Extracting a single calculated result

You can calculate a result based on the entire result data set, or you can limit the data to a specific region, such as the cavity region, the runner region, or even a single element. The results are displayed using the utility screen output and written to a single-value result file (study_name.val) in the associated study folder.

There are three pieces of information that are required to perform this type of extraction:

The command line call to extract a single calculated result is:

studyrlt <study> -result <result ID>  -min|-max|-average|-stddev|-count|-statistics
                             -node <node number>|-element <element number>
                             [-frame <frame_number>|<low>:<high>|first|last|all]
                             [-layer <layer name>|-cavity|-gate|-runner|-sprue]
                             [-component <number> [-anchor <node1> <node2> <node3>]
                             [-unit SI|Metric|English]

where the arguments are defined as follows:

ArgumentsDescription
<study>Study filename with extension.
-result <result ID>Extract a numerical value from the specified result set.
-minCalculate the minimum value of the result data set.
Important: Not available for Result ID 1740 (air traps for Dual Domain/Midplane model), which is classified as a highlight data type (HLDT).
-maxCalculate the maximum value of the result data set.
Important: Not available for Result ID 1740 (air traps for Dual Domain/Midplane model), which is classified as a highlight data type (HLDT).
-averageCalculate the average value of the result data set.
Important: Not available for Result ID 1740 (air traps for Dual Domain/Midplane model), which is classified as a highlight data type (HLDT).
-stddevCalculate the standard deviation value of the result data set.
Important: Not available for Result ID 1740 (air traps for Dual Domain/Midplane model), which is classified as a highlight data type (HLDT).
-statisticsReturn the following statistical values: minumum, maximum, average, standard deviation and count.
Note:: if the result contains more than one result frame then only the minimum and maximum values are calculated.
-countCount the number of entities of the result data set.
Note:
  • For result ID 1722 (weld line) and 1732 (weld and meld line), the number counted by is the number of segments in the weld line or weld/meld line.
  • For result ID 1622 (air traps, 3D model) and 1740 (air traps, Dual Domain/Midplane model), the number counted is the number of air trap locations.
  • For all other NDDT and ELDT results, the -count option counts the number of entities for the specified result ID
-node <node number>Return the result value at a specified node (Example : -node 57).
Important: Not available for Result ID 1740 (air traps for Dual Domain/Midplane model), which is classified as a highlight data type (HLDT).
-element <element number>Return the result value at a specified element (Example: -element 23).
Important: Not available for Result ID 1740 (air traps for Dual Domain/Midplane model), which is classified as a highlight data type (HLDT).
-frameFor time series (multi-frame) result datasets specify the frame or frame range to do the calculations. The range can set in a number of ways
  • frame_number Specify a single frame (eg. -frame 3)
  • first Specify the first frame (eg. -frame first This is equivalent to -frame 1)
  • last Specify the last frame (eg. -frame last)
  • all Specify all frames (eg. -frame all)
  • low:high Specify a frame range (eg. -frame 1:4 or -frame first:last)
  • Note: Frame values exceeding the number of result frames are set to the maximum number of result frames automatically
    -layer <layer name>Only consider results in the selected layer.
    Important: Not available for Result ID 1722 (weld line), 1732 (weld and meld line), 1622 (air traps, 3D model), or 1740 (air traps, Dual Domain/Midplane model).
    -cavityOnly consider results in the cavity region.
    Important: Not available for Result ID 1722 (weld line), 1732 (weld and meld line), 1622 (air traps, 3D model), or 1740 (air traps, Dual Domain/Midplane model).
    -gateOnly consider results in the gate region.
    Important: Not available for Result ID 1722 (weld line), 1732 (weld and meld line), 1622 (air traps, 3D model), or 1740 (air traps, Dual Domain/Midplane model).
    -runnerOnly consider results in the runner region.
    Important: Not available for Result ID 1722 (weld line), 1732 (weld and meld line), 1622 (air traps, 3D model), or 1740 (air traps, Dual Domain/Midplane model).
    -sprueOnly consider results in the sprue region.
    Important: Not available for Result ID 1722 (weld line), 1732 (weld and meld line), 1622 (air traps, 3D model), or 1740 (air traps, Dual Domain/Midplane model).
    -component <number>Component of the result data set to be extracted:
    • 0 = Magnitude (default)
    • 1 = X, 2 = Y, 3 = Z
      Note: Only applicable to vector-based results
    -anchor <node1> <node2> <node3>Apply anchor plane defined by nodes 1,2 and 3
    Note: Only applicable to warpage results.
    -unit <unit system>Show results in the specified unit system:
    • SI (default)
    • Metric
    • English