The following commands are available on the Mesh/Volume subpad.
Symbol |
Command | Description |
| Mesh Volumes | Creates mesh nodes throughout a volume | |
| Smooth Volume Meshes | Adjusts volume mesh node positions to improve uniformity of node spacing | |
| Set Volume Element Type | Specifies volume element types used throughout the model | |
| Link Volume Meshes Unlink Volume Meshes |
Creates or removes mesh hard links between volumes | |
| Modify Meshed Geometry | Converts mesh edges to topological edges | |
| Summarize Volume Mesh
Check Volume Meshes |
Displays mesh information in the graphics window; displays 3-D mesh quality information | |
| Delete Volume Meshes | Deletes existing mesh nodes from volumes |
The following sections describe the purpose and operation of each of the commands listed above.

The Mesh Volumes command allows you to create a mesh for one or more volumes in the model. When you mesh a volume, GAMBIT creates mesh nodes throughout the volume according to the currently specified meshing parameters.
To mesh a volume, you must specify the following parameters:
GAMBIT allows you to specify any volume for a meshing operation; however, the shape and topological characteristics of the volume, as well as the vertex types associated with its faces, determine the type(s) of mesh scheme(s) that can be applied to the volume.
To specify the meshing scheme, you must specify two parameters:
The Elements parameter defines the shape(s) of the elements that are used to mesh the volume. The Type parameter defines the meshing algorithm and, therefore, the overall pattern of mesh elements in the volume.
The following sections describe the parameters listed above and their effects on the overall volume mesh.
GAMBIT allows you to specify any of the following volume meshing Elements options.
| Option | Description |
| Hex | Specifies that the mesh includes only hexahedral mesh elements |
| Hex/Wedge | Specifies that the mesh is composed primarily of hexahedral mesh elements but includes wedge elements where appropriate |
| Tet/Hybrid | Specifies that the mesh is composed primarily of tetrahedral mesh elements but may include hexahedral, pyramidal, and wedge elements where appropriate |
Each of the Elements options listed above is associated with a specific set of Type options (see below).
GAMBIT provides the following volume meshing Type options.
| Option | Description |
| Map | Creates a regular, structured grid of hexahedral mesh elements |
| Submap | Divides an unmappable volume into mappable regions and creates a structured grid of hexahedral mesh elements in each region |
| Tet Primitive | Divides a four-sided volume into four hexahedral regions and creates a mapped mesh in each region |
| Cooper | Sweeps the mesh node patterns of specified "source" faces through the volume |
| Tet/Hybrid | Specifies that the mesh is composed primarily of tetrahedral mesh elements but may include hexahedral, pyramidal, and wedge elements where appropriate |
| Stairstep | Creates a regular hexahedral mesh and a corresponding faceted volume that approximates the shape of the original volume. |
As noted above, each of the Elements options is associated with a specific set of one or more of the Type options. The following table shows the correspondence between each of the volume meshing Elements and Type options. (NOTE: Shaded cells marked with an "X" represent allowable combinations of options.)
Elements Option |
|||
| Type Option | Hex |
Hex/Wedge |
Tet/Hybrid |
| Map | X |
||
| Submap | X | ||
| Tet Primitive | X | ||
| Cooper | X | X | |
| TGrid | X | ||
| Stairstep | X | ||
Each of the allowable combinations shown in the table above results in a unique pattern of mesh nodes for any given volume. In addition, each is associated with a set of restrictions that govern the types of volumes to which it can be applied. The following sections describe the patterns and restrictions associated with each of the allowable combinations of options listed above.
| NOTE (1): Of the Type options listed above, only the Cooper option is associated with more than one Elements option. Therefore, in the following sections, the volume meshing scheme types are differentiated from each other only by their respective Type names-for example, Tet Primitive. |
| NOTE (2): When you specify a volume on the Mesh Volumes form, GAMBIT automatically evaluates the volume with respect to its shape, topological characteristics, and vertex types and sets the Scheme option buttons to reflect a recommended volume meshing scheme. If you specify more than one volume for a meshing operation, the scheme represented by the Scheme option buttons reflects the recommended scheme for the most recently picked volume. If you enforce a meshing scheme, by means of the Scheme option buttons on the Mesh Volumes form, GAMBIT applies the specified scheme to all currently picked volumes. |
| NOTE(3): Some of the meshing schemes listed above create mesh node patterns that cannot be employed by certain solvers that are included in the GAMBIT Solvers menu on the main menu bar. The following table shows the correspondence between the solvers available on the Solvers menu and the mesh scheme types listed above. (NOTE: The FLUENT 4 solver requires a structured grid, and the NEKTON solver requires hexahedral mesh elements.) |
Type Option |
||||||
| Solver | Map |
Submap |
Tet Primitive |
Cooper |
TGrid |
Stairstep |
| FIDAP | X | X | X | X | X | X |
| FLUENT/UNS | X | X | X | X | X | X |
| FLUENT 5/6 | X | X | X | X | X | X |
| FLUENT 4 | X | X | X | X | ||
| NEKTON | X | X | X | X | X | |
| RAMPANT | X | X | X | X | X | X |
| POLYFLOW | X | X | X | X | X | X |
| Generic | X | X | X | X | X | X |
Map Meshing Scheme
When you apply the Map meshing scheme to a volume, GAMBIT meshes the volume using an array of hexahedral mesh elements, such as those shown in Figure 3-51.

