Results and Result Tools (Group)

Defines the engineering output for displaying and analyzing the results from a solution.

Applies to the following objects:

CategoryObject
StructuralBending Stress, Bolt Tool, Campbell Diagram, Directional Acceleration, Damage Status, Directional Deformation, Directional Velocity, Elastic Strain Intensity, Energy Dissipated Per Unit Volume, Equivalent Creep Strain, Equivalent Plastic Strain, Equivalent Stress, Equivalent Total Strain, Fiber Compressive Damage Variable, Fiber Compressive Failure Criterion, Fiber Tensile Damage Variable, Fiber Tensile Failure Criterion, Frequency Response, Linearized Stresses, Max Failure Criteria, Matrix Compressive Damage Variable, Matrix Compressive Failure Criterion, Matrix Tensile Damage Variable, Matrix Tensile Failure Criterion, Maximum Principal Elastic Strain, Maximum Principal Stress, Maximum Shear Elastic Strain, Maximum Shear Stress, Membrane Stress, Middle Principal Elastic Strain, Middle Principal Stress, Minimum Principal Elastic Strain, Minimum Principal Stress, Mullins Damage Variable, Mullins Max Previous Strain Energy, Normal Elastic Strain, Normal Gasket Pressure, Normal Gasket Total Closure, Normal Stress, Phase Response, Sheer Damage Variable, Shear Elastic Strain, Shear Gasket Pressure, Shear Gasket Total Closure, Shear Stress, Strain Energy, Stress Intensity, Structural Error, Thermal Strain, Total Acceleration, Total Deformation, Total Velocity, Vector Principal Elastic Strain, Vector Principal Stress
Structural BeamsAxial Force, Beam Tool, Bending Moment, Direct Stress, Maximum Bending Stress, Maximum Combined Stress, Minimum Bending Stress, Minimum Combined Stress, Shear Force, Shear-Moment Diagram, Torsional Moment
ThermalDirectional Heat Flux, Temperature, Thermal Error, Total Heat Flux, Fluid Flow Rate, Fluid Heat Conduction Rate
MagnetostaticCurrent Density, Directional Field Intensity, Directional Flux Density, Directional Force, Electric Potential, Flux Linkage, Inductance, Magnetic Error, Total Field Intensity, Total Flux Density, Total Force
ElectricDirectional Current Density, Directional Electric Field Intensity, Electric Voltage, Joule Heat, Total Current Density, Total Electric Field Intensity
GeneralCoordinate Systems Results (group), User Defined Result

Optimization

Topology Density, Topology Elemental Density

Acoustics and Acoustics Far Field

Acoustics

Pressure, Total Velocity, Directional Velocity, Kinetic Energy, Potential Energy, Sound Pressure, A-Weighted Sound Pressure Level, Frequency Band SPL, A-Weighted Frequency Band SPL

Acoustics Far Field

Far Field SPL, Far Field A-Weighted SPL, Far Field Maximum Pressure, Far Field Phase, Far Field Directivity, Far Field Maximum Scattered Pressure, Far Field Target Strength, Far Field Sound Power Level

Tree Dependencies:

Insertion Options:

  • For results and result tools that are direct child objects of a Solution object, use any of the following methods after highlighting the Solution object:

    • Open one of the toolbar drop-down menus or result category on the Solution context toolbar.

    • Right-click the Solution object or in the Geometry window, select Insert, and then select desired result or result category.

  • For results that are direct child objects of a specific result tool, use any of the following methods after highlighting the specific result tool object:

    • Choose result on the context toolbar related to the result tool.

    • Right-click a specific result tool object, select Insert, and then select the desired result or result category from the menu.

Additional Related Information:

The following right mouse button context menu options may be available based on the Result object.

Object Properties

The Details view properties for this object may include the following.

The following applies to many result objects whose direct parent object is Solution. Many exceptions are noted. For more complete information check individual descriptions for all results and result tools.

CategoryProperties
Scope

Scoping Method: property options include Geometry Selection, Named Selection, Path, Surface, Result File Item, or Surface Coating.

The application displays one of the following associated properties based on your Scoping Method selection:

Geometry

This property displays if the Scoping Method property is set to Geometry. Use selection filters to pick geometry, click in the Geometry field, then click Apply.

Named Selection

