Skip to main content
Version: 18

GET_RESULT

Queries results from an analysis or design run.

Description

Queries results from an analysis or design run. The syntax, attributes and parameters of the GET_RESULT command differs significantly depending on the calculation type, therefore both calculation types are described in detail separately in the Detailed description of calculation types chapter below.

The result searching algorithm is the following:

  1. All objects that can have the requested result type are filtered based on the parameters given in the Filter attribute line. The algorithm will search for results within the remaining objects. This step is optional. If there are no filters given, then all objects will be considered.
  2. Within the filtered objects, results are queried based on parameters given in the Location attribute line.
  3. At this point we have as many result values, as many objects have the requested result type, and fit the filtering conditions. From these result values the minimal or the maximal will be chosen based on the value of the Object select parameter. This will become the output for the Main result.

Syntax

GET_RESULT [Calculation type] [Main result]
Command attributes...

Main command parameters

Calculation type:

Available calculation types:

Main result:

Variable that will contain the main result.


Detailed description of calculation types

Analysis

Syntax

GET_RESULT Analysis [Main result] [Object ID] [x] [y] [z]
AnalysisType [Analysis type]
ResultType [Result category] [Result type] [Plate layer] [Dynamic direction] [Object select]
Combination [Combination ID]
Filter [Filter type 1] [Filter value 1] [Filter type 2] [Filter value 2] etc.
Location [Location type] [Location value]
TogetherWith [Supplementary result category] [Supplementary result type] [Plate layer] [Dynamic direction] [Supplementary result]

Additional command lines

Code lines directly after the GET_RESULT command can set certain attributes. The "AnalysisType", "ResultType" and "Combination" lines are always necessary, while the other ones are optional.

Available additional command lines:

Line starting keywordInclusionDescription
AnalysisTypeRequiredControls analysis type
ResultTypeRequiredControls result type
CombinationRequiredSelects combination
FilterOptionalFilters results
LoacationOptionalDefines location of results
TogetherWithOptionalRequests supplementary results

Filter:

Results can be filtered based on certain attributes. Multiple filters can be used for one GET_RESULT command with having multiple filter type-value pairs listed one after another in the Filter attribute line. In case of multiple filters the result will be queried from the intersection set of all filters.

Location:

A location can be specified from where results should be queried within an object.

TogetherWith:

With the TogetherWith attribute supplementary results can be queried. Multiple TogetherWith attribute lines can be added to one GET_RESULT command.

Command parameters

Command parameterAssignmentValue formatInput options
Main resultRequiredStringLocal, variable
Object IDOptionalStringLocal, variable
x, y, zOptionalStringsLocal, variable
Analysis typeRequiredPredefined stringsLocal, variable
Result categoryRequiredPredefined stringsLocal, variable
Result typeRequiredPredefined stringsLocal, variable
Plate layerOptionalPredefined stringsLocal, variable
Dynamic directionOptionalPredefined stringsLocal, variable
Object selectRequiredPredefined stringsLocal, variable
Combination IDRequiredLoad or mass combination name or IDLocal, variable
Filter typesOptionalPredefined stringsLocal, variable
Filter valuesOptionalStringLocal, variable
Location typeOptionalPredefined stringsLocal, variable
Location valueOptionalStringLocal, variable
Supplementary result categoryOptionalPredefined stringsLocal, variable
Supplementary result typeOptionalPredefined stringsLocal, variable
Supplementary resultOptionalStringLocal, variable

Main result:

Variable that will contain the main result.

Object ID:

Variable that will contain the ID of the object where the queried result originates from.

The assignment of this parameter is optional.

x, y, z:

3 variables that will contain the global coordinates of the queried result's location.

The assignment of these parameters is optional.

Analysis type:

Type of the analysis.

Available analysis types:
  • FirstOrder
  • SecondOrder
  • Buckling
  • Dynamics - in this case the ResultType attribute gets extended with a parameter
    • : Dir1, Dir2, Z

Result category:

Available result categories:
  • Deformation
  • InternalForces
  • ForcesOnShell
  • StressesOnShell - in this case the ResultType attribute gets extended with a parameter
    • : Top, Middle, Bottom
  • Reactions
  • Shape
  • PlasticHinge

Result type:

Available result types:
  • Deformation: X, Y, Z, Rx, Ry, Rz, W
  • InternalForces: N, Vy, Vz, T, My, Mz, B
  • ForcesOnShell: Mx, My, Mxy, Nx, Ny, Nxy, Qxz, Qyz, QRz
  • StressesOnShell: X, Y, XY, 1, 2, HMH
  • Reactions: Fx, Fy, Fz, Mx, My, Mz
  • Shape: positive integer
  • PlasticHinge: positive integer

