NX Open C++ Reference Guide
|
This class provides interfaces to query analysis results.
More...
This class provides interfaces to query analysis results.
To query results you must first understand how the results are structured. The basic structure is as follows
Results are divided into Load Cases(loadcase). Loadcase is a general term which could representand of the follow based on solution type
The number of Loadcases can be obtained by using CAE::Result::AskNumLoadcases . When querying information for a loadcase you will use the loadcase index ( 0 to n-1 ), where n is the number of loadcases. Each Loadcase is divided into multiple iterations, although for many results there will be only 1 iteration. Based on solution type, these iterations could represent
The number of iterations for a given loadcase can be obtained by using CAE::Result::AskNumIterations and specify the loadcase index. When querying information for a specific iteration, you will use both the loadcase and iteration index. Within an iteration query all the available Result types using CAE::Result::AskResultTypes
A Result type is defined by three parameters
The Results object also contains information on the finite element model for which results may be accessed. The number of nodes in this results model can be obtained by using CAE::Result::AskNumNodes . The number of elements in this results model can be obtained by using CAE::Result::AskNumElements . Elements are also organized in several groups (of type CAE::Result::GroupContainer ) based on the element type, material and physical property. One can query the number of each group type and its content.
Nodes and Elements in result the file are addressed by their index which varies from 1 to number of nodes/elements. Node and Element can have a user label associated with it. User labels are unique and have one to one mapping with its index.
An instance of this class can not be obtained
Created in NX5.0.0.
Result components.
ComponentScalar |
scalar |
ComponentX |
x |
ComponentY |
y |
ComponentZ |
z |
ComponentMagnitude |
magnitude |
ComponentXx |
xx |
ComponentYy |
yy |
ComponentZz |
zz |
ComponentXy |
xy |
ComponentYz |
yz |
ComponentZx |
zx |
ComponentDeterminant |
determinant |
ComponentMean |
mean |
ComponentMaximumShear |
maximum shear |
ComponentMinimumPrincipal |
minimum principal |
ComponentMiddlePrincipal |
middle principal |
ComponentMaximumPrincipal |
maximum principal |
ComponentOctahedral |
octahedral |
ComponentVonMises |
von mises |
ComponentMembraneXX |
membrane xx |
ComponentMembraneYY |
membrane yy |
ComponentMembraneXY |
membrane xy |
ComponentBendingXX |
bending xx |
ComponentBendingYY |
bending yy |
ComponentBendingXY |
bending xy |
ComponentShearYZ |
shear yz |
ComponentShearXZ |
shear xz |
ComponentAxial |
axial |
ComponentBendingS |
bending s |
ComponentBendingT |
bending t |
ComponentTorsion |
torsion |
ComponentShearS |
shear s |
ComponentShearT |
shear t |
ComponentSpringDashpotForce |
No longer used; it means CAE::Result::ComponentSpringDashpotForceX in new format. |
ComponentSpringDashpotForceX |
spring dashpot force x |
ComponentSpringDashpotForceY |
spring dashpot force y |
ComponentSpringDashpotForceZ |
spring dashpot force z |
ComponentSpringDashpotMomentX |
spring dashpot moment x |
ComponentSpringDashpotMomentY |
spring dashpot moment y |
ComponentSpringDashpotMomentZ |
spring dashpot moment z |
ComponentScalar1 |
scalar1 |
ComponentScalar2 |
scalar2 |
ComponentScalar3 |
scalar3 |
ComponentScalar4 |
scalar4 |
ComponentScalar5 |
scalar5 |
ComponentScalar6 |
scalar6 |
Coordinate systems.
CoordinateSystemAbsoluteRectangular |
absolute rectangular |
CoordinateSystemAbsoluteCylindrical |
absolute cylindrical |
CoordinateSystemAbsoluteSpherical |
absolute spherical |
CoordinateSystemWorkRectangular |
work rectangular |
CoordinateSystemWorkCylindrical |
work cylindrical |
CoordinateSystemWorkSpherical |
work spherical |
CoordinateSystemLocal |
local |
CoordinateSystemMaterial |
Material coordinate system is applicable only when such coordinate systems are defined in the results model; if no material coordinate system is defined CAE::Result::CoordinateSystemAbsoluteRectangular will be used. |
CoordinateSystemSelectRectangular |
select rectangular |
CoordinateSystemSelectCylindrical |
select cylindrical |
CoordinateSystemSelectSpherical |
select spherical |
Result data types.
DataTypeScalar |
scalar |
DataTypeVector |
vector |
DataTypeSixVector |
six vector |
DataTypeTensor |
tensor |
DataTypeElementResultantShell |
element resultant shell |
DataTypeElementResultantBeam |
element resultant beam |
DataTypeElementResultantSpringDashpot |
element resultant spring dashpot |
DataTypeSixScalars |
Applicable for CAE::Result::QuantitySolidLaminateFailureIndex. |
Group Containers.
Result locations.
Result quantities.
Result sections.
This enumeration defines the methods that can be used when calculating absolute values for the following derived components of CAE::Result::DataTypeTensor CAE::Result::ComponentDeterminant , CAE::Result::ComponentMean , CAE::Result::ComponentMaximumShear , CAE::Result::ComponentMinimumPrincipal , CAE::Result::ComponentMiddlePrincipal , CAE::Result::ComponentMaximumPrincipal , CAE::Result::ComponentOctahedral.
CAE::Result::TensorDerivedAbsoluteAllComponents will make all tensor primary components (XX, YY, ZZ, XY, YZ, ZX) to absolute and then calculate derived component. CAE::Result::TensorDerivedAbsoluteDerivedComponent is absolute value of derived component without changing primary components.
int NXOpen::CAE::Result::AskElementIndex | ( | int | elementLabel | ) |
Ask element index of a given element user label.
elementLabel | elementlabel |
int NXOpen::CAE::Result::AskElementLabel | ( | int | elementIndex | ) |
Ask element user label of a given element index.
elementIndex | element index ranges from 1 to N (number of elements) |
void NXOpen::CAE::Result::AskElementNodes | ( | int | elementIndex, |
std::vector< int > & | nodeIndex | ||
) |
Asks for the nodes given an element
Created in NX6.0.2.
License requirements : nx_masterfem ("Finite Element Modeling") OR nx_design_sim ("NX Design Simulation")
elementIndex | elementindex |
nodeIndex | nodeindex |
NXOpen::CAE::ElementTypes::Shape NXOpen::CAE::Result::AskElementShape | ( | int | elementIndex | ) |
Ask element shape given an element index.
elementIndex | Element Index |
std::vector<NXString> NXOpen::CAE::Result::AskIterations | ( | int | loadcaseIndex | ) |
Number of iterations available for a given loadcase and their descriptions Iteration index varies from 0 to N-1 (number of iterations)
loadcaseIndex | loadcaseindex |
std::vector<NXString> NXOpen::CAE::Result::AskLoadcases | ( | ) |
Number of loadcases available in the result file and their descriptions.
Loadcase index varies from 0 to N-1 (number of loadcases)
std::vector<NXOpen::Point3d> NXOpen::CAE::Result::AskNodeCoordinates | ( | const std::vector< int > & | nodeIndex | ) |
Asks for the coordinates of a node array.
nodeIndex | nodeindex |
int NXOpen::CAE::Result::AskNodeIndex | ( | int | nodeLabel | ) |
Ask node index of a given node user label.
nodeLabel | nodelabel |
int NXOpen::CAE::Result::AskNodeLabel | ( | int | nodeIndex | ) |
Ask node user label of a given node index.
nodeIndex | node index ranges from 1 to N (number of nodes) |
Ask number of elements in the model Element index varies from 0 to N-1 (number of elements)
void NXOpen::CAE::Result::AskNumElementsOfGroup | ( | NXOpen::CAE::Result::GroupContainer | type, |
int | groupIndex, | ||
std::vector< int > & | elementIndex | ||
) |
Returns an array of elements indices for a given group Group index range from 0 to N-1 (number of groups)
Created in NX6.0.2.
License requirements : nx_masterfem ("Finite Element Modeling") OR nx_design_sim ("NX Design Simulation")
type | type |
groupIndex | groupindex |
elementIndex | elementindex |
Returns the number of groups available in the model of type CAE::Result::GroupContainer .
type | type |
int NXOpen::CAE::Result::AskNumIterations | ( | int | loadcaseIndex | ) |
Number of iterations available for a given loadcase.
loadcaseIndex | loadcaseindex |
Number of loadcases available in the result file.
int NXOpen::CAE::Result::AskNumNodes | ( | ) |
Ask number of nodes in the model Node index varies from 1 to N (number of nodes)
NXOpen::CAE::Result::DataType NXOpen::CAE::Result::AskResultDataType | ( | int | loadcaseIndex, |
int | iterationIndex, | ||
const NXOpen::CAE::Result::Type & | resultType | ||
) |
Ask result datatype.
loadcaseIndex | loadcaseindex |
iterationIndex | iterationindex |
resultType | resulttype |
NXOpen::CAE::Result::LoadcaseValueType NXOpen::CAE::Result::AskResultLoadcaseValue | ( | int | loadcaseIndex, |
NXString * | description, | ||
double * | value | ||
) |
Ask load case description, value type and value for the input load case.
loadcaseIndex | load case |
description | description |
value | value |
void NXOpen::CAE::Result::AskResultSections | ( | int | loadcaseIndex, |
int | iterationIndex, | ||
const NXOpen::CAE::Result::Type & | resultType, | ||
std::vector< int > & | sectionNums | ||
) |
Ask element ids and corresponding number of sections at which result is defined
Created in NX6.0.3.
License requirements : nx_masterfem ("Finite Element Modeling") OR nx_design_sim ("NX Design Simulation")
loadcaseIndex | load case |
iterationIndex | iteration number |
resultType | result type |
sectionNums | sectionnums |
void NXOpen::CAE::Result::AskResultTypes | ( | int | loadcaseIndex, |
int | iterationIndex, | ||
std::vector< NXOpen::CAE::Result::Type > & | types, | ||
std::vector< NXString > & | description | ||
) |
Returns an array of result types and descriptions available for a given loadcase and iteration
Created in NX6.0.2.
License requirements : nx_masterfem ("Finite Element Modeling") OR nx_design_sim ("NX Design Simulation")
loadcaseIndex | loadcaseindex |
iterationIndex | iterationindex |
types | types |
description | description |
Ask Section description provided section type.
sect | section type |
NXOpen::TaggedObject* NXOpen::CAE::Result::Find | ( | const NXString & | journalIdentifier | ) |
Returns a CAE::BaseLoadcase.
journalIdentifier | Journal identifier of the object |
std::vector<NXOpen::CAE::BaseLoadcase *> NXOpen::CAE::Result::GetLoadcases | ( | ) |
Ask the loadcases present in this result.
void NXOpen::CAE::Result::GetResultCoordinateSystemDefinition | ( | int | id, |
NXOpen::CAE::Result::CoordinateSystem * | type, | ||
NXOpen::Point3d * | origin, | ||
NXOpen::Matrix3x3 * | matrix | ||
) |
Returns definitions of a result coordinate system
Created in NX8.0.1.
License requirements : nx_masterfem ("Finite Element Modeling") OR nx_design_sim ("NX Design Simulation")
id | id |
type | returns any of CAE::Result::CoordinateSystemSelectRectangular , CAE::Result::CoordinateSystemSelectCylindrical , CAE::Result::CoordinateSystemSelectSpherical |
origin | origin |
matrix | matrix |
std::vector<int> NXOpen::CAE::Result::GetResultCoordinateSystems | ( | ) |
Returns coordinate system IDs defined in the result.
bool NXOpen::CAE::Result::IsResultTypeComplex | ( | int | loadcaseIndex, |
int | iterationIndex, | ||
const NXOpen::CAE::Result::Type & | resultType | ||
) |
Ask whether a result type is complex or not.
loadcaseIndex | loadcaseindex |
iterationIndex | iterationindex |
resultType | resulttype |