Figure 3-51: Map volume meshing scheme-array of hexahedral elements
Each mesh element includes at least eight nodes-located at the corners of the element. If you specify an alternative volume element node pattern, GAMBIT creates either 20 or 27 nodes per mesh element (see "Set Volume Element Type," below).
General Applicability
The Map volume meshing scheme can only be applied to volumes that can be meshed such that the mesh represents a logical cube. To represent a logical cube, a volume mesh must satisfy the following general requirements.
According to the criteria described above, the most basic form of a mappable volume is a rectangular brick, such as that shown in Figure 3-51, above. For such a volume, the mesh nodes located at the corner vertices of the brick constitute the corners of the mesh cube.
Although the strict definition of volume mappability is best expressed in terms of the mesh itself, it is possible to state mappability requirements in terms of the general geometrical configuration of a given volume. Specifically, volume mappability criteria may be stated as follows:
To be mappable, a volume should contain six sides, each of which can be rendered mappable by the correct specification of vertex types.
(For an exception to the criteria described above, see "Mapping Volumes with Less Than Six Faces," below.)
| NOTE: Any side of the volume may consist of more than one face. |
As an example of the application of the general rule stated above, consider the volumes shown in Figure 3-52.

Figure 3-52: Map volume meshing scheme-example volumes
Of the volumes shown in the figure, only the brick shown in Figure 3-52(a) is mappable in its primitive form. However, it is possible to transform the other volumes into mappable volumes by means of vertex-type assignments and virtual geometry operations. The following sections describe the operations required to render each volume mappable.
Transforming Volumes Into Mappable Forms
As noted above, the volumes shown in Figure 3-52(b), (c), and (d) are not mappable in their primitive forms, but each can be transformed into a mappable volume by means of either vertex-type specifications or virtual geometry operations. Specifically, the operations that are required to transform each volume are as follows.
Figure 3-52 |
Shape | Operation |
(b) |
Pentagonal prism | Vertex-type specification |
(c) |
Cylinder | Virtual edge-split |
(d) |
Clipped cube | Virtual face collapse |
Pentagonal Prism-Specifying Vertex Types
To transform the pentagonal prism shown in Figure 3-52(b) into a mappable volume, you must specify its vertex types such that the top and bottom faces are mappable. To do so, you must specify one vertex on each of the top and bottom faces as a Side vertex and all other vertices as End vertices (see Figure 3-53(a)).

Figure 3-53: Mappable pentagonal prism volume
Figure 3-53(b) shows the Map volume mesh that results from the vertex specifications shown in Figure 3-53(a). Note that faces A and B in the figure comprise one side of the logical mesh cube and that face C, by itself, constitutes the opposing side.
When you assign vertex types to transform a prism into a mappable volume, you must specify the vertex types such that the Side vertices on the top and bottom faces are connected to each other by means of a single vertical edge. For example, if you assign vertex types according to the specifications shown in Figure 3-54, GAMBIT cannot create a Map volume mesh in the prism, because the configuration cannot be made to represent a logical mesh cube.

Figure 3-54: Unmappable pentagonal prism volume
Cylinder-Splitting Edges and Faces
The cylinder shown in Figure 3-52(c) is not mappable in its primitive form, but it is possible to transform the cylinder into a mappable volume by means of virtual edge-split and face-split operations. (For descriptions of the virtual edge-split and face-split operations, see the Appendix of this guide.)
If you split the edges that circumscribe the end caps and use the resulting vertices to split the cylindrical face into four separate faces, the end faces become mappable (see Figure 3-55(a)), and the cylinder becomes topologically equivalent to the brick shown in Figure 3-52(a). As a result, the cylinder can be meshed according to the Map meshing scheme (see Figure 3-55(b)).

Figure 3-55: Mappable cylinder
Clipped Cube-Collapsing a Face
The clipped cube shown in Figure 3-52(d) is not mappable in its primitive form, but it can be rendered mappable by means of a virtual face collapse operation. (For a description of the virtual face collapse operation, see the Appendix of this guide.) When you collapse the triangular face between its three neighboring faces, GAMBIT creates the virtual volume shown in Figure 3-56(a).

