*replacentitywithentitymark

Syntax

*replacentitywithentitymark mode existing_component_mark incoming_component_mark string_array number_of_strings

Type

HyperMesh Tcl Modify Command

Description

This command replaces multiple components.

Inputs

mode

The replace mode. Valid values are:

• 0 - Undo/reject replace operation.
• 1 - Initial replace operation.
• 2 - Finish/accept replace operation.

existing_component_mark

The ID of the mark containing the existing/old components.

incoming_component_mark

The ID of the mark containing the incoming/new components.

string_array

The ID of the string array that contains the input options. The string array is created using the *createstringarray command. This should always be set to 1.

The supported options and values are:

tolerance=value

The replacement tolerance. Right now it is a global tolerance, meaning the same tolerance is applied for all replace entities. The default is 0.01.

keep_src_prop=value

0 - Do not reuse/keep the property assigned to the outgoing component (default)

1 - Reuse/ assign property of source component to the outgoing component.

keep_src_mat=value

0 - Do not reuse/keep the material assigned to the outgoing component (default)

1 - Reuse/assign material of source component to the outgoing component.

keep_src_comp_cardimage=value

0 - Do not reuse/keep the card image assigned to the outgoing component (default)

1 - Reuse/ assign source component card image to the outgoing component.

keep_src_include=value

0 - Do not organize the incoming component to the outgoing component include (default)

1 - Organize the incoming component and its nodes/elements/reference entities to the outgoing component include.

log_file=value

If a log file is desired, value should be set to the full path and file name to write to.

number_of_strings

Integer indicating the size (number of strings) in the string array created using *createstringarray.

Example

To replace components 301 and 302 with 501 and 502 respectively:

*createmark comps 1 301 302
*replacesetentitydata componentmark=1
*createmark sets 1 20 30
*createmark groups 1 20 30
*replacesetentitydata preservemark=1 incomingonlyentities={sets groups} componentpairingstring={{301 501} {302 502}}
*createstringarray 4 "tolerance=0.5" "keep_src_prop=1" "keep_src_mat=1" "keep_src_comp_cardimage=1"
*createmark comps 1 301 302
*createmark comps 2 501 502
*replacentitywithentitymark 1 1 2 1 4

Errors

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

Version History

2017.2