DMForestTransferVec — PETSc 3.25.4 documentation

Skip to main content
`Ctrl`+`K`

# 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