Creates an FBD displacement plot, and fields or loads from the results.
Syntax
*fbddisplacement
set_ids=<value> data_strings=<value> num_strings=<value>
Type
HyperMesh Tcl Modify Command
Description
Creates an FBD displacement plot, and fields or loads from the results.
This queries the displacement data from the result entity on a freebodysection.
Inputs
- set_ids=<value>
- The set 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:
- 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 displacement field (default)
- 1 - Create a nodal displacement field
- createload=<value>
- 0 - Do not create FBD displacement loads (default)
- 1 - Create FBD displacement loads
- declim=<value>
- Controls the decimal limit. Default is 2.
- display=<value>
- 0 - Do not plot FBD displacements
- 1 - Plot FBD displacements (default)
- displacement=<value>
- 0 - Applied forces are not particupating in the FBD calculation (default)
- 1 - Applied forces are particupating in the FBD calculation
- freenode=<value>
- Currently must be set to 2. This is a mandatory argument.
- fx=<value>
- 0 - Fx translations are not included in the plot, load or field creation
(default)
- 1 - Fx translations are included in the plot, load or field creation
- fxy=<value>
- 0 - Fxy resultant translations are not included in the plot (default)
- 1 - Fxy resultant translations are included in the plot
- fxyz=<value>
- 0 - Fxyz resultant translations are not included in the plot (default)
- 1 - Fxyz resultant translations are included in the plot
- fxz=<value>
- 0 - Fxz resultant translations are not included in the plot (default)
- 1 - Fxz resultant translations are included in the plot
- fy=<value>
- 0 - Fy translations are not included in the plot, load or field creation
(default)
- 1 - Fy translations are included in the plot, load or field creation
- fyz=<value>
- 0 - Fyz resultant translations are not included in the plot (default)
- 1 - Fyz resultant translations are included in the plot
- fz=<value>
- 0 - Fz translations are not included in the plot, load or field creation
(default)
- 1 - Fz translations are included in the plot, load or field creation
- mx=<value>
- 0 - Mx rotations are not included in the plot, load or field creation
(default)
- 1 - Mx rotations are included in the plot, load or field creation
- mxy=<value>
- 0 - Mxy resultant rotations are not included in the plot (default)
- 1 - Mxy resultant rotations are included in the plot
- mxyz=<value>
- 0 - Mxyz resultant rotations are not included in the plot (default)
- 1 - Mxyz resultant rotations are included in the plot
- mxz=<value>
- 0 - Mxz resultant rotations are not included in the plot (default)
- 1 - Mxz resultant rotations are included in the plot
- my=<value>
- 0 - My rotations are not included in the plot, load or field creation
(default)
- 1 - My rotations are included in the plot, load or field creation
- myz=<value>
- 0 - Myz resultant rotations are not included in the plot (default)
- 1 - Myz resultant rotations are included in the plot
- mz=<value>
- 0 - Mz rotations are not included in the plot, load or field creation
(default)
- 1 - Mz rotations 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
- resultid=<value>
- The result entity ID.
- rotation=<value>
- 0 - SPC forces are not particupating in the FBD calculation (default)
- 1 - SPC forces are particupating in the FBD calculation
- 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
- 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 displacement
plot:
*createstringarray 46 "scientific=1" "arroworigin=0" "tolerance=0.00001" "scid=1" "resfileid=1" "resultid=1" "showvalue=1" "stepid=1" "sizescale=0" "vecstyle=0" "resolvein_sys=3 " "user_sys_id=2" "displacement=1" "rotation=1" "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" "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 setIds {1 2 3}
*fbddisplacement $setIds 1 46
Create
loads:
*createstringarray 17 "createload=1" "resolvein_sys=0" "scid=1" "resfileid=1" "resulted=1" "stepid=1" "fx=1" "fy=1" "fz=1" "mx=1" "my=1" "mz=1" "tolerance=0.00001" "displacement=1" "rotation=1" "display=0" "freenode=2"
set setIds {1 2 3}
*fbddisplacement $setIds 1 17
Create a
field:
*createstringarray 18 "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" "displacement=1" "rotation=1" "display=0" "freenode=2"
set setIds {1 2 3}
*fbddisplacement $setIds 1 18
Errors
Incorrect usage results in a
Tcl error. To detect
errors, you can use the
catch
command:
if { [ catch {command_name...} ] } {
# Handle error
}