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 3Inputs
- 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:
Example
To get the config and type of all elements in the component collector named my_comp:
set var [hm_getconfigtypeincol 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
}