Figure 3-56: Mappable brick without corner
The volume shown in Figure 3-56(a) is topologically equivalent to the brick shown in Figure 3-52(a). If all of its vertices are specified as End vertices, the volume represents a logical meshing cube and can, therefore, be meshed according to a Map volume meshing scheme (see Figure 3-56(b)).
Mapping Volumes with Less Than Six Faces
As a general rule, the Map volume meshing scheme is applicable only to volumes that include six or more faces. It is possible, however, to transform some volumes that contain fewer than six faces into mappable volumes. As an example of such a transformation, consider the sliver-shaped volume shown in Figure 3-57(a). The volume is bounded by four faces and is not mappable in its primitive form.

Figure 3-57: Mappable volume with four faces
You can transform the sliver-shaped volume shown in Figure 3-57 into a mappable form by performing a virtual split operation on each of the curved edges and specifying the vertex types as follows (see Figure 3-57(b)):
Figure 3-57(c) shows the final form of the Map volume mesh.
Submap Meshing Scheme
When you apply the Submap meshing scheme to a volume, GAMBIT subdivides the volume into logical mesh cubes each of which can be mapped according to a Map meshing scheme.
General Applicability
To be submappable, a volume must be configured such that it satisfies both of the following criteria:
The following sections illustrate each of these criteria.
Face Mappability and Submappability
In order for GAMBIT to apply a Submap meshing scheme to a volume, each face that bounds the volume must be either mappable or submappable. Figure 3-58 shows four volumes, three of which meet the criteria described above. The volumes shown in Figure 3-58(a), (b), and (c) are submappable, because the faces of each volume are, themselves, submappable. The volume shown in Figure 3-58(d) is not submappable, because the end face of the cylindrical protrusion on the top of the volume is neither mappable nor submappable.

Figure 3-58: Submap volume meshing schemesubmappability criterion
The face mappability/submappability criterion described above constitutes a necessary but insufficient condition for volume submappability. It is possible, for example, to construct a volume that cannot be meshed according to the Submap meshing scheme even though all of its faces are either mappable or submappable.
To apply the Submap meshing scheme to a volume, the face vertex types must be specified such that the face submap meshes on opposing faces of the volume are similar in shape and form. As an example of this requirement, consider the volume shown in Figure 3-59. The volume consists of an L-shaped brick the outside corner of which is truncated at an angle.

Figure 3-59: Submap volume meshing schemeL-shaped volume
The L-shaped faces that comprise the top and bottom sides of the volume can be submapped in a number of ways, each of which is a function of the vertex types that are assigned to the faces. Figure 3-59 shows face submap meshes that result from three different configurations of vertex types.
The configurations shown in Figure 3-59(a) and (b) can be meshed according to the Submap volume meshing scheme, because the vertex types and meshes on the top and bottom faces of the volume are consistent with each other. By contrast, GAMBIT cannot apply the Submap volume meshing scheme to the volume shown in Figure 3-59(c), because the Submap meshes on the top and bottom faces differ in form.
Tet Primitive Meshing Scheme
The Tet Primitive volume meshing scheme applies only to volumes that constitute logical tetrahedra. To constitute a logical tetrahedron, a volume must include only four sides, each of which constitutes a logical triangle. (NOTE: Any side of the logical tetrahedron may consist of more than one face.) When you apply the Tet Primitive meshing scheme, GAMBIT creates Tri Primitive meshes on each of the faces of the tetrahedron, then subdivides the volume into four hexahedral quadrants and creates a Map-type volume mesh in each quadrant.
As an example of the Tet Primitive meshing scheme, consider the tetrahedral volume shown in Figure 3-60(a). If you apply the Tet Primitive meshing scheme to the volume, GAMBIT creates Tri Primitive meshes on each face (see Figure 3-60(b)), then subdivides the volume into four quadrants and meshes each quadrant with hexahedral mesh elements. Figure 3-60(c) shows a cutaway view of the final mesh.

Figure 3-60: Tet Primitive volume meshing scheme
Cooper Meshing Scheme
When you apply the Cooper meshing scheme to a volume, GAMBIT treats the volume as consisting of one or more logical cylinders each of which is composed of two end caps and a barrel (see Figure 3-61). Faces that comprise the caps of such cylinders are called "source" faces; faces that comprise the barrels of the cylinders are called "non-source" faces. (For restrictions related to the specification of faces for the Cooper meshing scheme, see "Face Characteristics," below.)

Figure 3-61: Cooper volume meshing scheme-logical cylinder
The Cooper meshing scheme involves the following operations.
Step |
Operation |
1 |
Create Map and/or Submap meshes on each of the non-source faces. |
2 |
Imprint the source faces onto each other. |
3 |
Mesh the source faces. |
4 |
Project the source-face mesh node patterns through the volume |
As an example of the procedure outlined above, consider the volume shown in Figure 3-62. The volume represents the union of a cube, a cylinder, and a triangular prism.

