VecISCopy#

Copies between a reduced vector and the appropriate elements of a full-space vector.

Synopsis#

#include "petscvec.h"  
PetscErrorCode VecISCopy(Vec vfull, IS is, ScatterMode mode, Vec vreduced)

Logically Collective

Input Parameters#

  • vfull - the full-space vector

  • is - the index set for the reduced space

  • mode - the direction of copying, SCATTER_FORWARD or SCATTER_REVERSE

  • vreduced - the reduced-space vector

Output Parameter#

  • vfull - the sum of the full-space vector and reduced-space vector

Notes#

The index set identifies entries in the global vector. Negative indices are skipped; indices outside the ownership range of vfull will raise an error.

    mode == SCATTER_FORWARD: vfull[is[i]] = vreduced[i]
    mode == SCATTER_REVERSE: vreduced[i] = vfull[is[i]]

See Also#

VecISSet(), VecISAXPY(), VecCopy()

Level#

advanced

Location#

src/vec/vec/utils/projection.c

Examples#

src/snes/tutorials/ex13.c


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