All Frameworks Class Hierarchy This Framework Previous Next Indexes
AnalysisMeshingModel Interface CATIMSHAssociativity
System.IUnknown
|
+---System.IDispatch
|
+---System.CATBaseUnknown
|
+---CATIMSHAssociativity
Usage: an implementation of this interface is supplied and you must use it as is. You should not reimplement it.
interface CATIMSHAssociativity
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,CATMSHAssElementEdge*)
- Associate a set of finite element's edges to a geometry.
- o
AddLinkedElements(int,int,CATMSHElement* const*)
- Associate a set of finite elements to a geometry.
- o
AddLinkedFaces(int,int,CATMSHAssElementFace*)
- Associate a set of finite element's faces to a geometry.
- o
AddLinkedNodes(int,int,CATMSHNode* const*)
- Associate a set of finite element nodes to a geometry.
- o
GetElementEdgesLinkedTo(CATIProduct*,CATBaseUnknown*,CATMSHAssElementEdge*&,int,int)
- Retreives all finite element's edges associated to a geometry.
- o
GetElementFacesLinkedTo(CATIProduct*,CATBaseUnknown*,CATMSHAssElementFace*&,int,int)
- Retreives all finite element's faces associated to a geometry.
- o
GetLink(CATIProduct*,CATGeometry*)
- Creates or retreives a link between the Mesh and the geometry.
- o
GetMeshPartsOn(CATIProduct*,CATBaseUnknown*,CATMSHListOfMeshPart*&)
- Retreives the list of Mesh Parts which have a given support.
- o
GetNodesLinkedTo(int,CATIProduct*[],CATBaseUnknown*[],CATMSHNode**&,int,int)
- Retreives all the finite element nodes associated to a set of geometries.
- o
GetNumberOfElementEdgesLinkedTo(CATIProduct*,CATBaseUnknown*,int)
- Retreives a finite element's edges associated to a geometry.
- o
GetNumberOfElementFacesLinkedTo(CATIProduct*,CATBaseUnknown*,int)
- Retreives the number of finite element's faces associated to a geometry.
- o
GetNumberOfNodesLinkedTo(int,CATIProduct*[],CATBaseUnknown*[],int)
- Retreives the number of finite element nodes associated to a set of geometries.
Methods
o AddLinkedEdges
-
Associate a set of finite element's edges to a geometry.
The geometry is identified by the corresponding link tag, see
GetLink 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 void AddLinkedElements( | int | iNulink, |
| int | iNumberOfElements, |
| CATMSHElement* const* | iLinkedElements)=0 |
-
Associate a set of finite elements to a geometry.
The geometry is identified by the corresponding link tag, see
GetLink 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
-
Associate a set of finite element's faces to a geometry.
The geometry is identified by the corresponding link tag, see
GetLink 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 void AddLinkedNodes( | int | iNulink, |
| int | iNumberOfNodes, |
| CATMSHNode* const* | iLinkedNodes)=0 |
-
Associate a set of finite element nodes to a geometry.
The geometry is identified by the corresponding link tag, see
GetLink 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
-
Retreives all finite element's edges associated to a geometry.
The geometry is identified by the following:
- The product instance containing the geometry to link.
- The geometry itself that could be either:
- Parameters:
-
- iProduct
- The product instance.
- iGeometry
- The geometry (BRep object or mechanical feature).
- ioElementEdges
- An array containing the assocaited element's faces.
Lifecycle rules deviation: If ioElementEdges is set to NULL before calling this method, an array of appropriate size is allocated and should be desallocated by the callee.
Otherwise, the ioElementEdges array is assumed to be allocated with enougth space to store ouputs.
- iActiveOnly
- The element activivity flag (see
CATMSHElement ).
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
-
Retreives all finite element's faces associated to a geometry.
The geometry is identified by the following:
- The product instance containing the geometry to link.
- The geometry itself that could be either:
- Parameters:
-
- iProduct
- The product instance.
- iGeometry
- The geometry (BRep object or mechanical feature).
- ioElementFaces
- An array containing the associated element's faces.
Lifecycle rules deviation: If ioElementFaces is set to NULL before calling this method, an array of appropriate size is allocated and should be desallocated by the callee.
Otherwise, the ioElementFaces array is assumed to be allocated with enougth space to store ouputs.
- iActiveOnly
- The element activivity flag (see
CATMSHElement ).
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 GetLink
-
Creates or retreives a link between the Mesh and the geometry.
Role: This method creates or retreives a link to a geometric object. The link is
identified by a integer tag that should be used in methods
AddLinkedNodes,
AddLinkedEdges,
AddLinkedFaces or
AddLinkedElements.
In order to store associativity between several instance, the geometry is identified by the following:
- The product instance containing the geometry to link.
- The geometry itself.
- Parameters:
-
- iProduct
- The product instance.
- iGeometry
- The geometry to link.
- Returns:
- An integer tag representing the link.
o GetMeshPartsOn
-
Retreives the list of Mesh Parts which have a given support.
The support is identified by a geometry and a product instance.
- Parameters:
-
- iProduct
- The product instance.
- iGeometry
- The geometry (BRep object or mechanical feature).
- oListOfMeshParts
- The list of Mesh Parts found on this support (geometry + product).
- Returns:
- An HRESULT.
Legal values:
- S_OK
- The list of Mesh Parts has been successfully retreived.
- E_FAIL
- The list of Mesh Parts has not been retreived.
o GetNodesLinkedTo
-
Retreives all the finite element nodes associated to a set of geometries.
The geometries are identified by the following:
- The product instance containing the geometry to link.
- The geometry that could be either:
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 maner if an element's face is associated to a geometry all corresponding nodes are considered
as associated to this geometry.
- Parameters:
-
- iNbGeometries
- The number of geometries.
- iProducts
- An array containing for each geometry the corresponding product instance.
- iGeometries
- An array containing the geometries (BRep objects or mechanical features).
- ioNodes
- An array containing the assocaited nodes.
Lifecycle rules deviation: If ioNodes is set to NULL before calling this method, an array of appropriate size is allocated and should be desallocated by the callee.
Otherwise, the ioNodes array is assumed to be allocated with enougth space to store ouputs.
- iActiveOnly
- The element activivity flag (see
CATMSHElement ).
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.
o GetNumberOfElementEdgesLinkedTo
-
Retreives a finite element's edges associated to a geometry.
The geometry is identified by the following:
- The product instance containing the geometry to link.
- The geometry itself that could be either:
- Parameters:
-
- iProduct
- The product instance.
- iGeometry
- The geometry (BRep object or mechanical feature).
- 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 GetNumberOfElementFacesLinkedTo
-
Retreives the number of finite element's faces associated to a geometry.
The geometry is identified by the following:
- The product instance containing the geometry to link.
- The geometry itself that could be either:
- Parameters:
-
- iProduct
- The product instance.
- iGeometry
- The geometry (BRep object or mechanical feature).
- 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 GetNumberOfNodesLinkedTo
-
Retreives the number of finite element nodes associated to a set of geometries.
The geometries are identified by the following:
- The product instance containing the geometry to link.
- The geometry that could be either:
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 maner if an element's face is associated to a geometry all corresponding nodes are considered
as associated to this geometry.
- Parameters:
-
- iNbGeometries
- The number of geometries.
- iProducts
- An array containing for each geometry the corresponding product instance.
- iGeometries
- An array containing the geometries (BRep objects or mechanical features).
- 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: CATIMSHAssociativity.h
If needed, your Imakefile.mk should include the module: CATAmtModel