CATFmtModelInterfaces Interface CATIFmtCriterion

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


interface CATIFmtCriterion

Interface representing a finite element quality criterion.
Role: This interface should be re-implemented in order to add a new quality criteria in the finite element quality analysis.

BOA information: this interface can 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 Compute(CATFmtGeometricalEngine*,double&)
Computes the criterion for an finite element.
o ComputeNormalizedValue(double,CATFmtCriterionInfos*,double&,CATFmtCriterionQualityStatus&)
Computes the criterion for an finite element.
o GetInfos(CATIFmtConnectivity*)
Returns informations on the quality criterion such as minimum and maximum value .
o GetMagnitude()
Returns the name of the unit of criteria, empty string by default
o GetName()
Returns the name of the quality criterion.
o IsImplemented(CATIFmtConnectivity*,CATBoolean&)
Determines whether the criterion can be computed for a given connectivity or not.
o IsVisible()
Returns if the criterion is useful by the mesh analysis quality.
o NeedGeometricSupport()
Returns if the criterion needs geometric support.

Methods


o Compute
public virtual Compute( iGeometricalEngine,
oCriterion)
Computes the criterion for an finite element.
Parameters:
iGeometricalEngine
Object which handles all informations on the finite element.
oCriterion
The computed value of the quality criterion.
Returns:
An HRESULT.
Legal values:
S_OK
The computation is succesfull.
E_FAIL
The computation failed.
o ComputeNormalizedValue
public virtual ComputeNormalizedValue( const iCriterion,
const iCriterionInfos,
oNCriterion,
oQStatus)
Computes the criterion for an finite element.
Parameters:
iCriterion
value of quality criterion
iCriterionInfos
Limit values for poor and bad to element
oNCriterion
The computed normalized value:
Values:
0.
Best element (requered).
.01
Poor element(advised).
.1
Bad element (advised).
1.
Worst element (requered).
oQStatus

Legal values:
CATFmtCriterionQualityGood
Good element.
CATFmtCriterionQualityPoor
Poor element.
CATFmtCriterionQualityBad
Bad element.
Returns:
An HRESULT.
Legal values:
S_OK
The computation is succesfull.
E_FAIL
The computation failed.
o GetInfos
public virtual GetInfos( const iConnectivity)
Returns informations on the quality criterion such as minimum and maximum value ...
Parameters:
iConnectivity
The finite element connectivity to be tested.
Returns:
The CATMSHCriterionInfos for iConnectivity.
o GetMagnitude
public virtual GetMagnitude()
Returns the name of the unit of criteria, empty string by default
Returns:

Possible values:
"Length"
The criterion is a length.
"Angle"
The criterion is an angle.
""
Empty string for criterion whitout unit.
"xx"
Any name of magnitude compatible with CATParmDictionary.
o GetName
public virtual GetName()
Returns the name of the quality criterion.
o IsImplemented
public virtual IsImplemented( const iConnectivity,
oImplemented)
Determines whether the criterion can be computed for a given connectivity or not.
Parameters:
iConnectivity
The finite element connectivity to be tested.
oImplemented
  • TRUE : the criterion can be computed.
  • FALSE: the criterion can not be computed..
Returns:
An HRESULT.
Legal values:
S_OK
The criterion can be computed.
E_FAIL
The criterion has no meaning.
o IsVisible
public virtual IsVisible()
Returns if the criterion is useful by the mesh analysis quality.
Returns:
An int.
Legal values:
0
The criterion is ignored.
1
The criterion is use.
o NeedGeometricSupport
public virtual NeedGeometricSupport()
Returns if the criterion needs geometric support.
Returns:
An int.
Legal values:
0
The criterion don't need geometric support.
1
The criterion needs geometric support.

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

Copyright © 1999-2014, Dassault Systèmes. All rights reserved.