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/ex42.c
src/snes/tutorials/ex28.c
src/snes/tutorials/ex30.c
src/snes/tutorials/ex22.c
src/snes/tutorials/ex16.c
src/snes/tutorials/ex19.c
src/dm/tutorials/ex7.c
src/snes/tutorials/ex21.c
src/snes/tutorials/ex48.c
src/ksp/ksp/tutorials/ex49.c


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