PETSc version 3.17.4

MatConvert

Converts a matrix to another matrix, either of the same or different type.

Synopsis

#include "petscmat.h" 
PetscErrorCode MatConvert(Mat mat,MatType newtype,MatReuse reuse,Mat *M)

Collective on Mat

Input Parameters

	mat	- the matrix
	newtype	- new matrix type. Use MATSAME to create a new matrix of the same type as the original matrix.
	reuse	- denotes if the destination matrix is to be created or reused. Use MAT_INPLACE_MATRIX for inplace conversion (that is when you want the input mat to be changed to contain the matrix in the new format), otherwise use MAT_INITIAL_MATRIX or MAT_REUSE_MATRIX (can only be used after the first call was made with MAT_INITIAL_MATRIX, causes the matrix space in M to be reused).

Output Parameter

- pointer to place new matrix

Notes

MatConvert() first creates a new matrix and then copies the data from the first matrix. A related routine is MatCopy(), which copies the matrix entries of one matrix to another already existing matrix context.

Cannot be used to convert a sequential matrix to parallel or parallel to sequential, the MPI communicator of the generated matrix is always the same as the communicator of the input matrix.

Level

intermediate

MatConvert

Synopsis

Input Parameters

Output Parameter

Notes

See Also

Level

Location

Examples

Implementations