*fbdtraceplot

Creates an FBD trace plot.

Syntax

*fbdtraceplot freebodygroup_id data_strings num_strings

Type

HyperMesh Tcl Modify Command

Description

Creates an FBD trace plot.

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

Inputs

freebodygroup_id
The freebodygroup entity ID.
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 do not participate in the FBD calculation (default)
1 - Applied forces do participate in the FBD calculation
arrlen=<value>
Controls the FBD plot arrow length. Default is 75 (%).
declim=<value>
Controls the decimal limit. Default is 2.
displayat=<value>
0 - Allong the cutting nodes (default)
1 - Along the centroid of each freebodysection
fx=<value>
0 - Do not display Fx forces (default)
1 - Display Fx forces
fy=<value>
0 - Do not display Fy forces (default)
1 - Display Fy forces
fz=<value>
0 - Do not display Fz forces (default)
1 - Display Fz forces
gpf=<value>
0 - Grid-point forces do not participate in the FBD calculation (default)
1 - Grid-point forces do participate in the FBD calculation
intf=<value>
0 - Internal forces do not participate in the FBD calculation (default)
1 - Internal forces do participate in the FBD calculation
mpcf=<value>
0 - MPC forces do not participate in the FBD calculation (default)
1 - MPC forces do participate in the FBD calculation
mx=<value>
0 - Do not display Mx moments (default)
1 - Display Mx moments
my=<value>
0 - Do not display My moments (default)
1 - Display My moments
mz=<value>
0 - Do not display Mz moments (default)
1 - Display Mz moments
plotdir=<value>
0 - Auto. The direction axis is automatically determined on the basis of values (default)
1 - Global x-direction
2 - Global x-direction negative
3 - Global y-direction
4 - Global y-direction negative
5 - Global z-direction
6 - Global z-direction negative
resfileid=<value>
The result file ID for resultid. Useful when multiple result files are loaded for a single result entity.
resultid=<value>
The result entity ID.
scid=<value>
The results subcase ID for resultid.
scientific=<value>
0 - Fixed format text (default)
1 - Scientific format text
showvalue=<value>
0 - Show text (default)
1 - Hide text
spcf=<value>
0 - SPC forces do not participate in the FBD calculation (default)
1 - SPC forces do participate in the FBD calculation
stepid=<value>
The step/simulation ID for scid.
sumat=<value>
0 - Along cutting nodes (default)
1 - Along the centroid of each freebodysection
sysproj=<value>
0 - Do not project the system along the plot (default)
1 - Project the system along the plot
tolerance=<value>
The tolerance to limit the values. Default is 0.00001.
num_strings
Integer indicating the size (number of strings) in the data_strings array.

Example

Create an FBD trace plot:
*createstringarray 24 "scientific=1" "tolerance=0.00001" "scid=1" "resfileid=1" "resultid=1" "showvalue=1" "stepid=1" "fx=1" "fy=0" "fz=0" "mx=0" "my=0" "mz=0" "gpf=1" "appf=1" "spcf=1" "intf=1" "mpcf=1" "arrlen=75" "declim=2" "plotdir=0" "sysproj=0" "sumat=0" "displayat=0"
*fbdtraceplot 1 1 24

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