PETSc version 3.17.5
MatSetValuesCOO
set values at once in a matrix preallocated using MatSetPreallocationCOO()
Synopsis
#include "petscmat.h"
PetscErrorCode MatSetValuesCOO(Mat A, const PetscScalar coo_v[], InsertMode imode)
Collective on Mat
Input Parameters
| A | - matrix being preallocated
|
| coo_v | - the matrix values (can be NULL)
|
| imode | - the insert mode
|
Notes: The values must follow the order of the indices prescribed with MatSetPreallocationCOO() or MatSetPreallocationCOOLocal().
When repeated entries are specified in the COO indices the coo_v values are first properly summed, regardless of the value of imode.
The imode flag indicates if coo_v must be added to the current values of the matrix (ADD_VALUES) or overwritten (INSERT_VALUES).
MatAssemblyBegin() and MatAssemblyEnd() do not need to be called after this routine. It automatically handles the assembly process.
See Also
MatSetPreallocationCOO(), MatSetPreallocationCOOLocal(), InsertMode, INSERT_VALUES, ADD_VALUES
Level
beginner
Location
src/mat/utils/gcreate.c
Examples
src/mat/tutorials/ex18.c.html
Implementations
MatSetValuesCOO_MPIAIJKokkos in src/mat/impls/aij/mpi/kokkos/mpiaijkok.kokkos.cxx
MatSetValuesCOO_MPIAIJ in src/mat/impls/aij/mpi/mpiaij.c
MatSetValuesCOO_MPIAIJCUSPARSE in src/mat/impls/aij/mpi/mpicusparse/mpiaijcusparse.cu
MatSetValuesCOO_SeqAIJ in src/mat/impls/aij/seq/aij.c
MatSetValuesCOO_SeqAIJKokkos in src/mat/impls/aij/seq/kokkos/aijkok.kokkos.cxx
MatSetValuesCOO_SeqAIJCUSPARSE in src/mat/impls/aij/seq/seqcusparse/aijcusparse.cu
MatSetValuesCOO_HYPRE in src/mat/impls/hypre/mhypre.c
MatSetValuesCOO_IS in src/mat/impls/is/matis.c
Index of all Mat routines
Table of Contents for all manual pages
Index of all manual pages