constraints

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
5 - Non-weighted constraint engineering load
6 - Weighted constraint engineering load
7 - Thermal 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 load.
Type: pointer(levels 2, 3, and 4)
config
The configuration of the entity.
3 - Constraint
Type: unsigned integer
definedentity
True if the entity is defined, false otherwise.
Type: Boolean
dofstring
The DOF information in string form. Valid for hm_getvalue query only.
Type: string
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
internalid
The ID of the entity.
Type: unsigned integer
set
Pointer to the set when the load is applied to a set.
Type: pointer
solverkeyword
The name of the solver keyword.
Type: string
type
The solver dependent type code for the entity.
Type: integer
typename
The solver dependent type name for the entity.
Type: string

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 value in DOF1 or -999999.0 for none.
Type: double
comp2
The value in DOF2 or -999999.0 for none.
Type: double
comp3
The value in DOF3 or -999999.0 for none.
Type: double
comp4
The value in DOF4 or -999999.0 for none.
Type: double
comp5
The value in DOF5 or -999999.0 for none.
Type: double
comp6
The value in DOF6 or -999999.0 for none.
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
equalmagnitude
Returns 1 if all six DOFs are equal, 0 otherwise.
Type: integer
inputsystem
Pointer to the reference system.
Type: entity
location
The ID of the node where the load is applied. Valid for hm_getvalue query only.
Type: entity
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
spc
1 if at least ond of the six DOF is constrained, 0 otherwise. Valid for hm_getvalue query only.
Type: 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:

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

The following data names are available for ADVC engineering loads:

comp1
The ForcedDisplacement/ForcedVelocity value in the x-direction.
Type: double
comp2
The ForcedDisplacement/ForcedVelocity value in the y-direction.
Type: double
comp3
The ForcedDisplacement/ForcedVelocity value in the z-direction.
Type: double
comp4
The ForcedDisplacement/ForcedVelocity value about the x-direction.
Type: double
comp5
The ForcedDisplacement/ForcedVelocity value about the y-direction.
Type: double
comp6
The ForcedDisplacement/ForcedVelocity value about the z-direction.
Type: double
distribution
The distribution type:
0 - Uniform
1 - Non-uniform
Type: unsigned integer
dof1
The translation in x:
0 - Free DOF
1 - Fixed DOF
Type: Boolean
dof2
The translation in y:
0 - Free DOF
1 - Fixed DOF
Type: Boolean
dof3
The translation in z:
0 - Free DOF
1 - Fixed DOF
Type: Boolean
dof4
The rotation in x:
0 - Free DOF
1 - Fixed DOF
Type: Boolean
dof5
The rotation in y:
0 - Free DOF
1 - Fixed DOF
Type: Boolean
dof6
The rotation in z:
0 - Free DOF
1 - Fixed DOF
Type: Boolean
expanded_form_flag
Flag to export loads on nodes.
Type: Boolean
load_step_id
The ID of the referred loadstep.
Type: entity
prev_bc
Flag to hold previously applied boundary conditions.
Type: Boolean

The following data names are available for Nastran engineering loads:

nas_sname
The set name. SNAME may refer to any of the set names given in degree-of-freedom sets, or their new names on the DEFUSET entry.
Type: string

The following data names are available for OptiStruct engineering loads:

curveid
The ID of the MBCRV entries giving motion vs time.
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_g2
The grid point ID to define relative motion.
Type: entity
os_intrp_type
The interpolation type. Valid values are AKIMA (default), CUBIC or LINEAR.
Type: string
os_sname
The set name. If not equal to U6 or ZEROU6, USET will be ignored. If set to ZEROU6, the degrees-of-freedom are omitted from the set.
Type: string

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

