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, otherwisePETSC_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
ifn
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#
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