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
}