*library_retrieve_rep

Adds specific representations from a connected library.

Syntax

*library_retrieve_rep entity_type string_array number_of_strings repfolder ?overwrite=<value>? ?load=<value>?

Type

HyperMesh Tcl Modify Command

Description

Adds specific representations from a connected library.

Inputs

entity_type
The entity type stored in the library. Currently supported for parts and subsystems.
string_array
The string array ID that contains:
  • UID
  • Library item ID
  • Representation alias list or Representation UDM IDs list
The string array is created using the *createstringarray command. This should always be set to 1.
number_of_strings
Integer indicating the size (number of strings) in the string array created using *createstringarray. The array should contain three strings, so this should be always set to 3 for this specific command.
repfolder
The folder in which the representation exists.
overwrite=<value>
The flag defining if session information is overwritten. Default is true.
load=<value>
The name of the alias to be loaded. Default is empty (no alias is loaded).

Examples

To retrieve a part representation with UID LeftInner_A of major revision A from folder C:/Temp/representations:
set lib_info [ hm_libraryget parts iteminfo id uid=LeftInner_A major_revision=A study_revision=- ]
set lib_item_id [ lindex [ lindex $lib_info 1] 1 ]
*createstringarray 3 "LeftInner_A" $lib_item_id "NVH 10mm"
*library_retrieve_rep parts 1 3 C:/Temp/representations

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

2026