Plate layer:

Only active if Result category = StressesOnShell.

Available inputs:
  • Top
  • Middle
  • Bottom

Dynamic direction:

Only active if Analysis type = Dynamics.

Available inputs:
  • Dir1
  • Dir2
  • Z

Object select:

In case there are multiple objects to query results from, with this parameter it can be defined if the result should come from the object that has the maximal or minimal result value.

Available inputs:
  • Min
  • Max

Combination ID:

Load or mass combination ID based on which the result is queried. The accepted input is either a single mass or load combination ID or the name of the combination with this syntax: "NAME: [Combination name]"

Filter types:

Available filter types:
  • ID
  • SectionType
  • Material
  • Name
  • Thickness
  • GroupName
  • GroupID

Filter values:

Filter values paired to their filter types.

Location type:

Available location types:
  • Min/Max: location of minimal/maximal result within an object. In this case the Location value parameter has to stay undefined
  • EndA/EndB: result location measured from one end of the object. In this case the Location value parameter has to be set to a distance in milimeters.
  • Ratio: result location at a certain length ratio of the object. In this case the Location value parameter has to be set to a ratio number between 0 and 1.
  • Point: result location is at a certain global coordinate. In this case the Location value parameter has to be set to some x,y,z coordinates.

If not specified the defult location type is "Max".

Location value:

Value paired to the Location type.

Supplementary result category:

The same categories apply here as in case of the Result category parameter.

Supplementary result type:

The same types apply here as in case of the Result type parameter.

Supplementary result:

Variable that will conatin the supplementary result.

Sample code

Example 1: (Normal force)

GET_RESULT Analysis Result_Variable
AnalysisType FirstOrder
Combination "NAME: Load combination-1"
ResultType InternalForces N Min

Example 2: (αcr - elastic critical factor, with getting load combination ID)

FILTER LC_list
Objecttypes Loadcombination

ARRAY_GET LC_list 0 LCID1

GET_RESULT Analysis Result_Variable
AnalysisType Buckling
Combination $LCID1
ResultType Shape 1

Example 3: (Maximum negative bending moment + deflection)

This query gets the maximal negative bending moment from the model. Additionally the coordinates of the result's location are stored in the ResLocX, ResLocY and ResLocZ variables. The ID of the object that provided the result is stored in the Object_ID variable. Moreover the deformation in the "z" global direction is also queried at the same location as the main result, and stored in the Def_Z variable.

GET_RESULT Analysis Result_Variable Object_ID ResLocX ResLocY ResLocZ
AnalysisType FirstOrder
Combination "NAME: Load combination-1"
ResultType InternalForces My Min
TogetherWith Deformation Z Def_Z

Example 4: (Shell stress + filter)

This query gets the maximal positive stress in the local "x" direction from the bottom layer of all plates in the model that have a 200 mm thickness. Additionally the coordinates of the result's location are stored in the ResLocX, ResLocY and ResLocZ variables. The ID of the object that provided the result is stored in the Object_ID variable. Moreover the "nx" distributed internal force and deformation in the "z" direction are also queried at the same location as the main result, and stored in the ShellForce_nx and Def_Z variables.

GET_RESULT Analysis Result_Variable Object_ID ResLocX ResLocY ResLocZ
AnalysisType FirstOrder
Filter Thickness 200
Combination "NAME: Load combination-1"
ResultType StressesOnShell X Bottom Max
TogetherWith ForcesOnShell Nx ShellForce_nx
TogetherWith Deformation Z Def_Z

Example 5: (Shell stress at specific location given by coordinates)

This query gets the stress value at the location given by the coordinates (1000, 1000, 3000) in the local "x" direction from the bottom layer of the plate.

GET_RESULT Analysis Result_Variable Object_ID
AnalysisType FirstOrder
Location 1000 1000 3000
Combination "NAME: Load combination-1"
ResultType StressesOnShell X Bottom Max

Design

Syntax

GET_RESULT Design [Main result] [Object ID] [x] [y] [z] [Result combination ID]
ResultType [Result category] [Result type] [Object select]
Combination [Combination ID]
Filter [Filter type 1] [Filter value 1] [Filter type 2] [Filter value 2] etc.
Location [Location type] [Location value]
TogetherWith [Supplementary result category] [Supplementary result type] [Supplementary result]

