*imprint_mesh

Imprints mesh or geometry onto target mesh or FE geometry surface/lines creating new edges/fixed points or a mesh patch respectively.

Syntax

*imprint_mesh src_type=<entity_type> src_mark=<mark_id> tgt_type=<entity_type> tgt_mark=<mark_id> ?option1=<value1>? ?option2=<value2>? … ?optionN=<valueN>?

Type

HyperMesh Tcl Modify Command

Description

Imprints source entities (nodes or elements) onto target entities (elements, components, parts or surfaces) with various input options.

Inputs

src_type=<entity_type>: The type of the source entity for imprint. Valid values are nodes, elements, and surfaces. Note that only FE geometry surfaces are supported.
src_mark=<mark_id>: The ID of the mark containing the source entities for imprint. This will not be used if source is a node list. Valid values are 1 and 2.
tgt_type=<entity_type>: The type of target entity for imprint. Valid values are lines, surfaces, elements, components and parts.
tgt_mark=<mark_id>: The ID of the mark containing the target (destination) entities for imprint. Valid values are 1 and 2.
src_node_list=<value>: The ID of the list containing the source nodes defining the segments to imprint. Valid values are 1 and 2. This will be passed only if the source is a node list.
close_node_list=<value>: This is applicable only if source is a node list.; 0 - Do not imprint segment between the last node and the first node to close the list as a loop (default if not provided).; 1 – Imprint a segment between the last node and the first node to close the list as a loop.
anchor_nodes_mark=<value>: The ID of the mark containing the anchor nodes used for imprint. If provided, these nodes are anchored during imprint/remesh. Valid values are 1 and 2.
remain=<value>: 1 - Source remains, source node coordinates are kept. (default); 2 - Destination remains, node coordinates projected to destination are used.; 3 - Both remain, source entities are projected and a copy is imprinted to destination.; 4 - Create patch between source entities and the imprinted copy to destination.
projection=<value>: 0 - Normal to destination. (default); 1 - Along tangent.; 2 - Along vector direction, if defined 3 doubles should be defined in projection_vector.
projection_vector={x y z}: The x, y, z components defining the vector direction. Should be defined if projection is set to 2.
to_dest_component=<value>: -1 - Create elements in source component.; 0 - Create elements in current component. (default); 1 - Create elements in destination component.
do_not_remesh_rebuild_extn=<value>: 0 – Remesh/rebuild extension. (default); 1 - Do not remesh/rebuild extension.
do_not_add_fixed_points_edges=<value>: 0 - Add fixed points/edges on nodes imprint. (default); 1 - Do not add fixed points/edges on nodes imprint.
remesh_mode=<value>: -1 - No remesh. Element connectivity is maintained by recovery of the imprinting element edges.; 0 - Do not remesh destination. Destination mesh is stitched to maintain element connectivity. (default); 1 - Remesh all input destination elements.; 2 - Remesh destination elements defined by remesh_layers.
remesh_layers=<value>: Must be defined if remesh_mode is 2.; 0 - Remesh only the elements attached to the border of the imprinted element image.; > 0 - Remesh additional layers in addition to the elements attached to the imprinted element image. (default 2)
angle=<value>: The angle in degrees used to define feature edges on the mesh. (default 25.0)
max_distance=<value>: The command will exit with an error if the distance between source and destination exceeds this value. If not specified, this is ignored.
mesh_size=<value>: The mesh size used for remeshing the imprint area. Automatically detected from input mesh if not provided.
mesh_type=<value>: The mesh type used for remeshing the imprint area. Automatically detected from input mesh if not provided.; 0 - tria; 1 - quad; 2 - mixed; 3 - R-tria; 4 - quad only

Examples

To imprint elements ID 217 to 232 onto elements ID 117 to 216, imprinting along direction (0, 0, -1), creating a patch, with destination component as source component, remesh rebuild extension as 1, add fixed points edges as 0, without anchor nodes, remesh mode as 0 and a feature angle of 30:

*createmark elems 1 217-232
*createmark elems 2 117-216
*imprint_mesh src_type=2 src_mark=1 tgt_type=2 tgt_mark=2 projection=1 projection_vector={0 0 -1} remain=4 to_dest_component=-1 do_not_remesh_rebuild_extn=1 do_not_add_fixed_points_edges=0 anchor_nodes_mark=0 remesh_mode=0 angle=30.0

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

2023