Salome HOME
b4d2eeca23a423d0fccadf6b9750ad7d11a93194
[modules/homard.git] / doc / gui_create_hypothese.rst
1 .. _gui_create_hypothese:
2
3 L'hypothèse
4 ===========
5 .. index:: single: hypothèse
6
7 L'hypothèse contient toutes les paramètres de pilotage d'une adaptation d'un maillage. Cette opération permet de réaliser l'itération à laquelle elle est attachée.
8
9 Il existe trois classes d'hypothèses :
10
11   - Uniforme sur tout le maillage,
12   - Selon un champ,
13   - En fonction de zone géométrique.
14
15 .. image:: images/create_hypothese_1.png
16    :align: center
17
18
19 Nom de l'hypothèse
20 """"""""""""""""""
21 Un nom de l'hypothèse est proposé automatiquement : Hypo_1, Hypo_2, etc. Ce nom peut être modifié. Il ne doit pas avoir été utilisé pour une hypothèse précédente.
22
23 Adaptation uniforme
24 """""""""""""""""""
25 Par défaut on propose un raffinement uniforme. Quand on part d'un maillage qui a déjà été raffiné, l'option de déraffinement supprimera les mailles produites.
26
27 Adaptation selon un champ
28 """""""""""""""""""""""""
29
30 .. note::
31   Pour pouvoir adapter le maillage selon un champ il faut avoir au préalable désigné le fichier med contenant le champ. Cela se fait dans la fenêtre de construction de l'itération (voir :ref:`gui_create_iteration`). Le nom du fichier qui a été sélectionné est affiché sans modification possible ici :
32
33 .. image:: images/create_hypothese_ch_1.png
34    :align: center
35
36 Le champ voulu est à choisir dans la liste des champs contenus dans le fichier.
37 Une fois ce champ choisi, la liste des ses composantes s'affiche. Il suffit de désigner la (ou les) composantes désirées.
38
39 Si l'on choisit une seule composante, par défaut, c'est sa valeur absolue qui sera utilisée, mais il est possible d'utiliser la valeur relative. Dans le cas de plusieurs composantes, par défaut HOMARD utilisera la norme L2 (euclidienne). On peut toutefois choisir d'utiliser la norme infinie (le max des valeurs absolues des composantes).
40
41 On peut choisir de ne pas utiliser directement le champ, mais sa variation d'un élément à ses voisins. Pour cela, on activera le bouton "*Saut entre éléments*".
42
43 .. image:: images/create_hypothese_ch_2.png
44    :align: center
45
46
47 Le raffinement se fait selon un seuil qui définit un critère haut de raffinement. Toutes les mailles pour lesquelles l'indicateur est supérieur à ce critère seront raffinées.
48 Pour le choix du critère, trois variantes sont possible :
49
50   - selon un pourcentage de mailles à raffiner, nombre réel compris entre 0 et 100 ; HOMARD raffinera les x% des mailles qui ont la plus grande valeur du champ.
51   - selon une valeur relative du champ, nombre compris entre 0 et 100 ; HOMARD raffinera les mailles où le champ est supérieur à x% de l'intervalle [mini,maxi].
52   - selon une valeur absolue ; toutes les mailles avec une valeur de champ supérieure à cette valeur seront raffinées.
53
54 La même convention s'applique au déraffinement, en remplaçant supérieur par inférieur. On peut inactiver une des fonctions (raffinement ou déraffinement) en cochant le bouton ad_hoc.
55
56 .. image:: images/create_hypothese_ch_3.png
57    :align: center
58
59
60 Adaptation selon une zone
61 """""""""""""""""""""""""
62 .. index:: single: zone
63
64 Au démarrage, il faut créer une première zone par activation du bouton "*Nouveau*" (voir :ref:`gui_create_zone`) :
65
66 .. image:: images/create_hypothese_zo_1.png
67    :align: center
68
69 Lorsque des zones ont déjà été créées, la liste apparaît dans la fenêtre, ce qui permet de sélectionner les zones voulues.
70
71 .. image:: images/create_hypothese_zo_2.png
72    :align: center
73
74
75 Filtrage par les groupes
76 """"""""""""""""""""""""
77 .. index:: single: groupe
78
79 On peut restreindre l'application de l'hypothèse d'adaptation à des groupes. Ainsi les mailles n'appartenant pas à ces groupes ne seront pas modidiées, sauf par contamination ultérieure du raffinement pour assurer la conformité du maillage final.
80 On coche le bouton associé :
81
82 .. image:: images/create_hypothese_gr_1.png
83    :align: center
84
85 La liste des groupes de mailles présents dans le maillage est affichée. Il suffit de cocher ceux voulus pour restreindre l'hypothèse d'adaptation.
86
87 .. image:: images/create_hypothese_gr_2.png
88    :align: center
89
90
91 Interpolation de champs
92 """""""""""""""""""""""
93 .. index:: single: interpolation
94
95 .. note::
96   Pour pouvoir interpoler un champ de l'ancien vers le nouveau maillage, il faut avoir au préalable désigné le fichier med contenant le champ. Cela se fait dans la fenêtre de construction de l'itération (voir :ref:`gui_create_iteration`).
97
98 Par défaut, aucun champ n'est interpolé. A contrario, on peut demander l'interpolation de tous les champs présents dans le fichier fourni :
99
100 .. image:: images/create_hypothese_ch_4.png
101    :align: center
102
103 Si on veut choisir les champs à interpoler, il faut les cocher dans la liste de tous les champs présents dans le fichier fourni :
104
105 .. image:: images/create_hypothese_ch_5.png
106    :align: center
107
108
109 L'arbre d'étude
110 """""""""""""""
111 .. index:: single: arbre d'étude
112
113 L'arbre d'études contient les hypothèses créées et les itérations qui les utilisent. La description des zones qui leur sont éventuellement attachées est présente.
114
115 .. image:: images/create_hypothese_2.png
116    :align: center
117
118
119
120 Méthodes python correspondantes
121 """""""""""""""""""""""""""""""
122 Consulter :ref:`tui_create_hypothese`