2 Copyright (C) 2015-2016 EDF
4 This file is part of SALOME HYDRO module.
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.
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.
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/>.
19 #########################################
20 Import des images et fonds de plan
21 #########################################
23 .. |Hydro_module_button| image:: /_static/HYDRO.png
28 .. |Hydro_module_launch| image:: /_static/LaunchHYDRO.png
31 .. |import_image| image:: /_static/importImage.png
34 .. |import_image2| image:: /_static/importImage2.png
37 .. |selection_A| image:: /_static/selectionA.png
40 .. |selection_B| image:: /_static/selectionB.png
43 .. |selection_B2| image:: /_static/selectionB2.png
46 .. |fit_all| image:: /_static/fitall.png
49 .. |import_image_B| image:: /_static/importImageB.png
52 .. |deux_images| image:: /_static/deuxImages.png
55 .. |zoom_style| image:: /_static/zoomStyle.png
58 Chargement du module HYDRO
59 ==========================
61 Pour activer le module HYDRO, il faut le sélectionner dans la liste défilante des modules
62 ou cliquer sur son icône dans le bandeau : |Hydro_module_button|.
67 Import et géoréférencement d'une première image
68 ===============================================
70 Pour construire le contour de la rivière, nous allons importer plusieurs images.
71 Ici il s'agit de cartes que l'on peut télécharger à partir de sites comme `Géoportail`_
72 ou le site de l'IGN. Géoportail offre la possibilité de trouver les coordonnées de points dans
73 une image, nécessaires au géoréférencement.
75 .. _Géoportail: http://www.geoportail.gouv.fr/accueil
77 Pour importer une image, nous utilisons le menu contextuel de la rubrique *IMAGES* dans l'arbre de
82 La première image se trouve dans le répertoire d'installation de l'application SALOME HYDRO ::
84 <appli_xxx>/bin/salome/test/HYDRO/garonne_ign_01.png
86 L'image est affichée, avec deux points *A* et *B* qui vont être repositionnés à des emplacements
87 dont on connaît les coordonnées dans le repère Lambert 93, choisis assez éloignés l'un de l'autre
88 pour garder une bonne précision.
92 Voici les deux points particuliers dont on a préalablement repéré les coordonnées avec Géoportail :
94 |selection_A| coordonnées (471562, 6367750): un point en dessous à gauche de la marque *92*.
96 |selection_B| coordonnées (489400, 6377020): le centre de la croix à coté de *Hautevignes*.
98 * **remarque** : Pour contrôler le zoom sur la carte, on utilise la touche <Ctrl> avec le bouton droit
99 de la souris. Pour se déplacer sur la carte, il faut utiliser la touche <Ctrl> avec le bouton du milieu
102 Nous sélectionnons successivement le point A, puis le point B, en utilisant les boutons
103 *Activate point A selection* puis *Activate point B selection*.
104 Après avoir sélectionné les deux points, le dialogue de géoréférencement ressemble à ceci :
108 Pour les coordonnées x,y de chaque point, la première colonne donne les coordonnées du pixel de l'image,
109 la deuxième colonne donne les coordonnées géographiques.
111 Nous validons le géoréférencement avec le bouton *Apply and Close*.
112 Il faut s'assurer que l'icône "oeil" à gauche du nom de l'image dans l'arbre est bien active, et recentrer l'image
113 à l'aide du bouton *fit all* : |fit_all|.
115 L'image obtenue est légèrement inclinée vers la droite.
117 * **remarque** : dans cette vue, le zoom peut se faire à l'aide de la molette de la souris.
118 Le zoom peut être centré sur la position de la souris, ou au centre de l'image. C'est une option accessible dans le menu
119 *File/préférences* sous la rubrique *SALOME*, onglet *3D viewer*, *zooming style* :
123 Quand on promène la souris sur la carte, les coordonnées du curseur s'affichent dans la barre d'état
124 en bas à gauche de l'application.
126 * **remarque** : il faut prendre l'habitude de **sauver l'étude en cours régulièrement**
127 (menu *File/Save* ou *File/Save as*). Il est également conseillé de sauvegarder les différentes
128 étapes de l'étude dans des fichiers différents : *il est arrivé, dans certaines circonstances difficiles
129 à reproduire, que l'étude soit sauvée de manière incomplète.* Les cas où ce problème est survenu
130 correspondent à des rechargements d'études comprenant des données de plusieurs modules, et pour lesquels
131 le module HYDRO n'a pas été activé avant la sauvegarde. On se prémunit contre se risque de sauvegarde
132 incomplète en activant le module HYDRO avant de sauvegarder l'étude.
134 Import d'une deuxième image, géoréférencée à partir la première
135 ===============================================================
137 La deuxième image est au même endroit que la première ::
139 <appli_xxx>/bin/salome/test/HYDRO/garonne_ign_02.png
141 Pour la géoréférencer, nous utilisons l'option *choose points on the reference image* du dialogue.
142 Après avoir sélectionné la première image comme référence, nous voyons les deux images l'une en dessus de l'autre.
143 Nous sélectionnons d'abord un point A au même emplacement sur les deux images, puis un point B.
144 Il faut prendre deux points les plus éloignés possible, et zoomer suffisamment pour être précis.
145 Le dialogue ressemble alors à ceci :
149 Après avoir validé le dialogue, puis affiché les deux images et recentré la vue, nous obtenons :
153 Définition d'un repère local
154 ============================
156 Le repère local permet la manipulation de petits nombres. **Le changement de repère améliore
157 beaucoup la précision des étapes de géométrie, de maillage et de calcul**. Notamment, le fait
158 de garder des grands nombres peut rendre impossible l'obtention d'un maillage de bonne qualité.
160 Dans le menu *HYDRO/Change Local CS*, nous saisissons les coordonnées de la nouvelle origine.
162 Pour notre exemple, nous prenons pour origine le point (430 000, 6 350 000) situé
163 au sud ouest de notre domaine d'étude.
165 Après avoir validé le changement de repère, nous constatons que les coordonnées du curseur
166 qui s'affichent dans la barre d'état en bas à gauche de l'application sont fournies dans
167 les deux repères (local et global).
169 * **remarque** : ce changement de repère peut être fait plusieurs fois, à différents moments
170 de l'étude, car tout ce qui a déjà été importé est transposé par l'application,
171 mais il est préférable de le faire assez tôt pour minimiser les risques d'erreur ou d'incohérence,
172 et, en tous cas, avant d'exporter des éléments du module HYDRO, notamment la géométrie de calcul.
173 **Il est recommandé de fixer le repère local tôt dans l'étude, dès que l'étendue du domaine de calcul
179 Toutes les opérations effectuées à l'interface graphique ont leur équivalent en script Python.
180 On peut faire un dump de l'étude dans un script avec le menu *File/Dump Study*.
181 Le script Python obtenu permet, en partant d'une étude SALOME vierge, de reconstruire les données
182 de l'étude. ce script est, bien sûr, éditable.
184 On peut faire le dump après la définition du repère local, et comparer le fichier obtenu avec ::
186 <appli_xxx>/bin/salome/test/HYDRO/h003_changeLCS.py
188 On pourra vérifier la bonne exécution du dump en repartant d'une étude vierge (redémarrer SALOME,
189 *new document*, ou seulement *new document*), puis menu *File/Load Script* et activation du module HYDRO.
192 :ref:`ref_exempleInondation`