Grid sections are stored in the case file. A grid file is a subset of a case file, containing only those sections pertaining to the grid. The currently defined grid sections are:
Comment (See Comment)
Header (See Header)
Dimensions (See Dimensions)
Nodes (See Nodes)
Periodic Shadow Faces (See Periodic Shadow Faces)
Cells (See Cells)
Faces (See Faces)
Face Tree (See Face Tree)
Cell Tree (See Cell Tree)
Interface Face Parents (See Interface Face Parents)
The section ID numbers are indicated in both symbolic and numeric forms. The symbolic representations are available as symbols in a Scheme source file (xfile.scm), which is available from ANSYS Inc., or as macros in a C header file (xfile.h), which is located in your installation area.
| Index: | 0 |
| Scheme symbol: |
xf-comment
|
| C macro: |
XF_COMMENT |
| Status: | optional |
Comment sections can appear anywhere in the file (except within other sections) as:
(0 "comment text")
You should precede each long section, or group of related sections, by a comment section explaining what is to follow.
Example:
(0 "Variables:") (37 ( (relax-mass-flow 1) (default-coefficient ()) (default-method 0) ))
| Index: | 1 |
| Scheme symbol: |
xf-header
|
| C macro: |
XF_HEADER |
| Status: | optional |
Header sections can appear anywhere in the file (except within other sections). The following is an example:
(0 "fluent18.2.0 build-id: 0")
The purpose of this section is to identify the program that wrote the file. Although it can appear anywhere, it is one of the first sections in the file. Additional header sections indicate other programs that may have been used in generating the file. It provides a history mechanism showing where the file came from and how it was processed.
| Index: | 2 |
| Scheme symbol: |
xf-dimension
|
| C macro: |
XF_DIMENSION
|
| Status: | optional |
The dimensions of the grid appear as:
(2 ND)
where ND is 2 or 3. This section is
supported as a check that the grid has the appropriate dimension.
| Index: | 10 |
| Scheme symbol: |
xf-node
|
| C macro: |
XF_NODE
|
| Status: | required |
Format:
(10 (zone-id first-index last-index type ND)( x1 y1 z1 x2 y2 z2 . . . ))
If zone-id is zero, this
provides the total number of nodes in the grid. first-index will then be one, last-index will be the
total number of nodes in hexadecimal, type is equal to 1, ND is the dimensionality of the grid, and there are
no coordinates following (the parentheses for the coordinates are
omitted as well).
For example: (10 (0 1 2d5
1 2))
If zone-id is greater than
zero, it indicates the zone to which the nodes belong. first-index and last-index are
the indices of the nodes in the zone, in hexadecimal. The values of last-index in each zone
must be less than or equal to the value in the declaration section. Type is always equal to 1.
ND is an optional argument that indicates
the dimensionality of the node data, where ND is 2 or 3.
If the number of dimensions in the grid is
two, as specified by the node header, then only and
coordinates are present on each
line.
The following is an example of a 2D grid:
(10 (1 1 2d5 1 2)(
1.500000e-01 2.500000e-02
1.625000e-01 1.250000e-02
.
.
.
1.750000e-01 0.000000e+00
2.000000e-01 2.500000e-02
1.875000e-01 1.250000e-02
))
Because the grid connectivity is composed of integers representing
pointers (see Cells and Faces), using hexadecimal conserves space
in the file and provides for faster file input and output. The header
indices are in hexadecimal so that they match the indices in the bodies
of the grid connectivity sections. The zone-id and type are also in hexadecimal for consistency.
| Index: | 18 |
| Scheme symbol: |
xf-periodic-face
|
| C macro: |
XF_PERIODIC_FACE |
| Status: | required only for grids with periodic boundaries |
This section indicates the pairings of periodic faces on periodic boundaries. Grids without periodic boundaries do not have sections of this type. The format of the section is as follows:
(18 (first-index last-index periodic-zone shadow-zone)( f00 f01 f10 f11 f20 f21 . . . ))
where
first-index = index of the first periodic face pair in the list |
last-index = index of
the last periodic face pair in the list |
periodic-zone = zone ID of
the periodic face zone |
shadow-zone = zone ID of the corresponding shadow face
zone |
These are in hexadecimal format. The indices in the section
body (f*) refer to the faces on each of the
periodic boundaries (in hexadecimal), the indices being offsets into
the list of faces for the grid.
Note: In this case, first-index and last-index do not refer to face
indices. They refer to indices in the list of periodic pairs.
Example:
(18 (1 2b a c) ( 12 1f 13 21 ad 1c2 . . . ))
| Index: | 12 |
| Scheme symbol: |
xf-cell
|
| C macro: |
XF_CELL
|
| Status: | required |
The declaration section for cells is similar to that for nodes.
(12 (zone-id first-index last-index type element-type))
Again, zone-id is zero to indicate
that it is a declaration of the total number of cells. If last-index is zero, then there are no cells in the grid.
This is useful when the file contains only a surface mesh to alert ANSYS Fluent that
it cannot be used. In a declaration section, the type has a value of zero and the element-type is not present.
For example,
(12 (0 1 3e3 0))
It states that there are 3e3 (hexadecimal) = 995 cells in the grid. This declaration section is required and must precede the regular cell sections.
The element-type in a regular cell
section header indicates the type of cells in the section, as follows:
element-type
| description | nodes/cell | faces/cell |
|---|---|---|---|
| 0 | mixed | ||
| 1 | triangular | 3 | 3 |
| 2 | tetrahedral | 4 | 4 |
| 3 | quadrilateral | 4 | 4 |
| 4 | hexahedral | 8 | 6 |
| 5 | pyramid | 5 | 5 |
| 6 | wedge | 6 | 5 |
| 7 | polyhedral | NN | NF |
where NN and NF will vary, depending on the specific polyhedral cell.
Regular cell sections have no body, but they have a header of
the same format where first-index and last-index indicate the range for the particular zone, type indicates whether the cell zone is an active zone
(solid or fluid), or inactive zone (currently only parent cells resulting
from hanging node adaption). Active zones are represented with type=1, while inactive zones are represented with type=32.
In the earlier versions of ANSYS Fluent, a distinction was made between solid and fluid zones. This is now determined by properties (that is, material type).
A type of zero indicates a dead zone
and will be skipped by ANSYS Fluent. If a zone is of mixed type (element-type=0), it will have a body that lists the element-type of each cell.
Example:
(12 (9 1 3d 0 0)( 1 1 1 3 3 1 1 3 1 . . . ))
Here, there are 3D (hexadecimal) = 61 cells in cell zone 9, of which the first 3 are triangles, the next 2 are quadrilaterals, and so on.
| Index: | 13 |
| Scheme symbol: |
xf-face
|
| C macro: |
XF_FACE
|
| Status: | required |
The format for face sections is as follows:
(13 (zone-id first-index last-index bc-type face-type))
where
zone-id =
zone ID of the face section |
first-index = index of the first face in
the list |
last-index = index of the last face in the list |
bc-type = ID of the boundary
condition represented by the face section |
face-type = ID of the type(s)
of face(s) in the section |
The current valid boundary condition types are defined in the following table:
bc-type
| description |
| 2 | interior |
| 3 | wall |
| 4 | pressure-inlet, inlet-vent, intake-fan |
| 5 | pressure-outlet, exhaust-fan, outlet-vent |
| 7 | symmetry |
| 8 | periodic-shadow |
| 9 | pressure-far-field |
| 10 | velocity-inlet |
| 12 | periodic |
| 14 | fan, porous-jump, radiator |
| 20 | mass-flow-inlet, mass-flow-outlet |
| 24 | interface |
| 31 | parent (hanging node) |
| 36 | outflow |
| 37 | axis |
The faces resulting from the intersection of non-conformal grids
are placed in a separate face zone, where a factor of 1000 is added
to the bc-type (for example, 1003 is a wall
zone).
The current valid face types are defined in the following table:
face-type
| description | nodes/face |
| 0 | mixed | |
| 2 | linear | 2 |
| 3 | triangular | 3 |
| 4 | quadrilateral | 4 |
| 5 | polygonal | NN |
where NN will vary, depending on the specific polygonal face.
A zone-id of zero indicates a declaration
section, which provides a count of the total number of faces in the
file. Such a section omits the bc-type and
is not followed by a body with further information.
A nonzero zone-id indicates a regular
face section, and will be followed by a body that contains information
about the grid connectivity. Each line of the body will describe one
face and will have the following format:
n0 n1 n2 c0 c1
where,
n* = defining
nodes (vertices) of the face |
c* = adjacent cells |
This is the format for a 3D grid with a triangular face format.
The actual number of nodes depends on the face-type. The order of the cell indices is important, and is determined by
the right-hand rule: if you curl the fingers of your right hand in
the order of the nodes, your thumb will point toward c0.
For 2D grids, n2 is omitted. c1 is determined by the cross product of two vectors, and
. The
vector extends
from
n0 to n1, whereas
the vector has its origin at
n0 and points out of the grid plane toward the viewer.
If you extend your right hand along and curl your
fingers in the direction of the angle between
and
, your thumb will point along
toward
c1.
If the face zone is of mixed type (face-type= 0) or of polygonal type (face-type= 5),
each line of the section body will begin with a reference to the number
of nodes that make up that particular face, and has the following
format:
x n0 n1 ... nf c0 c1
where,
x = the number
of nodes (vertices) of the face |
nf = the final node of the face |
All cells, faces, and nodes have positive indices. If a face
has a cell only on one side, then either c0 or c1 is zero. For files containing only
a surface mesh, both these values are zero.
For information on face-node connectivity for various cell types in ANSYS Fluent, refer to Face-Node Connectivity in ANSYS Fluent.
| Index: | 59 |
| Scheme symbol: |
xf-face-tree
|
| C macro: |
XF_FACE_TREE
|
| Status: | only for grids with hanging node adaption |
This section indicates the face hierarchy of the grid containing hanging nodes. The format of the section is as follows:
(59 (face-id0 face-id1 parent-zone-id child-zone-id) ( number-of-kids kid-id-0 kid-id-1 ... kid-id-n . . . ))
where,
face-id0 =
index of the first parent face in the section |
face-id1 = index of the last
parent face in the section |
parent-zone-id = ID of the zone containing
parent faces |
child-zone-id = ID of the zone containing children faces |
number-of-kids = the number
of children of the parent face |
kid-id-n = the face IDs of the children |
These are in hexadecimal format.
| Index: | 58 |
| Scheme symbol: |
xf-cell-tree
|
| C macro: |
XF_CELL_TREE
|
| Status: | only for grids with hanging node adaption |
This section indicates the cell hierarchy of the grid containing hanging nodes. The format of the section is as follows:
(58 (cell-id0 cell-id1 parent-zone-id child-zone-id) ( number-of-kids kid-id-0 kid-id-1 ... kid-id-n . . . ))
where,
cell-id0 =
index of the first parent cell in the section |
cell-id1 = index of the last
parent cell in the section |
parent-zone-id = ID of the zone containing
parent cells |
child-zone-id = ID of the zone containing children cells |
number-of-kids = the number
of children of the parent cell |
kid-id-n = the cell IDs of the children |
These are in hexadecimal format.
| Index: | 61 |
| Scheme symbol: |
xf-face-parents
|
| C macro: |
XF_FACE_PARENTS |
| Status: | only for grids with non-conformal interfaces |
This section indicates the relationship between the intersection faces and original faces. The intersection faces (children) are produced from intersecting two non-conformal surfaces (parents) and are some fraction of the original face. Each child will refer to at least one parent. The format of the section is as follows:
(61 (face-id0 face-id1) ( parent-id-0 parent-id-1 . . . ))
where,
|
|
|
|
|
|
These are in hexadecimal format.
If you set up and save a non-conformal mesh in the solution mode of Fluent and then read it using the meshing mode of Fluent, this section will be skipped; consequently, all the information necessary to preserve the non-conformal interface will not be maintained. When you switch to or read the mesh back into the solution mode, you will need to recreate the interface.
Figure 1: Quadrilateral Mesh illustrates a simple quadrilateral mesh with no periodic boundaries or hanging nodes.
The following describes this mesh:
(0 "Grid:") (0 "Dimensions:") (2 2) (12 (0 1 3 0)) (13 (0 1 a 0)) (10 (0 1 8 0 2)) (12 (7 1 3 1 3)) (13 (2 1 2 2 2)( 1 2 1 2 3 4 2 3)) (13 (3 3 5 3 2)( 5 1 1 0 1 3 2 0 3 6 3 0)) (13 (4 6 8 3 2)( 7 4 3 0 4 2 2 0 2 8 1 0)) (13 (5 9 9 a 2)( 8 5 1 0)) (13 (6 a a 24 2)( 6 7 3 0)) (10 (1 1 8 1 2) ( 1.00000000e+00 0.00000000e+00 1.00000000e+00 1.00000000e+00 2.00000000e+00 0.00000000e+00 2.00000000e+00 1.00000000e+00 0.00000000e+00 0.00000000e+00 3.00000000e+00 0.00000000e+00 3.00000000e+00 1.00000000e+00 0.00000000e+00 1.00000000e+00))
Figure 2: Quadrilateral Mesh with Periodic Boundaries illustrates a simple quadrilateral mesh with periodic boundaries but no hanging nodes. In this example, bf9 and bf10 are faces on the periodic zones.
The following describes this mesh:
(0 "Dimensions:") (2 2) (0 "Grid:") (12 (0 1 3 0)) (13 (0 1 a 0)) (10 (0 1 8 0 2)) (12 (7 1 3 1 3)) (13 (2 1 2 2 2)( 1 2 1 2 3 4 2 3)) (13 (3 3 5 3 2)( 5 1 1 0 1 3 2 0 3 6 3 0)) (13 (4 6 8 3 2)( 7 4 3 0 4 2 2 0 2 8 1 0)) (13 (5 9 9 c 2)( 8 5 1 0)) (13 (1 a a 8 2)( 6 7 3 0)) (18 (1 1 5 1)( 9 a)) (10 (1 1 8 1 2)( 1.00000000e+00 0.00000000e+00 1.00000000e+00 1.00000000e+00 2.00000000e+00 0.00000000e+00 2.00000000e+00 1.00000000e+00 0.00000000e+00 0.00000000e+00 3.00000000e+00 0.00000000e+00 3.00000000e+00 1.00000000e+00 0.00000000e+00 1.00000000e+00))
Figure 3: Quadrilateral Mesh with Hanging Nodes illustrates a simple quadrilateral mesh with hanging nodes.
The following describes this mesh:
(0 "Grid:") (0 "Dimensions:") (2 2) (12 (0 1 7 0)) (13 (0 1 16 0)) (10 (0 1 d 0 2)) (12 (7 1 6 1 3)) (12 (1 7 7 20 3)) (58 (7 7 1 7)( 4 6 5 4 3)) (13 (2 1 7 2 2)( 1 2 6 3 1 3 3 4 1 4 4 5 1 5 5 6 6 7 1 2 5 8 2 6 9 5 2 5)) (13 (3 8 b 3 2)( a 6 1 0 6 9 2 0 4 b 4 0 9 4 5 0)) (13 (4 c f 3 2)( 2 8 6 0 c 2 3 0 8 7 2 0 7 d 1 0)) (13 (5 10 10 a 2)( d a 1 0)) (13 (6 11 12 24 2)( 3 c 3 0 b 3 4 0)) (13 (b 13 13 1f 2)( c 8 7 0)) (13 (a 14 14 1f 2)( b c 7 0)) (13 (9 15 15 1f 2)( 9 b 7 0)) (13 (8 16 16 1f 2)( 9 8 2 7)) (59 (13 13 b 4)( 2 d c)) (59 (14 14 a 6)( 2 12 11)) (59 (15 15 9 3)( 2 b a)) (59 (16 16 8 2)( 2 7 6)) (10 (1 1 d 1 2) ( 2.50000000e+00 5.00000000e-01 2.50000000e+00 1.00000000e+00 3.00000000e+00 5.00000000e-01 2.50000000e+00 0.00000000e+00 2.00000000e+00 5.00000000e-01 1.00000000e+00 0.00000000e+00 1.00000000e+00 1.00000000e+00 2.00000000e+00 1.00000000e+00 2.00000000e+00 0.00000000e+00 0.00000000e+00 0.00000000e+00 3.00000000e+00 0.00000000e+00 3.00000000e+00 1.00000000e+00 0.00000000e+00 1.00000000e+00))