Mesh Interface

Overview

The MeshInterface class implements a query interface between Mesh objects and finite element data. Function pointers are used to query finite element model and results data. If a MeshInterface object interfaces to finite element data maintained by the host application, it is the responsibility of the user to implement the appropriate query functions. If a Mesh object maintains the finite element data, then the MeshInterface function pointers are set automatically.

The functions associated with a MeshInterface object are the following.

Initialize and manage interface
- initialize() - Initialize function pointers
- copy() - Copy interface from another object
- getErrorCode() - Get error code
Set and query function pointers
- setFunction() - Set function pointer
- getFunction() - Get function pointer
- setFunctionError() - Set error handling function pointer
Query mesh topology and counts
- getEntityCount() - Get number of entities (nodes/elements)
- getTopology() - Get element topology
- getMaxElementNodes() - Get maximum nodes in any element
- getElementNodeCount() - Get node count for an element
Query element and node data
- getElementNodes() - Get node indices for an element
- getCoordinates() - Get node coordinates
Query element entities (faces/edges)
- getElementEntityCount() - Get entity count in an element
- getElementEntityConnectivity() - Get entity node connectivity
- getElementEntityConnectionNumbers() - Get entity connection numbers
- getElementEntityCornerConnectionNumbers() - Get corner connection numbers
- getElementEntityTopology() - Get entity topology
Query associations (element/node/faces/edges)
- getElementAssociation() - Get element associations
- getNodeAssociation() - Get node associations
- getElementEntityAssociation() - Get element entity association
Query reverse connectivity
- getMaxElementCountConnectedToNode() - Get maximum elements connected to node
- getElementsConnectedToNode() - Get get elements connected to a node
- getAdjacentElements() - Get elements adjacent to a given element
- getElementCountConnectedToNode() - Get number of elements connected to node
- getElementsAdjacentToNodes() - Get elements adjacent to nodes
Query part data
- getPartName() - Get part name string
- getPartNameCount() - Get number of partnames
- getPartInformation() - Get specific partname
Miscellaneous
- getExtent() - Get node coordinate extent
- getDimension() - Get the spatial dimension
- getIntegrationPointCount() - Get number of element integration points

Initialize the interface using initialize(). This sets all function pointers to NULL. The query functions such as getEntityCount(), getTopology(), and getCoordinates() are used to retrieve mesh data. These functions internally call the registered callback functions to access the data.

For interfaces to application-maintained data, the user must implement and register all necessary callback functions. If using a Mesh object to store data, the mesh automatically registers the appropriate callbacks.

Class Members Descriptions

The currently available MeshInterface functions are described in detail in this section.

class MeshInterface

Interface for accessing mesh data from external sources.

Public Types

enum class Function

Function type identifiers for mesh interface.

Values:

enumerator GET_ENTITY_COUNT: Get the number of entities (nodes/elements)

enumerator GET_TOPOLOGY: Get element topology information.

enumerator GET_ELEMENT_NODES: Get node indices for an element.

enumerator GET_MAX_ELEMENT_NODES: Get maximum number of nodes in any element.

enumerator GET_COORDINATES: Get node coordinates (float precision)

enumerator GET_NODE_ASSOCIATION: Get node association information.

enumerator GET_ELEMENT_ASSOCIATION: Get element association information.

enumerator GET_ELEMENT_ENTITY_COUNT: Get number of entities (faces/edges/nodes) in an element.

enumerator GET_ELEMENT_ENTITY_CONNECTIVITY: Get node connectivity for an element entity.

enumerator GET_ELEMENT_ENTITY_TOPOLOGY: Get topology of an element entity.

enumerator GET_ADJACENT_ELEMENTS: Get elements adjacent to a specified element.

enumerator GET_MAX_ELEMENT_COUNT_CONNECTED_TO_NODE: Get maximum number of elements connected to any node.

enumerator GET_ELEMENTS_CONNECTED_TO_NODE: Get elements connected to a node.

enumerator GET_EXTENT: Get spatial extent (float precision)

enumerator GET_ELEMENT_ENTITY_CONNECTION_NUMBERS: Get connection numbers for an element entity.

enumerator GET_ELEMENTS_ADJACENT_TO_NODE: Get elements adjacent to a set of nodes.

enumerator GET_COORDINATES_DOUBLE_PRECISION: Get node coordinates (double precision)

enumerator SET_ERROR: Set error handling function.

enumerator GET_ELEMENT_NODE_COUNT: Get number of nodes in an element.

enumerator GET_ELEMENT_COUNT_CONNECTED_TO_NODE: Get number of elements connected to a node.

enumerator GET_ELEMENT_ENTITY_CORNER_CONNECTION_NUMBERS: Get corner connection numbers for an element entity.