This property displays if the Scoping Method property is set to Named Selection. Specify named selection.

Path

This property displays if the Scoping Method property is set to Path. Select a defined path from the drop-down list.

Surface

This property displays if the Scoping Method property is set to Surface. Select a defined surface from the drop-down list.

Item Type

This property displays if the Scoping Method property is set to Result File Item. The options include:

  • Material IDs

  • Element Name IDs

  • Element Type IDs

  • Component Name

The values associated with the above options are generated and displayed in the Worksheet. Refer to the Result File Item section for additional information.

Solver Component IDs

This property displays if the Item Type property is set to Materials IDs, Element Name IDs, or Element Type IDs. The default value is All. For the Materials IDs and Element Name IDs options, you enter a number or a number range (i.e., 1, 2, 3, or 2-5). For Element Name IDs, you enter an element name, such as BEAM188, or, you can simply enter a group label, such as "beam", to include all beam element types. See the Result File Item section of the Help.

Component Name

This property displays if the Item Type property is set to Component Name. Specify a Component Name as listed in the Solver Component Names table of the Worksheet. See the Result File Item section of the Help.

Surface Coating

This property displays if the Scoping Method property is set to Surface Coating. This property provides a drop-down menu of available surface coatings. The default setting for this property is All.

Sub Scope By: Options include:

  • Layer: specifies the layer to calculate Shell result values. If selected, a Layer property also displays that requires you to specify a Layer number.

  • Ply: If selected, a Ply property also displays that requires you to select a target ply from the Modeling Ply object in the tree. The result calculation uses the intersection of the specified Ply and the Geometry property scoping. This option is not supported for Design Assessment results.

Position - appears only for stress and strain results scoped to surface bodies or to a layer (which may include a layer or ply of a solid body). Options include: Top/Bottom, Top, Middle, and Bottom.

Definition

Type: result type indication, can be changed within the same result category. Read-only indication for:

Current Density, Electric Potential, Equivalent Plastic Strain, Force Reaction, Magnetic Error, Strain Energy, Structural Error, Temperature, Thermal Error, User Defined Result, Vector Principal Elastic Strain, Vector Principal Stress
For Fracture results: SIFS, J-Integral, VCCT, Material Force, T-Stress, and C*-Integral.

Subtype: this property only displays for the Fracture Results SIFS, VCCT, and Material Force.

Response Type: appears for Random Vibration and Response Spectrum analyses only and is only available for User Defined results. Options include Displacement (default), Velocity, Acceleration, and Other Result.

Location Method: The Location Method property is available for the Force Reaction option (which is the same as the Force Reaction probe) of Frequency Response results. This property is used to specify the method you want to extract use to frequency response results. Options include Boundary Condition (default), Contact Region, Remote Points, Spring, and Beam. Based upon your selection, one of the following corresponding properties display.

Boundary Condition: provides a drop-down list of available boundary conditions that you use to scope the result to.
Contact Region: provides a drop-down list of available contact regions.
Remote Points: provides a drop-down list of available remote points.
Spring: provides a drop-down list of available body-ground springs.
Beam: provides a drop-down list of available body-ground beams.

Extraction: Only displayed for a Frequency Response (Force Reaction) result when the Location Method is set to Contact Region. Options include: Contact (Underlying Element) and Target (Underlying Element).

Orientation: appears only for: Axial Force, Directional Deformation, Directional Field Intensity, Directional Flux Density, Directional Force, Directional Heat Flux, Normal Elastic Strain, Normal Stress, Shear Elastic Strain, Shear Stress, Torsional Moment, Shell Membrane Stress, Shell Bending Stress.

For Frequency Response results, this property is used to specify the Orientation in which results are to be extracted. Options include X Axis (default), Y Axis, and Z Axis.

Expression: appears only for User Defined Result.

Input Unit System: appears only for User Defined Result.

Output Unit: appears only for User Defined Result.

Identifier: appears only for User Defined Result.

Coordinate System: this property displays for results that change with respect to a coordinate system, such as Normal Stress. For these result types, you accept the default setting, Global Coordinate System, or you can select a local coordinate system that you have defined, or select Solution Coordinate System. When the Sub Scope By property is set to Ply, this property defaults to the Fiber Coordinate System option.