Figure 3-62: Cooper volume meshing scheme-example volume
If you apply the Cooper meshing scheme to the volume shown in Figure 3-62, GAMBIT performs the following operations (see Figure 3-63).
Step |
Operation |
1 |
Mesh the non-source faces (see Figure 3-63(a)). |
2 |
Imprint the source faces onto each other (see Figure 3-63(b)). (NOTE: Regions A' and B' represent the imprinting of faces A and B, respectively.) |
3 |
Mesh each of the source faces (see Figure 3-63(c)). |
4 |
Project the source-face mesh node patterns through the volume (see Figure 3-63(d)). |

Figure 3-63: Cooper volume meshing scheme-example volume
General Applicability
In general, the Cooper meshing scheme applies to volumes that demonstrate either of the following characteristics.
Faces that meet either of the criteria outlined above, as well as those that are logically parallel to such faces, constitute source faces for the volume and the end caps of the corresponding logical cylinder.
| NOTE: The Submap volume meshing scheme, described above, constitutes a special version of the Cooper meshing scheme. If a volume is configured such that it can be meshed by either the Submap scheme or the Cooper scheme, it is usually desirable to mesh the volume by means of the Submap scheme. |
The Cooper volume meshing scheme imposes the following restrictions on the volumes to which it applies.
Figure 3-64 shows four volumes that illustrate the application of the criteria outlined above.

Figure 3-64: Non-Cooper-able volumes
The volumes shown in Figure 3-64 violate the restrictions outlined above for the following reasons.
Volume |
Criterion |
Reason |
Figure 3-64(a) |
(1) |
It is impossible to construct a logical cylinder the barrel of which is mappable. |
Figure 3-64(b) |
(2) |
GAMBIT cannot imprint the mesh from faces B and C onto face A, because face A possesses an existing mesh. |
Figure 3-64(c) |
(3) |
The top and bottom faces of the logical cylinder each include an internal edge loop (see NOTE, below). |
Figure 3-64(d) |
(4) |
Face A is linked to face B, therefore GAMBIT cannot imprint the face A mesh onto face B, because the imprint would violate the operation of the mesh link. |
|
NOTE: To apply the Cooper meshing scheme to a volume
such as that shown in Figure 3-64(c), you must first split the upper and lower rectangular
source faces as shown in Figure 3-65.
Figure 3-65: Cooper-able volume with internal edge loops |
Specifying Source Faces
When you apply the Cooper volume meshing scheme to a volume, you must specify the source faces that define the end caps of the logical cylinder. The source faces also define the longitudinal direction of the logical cylinder. For certain volumes, there exist more than one valid set of source faces. For such volumes, the final form of the mesh depends, in part, on the selection of source faces.
| NOTE: When you specify a Cooper meshing scheme for a volume, GAMBIT automatically determines which faces are likely source faces. To override the automatically selected set of source faces, specify an alternative set of faces on the Mesh Volumes form. |
As an example of the effect of source-face selection on a mesh, consider the annular volume shown in Figure 3-66. The volume includes four faces-the end faces, labeled A and B, and the inner and outer cylindrical faces, labeled C, and D, respectively.

Figure 3-66: Annular volume
If you mesh the annular volume by means of a Cooper volume meshing scheme and specify faces A and B as the source faces, GAMBIT maps the inner and outer cylinders and paves the end faces, then sweeps the paved mesh through the annular volume along its axis. The resulting mesh appears as shown in Figure 3-67(a), below.

