MatFactorGetSchurComplement — PETSc 3.23.0 documentation

Skip to main content
`Ctrl`+`K`

# MatFactorGetSchurComplement

Gets access to a Schur complement matrix using the current Schur data within a factored matrix

## Synopsis

    #include "petscmat.h"
    PetscErrorCode MatFactorGetSchurComplement(Mat F, Mat *S, MatFactorSchurStatus *status)

Logically Collective

## Input Parameters

- F - the factored matrix obtained by calling `MatGetFactor()`

- S - location where to return the Schur complement, can be `NULL`

- status - the status of the Schur complement matrix, can be `NULL`

## Notes

You must call `MatFactorSetSchurIS()` before calling this routine.

Schur complement mode is currently implemented for sequential matrices with factor type of `MATSOLVERMUMPS`

The routine returns a the Schur Complement stored within the data structures of the solver.

If `MatFactorInvertSchurComplement()` has previously been called, the returned matrix is actually the inverse of the Schur complement.

The returned matrix should not be destroyed; the caller should call `MatFactorRestoreSchurComplement()` when the object is no longer needed.

Use `MatFactorCreateSchurComplement()` to create a copy of the Schur complement matrix that is within a factored matrix

See `MatCreateSchurComplement()` or `MatGetSchurComplement()` for ways to create virtual or approximate Schur complements.

## See Also

Matrices, `Mat`, `MatGetFactor()`, `MatFactorSetSchurIS()`, `MatFactorRestoreSchurComplement()`, `MatFactorCreateSchurComplement()`, `MatFactorSchurStatus`

## Level

advanced

## Location

src/mat/interface/matrix.c

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