All Frameworks Class Hierarchy This Framework Indexes Previous Next

CATFmtModelInterfaces Interface CATIFmtAssociativity

Usage: an implementation of this interface is supplied and you must use it as is. You should not reimplement it.

interface CATIFmtAssociativity

Interface representing the Mesh Associativity.
Role: The Mesh Associativity is the object which manage all links between the Mesh (nodes and elements) and the geometry.
In order to be consistent the following rules should be applied when creating links between nodes/elements and geometry:

Do not link finite element objects (nodes and elements) with more than one geometric object.
Link finite element objects (nodes and elements) with geometric object of same dimension: node with vertex, finite element's edge with geometric edge, finite element's face with geometric face.
Create links with topological objects, rather than geometrical objects: vertex/point, edge/curve , face/surface.
If a finite element has only one edge, associate the entire element to the geometry rather than the element's edge. In the same manner, if a finite element has only one face, associate the entire element to the geometry rather than the element's face.

Method Index

o AddLinkedEdges(int,int,CATFmtEdge*): Associate a set of finite element's edges to a geometry.
o AddLinkedElements(int,int,CATFmtElement* const*): Associate a set of finite elements to a geometry.
o AddLinkedFaces(int,int,CATFmtFace*): Associate a set of finite element's faces to a geometry.
o AddLinkedNodes(int,int,CATFmtNode* const*): Associate a set of finite element's nodes to a geometry.
o GetElementEdgesLinkedTo(CATFmtPath*,CATFmtListOfFEEntities*&,int,int): Retrieves all finite element's edges associated to a geometry.
o GetElementFacesLinkedTo(CATFmtPath*,CATFmtListOfFEEntities*&,int,int): Retrieves all finite element's faces associated to a geometry.
o GetElementsLinkedTo(CATFmtPath*,CATFmtListOfFEEntities*&,int,int): Retrieves all finite elements associated to a geometry.
o GetLink(CATFmtPath*,CATGeometry*): Creates or retrieves a link between the Mesh and the geometry.
o GetNodesLinkedTo(CATFmtPath*,CATFmtListOfFEEntities*&,int,int): Retrieves all the finite element nodes associated to a set of geometries.

Methods

o AddLinkedEdges

public virtual AddLinkedEdges(		`iNulink`,
		`iNumberOfEdges`,
		`iLinkedEdges`)

Associate a set of finite element's edges to a geometry.
The geometry is identified by the corresponding link tag, see method.

Parameters:

iNulink: The link tag corresponding to the geometry.
iNumberOfEdges: The number of finite element's edge to associate.
iLinkedEdges: An array containing pointer to the finite element's edges to associate.

o AddLinkedElements

public virtual AddLinkedElements(		`iNulink`,
		`iNumberOfElements`,
		`iLinkedElements`)

Associate a set of finite elements to a geometry.
The geometry is identified by the corresponding link tag, see method.

Parameters:

iNulink: The link tag corresponding to the geometry.
iNumberOfElements: The number of finite elements to associate.
iLinkedElements: An array containing pointer to the finite elements to associate.

o AddLinkedFaces

public virtual AddLinkedFaces(		`iNulink`,
		`iNumberOfFaces`,
		`iLinkedFaces`)

Associate a set of finite element's faces to a geometry.
The geometry is identified by the corresponding link tag, see method.

Parameters:

iNulink: The link tag corresponding to the geometry.
iNumberOfFaces: The number of finite element's face to associate.
iLinkedFaces: An array containing pointer to the finite element's faces to associate.

o AddLinkedNodes

public virtual AddLinkedNodes(		`iNulink`,
		`iNumberOfNodes`,
		`iLinkedNodes`)

Associate a set of finite element's nodes to a geometry.
The geometry is identified by the corresponding link tag, see method.

Parameters:

iNulink: The link tag corresponding to the geometry.
iNumberOfNodes: The number of finite element nodes to associate.
iLinkedNodes: An array containing pointer to the finite element nodes to associate.

o GetElementEdgesLinkedTo

public virtual GetElementEdgesLinkedTo(	`iSupport`,
	`oElementEdges`,
	`iActiveOnly`	`= 0` ,
	`iAssembly`	`= 0` )

