*ME_ModuleOccurrenceInstancesDetach

Breaks a list of module occurrences from their current prototype and re-assigns them to new prototypes.

Syntax

*ME_ModuleOccurrenceInstancesDetach me_ids ?options?

Type

HyperMesh Tcl Modify Command

Description

Breaks a list of module occurrences from their current prototype and re-assigns them to new prototypes.

Every module occurrence in a model has an associated module prototype that it came from. A single module prototype may provide the base for multiple module occurrences, i.e. a prototype of a wheel, might have four occurrences in a vehicle.

This command is applied to a list of occurrences that are a subset of all the instances of a common, original prototype, i.e. the 2 right side wheels of the vehicle. It will break the existing links with the original prototype for the specified occurrences so they can have their own, unique definition. A new, cloned version of the original prototype will be created, and the specified occurrences will be re-linked to the new prototype, which provides the basis of this new definition.

In the case of a multi-level instanced assembly, the command will also appropriately handle the assembly instances to create and re-link additional prototype clones of assemblies as required. Finally, based on the options provided, the command will perform additional operations (i.e. copying attributes) between the original structure and the new cloned entities.

Inputs

me_ids
The IDs of the modules to detach, within quotes if more than one.
options
The list of input options, passed as a comma separated string enclosed in quotes. Valid options are:
copyprotoattribs=<value>
NONE - Do not copy any attributes from original prototypes to newly created cloned prototypes
HW_PDM - Copy the PDM attributes from original prototypes to newly created cloned prototypes

Example

Break the module occurrences with IDs 22 and 24 from their current prototype and re-assigns them to newly created prototypes which are assigned the PDM attributes from the original prototypes:

* ME_ModuleOccurrenceInstancesDetach "22 24" "copyprotoattribs=HW_PDM"

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

2019.1