components

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

activesuppressed
Returns non-zero if the entity is set inactive, 0 otherwise.
Type: integer
attributesmax
The number of attributes owned by this entity.
Type: unsigned integer
cardimage
The name of the assigned card image.
Type: string
cardimagetype
The type of the assigned card image.
Type: string
color
The 1-64 color of the entity.
Type: integer
color_rgb
The RGB color of the entity.
Type: string
connectors
The list of connectors contained in the component. Valid for hm_getvalue query only.
Type: entity array
definedentity
True if the entity is defined, false otherwise.
Type: Boolean
elements
The list of elements contained in the component. Valid for hm_getvalue query only.
Type: entity array
festyle
The FE visualization style.
Type: integer
geomstyle
The geometry visualization style.
Type: integer
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
internalpropertyid
The ID of the property assigned to the component. This could be a valid property ID or unresolved property ID.
Type: integer
isempty
Returns "1" if the component does not contain any elements, "0" otherwise.
Type: integer
lines
The list of lines contained in the component. Valid for hm_getvalue query only.
Type: entity array
material
Material pointer to the material assigned to the component. This will always be a valid material ID if one is assigned.
Type: pointer
materialid
The ID of the material assigned to the component. This could be a valid material ID or unresolved material ID.
Type: integer
moduleid
The module ID of the entity.
Type: integer
name
The name of the entity.
Type: string
nodes
The list of nodes associated to elements contained in the component. Valid for hm_getvalue query only.
Type: entity array
outputsuppressed
Returns non-zero if the entity is set "do not export", 0 otherwise.
Type: integer
points
The list of points contained in the component. Valid for hm_getvalue query only.
Type: entity array
poolid
The pool number of the entity.
Type: integer
poolname
The pool name of the entity.
Type: string
property
Property pointer to the property assigned to the component. This will always be a valid property ID if one is assigned.
Type: pointer
propertyid
The ID of the property assigned to the component. This could be a valid property ID or unresolved property ID.
Type: integer
solids
The list of solids contained in the component. Valid for hm_getvalue query only.
Type: entity array
solver_id
The solver ID of the entity.
Type: integer
solverkeyword
The name of the solver keyword.
Type: string
surfaces
The list of surfaces contained in the component. Valid for hm_getvalue query only.
Type: entity array
The following data names are only available for "core" solver templates routinely maintained by Altair:
cogx
The x center-of-gravity for the elements in the component. This takes into account the thickness and mass of the elements.
cogy
The y center-of-gravity for the elements in the component. This takes into account the thickness and mass of the elements.
cogz
The z center-of-gravity for the elements in the component. This takes into account the thickness and mass of the elements.
IXX
The Ixx component of the mass moment of inertia for the elements in the component. This is calculated about the global origin (0,0,0).
IXXcog
The Ixx component of the mass moment of inertia for the elements in the component. This is calculated about the component COG.
IYY
The IYY component of the mass moment of inertia for the elements in the component. This is calculated about the global origin (0,0,0).
IYYcog
The IYY component of the mass moment of inertia for the elements in the component. This is calculated about the component COG.
IZZ
The IZZ component of the mass moment of inertia for the elements in the component. This is calculated about the global origin (0,0,0).
IZZcog
The IZZ component of the mass moment of inertia for the elements in the component. This is calculated about the component COG.
IXY
The IXY component of the mass moment of inertia for the elements in the component. This is calculated about the global origin (0,0,0).
IXYcog
The IXY component of the mass moment of inertia for the elements in the component. This is calculated about the component COG.
IXZ
The IXZ component of the mass moment of inertia for the elements in the component. This is calculated about the global origin (0,0,0).
IXZcog
The IXZ component of the mass moment of inertia for the elements in the component. This is calculated about the component COG.
IYZ
The IYZ component of the mass moment of inertia for the elements in the component. This is calculated about the global origin (0,0,0).
IYZcog
The IYZ component of the mass moment of inertia for the elements in the component. This is calculated about the component COG.
mass
The summed total mass of the elements in the component. This takes into account both structural and nonstructural mass.
nonstructuralmass
The summed nonstructural mass of the elements in the component.
principalaxis1
The x, y and z components of the first principal axis for the elements in the component. This is calculated about the global origin (0,0,0).
principalaxis1cog
The x, y and z components of the first principal axis for the elements in the component. This is calculated about the component COG.
principalaxis2
The x, y and z components of the second principal axis for the elements in the component. This is calculated about the global origin (0,0,0).
principalaxis2cog
The x, y and z components of the second principal axis for the elements in the component. This is calculated about the component COG.
principalaxis3
The x, y and z components of the third principal axis for the elements in the component. This is calculated about the global origin (0,0,0).
principalaxis3cog
The x, y and z components of the third principal axis for the elements in the component. This is calculated about the component COG.
structuralmass
The summed structural mass of the elements in the component.
thickness
The thickness of the component. This only takes into account the thickness of the property assigned to the component.

