Salome HOME
Merge branch 'master' into BR_quadtree
[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 Nous allons créer un *Cas de Calcul*, c'est à dire la configuration des objets que nous allons retenir dans notre étude.
54
55 Nous avons créé 3 objets : le lit mineur, le lit majeur, et le domaine d'étude.
56
57 Pour créer un *cas de calcul*, nous utilisons le menu contextuel de la rubrique *CALCULATION CASE*.
58
59   |createCalculationCase1|
60
61 Dans le dialogue, nous nommons le cas : *garonne_1*.
62
63 Nous choisissons comme limite le domaine,
64 nous prenons le mode manuel (ce mode sera expliqué plus loin),
65 nous sélectionnons les trois objets présents, pour les inclure dans le cas.
66
67 Il faut valider cette étape en appuyant sur le bouton *next*.
68
69   |createCalculationCase2|
70
71 Le dialogue propose de sélectionner des groupes à conserver : 
72 il s'agit des contours des différents objets pris en compte dans le cas.
73 Ces groupes peuvent se révéler utiles par la suite pour définir des conditions aux limites, ou contrôler le maillage.
74 Le fait de les conserver permet de les retrouver sous leur nom dans les différentes étapes du calcul.
75
76 Nous sélectionnons les trois groupes proposés, pour les garder dans le cas.
77
78 Il faut valider cette étape en appuyant sur le bouton *next*.
79
80   |createCalculationCase3|
81
82 Le dialogue suivant permet d'affecter des coefficients de frottement à différentes zones du domaine,
83 à l'aide d'une table de coefficients de Strickler, et d'un découpage en zones `land cover map`.
84 Il faut avoir préalablement importé et/ou édité cette table de Strickler et ce `land cover map`.
85 Nous sautons cette étape dans le cadre de notre étude simple. Cette étape sera développée plus tard.
86
87 Il faut valider cette étape en appuyant sur le bouton *next*.
88
89   |createCalculationCase4|
90
91 L'étape suivante montre le résultat de la *partition* des différentes zones retenues dans le cas de calcul.
92 Les surfaces initiales ont été découpées selon les lignes de chevauchement.
93
94 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*.
95
96 Certaines zones sont colorées en rouge : ces zones sont les zones de chevauchement des faces initiales.
97 La liste des objets initiaux apparaît dans la deuxième colonne.
98
99 Pour ces zones, plusieurs définitions de bathymétrie sont possibles. Elles sont listées en troisième colonne.
100 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*.
101
102   |createCalculationCase5|
103
104 Il faut sélectionner successsivement chaque zone en conflit, pour choisir le mode de calcul de la bathymétrie
105 pour la zone.
106 La sélection s'opère dans le menu déroulant associé à la zone.
107
108 Les choix possibles sont :
109
110  * une bathymétrie parmi celles proposées
111
112  * le minimum local de l'ensemble des bathymétries listées
113
114  * le maximum local de l'ensemble des bathymétries listées
115
116   |createCalculationCase6|
117
118 Quand la résolution des conflits est terminée, il ne doit plus rester de zone rouge.
119
120 Il est possible de regénérer les couleurs des zones (bouton *regenerate colors*) si nécessaire.
121  
122   |createCalculationCase7|
123
124 Nous regroupons ensuite plusieurs zones dans des régions. Pourquoi ?
125
126 Une zone correspond à un mode de calcul de la bathymétrie.
127 Le contour de cette zone n'est pas forcément intéressant en tant que *ligne de contrainte* du maillage.
128 Quand on regroupe plusieurs zones contiguës dans une même région, seul le contour de la région sera gardé en
129 tant que *ligne de contrainte* du maillage.
130
131 Nous regroupons donc les deux zones de la rive gauche ensemble, et faisons de même avec les deux zones de la rive Droite,
132 pour obtenir trois régions.
133
134 Pour déplacer une zone, il faut faire un *drag & drop* de cette zone d'une région à une autre.
135
136 Il faut valider cette étape en appuyant sur le bouton *next*.
137
138   |createCalculationCase8|
139
140 L'étape suivant concerne le `land cover map`. Nous passons cette étape.
141
142 Il faut valider cette dernière étape en appuyant sur le bouton *apply and close*.
143
144   |createCalculationCase9|
145
146 Le cas est publié dans l'arbre d'étude.Nous sélectionnons chaque région pour lui donner un nom significatif (menu contextuel).
147
148 Pour identifier la région, il faut s'aider en examinant les zones qu'elle contient.
149 La vue graphique affiche les zones. En développant l'arbre d'étude au niveau de chaque région, 
150 il est possible de sélectionner les zones pour les mettre en surbrillance.
151
152 En principe, il n'est pas nécessaire de renommer les zones elles mêmes, mais seulement les régions.
153 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.
154
155   |createCalculationCase10|
156
157
158
159   :ref:`ref_exempleInondation`
160