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
}