LS-DYNA Specific Data Names

The following data names are only available for LS-DYNA, or have specific behavior for LS-DYNA.

distributedmass
This is the mass distributed from nodal rigid bodies to free nodes.
Type: double
engineeringmass
Corresponds to structuralmass + lumpedmass + nonstructuralmass.
Type: double
Exceptions:
For PART with PART_INERTIA:
Secondary CRB of this part should have 0 mass.
The mass of the part should be equal to TM (if Iflag=1, transfer mass from secondary to main).
For *CONSTRAINED_NODAL_RIGID_BODY_INERTIA
The mass of the secondary nodes on the connected part should not be taken into account.
lumpedmass
The summed lumped mass added through *ELEMENT_MASS, *ELEMENT_MASS_NODE_SET, *ELEMENT_INERTIA or *ELEMENT_SEATBELT_ACCELEROMETER.
Type: double
nonstructuralmass
The summed nonstructural mass added through *ELEMENT_MASS_PART_SET, *ELEMENT_MASS_PART or NSM in *SECTION.
Type: double
rigidbodymass
Mass in nodal rigid bodies. This is the mass transferred from deformable nodes to nodal rigid bodies. This includes the mass transfer of the lumped mass defined on deformable elements of the nodal rigid body.
Type: double
solvertpartmass
For rigid parts:
  • Structural mass + lumped mass + non-structural mass + mass transferred from deformable nodes (including lumped mass ; NSM applied on these nodes) + mass transferred from other rigid parts (merged)
  • If PART_INERTIA is defined then the mass/COG/inertia are equal to the ones specified (if Iflag=1 in xtranodes or crb these are added too)
For deformable parts:
  • Structural mass + non-structural mass - mass in nodal rigid bodies (lumped mass excluded)
Type: double
structuralmass
The summed structural mass of the elements in the component.
For PART_INTERIA, reports the translational mass (TM) value.
Type: double
totalmass
Corresponds to distributedmass + lumpedmass + nonstructuralmass + rigidbodymass + structuralmass + transferredmass
Type: double
transferredmass
This is the mass transferred from deformable nodes to rigid materials. This includes lumped mass transfer from rigid or deformable nodes to the rigid materials.
For rigid material this is the mass gained from deformable (+). For deformable parts this is the mass lost to rigid material (-).
Type: double

Radioss Specific Data Names

The following data names are only available for Radioss, or have specific behavior for Radioss.

distributedmass
This is the mass distributed from rigid bodies to free nodes.
Type: double
engineeringmass
Corresponds to structuralmass + lumpedmass - transferredmass.
Type: double
lumpedmass
The summed lumped mass.
Type: double
rigidbodymass
The rigid bodies mass. This is the mass transferred from deformable nodes to rigid bodies. This includes the mass transfer of the lumped mass defined on deformable elements of the rigid body.
Type: double
solvertpartmass
The mass given by the solver.
Type: double
totalmass
Corresponds to distributedmass + lumpedmass + rigidbodymass + structuralmass
Type: double

Version History

2019 - Added new data names festyle and geomstyle. Support added for Radioss to distributedmass, engineeringmass, lumpedmass, rigidbodymass, solvertpartmass and totalmass.

2020 - Added new data name color_rgb.

2020.1 - Added new data name solverkeyword.

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