*createfbdsummarytable

Creates an FBD summary table or min/max table.

Syntax

*createfbdsummarytable freebodysection_ids subcase_ids data_strings num_strings

Type

HyperMesh Tcl Modify Command

Description

Creates an FBD summary table or min/max table.

This queries the GPF, Applied, SPC and MPC data from the result entity on a freebodysection.

Inputs

freebodysection_ids
The list of freebodysection entity IDs.
subcase_ids
The subcase info as an array. Values are specified as <resultfile_id>_<subcase_id>_<step_id>, with each list separated by a comma. For example: 1_1_0,1_2_0,2_1_0,2_1_1.
data_strings
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:
appf=<value>
0 - Applied forces are not participating in the FBD calculation (default)
1 - Applied forces are participating in the FBD calculation
freenode=<value>
0 - Free nodes. Find the nodes which are shared by elements other than the elements contained in the freebodysection.
1 - Boundary nodes. Find only the boundary nodes of the elements contained in the freebodysection.
2 - All nodes. Find all nodes of the elements contained in the freebodysection.
gpf=<value>
0 - Grid-point forces are not participating in the FBD calculation (default)
1 - Grid-point forces are participating in the FBD calculation
intf=<value>
0 - Internal forces are not participating in the FBD calculation (default)
1 - Internal forces are participating in the FBD calculation
minmax=<value>
0 - Create FBD summary table (default)
1 - Create FBD min/max table
mpcf=<value>
0 - MPC forces are not participating in the FBD calculation (default)
1 - MPC forces are participating in the FBD calculation
resultid=<value>
The result entity ID.
spcf=<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 for table creation. Default is 0.00001.
num_strings
Integer indicating the size (number of strings) in the data_strings array.

Example

To create an FBD summary table:
*createstringarray 9 "tolerance=0.00001" "resultid=1" "gpf=1" "appf=1" "spcf=1" "intf=1" "mpcf=1" "freenode=2" "minmax=0"
set fbdIds {1 2 3}
set scIds {1_1_0,1_2_0,2_1_0,2_1_1}
*createfbdsummarytable $fbdIds $scIds 1 9
To create an FBD min/max table:
*createstringarray 9 "tolerance=0.00001" "resultid=1" "gpf=1" "appf=1" "spcf=1" "intf=1" "mpcf=1" "freenode=2" "minmax=1"
set fbdIds {1 2 3}
set scIds {1_1_0,1_2_0,2_1_0,2_1_1}
*createfbdsummarytable $fbdIds $scIds 1 9

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