Salome HOME
Copyright update 2022
[modules/homard.git] / doc / en / gui_mesh_info.rst
1 .. _gui_mesh_info:
2
3 Mesh analysis
4 #############
5 .. index:: single: analysis
6 .. index:: single: information
7
8 The request of analysis of a mesh is made by the following information:
9
10   - A directory
11   - A mesh file
12
13 If the mesh is a part of a registered case, its analysis is made from its iteration in the object browser. See farther.
14
15
16 Importation of the mesh
17 ***********************
18 The selection of the function of analysis is made by the menu of the superior bar of the window:
19
20 .. image:: images/mesh_info_1.png
21    :align: center
22
23 The window of choice is displayed.
24
25 .. image:: images/mesh_info_2.png
26    :align: center
27
28 Name of the case
29 ****************
30 A name of case is automatically proposed: Case_1, Case_2, etc. This name can be modified. He must not already have been used for another case.
31
32 The directory
33 *************
34 The directory is the one which will contain files produced by the information. By default, nothing is proposed. The choice is made, either by typing the name in the text field, or by activating the function of research. It is in this directory that will be exported the files of information of name "Liste.log" and "info_av.00.bilan". These files will be visible in the object browser.
35
36 .. image:: images/create_case_2.png
37    :align: center
38
39 .. index:: single: mesh;initial
40 .. index:: single: MED
41
42 Mesh to be analysed
43 *******************
44 The mesh to be analyzed has to be in a file in the format MED. The name of the file can be supplied, either by typing the name in the text field, or by activating the function of research.
45
46 .. image:: images/create_case_3.png
47    :align: center
48
49 .. note::
50   The file has to contain only a single mesh.
51
52 .. warning::
53   The mesh does not have to be produced of an adaptation of mesh by HOMARD itself, at the risk of losing the analysis of the various levels of refinement / unrefinement
54
55 Options for the analysis
56 ************************
57 The analysis is made according to the marked options.
58   - Quality of elements
59   - Diameter of elements
60   - Connectivity of the domain; in a single piece, how many holes, etc.
61   - Sizes of the constituents of the domain, group by group
62   - Interpenetration of elements, by dimension
63
64 The result of the analysis is contained in the file "info_av.00.bilan"; this file is to be consulted by showing it after its name with "*Edit file*" in the menu HOMARD or with the mouse.
65
66 Object browser
67 **************
68 At the end of this request of information, the object browser was enriched by this new case. We find the initial iteration there, identified by the name of the mesh which was read in the supplied file, and both files of information of name "Liste.log" and "info_av.00.bilan".
69
70 .. image:: images/mesh_info_3.png
71    :align: center
72
73
74 Computed iteration
75 ******************
76
77 To analyze the mesh produced by an iteration of mesh adaptation, we indicate with the mouse this iteration in the object browser and we launch the analysis. We find the menu similar to the initial case:
78
79 .. image:: images/mesh_info_4.png
80    :align: center
81
82 As for an imported mesh, the object browser was enriched with both files of information of name "Liste.log" and "info_ap.xx.bilan", where xx is the number of the iteration in the case.
83
84 .. image:: ../images/mesh_info_5.png
85    :align: center
86
87
88
89 Corresponding python functions
90 ******************************
91 Look :doc:`tui_create_case` and :doc:`tui_create_iteration`
92