Additional command lines

Code lines directly after the GET_RESULT command can set certain attributes. The "ResultType" line is always necessary, while the other ones are optional.

Available additional command lines:

Line starting keywordInclusionDescription
ResultTypeRequiredControls result type
CombinationOptionalSelects combination
FilterOptionalFilters results
LoacationOptionalDefines location of results
TogetherWithOptionalRequests supplementary results

Filter:

Results can be filtered based on certain attributes. Multiple filters can be used for one GET_RESULT command with having multiple filter type-value pairs listed one after another in the Filter attribute line. In case of multiple filters the result will be queried from the intersection set of all filters.

Location:

A location can be specified from where results should be queried within an object.

TogetherWith:

With the TogetherWith attribute supplementary results can be queried. Multiple TogetherWith attribute lines can be added to one GET_RESULT command.

Command parameters

Command parameterAssignmentValue formatInput options
Main resultRequiredStringLocal, variable
Object IDOptionalStringLocal, variable
x, y, zOptionalStringsLocal, variable
Result combination IDOptionalStringLocal, variable
Result categoryRequiredPredefined stringsLocal, variable
Result typeRequiredPredefined stringsLocal, variable
Object selectOptionalPredefined stringsLocal, variable
Combination IDOptionalLoad combination name or IDLocal, variable
Filter typesOptionalPredefined stringsLocal, variable
Filter valuesOptionalStringLocal, variable
Location typeOptionalPredefined stringsLocal, variable
Location valueOptionalStringLocal, variable
Supplementary result categoryOptionalPredefined stringsLocal, variable
Supplementary result typeOptionalPredefined stringsLocal, variable
Supplementary resultOptionalStringLocal, variable

Main result:

Variable that will contain the main result.

Object ID:

Variable that will contain the ID of the object where the queried result originates from.

The assignment of this parameter is optional.

x, y, z:

3 variables that will contain the global coordinates of the queried result's location.

The assignment of these parameters is optional.

Result combination ID:

Variable that will contain the ID of the load combination that produced the queried result. The assigment of this parameter is optional.

Result category:

Available result categories:
  • Dominant
  • Steel
  • ConcBeam
  • ConCol
  • CompCol
  • AlphaUlt

Result type:

Available result types:
  • Dominant: All, Steel, Concrete, CompositeColumn
  • Steel: General, Pure, Plastic, Conservative, Stability, Stablelength
  • ConcBeam: Mrd, Vrdc, Vrd, VrdTrd, VrdTrdc, Asl
  • ConCol: NrdMrd, VzrdVyrd
  • CompCol: Pure, LocalBuckling, Interaction
  • AlphaUlt: Steel

Object select:

In case there are multiple objects to query results from, with this parameter it can be defined if the result should come from the object that has the maximal or minimal result value.

Available inputs:
  • Min
  • Max

Combination ID:

Only required if Result category=AlphaUlt.

Load combination ID based on which the result is queried. The accepted input is either a single load combination ID or the name of the combination with this syntax: "NAME: [Load combination name]"

Filter types:

Available filter types:
  • ID
  • SectionType
  • Material
  • Name
  • Thickness
  • GroupName
  • GroupID

Filter values:

Filter values paired to their filter types.

Location type:

Available location types:
  • Min/Max: location of minimal/maximal result within an object. In this case the Location value parameter has to stay undefined
  • EndA/EndB: result location measured from one end of the object. In this case the Location value parameter has to be set to a distance in milimeters.
  • Ratio: result location at a certain length ratio of the object. In this case the Location value parameter has to be set to a ratio number between 0 and 1.
  • Point: result location is at a certain global coordinate. In this case the Location value parameter has to be set to some x,y,z coordinates.

If not specified the defult location type is "Max".

Location value:

Value paired to the Location type.

Supplementary result category:

The same categories apply here as in case of the Result category parameter.

Supplementary result type:

The same types apply here as in case of the Result type parameter.

Supplementary result:

Variable that will conatin the supplementary result.

Sample code

Example 1: (Steel pure resistance utilization)

GET_RESULT Design Result_Variable
ResultType Steel Pure Max

Example 2: (Steel dominant utilization)

GET_RESULT Design Result_Variable Object_ID ResLocX ResLocY ResLocZ
ResultType Dominant All Max

Example 3: (αult)

GET_RESULT Design Result_Variable Object_ID ResLocX ResLocY ResLocZ
ResultType AlphaUlt Steel Max
Combination "NAME: Load combination-1"