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_TRUE if the null space contains the constant vector, otherwise PETSC_FALSE

  • n - number of vectors (excluding constant vector) in the null space

  • vecs - returns array of length n containing the orthonormal vectors that span the null space (excluding the constant vector), NULL if n is 0

Note#

These vectors and the array 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#

src/mat/interface/matnull.c

Examples#

src/ksp/ksp/tutorials/ex49.c
src/snes/tutorials/ex69.c


Index of all Mat routines
Table of Contents for all manual pages
Index of all manual pages