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 ==========================
60 Pour activer le module HYDRO, il faut le sélectionner dans la liste défilante des modules
61 ou cliquer sur son icône dans le bandeau : |Hydro_module_button|.
66 Import et géoréférencement d'une première image
67 ===============================================
69 Pour construire le contour de la rivière, on va importer plusieurs images.
70 Ici il s'agit de cartes que l'on peut télécharger à partir de sites comme Géoportail_
71 ou le site de l'IGN. Géoportail offre la possibilité de trouver les coordonnées de points dans
72 une image, nécessaires au géoréférencement.
74 .. Géoportail_: http://www.geoportail.gouv.fr/accueil
76 Pour importer une image, on utilise le menu contextuel de la rubrique *IMAGES* dans l'arbre de
81 La première image se trouve dans le répertoire d'installation de l'application SALOME HYDRO ::
83 <appli_xxx>/bin/salome/test/HYDRO/garonne_ign_01.png
85 L'image est affichée, avec deux points *A* et *B* qui vont être repositionnés à des emplacements
86 dont on connaît les coordonnées dans le repère Lambert 93, choisis assez éloignés l'un de l'autre
87 pour garder une bonne précision.
91 Voici les deux points particuliers dont on a préalablement repéré les coordonnées avec Géoportail :
93 |selection_A| coordonnées (471562, 6367750): un point en dessous à gauche de la marque *92*.
95 |selection_B| coordonnées (489400, 6377020): le centre de la croix à coté de *Hautevignes*.
97 * **remarque** : Pour contrôler le zoom sur la carte, on utilise la touche <Ctrl> avec le bouton droit
98 de la souris. Pour se déplacer sur la carte, il faut utiliser la touche <Ctrl> avec le bouton du milieu
101 On sélectionne successivement le point A, puis le point B, en utilisant les boutons
102 *Activate point A selection* puis *Activate point B selection*.
103 Après avoir sélectionné les deux points, le dialogue de géoréférencement ressemble à ceci :
107 Pour les coordonnées x,y de chaque point, la première colonne donne les coordonnées du pixel de l'image,
108 la deuxième colonne donne les coordonnées géographiques.
110 On valide le géoréférencement avec le bouton *Apply and Close*.
111 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
112 à l'aide du bouton *fit all* : |fit_all|.
114 L'image obtenue est légèrement inclinée vers la droite.
116 * **remarque** : dans cette vue, le zoom peut se faire à l'aide de la molette de la souris.
117 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
118 *File/préférences* sous la rubrique *SALOME*, onglet *3D viewer*, *zooming style* :
122 Quand on promène la souris sur la carte, les coordonnées du curseur s'affichent dans la barre d'état
123 en bas à gauche de l'application.
125 * **remarque** : il faut prendre l'habitude de **sauver l'étude en cours régulièrement**
126 (menu *File/Save* ou *File/Save as*). Il est également conseillé de sauvegarder les différentes
127 étapes de l'étude dans des fichiers différents : *il est arrivé, dans certaines circonstances difficiles
128 à reproduire, que l'étude soit sauvée de manière incomplète.* Les cas où ce problème est survenu
129 correspondent à des rechargements d'études comprenant des données de plusieurs modules, et pour lesquels
130 le module HYDRO n'a pas été activé avant la sauvegarde. On se prémunit contre se risque de sauvegarde
131 incomplète en activant le module HYDRO avant de sauvegarder l'étude.
133 Import d'une deuxième image, géoréférencée à partir la première
134 ================================================================
136 La deuxième image est au même endroit que la première ::
138 <appli_xxx>/bin/salome/test/HYDRO/garonne_ign_02.png
140 Pour la géoréférencer, on utilise l'option *choose points on the reference image* du dialogue.
141 Après avoir sélectionné la première image comme référence, on voit les deux images l'une en dessus de l'autre.
142 On sélectionne d'abord un point A au même emplacement sur les deux images, puis un point B.
143 Il faut prendre deux points les plus éloignés possible, et zoomer suffisamment pour être précis.
144 Le dialogue ressemble alors à ceci :
148 Après avoir validé le dialogue, puis affiché les deux images et recentré la vue, on obtient :
152 Définition d'un repère local
153 ===========================================
155 Le repère local permet la manipulation de petits nombres. **Le changement de repère améliore
156 beaucoup la précision des étapes de géométrie, de maillage et de calcul**. Notamment, le fait
157 de garder des grands nombres peut rendre impossible l'obtention d'un maillage de bonne qualité.
159 Dans le menu *HYDRO/Change Local CS*, on saisit les coordonnées de la nouvelle origine.
161 Pour notre exemple, on prend pour origine le point (430 000, 6 350 000) situé
162 au sud ouest de notre domaine d'étude.
164 Après avoir validé le changement de repère, on constate que les coordonnées du curseur
165 qui s'affichent dans la barre d'état en bas à gauche de l'application sont fournies dans
166 les deux repères (local et global).
168 * **remarque** : ce changement de repère peut être fait plusieurs fois, à différents moments
169 de l'étude, car tout ce qui a déjà été importé est transposé par l'application,
170 mais il est préférable de le faire assez tôt pour minimiser les risques d'erreur ou d'incohérence,
171 et, en tous cas, avant d'exporter des éléments du module HYDRO, notamment la géométrie de calcul.
172 **Il est recommandé de fixer le repère local tôt dans l'étude, dès que l'étendue du domaine de calcul
178 Toutes les opérations effectuées à l'interface graphique ont leur équivalent en script Python.
179 On peut faire un dump de l'étude dans un script avec le menu *File/Dump Study*.
180 Le script Python obtenu permet, en partant d'une étude SALOME vierge, de reconstruire les données
181 de l'étude. ce script est, bien sûr, éditable.
183 On peut faire le dump après la définition du repère local, et comparer le fichier obtenu avec ::
185 <appli_xxx>/bin/salome/test/HYDRO/h003_changeLCS.py
187 On pourra vérifier la bonne exécution du dump en repartant d'une étude vierge (redémarrer SALOME,
188 *new document*, ou seulement *new document*), puis menu *File/Load Script* et activation du module HYDRO.
