hm_getconfigtypecountincol

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

Syntax

hm_getconfigtypecountincol collector_type entity_type name_or_id ?search_type?

Type

HyperMesh Tcl Query

Description

This command returns as a list the unique config, type anc count (number) combinations for the entities inside a collector. The list returns a list containing alternating config, type and count 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 50 tria3 elements (config 103) of type 1, 25 tria3 elements of type 2, and 10 quad4 elements (config 104) of type 3, the values returned would be:

103 1 50 103 2 25 104 3 15

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, type and count 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
}

Version History

10.0