DMForestTransferVec#

Transfer a Vec between two related DMFOREST grids, e.g. before and after adaptation.

Synopsis#

#include "petscdmforest.h" 
#include "petscdm.h" 
#include "petscdmlabel.h" 
PetscErrorCode DMForestTransferVec(DM dmIn, Vec vecIn, DM dmOut, Vec vecOut, PetscBool useBCs, PetscReal time)

Collective

Input Parameters#

  • dmIn - source DMFOREST

  • vecIn - vector on dmIn

  • dmOut - destination DMFOREST

  • useBCs - if PETSC_TRUE, apply boundary conditions during transfer

  • time - simulation time supplied to any time-dependent boundary conditions

Output Parameter#

  • vecOut - vector on dmOut that receives the transferred values

Note#

Requires the forest implementation to provide a transfer routine; otherwise raises PETSC_ERR_SUP.

See Also#

DM, DMFOREST, DMForestTransferVecFromBase(), DMForestSetAdaptivityForest()

Level#

intermediate

Location#

src/dm/impls/forest/forest.c

Examples#

src/ts/tutorials/ex11.c
src/ts/tutorials/ex30.c

Implementations#

DMForestTransferVec_pforest() in src/dm/impls/forest/p4est/pforest.h


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