Figure 3-67: Cooper mesh of an annular volume, end source faces
If you specify faces C and D as the source faces, GAMBIT maps the end faces and paves the inner and outer cylindrical faces, then sweeps the paved mesh node pattern in a radial direction through the volume. The resulting mesh appears as shown in Figure 3-67(b).
| NOTE (1): In the example given above, the inner and outer faces are regular in shape, therefore, the paved meshes on the cylindrical faces are identical in appearance to mapped mesh node patterns. |
| NOTE (2): There are no restrictions on the types of face-meshing schemes that can be applied to faces that constitute source faces for the Cooper volume meshing scheme. For example, if you apply a Tri-Pave meshing scheme to a source face and employ a Cooper meshing scheme, GAMBIT creates wedge elements in the meshed volume. |
TGrid Meshing Scheme
When you apply the TGrid meshing scheme to a volume, GAMBIT creates a mesh that consists primarily of tetrahedral mesh elements but which may also contain elements that possess other shapes. If you mesh one or more faces of the volume by means of a Quad or Quad/Tri scheme before applying the TGrid volume meshing scheme, GAMBIT creates hexahedral, pyramidal, and/or wedge elements where appropriate in proximity to the previously meshed faces.
The TGrid meshing algorithm may be summarized as follows.
Step |
Description |
1 |
Mesh all unmeshed faces by means of a Tri-Pave scheme |
2 |
If boundary layers are attached to any of the faces on the volume, generate hexahedral or prism elements in the regions adjacent to the boundary layers and to faces that contain quadrilateral or triangular face elements, respectively.) |
3 |
If any quadrilateral face elements exist on the volume faces (or the tops of their attached boundary layers), generate pyramidal volume elements to create a transition from the associated hexahedral/quadrilateral elements to the tetrahedral elements that will occupy the remainder of the volume. |
4 |
Mesh the remainder of the volume with tetrahedral elements. |
As an example of effect of face meshes on the TGrid scheme, consider the rectangular brick volume shown in Figure 3-68. Figure 3-68(a) shows the general shape of the tetrahedral mesh elements that are created in the volume if none of the faces are meshed prior to the application of the TGrid scheme or if all pre-meshed faces are meshed by means of a Tri-Pave scheme. If you create a Quad-Map mesh on one of the faces of the brick prior to applying the TGrid meshing scheme (see Figure 3-68(b)), GAMBIT creates an array of pyramidal mesh elements in proximity of that face (see Figure 3-68(c)) and creates tetrahedral elements throughout the rest of the volume.

Figure 3-68: TGrid meshing scheme
| NOTE (1): The TGrid meshing scheme imposes no restrictions on the types of edge or face meshes that can be previously applied to the volume. |
| NOTE (2): You can control the refinement for the tetrahedral mesh by means of the GAMBIT program defaults. The program defaults also allow you to control several aspects of prism boundary layer elements. For a description of the use of GAMBIT program defaults, see the GAMBIT User's Guide. |
| NOTE (3): In general, it is best to avoid creating quadrilateral face mesh elements with aspect ratios greater than 5 on the boundaries of any volume to be meshed by means of the TGrid meshing scheme. Face mesh elements with high aspect ratios produce highly skewed transition pyramidal elements. As a result, the TGrid volume meshing may fail or produce low-quality elements. |
| NOTE (4): If you employ a face boundary layer when meshing a volume by means of the TGrid meshing scheme, it is best to attach the boundary layer to the face itself rather than to its bounding edges. If you apply the boundary layers to the bounding edges rather than to the face, the TGrid scheme will create pyramidal elements on the side faces but not on the face itself. As a result, the volume will not contain boundary layers of transition elements in the region adjacent to the face. |
The Stairstep meshing scheme creates and meshes a faceted volume the shape of which approximates the volume to be meshed. GAMBIT does not mesh the original volume itself, and the created faceted volume is not connected to any existing geometryincluding geometry to which the original volume is connected.
As an example of the effect of the Stairstep meshing scheme, consider the volume (volume.1) shown in Figure 3-69. The volume is an elliptical cylinder 10 units long with major and minor axis radii of 5 and 3 units, respectively.

If you mesh the elliptical cylinder shown in Figure 3-69 by means
of the Stairstep scheme using
an overall interval size of 1, GAMBIT creates and meshes the faceted
volume (f_volume.2) shown
in Figure 3-70. Note that the shape of the faceted volume crudely
approximates the shape of the original elliptical cylinder and
that all mesh elements are cubic hexahedra of uniform size.

Using a Template Mesh Volume
In the general Stairstep meshing scheme described above, the created mesh consists entirely of cubic hexahedral mesh elements the sizes of which can vary according to user-specified default settings and any existing mesh information associated with edges and/or faces of the volume to be meshed. It is possible, however, to employ a template mesh volume that serves as an initial overlay grid to start the Stairstep meshing procedures. In some cases, the use of a template mesh volume can greatly improve the density and element quality of the Stairstep mesh. To employ a template mesh volume, you must create and mesh a volume that completely encloses the volume to be meshed by the Stairstep scheme. You can mesh the template mesh volume using any applicable volume meshing schemesuch as Cooper or Mapbut the template mesh must consist of 8-node hexahedral elements and must not contain any hanging nodes. GAMBIT uses the mesh of the template mesh volume as the initial subdivision for the Stairstep scheme.
Stairstep Mesh Refinement
Overview
If you apply the Stairstep meshing scheme to a volume that includes edges and/or faces for which mesh interval size information exists, GAMBIT refines the hexahedral mesh in the region of the edges and/or faces. If the existing interval length for an edge is less than the overall length specified for the Stairstep scheme, GAMBIT creates smaller cubic hexahedral mesh elements in the proximity of the edge and also creates a transition region located near to the edge. For example, if you specify an interval size of 0.5 for the elliptical front face of volume.1 in Figure 3-69 and mesh the volume using the Stairstep scheme with an overall interval length specification of 1, GAMBIT creates the meshed, faceted volume shown in Figure 3-71.

