Salome HOME
Fix Redesign of SMESH documentation
[modules/smesh.git] / doc / salome / gui / SMESH / input / use_existing_algos.rst
1 .. _import_algos_page: 
2
3 ********************************************
4 Import Elements from Another Mesh Algorithms
5 ********************************************
6
7 **Import Elements from Another Mesh** algorithms allow to
8 define the mesh of a geometrical 
9 object by importing suitably located mesh elements from another
10 mesh. The mesh elements to import from the other mesh should be contained in
11 groups. If several groups are used to mesh the same geometry, validity of
12 nodal connectivity of result mesh must be assured by connectivity of
13 the source mesh; no geometrical checks are performed to merge
14 different nodes at same locations.
15
16 The source elements must totally cover the meshed geometry.
17 The source elements lying partially over the geometry will not be used.
18
19 These algorithms can be used to mesh a very complex geometry part by
20 part, by storing meshes of parts in files and then fusing them
21 together using these algorithms.
22
23
24 **Import 1D Elements from Another Mesh** algorithm allows to define
25 the mesh of a geometrical edge (or group of edges)
26 by importing mesh edges contained in a group (or groups) from another mesh.
27  
28 To apply this algorithm select the edge to be meshed (indicated in
29 the field **Geometry** of **Create mesh** dialog box),
30 **Import 1D Elements from Another Mesh** in the list of 1D
31 algorithms and click the *"Add Hypothesis"* button.
32 The following dialog box will appear:
33
34 .. image:: ../images/hyp_source_edges.png
35         :align: center                                                 
36
37 In this dialog box you can define 
38
39 * The **Name** of the algorithm. 
40 * The **Groups of Edges** to import 1D elements from.
41 * **To copy mesh** checkbox allows to import not only the edges of the selected **Groups of Edges**, but the whole source mesh. In this case **To copy groups** checkbox allows to create the same groups as in the imported source mesh.
42
43
44 **Import 1D-2D Elements from Another Mesh** algorithm allows to define the mesh of a geometrical face (or group of faces) by importing mesh faces contained in a group (or groups) from another (or this) mesh. 1D elements on the boundary of the geometrical face (if not yet present) are also created by the algorithm in conformity with the created 2D elements.
45
46 To apply this algorithm select the geometrical face to be meshed (indicated in the field **Geometry** of **Create mesh** dialog box), **Import 1D-2D Elements from Another Mesh** in the list of 2D algorithms and click the *"Add Hypothesis"* button.
47
48 The following dialog box will appear:
49
50 .. image:: ../images/hyp_source_faces.png
51         :align: center                                                 
52
53 In this dialog box you can define 
54
55 * The **Name** of the algorithm. 
56 * The **Groups of Faces** to import 2D elements from.
57 * **To copy mesh** checkbox allows to import not only the faces of the selected **Groups of Faces**, but the whole source mesh. In this case **To copy groups** checkbox allows to create the same groups as in the imported source mesh.
58
59
60 **See Also** a sample TUI Script of :ref:`Import 2D Elements from Another Mesh <tui_import>`.