petsc-3.14.5 2021-03-03
Report Typos and Errors

# DMProjectFunctionLabel

This projects the given function into the function space provided, putting the coefficients in a global vector, setting values only for points in the given label.

### Synopsis

    #include "petscdm.h"
    #include "petscdmlabel.h"
    #include "petscds.h"
    PetscErrorCode DMProjectFunctionLabel(DM dm, PetscReal time, DMLabel label, PetscInt numIds, const PetscInt ids[], PetscInt Nc, const PetscInt comps[], PetscErrorCode (**funcs)(PetscInt, PetscReal, const PetscReal [], PetscInt, PetscScalar *, void *), void **ctxs, InsertMode mode, Vec X)

Collective on DM

### Input Parameters

| dm | - The DM
| time | - The time
| label | - The DMLabel selecting the portion of the mesh for projection
| funcs | - The coordinate functions to evaluate, one per field
| ctxs | - Optional array of contexts to pass to each coordinate function. ctxs itself may be null.
| mode | - The insertion mode for values

### Output Parameter

| X | - vector

### Calling sequence of func

       func(PetscInt dim, PetscReal time, const PetscReal x[], PetscInt Nf, PetscScalar u[], void *ctx);

| dim | - The spatial dimension
| x | - The coordinates
| Nf | - The number of fields
| u | - The output field values
| ctx | - optional user-defined function context

### See Also

DMProjectFunction(), DMProjectFunctionLocal(), DMProjectFunctionLabelLocal(), DMComputeL2Diff()

### Level

developer

### Location

src/dm/interface/dm.c
Index of all DM routines
Table of Contents for all manual pages
Index of all manual pages