*move_feature

Moves a selection of elements and pastes them onto the displayed shell elements at the target location.

Syntax

*move_feature entity_type mark_id string_array number_of_strings

Type

HyperMesh Tcl Modify Command

Description

Moves a selection of elements and pastes them onto the displayed shell elements at the target location. The neighborhood of the pasted region will be remeshed. If the selected entities are connected to another mesh at the source, they are detached from them. Any holes left behind are patched and remeshed. Doesn’t allow moving elements associated to geometry.

Inputs

entity_type
The type of entity to copy. Valid values are components and elements. The selection may consist of shell or solid elements. Any 1D elements attached to shell elements are automatically included.
mark_id
The ID of the mark of entities. Valid values are 1 and 2.
string_array
The ID of the string array that contains the additional input parameters. The string array is created using the *createstringarray command. This should always be set to 1.
All parameters are case insensitive, order insensitive and optional. If not supplied, the default values will be used. Valid parameters and their syntax are:
NumLayers : <value>
The number of layers to remesh (default 2).
MoprhFeatureToBase : <value>
0 - Do not morph.
1 - Morph to conform to the shape of the base mesh at the target location (default).
Rebuild : <value>
0 - Remesh using size and bias.
1 - Remesh using rebuild (default).
TransformByMatrix : <tr11> <tr12> <tr13> <tr14> <tr21> <tr22> <tr23> <tr24> <tr31> <tr32> <tr33> <tr34> <tr41> <tr42> <tr43> <tr44>
The transformation specified as a 4x4 matrix.
TransformByNodes : <sn1> <sn2> <sn3> <tn1> <tn2> <tn3>
The transformation specified between two systems defined at source and target locations. The system at source is defined by three nodes sn1, sn2 and s3. The origin is defined by the node sn1. The x-axis is defined by the vector from sn1 to sn2. The x-y plane is defined as the plane containing all three nodes sn1, sn2 and sn3. Similarly, the system at target is defined by three nodes tn1, tn2 and tn3.
number_of_strings
Integer indicating the size (number of strings) in the string array created using *createstringarray.

Example

To move elements 5100-5200 along the -y direction with a distance of 1, and remeshing 2 layers with the rebuild algorithm:

*createstringarray 5 "TransformByMatrix : 0 -1 0 0 1 0 0 0 0 0 1 0 0 0 0 1 " "MorphFeatureToBase : 1" "Rebuild : 1" "NumLayers : 2"
*createmark elements 1 5100-5200
*copy_feature elements 1 1 5

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