petsc-3.14.6 2021-03-30

MatCreateRedundantMatrix

Create redundant matrices and put them into processors of subcommunicators.

#include "petscmat.h" 
PetscErrorCode MatCreateRedundantMatrix(Mat mat,PetscInt nsubcomm,MPI_Comm subcomm,MatReuse reuse,Mat *matredundant)

Collective on Mat

	mat	- the matrix
	nsubcomm	- the number of subcommunicators (= number of redundant parallel or sequential matrices)
	subcomm	- MPI communicator split from the communicator where mat resides in (or MPI_COMM_NULL if nsubcomm is used)
	reuse	- either MAT_INITIAL_MATRIX or MAT_REUSE_MATRIX

matredundant

- redundant matrix

MAT_REUSE_MATRIX can only be used when the nonzero structure of the original matrix has not changed from that last call to MatCreateRedundantMatrix().

This routine creates the duplicated matrices in subcommunicators; you should NOT create them before calling it.

advanced