moments

Unless otherwise specified, data names are accessible in level 3 only.

engineering_type
The engineering type of load. Engineering loads act on set entities. Valid values are:
0 - Classic load
3 - Directional engineering load
Type: unsigned integer

The following data names are available for both classic and engineering loads:

attributesmax
The number of attributes owned by this entity.
Type: unsigned integer
collector
Pointer to the collector that owns the element.
Type: pointer (levels 2, 3 and 4)
config
The configuration of the entity.
2 - Moment
Type: unsigned integer
definedentity
True if the entity is defined, false otherwise.
Type: Boolean
entityid
The ID of the entity the load is attached to.
Type: integer
entitytype
The type of the entity to which the load is applied.
  • 1 - node
  • 3 - comp
  • 10 - set
  • 27 - point
Type: integer
entitytypename
The string type of the entity to which the load is applied.
  • nodes
  • comps
  • sets
  • points
Type: string
id
The ID of the entity.
Type: unsigned integer
include
The ID of the include file the entity is organized in.
Type: entity
includeid
The ID of the include file the entity is organized in.
Type: unsigned integer
internalid
The ID of the entity.
Type: unsigned integer
internalname
The internal name of the entity.
Type: string
moduleid
The module ID of the entity.
Type: integer
poolid
The pool number of the entity.
Type: integer
poolname
The pool name of the entity.
Type: string
set
Pointer to the set when the load is applied to a set.
Type: pointer
solver_id
The solver ID of the entity.
Type: integer
solverkeyword
The name of the solver keyword.
Type: string
solvername
The solver name of the entity for entities enabled for name pool, otherwise the internal name of the entity.
Type: string
type
The solver dependent type code for the entity.
Type: integer
typename
The solver dependent type name for the entity.
Type: string
vectorx
The x component of the unit vector.
Type: double
vectory
The y component of the unit vector.
Type: double
vectorz
The z component of the unit vector.
Type: double

The following data names are available for classic loads:

baselocation
The coordinates where the load on a component or set should display. Valid for hm_getvalue query only.
Also used to convert the load vector components into local values for non-rectangular coordinate systems.
Type: triple double
baselocationx
The x-coordinate where the load on a component or set should display.
Also used to convert the load vector components into local values for non-rectangular coordinate systems.
Type: double
baselocationy
The y-coordinate where the load on a component or set should display.
Also used to convert the load vector components into local values for non-rectangular coordinate systems.
Type: double
baselocationz
The z-coordinate where the load on a component or set should display.
Also used to convert the load vector components into local values for non-rectangular coordinate systems.
Type: double
comp1
The x component of the vector in the global coordinate system.
Type: double
comp2
The y component of the vector in the global coordinate system.
Type: double
comp3
The z component of the vector in the global coordinate system.
Type: double
component
Pointer to the component when the load is applied to a component.
Type: pointer
curveid
The ID of the curve defining the load magnitude when a curve has been used to define the load.
Type: integer
inputsystem
Pointer to the reference system.
Type: pointer
inputsystemid
The ID of the reference system.
Type: integer
local_comp1
The x component of the vector in the local coordinate system.
Type: double
local_comp2
The y component of the vector in the local coordinate system.
Type: double
local_comp3
The z component of the vector in the local coordinate system.
Type: double
local_vector
The load vector in the local coordinate system.
Type: triple double
local_vectorx
The x component of the unit vector in the local coordinate system.
Type: double
local_vectory
The y component of the unit vector in the local coordinate system.
Type: double
local_vectorz
The z component of the unit vector in the local coordinate system.
Type: double
location
The ID of the node where the load is applied. Valid for hm_getvalue query only.
Type: entity
magnitude
The magnitude of the vector.
Type: double
mappedid
The ID of the original load on geometry.
Type: integer
node
Pointer to the node when the load is applied to a node.
Type: pointer
vector
The component of the unit vector. Valid for hm_getvalue query only.
Type: triple double
xscale
The x scale or time scale of the load curve when a curve has been used to define the load.
Type: double

The following data names are available for engineering loads:

compx
The dot product of the load vector projected on the global x axis.
Type: double
compy
The dot product of the load vector projected on the global y axis.
Type: double
compz
The dot product of the load vector projected on the global z axis.
Type: double
distribution_table_count
The number of rows of a non-uniform engineering load.
Type: unsigned integer
field
The field entity that stores the tabular load data.
Type: entity
location_unit_node
The nodes for which the data is stored in the table for a non-uniform engineering load.
Type: entity array
orient
The load orientation vector.
Type: triple double
orientx
The x component of the load orientation vector.
Type: double
orienty
The y component of the load orientation vector.
Type: double
orientz
The z component of the load orientation vector.
Type: double
resultant_magnitude
The resultant scalar component of the load vector in the global coordiante system.
Type: double

The following data names are available for ADVC engineering loads:

