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> 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 vertex index j, the (i, j)th cell gives the vertex number that comprises the jth vertex 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 counterclockwise 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 <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 termed the adjacent face table, which has the same dimensions as the mesh face table. The values in the adjacent face table are positive integer values that specify face indexes that represent the row in the mesh face table.

Class diagram

Figure 6.190 — 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

Default field values

Default field values for DRM_Mesh_Face_Table

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

Clarifications

None.

Example(s)

  • Consider six <DRM Vertex> instances, used to define a <DRM Mesh Face Table> instance, where the mesh is diagrammed as depicted in Figure 6.191:

    Mesh Face Table, Example 1

    Figure 6.191 — <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, is 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 indicated by 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