Chargement du module HYDRO
==========================
-Pour actver le module HYDRO, il faut le selectionner dans la liste défilante des modules
-ou cliquer sur son icone dans le bandeau : |Hydro_module_button|.
+
+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|.
|Hydro_module_launch|
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 *IMGAGES* 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|
<appli_xxx>/bin/salome/test/HYDRO/garonne_ign_01.png
L'image est affichée, avec deux points *A* et *B* qui vont être repositionnés à des emplacements
-dont on connait la position dans le repère Lambert 93, choisis assez éloignés l'un de l'autre
+dont on connaît les coordonnées dans le repère Lambert 93, choisis assez éloignés l'un de l'autre
pour garder une bonne précision.
|import_image2|
-Voici les deux points particuliers dont on a prélablement repéré les coordonnées avec Géoportail :
+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*.
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 :
|selection_B2|
Pour les coordonnées x,y de chaque point, la première colonne donne les coordonnées du pixel de l'image,
-lacdeuxième colonne donne les coordonnées géographiques.
+la deuxième colonne donne les coordonnées géographiques.
-On valide le géoréférencement avec le bouton *Apply and Close*.
-Il faut s'assurer que l'oeil à gauche du nom de l'image dans l'arbre est bien actif, et recentrer l'image
+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|.
L'image obtenue est légèrement inclinée vers la droite.
* **remarque** : dans cette vue, le zoom peut se faire à l'aide de la molette de la souris.
- Le zoom peut être centré sur la position de la souris. C'est une option accessible dans le menu
+ 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
*File/préférences* sous la rubrique *SALOME*, onglet *3D viewer*, *zooming style* :
|zoom_style|
Quand on promène la souris sur la carte, les coordonnées du curseur s'affichent dans la barre d'état
en bas à gauche de l'application.
- * **remarque** : il faut prendre l'habitude de sauver l'étude en cours régulièrement
+ * **remarque** : il faut prendre l'habitude de **sauver l'étude en cours régulièrement**
(menu *File/Save* ou *File/Save as*). Il est également conseillé de sauvegarder les différentes
étapes de l'étude dans des fichiers différents : *il est arrivé, dans certaines circonstances difficiles
à reproduire, que l'étude soit sauvée de manière incomplète.* Les cas où ce problème est survenu
le module HYDRO n'a pas été activé avant la sauvegarde. On se prémunit contre se risque de sauvegarde
incomplète en activant le module HYDRO avant de sauvegarder l'étude.
-Import d'une deuxième image, géorférérencée à partir la première
-================================================================
+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 selectionne 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`
