File Formats - Volume Grid Format

UGRID file format (.ugrid): A UGRID file contains a tria/quad face boundary surface grid and (optionally) a polyhedral element volume grid. The optional boundary reconnection, boundary condition, and initial normal spacing data records are identical to those for an FGRID file (FAST grid).  Details of element connectivity can be found here.

 { Number_of_Nodes, Number_of_Surf_Trias, Number_of_Surf_Quads,
   Number_of_Vol_Tets, Number_of_Vol_Pents_5, Number_of_Vol_Pents_6,
   Number_of_Vol_Hexs }

 { [ ( X for node 1,
       Y for node 1,
       Z for node 1 ),
     ( X for node 2,
       Y for node 2,
       Z for node 2 ),
       ...
     ( X for node Number_of_Nodes,
       Y for node Number_of_Nodes,
       Z for node Number_of_Nodes ) ] }

 { [ ( index for node 1 of tria boundary face 1,
       index for node 2 of tria boundary face 1,
       index for node 3 of tria boundary face 1 ),
     ( index for node 1 of tria boundary face 2,
       index for node 2 of tria boundary face 2,
       index for node 3 of tria boundary face 2 ),
     ...
     ( index for node 1 of tria boundary face Number_of_Surf_Trias,
       index for node 2 of tria boundary face Number_of_Surf_Trias,
       index for node 3 of tria boundary face Number_of_Surf_Trias ) ]

   [ ( index for node 1 of quad boundary face 1,
       index for node 2 of quad boundary face 1,
       index for node 3 of quad boundary face 1,
       index for node 4 of quad boundary face 1 ),
     ( index for node 1 of quad boundary face 2,
       index for node 2 of quad boundary face 2,
       index for node 3 of quad boundary face 2,
       index for node 4 of quad boundary face 2 ),
     ...
     ( index for node 1 of quad boundary face Number_of_Surf_Quads,
       index for node 2 of quad boundary face Number_of_Surf_Quads,
       index for node 3 of quad boundary face Number_of_Surf_Quads,
       index for node 4 of quad boundary face Number_of_Surf_Quads ) ]

   [ surface ID for boundary face 1,
     surface ID for boundary face 2,
     ...
     surface ID for boundary face Number_of_Surf_Trias+Number_of_Surf_Quads ]

   [ ( index for node 1 of tet element 1,
       index for node 2 of tet element 1,
       index for node 3 of tet element 1,
       index for node 4 of tet element 1 ),
     ( index for node 1 of tet element 2,
       index for node 2 of tet element 2,
       index for node 3 of tet element 2,
       index for node 4 of tet element 2 ),
     ...
     ( index for node 1 of tet element Number_of_Vol_Tets,
       index for node 2 of tet element Number_of_Vol_Tets,
       index for node 3 of tet element Number_of_Vol_Tets,
       index for node 4 of tet element Number_of_Vol_Tets ) ]

   [ ( index for node 1 of pent_5 element 1,
       index for node 2 of pent_5 element 1,
       index for node 3 of pent_5 element 1,
       index for node 4 of pent_5 element 1,
       index for node 5 of pent_5 element 1 ),
     ( index for node 1 of pent_5 element 2,
       index for node 2 of pent_5 element 2,
       index for node 3 of pent_5 element 2,
       index for node 4 of pent_5 element 2,
       index for node 5 of pent_5 element 2 ),
     ...
     ( index for node 1 of pent_5 element Number_of_Vol_Pents_5,
       index for node 2 of pent_5 element Number_of_Vol_Pents_5,
       index for node 3 of pent_5 element Number_of_Vol_Pents_5,
       index for node 4 of pent_5 element Number_of_Vol_Pents_5,
       index for node 5 of pent_5 element Number_of_Vol_Pents_5 ) ]

   [ ( index for node 1 of pent_6 element 1,
       index for node 2 of pent_6 element 1,
       index for node 3 of pent_6 element 1,
       index for node 4 of pent_6 element 1,
       index for node 5 of pent_6 element 1,
       index for node 6 of pent_6 element 1 ),
     ( index for node 1 of pent_6 element 2,
       index for node 2 of pent_6 element 2,
       index for node 3 of pent_6 element 2,
       index for node 4 of pent_6 element 2,
       index for node 5 of pent_6 element 2,
       index for node 6 of pent_6 element 2 ),
     ...
     ( index for node 1 of pent_6 element Number_of_Vol_Pents_6,
       index for node 2 of pent_6 element Number_of_Vol_Pents_6,
       index for node 3 of pent_6 element Number_of_Vol_Pents_6,
       index for node 4 of pent_6 element Number_of_Vol_Pents_6,
       index for node 5 of pent_6 element Number_of_Vol_Pents_6,
       index for node 6 of pent_6 element Number_of_Vol_Pents_6 ) ]

   [ ( index for node 1 of hex element 1,
       index for node 2 of hex element 1,
       index for node 3 of hex element 1,
       index for node 4 of hex element 1,
       index for node 5 of hex element 1,
       index for node 6 of hex element 1,
       index for node 7 of hex element 1,
       index for node 8 of hex element 1 ),
     ( index for node 1 of hex element 2,
       index for node 2 of hex element 2,
       index for node 3 of hex element 2,
       index for node 4 of hex element 2,
       index for node 5 of hex element 2,
       index for node 6 of hex element 2,
       index for node 7 of hex element 2,
       index for node 8 of hex element 2 ),
     ...
     ( index for node 1 of hex element Number_of_Vol_Hexs,
       index for node 2 of hex element Number_of_Vol_Hexs,
       index for node 3 of hex element Number_of_Vol_Hexs,
       index for node 4 of hex element Number_of_Vol_Hexs,
       index for node 5 of hex element Number_of_Vol_Hexs,
       index for node 6 of hex element Number_of_Vol_Hexs,
       index for node 7 of hex element Number_of_Vol_Hexs,
       index for node 8 of hex element Number_of_Vol_Hexs ) ] }

 *{ [ reconnection flag for boundary face 1,
      reconnection flag for boundary face 2,
      ...
      reconnection flag for boundary face
      Number_of_Surf_Trias+Number_of_Surf_Quads ] }*

 *{ [ grid boundary condition flag for boundary face 1,
      grid boundary condition flag for boundary face 2,
      ...
      grid boundary condition flag for boundary face
      Number_of_Surf_Trias+Number_of_Surf_Quads ] }*

 *{ [ initial normal spacing for node 1,
      initial normal spacing for node 2,
      ...
      initial normal spacing for node Number_of_Nodes ] }*

