MatCreateSum

 Creates a matrix as the implicit sum of zero or more matrices. This class is an adoption of MATCOMPOSITE type in PETSc.

Synopsis

PetscErrorCode  MatCreateSum(MPI_Comm comm,PetscInt nmat,const Mat *mats,Mat *mat)
Collective on MPI_Comm

Input Parameters

comm - MPI communicator
nmat - number of matrices to put in
mats - the matrices

Output Parameter

A - the matrix

Notes

Alternative construction 
      MatCreate(comm,&mat);

      MatSetType(mat,MATSUM);

      MatCompositeAddMat(mat,mats[0]);

      ....

      MatCompositeAddMat(mat,mats[nmat-1]);

      MatAssemblyBegin(mat,MAT_FINAL_ASSEMBLY);

      MatAssemblyEnd(mat,MAT_FINAL_ASSEMBLY);

See Also

MatDestroy(), MatMult(), MatCompositeAddMat(), MatCompositeMerge(), MatCompositeSetType(), MatCompositeType

Level

advanced

Location

src/mat/impls/composite/matsum.c
Index of all Mat routines
Table of Contents for all manual pages
Index of all manual pages