*organizecomponents

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

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

Version History

2022