petsc-3.11.4 2019-09-28
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[])
Not 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,PETSC_NULL_KSP,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
Examples
src/ksp/ksp/examples/tutorials/ex7.c.html
src/ksp/ksp/examples/tutorials/ex7f.F90.html
src/snes/examples/tutorials/ex3.c.html
Implementations
PCBJacobiGetSubKSP_BJacobi in src/ksp/pc/impls/bjacobi/bjacobi.c
Index of all PC routines
Table of Contents for all manual pages
Index of all manual pages