Salome HOME
Merge remote branch 'origin/V8_5_asterstudy'
[modules/smesh.git] / 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 meshes. 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 meshes. 
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 *To Build a compound mesh:*
11
12 .. |img| image:: ../images/image161.png
13
14 From the **Mesh** menu select **Build Compound** or click *"Build Compound Mesh"* button |img| in the toolbar. The following dialog box will appear:
15
16         .. image:: ../images/buildcompound.png
17                 :align: center
18
19 * **Name** - allows selecting the name of the resulting **Compound** mesh.
20 * **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.
21 * **Processing identical groups** - allows selecting the method of processing the namesake groups existing in the input meshes. They can be either 
22
23   * **United** - all elements of *Group1* of *Mesh_1* and *Group1* of *Mesh_2* become the elements of *Group1* of the *Compound_Mesh*, or
24   * **Renamed** - *Group1* of *Mesh_1* becomes *Group1_1* and *Group1* of *Mesh_2* becomes *Group1_2*.
25     
26   See :ref:`grouping_elements_page` for more information about groups.
27 * **Create groups from input objects** check-box permits to automatically create groups corresponding to every initial mesh.
28
29         .. image:: ../images/buildcompound_groups.png
30                 :align: center
31
32         .. centered:: 
33                 Groups created from input meshes 'Box_large' and 'Box_small'
34
35 * 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.
36
37         .. image:: ../images/image160.gif
38                 :align: center
39
40         .. centered::
41                 Example of a compound of two meshed cubes
42
43 **See Also** a sample script of :ref:`tui_building_compound`.