Refinement Options
GAMBIT provides three different options for refining the mesh in the Stairstep scheme. One option allows the existence of hanging nodes such as those shown in Figure 3-71. The other two options disallow the existence of hanging nodes by propagating the refined mesh either across the volume in the directions of the coordinate axes to the limit of the volume boundaries or throughout the entire volume.
You can control the Stairstep mesh refinement algorithm by means of a GAMBIT default variable named STAIRSTEP_MESH_TYPE. To modify the STAIRSTEP_MESH_TYPE default variable:
The value of the STAIRSTEP_MESH_TYPE default variable affects Stairstep mesh refinement in the following manner.
Value |
Description |
0 |
Allows hanging nodes in the region of mesh refinement |
1 |
Disallows hanging nodes by propagating the refined mesh in the directions of the coordinate axes to the volume boundaries |
2 |
Disallows hanging nodes by propagating the refined mesh throughout the volume |
As an example of the effect of the STAIRSTEP_MESH_TYPE default variable on the Stairstep mesh, consider the volume shown in Figure 3-72. The volume consists of a cube with a spherical cut-out in one corner. Each edge of the cube is 10 units long, and the sphere radius is 4 units.
Figure 3-72: Stairstep meshing schemecube with cutout corner
Figure 3-73 shows the effect of the STAIRSTEP_MESH_TYPE default variable value on the final Stairstep mesh configuration. In each case, the edge interval lengths for the straight and curved edges are 1.0 and 0.25, respectively.

General Applicability
The Stairstep meshing scheme
is applicable to all volumes.
Specifying Volume Meshing Options
GAMBIT includes the following primary options on the Mesh Volumes form:
If you select the Mesh option, GAMBIT meshes the picked volume(s) according to the parameters as currently specified on the Mesh Volumes form. If you Apply the meshing specifications without selecting the Mesh option, GAMBIT applies the currently specified mesh parameters to the volume(s) but does not create the mesh.
Remove old mesh Option
If you select the Remove old mesh option, GAMBIT deletes any currently existing mesh from the specified volume(s). If you delete a volume mesh using the Remove old mesh option, GAMBIT enables the Remove lower mesh optionwhich allows you to specify whether or not to delete the mesh on the faces and edges that define the volume. If you select the Remove lower mesh option, GAMBIT deletes the face and edge mesh(es) when it deletes the volume mesh(es). If you do not select the option, GAMBIT deletes the volume mesh but retains any associated face and edge meshes.
Ignore size functions Option
If you select the Ignore size functions option, GAMBIT ignores any existing size function specifications that would otherwise affect the volume mesh.
To open the Mesh Volumes form (see below), click the Mesh command button on the Mesh/Face subpad.

The Mesh Volumes form contains the following options and specifications.
| Volumes | specifies the volume(s) to be meshed. |
| Scheme: | ------------------------- |
| Apply | specifies that the meshing scheme indicated on the option button is applied to all currently picked volumes. |
Default |
resets the meshing scheme option button to its default algorithm value (Undetermined). |
| Elements: | ------------------------ |
| Hex Hex/Wedge Tet/Hybrid |
specifies the types of elements to be used in meshing the volume(s). |
| Type: | ------------------------ |
| Map Submap Tet Primitive Cooper TGrid Stairstep |
specifies the type of meshing scheme to apply to the
volume(s). NOTE (1): If you specify the Cooper meshing scheme, GAMBIT displays a Sources list box (see below) that allows you to specify source faces for the scheme.
NOTE (2): If you specify the Stairstep meshing scheme, GAMBIT displays a Template list box (see below) that allows you to specify a template mesh volume as the starting point for the Stairstep algorithm.
|
| Spacing: | ------------------------- |
| Apply | specifies that the current mesh node spacing parameters are applied to all currently specified volume(s). |
Default |
resets the mesh node spacing parameters to their default values. |
| Value | specifies the numerical component of the mesh node spacing parameters. |
| Interval size Interval count Shortest edge (%) |
specifies the measurement unit for the mesh node spacing parameters. |
| Options | ------------------------- |
| Mesh | specifies that a new mesh is created in the specified volume(s). |
| Remove old mesh | specifies the deletion of any current mesh that is associated with the specified volume(s) and created by means of the Mesh Volumes form. |
| Lower unused mesh | specifies that all lower-topology (face and edge) meshes associated with the specified volume(s) are deleted when the volume mesh is deleted unless they are associated with other meshed topology. |
| Ignore size functions | specifies that GAMBIT ignores any existing size-function specifications that would otherwise affect the volume mesh. |

