*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