Note:
  • The Fiber Coordinate System setting, when a result is scoped to a ply, supports the Mechanical APDL Solver only. In addition, this setting executes the same coordinate system commands as the Solution Coordinate System setting.

  • If a result changes with respect to coordinate systems, then Mechanical rotates this result in an identical fashion to Mechanical APDL. For an explanation of rotating results to a different coordinate system, see the Additional POST1 Postprocessing section in the Mechanical APDL Basic Analysis Guide.


By: This property enables you to specify a value (time, frequency, maximum value) for an independent variable for which you would like a contour result. The options vary based on the type of analysis. See the Multiple Result Sets section for more information.


Note:  This property is not available for the Far Field Sound Power Level, Frequency Band SPL, and A-Weighted Frequency Band SPL results.


Display Time: appears if By is set to Time. (See Note below.)

Frequency: appears if By is set to Frequency. (See Note below.)

Set Number: appears if By is set to Result Set.

Mode: appears for Modal analyses.

Calculate Time History: appears if By is set to Time or Set.

Sphere Radius: appears for all Far-field Results in Harmonic Acoustic analyses, except for the Far-Field Sound Power Level result.

Reference RMS Sound Pressure: appears for all Far-field Results in Harmonic Acoustic analyses, except for the Far-Field Sound Power Level result. The default value is 2e-5 Pa.

Reference Sound Power Level: appears for Far-Field Sound Power Level result. Defaults to 1e-12 Pa.

Amplitude: appears for contour results in a Harmonic Response Analysis only. Options include Yes or No (default). When the Amplitude property is set to Yes, the amplitude contour result is displayed with respect to the Solution Coordinate System.

Sweeping Phase:

  • For a Harmonic Response Analysis, this property appears only for contour results when the Amplitude property is set to No and the By property is set to Frequency, Set, Maximum Over Frequency, or Frequency of Maximum.

  • For Damped Modal analysis, this property always appears for contour results and for probe results when the By property is set to Mode, Maximum Over Modes, or Mode of Maximum.

Phase Increment: appears if the By property is set to Maximum Over Phase or Phase of Maximum. The entry can be between 1° and 10°. The default value is 10°.

Scale Factor: appears only for Random Vibration Analysis. Options include 1 Sigma (default), 2 Sigma, 3 Sigma, and User Input.

Scale Factor Value: appears when you set the Scale Factor property to User Input. The default value is 1.

Probability: read-only property that appears only for Random Vibration Analysis. Presents a probability value corresponding to each sigma value.

Identifier: This property is available for all result types. It enables you to specify a unique name/symbol/character that you can then use in the Expression property of a User Defined result.

Suppressed: suppresses the object if set to Yes.

Contour Start: appears only for Fracture Results.

Contour End: appears only for Fracture Results.

Active Contour: appears only for Fracture Results.

Note:
If you specify a Display Time or Frequency value which exceeds the final time or frequency in the result file, then Mechanical will not allow the result to be evaluated.
If you specify a Display Time or Frequency value for which no results are available, then Mechanical performs a linear interpolation to calculate the results at that specified time. The two times or frequencies in the result file that are the closest to the specified time/frequency are used in the interpolation. Note that the application does not perform the interpolation for a display time before the first result set.
No interpolation is performed for the Fracture Tool results. That is, for Fracture Results with a Display Time between the two solution time points, only the data set associated with the lower of the solution time points is used.

Options

The Options category is only present for the Frequency Response and Phase Response result types.

Frequency Response

For the Frequency Response result type the properties include the following:

  • Frequency Range: options include Use Parent (default) or Specified.

  • Minimum Frequency: you can enter a value for this property when the Frequency Range property is set to Specified, otherwise, it is read-only.

  • Maximum Frequency: you can enter a value for this property when the Frequency Range property is set to Specified, otherwise, it is read-only.

  • Display: options include:

    • Real

    • Imaginary

    • Real and Imaginary

    • Amplitude

    • Phase Angle

    • Bode (default setting - plots both Amplitude and Phase Angle)

  • Chart Viewing Style: select from the following options to select a scale to plot results:

    • Linear: this option plots the result values linearly.

    • Log X: this option plots the X-Axis logarithmically. If negative axis values or a zero value exists, this option is not supported and the graph plots linearly.

    • Log Y (default when graph has Amplitude): this option plots the Y-Axis is plotted logarithmically. If negative axis values or a zero value exists, this option is not supported and the graph plots linearly.

    • Log-Log: this option plots the X-Axis and Y-Axis logarithmically. If negative axis values or a zero value exists, this option is not supported and the graph plots linearly.

