DMForestSetBaseCoordinateMapping — PETSc 3.25.4 documentation

Skip to main content
`Ctrl`+`K`

# DMForestSetBaseCoordinateMapping

Set a user-supplied mapping that is applied to the base `DM`’s coordinates when the forest computes coordinates for refined cells.

## Synopsis

    #include "petscdmforest.h"
    #include "petscdm.h"
    #include "petscdmlabel.h"
    PetscErrorCode DMForestSetBaseCoordinateMapping(DM dm, PetscErrorCode (*func)(DM base, PetscInt coarsePoint, PetscInt dim, const PetscReal coordIn[], PetscReal coordOut[], PetscCtx ctx), PetscCtx ctx)

Logically Collective

## Input Parameters

- dm - the `DMFOREST`

- func - callback that maps reference coordinates to physical coordinates

- ctx - optional application context passed through to `func`

## Calling sequence of `func`

- base - the base `DM` of the forest

- coarsePoint - the base-`DM` cell that owns the coordinate being mapped

- dim - the coordinate dimension (at most 3)

- coordIn - the input coordinate on the base `DM`

- coordOut - the mapped coordinate to be written

- ctx - optional application context

## See Also

`DM`, `DMFOREST`, `DMForestGetBaseCoordinateMapping()`, `DMForestSetBaseDM()`

## Level

intermediate

## Location

src/dm/impls/forest/forest.c

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