Salome HOME
Merge from V6_main 13/12/2012
[modules/homard.git] / doc / tui_create_boundary.rst
1 .. _tui_create_boundary:
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. On doit alors préciser si une zone est utilisée pour raffiner toutes les mailles dont une arête est contenue dans la zone, ou si la zone est utilisée pour déraffiner les mailles intérieures à la zone. Si aucun choix n'est fait, la zone est ignorée dans cette hypothèse.
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 Les options avancées
110 """"""""""""""""""""
111 Si la case "Options avancées" n'est pas cochée, aucune contrainte supplémentaire n'est définie.
112 Si la case est cochée, on définira les options avancées.
113
114 Une première série d'options portent sur la finesse maximale de maillage que l'on ne veut pas dépasser. Deux directives sont possibles, séparément ou ensemble. On peut imposer une taille de maille minimale : une maille dont le diamètre est inférieur à cette limite ne sera plus découpée. Par défaut, on propose un diamètre minimal nul, ce qui revient à ne rien imposer. On peut imposer un niveau de raffinement maximal. Par défaut, le maximum est à 99, ce qui équivaut en général à ne rien imposer.
115
116 La deuxième série d'options n'a d'intérêt que dans le cas où l'adaptation est piloté par un champ et que ce champ n'est pas défini partout dans le maillage. Cela arrive par exemple quand on construit un champ basé sur une distance dans un plan alors que le domaine est 3D : le champ ne sera pas défini sur les noeuds hors du plan. Pour de tels champs, cette option permet de préciser le comportement que l'on souhaite dans les régions où le champ n'est pas défini. Par défaut, il ne se passe rien : les mailles sont gardées telles quelles. On peut choisir les deux autres variantes : raffiner, toutes les mailles seront a priori coupées, ou déraffiner, toutes les mailles seront candidates au déraffinement.
117
118 Le dernier choix porte sur une sortie supplémentaire de l'adaptation. Si la case est cochée, le fichier MED en sortie contiendra un champ contenant le niveau de raffinement de chaque maille. La convention est celle de HOMARD : une maille du maillage initial est de niveau 0, une maille issue d'un raffinement d'une maille initiale porte le niveau 1, etc. Les mailles de transition qui sont produites entre deux mailles de niveau différents, n et n+1, sont affectées du demi-niveau n+0,5. Par défaut, la case n'est pas cochée et le champ n'est pas produit.
119
120 .. image:: images/create_hypothese_av_1.png
121    :align: center
122
123 .. index:: single: arbre d'étude
124
125 L'arbre d'étude
126 """""""""""""""
127 .. index:: single: arbre d'étude
128
129 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.
130
131 .. image:: images/create_hypothese_2.png
132    :align: center
133
134
135
136 Méthodes python correspondantes
137 """""""""""""""""""""""""""""""
138 Consulter :ref:`tui_create_hypothese`