Retrieves all finite element's edges associated to a geometry.
The geometry is identified by the following:

The support containing the path of the geometry to link.
The geometry itself that could be either:
- A BRep object see .
- A mechanical feature see

Parameters:

iSupport

A Path to the geometry (BRep object or mechanical feature).

ioElementEdges

An list containing the associated element's faces.

iActiveOnly

The element activivity flag (see

Legal values

0: all associated element's edges are returned.
1: only edges corresponding to active elements are returned.

iAssembly

To specify the target in the context of assembly of Analysis:
Legal values:

0: the element's edges are searched in the current Analysis.
1: the element's edges are searched in the current Analysis and all sub Analysis.

Returns:

The number of finite element's edges associated to the geometry.

o GetElementFacesLinkedTo

public virtual GetElementFacesLinkedTo(	`iSupport`,
	`oElementFaces`,
	`iActiveOnly`	`= 0` ,
	`iAssembly`	`= 0` )

Retrieves all finite element's faces associated to a geometry.
The geometry is identified by the following:

The support containing the path with the geometry to link.
The geometry itself that could be either:
- A BRep object see .
- A mechanical feature see

Parameters:

iSupport

A Path to the geometry (BRep object or mechanical feature).

ioElementFaces

An list containing the associated element's faces.

iActiveOnly

The element activivity flag (see

Legal values

0: all associated element's faces are returned.
1: only faces corresponding to active elements are returned.

iAssembly

To specify the target in the context of assembly of Analysis:
Legal values:

0: the element's faces are searched in the current Analysis.
1: the element's faces are searched in the current Analysis and all sub Analysis.

Returns:

The number of finite element's faces associated to the geometry.

o GetElementsLinkedTo

public virtual GetElementsLinkedTo(	`iSupport`,
	`oElements`,
	`iActiveOnly`	`= 0` ,
	`iAssembly`	`= 0` )

Retrieves all finite elements associated to a geometry.
The geometry is identified by the following:

The support containing the path of the geometry to link.
The geometry itself that could be either:
- A BRep object see .
- A mechanical feature see

Parameters:

iSupport

A Path to the geometry (BRep object or mechanical feature).

oElements

An list containing the assocaited elements.

iActiveOnly

The element activivity flag (see

Legal values

0: all associated elements are returned.
1: only active elements are returned.

iAssembly

To specify the target in the context of assembly of Analysis:
Legal values:

0: the elements are searched in the current Analysis.
1: the elements edges are searched in the current Analysis and all sub Analysis.

Returns:

The number of finite elements associated to the geometry.

o GetLink

public virtual GetLink(		`iSupport`,
		`iGeometry`)

Creates or retrieves a link between the Mesh and the geometry.
Role: This method creates or Retrieves a link to a geometric object. The link is identified by a integer tag that should be used in methods , , or .
In order to store associativity between several instance, the geometry is identified by the following:

The support containing the link with the geometry to link.
The geometry itself.

Parameters:

iSupport: object managing and containing the link with geometry .
iGeometry: The geometry to link.

Returns:

An integer tag representing the link.

o GetNodesLinkedTo

public virtual GetNodesLinkedTo(	`iSupport`,
	`oNodes`,
	`iActiveOnly`	`= 0` ,
	`iAssembly`	`= 0` )

Retrieves all the finite element nodes associated to a set of geometries.
The geometries are identified by the following:

The support containing the path of the geometries to link.
The geometry that could be either:
- A BRep object see .
- A mechanical feature see

Finite element nodes inherit from elements associativity, i.e. if an element's edge is associated to a geometry all corresponding nodes are considered as associated to this geometry. In the same manner if an element's face is associated to a geometry all corresponding nodes are considered as associated to this geometry.

Parameters:

iSupport

A Path to the geometry (BRep object or mechanical feature).

ioNodes

A list containing the associated nodes.

iActiveOnly

The element activivity flag (see

Legal values

0: all associated nodes are returned.
1: only nodes corresponding to active elements are returned.

iAssembly

To specify the target in the context of assembly of Analysis:
Legal values:

0: the nodes are searched in the current Analysis.
1: the nodes are searched in the current Analysis and all sub Analysis.

Returns:

The number of finite element nodes associated to the geometries.

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