Phase Response

For the Phase Response result type, the properties include the following:

  • Frequency: input frequency at which Phase Response is requested.

  • Duration: phase period over which response is requested. The default setting is 720°.

Integration Point Results

Display Option: appears only for result items that can display unaveraged contour results.

Average Across Bodies: When you select Averaged as the Display Option, this property displays. Setting this property to Yes (the default value is No) averages results across separate bodies.

Results - Read-only status indication of result object.

Minimum: not available for Vector Principal Stress.

Maximum: not available for Vector Principal Stress.

Minimum Occurs On: not available for: Current Density, Electric Potential, Strain Energy, Vector Principal Stress.

Maximum Occurs On: not available for: Current Density, Electric Potential, Strain Energy, Vector Principal Stress.

The following read-only properties display for Frequency Response results:

  • Maximum Amplitude: reports maximum amplitude from all the result sets.

  • Frequency: reports frequency at which maximum amplitude occurs.

  • Phase Angle: reports phase angle at which maximum amplitude occurs.

  • Real: reports real value at which maximum amplitude occurs.

  • Imaginary: reports imaginary value at which maximum amplitude occurs.

Maximum Value Over Time

This category provides read-only properties that display maximum values of the results you select over time. These properties are only applicable for static, transient, explicit, and design assessment analyses.

Minimum Value Over Time

This category provides read-only properties that display minimum values of the results you select over time. These properties are only applicable for static, transient, explicit, and design assessment analyses.

Information - Read-only status indication of time stepping.

Time

Load Step

Substep

Iteration Number

Acoustics

CategoryProperties
Phi

Start: Starting Angle Phi. Appears for all Far-field Results in Harmonic Acoustic analyses except Far-Field Sound Power Level. Defaults to 0.0°.

End: Ending Angle Phi. Appears for all Far-field Results in Harmonic Acoustic analyses except Far-Field Sound Power Level. Defaults to 0.0°.

No. of Divisions: Number of Divisions in Phi direction. Appears for all Far-field Results in Harmonic Acoustic analyses except Far-Field Sound Power Level. Defaults to 1.

Theta

Start: Starting Angle Theta. Appears for all Far-field Results in Harmonic Acoustic analyses except Far-Field Sound Power Level. Defaults to 0.0°.

End: Ending Angle Theta. Appears for all Far-field Results in Harmonic Acoustic analyses except Far-Field Sound Power Level. Defaults to 0.0°.

No. of Divisions: Number of Divisions in Theta direction. Appears for all Far-field Results in Harmonic Acoustic analyses except Far-Field Sound Power Level. Defaults to 1.

Advanced

Model Type: appears for all Far-field Results in Harmonic Acoustic analyses. Options include 3D (default), 2.5D Z-Direction Extrusion, and 2.5D Y-Axis Rotation Extrusion.

Model Thickness in Z-Direction: appears when Model Type is set to 2.5D Z-Direction Extrusion for a Far-field Result. Defaults to 0.0.

Y Axis Extrusion Angle: appears when Model Type is set to 2.5D Y-Axis Rotation Extrusion for a Far-field Result. Defaults to 0.0 degrees.

Spatial Radiation Angle: appears for Far Field Directivity and Far Field Sound Power results in Harmonic Acoustic analyses. Options include Full (default) and Partial.

Starting Radiation Angle Phi: appears when Spatial Radiation Angle is set to Partial for a Far-field Result. Defaults to 0.0 degrees.

Ending Radiation Angle Phi: appears when Spatial Radiation Angle is set to Partial for a Far-field Result. Defaults to 0.0 degrees.

Starting Radiation Angle Theta: appears when Spatial Radiation Angle is set to Partial for a Far-field Result. Defaults to 0.0 degrees.

Ending Radiation Angle Theta: appears when Spatial Radiation Angle is set to Partial for a Far-field Result. Defaults to 0.0 degrees.


Release 18.2 - © ANSYS, Inc. All rights reserved.