MatRestoreNullSpaces#

sets the null spaces, transpose null spaces, and near null spaces obtained with MatGetNullSpaces() for an array of matrices

Synopsis#

#include "petscmat.h" 
PetscErrorCode MatRestoreNullSpaces(PetscInt n, Mat mat[], MatNullSpace *nullsp[])

Logically Collective

Input Parameters#

  • n - the number of matrices

  • mat - the array of matrices

  • nullsp - an array of null spaces, of length 3 * n

Notes#

Call MatGetNullSpaces() to create nullsp.

Frees nullsp.

Developer Note#

The name of this function is confusing. Traditionally in PETSc, a restore operation undoes something that was previously done on an object (or objects) with a get operation. This restore routine does something to a new set of objects using the results of a get operation on a previous set of objects. Perhaps this routine should have simply been called MatSetNullSpaces()

See Also#

Matrices, Mat, MatCreate(), MatNullSpaceCreate(), MatSetNearNullSpace(), MatGetNullSpace(), MatSetTransposeNullSpace(), MatGetTransposeNullSpace(), MatNullSpaceRemove(), MatGetNullSpaces(), MatNullSpace

Level#

developer

Location#

src/mat/interface/matrix.c


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