**union

Description

This command creates the union of meshes.

Syntax

**union \(~\,\) *add mesh-name \(~\,\) [ *elset eset-name ] \(~\,\) [ *merge_nset merge ] \(~\,\) [ *base_name base-name ] \(~\,\) [ *tolerance val ] \(~\,\) [ *translation trans-vector ] \(~\,\) [ *create_elset ] \(~\,\) [ *merge_elsets ] \(~\,\) [ *no_fuse ] \(~\,\) [ *merge_by_func ] \(~\,\) [ *merge_func <FUNCTION> ] \(~\,\) [ *allow_empty_mesh ] \(~\,\) [ *from_element ] \(~\,\) [ *from_node ] \(~\,\) [ *append_id ] \(~\,\) [ *dont_renumber ] \(~\,\) [ *node_offset ]

*add mesh-name

adds the mesh in file mesh-name.geof to the active mesh.

*elset eset-name

A new element set will be created with the name eset-name and containing all the elements added in this operation.

*merge_nset

limit the fusion of nodes to the given node set. The node set is on the current mesh, not the newly added mesh given by mesh-name.

*base_name

rename all sets from old-name to base-name.old-name.

*tolerance

Gives the critical distance for node fusion between the two meshes. If too large, elements will collapse because node neighbors are joined, too small and there may be gaps at the interface. Use zero to join two meshes without node fusion, such as in the joining of two parts in contact. The default value is \(10^{-3}\) (or the value of the global parameter Mesher.MeshFusion if it was modified).

*translation

Translates the new elements by trans-vector. trans-vector must be input in theform (x y z)

*create_elset

create an elset for each added mesh. Its name is the name of the added mesh file.

*merge_elsets

if the added mesh contains an elset with a name that already exists in the active mesh, they will be merged.

*no_fuse

do not fuse nodes.

*merge_by_func

A flag to restrict the fusion of nodes to only those that satisfy a function to be given after *merge_func.

*allow_empty_mesh

allow empty mesh to be added.

*from_element

element id from which the numbering of added elements starts, but without changing the order.

*from_node

node id from which the numbering of added nodes starts, but without changing the order.

*append_id

number elements and nodes from the maximum ids innthe active mesh. The id to start from can also be given by *from_node/*from_element.

*dont_renumber

do not renumber node ids.

*node_offset

shift node ids by an offset.

Note

*dont_renumber, *node_offset and *append_id are mutually exclusive, so only one of them can be used at once.

Example

A short example follows of some union sections from the test case in Mesher_test/INP/PIPE.inp

**union
 *add pipe-data/PIPE1.geof
 *elset PIPE1
 *tolerance 0.15
**union
 *add pipe-data/PIPE2.geof
 *elset PIPE2
 *tolerance 0.15
 *translation (0. 10. 0.)