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 (clic droit) de la rubrique *IMAGES* dans l'arbre de
l'étude SALOME:
|import_image|
Voici les deux points particuliers dont on a préalablement repéré les coordonnées avec Géoportail :
- |selection_A| coordonnées (471562, 6367750): un point en dessous à gauche de la marque *92*.
+ |selection_A|
+
+coordonnées (471562, 6367750): un point en dessous à gauche de la marque *92*.
- |selection_B| coordonnées (489400, 6377020): le centre de la croix à coté de *Hautevignes*.
+ |selection_B|
- * **remarque** : Pour contrôler le zoom sur la carte, on utilise la touche <Ctrl> avec le bouton droit
+coordonnées (489400, 6377020): le centre de la croix à coté de *Hautevignes*.
+
+ * **remarque** : Pour contrôler le zoom sur la carte, on utilise la touche <Ctrl> avec le bouton gauche
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).
et, en tous cas, avant d'exporter des éléments du module HYDRO, notamment la géométrie de calcul.
**Il est recommandé de fixer le repère local tôt dans l'étude, dès que l'étendue du domaine de calcul
est connue**.
+
+ * Après un changement de repère local, if faut mettre à jour les données de l'arbre qui apparaissent en bleu italique
+ avec le menu contextuel *update*, puis recentrer la vue avec la commande *Fit All*.
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.
+.. only:: html
+
+ :ref:`ref_exempleInondation`