This class holds the solution result data that can be accessed, directly related to the solution. The solution result class will be initialized with the unit system specified for the Design Assessment analysis. Only when a valid unit system and type are set will results obtained be converted correctly to the expected result units.
Results are organized in sets; each set contains the results at a given time, frequency, etc. depending upon the analysis type. It is more efficient to get all the required results at a given set, before changing sets. For convenience the set can be identified automatically by defining a time or frequency. If the value is not exact then the results will be interpolated from the adjacent values.
If the value cannot be obtained (for example, requesting elemental values for a nodal result), the maximum value for a double type is returned (1.79769e+308).
Note: DefineCoordinateSystem and CoordinateSystem are mutually exclusive; if both are used, the last one defined takes precedence.
Table 105: Members
| Name | Type | Description |
|---|---|---|
| Name | string | Gets or sets the name of the result, so that it can be found from the solution class. |
| ElementNodalValues(int ElementId, int NodeId) | double[] | Array of values of an element nodal result at the given ElementId and NodeId. The size of the returned array will depend upon the number of result components. If required, this can be determined using ComponentCount or the python len() function. |
| ElementalValues(int ElementId) | double[] | Array of values of an element result at the given ElementId. The size of the returned array will depend upon the number of result components. If required, this can be determined using ComponentCount or the python len() function. |
| NodalValues(int NodeId) | double[] | Array of values of a nodal result at the given NodeId. The size of the returned array will depend upon the number of result components. If required, this can be determined using ComponentCount or the python len() function. |
| DisplayStyle | string |
Returns the DisplayStyle: i.e. if it’s a Vector, Tensor, Scalar, etc. The returned string can be used to programmatically set the ResultGroup’s DisplayStyle. Note: the returned value is dependent on provided Expression and IntegrationMethod, so these should be called beforehand. |
| DisplayType | string |
Returns the DisplayType: i.e. if it’s a Nodal, Elemental or ElementNodal result. The returned string can be used to programmatically set the ResultGroup’s DisplayType. Note: the returned value is dependent on provided Expression and IntegrationMethod, so these should be called beforehand. |
| ComponentCount | int |
Returns the number of components for this result, typically 1, 3, or 6. Note: the returned value is dependent on provided Expression and IntegrationMethod, so these should be called beforehand. |
| ResultSetCount | int | Returns the total number of results sets for this system. The Result Set count is read directly from the underlying file containing the results.. |
| Expression | string | Set the expression by assigning a string. Valid expressions are the same as those used for user defined results and can include mathematical modifiers. |
| CoordinateSystem | string |
Sets the coordinate system type by assigning a string. Valid inputs are either the name of a user coordinate system in the Mechanical application or one of the following: Global (default) Solution The solution coordinate system is generally associated with beam based results. |
| DefineCoordinateSystem(string Axes, double Axis1X, double Axis1Y, double Axis1Z, double Axis2X, double Axis2Y, double Axis2Z, double OriginX, double OriginY, double OriginZ) | void |
Defines a custom coordinate system orientation matrix to obtain results in. Use as an alternative to CoordinateSystem to enable an axis to be defined directly in the python code. Axes is one of the following strings used to define what two axes of the orientation matrix are being entered, the third axis is calculated automatically. XY YZ ZX |
| SetUnitsSystem(string UnitsSystem, string RotationUnit, string TemperatureUnit) | void |
Defines the units system that the results are to be obtained in. If a string is blank, then the default is assumed. Options for UnitsSystem are: MKS: i.e. Metric (m, Kg, N, s, V, A), (Default) UMKS: i.e. Metric (µm, Kg, µN, s, mV, mA) CGS: i.e. Metric (cm, g, dyne, s, V, A) NMM: i.e. Metric (mm, Kg, N, s, mV, mA) LBFT: i.e. US Customary (ft, lbm, lbf, s, V, A) LBIN: i.e. US Customary (in, lbm, lbf, s, V, A) Options for RotationUnit are: Degrees Radians (Default) Options for TemperatureUnit are: Kelvin Celsius (Default for metric systems) For US Customary, Fahrenheit is always used and the entered value is ignored. |
| ResultType | string |
Gets or Sets the ResultType. ResultType string should be set to one of the values listed for DisplayUnits keyword in the DAResult section of the XML definition file. No Units is the default value. If not set or left as default No Units, any results obtained will not be unit converted to the appropriate units for the Design Assessment system. |
| IntegrationMethod | string |
Defines the integration method used when obtaining results by assigning a string. Valid options are: UnAveraged Averaged (default) Nodal Difference Nodal Fraction Elemental Mean Elemental Difference Elemental Fraction Different Integration options can affect the DisplayType. |
| ResultSet | int |
Defines the set that data is obtained from by assigning an integer value. It is recommended that this method is used to specify which results are to be obtained for Modal, Spectrum, and Response Spectrum analyses. Assigning 0 will obtain data from the last result set in the analysis. Default is based on the entry in the Solution Selection table. |
| ResultTimeFrequency | double |
Defines the time or frequency that data is obtained from by assigning a real number to indicate the time or frequency. Whether it is defining Time or Frequency 1 is determined automatically from the analysis type. Assigning 0.0 will obtain data from the last time or frequency in the analysis. If the analysis is time or frequency independent then the ResultSet property can be used instead. Default is based on the entry in the Solution Selection table. |
| ShellLayer | int |
Define the layer for which to obtain results. In the case of composite sections, assigning ShellLayer to a positive integer can be used to define the layer number. Alternatively, assign 0 for the whole section; this is default behavior. See also ShellFaceResultDisplay. Only applicable to shell elements. |
| ShellFaceResultDisplay | string |
Define what results are displayed on the faces of shell elements by assigning a string. Valid entries are: Top (i.e. results calculated for the top face on both faces) Bottom (i.e. results calculated for the bottom face on both faces) Middle (i.e. calculated middle values on both faces - see Surface Body Results (including Layered Shell Results) for details) Only applicable to shell elements. |
1 - Obtaining frequency based results is not presently supported.