hm_getmultilevelreferenceentities

Finds all the multi-level reference entities for the entities specified on the input mark.

Syntax

hm_getmultilevelreferenceentities entity_type inputmark=<mark_id> outputmark=<mark_id>

Type

HyperMesh Tcl Query Command

Description

Finds all the multi-level reference entities for the entities specified on the input mark. Each type of entity that is referenced by the specified input entities is returned in a list, and the found entities are placed on the corresponding mark with the specified output mark ID.

Inputs

entity_type
The type of entity for which related entities are to be found.
inputmark=<mark_id>
The ID of the mark containing the input entities. Valid values are 1 or 2.
outputmark=<mark_id>
The ID of the mark in which to place the found referenced entities. Valid values are 1 and 2.

Examples

To obtain all the entities related to components ID 1 and 2 on mark 1:

*createmark comps 1 1 2
hm_getmultilevelreferenceentities comps inputmark=1 outputmark=2

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

2021.1

See Also

hm_getcrossreferencedentitiesmark

hm_getreferencedentitiesmark

hm_getreferencedentities