All Frameworks Class Hierarchy This Framework Indexes Previous Next

CATFmtModelInterfaces Interface CATIFmtConnectivity

Usage: you can reimplement this interface by deriving the supplied CATFmtExtIConnectivity adapter class.

interface CATIFmtConnectivity

Interface representing a finite element connectivity.
Role: This interface provides all necessary informations about a finite element connectivity such as dimension, nodes number, edges and faces desciption, ...

Conventions used for method arguments:

Nodes are numbered between 0 and NbNodes - 1.
Edges are numbered between 0 and NbEdges - 1.
Faces are numbered between 0 and NbFaces - 1;
An object backward pointer to an array containing objects data is the last position into the array concerning the object. For example, if you have an array of backward pointers PtDataOfNodes into an array DataOfNodes for the nodes of the connectivity, all the data concerning the i-th node will be located between DataOfNodes[PtDataOfNodes[i]+1] and DataOfNodes[PtDataOfNodes[i+1]]

BOA information: this interface CANNOT be implemented using the BOA (Basic Object Adapter). To know more about the BOA, refer to the CAA Encyclopedia home page. Click Middleware at the bottom left, then click the Object Modeler tab page. Several articles deal with the BOA.

Method Index

o CreateGeometricalEngine(): Creates an returns an new geometrical engine compatible with the connectivity.
o GetEdgeConnectivity(int): Returns the connectivity corresponding to an edge.
o GetEdgesOfFaces(int*&,int*&,int*&): Retrieves the faces definition in term of edges.
o GetEdgesOfNodes(int*&,int*&): Retrieves the edges connected to edges.
o GetEdgesPermutation(): Returns the edges permutation that should be applied in order to reverse the element.
o GetFaceConnectivity(int): Returns the connectivity corresponding to a face.
o GetFacesOfEdges(int*&,int*&): Retrieves the faces connected to edges.
o GetFacesOfNodes(int*&,int*&): Retrieves the faces connected to nodes.
o GetFacesPermutation(): Returns the faces permutation that should be applied in order to reverse the element.
o GetGeometricalEngine(): Returns the geometrical engine associated with the connectivity.
o GetInfos(): Returns general informations on the finite element connectivity (dimension and sizes).
o GetInteriorAngleOfEdges(double*&): Returns the ideal interior angle for each edge.
o GetMainConnectivity(): Returns the connectivity with the same shape and main nodes
o GetName(): Returns the name of the connectivity.
o GetNodesOfEdges(int*&,int*&): Retrieves the edges definition in terms of nodes.
o GetNodesOfFaces(int*&,int*&): Retrieves the faces definition in term of nodes.
o GetNodesPermutation(): Returns the nodes permutation that should be applied in order to reverse the element.
o GetNumber(): Returns the finite element connectivity number.
o GetSIMEdgesMapping(): Returns the nodes mapping that should be applied in order to persist the element in SIM.
o GetSIMFacesMapping(): Returns the nodes mapping that should be applied in order to persist the element in SIM.
o GetSIMName(): Returns the SIM name of the connectivity.
o GetSIMNodesMapping(): Returns the nodes mapping that should be applied in order to persist the element in SIM.
o GetTypeOfNodes(int*&): Retrieves the type of each nodes.
o Next(): Returns the next finite element connectivity.

Methods

o CreateGeometricalEngine

public virtual CreateGeometricalEngine(

)

Creates an returns an new geometrical engine compatible with the connectivity.

o GetEdgeConnectivity

public virtual GetEdgeConnectivity( iNumEdge = 0 )

Returns the connectivity corresponding to an edge.

Parameters:

iNumEdge: Edge number.

Returns:

The connectivity of the edge.

o GetEdgesOfFaces

public virtual GetEdgesOfFaces(	const	`oPtEdgesOfFaces`,
	const	`oEdgesOfFaces`,
	const	`oOrientOfEdges`)

Retrieves the faces definition in term of edges.
The edges of faces should be ordered in sequence in order to define the positive orientation for faces. For a 3D connectivity all the faces should be outward oriented.

Parameters:

oPtEdgesOfFaces

Array containing for each face a backward pointer in oEdgesOfFaces and oOrientOfEdges arrays.

oEdgesOfFaces

Array containing the edges number of the faces.

oOrientOfEdges

Array containing the edges orientation of the faces.
Legal values:

0: The edge is used with its default orientation.
1: The edge is used with its reverse orientation.

Returns:

The number of faces in the connectivity.

o GetEdgesOfNodes

public virtual GetEdgesOfNodes(	const	`oPtEdgesOfNodes`,
	const	`oEdgesOfNodes`)

Retrieves the edges connected to edges.

Parameters:

