2 Copyright (C) 2015-2016 EDF
4 This file is part of SALOME HYDRO module.
6 SALOME HYDRO module is free software: you can redistribute it and/or modify
7 it under the terms of the GNU General Public License as published by
8 the Free Software Foundation, either version 3 of the License, or
9 (at your option) any later version.
11 SALOME HYDRO module is distributed in the hope that it will be useful,
12 but WITHOUT ANY WARRANTY; without even the implied warranty of
13 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
14 GNU General Public License for more details.
16 You should have received a copy of the GNU General Public License
17 along with SALOME HYDRO module. If not, see <http://www.gnu.org/licenses/>.
19 #########################################
20 Création, modification de polylignes
21 #########################################
23 .. |contour_garonne| image:: /_static/contourGaronne.png
26 .. |contour_lit_majeur| image:: /_static/contourLitMajeur.png
29 .. |icone_polyligne_xy| image:: /_static/icon_polyline_xy.png
32 .. |createPolyligneDialogue1| image:: /_static/createPolyligneDialogue1.png
35 .. |insertNewSection| image:: /_static/insertNewSection.png
38 .. |createPolyligneDialogue2| image:: /_static/createPolyligneDialogue2.png
41 .. |addition_mode| image:: /_static/additionMode.png
44 .. |ajoutPointsPolyligne| image:: /_static/ajoutPointsPolyligne.png
47 .. |modification_mode| image:: /_static/modificationMode.png
50 .. |undoPoly| image:: /_static/undoPoly.png
53 .. |modificationPolyligne2| image:: /_static/modificationPolyligne2.png
56 Nous allons créer trois lignes en dessinant sur les cartes et la bathymétrie.
58 * Un contour fermé représentant une portion de la Garonne
59 (débordant du domaine d'étude défini plus loin), représenté par la surface bleu foncé ci-dessous :
63 * Un autre contour fermé sur une portion du lit majeur du fleuve
64 (toujours débordant du domaine d'étude en amont et en aval),
65 correspondant au champ de bathymétrie garonne_point_L93.
67 * Un contour fermé en lignes brisées qui délimitera notre domaine d'étude.
69 Le contour du lit majeur et du domaine d'étude :
73 Dessin des rives du fleuve
74 ==========================
76 Pour créer une polyligne, nous utilisons le menu contextuel de la rubrique *POLYLIGNES* dans l'arbre de
77 l'étude SALOME : |icone_polyligne_xy|
79 La première partie du dialogue de création permet de nommer la polyligne.
80 Il est important de donner des noms significatifs aux objets, nous pourrons être amenés à en manipuler un grand nombre.
82 * **remarque** : attention à ne pas utiliser d'espaces ou d'accents pour les noms d'objets : problèmes potentiels
83 à différents niveaux dont les scripts Python.
85 Il est toujours possible de renommer les objets après coup :
87 |createPolyligneDialogue1|
89 Les polylignes peuvent comprendre plusieurs sections. Nous n'en utiliserons qu'une seule, il faut la créer :
93 Dans le dialogue relatif à la section, nous choisissons une ligne de type spline, fermée et cliquons sur le bouton add.
95 |createPolyligneDialogue2|
97 * **remarque** : Les polylignes sont de deux types :
99 * *spline* : une seule ligne continue, a dérivée continue, passant par tous les points.
100 **On privilégie ce type de ligne pour toutes les lignes courbes, les points de définition ne
101 seront pas repris dans le maillage**, ce qui donne une plus grande souplesse sur le contrôle
102 du raffinement de maillage.
104 * *polyline* : une seule ligne continue, composée de segments droits. Il faut utiliser
105 ce type de ligne pour les objets artificiels composés de segments droits, et chaque fois
106 que l'on a besoin de lignes brisées. Les points sont conservés dans le maillage.
108 Une fois la section créée, il faut ajouter des points en passant en mode addition :
112 Nous cliquons alors sur la carte, en suivant le contour du fleuve. **Il faut commencer à une extrémité
113 (amont ou aval du domaine)**. Chaque clic dépose un point, et le contour fermé se dessine progressivement.
114 Il est possible d'annuler un ou plusieurs des derniers points, avec les boutons undo / redo :
118 * **remarque** : **Il est important de choisir ou commence une ligne fermée : le point correspondant est le
119 seul qui reste imposé dans le maillage. Dans le cas d'un fleuve, autant mettre ce point hors du domaine.**
121 |ajoutPointsPolyligne|
123 Nous ajoutons des points jusqu'à revenir au point de départ après avoir décrit les deux rives.
124 Il est inutile de mettre trop de points, sauf à vouloir capturer les détails d'une rive très découpée.
125 A titre d'exemple, il faut une soixantaine de points pour la portion de fleuve qui nous intéresse.
127 Quand la saisie est terminée, il faut valider avec *apply and close*.
129 modification, édition de polyligne
130 ----------------------------------
132 Si le résultat n'est pas satisfaisant, il est possible de modifier la polyligne en utilisant le menu
133 contextuel de la polyligne. Dans le dialogue qui s'affiche, il faut sélectionner la section, puis
134 cliquer sur le mode modification :
138 Il est alors possible de :
140 * sélectionner un seul point en cliquant dessus,
142 * sélectionner plusieurs points en les encadrant,
144 * créer un point intermédiaire en cliquant sur la ligne, entre deux points.
146 Le ou les points sélectionnés peuvent être déplacés avec un clic-déplacement
147 (le bouton gauche et maintenu enfoncé sur le déplacement).
149 Les points restent sélectionnés tant qu'il n'y a pas d'autre clic ou sélection.
151 Le bouton Undo permet d'annuler les dernières modifications.
153 Les coordonnées des points sélectionnés sont affichées dans le dialogue. Elles sont éditables.
155 |modificationPolyligne2|
157 En cours d'édition, on voit deux lignes. La ligne noire, précise, n'est pas recalculée à chaque fois.
158 La ligne rouge est modifiée à chaque action, elle est moins précise, mais redessinée plus vite
159 (c'est sensible pour les lignes comprenant un grand nombre de points).
161 Il est possible de recalculer la ligne sans quitter le dialogue : il faut utiliser le bouton *apply*,
162 puis, si l'on veut poursuivre les modifications, resélectionner la section avec un double clic,
163 suivi de *OK* ou *Cancel*
165 * **Remarque** : On notera qu'il est possible de changer le type *spline* ou *polyline*, la fermeture,
166 en mode édition, avec un double clic sur la section.
168 Dessin du contour du lit majeur et du domaine de calcul
169 =======================================================
171 Une fois le fleuve dessiné, nous poursuivons avec le dessin du contour de la bathymétrie du lit majeur, garonne_point_L93,
172 puis la définition du contour du domaine de calcul, qui doit couper les deux autres lignes en amont et en aval.
174 **Il est préférable que le domaine de calcul coupe le fleuve perpendiculairement à son axe, de façon à
175 définir correctement les conditions limites amont et aval. Il faut aussi éviter de créer des angles aigus en limite
176 du domaine, ce qui risquerait de favoriser l'apparition de triangles surcontraints lors du maillage** (ce qui peut se
177 corriger par une détection et une inversion de diagonale).
181 :ref:`ref_exempleInondation`
