doc/salome/gui/SMESH/input/building_compounds.rst

   1 .. _building_compounds_page:
   2
   3 ************************
   4 Building Compound Meshes
   5 ************************
   6
   7 Compound Mesh is a combination of several mesh objects (meshes, groups, submeshes). All elements and groups present in input meshes are present in the compound mesh. However, it does not use geometry or hypotheses of the initial mesh objects.
   8 The links between the input meshes and the compound mesh are not supported, consequently the modification of an input mesh does not lead to the update of the compound mesh.
   9
  10 There are two modes of building a compound:
  11
  12 * joining selected mesh objects into a new mesh.
  13 * appending selected mesh objects to an existing mesh.
  14
  15 *To Build a compound mesh:*
  16
  17 .. |img| image:: ../images/image161.png
  18
  19 From the **Mesh** menu select **Build Compound** or click *"Build Compound Mesh"* button |img| in the toolbar. The following dialog box will appear:
  20
  21         .. image:: ../images/buildcompound.png
  22                 :align: center
  23
  24 * **Result** group allows selecting a mode of operation
  25
  26   * Activating **Create new mesh named** enables typing the name of the resulting compound mesh.
  27   * Activating **Append to mesh** enables selection of a mesh to append other selected objects to.
  28
  29 * **Meshes, sub-meshes, groups** allows selecting the meshes, sub-meshes and groups to be concatenated. They can be chosen in the Object Browser while holding *Ctrl* button.
  30 * **Processing identical groups** allows selecting the method of processing the namesake groups existing in the input meshes. They can be either
  31
  32   * **United** - all elements of *Group1* of *Mesh_1* and *Group1* of *Mesh_2* become the elements of *Group1* of the *Compound_Mesh*, or
  33   * **Renamed** - *Group1* of *Mesh_1* becomes *Group1_1* and *Group1* of *Mesh_2* becomes *Group1_2*.
  34
  35   See :ref:`grouping_elements_page` for more information about groups.
  36 * **Create groups from input objects** check-box permits to automatically create groups corresponding to every initial mesh.
  37
  38         .. image:: ../images/buildcompound_groups.png
  39                 :align: center
  40
  41         .. centered::
  42                 Groups created from input meshes 'Box_large' and 'Box_small'
  43
  44 * You can choose to additionally :ref:`Merge coincident nodes <merging_nodes_page>` :ref:`and elements <merging_elements_page>` in the compound mesh, in which case it is possible to define the **Tolerance** for this operation.
  45
  46         .. image:: ../images/image160.gif
  47                 :align: center
  48
  49         .. centered::
  50                 Example of a compound of two meshed cubes
  51
  52 **See Also** a sample script of :ref:`tui_building_compound`.