*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