petsc-3.12.4 2020-02-04
Report Typos and Errors

# MatReuse

Indicates if matrices obtained from a previous call to MatCreateSubMatrices(), MatCreateSubMatrix(), MatConvert() or several other functions are to be reused to store the new matrix values.

### Synopsis

    typedef enum {MAT_INITIAL_MATRIX,MAT_REUSE_MATRIX,MAT_IGNORE_MATRIX,MAT_INPLACE_MATRIX} MatReuse;

     MAT_INITIAL_MATRIX - create a new matrix

     MAT_REUSE_MATRIX - reuse the matrix created with a previous call that used MAT_INITIAL_MATRIX

     MAT_INPLACE_MATRIX - replace the first input matrix with the new matrix (not applicable to all functions)

     MAT_IGNORE_MATRIX - do not create a new matrix or reuse a give matrix, just ignore that matrix argument (not applicable to all functions)

Any additions/changes here MUST also be made in include/petsc/finclude/petscmat.h

### See Also

MatCreateSubMatrices(), MatCreateSubMatrix(), MatDestroyMatrices(), MatConvert()

### Level

beginner

### Location

src/mat/../../include/petscmat.h

### Examples

src/ksp/ksp/examples/tutorials/ex29.c.html
src/ksp/ksp/examples/tutorials/ex34.c.html
src/ksp/ksp/examples/tutorials/ex43.c.html
src/ksp/ksp/examples/tutorials/ex49.c.html
src/ksp/ksp/examples/tutorials/ex59.c.html
src/ksp/ksp/examples/tutorials/ex64.c.html
src/ksp/ksp/examples/tutorials/ex65.c.html
src/ksp/ksp/examples/tutorials/ex71.c.html
src/ksp/ksp/examples/tutorials/ex72.c.html
src/ksp/ksp/examples/tutorials/ex74.c.html
src/ksp/ksp/examples/tutorials/ex6f.F90.html
Index of all Mat routines
Table of Contents for all manual pages
Index of all manual pages