hm_getconfigtypeincol

Returns a list indicating the entity config and type values that are contained in a collector.

Syntax

hm_getconfigtypeincol collector_type entity_type name_or_id ?search_type?

Type

HyperMesh Tcl Query Command

Description

This command returns as a list the unique config and type combinations for the entities inside a collector. The list returns a list containing alternating config and type values for the entities of entity_type contained in the collector. The values are returned sorted by increasing config and increasing type within each config. For example, for a component collector containing tria3 elements (config 103) of type 1, tria3 elements of type 2, and quad4 elements (config 104) of type 3, the values returned would be:

103 1 103 2 104 3

Inputs

collector_type: The type of collector to query. Valid values are comps, groups and loadcols.
entity_type: The type of entities in the collector_type to return the config and type values for. The valid value for collector_type comps and groups is elems. The valid values for collector_type loadcols are equations and loads.
name_or_id: The name or ID of the queried collector_type.
?search_type?: By default, HyperMesh searches for entities by name, and if the name is not found, it then searches by ID. This option allows you to specify how the search for an entity should be conducted. The two options are:; -byname: search only by name; -byid: search only by ID

Example

To get the config, type and count of all elements in the component collector named my_comp:

set var [hm_getconfigtypecountincol comps elems my_comp -byname]

Errors

Incorrect usage results in a Tcl error. To detect errors, you can use the catch command:

if { [ catch {command_name...} ] } {
   # Handle error
}