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

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.

If the MAT_STRUCTURE_ONLY option is set to true, the values are ignored and only the assembly process is performed.

MatSetValues() and other operations may modify existing entries of the matrix between calls to this routine. If they change the nonzero pattern built by MatSetPreallocationCOO(), for example by inserting a new nonzero, this routine generates an error for MATAIJ and its device subtypes; call MatSetPreallocationCOO() again before calling MatSetValuesCOO().