Salome HOME
Merge branch 'BR_H2018_3' into BR_2018_V8_5
[modules/hydro.git] / doc / salome / tutorial / casCalcul.rst
1 ..
2    Copyright (C) 2015-2016 EDF
3
4    This file is part of SALOME HYDRO module.
5
6    SALOME HYDRO module is free software: you can redistribute it and/or modify
7    it under the terms of the GNU General Public License as published by
8    the Free Software Foundation, either version 3 of the License, or
9    (at your option) any later version.
10
11    SALOME HYDRO module is distributed in the hope that it will be useful,
12    but WITHOUT ANY WARRANTY; without even the implied warranty of
13    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
14    GNU General Public License for more details.
15
16    You should have received a copy of the GNU General Public License
17    along with SALOME HYDRO module.  If not, see <http://www.gnu.org/licenses/>.
18
19 #########################################
20 Constitution du cas de calcul
21 #########################################
22
23 .. |createCalculationCase1| image:: /_static/createCalculationCase1.png
24    :align: middle
25
26 .. |createCalculationCase2| image:: /_static/createCalculationCase2.png
27    :align: middle
28
29 .. |createCalculationCase3| image:: /_static/createCalculationCase3.png
30    :align: middle
31
32 .. |createCalculationCase4| image:: /_static/createCalculationCase4.png
33    :align: middle
34
35 .. |createCalculationCase5| image:: /_static/createCalculationCase5.png
36    :align: middle
37
38 .. |createCalculationCase6| image:: /_static/createCalculationCase6.png
39    :align: middle
40
41 .. |createCalculationCase7| image:: /_static/createCalculationCase7.png
42    :align: middle
43
44 .. |createCalculationCase8| image:: /_static/createCalculationCase8.png
45    :align: middle
46
47 .. |createCalculationCase9| image:: /_static/createCalculationCase9.png
48    :align: middle
49
50 .. |createCalculationCase10| image:: /_static/createCalculationCase10.png
51    :align: middle
52
53 Création du cas
54 ===============
55
56 Nous allons créer un *Cas de Calcul*, c'est à dire la configuration des objets que nous allons retenir dans notre étude.
57
58 Nous avons créé 3 ou 4 objets : le lit mineur, le lit majeur, la digue optionnelle et le domaine d'étude.
59
60 Pour créer un *cas de calcul*, nous utilisons le menu contextuel de la rubrique *CALCULATION CASE*.
61
62   |createCalculationCase1|
63
64 Dans le dialogue, nous nommons le cas : *garonne_1*.
65
66 ***Nous choisissons comme limite le domaine**,
67 nous prenons le **mode manuel** (ce mode sera expliqué plus loin),
68 nous sélectionnons les 3 objets naturels présents plus la digue optionnelle, pour les inclure dans le cas.
69
70 Il faut valider cette étape en appuyant sur le bouton *next*.
71
72   |createCalculationCase2|
73
74 Le dialogue propose de sélectionner des groupes à conserver : 
75 il s'agit des contours des différents objets pris en compte dans le cas.
76 Ces groupes peuvent se révéler utiles par la suite pour définir des conditions aux limites, ou contrôler le maillage.
77 Le fait de les conserver permet de les retrouver sous leur nom dans les différentes étapes du calcul.
78
79 Nous sélectionnons les groupes proposés, pour les garder dans le cas.
80
81 Il faut valider cette étape en appuyant sur le bouton *next*.
82
83   |createCalculationCase3|
84
85 Le dialogue suivant permet d'affecter des coefficients de frottement à différentes zones du domaine,
86 à l'aide d'une table de coefficients de Strickler, et d'un découpage en zones `land cover map`.
87 Il faut avoir préalablement importé et/ou édité cette table de Strickler et ce `land cover map`.
88 Pour cet exemple, la `land cover map` est optionnelle. Pour l'introduire, on peut se référer au 
89 paragraphe *Land Cover Map* plus bas.
90
91 Il faut valider cette étape en appuyant sur le bouton *next*.
92
93   |createCalculationCase4|
94
95 Choix du calcul de la Bathymetrie pour les zones de chevauchement
96 =================================================================
97
98 L'étape suivante montre le résultat de la *partition* des différentes zones retenues dans le cas de calcul, sans la digue.
99 Les surfaces initiales ont été découpées selon les lignes de chevauchement.
100
101 Le panneau de droite montre autant de *régions* que de faces découpées : chaque région contient une face découpée ou *zone*.
102
103 Certaines zones sont colorées en rouge : ces zones sont les zones de chevauchement des faces initiales.
104 La liste des objets initiaux apparaît dans la deuxième colonne.
105
106 Pour ces zones, plusieurs définitions de bathymétrie sont possibles. Elles sont listées en troisième colonne.
107 Tant que l'on n'a pas défini quelle règle prendre pour calculer la bathymétrie sur la zone, elle est déclarée *en conflit*.
108
109   |createCalculationCase5|
110
111 Il faut sélectionner successivement chaque zone en conflit, pour choisir le mode de calcul de la bathymétrie
112 pour la zone.
113 La sélection s'opère dans le menu déroulant associé à la zone.
114
115 Les choix possibles sont :
116
117  * une bathymétrie parmi celles proposées
118
119  * le minimum local de l'ensemble des bathymétries listées
120
121  * le maximum local de l'ensemble des bathymétries listées
122
123   |createCalculationCase6|
124
125 Quand la résolution des conflits est terminée, il ne doit plus rester de zone rouge.
126
127 Il est possible de régénérer les couleurs des zones (bouton *regenerate colors*) si nécessaire.
128  
129   |createCalculationCase7|
130
131 Regroupement des zones en régions
132 =================================
133
134 Nous regroupons ensuite plusieurs zones dans des régions. Pourquoi ?
135
136 Une zone correspond à un mode de calcul de la bathymétrie.
137 Le contour de cette zone n'est pas forcément intéressant en tant que *ligne de contrainte* du maillage.
138 Quand on regroupe plusieurs zones contiguës dans une même région, seul le contour de la région sera gardé en
139 tant que *ligne de contrainte* du maillage.
140
141 Nous regroupons donc les deux zones de la rive gauche ensemble, et faisons de même avec les deux zones de la rive Droite,
142 pour obtenir trois régions.
143
144 Pour déplacer une zone, il faut faire un *drag & drop* de cette zone d'une région à une autre.
145
146 Il faut valider cette étape en appuyant sur le bouton *next*.
147
148   |createCalculationCase8|
149
150 Il faut valider cette dernière étape en appuyant sur le bouton *Finish*.
151
152 Le cas est publié dans l'arbre d'étude.Nous sélectionnons chaque région pour lui donner un nom significatif (menu contextuel *Rename*).
153
154 Pour identifier la région, il faut s'aider en examinant les zones qu'elle contient.
155 La vue graphique affiche les zones. En développant l'arbre d'étude au niveau de chaque région, 
156 il est possible de sélectionner les zones pour les mettre en surbrillance.
157
158 En principe, il n'est pas nécessaire de renommer les zones elles mêmes, mais seulement les régions.
159 Ce sont les régions que l'on utilisera par la suite à l'aide de leur nom. Une étude réaliste peut en contenir plusieurs dizaines.
160
161   |createCalculationCase10|
162
163 .. only:: html
164
165   :ref:`ref_exempleInondation`
166