Import et géoréférencement d'une première image
===============================================
-Pour construire le contour de la rivière, on va importer plusieurs images.
+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
-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|.
<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|
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).
Il est également possible d'importer des bathymétries contenues dans des fichiers au
format SinusX, qui sera décrit plus loin.
-On va importer deux fichiers pour les besoins de notre étude.
+Nous allons importer deux fichiers pour les besoins de notre étude.
Ils se trouvent dans le répertoire d'installation de l'application SALOME HYDRO ::
<appli_xxx>/bin/salome/test/HYDRO/cloud_02.xyz
<appli_xxx>/bin/salome/test/HYDRO/garonne_point_L93.xyz
-Pour importer ces fichiers, on utilise le menu contextuel de la rubrique *BATHYMETRIES*
+Pour importer ces fichiers, nous utilisons le menu contextuel de la rubrique *BATHYMETRIES*
dans l'arbre de l'étude SALOME. Le dialogue d'import permet de sélectionner le fichier à importer
et de changer son nom dans l'arbre d'étude.
-On valide l'import avec le bouton *Apply and Close*.
+Nous validons l'import avec le bouton *Apply and Close*.
pour afficher la bathymetrie, il faut cliquer sur l'oeil en face de son nom, et recentrer l'image
à l'aide du bouton *fit all*.
du minimum et du maximum de l'ensemble des champs affichés. La légende correspondante est
systématiquement affichée.
-Vous devriez obtenir une vue ressemblant à ceci :
+Nous devrions obtenir une vue ressemblant à ceci :
|import_bathy1|
.. |contour_lit_majeur| image:: /_static/contourLitMajeur.png
:align: middle
-On va créer trois lignes en dessinant sur les cartes et la bathymétrie.
+.. |icone_polyligne_xy| image:: /_static/icon_polyline_xy.png
+ :align: middle
+
+.. |createPolyligneDialogue1| image:: /_static/createPolyligneDialogue1.png
+ :align: middle
+
+.. |insertNewSection| image:: /_static/insertNewSection.png
+ :align: middle
+
+.. |createPolyligneDialogue2| image:: /_static/createPolyligneDialogue2.png
+ :align: middle
+
+.. |addition_mode| image:: /_static/additionMode.png
+ :align: middle
+
+.. |ajoutPointsPolyligne| image:: /_static/ajoutPointsPolyligne.png
+ :align: middle
+
+.. |modification_mode| image:: /_static/modificationMode.png
+ :align: middle
-* Un contour fermé représentant une portion de la Garonne, représenté par la surface bleu foncé ci-dessous :
+.. |undoPoly| image:: /_static/undoPoly.png
+ :align: middle
+
+.. |modificationPolyligne2| image:: /_static/modificationPolyligne2.png
+ :align: middle
+
+Nous allons créer trois lignes en dessinant sur les cartes et la bathymétrie.
+
+* Un contour fermé représentant une portion de la Garonne
+ (débordant du domaine d'étude), représenté par la surface bleu foncé ci-dessous :
|contour_garonne|
-* Un autre contour fermé sur une portion du lit majeur du fleuve, correspondant au champ de bathymétrie garonne_point_L93.
+* Un autre contour fermé sur une portion du lit majeur du fleuve
+ (toujours débordant du domaine d'étude),
+ correspondant au champ de bathymétrie garonne_point_L93.
* Un contour fermé en lignes brisées qui délimitera notre domaine d'étude.
Le contour du lit majeur et du domaine d'étude :
- |contour_lit_majeur|
\ No newline at end of file
+ |contour_lit_majeur|
+
+Dessin des rives du fleuve
+==========================
+
+Pour créer une polyligne, nous utilisons le menu contextuel de la rubrique *POLYLIGNES* dans l'arbre de
+l'étude SALOME : |icone_polyligne_xy|
+
+La première partie du dialogue de création permet de nommer la polyligne.
+Il est important de donner des noms significatifs aux objets, nous pourrons être amenés à en manipuler un grand nombre.
+Il est toujours possible de renommer les objets après coup :
+
+ |createPolyligneDialogue1|
+
+Les polylignes peuvent comprendre plusieurs sections. Nous n'en utiliserons qu'une seule, il faut la créer :
+
+ |insertNewSection|
+
+Dans le dialogue relatif à la section, nous choisissons une ligne de type spline, fermée et cliquons sur le bouton add.
+
+ |createPolyligneDialogue2|
+
+ * **remarque** : Les polylignes sont de deux types :
+
+ * *spline* : une seule ligne continue, a dérivée continue, passant par tous les points.
+ On privilégie ce type de ligne pour toutes les lignes courbes, les points de définition ne
+ seront pas repris dans le maillage, ce qui donne une plus grande souplesse sur le contrôle
+ du raffinement de maillage.
+
+ * *polyline* : une seule ligne continue, composée de segments droits. Il faut utiliser
+ ce type de ligne pour les objets artificiels composés de segments droits, et chaque fois
+ que l'on a besoin de lignes brisées. Les points sont conservés dans le maillage.
+
+Une fois la section créée, il faut ajouter des points en passant en mode addition :
+
+ |addition_mode|
+
+Nous cliquons alors sur la carte, en suivant le contour du fleuve. Il faut commencer à une extrémité
+(amont ou aval du domaine). Chaque clic dépose un point, et le contour fermé se dessine progressivement.
+Il est possible de'annuler un ou plusieurs des derniers points, avec les boutons undo / redo :
+
+ |undoPoly|
+
+ * **remarque** : Il est important de choisir ou commence une ligne fermée : le point correspondant est le
+ seul qui reste imposé dans le maillage. Dans le cas d'un fleuve, autant mettre ce point hors du domaine.
+
+ |ajoutPointsPolyligne|
+
+Nous ajoutons des points jusqu'à revenir au point de départ après avoir décrit les deux rives.
+Il est inutile de mettre trop de points, sauf à vouloir capturer les détails d'une rive très découpée.
+A titre d'exemple, il faut une soixantaine de points pour la portion de fleuve qui nous intéresse.
+
+Quand la saisie est terminée, il faut valider avec *apply and close*.
+
+Si le résultat n'est pas satisfaisant, il est possible de modifier la polyligne en utilisant le menu
+contextuel de la polyligne. Dans le dialogue qui s'affiche, il faut sélectionner la section, puis
+cliquer sur le mode modification :
+
+ |modification_mode|
+
+Il est alors possible de :
+
+ * sélectionner un seul point en cliquant dessus,
+
+ * sélectionner plusieurs points en les encadrant,
+
+ * créer un point intermédiaire en cliquant sur la ligne, entre deux points.
+
+Le ou les points sélectionnés peuvent être déplacés avec un clic-déplacement
+(le bouton gauche et maintenu enfoncé sur le déplacement).
+
+Les points restent selectionnés tant qu'il n'y a pas d'autre clic ou sélection.
+
+Le bouton Undo permet d'annuler les dernières modifications.
+
+Les coordonnées des points sélectionnés sont affichées dans le dialogue. Elles sont éditables.
+
+ |modificationPolyligne2|
+
+En cours d'édition, on voit deux lignes. La ligne noire, précise, n'est pas recalculée à chaque fois.
+La ligne rouge est modifiée à chaque action, elle est moins précise, mais redessinée plus vite
+(c'est sensible pour les lignes comprenant un grand nombre de points).
+
+Il est possible de recalculer la ligne sans quitter le dialogue : il faut utiliser le bouton *apply*,
+puis, si l'on veut poursuivre les modifications, resélectionner la section avec un double clic,
+suivi de *OK* ou *Cancel*
+
+ * **Remarque** : On notera qu'il est possible de changer le type *spline* ou *polyline*, la fermeture,
+ en mode édition, avec un double clic sur la section.
+
+Une fois le fleuve dessiné, nous poursuivons avec le dessin du contour de la bathymétrie du lit majeur, garonne_point_L93,
+puis la définition du contour du domaine de calcul, qui doit couper les deux autres lignes en amont et en aval.
+Il est préférable que le domaine de calcul coupe le fleuve perpendiculairement à son axe, de façon à
+définir correctement les conditions limites amont et aval.
