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, modification 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 d'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 modification, édition de polyligne
 126 ----------------------------------
 127
 128 Si le résultat n'est pas satisfaisant, il est possible de modifier la polyligne en utilisant le menu
 129 contextuel de la polyligne. Dans le dialogue qui s'affiche, il faut sélectionner la section, puis
 130 cliquer sur le mode modification :
 131
 132   |modification_mode|
 133
 134 Il est alors possible de :
 135
 136  * sélectionner un seul point en cliquant dessus,
 137
 138  * sélectionner plusieurs points en les encadrant,
 139
 140  * créer un point intermédiaire en cliquant sur la ligne, entre deux points.
 141
 142 Le ou les points sélectionnés peuvent être déplacés avec un clic-déplacement
 143 (le bouton gauche et maintenu enfoncé sur le déplacement).
 144
 145 Les points restent sélectionnés tant qu'il n'y a pas d'autre clic ou sélection.
 146
 147 Le bouton Undo permet d'annuler les dernières modifications.
 148
 149 Les coordonnées des points sélectionnés sont affichées dans le dialogue. Elles sont éditables.
 150
 151   |modificationPolyligne2|
 152
 153 En cours d'édition, on voit deux lignes. La ligne noire, précise, n'est pas recalculée à chaque fois.
 154 La ligne rouge est modifiée à chaque action, elle est moins précise, mais redessinée plus vite
 155 (c'est sensible pour les lignes comprenant un grand nombre de points).
 156
 157 Il est possible de recalculer la ligne sans quitter le dialogue : il faut utiliser le bouton *apply*,
 158 puis, si l'on veut poursuivre les modifications, resélectionner la section avec un double clic,
 159 suivi de *OK* ou *Cancel*
 160
 161  * **Remarque** : On notera qu'il est possible de changer le type *spline* ou *polyline*, la fermeture,
 162    en mode édition, avec un double clic sur la section.
 163
 164 Dessin du contour du lit majeur et du domaine de calcul
 165 =======================================================
 166
 167 Une fois le fleuve dessiné, nous poursuivons avec le dessin du contour de la bathymétrie du lit majeur, garonne_point_L93,
 168 puis la définition du contour du domaine de calcul, qui doit couper les deux autres lignes en amont et en aval.
 169
 170 Il est préférable que le domaine de calcul coupe le fleuve perpendiculairement à son axe, de façon à
 171 définir correctement les conditions limites amont et aval. Il faut aussi éviter de créer des angles aigus en limite
 172 du domaine, ce qui risquerait de favoriser l'apparition de triangles surcontraints lors du maillage (ce qui peut se
 173 corriger par une détection et une inversion de diagonale).
 174
 175 .. only:: html
 176
 177    :ref:`ref_exempleInondation`