petsc-3.7.7 2017-09-25

PCBJacobiGetSubKSP

Gets the local KSP contexts for all blocks on this processor.

Synopsis

#include "petscpc.h" 
PetscErrorCode  PCBJacobiGetSubKSP(PC pc,PetscInt *n_local,PetscInt *first_local,KSP *ksp[])

Note Collective

Input Parameter

pc -the preconditioner context

Output Parameters

	n_local	- the number of blocks on this processor, or NULL
	first_local	- the global number of the first block on this processor, or NULL
	ksp	- the array of KSP contexts

Notes

After PCBJacobiGetSubKSP() the array of KSP contexts is not to be freed.

Currently for some matrix implementations only 1 block per processor is supported.

You must call KSPSetUp() or PCSetUp() before calling PCBJacobiGetSubKSP().

Fortran Usage: You must pass in a KSP array that is large enough to contain all the local KSPs. You can call PCBJacobiGetSubKSP(pc,nlocal,firstlocal,NULL_OBJECT,ierr) to determine how large the KSP array must be.

Keywords

block, Jacobi, get, sub, KSP, context

Examples

src/ksp/ksp/examples/tutorials/ex7.c.html
src/snes/examples/tutorials/ex3.c.html