Salome HOME
bos #26453 Merge branch 'jfa/uniform_refinement'
[modules/smesh.git] / doc / salome / gui / SMESH / input / adaptation.rst
1 .. _adaptation_page:
2
3 **********
4 Adaptation
5 **********
6
7 Mesh module provides the possibility to perform different adaptations of a mesh.
8 To refine the mesh means to cut out elements indicated according to indications provided by the user.
9
10 .. _homard_adapt_anchor:
11
12 HOMARD
13 ######
14
15 HOMARD can treat meshes into 2 or 3 dimensions and comprising the following elements:
16    - mesh-points
17    - segments
18    - triangles
19    - quadrangles
20    - tetrahedra
21    - hexahedra
22    - prisms
23
24 These elements can be present simultaneously. For example, HOMARD will be able to adapt a comprising mesh of the triangles and the quadrangles.
25
26 To start operation, select **Remesh with HOMARD** item in **Adaptation** menu.
27
28 .. image:: ../images/adaptation_with_homard_arguments.png
29   :align: center
30
31 * **Mesh In** is the initial mesh to remesh.
32 * **Mesh Out** is the resulting mesh after remeshing. By default, the name of the initial mesh is kept and the file name is based on the name of the initial mesh.
33 * **Conformity type** is a choice between **Conformal** and **Non conformal**.
34 * **Boundary type** is a choice between **No boundary**, **CAO** and **Non CAO**.
35
36 - If the choice is **CAO**, a XAO file is required for each CAO boundary creation.
37
38 .. image:: ../images/adaptation_with_homard_boundary_cao.png
39   :align: center
40
41 **See more** at :ref:`homard_create_boundary_CAO`.
42
43 - If the choice is **Non CAO**, some discrete and/or analytical boundaries can be created.
44
45 .. image:: ../images/adaptation_with_homard_boundary_discrete.png
46   :align: center
47
48 **See more** at :ref:`homard_create_boundary_Di`.
49
50 .. image:: ../images/adaptation_with_homard_boundary_analytical.png
51   :align: center
52
53 **See more** at :ref:`homard_create_boundary_An`.
54
55 .. note::
56   The exhaustive description of HOMARD can be read into its documentation. It can be reached by the general help button.
57
58 **See Also** a sample TUI Script of adaptation with :ref:`tui_homard_adapt`.
59
60
61 .. _mg_adapt_anchor:
62
63 MG_Adapt
64 ########
65
66 For meshes made of triangles and/or tetrahedra, remeshing operations are available with the MG-Adapt plugin. The remeshing is based on wanted mesh sizes defined over the mesh or as a constant. The boundaries are dedeuced from the initial mesh.
67
68 To start **Remeshing** operation, select **Remesh with MG_Adapt** item in **Adaptation** menu.
69
70 .. image:: ../images/adaptation_01.png
71   :align: center
72
73
74 * **Mesh In** is the initial mesh to remesh.
75 * **Mesh Out** is the resulting mesh after remeshing. By default, the name of the initial mesh is kept and the file name is based on the name of the initial mesh.
76 * **Size map definition** is a choice between **Local**, **Background** and **Constant**.
77
78 - If the choice is **Background**, the name of the MED file must be given.
79 - If the choice is **Local** or **Background**, the name of the field must be selected from the list, together with time step.
80
81 .. image:: ../images/adaptation_02.png
82   :align: center
83
84 .. note::
85   The exhaustive description of MG-Adapt can be read into its documentation. It can be reached by the general help button.
86
87 **See Also** a sample TUI Script of :ref:`tui_adaptation_page`.