hm_getalltiedentities

Identifies groups of connected components and free parts within selected components.

Syntax

hm_getalltiedentities entity_type mark_id ?option1=value1? ?option2=value2? ... ?optionN=valueN?

Type

HyperMesh Tcl Query

Description

This command identifies group of connected parts and free parts, including tied and non-tied to the entities, within selected components. The output is a string with the connectivity information if any is found, or 0 otherwise. The output is of the form:

G- {IDg1, IDg2,…IDgN} F- {IDf1, IDf2, ..., IDfN}

Where G represents a group of connected parts, and F represents free parts.

You can select the types of components (like RBE3, welds) to be excluded or included while grouping attached entities. Mass elements are excluded when checking for connectivity.

Currently enabled for LS-DYNA only.

Inputs

entity_type
The type of entity to query. Must be set to comps.
mark_id
The ID of the mark containing the entities to query. Valid values are 1 and 2.
<option>=<value>
Additional options are available to further control the behavior. These are optional and can be specified in any order after the first two mandatory arguments. All options support yes/no, 1/0 and true/false values.
connectors=<value>
Include connectors while checking connectivity. The default value is true/yes/1.
constrainedextranodes=<value>
Include constrained extra nodes while checking connectivity. The default value is true/yes/1.
constrainedgroups=<value>
Include constrained extra groups while checking connectivity. The default value is true/yes/1.
constrainedrigidbodies=<value>
Include constrained rigid bodies while checking connectivity. The default value is true/yes/1.
contactgroups=<value>
Include contact groups while checking connectivity. The default value is true/yes/1.
joints=<value>
Include joints while checking connectivity. The default value is true/yes/1.
physicalconnectivity=<value>
Include node-to-node connections while checking connectivity. The default value is true/yes/1.
rbe3=<value>
Include RBE3 elements while checking connectivity. The default value is true/yes/1.
rigidlinks=<value>
Include rigidlinks while checking connectivity. The default value is true/yes/1.
slipringretractors=<value>
Include slip ring retractors while checking connectivity. The default value is true/yes/1.
welds=<value>
Include weld elements while checking connectivity. The default value is true/yes/1.

Examples

To include all kinds of connectivity:

*createmark comps 1 displayed
hm_getalltiedentities comps 1 connectors=true
or
hm_getalltiedentities comps 1 connectors=1
or
hm_getalltiedentities comps 1 connectors=yes
To exclude node to node connectivity:
*createmark comps 1 displayed
hm_getalltiedentities comps 1 physicalconnectivity=false
or
hm_getalltiedentities comps 1 physicalconnectivity=0
or
hm_getalltiedentities comps 1 physicalconnectivity=no
To exclude connectivity by rigid links and joints:
*createmark comps 1 displayed
hm_getalltiedentities comps 1 rigidlinks=false joints=false
or
hm_getalltiedentities comps 1 rigidlinks=0 joints=0
or
hm_getalltiedentities comps 1 rigidlinks=no joints=no

Errors

Incorrect usage results in a Tcl error. To detect errors, you can use the catch command:
if { [ catch {command_name...} ] } {
   # Handle error
}

Version History

14.0.130