accelerations

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.
9 - Acceleration
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
5 - surf
10 - set
27 - point
28 - line
Type: integer
entitytypename
The string type of the entity to which the load is applied.
nodes
comps
surfs
sets
points
lines
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
inputsystem
Pointer to the reference system.
Type: entity
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 in the global coordinate system.
Type: double
vectory
The y component of the unit vector in the global coordinate system.
Type: double
vectorz
The z component of the unit vector in the global coordinate system.
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.
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 (levels 2, 3 and 4)
curveid
The ID of the curve defining the load magnitude when a curve has been used to define the load.
Type: entity
inputsystemid
The ID of the reference system.
Type: entity
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 LS-DYNA engineering loads:

activation_time
The time the imposed motion is activated (default 0.0).
Type: double
add_part_construct_stage
The construction stage at which a part is added (default 0).
Type: integer
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: unsigned integer
crash_dofstring
The string that outputs the computed DOF directions.
Type: string
curveid
The load curve ID.
Type: entity
deactivation_time
The time the imposed motion is removed (default 1020).
Type: double
displayname
The description of the loading.
Type: string
dyn_relax_evolve_fn
The load curve defined as a function of time during dynamic relaxation.
Type: entity
entity_select_option
Flag that enables curve selection using curveid for LOAD_GRAVITY_PART (type=0).
keyword_name
Flag that activates ID option.
Type: Boolean
load_body_opt
Available options include for base accelerations. Valid options are X, Y, or Z.
Type: string
load_dof
For BOUNDARY_PRESCRIBED_MOTION (type=1):
1 - x-translational degree-of-freedom
2 - y-translational degree-of-freedom
3 - z-translational degree-of-freedom
4 - Translational motion in direction given by the VID. Movement on plane normal to the vector is permitted.
-4 - Translational motion in direction given by the VID. Movement on plane normal to the vector is not permitted.
5 - x-rotational degree-of-freedom
6 - y-rotational degree-of-freedom
7 - z-rotational degree-of-freedom
8 - Rotational motion about a vector parallel to vector VID. Rotation about the normal axes is permitted.
-8 - Rotational motion about a vector parallel to vector VID. Rotation about the normal axes is not permitted.
9 - Rotation motion about axis parallel to the x-axis. Radial motion is not permitted.
-9 - Rotation motion about axis parallel to the x-axis. Radial motion is permitted.
10 - Rotation motion about axis parallel to the y-axis. Radial motion is not permitted.
-10 - Rotation motion about axis parallel to the y-axis. Radial motion is permitted.
11 - Rotation motion about axis parallel to the z-axis. Radial motion is not permitted.
-11 - Rotation motion about axis parallel to the z-axis. Radial motion is permitted.
For LOAD_GRAVITY_PART (type=0):
1 – Direction X
2 – Direction Y
3 – Direction Z
Type: integer
motion_rigid_local_option
Flag that activates the LOCAL option.
Type: Boolean
motion_type
Velocity/Acceleration/Displacement flag.
0 - Velocity (rigid bodies and nodes)
1 - Acceleration (rigid bodies and nodes)
2 - Displacement (rigid bodies and nodes)
3 - Velocity versus displacement (rigid bodies only)
4 - Relative displacement (rigid bodies only)
Type: integer
magnitude
Load curve scale factor (default 1.0).
Type: double
motion_vec_dir
The vector ID for BOUNDARY_PRESCRIBED_MOTION (type=1) for load_dof values 4 and 8.
Type: entity
nodal_rigid_body
The element ID of the constrained nodal rigid body.
Type: entity
plane_axis_coord1
The offset for BOUNDARY_PRESCRIBED_MOTION (type=1) for load_dof types 9 - 11 (y, z, x direction) (default 0.0).
Type: double
plane_axis_coord2
The offset for BOUNDARY_PRESCRIBED_MOTION (type=1) for load_dof types 9 - 11 (z, x, y direction) (default 0.0).
rem_part_construct_stage
The construction stage at which a part is removed (default 0).
Type: integer
rigidbody_option
Flag that enables nodal rigid body selection.
Type: Boolean
rigid_part
The part ID of the rigid body.
Type: entity
vector
The acceleration load vector components in the coordinate system CID.
Type: triple double

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

curveid
The ID of the curve defining the scale factor values at defined locations.
Type: entity
distribution
The distribution type:
0 - Uniform
1 - Non-uniform
Type: unsigned integer
magnitude
The scale factor for the load vector.
Type: double
os_comp_dir
The component direction of the load variation. Valid values are X, Y and Z.
Type: string
vector
The acceleration load vector components in the coordinate system CID. A minimum of one Ni should not be 0.0.
Type: triple double

The following data names are available for OptiStruct engineering loads:

os_tid
The ID of the load collector with card image TABLED1, defining the location (LOCi) versus scale factor (VALi) values.
Type: entity

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
magnitude
The ordinate (force) scale factor (default 1.0).
Type: double
rad_dir
The direction in translation. Valid values are X, Y, Z, XX, YY and ZZ.
Type: string
rad_sensor_id
The ID of the sensor entity.
Type: entity
rad_tstart
The start time.
Type: double
rad_tstop
The stop time (default 10^30).
Type: double
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, field, local_comp1, local_comp2, local_comp3, local_vector, local_vectorx, local_vectory, local_vectorz, location, location_unit_node, orient, orientx, orienty, orientz, os_comp_dir, os_tid, rad_dir, rad_sensor_id, rad_tstart, rad_tstop and resultant_magnitude.

2020.1 - Added new data name solverkeyword.

2021.1 – Added new data names for LS-DYNA engineering loads: activation_time, add_part_construct_stage, crash_dir_flag, crash_dofstring and load_body_opt, curveid, deactivation_time, displayname, dyn_relax_evolve_fn, entity_select_option, keyword_name, load_dof, magnitude, motion_rigid_local_option, motion_type, motion_vec_dir, nodal_rigid_body, plane_axis_coord1, plane_axis_coord2, rem_part_construct_stage, rigid_part, rigidbody_option, vector, moduleid, poolid, poolname, and solver_id.

2021.2 - Added new data names internalname and solvername.