enumerator GET_DIMENSION: Get dimensionality of the model.

enumerator GET_EXTENT_DOUBLE_PRECISION: Get spatial extent (double precision)

enumerator GET_ELEMENT_ENTITY_ASSOCIATION: Get association for an element entity.

enumerator GET_INTEGRATION_POINT_COUNT: Get number of integration points in an element.

enumerator GET_PARTNAME: Get name of a part.

enumerator GET_PARTNAME_COUNT: Get number of named parts.

enumerator GET_PART_INFORMATION: Get part information by index.

Public Functions

HOOPS_CAE_EXTERN ErrorCode getErrorCode ()

Return the current ErrorCode of the MeshInterface object.

Returns:	`ErrorCode` - The current error code, or `NONE` if no error.

HOOPS_CAE_EXTERN Status initialize ()

Initialize all function pointers to NULL.

Returns:	Status

HOOPS_CAE_EXTERN Status setFunction (Function functionType, Vfunc *function)

Set pointer to grid function. The function descriptions are identical to the associated Mesh functions.

See Also getCoordinates

Parameters:	indexCount – Number of nodes indexes – Array of node indices coordinates – [out] Array of node coordinates [indexCount][3]
Returns:	Status

HOOPS_CAE_EXTERN Status getCoordinates (int indexCount, int indexes[], double coordinates[][3])

Gather node coordinates in double precision.

See Also getCoordinates

Parameters:	indexCount – Number of nodes indexes – Array of node indices coordinates – [out] Array of node coordinates [indexCount][3]
Returns:	Status

HOOPS_CAE_EXTERN Status getNodeAssociation (NodeAssociationType type, int indexCount, int indexes[], int associations[])

Get node associations, associations, for a set of specified nodes indexes.

See Also getExtent

Errors: VALUE is generated if group is not a node group.

Parameters:	group – Pointer to Group object of nodes. If NULL, then all nodes are assumed. extent – [out] World coordinates of points at minimum x,y,z and maximum x,y,z.
Returns:	Status

HOOPS_CAE_EXTERN Status getExtent (Group *group, double extent[2][3])

Return the coordinates of two points defining the world coordinate extent box of a set of nodes in double precision. The point extent[0] is the minimum and the point extent[1] is the maximum. If no node point coordinates have been specified, then the contents of extent are undefined.

See Also getExtent

Errors: VALUE is generated if group is not a node group.

Parameters:	group – Pointer to Group object of nodes. If NULL, then all nodes are assumed. extent – [out] World coordinates of points at minimum x,y,z and maximum x,y,z.
Returns:	Status

HOOPS_CAE_EXTERN Status getElementNodeCount (int index, int *count)

Get the number of nodes in an element.

See Also getCoordinates

Parameters:	function – Pointer to float coordinates function
Returns:	Status

HOOPS_CAE_EXTERN Status setFunctionGetCoordinatesDouble (GetCoordinatesDoubleFunction *function)

Set the function pointer for gathering node coordinates in double precision.

See Also getCoordinates

Parameters:	function – Pointer to double coordinates function
Returns:	Status

HOOPS_CAE_EXTERN Status setFunctionGetNodeAssociation (GetNodeAssociationFunction *function)

Set the function pointer for querying node associations.

See Also getExtent

Parameters:	function – Pointer to float extent function
Returns:	Status

HOOPS_CAE_EXTERN Status setFunctionGetExtentDouble (GetExtentDoubleFunction *function)

Set the function pointer for computing the node coordinate extent in double precision.

See Also getExtent

Parameters:	function – Pointer to double extent function
Returns:	Status

HOOPS_CAE_EXTERN Status setFunctionGetElementNodeCount (GetElementNodeCountFunction *function)

Set the function pointer for querying the number of nodes in an element.

Parameters:	index – Element index shape – [out] Element shape type maxi – [out] Maximum index in i-direction maxj – [out] Maximum index in j-direction maxk – [out] Maximum index in k-direction
Returns:	Status

Parameters:	entityType – Type of element feature `FACE` `EDGE` `NODE` elementIndex – Element index to get connected elements entityNumber – Element face, edge or node number elementCount – [out] Number of elements connected to specified element elementIndexes – [out] Array of connected element indices
Returns:	Status

Parameters:	entityType – `EntityType` `EDGE` `FACE` `NODE` index – Element index count – [out] Number of entities in the element
Returns:	Status

Parameters:	entityType – `EntityType` `EDGE` `FACE` index – Element index entityNumber – Entity number on the element nodeCount – [out] Number of connection numbers connectionNumbers – [out] Array of connection numbers
Returns:	Status

Mesh Interface

Overview

Class Members Descriptions

Hello! I'm HOOPSY