doc/salome/tutorial/polylignes.rst

   1 ..
   2    Copyright (C) 2015-2016 EDF
   3
   4    This file is part of SALOME HYDRO module.
   5
   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.
  10
  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.
  15
  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/>.
  18
  19 #########################################
  20 Création de polylignes
  21 #########################################
  22
  23 .. |contour_garonne| image:: /_static/contourGaronne.png
  24    :align: middle
  25
  26 .. |contour_lit_majeur| image:: /_static/contourLitMajeur.png
  27    :align: middle
  28
  29 .. |icone_polyligne_xy| image:: /_static/icon_polyline_xy.png
  30    :align: middle
  31
  32 .. |createPolyligneDialogue1| image:: /_static/createPolyligneDialogue1.png
  33    :align: middle
  34
  35 .. |insertNewSection| image:: /_static/insertNewSection.png
  36    :align: middle
  37
  38 .. |createPolyligneDialogue2| image:: /_static/createPolyligneDialogue2.png
  39    :align: middle
  40
  41 .. |addition_mode| image:: /_static/additionMode.png
  42    :align: middle
  43
  44 .. |ajoutPointsPolyligne| image:: /_static/ajoutPointsPolyligne.png
  45    :align: middle
  46
  47 .. |modification_mode| image:: /_static/modificationMode.png
  48    :align: middle
  49
  50 .. |undoPoly| image:: /_static/undoPoly.png
  51    :align: middle
  52
  53 .. |modificationPolyligne2| image:: /_static/modificationPolyligne2.png
  54    :align: middle
  55
  56 Nous allons créer trois lignes en dessinant sur les cartes et la bathymétrie.
  57
  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 :
  60
  61   |contour_garonne|
  62
  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.
  66
  67 * Un contour fermé en lignes brisées qui délimitera notre domaine d'étude.
  68
  69 Le contour du lit majeur et du domaine d'étude :
  70
  71   |contour_lit_majeur|
  72
  73 Dessin des rives du fleuve
  74 ==========================
  75
  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|
  78
  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.
  81 Il est toujours possible de renommer les objets après coup :
  82
  83   |createPolyligneDialogue1|
  84
  85 Les polylignes peuvent comprendre plusieurs sections. Nous n'en utiliserons qu'une seule, il faut la créer :
  86
  87   |insertNewSection|
  88
  89 Dans le dialogue relatif à la section, nous choisissons une ligne de type spline, fermée et cliquons sur le bouton add.
  90
  91   |createPolyligneDialogue2|
  92
  93  * **remarque** : Les polylignes sont de deux types :
  94
  95    * *spline* : une seule ligne continue, a dérivée continue, passant par tous les points.
  96      On privilégie ce type de ligne pour toutes les lignes courbes, les points de définition ne
  97      seront pas repris dans le maillage, ce qui donne une plus grande souplesse sur le contrôle
  98      du raffinement de maillage.
  99
 100    * *polyline* : une seule ligne continue, composée de segments droits. Il faut utiliser
 101      ce type de ligne pour les objets artificiels composés de segments droits, et chaque fois
 102      que l'on a besoin de lignes brisées. Les points sont conservés dans le maillage.
 103
 104 Une fois la section créée, il faut ajouter des points en passant en mode addition :
 105
 106   |addition_mode|
 107
 108 Nous cliquons alors sur la carte, en suivant le contour du fleuve. Il faut commencer à une extrémité
 109 (amont ou aval du domaine). Chaque clic dépose un point, et le contour fermé se dessine progressivement.
 110 Il est possible de'annuler un ou plusieurs des derniers points, avec les boutons undo / redo :
 111
 112   |undoPoly|
 113
 114  * **remarque** : Il est important de choisir ou commence une ligne fermée : le point correspondant est le
 115    seul qui reste imposé dans le maillage. Dans le cas d'un fleuve, autant mettre ce point hors du domaine.
 116
 117   |ajoutPointsPolyligne|
 118
 119 Nous ajoutons des points jusqu'à revenir au point de départ après avoir décrit les deux rives.
 120 Il est inutile de mettre trop de points, sauf à vouloir capturer les détails d'une rive très découpée.
 121 A titre d'exemple, il faut une soixantaine de points pour la portion de fleuve qui nous intéresse.
 122
 123 Quand la saisie est terminée, il faut valider avec *apply and close*.
 124
 125 Si le résultat n'est pas satisfaisant, il est possible de modifier la polyligne en utilisant le menu
 126 contextuel de la polyligne. Dans le dialogue qui s'affiche, il faut sélectionner la section, puis
 127 cliquer sur le mode modification :
 128
 129   |modification_mode|
 130
 131 Il est alors possible de :
 132
 133  * sélectionner un seul point en cliquant dessus,
 134
 135  * sélectionner plusieurs points en les encadrant,
 136
 137  * créer un point intermédiaire en cliquant sur la ligne, entre deux points.
 138
 139 Le ou les points sélectionnés peuvent être déplacés avec un clic-déplacement
 140 (le bouton gauche et maintenu enfoncé sur le déplacement).
 141
 142 Les points restent selectionnés tant qu'il n'y a pas d'autre clic ou sélection.
 143
 144 Le bouton Undo permet d'annuler les dernières modifications.
 145
 146 Les coordonnées des points sélectionnés sont affichées dans le dialogue. Elles sont éditables.
 147
 148   |modificationPolyligne2|
 149
 150 En cours d'édition, on voit deux lignes. La ligne noire, précise, n'est pas recalculée à chaque fois.
 151 La ligne rouge est modifiée à chaque action, elle est moins précise, mais redessinée plus vite
 152 (c'est sensible pour les lignes comprenant un grand nombre de points).
 153
 154 Il est possible de recalculer la ligne sans quitter le dialogue : il faut utiliser le bouton *apply*,
 155 puis, si l'on veut poursuivre les modifications, resélectionner la section avec un double clic,
 156 suivi de *OK* ou *Cancel*
 157
 158  * **Remarque** : On notera qu'il est possible de changer le type *spline* ou *polyline*, la fermeture,
 159    en mode édition, avec un double clic sur la section.
 160
 161 Dessin du contour du lit majeur et du domaine de calcul
 162 =======================================================
 163
 164 Une fois le fleuve dessiné, nous poursuivons avec le dessin du contour de la bathymétrie du lit majeur, garonne_point_L93,
 165 puis la définition du contour du domaine de calcul, qui doit couper les deux autres lignes en amont et en aval.
 166
 167 Il est préférable que le domaine de calcul coupe le fleuve perpendiculairement à son axe, de façon à
 168 définir correctement les conditions limites amont et aval. Il faut aussi éviter de créer des angles aigus en limite
 169 du domaine, ce qui risquerait de favoriser l'apparition de triangles surcontraints lors du maillage (ce qui peut se
 170 corriger par une détection et une inversion de diagonale).
 171
 172   :ref:`ref_exempleInondation`