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 I_xx 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 I_xx component of the mass moment of inertia for the elements in the component. This is calculated about the component COG.
IYY: The I_YY 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 I_YY component of the mass moment of inertia for the elements in the component. This is calculated about the component COG.
IZZ: The I_ZZ 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 I_ZZ component of the mass moment of inertia for the elements in the component. This is calculated about the component COG.
IXY: The I_XY 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 I_XY component of the mass moment of inertia for the elements in the component. This is calculated about the component COG.
IXZ: The I_XZ 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 I_XZ component of the mass moment of inertia for the elements in the component. This is calculated about the component COG.
IYZ: The I_YZ 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 I_YZ 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.