DMDASetFieldName — PETSc 3.24.5 documentation

Skip to main content
`Ctrl`+`K`

# DMDASetFieldName

Sets the names of individual field components in multicomponent vectors associated with a `DMDA`.

## Synopsis

    #include "petscdmda.h"
    PetscErrorCode DMDASetFieldName(DM da, PetscInt nf, const char name[])

Logically Collective; name must contain a common value

## Input Parameters

- da - the `DMDA`

- nf - field number for the `DMDA` (0, 1, … dof-1), where dof indicates the number of degrees of freedom per node within the `DMDA`

- name - the name of the field (component)

## Note

It must be called after having called `DMSetUp()`.

## See Also

DMDA - Creating vectors for structured grids, `DM`, `DMDA`, `DMDAGetFieldName()`, `DMDASetCoordinateName()`, `DMDAGetCoordinateName()`, `DMDASetFieldNames()`, `DMSetUp()`

## Level

intermediate

## Location

src/dm/impls/da/dacorn.c

## Examples

src/ksp/ksp/tutorials/ex70.c
src/dm/tutorials/ex7.c
src/ksp/ksp/tutorials/ex73.c
src/snes/tutorials/ex19.c
src/ksp/ksp/tutorials/ex43.c
src/ksp/ksp/tutorials/ex49.c
src/dm/tutorials/ex11f90.F90
src/ksp/ksp/tutorials/ex42.c
src/ksp/ksp/tutorials/ex29.c
src/snes/tutorials/ex21.c

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