Note that in the above description the loops over all boundary faces (1,2,...,
Number_of_Surf_Trias+Number_of_Surf_Quads) the triangular faces are first,
followed by the quadrilateral faces.

The variables used above are defined as follows.

   Number_of_Surf_Quads        : Number of quadrilateral boundary surface
                                 faces.
   Number_of_Surf_Trias        : Number of triangular boundary surface faces.
   Number_of_Vol_Hexs          : Number of hexahedral volume elements.
   Number_of_Vol_Pents_5       : Number of pentahedral volume elements with
                                 five nodes (pyramid).
   Number_of_Vol_Pents_6       : Number of pentahedral volume elements with
                                 six nodes (prismatic).
   Number_of_Vol_Tets          : Number of tetrahedral volume elements.
   Number_of_Nodes             : Number of grid nodes.

In the above description, the parentheses ( ... ) are for grouping, the brackets [ ... ] enclose items in a loop, and braces { ... } enclose items in a single logical record. The items in starred braces *{ ... }* are optional records for grid files that describe a surface grid. If Number_of_Vol_Hexs, Number_of_Vol_Pents_5, Number_of_Vol_Pents_6, or Number_of_Vol_Tets is greater than zero (the grid is a volume grid and not a surface grid) then this data is not read in or written out. The optional records can be included in whole or in
part as long as they are in the correct order. The UG_IO grid file reader will attempt to read the "reconnection flag" first. If it is not found then reading of the file will end. Next, the reader will attempt to read the "grid boundary condition". If it is not found then reading of the file will end. Finally, the reader will attempt to read the "initial normal spacing".

In FORTRAN unformatted form, the data must be written out or read in using the record format defined above. The floating point data items must all be either real*4 or real*8 data.

In C binary form, the data may be written out or read in using records the length of loops or of the individual data items. The floating point data items must all be either float or double data.

In ASCII formatted form, the data may be written out or read in using records the length of loops or of the individual data items. Data items may be written out in free format of any specific form.


SolidMesh Contents SolidMesh User Manual SolidMesh Home