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:


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
public virtual void AddLinkedEdges(int iNulink,
int iNumberOfEdges,
CATMSHAssElementEdge* iLinkedEdges)=0
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
public virtual void AddLinkedFaces(int iNulink,
int iNumberOfFaces,
CATMSHAssElementFace* iLinkedFaces)=0
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
public virtual int GetElementEdgesLinkedTo(CATIProduct* iProduct,
CATBaseUnknown* iGeometry,
CATMSHAssElementEdge*& ioElementEdges,
int iActiveOnly= 0 ,
int iAssembly= 0 )=0
Retreives all finite element's edges associated to a geometry.
The geometry is identified by the following:
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
public virtual int GetElementFacesLinkedTo(CATIProduct* iProduct,
CATBaseUnknown* iGeometry,
CATMSHAssElementFace*& ioElementFaces,
int iActiveOnly= 0 ,
int iAssembly= 0 )=0
Retreives all finite element's faces associated to a geometry.
The geometry is identified by the following:
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
public virtual int GetLink(CATIProduct* iProduct,
CATGeometry* iGeometry)=0
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:
Parameters:
iProduct
The product instance.
iGeometry
The geometry to link.
Returns:
An integer tag representing the link.
o GetMeshPartsOn
public virtual HRESULT GetMeshPartsOn(CATIProduct* iProduct,
CATBaseUnknown* iSupport,
CATMSHListOfMeshPart*& oListOfMeshParts)=0
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
public virtual int GetNodesLinkedTo(int iNbGeometries,
CATIProduct*[] iProducts,
CATBaseUnknown*[] iGeometries,
CATMSHNode**& ioNodes,
int iActiveOnly= 0 ,
int iAssembly= 0 )=0
Retreives all the finite element nodes associated to a set of geometries.
The geometries are identified by the following:
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
public virtual int GetNumberOfElementEdgesLinkedTo(CATIProduct* iProduct,
CATBaseUnknown* iGeometry,
int iAssembly= 0 )=0
Retreives a finite element's edges associated to a geometry.
The geometry is identified by the following:
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
public virtual int GetNumberOfElementFacesLinkedTo(CATIProduct* iProduct,
CATBaseUnknown* iGeometry,
int iAssembly= 0 )=0
Retreives the number of finite element's faces associated to a geometry.
The geometry is identified by the following:
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
public virtual int GetNumberOfNodesLinkedTo(int iNbGeometries,
CATIProduct*[] iProducts,
CATBaseUnknown*[] iGeometries,
int iAssembly= 0 )=0
Retreives the number of finite element nodes associated to a set of geometries.
The geometries are identified by the following:
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

Copyright © 2003, Dassault Systèmes. All rights reserved.