comp1
The value of enforced motion for components Gi at grid Ci.
Type: double
comp2
The value of enforced motion for components Gi at grid Ci.
Type: double
comp3
The value of enforced motion for components Gi at grid Ci.
Type: double
comp4
The value of enforced motion for components Gi at grid Ci.
Type: double
comp5
The value of enforced motion for components Gi at grid Ci.
Type: double
comp6
The value of enforced motion for components Gi at grid Ci.
Type: double
constraint_dof_flag
The constraint type.
For DAREA and TIC, valid values are 0 to 6.
For MOTNG and MOTNGC, valid values are 0 to 18.
Type: unsigned integer
constraint_flag
0 - Translational DOFs (dof1, dof2, dof3)
1 - Rotational DOFs (dof4, dof5, dof6)
2 - All DOFs
Type: unsigned integer
distribution
The distribution type:
0 - Uniform
1 - Non-uniform
Type: unsigned integer
dof1
The translation in x:
0 - Free DOF
1 - Fixed DOF
Type: Boolean
dof2
The translation in y:
0 - Free DOF
1 - Fixed DOF
Type: Boolean
dof3
The translation in z:
0 - Free DOF
1 - Fixed DOF
Type: Boolean
dof4
The rotation in x:
0 - Free DOF
1 - Fixed DOF
Type: Boolean
dof5
The rotation in y:
0 - Free DOF
1 - Fixed DOF
Type: Boolean
dof6
The rotation in z:
0 - Free DOF
1 - Fixed DOF
Type: Boolean
magnitude
In OptiStruct and Nastran, it is the initial displacement or initial velocit in the TIC card, or the area scale factor in the DAREA card.
In OptiStruct , it is the scale factor in MOTNG(D), MOTNG(V) and MOTNG(A) cards.
Type: double
os_d0
The initial displacement if motion is acceleration or velocity, ignored otherwise. Additionally, it also represents the time delay for point Pi and component Ci of the DELAY card with DAREA.
Type: double
os_delay_flag
Enables the time delay term in the dynamic loading fucntion.
Type: Boolean
os_dphase_flag
Enables the phase lead term in the dynamic loading fucntion.
Type: Boolean
os_enforced_deform
The value of the enforced motion for weighted constraints (e.g. SPC, SPCD).
Type: double
os_spc_f_flag
If enabled, retain the deformed boundary.
Type: Boolean
os_v0
The initial velocity if motion is acceleration, ignored otherwise. Additionally, it also represents the phase lead in degrees of the DPHASE card with DAREA.
Type: double

The following data names are available for Radioss engineering loads:

constraint_flag
0 - Translational DOFs (dof1, dof2, dof3)
1 - Rotational DOFs (dof4, dof5, dof6)
2 - All DOFs
Type: unsigned integer
curveid
The ID of the curve defining the time function identifier.
Type: entity
displayname
The text for the title entry.
Type: string
distribution
The spring specification in the IMPDISP_FGEO card:
0 - Spring part selection
1 - Final node psotions
Type: unsigned integer
dof1
The translation in x:
0 - Free DOF
1 - Fixed DOF
Type: Boolean
dof2
The translation in y:
0 - Free DOF
1 - Fixed DOF
Type: Boolean
dof3
The translation in z:
0 - Free DOF
1 - Fixed DOF
Type: Boolean
dof4
The rotation in x:
0 - Free DOF
1 - Fixed DOF
Type: Boolean
dof5
The rotation in y:
0 - Free DOF
1 - Fixed DOF
Type: Boolean
dof6
The rotation in z:
0 - Free DOF
1 - Fixed DOF
Type: Boolean
inputsystem
The skew or frame system.
Type: entity
magnitude
The ordinate (displacement) scale factor for fct_IDT.
Type: double
rad_dir
The direction X, Y or Z in traslation or XX, YY or ZZ in rotation.
Type: string
rad_icoor
The coordinate system usage type:
0 - Cartesian coordinates
1 - Cylindrical coordinates
Type: integer
rad_node_pos
The coordinates of the position node
Type: triple double
rad_sensor_id
The ID of the sensor entity.
Type: entity
rad_sphbcs_ilev
The formulation level:
0 - Particles crossing the symmetry plane will progressively not be taken into account in the computation
1 - Particles will rebound on the symmetry plane, following the elastic shock equations (SPH symmetry conditions)
Type: integer
rad_sphbcs_type
The symmetry condition type:
Slide - Material is perfectly sliding along the plane
Tied - Material cannot slide along the symmetry plane
Type: string
rad_spring_part
The ID of the spring part.
Type: entity
rad_system_input_type
The ID of the reference frame. Must be fixed.
Type: unsigned integer
rad_tstart
The start time.
Type: double
rad_tstop
The stop time (default 10^30).
Type: double
xscale
The abcissa (time) scale factor for fct_IDT.
Type: double

Version History

2020 - New support for engineering loads. Added new data names constraint_flag, constraint_dof_flag, displayname, distribution, dof1, dof2, dof3, dof4, dof5, dof6, displayname, distribution, engineering_type, expanded_form_flag, location, nas_sname, os_d0, os_delay_flag, os_dphase_flag, os_eid, os_enforced_deform, os_g2, os_intrp_type, os_sname, os_spc_f_flag, os_v0, rad_dir, rad_icoor, rad_node_pos, rad_sensor_id, rad_sphbcs_ilev, rad_sphbcs_type, rad_spring_part, rad_system_input_type, rad_tstart, rad_tstop and spc.

2020.1 - Added new data name solverkeyword.

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