displayname
The text for the title entry.
Type: string
distribution
The distribution type:
0 - Uniform
1 - Non-uniform
Type: unsigned integer
expanded_form_flag
Flag to export loads on nodes.
Type: Boolean
keyword_name
Flag to specify if the title entry is enabled.
Type: Boolean
load_step_id
The ID of the referred loadstep.
Type: entity
magnitude
The scale factor (default 1.0).
Type: double
prev_bc
Flag to hold previously applied boundary conditions.
Type: Boolean
vector
The direction of the force vector. At lesat one of the vector components must be non-zero.
Type: triple double

The following data names are available for LS-DYNA engineering loads:

crash_dir_flag
Input flag to determine if directions can be input using vector or using crash direction semantics.
0 – Select global direction
1 – Select direction component
Type: integer
curveid
The load curve ID.
Type: entity
follower_load
Flag that activates the follower load options.
Type: Boolean
force_ev_fn
Flag that activates force as a function of the absolute value of the rigid body displacement.
Type: Boolean
inputsystem
The coordinate system ID.
Type: entity
load_dof
Applicable degree-of-freedom for LOAD_NODE (type=1) and LOAD_RIGID_BODY (type=2).
5 – Moment in x-axis
6 – Moment in y-axis
7 – Moment in z-axis
8 – Follower moment
Type: integer
magnitude
The load curve scale factor (default 1.0).
Type: double
plane_node1
The node 1 ID for LOAD_NODE (type=1) and LOAD_RIGID_BODY (type=2). Only necessary if load_dof=8.
Type: entity
plane_node2
The node 2 ID for LOAD_NODE (type=1) and LOAD_RIGID_BODY (type=2). Only necessary if load_dof=8.
Type: entity
plane_node3
The node 3 ID for LOAD_NODE (type=1) and LOAD_RIGID_BODY (type=2). Only necessary if load_dof=8.
Type: entity
rigid_part
The part ID of the rigid body.
Type: entity
vector
Force load vector components in the coordinate system CID.
Type: triple double

The following data names are available for Nastran and OptiStruct engineering loads:

distribution
The distribution type:
0 - Uniform
1 - Non-uniform
Type: unsigned integer
inputsystem
The coordinate system ID. A value of 0 or blank references the basic coordinate system.
Type: entity
magnitude
For MOMENT, the scale factor.
For MOMENT1, the force magnitude.
Type: double
os_g1
The grid point ID.
Type: entity
os_g2
The grid point ID.
Type: entity
vector
The direction of the moment vector measured in the system defined by CID. At lesat one of the vector components must be non-zero.
Type: triple double

The following data names are available for OptiStruct engineering loads:

curveid
The ID of the MBCRV entries giving load versus independent variable measured in the coordinate system defined by CID.
Type: integer
expanded_form_flag
Flag to export loads on nodes.
Type: Boolean
os_eid
The ID of the MBVAR for the independent variable expression.
Type: entity
os_intrp_type
The interpolation type. Valid values are AKIMA (default), CUBIC or LINEAR.
Type: string

The following data names are available for Radioss engineering loads:

curveid
The ID of the curve defining the time function identifier.
Type: entity
crash_dir_flag
Specifies if directions can be input using vector or crash direction semantics:
0 - Select global direction
1 - Select direction component
Type: unsigned integer
crash_dofstring
The sring that outputs the computed DOF directions, useful if the direction is specified using a string vector.
Type: string
displayname
The text for the title entry.
Type: string
inputsystem
The system ID for the skew or frame identifier.
Type: entity
magnitude
The ordinate scale factor (default 1.0).
Type: double
rad_dir
The direction in translation. Valid values are X, Y and Z for forces and XX, YY and ZZ for moments.
Type: string
rad_ivar_flag
The flag to disregard the variation of velocity with respect to time for the calculation of the force.
1 - Variation of velocity is not considered (default)
2 - Variation of velocity is considered
Type: integer
rad_sensor_id
The ID of the sensor entity.
Type: entity
xscale
The abscissa (time) scale factor (default 1.0).
Type: double

Version History

2020 - New support for engineering loads. Added new data names compx, compy, compz, crash_dir_flag, crash_dofstring, displayname, distribution, distribution_table_count, engineering_type, expanded_form_flag, field, local_comp1, local_comp2, local_comp3, local_vector, local_vectorx, local_vectory, local_vectorz, location, location_unit_node, orient, orientx, orienty, orientz, os_eid, os_g1, os_g2, os_intrp_type, rad_dir, rad_ivar_flag, rad_sensor_id and resultant_magnitude.

2020.1 - Added new data name solverkeyword.

2021 - Added new data names keyword_name, load_step_id and prev_bc. New ADVC support.

2021.1 – Added new data names for LS-DYNA engineering loads: crash_dir_flag, curveid, follower_load, force_ev_fn, inputsystem, load_dof, magnitude, plane_node1, plane_node2, plane_node3, rigid_part and vector.

2021.1 - Added new data names moduleid, poolid, poolname, and solver_id.

2021.2 - Added new data names internalname and solvername.