*ME_ModuleOccurrencesLink

Links a set of module occurrences to a main module occurrence.

Syntax

*ME_ModuleOccurrencesLink main_id ids ?options?

Type

HyperMesh Tcl Modify Command

Description

Links a set of specified module occurrences to a main module occurrence to allow all of them to share the main occurrence’s underlying definition (including its prototype).

Every module occurrence in a model has an associated module prototype. A single module prototype may provide the base definition for multiple module occurrences, i.e. a prototype of a wheel might have four occurrences in a vehicle. In some models, the original model definition does not have this modelling structure and each module occurrence has its own prototype when they could share a common prototype definition. This command provides a method to link these similar module occurrences to obtain the desired instanced model structure.

When this command is applied to a list of occurrences, it will update the model structure, handle the cleanup of the discarded prototype definitions, and handle any matrix updates required by the specified options.

Inputs

main_id

The ID of the source module occurrence which provides the underlying definitions (i.e. the prototype) to be shared.

ids

The IDs of the module occurrences to be linked to the main module occurrence, within quotes if more than 1.

?options?

List of input options, passed as a comma separated string enclosed in quotes. Valid options are:

updatematrices=<value>: none - Do not update the structural matrices of the linked module occurrences (default); calcoffset - Update the structural matrices for each linked module occurrences by calculating the offset in positions of the current contents of each linked module occurrence relative to the main module occurrence

Examples

To link the modules 24, 26 and 28 to share the definition of main module 22. As a result of the command, all of these modules will now share the same prototype and representations. In this operation, the matrices for the linked modules will be updated with any required offsets between each module and the main module:

*ME_ModuleOccurrencesLink 22 "24 26 28" "updatematrices=calcoffset"

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

2021