*fbdforce

Creates an FBD force plot, and fields or loads from the results.

Syntax

*fbdforce freebodysection_ids=<value> data_strings=<value> num_strings=<value>

Type

HyperMesh Tcl Modify Command

Description

Creates an FBD force plot, and fields or loads from the results.

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

Inputs

freebodysection_ids=<value>
The freebodysection entity IDs.
data_strings=<value>
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 (%).
arroworigin=<value>
0 - Tail of arrow at node for the plot (default)
1 - Tip of arrow at node for the plot
colorfx=<value>
The color of the Fx arrow. Valid values are 1-64.
colorfxy=<value>
The color of the Fxy arrow. Valid values are 1-64.
colorfxyz=<value>
The color of the Fxyz arrow. Valid values are 1-64.
colorfxz=<value>
The color of the Fxz arrow. Valid values are 1-64.
colorfy=<value>
The color of the Fy arrow. Valid values are 1-64.
colorfyz=<value>
The color of the Fyz arrow. Valid values are 1-64.
colorfz=<value>
The color of the Fz arrow. Valid values are 1-64.
colormx=<value>
The color of the Mx arrow. Valid values are 1-64.
colormxy=<value>
The color of the Mxy arrow. Valid values are 1-64.
colormxyz=<value>
The color of the Mxyz arrow. Valid values are 1-64.
colormxz=<value>
The color of the Mxz arrow. Valid values are 1-64.
colormy=<value>
The color of the My arrow. Valid values are 1-64.
colormyz=<value>
The color of the Myz arrow. Valid values are 1-64.
colormz=<value>
The color of the Mz arrow. Valid values are 1-64.
createfield=<value>
0 - Do not create a nodal force and moment field (default)
1 - Create a nodal force and moment field
createload=<value>
0 - Do not create FBD force and moment loads (default)
1 - Create FBD force and moment loads
declim=<value>
Controls the decimal limit. Default is 2.
display=<value>
0 - Do not plot FBD forces
1 - Plot FBD forces (default)
freenode=<value>
0 - Free nodes. Find the nodes shared by elements other than the elements in the freebodysection (default).
1 - Boundary nodes. Find only te boundary nodes of the elements in the freebodysection.
2 - All nodes. Considers all nodes of the elements in the freebodysection.
fx=<value>
0 - Fx forces are not included in the plot, load or field creation (default)
1 - Fx forces are included in the plot, load or field creation
fxy=<value>
0 - Fxy resultant forces are not included in the plot (default)
1 - Fxy resultant forces are included in the plot
fxyz=<value>
0 - Fxyz resultant forces are not included in the plot (default)
1 - Fxyz resultant forces are included in the plot
fxz=<value>
0 - Fxz resultant forces are not included in the plot (default)
1 - Fxz resultant forces are included in the plot
fy=<value>
0 - Fy forces are not included in the plot, load or field creation (default)
1 - Fy forces are included in the plot, load or field creation
fyz=<value>
0 - Fyz resultant forces are not included in the plot (default)
1 - Fyz resultant forces are included in the plot
fz=<value>
0 - Fz forces are not included in the plot, load or field creation (default)
1 - Fz forces are included in the plot, load or field creation
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 - Mx moments are not included in the plot, load or field creation (default)
1 - Mx moments are included in the plot, load or field creation
mxy=<value>
0 - Mxy resultant moments are not included in the plot (default)
1 - Mxy resultant moments are included in the plot
mxyz=<value>
0 - Mxyz resultant moments are not included in the plot (default)
1 - Mxyz resultant moments are included in the plot
mxz=<value>
0 - Mxz resultant moments are not included in the plot (default)
1 - Mxz resultant moments are included in the plot
my=<value>
0 - My moments are not included in the plot, load or field creation (default)
1 - My moments are included in the plot, load or field creation
myz=<value>
0 - Myz resultant moments are not included in the plot (default)
1 - Myz resultant moments are included in the plot
mz=<value>
0 - Mz moments are not included in the plot, load or field creation (default)
1 - Mz moments are included in the plot, load or field creation
resfileid=<value>
The result file ID for resultid. Useful when multiple result files are loaded for a single result entity.
resolvein_sys=<value>
0 - Resolve in analysis system (default)
1 - Resolve in global system
2 - Resolve in user system
resultant=<value>
0 - Free body force/moment plot
1 - Resultant force/moment plot
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
sizescale=<value>
0 - Constant FBD plot arrow length (default)
1 - Magnitude FBD plot arrow length
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.
tolerance=<value>
The tolerance to limit the values. Default is 0.00001.
user_sys_id=<value>
The system ID when resolvein_sys=2.
vecstyle=<value>
0 - 3D FBD plot arrow (default)
1 - 2D FBD plot arrow
num_strings=<value>
Integer indicating the size (number of strings) in the data_strings array.

Example

Create an FBD force plot:
*createstringarray 48 "scientific=1" "resultant=1" "arroworigin=0" "tolerance=0.00001" 
"scid=1" "resfileid=1" "resultid=1" "showvalue=1" "stepid=1" "sizescale=0" "vecstyle=0" "fx=1" "fy=1" "fz=1" "mx=1" "my=1" "mz=1" "fxy=1" "fyz=1" "fxz=1" "mxy=1" "myz=1" "mxz=1" "fxyz=1" "mxyz=1" "gpf=1" "appf=1" "spcf=1" "intf=1" "mpcf=1" "arrlen=75" "declim=2" "freenode=2" "display=1" "colorfx=3" "colorfy=4" "colorfz=5" "colorfxy=7" "colorfyz=8" "colorfxz=9" "colorfxyz=12" "colormx=3" "colormy=4" "colormz=5" "colormxy=7" "colormyz=8" "colormxz=9" "colormxyz=12"
set fbdIds {1 2 3}
*fbdforce $fbdIds 1 48
Create loads:
*createstringarray 21 "createload=1" "resolvein_sys=3 " "user_sys_id=2" "scid=1" "resfileid=1" "resulted=1" "stepid=1" "fx=1" "fy=1" "fz=1" "mx=1" "my=1" "mz=1" "tolerance=0.00001" "gpf=1" "appf=1" "spcf=1" "intf=1" "mpcf=1" "display=0" "freenode=1"
set fbdIds {1 2 3}
*fbdforce $fbdIds 1 21
Create a field:
*createstringarray 21 "createfield=1" "resolvein_sys=3 " "user_sys_id=2" "scid=1" "resfileid=1" "resulted=1" "stepid=1" "fx=1" "fy=1" "fz=1" "mx=1" "my=1" "mz=1" "tolerance=0.00001" "gpf=1" "appf=1" "spcf=1" "intf=1" "mpcf=1" "display=0" "freenode=1"
set fbdIds {1 2 3}
*fbdforce $fbdIds 1 21

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