InsertMode

How the entries are combined with the current values in the vectors or matrices

Synopsis

typedef enum {
  NOT_SET_VALUES,
  INSERT_VALUES,
  ADD_VALUES,
  MAX_VALUES,
  MIN_VALUES,
  INSERT_ALL_VALUES,
  ADD_ALL_VALUES,
  INSERT_BC_VALUES,
  ADD_BC_VALUES
} InsertMode;

Values

• NOT_SET_VALUES - do not actually use the values

• INSERT_VALUES - replace the current values with the provided values, unless the index is marked as constrained by the PetscSection

• ADD_VALUES - add the values to the current values, unless the index is marked as constrained by the PetscSection

• MAX_VALUES - use the maximum of each current value and provided value

• MIN_VALUES - use the minimum of each current value and provided value

• INSERT_ALL_VALUES - insert, even if indices that are not marked as constrained by the PetscSection

• ADD_ALL_VALUES - add, even if indices that are not marked as constrained by the PetscSection

• INSERT_BC_VALUES - insert, but ignore indices that are not marked as constrained by the PetscSection

• ADD_BC_VALUES - add, but ignore indices that are not marked as constrained by the PetscSection

Note

The PetscSection that determines the effects of the InsertMode values can be obtained by the Vec object with VecGetDM() and DMGetLocalSection().

Not all options are supported for all operations or PETSc object types.

See Also

VecSetValues(), MatSetValues(), VecSetValue(), VecSetValuesBlocked(), VecSetValuesLocal(), VecSetValuesBlockedLocal(), MatSetValuesBlocked(), MatSetValuesBlockedLocal(), MatSetValuesLocal(), VecScatterBegin(), VecScatterEnd()

Level

beginner

Location

include/petscsystypes.h

---

Index of all Sys routines
Table of Contents for all manual pages
Index of all manual pages