Connect/merge the proximity regions of 2D elements within a given
tolerance.
Syntax
*mesh_fusing
destination_entity_type destination_mark_id target_entity_type target_mark_id
"string_options"
Type
HyperMesh Tcl Modify Command
Description
Connect/merge the proximity regions of 2D elements within a given tolerance. Elements are
distributed into groups based on their connectivity and component membership. The elements
belonging to different components can be in a single group by parameter input. Only are
different groups taken as counterparts of proximity/intersection calculation and fusing.
Inputs
-
destination_entity_type
- The destination entity type. Valid values are elems and comps.
-
destination_mark_id
- The ID of the mark containing the destination entities. Valid values are 1 and
2.
- All entities can also put on this mark. The actual destination elements will be
filtered out automatically by source_mark_id.
-
source_entity_type
- The source entity type. Valid values are elems and comps.
-
source_mark_id
- The ID of the mark containing the source entities. Valid values are 1 and 2.
-
"string_options"
- A string that defines the advanced parameters. Each option/value pair is space
separated, and can be specified in any order. The entire string must be enclosed in
quotes.
-
-
adjust_elem_orientation
- 0 - Auto normal adjustment is not performed.
- 1 - For input without intersecting elements in contact regions, auto normal
adjustment is performed (default).
-
break_shell_along_component_boundaries
- 0 - All elements connected each other are classified as a group.
- 1 - Element group building stops at component boundaries. This mean that
elements in an element group belong to a single component. This is the
default.
-
collapse_source_fusing_lines
- 0 - Both source and target fusing lines remain (default).
- 1 - Stitch both source and target fusing lines.
-
excl_tangent_angle
- Used to filter out some elements inside the proximity fusing regions (0,
90].
-
feature_angle
- This value is used to define feature edges on mesh. Default value is 30.0.
-
fusing_direction
- 1 - The normal directions of the source elements are used as fusing directions.
- 0 - Fusing direction are defined automatically (default).
-
fusing_elems_to_new_comp
- 0 - Fusing element are stored to the component of source elements
(default).
- 1 - Fusing elements are stored to the new component fusing_elems
- 2 - Fusing elements are stored to the current component.
-
keep_fusing_shell
- 0 - The elements inside source or destination fusing regions are deleted
(default).
- 1 - The elements inside source fusing regions are kept, while the elements
inside destination fusing regions are deleted.
- 2 - The elements inside destination fusing regions are kept, while the elements
inside source fusing regions are deleted.
- 3 - All elements inside fusing regions are kept.
-
kept_intersect_segment_angle
- Used to decide whether some element intersection segments are kept as part of
fusing region boundaries (0, 90].
-
mark_init_prox_elems_only
- 1 - Only perform the proximity calculations between all source and destination
elements, and mark the elements within the input tolerance.
- 0 - Do not do (default).
-
num_remesh_layers
- -1 - Intersecting elements are split and stitched to obtain conformal element
connectivity. No remeshing is performed.
- 0 - Remesh only the intersecting elements.
- > 0 - Remesh the specified number of layers of elements in addition to the
intersecting elements.
-
proximity_tolerance
- Used to decide the fusing regions. Only the source elements with this distance
to the elements in the destination are considered as candidates in the source
fusing region. The corresponding elements in the destination within this distance
are the candidates corresponding to mated fusing regions.
-
snapping_tolerance
- Used to decide whether region boundaries are allowed to snap to the free mesh
edges when the distance of the boundaries of the fusing regions to free mesh
boundaries are less than this value, and operation is possible.
-
tria_remesh_growth_ratio
- Used to specify the triangular element size growth ratio when
use_adaptive_tria_remesh is 1.
-
use_adaptive_tria_remesh
- 0 - Use the default tria remesher.
- 1 - Use the adaptive tria remesher.
Examples
To fuse all components, using component "green" as the
source:
*createmark components 1 "displayed"
*createmark components 2 "green"
*mesh_fusing components 1 components 2 \
"feature_angle 30.0 \
break_shell_along_component_boundaries 0 \
mark_init_prox_elems_only 0 \
fusing_direction 0 \
proximity_tolerance 2.0 \
excl_tangent_angle 65.0 \
kept_intersect_segment_angle 45.0 \
keep_fusing_shell 0"
Errors
Incorrect usage results in a
Tcl error. To detect
errors, you can use the
catch
command:
if { [ catch {command_name...} ] } {
# Handle error
}
