*organizecomponents

Reorganizes elements in existing components based on selected policy.

Syntax

*organizecomponents policy ?preserve_element_include?

Type

HyperMesh Tcl Modify Command

Description

Reorganizes the existing elements by grouping them based on one of the following policies:
  1. By property

    Elements of same property are grouped under one component. The component is assigned that property and the component inherits the meta data such as name, color, module, include from the property

  2. By material

    Elements of same material are grouped under one component. The component inherits the meta data such as name, color, module, include from the material

  3. As one component

    All valid elements are grouped under one component.

By default, the elements follow the components to the destination include which in turn follows the targeted entity (properties or materials). The current element include organization can be preserved using the optional argument preserve_element_include.

Inputs

policy
The grouping policy. Valid values are:
1 – By property
2 – By material
3 – As one component
preserve_element_include
Optional argument to preserve the current element include structure. Valid values are 0 or 1.

Examples

To organize all components by property:
*organizecomponents 1
or
*organizecomponents byprop

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

2022