Results Format

The DA Results format defines the available DA Results tree objects. A maximum of 10 attributes can be included per DA Result object; for example to define direction components. For attributes applied to results objects, the application entry is ignored. DA Result objects automatically sort themselves by drop-downs of available types and subtypes. Each DA Result object also contains information on how it should display results; this can either be set in this XML definition file or programmatically in the python solve or evaluate scripts.

Minimum and maximum values are also reported and can be parametrized. Probe labels can be added to the graphic to identify specific results, or the minimum and maximum locations.

<Results ObjId="3" Type="CAERepBase" Ver="2">
  <DAResult ObjId ="100001"  Type="DAResult" Ver="2">
    <GroupType PropType="string">Group Type</GroupType> 
    <GroupSubtype PropType="string">Group Subtype</GroupSubtype>
    <AttributeIDs PropType="vector&lt;unsigned int>">list of attribute numbers</AttributeIDs>
    <DisplayType PropType="string">display type keyword</DisplayType>
    <DisplayStyle PropType="string">display style keyword</DisplayStyle>
    <DisplayUnits PropType="string">display units keyword</DisplayUnits>
  </DAResult>
</Results>

The result is defined in the Details panel with standard rows and then up to 10 attributes:

Note that if the Display Style of a result is anything other than scalar, a "Components" field is shown in the Definitions section.

The Results tag properties should be set as follows:

PropertyValueMeaning
ObjIdenter an integerNumber identifying this attribute group collection
TypeCAERepBaseSpecifies that the file is in ANSYS intermediate file format
Verenter an integerVersion of the Results definition section; this should be set to 2

The DAResult tag properties should be set as follows:

PropertyValueMeaning
ObjIdenter an integerUnique number identifying this DA Result; suggest starting at a fixed number (e.g. 1000) to avoid conflict with other objects
TypeDAResultSignifies that the contents of the DAResult tag defines a result group
Verenter an integerVersion of the DA Result object definition; this should be set to 3

The following tags can be included as children of a DAResult tag:

PropertyValueMeaning
GroupTypeenter a stringType of this DA Result object
GroupSubtypeenter a stringSubtype of this DA Result object
AttributeIDsenter a comma separated list of attribute ID numbersAttributes that will be displayed for this DA Result object
DisplayType, with following values of display type keywords allowed:ElementValues per element are expected
NodalValues per node are expected.
ElementNodalValues per node of each element are expected

DisplayStyle, with following values of display style keywords allowed:

(Only used if version number of DAResult > 2)

ScalarA single number is expected for each element / node depending upon the DisplayType set (default if field is not defined)
Vector

X, Y and Z component values are expected for each element / node depending upon the DisplayType

An additional drop-down will be provided to choose between X, Y, Z, Resultant and Vector Display

The Resultant, R, is determined by

Tensor

X, Y, Z, XY, YZ and XZ component values are expected for each element / node depending upon the DisplayType

An additional drop-down will be provided to choose between X, Y, Z, XY, YZ and XZ, Maximum Principal, Middle Principal, Minimum Principal, Intensity, Equivalent, Vector Principal, and Maximum Shear

StrainTensorAs Tensor, but without the Maximum Shear option

DisplayUnits, with following values of display units keywords allowed:

(Only used if version number of DAResult > 2)

When a display unit is defined the result will automatically scale depending on the given unit system

No UnitsNo units are associated with the result (default if field is not defined)
StressResults are treated as stress
DistanceResults are treated as distance
StrainResults are treated as strain
ForceResults are treated as force
MomentResults are treated as moment, i.e. force x distance
RotationResults are treated as rotation
Angular AccelerationResults are treated as angular acceleration, i.e. rotation / time2
Angular VelocityResults are treated as angular velocity, i.e. rotation / time
VelocityResults are treated as velocity, i.e. distance / time
AccelerationResults are treated as acceleration, i.e. distance / time2
TemperatureResults are treated as temperature
PressureResults are treated as pressure, i.e. force / distance2
VoltageResults are treated as voltage
EnergyResults are treated as energy
VolumeResults are treated as volume, i.e. distance3
AreaResults are treated as area, i.e. distance2
CurrentResults are treated as current
Heat RateResults are treated as heat rate
Current DensityResults are treated as current density
PowerResults are treated as power
Heat GenerationResults are treated as heat generation
Magnetic FluxResults are treated as magnetic flux

The DisplayType, DisplayStyle and Display unit can all be over-ridden or set within the python script if desired. However, DisplayStyle needs to be set here to enable the addition of the drop-down to choose the component and automatic calculation of additional results (e.g. Resultant, Maximum Principal, etc.) in the cases of vector or tensor display. See the DAResult class in the API for details on how to set these programmatically.

The PropType property of the GroupType, GroupSubtype, and DisplayType tags must be set to string, and the PropType property of the AttributeIDs tags must be set to vector&lt;unsigned int>.


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