Salome HOME
Merge branch 'BR_2018_V8_5' into BR_PY3
[modules/hydro.git] / doc / salome / tutorial / depouillementCalcul.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 Dépouillement du calcul TELEMAC
21 #########################################
22
23
24 .. |paravisDansSalome| image:: /_static/paravisDansSalome.png
25    :align: middle
26
27 .. |hydraulicsFilters| image:: /_static/hydraulicsFilters.png
28    :align: middle
29
30 .. |paravis02| image:: /_static/paravis02.png
31    :align: middle
32
33 .. |paravis03| image:: /_static/paravis03.png
34    :align: middle
35
36 .. |paravis04| image:: /_static/paravis04.png
37    :align: middle
38
39 .. |paravis05| image:: /_static/paravis05.png
40    :align: middle
41
42 .. |paravis06| image:: /_static/paravis06.png
43    :align: middle
44
45 .. |paravis07a| image:: /_static/paravis07a.png
46    :align: middle
47
48 .. |paravis07| image:: /_static/paravis07.png
49    :align: middle
50
51 .. |paravis08| image:: /_static/paravis08.png
52    :align: middle
53
54 .. |paravis08| image:: /_static/paravis08.png
55    :align: middle
56
57 .. |paravis09| image:: /_static/paravis09.png
58    :align: middle
59
60 .. |paravis10| image:: /_static/paravis10.png
61    :align: middle
62
63 .. |paravis11| image:: /_static/paravis11.png
64    :align: middle
65
66 .. |paravis12| image:: /_static/paravis12.png
67    :align: middle
68
69 .. |paravis13| image:: /_static/paravis13.png
70    :align: middle
71
72 .. |paravis14| image:: /_static/paravis14.png
73    :align: middle
74
75 .. |paravis15| image:: /_static/paravis15.png
76    :align: middle
77
78 .. |paravis16| image:: /_static/paravis16.png
79    :align: middle
80
81 .. |paravis17| image:: /_static/paravis17.png
82    :align: middle
83
84 .. |paravis18| image:: /_static/paravis18.png
85    :align: middle
86
87 .. |paravis19| image:: /_static/paravis19.png
88    :align: middle
89
90 .. |paravis20| image:: /_static/paravis20.png
91    :align: middle
92
93 .. |paravis21| image:: /_static/paravis21.png
94    :align: middle
95
96 .. |paravis22| image:: /_static/paravis22.png
97    :align: middle
98
99 .. |paravis24| image:: /_static/paravis24.png
100    :align: middle
101
102 .. |paravis25| image:: /_static/paravis25.png
103    :align: middle
104
105 .. |paravis26| image:: /_static/paravis26.png
106    :align: middle
107
108 .. |paravis27| image:: /_static/paravis27.png
109    :align: middle
110
111 Paravis correspond à l'adaptation du produit open source Paraview à SALOME.
112
113 Paravis peut être utilisé de de façons. Soit comme module depuis l'interface graphique de SALOME,
114
115   |paravisDansSalome|
116
117 soit en tant qu'outil autonome.
118
119
120 Lancement de Paraview en mode autonome
121 ======================================
122
123 Installer la dernière version de SALOME. Sur l'intranet EDF : ::
124
125   ftp://ftp.pleiade.edf.fr/projets/salome/Releases/
126
127 Une fois SALOME installé, 2 dossiers sont créés : 
128
129 * appli_xxx
130 * Salome_xxx
131
132 Lancer Paraview par le salome shell de SALOME.
133
134 La commande est : ::
135
136   <chemin appli_xxx>/salome shell paraview
137   
138 Exemple ::
139
140   ~/salome-hydro/SALOME_DEV/14-10-2018/appli_DEV/salome shell paraview
141
142 Paraview s’ouvre.
143
144 Filtres utiles pour l'hydraulique
145 =================================
146
147 Charger un fichier résultat : *File / Open*.
148
149 Cliquer sur *Apply*.
150
151 Aller dans *Filters / Hydraulics*. C’est là que sont répertoriés les filtres dédiés à l’hydraulique tels que :
152
153 * Profil spatial
154 * Profil temporel
155 * Calcul de débit à travers une section
156 * Calcul de sédiments érodés / déposés dans une zone
157 * Evolution temporelle d’une variable dans une colonne d’eau (en un x et y fixé, 
158   évolution d’une variable comme la température, par exemple, en fonction du temps
159   en abscisse et de la profondeur en ordonnées)
160   
161  |hydraulicsFilters|
162  
163 Filtre Temporal on Point
164 ------------------------
165
166 Charger un fichier résultat.
167
168 Sélectionner le filtre Temporal On Point.
169
170 Pour l’instant, se placer en 3D. Il existe un bug pour déplacer la croix si on reste en 2D.
171
172   |paravis02|
173   
174 Déplacer la croix blanche à l’endroit souhaité. La croix blanche est située initialement au centre de la boîte encadrant le modèle.
175
176   |paravis03|
177
178 Cliquer sur *Apply*.
179
180 Sélectionner la variable à afficher, par exemple Free surface.
181
182   |paravis04|
183
184 * **Astuce :** La croix blanche a disparu à ce moment sur la fenêtre de gauche RenderView.
185   Pour la faire réapparaître, se placer sur la fenêtre RenderView montrant le fichier résultat.
186
187 Filtre Spatial Profile
188 ----------------------
189
190 Charger un fichier résultat.
191
192 Lancer le filtre Spatial Profile : une ligne jaune apparaît, diagonale de la boîte encadrant le modèle.
193
194   |paravis05|
195
196 Déplacer les 2 extrémités de cette ligne à l’endroit où l’on souhaite commencer la polyligne.
197
198   |paravis06|
199
200 Adapter l’échelle de couleur si besoin : pour cela se placer sur le fichier résultat et cliquer sur :
201
202   |paravis07a|
203   
204   |paravis07|
205
206 Se replacer sur le filtre SpatialProfile1.
207
208   |paravis08|
209
210 Utiliser les commandes de l’encadré rouge : 
211 on conseille d’utiliser la dernière commande *Alt + Left click* pour ajouter des points à la fin de la polyligne.
212
213   |paravis09|
214
215   |paravis10|
216
217 Et ainsi de suite jusqu’à l’obtention de la ligne souhaitée.
218
219 Cliquer sur *Apply*.
220
221 Sélectionner la variable souhaitée, par exemple *Curv Abscissa*.
222
223   |paravis11|
224
225 * **Astuce :** La polyligne a disparu à ce moment sur la fenêtre de gauche RenderView.
226   Pour la faire réapparaître, se placer sur la fenêtre RenderView montrant le fichier résultat.
227
228   |paravis12|
229
230 * **Remarque importante :**
231
232   Au 16-11-2018, il existe un bug sur l’interpolation le long de cette polyligne.
233   Le tracé de la polyligne fonctionne bien mais les points rajoutés ne sont pas pris en compte dans l’interpolation. 
234
235 Filtre Spatial Profile On Points
236 --------------------------------
237
238 Charger un fichier résultat. 
239
240 Cliquer sur *Apply*.
241
242 Charger une polyligne déjà créée. Cette polyligne peut avoir 2 formats : shape ou sinusx.
243 (créée dans Qgis par exemple au format shape).
244
245 Cliquer sur *Apply*.
246
247 Si la polyligne est déjà dans le même référentiel local que le modèle, elle s’affiche automatiquement.
248
249   |paravis13|
250
251 Penser aux possibles translations qui ont pu être effectuées lors de la construction du modèle.
252 Si la polyligne est construite dans Qgis sur fond de carte, elle sera dans le référentiel global.
253 Il va donc falloir la translater dans Paraview. 
254
255 Pour cela une fois la polyligne chargée, sélectionner le filtre *Transform* et renseigner
256 la translation dans l’encadré rouge.
257 Une boîte s’affiche, on peut la faire disparaître en décochant *Show box* (dans l’encadré rouge).
258
259   |paravis14|
260
261 Lancer le filtre Spatial *Profil On Points*.
262
263 Une fenêtre s’ouvre : 
264
265 * Renseigner dans un premier temps l’input : il s’agit du fichier résultat. 
266 * Renseigner dans un deuxième temps la source : il s’agit de la polyligne chargée (ou de sa translation s’il y a lieu).
267
268   |paravis15| |paravis16|
269
270 Cliquer sur *OK*.
271
272 Cliquer sur *Apply*.
273
274 Sélectionner la variable que l’on souhaite visualiser, exemple ci-dessous la surface libre.
275
276   |paravis17|
277
278 * **Remarque :** Un point important est de choisir le nombre de subdivisions de la polyligne (chiffre variant entre 1 et 100).
279   La valeur conseillée est 50. La courbe traçant la variable sera alors plus précise, plus détaillée. 
280   
281   Pour cela, sélectionner la polyligne dans *Pipeline Browser*.
282   
283   Changer le nombre de subdivisions : ici on passe de 1 à 50.
284
285   |paravis18|
286
287 Cliquer sur *Apply*.
288
289   |paravis19|
290
291 L’interpolation est plus précise.
292
293 Filtre Rate Of Flow Through Section
294 -----------------------------------
295
296 Charger un fichier résultat.
297
298 Cliquer sur *Apply*.
299
300 Charger un fichier polyligne décrivant une section (à travers laquelle on souhaite connaître le débit transitant).
301 Cette polyligne peut avoir 2 formats : shape ou sinusx. 
302
303 Cliquer sur *Apply*.
304
305 Lancer le filtre *Rate Of Flow Through Section*.
306
307 Une fenêtre s’ouvre : 
308
309 * Renseigner dans un premier temps l’input : il s’agit du fichier résultat. 
310 * Renseigner dans un deuxième temps la source : il s’agit de la polyligne chargée décrivant
311   la section à travers laquelle on souhaite connaître le débit transitant.
312
313   |paravis20| |paravis21|
314
315 Cliquer sur *OK*.
316
317 Cliquer sur *Apply*.
318
319   |paravis22|
320
321 * **Remarque :** Dans ce cas aussi, on peut changer le nombre de subdivisions de la polyligne chargée.
322   Le résultat change en fonction du nombre de subdivisions. Le probleme est est en cours de traitement par l'équipe de Paraview.
323
324   Dans notre cas, en fonction du nombre de subdivisions (1, 50 ou 100), le débit change :
325   
326 *  1 => 1487 m3/s – 1428 m3/s
327 *  50 => 1603 m3/s – 1531 m3/s 
328 *  100 => 1592 m3/s – 1525 m3/s
329
330 Filtre Sediment Deposit
331 -----------------------
332
333 Charger un fichier résultat.
334
335 Cliquer sur *Apply*
336
337 Charger un fichier contour (polygone au niveau duquel on souhaite connaître les évolutions du fond (érosion / dépôt)).
338 Ce polygone est au format shape. 
339
340 Cliquer sur *Apply*.
341
342 Lancer le filtre *Sediment Deposit*.
343
344 Une fenêtre s’ouvre : 
345
346 * Renseigner dans un premier temps l’input : il s’agit du fichier résultat. 
347 * Renseigner dans un deuxième temps la source : il s’agit du polygone chargé décrivant le contour au niveau
348   duquel on souhaite connaître les évolutions du fond.
349
350   |paravis24| |paravis25|
351
352 Cliquer sur *OK*.
353
354 Cliquer sur *Apply*.
355
356   |paravis26|
357   
358 On a alors 3 courbes tracées que l’on peut sélectionner comme on le souhaite :
359
360   |paravis27|
361
362 * Négatif = érosion
363 * Positif = Dépôt
364 * Total = Somme des deux
365
366 Filtre Depth Vs Time On Point
367 -----------------------------
368
369 Description à venir.
370
371
372 .. only:: html
373
374    :ref:`ref_exempleInondation`