The Smooth Volume Meshes command allows you to smooth the spacing of mesh nodes throughout one or more volumes.
When you smooth a volume mesh, GAMBIT automatically adjusts mesh node locations in order to improve the uniformity of spacing between nodes throughout the mesh. To smooth a volume mesh, you must specify the following parameters:
Specifying the Smoothing Scheme
GAMBIT provides the following mesh smoothing schemes:
The following table summarizes the basic features of the algorithms employed by each scheme.
| Algorithm | Features |
| Length-weighted Laplacian | Uses the average edge length of the elements surrounding each node |
| Equipotential | Adjusts node locations to equalize the volumes of the mesh elements surrounding each node |
Using the Smooth Volume Meshes Form
To open the Smooth Volume Meshes form (see below), click the Smooth Mesh command button on the Mesh/Volume subpad.

The Smooth Volume Meshes form contains the following options and specifications.
| Volumes | specifies the volume(s) for which the mesh is to be smoothed. |
| Scheme | ------------------------- |
| L-W Laplacian Equipotential |
specifies the mesh smoothing algorithm. (For a general description of each algorithm, see "Specifying the Smoothing Scheme," above.) |
| Smooth Edges | specifies that mesh nodes located on the edges of the volume faces are included in the smoothing operation. |
| Smooth Faces | specifies that mesh nodes located on all faces associated with the volume are included in the smoothing operation. |

The Set Volume Element Type command allows you to specify the number of mesh nodes and the node pattern associated with any of four available volume element shapes.
To set the volume element type, you must specify the numbers of nodes associated with each of the volume element shapes. There are four volume element shapes available in GAMBIT:
Every volume element shape is associated with as many as five different node patterns. Each node pattern is characterized by the number of nodes in the pattern. The node patterns associated with each volume element shape are as follows:
Shape |
Numbers of Nodes |
Hexahedron |
8, 20, 27 |
Wedge |
6, 15, 18 |
Tetrahedron |
4, 10 |
Pyramid |
5, 13, 14 |
When you set a volume element type, GAMBIT applies the specified mesh node pattern to all volume elements of the specified shape. For example, if you specify 20-node wedge volume elements, GAMBIT locates mesh nodes according to the 20-node pattern for all wedge volume elements produced in the subsequent volume meshing operation.
Figure 3-74, Figure 3-75, Figure 3-76, and Figure 3-77 show the placement of nodes for each of the node patterns listed above.

Figure 3-74: Hexahedron volume element node patterns

Figure 3-75: Wedge volume element node patterns

Figure 3-76: Tetrahedron volume element node patterns

Figure 3-77: Pyramid volume element node patterns
Using the Set Volume Element Type Form
To open the Set Volume Element Type form (see below), click the Set Volume Element Type command button on the Mesh/Volume subpad.

The Set Volume Element Type form contains the following specifications.
| Hexahedron | specifies the hexahedron volume element type: 8 node, 20 node, or 27 node. |
| Wedge | specifies the wedge volume element type: 6 node, 15 node, or 18 node. |
| Tetrahedron | specifies the tetrahedron volume element type: 4 node or 10 node. |
| Pyramid | specifies the pyramid volume element type: 5 node, 13 node, or 14 node. |
3.4.4 Link/Unlink Volume Meshes
The Link/Unlink Volume Meshes command button allows you to perform the following operations.
| Symbol | Command | Description |
| Link Volume Meshes | Creates hard links between volumes | |
| Unlink Volume Meshes | Deletes hard links between volumes |
The following sections describe the procedures and specifications required to execute the operations listed above.

The Link Volume Meshes command allows you to create a hard link between two volumes. When you mesh a volume that is hard-linked to another volume, GAMBIT applies identical mesh parameters to both volumes. The volumes to be linked must satisfy the following criteria:
Figure 3-78: Example volumes to be hard-linked
To create a hard link between the two volumes, you must first create hard links between face.1 and face.4, face.2 and face.5, and face.3 and face.6. (For instructions on the creation of hard links between faces, see "Link Face Meshes," in Section 3.3.6, above.)
Using the Link Volume Meshes Form
To open the Link Volume Meshes form (see below), click the Link command button on the Mesh/Volume subpad.

The Link Volume Meshes form contains the following specifications.
| Volume | specifies the first of two volumes to be hard-linked. |
| Link With | ------------------------- |
| Volume | specifies the second of the two volumes to be hard-linked. |

The Unlink Volume Meshes command allows you to delete an existing link between two volumes. To delete the link, you must specify both volumes associated with the link.
Using the Unlink Volume Meshes Form
To open the Unlink Volume Meshes form (see below), click the Unlink command button on the Mesh/Volume subpad.

