MatNullSpaceGetVecs#
get the vectors defining the null space
Synopsis#
#include "petscmat.h"
PetscErrorCode MatNullSpaceGetVecs(MatNullSpace sp, PetscBool *has_const, PetscInt *n, const Vec *vecs[])
Not Collective
Input Parameter#
sp - null space object
Output Parameters#
has_const -
PETSC_TRUEif the null space contains the constant vector, otherwisePETSC_FALSEn - number of vectors (excluding constant vector) in the null space
vecs - returns array of length
ncontaining the orthonormal vectors that span the null space (excluding the constant vector),NULLifnis 0
Note#
These vectors and the array returned are owned by the MatNullSpace and should not be destroyed or freeded by the caller
Fortran Note#
One must pass in an array vecs that is large enough to hold all of the requested vectors
See Also#
Matrices, Mat, MatNullSpace, MatNullSpaceCreate(), MatGetNullSpace(), MatGetNearNullSpace()
Level#
developer
Location#
Examples#
src/snes/tutorials/ex69.c
src/ksp/ksp/tutorials/ex49.c
Index of all Mat routines
Table of Contents for all manual pages
Index of all manual pages