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 coordinate system.
Type: double

The following data names are available for Abaqus engineering loads:

boundary_region
The type of boundary region on which load is applied.
LAGRANGIAN - Apply the load to a Lagrangian boundary region (default)
SLIDING - Apply the load to a Sliding boundary region
EULERIAN - Apply the load to an Eulerian boundary region
Type: string
curveid
The amplitude curve that defines the variation of the load magnitude during the step.
Type: entity
cyclic_mode
The cyclic symmetry mode number of loads that are applied in the current steady-state dynamics procedure.
Type: integer
distribution
The distribution type:
0 - Uniform
1 - Non-uniform
Type: unsigned integer
dload_type
The distributed load type for DLOAD.
CENTRIF - Centrifugal load
CENT - Centrifugal load
CORIO - Coriolis force
Type: string
expanded_form_flag
Flag to export loads on elements/nodes.
Type: Boolean
follower_load
Flag to activate follower load options.
Type: Boolean
load_case
The load case number (1 or 2).
Type: integer
magnitude
Reference load magnitude.
Type: double
matrix_generation
The mutually exclusive parameters for matrix generation and steady-state dynamics analyses.
REAL - Define the real (in-phase) part of the loading
IMAGINARY - Define the imaginary (out-of-phase) part of the loading
Type: string
rot_axis_pos
The coordinates of a point on the axis of rotatory acceleration.
Type: triple double
vector
For DLOAD with load label CENTRIF, CENT or CORIO
Components of the direction cosine of the axis of rotation.
For CLOAD
Vector components to define degree of freedom.
Type: triple 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 least 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.

2022.2 - Added data name for Abaqus engineering loads: boundary_region, cyclic_mode, dload_type, load_case, matrix_generation, and rot_axis_pos.