Salome HOME
#17864 [CEA 17856] Issue with Import 1D-2D
[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 algorithms import elements whose all nodes lye on the geometry
11 being meshed.
12 The mesh elements to import from the other mesh should be contained in
13 groups. If several groups are used to mesh the same geometry, validity of
14 nodal connectivity of result mesh must be assured by connectivity of
15 the source mesh; no geometrical checks are performed to merge
16 different nodes at same locations.
17
18 The source elements must totally cover the meshed geometry.
19 The source elements lying partially over the geometry will not be used.
20
21 These algorithms can be used to mesh a very complex geometry part by
22 part, by storing meshes of parts in files and then fusing them
23 together using these algorithms.
24
25
26 **Import 1D Elements from Another Mesh** algorithm allows to define
27 the mesh of a geometrical edge (or group of edges)
28 by importing mesh edges contained in a group (or groups) from another mesh.
29  
30 To apply this algorithm select the edge to be meshed (indicated in
31 the field **Geometry** of **Create mesh** dialog box),
32 **Import 1D Elements from Another Mesh** in the list of 1D
33 algorithms and click the *"Add Hypothesis"* button.
34 The following dialog box will appear:
35
36 .. image:: ../images/hyp_source_edges.png
37         :align: center                                                 
38
39 In this dialog box you can define 
40
41 * The **Name** of the algorithm. 
42 * The **Groups of Edges** to import 1D elements from.
43 * **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.
44
45
46 **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. The algorithm imports a mesh face provided that all its nodes lye on the geometrical face.
47
48 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.
49
50 The following dialog box will appear:
51
52 .. image:: ../images/hyp_source_faces.png
53         :align: center                                                 
54
55 In this dialog box you can define 
56
57 * The **Name** of the algorithm. 
58 * The **Groups of Faces** to import 2D elements from.
59 * **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.
60
61
62 **See Also** a sample TUI Script of :ref:`Import 2D Elements from Another Mesh <tui_import>`.