*freebodysectiondisplacementtable

Creates an FBD displacement summary table from freebodysection entity.

Syntax

*freebodysectiondisplacementtable entity_ids subcase_ids string_array number_of_strings

Type

HyperMesh Tcl Modify Command

Description

Creates an FBD displacement summary table. This queries the GPF, Applied, SPC and MPC data from the result entity on a freebodysection.

Inputs

entity_ids
The freebodysection entity IDs.
subcase_ids
The subcase details supplied as an array. Values are specified as <resultfile_id>_<subcase_id>_<step_id>, with each list separated by a comma.
string_array
The ID of the string array that contains the additional input parameters. The string array is created using the *createstringarray command. This should always be set to 1. Valid parameters and their syntax are:
displacement=<value>
0 - Applied forces are not participating in the FBD calculation (default)
1 - Applied forces are participating in the FBD calculation
freenode=<value>
Currently must be set to 2. This is a mandatory argument.
resolvein_sys=<value>
1 - Resolve in global system
2 - Resolve in user system
3 - Free body section system
resultid=<value>
The result entity ID.
rotation=<value>
0 - SPC forces are not participating in the FBD calculation (default)
1 - SPC forces are participating in the FBD calculation
tolerance=<value>
The tolerance to limit the values. Default is 0.00001.
user_sys_id=<value>
The system ID when resolvein_sys=2.
number_of_strings
Integer indicating the size (number of strings) in the string array created using *createstringarray.

Examples

To create an FBD displacement summary table:
*createstringarray 8 "tolerance=0.00001" "resultid=1" "display=0" "resolvein_sys=1" "user_sys_id=0" "displacement=1" "rotation=1" "freenode=2"
*freebodysectiondisplacementtable {1 2 3} {2_1_0,2_2_0} 1 8

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

2023