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:
- 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.
- Within the filtered objects, results are queried based on parameters given in the Location attribute line.
- 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 keyword | Inclusion | Description |
---|---|---|
AnalysisType | Required | Controls analysis type |
ResultType | Required | Controls result type |
Combination | Required | Selects combination |
Filter | Optional | Filters results |
Loacation | Optional | Defines location of results |
TogetherWith | Optional | Requests 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 parameter | Assignment | Value format | Input options |
---|---|---|---|
Main result | Required | String | Local, variable |
Object ID | Optional | String | Local, variable |
x, y, z | Optional | Strings | Local, variable |
Analysis type | Required | Predefined strings | Local, variable |
Result category | Required | Predefined strings | Local, variable |
Result type | Required | Predefined strings | Local, variable |
Plate layer | Optional | Predefined strings | Local, variable |
Dynamic direction | Optional | Predefined strings | Local, variable |
Object select | Required | Predefined strings | Local, variable |
Combination ID | Required | Load or mass combination name or ID | Local, variable |
Filter types | Optional | Predefined strings | Local, variable |
Filter values | Optional | String | Local, variable |
Location type | Optional | Predefined strings | Local, variable |
Location value | Optional | String | Local, variable |
Supplementary result category | Optional | Predefined strings | Local, variable |
Supplementary result type | Optional | Predefined strings | Local, variable |
Supplementary result | Optional | String | Local, 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.