Chargement du module HYDRO
==========================
+
Pour activer le module HYDRO, il faut le sélectionner dans la liste défilante des modules
ou cliquer sur son icône dans le bandeau : |Hydro_module_button|.
Import et géoréférencement d'une première image
===============================================
-Pour construire le contour de la rivière, on va importer plusieurs images.
-Ici il s'agit de cartes que l'on peut télécharger à partir de sites comme Géoportail_
+Pour construire le contour de la rivière, nous allons importer plusieurs images.
+Ici il s'agit de cartes que l'on peut télécharger à partir de sites comme `Géoportail`_
ou le site de l'IGN. Géoportail offre la possibilité de trouver les coordonnées de points dans
une image, nécessaires au géoréférencement.
-.. Géoportail_: http://www.geoportail.gouv.fr/accueil
+.. _Géoportail: http://www.geoportail.gouv.fr/accueil
-Pour importer une image, on utilise le menu contextuel de la rubrique *IMAGES* dans l'arbre de
+Pour importer une image, nous utilisons le menu contextuel de la rubrique *IMAGES* dans l'arbre de
l'étude SALOME:
|import_image|
de la souris. Pour se déplacer sur la carte, il faut utiliser la touche <Ctrl> avec le bouton du milieu
de la souris.
-On sélectionne successivement le point A, puis le point B, en utilisant les boutons
+Nous sélectionnons successivement le point A, puis le point B, en utilisant les boutons
*Activate point A selection* puis *Activate point B selection*.
Après avoir sélectionné les deux points, le dialogue de géoréférencement ressemble à ceci :
Pour les coordonnées x,y de chaque point, la première colonne donne les coordonnées du pixel de l'image,
la deuxième colonne donne les coordonnées géographiques.
-On valide le géoréférencement avec le bouton *Apply and Close*.
+Nous validons le géoréférencement avec le bouton *Apply and Close*.
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
à l'aide du bouton *fit all* : |fit_all|.
incomplète en activant le module HYDRO avant de sauvegarder l'étude.
Import d'une deuxième image, géoréférencée à partir la première
-================================================================
+===============================================================
La deuxième image est au même endroit que la première ::
<appli_xxx>/bin/salome/test/HYDRO/garonne_ign_02.png
-Pour la géoréférencer, on utilise l'option *choose points on the reference image* du dialogue.
-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.
-On sélectionne d'abord un point A au même emplacement sur les deux images, puis un point B.
+Pour la géoréférencer, nous utilisons l'option *choose points on the reference image* du dialogue.
+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.
+Nous sélectionnons d'abord un point A au même emplacement sur les deux images, puis un point B.
Il faut prendre deux points les plus éloignés possible, et zoomer suffisamment pour être précis.
Le dialogue ressemble alors à ceci :
|import_image_B|
-Après avoir validé le dialogue, puis affiché les deux images et recentré la vue, on obtient :
+Après avoir validé le dialogue, puis affiché les deux images et recentré la vue, nous obtenons :
|deux_images|
Définition d'un repère local
-===========================================
+============================
Le repère local permet la manipulation de petits nombres. **Le changement de repère améliore
beaucoup la précision des étapes de géométrie, de maillage et de calcul**. Notamment, le fait
de garder des grands nombres peut rendre impossible l'obtention d'un maillage de bonne qualité.
-Dans le menu *HYDRO/Change Local CS*, on saisit les coordonnées de la nouvelle origine.
+Dans le menu *HYDRO/Change Local CS*, nous saisissons les coordonnées de la nouvelle origine.
-Pour notre exemple, on prend pour origine le point (430 000, 6 350 000) situé
+Pour notre exemple, nous prenons pour origine le point (430 000, 6 350 000) situé
au sud ouest de notre domaine d'étude.
-Après avoir validé le changement de repère, on constate que les coordonnées du curseur
+Après avoir validé le changement de repère, nous constatons que les coordonnées du curseur
qui s'affichent dans la barre d'état en bas à gauche de l'application sont fournies dans
les deux repères (local et global).
est connue**.
Dump Python
-=============
+===========
Toutes les opérations effectuées à l'interface graphique ont leur équivalent en script Python.
On peut faire un dump de l'étude dans un script avec le menu *File/Dump Study*.
On pourra vérifier la bonne exécution du dump en repartant d'une étude vierge (redémarrer SALOME,
*new document*, ou seulement *new document*), puis menu *File/Load Script* et activation du module HYDRO.
+
+ :ref:`ref_exempleInondation`