hm_getresults

Returns results data.

Syntax

hm_getresults id=<value> ?<option1>=<value1>? ?<option2>=<value2>? ... ?<optionN>=<valueN>?

Type

HyperMesh Tcl Query Command

Description

Returns results data.

<option>=<value> options can be provided in any order.

Inputs

id=<value>
The ID of the result entity to query.
contour=<value>
0 - Do not contour
1 - Contour
dataname=<value>
The query data type. Valid values are:
avgmethod
binding
complex_filter
corners
datacomps
datatypes
deriveddatacomps
derivedlayers
envEqns
fields
format
isderived
isvalidmodel
layers
loadcases
lspEqns
subcasetype
systems
dataset=<value>
The data type scalar, tensor or vector.
derived_subcase_id=<value>
The subcase ID for derived subcases of type envelope or lsp.
fileid=<value>
The file ID corresponding to the unique ID of the result file from the result entity.
fileid_subcase=<value>
The unique combinations for considering multiple subcases, separated by colons. For example 1:1,2:1,3:1,4:2
resultcomponent=<value>
The component when dataset is tensor or vector.
step=<value>
The step index for a given subcase.
subcase=<value>
The subcase ID within the result file.
type=<value>
The derived loadcase type, either envelope or lsp (linear superposition).
xml=<value>
The complete file path of the XML file that holds the inputs for results query.

Example

Generate a vonMises Stress contour for subcase 1 and step 0 for file 1 in result ID 1:
hm_getresults id=1 dataset="Stress" resultcomponent="VonMises" fileid="1" subcase=1 step=0 contour=1
Get the envelope derived subcase data for result ID 1:
hm_getresults id=1 type=envelope dataname=UniqueDerivedSubcase
Get the complex filter options for file ID 3 and subcase 5 for result ID 1:
hm_getresults id=1 fileid=3 subcase=5 dataname=complex_filter
Get the complex filter options for multiple file IDs and subcases for result ID 1:
hm_getresults id=1 fileid_subcase=1:1,2:1,3:1,4:2 dataname=complex_filter

Errors

Incorrect usage results in a Tcl error. To detect errors, you can use the catch command:
if { [ catch {command_name...} ] } {
   # Handle error
}

Version History

2019.1