Salome HOME
Merge branch 'master' into BR_quadtree
[modules/hydro.git] / doc / salome / tutorial / polylignes.rst
index 446e5e356e71fa7e7472346035918a4968f17ea4..26fd824f9bf8c62b7f4f42d3392a2506189875ae 100644 (file)
@@ -26,16 +26,144 @@ Création de polylignes
 .. |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 défini plus loin), 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 en amont et en aval),
+  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.  
+
+Dessin du contour du lit majeur et du domaine de calcul
+=======================================================
+
+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. 
+ 
+  :ref:`ref_exempleInondation`