DMForestTransferVecFromBase — PETSc 3.25.4 documentation

Skip to main content
`Ctrl`+`K`

# DMForestTransferVecFromBase

Transfer a `Vec` defined on the base `DM` of a `DMFOREST` onto the refined forest.

## Synopsis

    #include "petscdmforest.h"
    #include "petscdm.h"
    #include "petscdmlabel.h"
    PetscErrorCode DMForestTransferVecFromBase(DM dm, Vec vecIn, Vec vecOut)

Collective

## Input Parameters

- dm - the `DMFOREST`

- vecIn - vector defined on the base `DM` returned by `DMForestGetBaseDM()`

## Output Parameter

- vecOut - vector on `dm` that receives the transferred values

## Note

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

## See Also

`DM`, `DMFOREST`, `DMForestTransferVec()`, `DMForestGetBaseDM()`

## Level

intermediate

## Location

src/dm/impls/forest/forest.c

## Implementations

DMForestTransferVecFromBase_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