From: Paul RASCLE Date: Wed, 11 Nov 2015 22:19:47 +0000 (+0100) Subject: tutoriel polylignes X-Git-Tag: BR_quadtree_20151126~2 X-Git-Url: http://git.salome-platform.org/gitweb/?a=commitdiff_plain;h=431f25196a3eb44a3dce0dbc2e5ace9a84b2cf0e;p=modules%2Fhydro.git tutoriel polylignes --- diff --git a/doc/salome/tutorial/_static/additionMode.png b/doc/salome/tutorial/_static/additionMode.png new file mode 100644 index 00000000..c3fcd434 Binary files /dev/null and b/doc/salome/tutorial/_static/additionMode.png differ diff --git a/doc/salome/tutorial/_static/ajoutPointsPolyligne.png b/doc/salome/tutorial/_static/ajoutPointsPolyligne.png new file mode 100644 index 00000000..7e63c2b1 Binary files /dev/null and b/doc/salome/tutorial/_static/ajoutPointsPolyligne.png differ diff --git a/doc/salome/tutorial/_static/createPolyligneDialogue1.png b/doc/salome/tutorial/_static/createPolyligneDialogue1.png new file mode 100644 index 00000000..b02a3f48 Binary files /dev/null and b/doc/salome/tutorial/_static/createPolyligneDialogue1.png differ diff --git a/doc/salome/tutorial/_static/createPolyligneDialogue2.png b/doc/salome/tutorial/_static/createPolyligneDialogue2.png new file mode 100644 index 00000000..ec155a92 Binary files /dev/null and b/doc/salome/tutorial/_static/createPolyligneDialogue2.png differ diff --git a/doc/salome/tutorial/_static/icon_polyline_xy.png b/doc/salome/tutorial/_static/icon_polyline_xy.png new file mode 100644 index 00000000..e33487d9 Binary files /dev/null and b/doc/salome/tutorial/_static/icon_polyline_xy.png differ diff --git a/doc/salome/tutorial/_static/insertNewSection.png b/doc/salome/tutorial/_static/insertNewSection.png new file mode 100644 index 00000000..a604b94b Binary files /dev/null and b/doc/salome/tutorial/_static/insertNewSection.png differ diff --git a/doc/salome/tutorial/_static/modificationMode.png b/doc/salome/tutorial/_static/modificationMode.png new file mode 100644 index 00000000..858fb724 Binary files /dev/null and b/doc/salome/tutorial/_static/modificationMode.png differ diff --git a/doc/salome/tutorial/_static/modificationPolyligne2.png b/doc/salome/tutorial/_static/modificationPolyligne2.png new file mode 100644 index 00000000..276d7900 Binary files /dev/null and b/doc/salome/tutorial/_static/modificationPolyligne2.png differ diff --git a/doc/salome/tutorial/_static/undoPoly.png b/doc/salome/tutorial/_static/undoPoly.png new file mode 100644 index 00000000..0da3851a Binary files /dev/null and b/doc/salome/tutorial/_static/undoPoly.png differ diff --git a/doc/salome/tutorial/import.rst b/doc/salome/tutorial/import.rst index 12b658aa..40d6a984 100644 --- a/doc/salome/tutorial/import.rst +++ b/doc/salome/tutorial/import.rst @@ -66,14 +66,14 @@ ou cliquer sur son icône dans le bandeau : |Hydro_module_button|. 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| @@ -98,7 +98,7 @@ Voici les deux points particuliers dont on a préalablement repéré les coordon de la souris. Pour se déplacer sur la carte, il faut utiliser la touche 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 : @@ -107,7 +107,7 @@ Après avoir sélectionné les deux points, le dialogue de géoréférencement r 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|. @@ -137,15 +137,15 @@ La deuxième image est au même endroit que la première :: /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| @@ -156,12 +156,12 @@ Le repère local permet la manipulation de petits nombres. **Le changement de re 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). diff --git a/doc/salome/tutorial/importBathy.rst b/doc/salome/tutorial/importBathy.rst index 24f10654..a1ec89bb 100644 --- a/doc/salome/tutorial/importBathy.rst +++ b/doc/salome/tutorial/importBathy.rst @@ -32,17 +32,17 @@ du coin sud ouest, le pas en x et en y, on trouve la matrice des altitudes z. 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 :: /bin/salome/test/HYDRO/cloud_02.xyz /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*. @@ -51,6 +51,6 @@ Les points sont colorés selon leur altitudes, et les plages de couleurs sont aj 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| diff --git a/doc/salome/tutorial/polylignes.rst b/doc/salome/tutorial/polylignes.rst index 446e5e35..f4fc8601 100644 --- a/doc/salome/tutorial/polylignes.rst +++ b/doc/salome/tutorial/polylignes.rst @@ -26,16 +26,139 @@ 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), 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.