Table 6.160 — DRM_Mesh_Face_Table

Property

Description

Class

  • <DRM Mesh Face Table>

Superclass

Subclass

  • None.

Definition

An instance of this DRM class specifies a two-dimensional table that defines the face elements of a <DRM Finite Element Mesh> instance in terms of vertex numbers in the ordered <DRM Vertex> component list of the <DRM Finite Element Mesh> instance and, optionally, the topology of the face elements.

The first data element specifies, for cell i,j, the index in the ordered <DRM Vertex> list of the <DRM Vertex> instance representing the jth vertex of the ith mesh face. If the ith mesh face contains less than j vertices, so that j is greater than the number of the last listed vertex of mesh face i, the cell data element contains zero (0). The edges of each mesh face i are implicitly defined by pairing vertex j to vertex j + 1.

For a given mesh face element index i and mesh face node index j, the (i, j)th cell gives the vertex number that comprises the jth node of the ith mesh face. The mesh face vertices are listed (j index) in clockwise order around the outer perimeter of the mesh face, starting and ending with a first vertex. If inner perimeter rings are present, the vertex list along the second axis continues with inner perimeter vertices in counter-clockwise order starting and ending with a first vertex on each inner ring.

The mesh_face_count field specifies the total number of mesh faces in the given <DRM Mesh Face Table> instance.

The maximum_vertices_per_face field specifies the maximum number of vertices in any one face element.

If the adjacent_face_table_present field is set to TRUE, the given <DRM Finite Element Mesh> instance contains face adjacency information in a separate table called the adjacent face table, which has the same dimensions as the mesh face table. The values in the table are positive integer values that specify face indices that represent the row in the mesh face table.

Clarifications

None.

Class diagram

Figure 6.183 — DRM_Mesh_Face_Table

Inherited field elements

Field name

Range

Field data type

None

   

Field elements

Field name

Range

Field data type

mesh_face_count

 

Integer_Positive

maximum_vertices_per_face

 

Integer_Positive

adjacent_face_table_present

 

Boolean

Associated to (one-way) (inherited)

  • None.

Associated to (one-way)

  • None.

Associated by (one-way) (inherited)

  • None.

Associated by (one-way)

  • None.

Associated with (two-way) (inherited)

  • None.

Associated with (two-way)

  • None.

Composed of (two-way) (inherited)

  • None.

Composed of (two-way)

  • None.

Composed of (two-way metadata) (inherited)

  • None.

Composed of (two-way metadata)

  • None.

Component of (two-way) (inherited)

  • None.

Component of (two-way)

Constraints

Example(s)

  • Consider six <DRM Vertex> instances, used to define a <DRM Mesh Face Table>, where the mesh would be diagrammed as follows.

    Mesh Face Table, Example 1

    Figure 6.184 — <DRM Mesh Face Table> example

    In this example, there are six <DRM Vertex> instances forming the vertices of the mesh, which has three mesh faces (A, B, C).

    The corresponding <DRM Mesh Face Table> instance, without surface topology, would be organized as follows, where each individual cell contains a vertex number.

     Vertex number
      1 2 3 4 5
    1 (Mesh face A) 1 2 4 1 0
    2 (Mesh face B) 2 3 6 5 2
    3 (Mesh face C) 4 2 5 4 0

  • Consider the <DRM Mesh Face Table> instance from the previous example, with the addition of surface topology (that is, adjacent_face_table_present set to TRUE. In this instance, each individual cell contains a (vertex number, adjacent mesh face number) pair.

     Vertex number
      1 2 3 4 5
    1 (Mesh face A) 1, 0 2, 3 4, 0 1, 0 0, 0
    2 (Mesh face B) 2, 0 3, 0 6, 0 5, 3 2, 0
    3 (Mesh face C) 4, 1 2, 2 5, 0 4, 0 0, 0