petsc-dev 2014-07-24
Report Typos and Errors

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

See Also

PCBJacobiGetSubKSP()

Level:advanced
Location:
src/ksp/pc/impls/bjacobi/bjacobi.c
Index of all PC routines
Table of Contents for all manual pages
Index of all manual pages

Examples

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