hm_getresults

Returns results data.

Syntax

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

HyperMesh Tcl Query Command

Returns results data.

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

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.

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

Incorrect usage results in a Tcl error. To detect errors, you can use the catch command:

if { [ catch {command_name...} ] } {
   # Handle error
}

2019.1