The Unlink Volume Meshes form contains the following options and specifications.
| Volumes | specifies the volumes between which the link is to be deleted. |
| Lower topology | specifies that any face or edge hard links that are associated with the volume hard link are deleted along with the volume hard link. |

The Modify Meshed Geometry command allows you to convert exterior mesh edges to topological edges. When you convert a mesh edge to a topological edge, GAMBIT creates a real straight edge the endpoints of which are located at the mesh-node endpoints of the mesh edge.
For a description of the procedures and specifications involved in creating a conversion list, see "Modify Meshed Geometry," in Section 3.3.7, above.
Using the Modify Meshed Geometry Form
To open the Modify Meshed Geometry form (see below), click the Modify Meshed Geometry command button on the Mesh/Volume subpad.

For a general description of the procedures and specifications involved in using the Modify Meshed Geometry form, see "Using the Modify Meshed Geometry Form," in Section 3.3.7, above.
3.4.6 Summarize Volume Mesh / Check Volume Meshes
The Summarize Volume Mesh / Check Volume Meshes command buttons let you perform the following operations.
Symbol |
Command | Description |
| Summarize Volume Mesh | Summarizes general volume mesh information in the Transcript window | |
| Check Volume Meshes | Displays 3-D mesh quality information in the Transcript window |
The following sections describe the procedures and specifications required to execute the operations listed above.
The Summarize Volume Mesh command displays a summary of volume mesh information in the Transcript window.
Using the Summarize Volume Mesh Form
To open the Summarize Volume Mesh form (see below), click the Summarize command button on the Mesh/Volume subpad.

For a general description of the use of the Summarize Volume Mesh form, see Section 3.3.8, above.
The Check Volume Meshes command displays 3-D mesh quality data. When you execute the Check Volume Meshes command, GAMBIT displays the following elements in the Transcript window:
The Check Volume Meshes tabular output represents the statistical distribution of element mesh quality values for the current default 3-D quality metric. Table 3.2 shows an example of such output for a volume mesh evaluated according to the EquiAngle Skew quality metric. Output such as that shown in Table 3.2 constitutes a numerical representation of the mesh quality histogram that is displayed on the Examine Mesh form when you choose the Display Type: Range option (see Section 3.4.2 of the GAMBIT User's Guide).
From value To value Count in range % of total count (1463)
-----------------------------------------------------------------
0 0.1 286 19.55
0.1 0.2 671 45.86
0.2 0.3 341 23.31
0.3 0.4 88 6.02
0.4 0.5 66 4.51
0.5 0.6 11 0.75
0.6 0.7 0 0.00
0.7 0.8 0 0.00
0.8 0.9 0 0.00
0.9 1 0 0.00
-----------------------------------------------------------------
0 1 1463 100.00
In addition to the tabular output shown in Table 3.2, the Check Volume Meshes command displays the minimum and maximum values of element quality for the set of specified volumes, thus:
Measured minimum value: 0.0274079
Measured maximum value: 0.553874
This minimum and maximum element quality information is not available
by means of any other GAMBIT operation.
Specifying the Quality Metric
As noted above, the Check Volume Meshescommand evaluates mesh element quality according to the current default 3-D mesh quality metric. To change the metric used to evaluate element quality for the Check Volume Meshes command, you must modify the default 3-D mesh quality metric by means of the Edit Defaults form. To do so:
(For a complete description of the procedures required to modify default variables by means of the Edit Defaults form, see Section 4.2.4 of the GAMBIT User's Guide.)
For example, to evaluate 3-D elements on the basis of the Aspect Ratio metric:
Summary Statement
The Check Volume Meshes summary statement indicates the number of specified volumes that "fail" the mesh check-for example,
0 out of 2 meshed volumes(s)failed mesh check.
In the context of the Check Volume Meshes command, any volume that includes at least one inverted mesh element fails the mesh check.
Using the Check Volume Meshes Form
To open the Check Volume Meshes form (see below), click the Check command button on the Mesh/Volume subpad.

The Check Volume Meshes form contains the following specification.
| Volumes | specifies the volumes for which mesh element quality is to be evaluated. |

The Delete Volume Meshes command allows you to delete the mesh from one or more volumes. When you delete a volume mesh, GAMBIT allows you to retain or delete all face meshes and edge meshes associated with the volume.
Using the Delete Volume Meshes Form
To open the Delete Volume Meshes form (see below), click the Delete command button on the Mesh/Volume subpad.

The Delete Volume Meshes form contains the following options and specifications.
| Volumes | specifies the volume(s) for which the mesh is to be deleted. |
| All Pick |
|
| Remove unused lower mesh | specifies that all face meshes and edge meshes associated with the specified volume(s) are to be deleted along with the volume mesh(es). |