*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)
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
if { [ catch {command_name...} ] } {
# Handle error
}Version History
2021