oPtEdgesOfNodes: Array containing for each node a backward pointer in oEdgesOfNodes array.
oEdgesOfNodes: Array containing the edges number connected to nodes.

Returns:

The number of nodes in the connectivity.

o GetEdgesPermutation

public virtual GetEdgesPermutation(

)

Returns the edges permutation that should be applied in order to reverse the element.

o GetFaceConnectivity

public virtual GetFaceConnectivity( iNumFace = 0 )

Returns the connectivity corresponding to a face.

Parameters:

iNumFace: Face number.

Returns:

The connectivity of the face.

o GetFacesOfEdges

public virtual GetFacesOfEdges(	const	`oPtFacesOfEdges`,
	const	`FacesOfEdges`)

Retrieves the faces connected to edges.

Parameters:

oPtFacesOfEdges: Array containing for each edge a backward pointer in FacesOfEdges array.
FacesOfEdges: Array containing the faces number connected to edges.

Returns:

The number of edges in the connectivity.

o GetFacesOfNodes

public virtual GetFacesOfNodes(	const	`oPtFacesOfNodes`,
	const	`oFacesOfNodes`)

Retrieves the faces connected to nodes.

Parameters:

oPtFacesOfNodes: Array containing for each node a backward pointer in oFacesOfNodes array.
oFacesOfNodes: Array containing the faces number connected to nodes.

Returns:

The number of nodes in the connectivity.

o GetFacesPermutation

public virtual GetFacesPermutation(

)

Returns the faces permutation that should be applied in order to reverse the element.

o GetGeometricalEngine

public virtual GetGeometricalEngine(

)

Returns the geometrical engine associated with the connectivity.

o GetInfos

public virtual GetInfos(

)

Returns general informations on the finite element connectivity (dimension and sizes).

o GetInteriorAngleOfEdges

public virtual GetInteriorAngleOfEdges( const oAnglesOfEdges)

Returns the ideal interior angle for each edge.

Parameters:

oAnglesOfEdges: Array containing for each edge the ideal interior angle.

Returns:

The number of edges in the connectivity.

o GetMainConnectivity

public virtual GetMainConnectivity(

)

Returns the connectivity with the same shape and main nodes

Returns:: The main the connectivity.

o GetName

public virtual GetName(

)

Returns the name of the connectivity.

o GetNodesOfEdges

public virtual GetNodesOfEdges(	const	`oPtNodesOfEdges`,
	const	`oNodesOfEdges`)

Retrieves the edges definition in terms of nodes.
The nodes of edges should be ordered in sequence in order to define the positive orientation for edges.

Parameters:

oPtNodesOfEdges: Array containing for each edge a backward pointer in oNodesOfEdges array.
oNodesOfEdges: Array containing the nodes number of edges.

Returns:

The number of edges in the connectivity.

o GetNodesOfFaces

public virtual GetNodesOfFaces(	const	`oPtNodesOfFaces`,
	const	`oNodesOfFaces`)

Retrieves the faces definition in term of nodes.
Nodes of a face should be ordered in a compatible way with the face connectivity (see method).

Parameters:

oPtNodesOfFaces: Array containing for each face a backward pointer in the oNodesOfFaces array.
oNodesOfFaces: Array containing the nodes number of the faces.

Returns:

The number of faces in the connectivity.

o GetNodesPermutation

public virtual GetNodesPermutation(

)

Returns the nodes permutation that should be applied in order to reverse the element.

o GetNumber

public virtual GetNumber(

)

Returns the finite element connectivity number. Connectivities are numbered between 0 and the total number of elements minus one. Take care of the fact that this number is not stable upon modifications, for example in case of creation of a new connectivity.

o GetSIMEdgesMapping

public virtual GetSIMEdgesMapping(

)

Returns the nodes mapping that should be applied in order to persist the element in SIM.

o GetSIMFacesMapping

public virtual GetSIMFacesMapping(

)

Returns the nodes mapping that should be applied in order to persist the element in SIM.

o GetSIMName

public virtual GetSIMName(

)

Returns the SIM name of the connectivity.

o GetSIMNodesMapping

public virtual GetSIMNodesMapping(

)

Returns the nodes mapping that should be applied in order to persist the element in SIM.

o GetTypeOfNodes

public virtual GetTypeOfNodes( const oTypeOfNodes)

Retrieves the type of each nodes.

Parameters:

oTypeOfNodes

Array containing for each node his type:.
Legal values:

0: Main node.
1: Intermediate node on edge.
2: Intermediate node on face.
3: Intermediate node in volume.

Returns:

The number of nodes in the connectivity.

o Next

public virtual Next(

)

Returns the next finite element connectivity. This method should be used with the method to scan all connectivities.

This object is included in the file: CATIFmtConnectivity.h
If needed, your Imakefile.mk should include the module: CATFmtModelInterfaces