Mesh Entity Relationships
[Sierra Toolkit Mesh]

Detailed Description

An seemingly simple relationship between two mesh entities has consequences for entity membership in parts and derived field relationships.

Entity Relation

An entity relation defines a directed relationship between two entities eA and eB. This relationship is directed from the higher ranking entity to the lower ranking entity.
  if ( eA.entity_type() > eB.entity_type() ) {
    // relationship is from eA to eB

Each relationship has two attributes:

The identifier is local to the from entity of the relationship. For example, a relationship from an element entity to a node entity is given local identifier according to the element topology's local numbering system for nodes.

The kind attribute support and application-defined taxonomy of relationships. For example,


Each entity has a set of relations for which that entity is a member. Relations for which the entity is a from members or a to member are included.

Relation Stencil

An entity relation stencil is a mapping of a relation type to an integer value.
    i = stencil( from_entity_type , to_entity_type , identifer , kind );
If the returned integer value is non-negative then a relation of this type is in the domain of the map. Otherwise it is not.

An entity relation stencil is used to induce entity membership in parts and to induce field data pointer values from entity relations.

Part Membership

An entity is becomes a member of a mesh part explicility via the mesh bulk data change entity parts method, and when it membership is induced by its relationships.

Induced membership occurs as per the following simple type-based rule.

Induced membership may also occur as per the following stencil-based rule.

The negation holds for both of these induced membership rules:

Part Membership

A field relation is used to induce field data relationships between related mesh entities.

If the following field relation conditions are satisfied

Note that the non-negative values of the stencil map must be unique over the domain of the stencil.


struct  stk::mesh::PartRelation
 A defined entity-relationship between parts. More...


typedef int(*) stk::mesh::relation_stencil_ptr (unsigned from_type, unsigned to_type, unsigned identifier)
 A relation stencil maps entity relationships to ordinals.

Typedef Documentation

typedef int( * ) stk::mesh::relation_stencil_ptr(unsigned from_type, unsigned to_type, unsigned identifier)

A relation stencil maps entity relationships to ordinals.

A relation stencil function is the inverse mapping of a contiguous span of non-negative integers to a template of entity relations. For example, a triangle-to-vertex relation stencil would map:

If the input entity relationship is within the stencil then a stencil function returns a non-negative integer; otherwise a stencil function returns a negative value.

Definition at line 109 of file Types.hpp.

Generated on Tue Jul 13 09:27:32 2010 for Sierra Toolkit by  doxygen 1.4.7