MatSetValuesLocal

Inserts or adds values into certain locations of a matrix, using a local numbering of the rows and columns.

Synopsis

#include "petscmat.h" 
PetscErrorCode MatSetValuesLocal(Mat mat, PetscInt nrow, const PetscInt irow[], PetscInt ncol, const PetscInt icol[], const PetscScalar y[], InsertMode addv)

Not Collective

Input Parameters

• mat - the matrix

• nrow - number of rows

• irow - the row local indices

• ncol - number of columns

• icol - the column local indices

• y - a one-dimensional array that contains the values implicitly stored as a two-dimensional array, by default in row-major order. See MAT_ROW_ORIENTED in MatSetOption() for how to use column-major order.

• addv - either ADD_VALUES to add values to any existing entries, or INSERT_VALUES to replace existing entries with new values

Notes

If you create the matrix yourself (that is not with a call to DMCreateMatrix()) then you MUST call MatSetLocalToGlobalMapping() before using this routine

Calls to MatSetValuesLocal() with the INSERT_VALUES and ADD_VALUES options cannot be mixed without intervening calls to the assembly routines.

These values may be cached, so MatAssemblyBegin() and MatAssemblyEnd() MUST be called after all calls to MatSetValuesLocal() have been completed.

Fortran Notes

If any of irow, icol, and y are scalars pass them using, for example,

  call MatSetValuesLocal(mat, one, [irow], one, [icol], [y], INSERT_VALUES, ierr)

If y is a two-dimensional array use reshape() to pass it as a one dimensional array

See Also

Matrices, Mat, MatAssemblyBegin(), MatAssemblyEnd(), MatSetValues(), MatSetLocalToGlobalMapping(), MatGetValuesLocal()

Level

intermediate

Location

src/mat/interface/matrix.c

Examples

src/snes/tutorials/ex5f90.F90
src/tao/bound/tutorials/plate2.c
src/ksp/ksp/tutorials/ex36.cxx
src/tao/bound/tutorials/jbearing2.c
src/ksp/ksp/tutorials/ex35.cxx
src/ksp/ksp/tutorials/ex85.c
src/tao/bound/tutorials/plate2f.F90
src/snes/tutorials/ex28.c
src/snes/tutorials/ex5f90t.F90
src/ksp/ksp/tutorials/ex70.c

Implementations

MatSetValuesLocal_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