Synopsis
set/add/delete a cell_set to the Cell_Set array in a Grid's Cells subobject
int FLDset_cell_set (
OMobj_id cell_set,
const char *cell_set_name);
int FLDadd_cell_set (
OMobj_id field,
const char *cell_set_name);
int FLDdel_cell_set (
OMobj_id field,
OMobj_id cell_set);
Description
These routines add or delete an element of the Cell_Set cell_set array within Cells. They are the first thing you use whenever you need to add another cell type (Tri, Hex, Pyr, etc.) to the list of Cell_Sets in the Grid describing a field.
FLDset_cell_set sets the type of an existing cell_set array element.
Parameters
OMobj_id field
FLDadd_cell_set and FLDdel_cell_set only. The OMobj_id of a field containing a Grid.
OMobj_id cell_set
FLDset_cell_set and FLDdel_cell_set only. The OMobj_id of one element of the cell_set array, such as that produced by the FLDget_cell_set routine.
const char *cell_set_name
In FLDset_cell_set and FLDadd_cell_set, cell_set_name is a character string. This is copied to the cell_set's cell_name subobject, thereby defining the type of cell. The choices are: Point, Line, Line2, Polyline, Tri, Tri2, Polytri, Quad, Quad2, Tet, Tet2, Hex, Hex2, Pyr, Pyr2, Prism, Prism2. (The "2"s are cells of that type that contain mid-edge nodes.)
Note: This is the cell_name subobject. It is not the name subobject (the "user's name"). To get/set name, see the reference below.
Example
For FLDset_cell_set:
modules/advect.c
modules/ext_face.c
modules/gen_fld.c
modules/iso.c
modules/rd_ucd.c (and others)
For FLDadd_cell_set:
modules/bounds.c
modules/contour.c
modules/cut.c
modules/ex_brk3.c
modules/ext_edge.c
modules/ext_face.c (and others)
For FLDdel_cell_set:
modules/ext_edge.c
Related routines