]> SALOME platform Git repositories - modules/hydro.git/commitdiff
Salome HOME
restructuration tutoriel
authorPaul RASCLE <paul.rascle@edf.fr>
Tue, 1 Dec 2015 15:39:12 +0000 (16:39 +0100)
committerPaul RASCLE <paul.rascle@edf.fr>
Tue, 1 Dec 2015 15:39:12 +0000 (16:39 +0100)
18 files changed:
doc/salome/tutorial/casCalcul.rst
doc/salome/tutorial/depouillementCalcul.rst
doc/salome/tutorial/donneesPrealables.rst [new file with mode: 0644]
doc/salome/tutorial/geometrie.rst
doc/salome/tutorial/import.rst
doc/salome/tutorial/importBathy.rst
doc/salome/tutorial/index.rst
doc/salome/tutorial/installationLancementSalome.rst [new file with mode: 0644]
doc/salome/tutorial/interpolationZ.rst
doc/salome/tutorial/lancementCalcul.rst
doc/salome/tutorial/maillage.rst
doc/salome/tutorial/miseEnDonneesTelemac.rst
doc/salome/tutorial/objetsArtificiels.rst
doc/salome/tutorial/objetsNaturels.rst
doc/salome/tutorial/piegesAEviter.rst [new file with mode: 0644]
doc/salome/tutorial/polylignes.rst
doc/salome/tutorial/preliminaires.rst
doc/salome/tutorial/streams.rst

index ca8156f225eee8ae889c6a9807e31e43efe12830..042da2e0c2a4324887552d64a5f27ac046155308 100644 (file)
@@ -84,4 +84,6 @@ Il faut valider cette étape en appuyant sur le bouton *next*.
   |createCalculationCase10|
 
 
+ 
+  :ref:`ref_exempleInondation`
 
index 541b61c3e5be4a0831f3194555bf0c02b266fd45..107249fb0c3f8531d6c7e7276c4d943d9719b60f 100644 (file)
@@ -20,4 +20,7 @@
 Dépouillement du calcul TELEMAC
 #########################################
 
-blabla.
\ No newline at end of file
+blabla.
+
+ 
+  :ref:`ref_exempleInondation`
diff --git a/doc/salome/tutorial/donneesPrealables.rst b/doc/salome/tutorial/donneesPrealables.rst
new file mode 100644 (file)
index 0000000..acedac9
--- /dev/null
@@ -0,0 +1,46 @@
+..
+   Copyright (C) 2015-2016 EDF
+
+   This file is part of SALOME HYDRO module.
+
+   SALOME HYDRO module is free software: you can redistribute it and/or modify
+   it under the terms of the GNU General Public License as published by
+   the Free Software Foundation, either version 3 of the License, or
+   (at your option) any later version.
+
+   SALOME HYDRO module is distributed in the hope that it will be useful,
+   but WITHOUT ANY WARRANTY; without even the implied warranty of
+   MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+   GNU General Public License for more details.
+
+   You should have received a copy of the GNU General Public License
+   along with SALOME HYDRO module.  If not, see <http://www.gnu.org/licenses/>.
+
+####################################
+données préalables
+####################################
+
+* Pour les fichiers image : disposer de fichiers images des fonds carto ou photo et avoir repéré dans le système de travail 
+  (les coordonnées de 2 ou 3 points) bien répartis sur l’image (proches des coins de préférences)
+  Il est préférable d’avoir au moins trois points pour une meilleure précision du géo référencement. 
+* Disposer des données de bathy au format ascii  (3 colonnes x,y,z). Pour l’instant ces fichiers doivent porter l’extension .xyz ou .asc
+
+* Changement de repère et grandes coordonnées. Il est vivement conseillé de changer l’origine du système de coordonnées local 
+  pour éviter de manipuler de très grands nombres et  avoir plus de précisions dans les différents calculs notamment pour le maillage. 
+  Pour cela il faut :
+  Clic sur Hydro/change local CS
+  Renseigner les coordonnées de la nouvelle origine
+
+QGIS et CLOUDCOMPARE
+====================
+
+Visualisation et pré-traitement des données avec Qgis et/ou CloudCompare. 
+Il est à l’étude actuellement de pouvoir à terme transférer des données type shapefile depuis Qgis vers Salomé. 
+Les imports de Shapefiles et de données de lignes dans un format ASCII (SinusX) n’étaient pas encore disponibles au moment de la réalisation de la présente étude. 
+Je crois que ça l’est maintenant, le seul problème est que les Shapefiles de QGIS sont des polygones et non pas des splines ???? 
+CloudCompare a déjà subi de nombreuses évolutions dans une optique de compatibilité avec les formats et outils associés au logiciel Telemac 
+ainsi que pour répondre au besoin des études hydrauliques du LNHE. Il est aujourd’hui possible avec CloudCompare de blabla.
+
+ 
+  :ref:`ref_notionsPrealables`
index e6dfabf50d944b8abd4cb188f63220eab4566827..1901cc0372c63d18dc427e8219a7bbad06c10f96 100644 (file)
@@ -20,4 +20,7 @@
 Etape géometrique
 #########################################
 
-blabla.
\ No newline at end of file
+blabla.
+
+ 
+  :ref:`ref_exempleInondation`
index 40d6a98423ccb7d02f8bf03ade2e088a6c0bb7a1..dabc437f7fa1a35f20bb100d0047dd41210794ad 100644 (file)
@@ -57,6 +57,7 @@ Import des images et fonds de plan
 
 Chargement du module HYDRO
 ==========================
+
 Pour activer le module HYDRO, il faut le sélectionner dans la liste défilante des modules 
 ou cliquer sur son icône dans le bandeau : |Hydro_module_button|.
 
@@ -67,11 +68,11 @@ Import et géoréférencement d'une première image
 ===============================================
 
 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
+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
+.. _Géoportail: http://www.geoportail.gouv.fr/accueil
 
 Pour importer une image, nous utilisons le menu contextuel de la rubrique *IMAGES* dans l'arbre de
 l'étude SALOME: 
@@ -131,7 +132,7 @@ en bas à gauche de l'application.
    incomplète en activant le module HYDRO avant de sauvegarder l'étude. 
 
 Import d'une deuxième image, géoréférencée à partir la première
-================================================================
+===============================================================
 
 La deuxième image est au même endroit que la première ::
 
@@ -150,7 +151,7 @@ Après avoir validé le dialogue, puis affiché les deux images et recentré la
   |deux_images|
 
 Définition d'un repère local
-===========================================
+============================
 
 Le repère local permet la manipulation de petits nombres. **Le changement de repère améliore
 beaucoup la précision des étapes de géométrie, de maillage et de calcul**. Notamment, le fait 
@@ -173,7 +174,7 @@ les deux repères (local et global).
     est connue**.
 
 Dump Python
-=============
+===========
 
 Toutes les opérations effectuées à l'interface graphique ont leur équivalent en script Python.
 On peut faire un dump de l'étude dans un script avec le menu *File/Dump Study*.
@@ -187,3 +188,5 @@ On peut faire le dump après la définition du repère local, et comparer le fic
 On pourra vérifier la bonne exécution du dump en repartant d'une étude vierge (redémarrer SALOME,
 *new document*, ou seulement *new document*), puis menu *File/Load Script* et activation du module HYDRO.
 
+ 
+  :ref:`ref_exempleInondation`
index 5a3569c79dfd34394d8462c5e6a008ec6725c900..a90764f639984ad89d7fd76c379d7b08f2f622a8 100644 (file)
@@ -16,9 +16,9 @@
    You should have received a copy of the GNU General Public License
    along with SALOME HYDRO module.  If not, see <http://www.gnu.org/licenses/>.
 
-#########################################
+#######################
 Import de bathymétrie
-#########################################
+#######################
 
 .. |import_bathy1| image:: /_static/bathy1.png
    :align: middle
@@ -58,3 +58,6 @@ systématiquement affichée.
 Nous devrions obtenir une vue ressemblant à ceci :
 
   |import_bathy1|
+
+ 
+  :ref:`ref_exempleInondation`
index db77de7e2164be4a4327a00addec36d95fdc3741..81efbde8dd216e3e06edb9570920c9b29e8ec901 100644 (file)
@@ -39,16 +39,56 @@ auxquels ont été ajoutés deux modules spécifiques du métier :
   * HYDRO |Hydro_module_button| : acquisition des données de terrain (contours, bathymétrie...),
     construction de la géométrie du cas de calcul, identification des zones de 
     condition limite...
+
   * HYDROSolver |hydrosolver_module_button| : définition des paramètres physiques et
     numériques du cas de calcul, pilotage du calcul
 
 Le tutoriel traite l'ensemble des étapes d'une étude d'inondation liée à une crue 
 de fleuve. L'exemple est tiré d'un cas réel pour lequel beaucoup de données sont disponibles.
+
+.. _ref_installationLancementSalome:
+
+###################################
+Introduction à SALOME
+###################################
+
+Dans cette partie, on rappelle comment installer et exécuter SALOME. 
  
 .. toctree::
-   :maxdepth: 2
+   :numbered:
+   :maxdepth: 3
+
+   installationLancementSalome.rst
+
+.. _ref_notionsPrealables:
+
+###################################
+Quelques notions préalables
+###################################
+
+On décrit ici les différentes étapes d'une étude SALOME-HYDRO, en introduisant les concepts nécessaires.
+Cette partie contient également une série de recommandations et de pièges à éviter.
+.. toctree::
+   :numbered:
+   :maxdepth: 3
 
    preliminaires.rst
+   piegesAEviter.rst
+   donneesPrealables.rst
+
+.. _ref_exempleInondation:
+
+###################################
+Un exemple simple d'inondation
+###################################
+
+Cet exercice couvre complètement une étude d'inondation sur un problème simple.
+
+.. toctree::
+   :numbered:
+   :maxdepth: 3
+
    import.rst
    importBathy.rst
    polylignes.rst
@@ -60,6 +100,19 @@ de fleuve. L'exemple est tiré d'un cas réel pour lequel beaucoup de données s
    miseEnDonneesTelemac.rst
    lancementCalcul.rst
    depouillementCalcul.rst
+
+.. _ref_casParticuliers:
+
+###################################
+Des cas particuliers
+###################################
+
+On introduit ici des concepts non abordés dans l'exemple simple précédent.
+
+.. toctree::
+   :numbered:
+   :maxdepth: 3
+
    streams.rst
    objetsArtificiels.rst
    
\ No newline at end of file
diff --git a/doc/salome/tutorial/installationLancementSalome.rst b/doc/salome/tutorial/installationLancementSalome.rst
new file mode 100644 (file)
index 0000000..3b93066
--- /dev/null
@@ -0,0 +1,67 @@
+..
+   Copyright (C) 2015-2016 EDF
+
+   This file is part of SALOME HYDRO module.
+
+   SALOME HYDRO module is free software: you can redistribute it and/or modify
+   it under the terms of the GNU General Public License as published by
+   the Free Software Foundation, either version 3 of the License, or
+   (at your option) any later version.
+
+   SALOME HYDRO module is distributed in the hope that it will be useful,
+   but WITHOUT ANY WARRANTY; without even the implied warranty of
+   MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+   GNU General Public License for more details.
+
+   You should have received a copy of the GNU General Public License
+   along with SALOME HYDRO module.  If not, see <http://www.gnu.org/licenses/>.
+
+####################################
+installation et lancement de SALOME
+####################################
+
+installation
+============
+
+ * Ouvrir compte  (ex : I88928)
+
+ * Ouvrir navigateur web (bouton bleu en haut à droite ou Applications/Internet/Navigation Web Iceweasel)
+
+ * Taper l’adresse : nepal.der.edf.fr/pub/
+
+ * Aller dans SALOME_releases/
+
+ * Puis v7_3_0/
+
+ * Puis, Calibre 7
+
+ * Puis Salome_V7_3_0_hydro_x86_64.run
+
+ * Enregistrer (le fichier est automatiquement sauvé dans /Téléchargements)
+
+ * Ouvrir un terminal  (En haut de l’écran : Accessoires/Terminal)
+
+ * Taper cd Téléchargements
+
+ * Taper ls : on doit voir le Salome ….run
+
+ * (si nécessaire le rendre exécutable : chmod +x Salome_V7_3_0_hydro_x86_64.run)
+
+ * Lancer l’installation en tapant ./Salomé_V7_3 …
+
+ * Réponse aux questions d’installation (répertoire /scartche/NNI/salome/, langue : anglais, toutes les autres questions : oui par défaut)
+
+Le laisser installer dans le répertoire /salome, répondre aux questions en laissant les valeurs par défaut.
+Salome_Hydro est installé
+ 
+
+installation en anglais. 
+
+icone sur le bureau : editer pour la log.
+
+lancement de SALOME
+====================
+
+blabla
+
+  :ref:`ref_installationLancementSalome`
index 4c7387e018aea04a56616f13cdf94d38833837d3..acd3272d331d91db4f048dafb997f7921bad48de 100644 (file)
@@ -20,4 +20,7 @@
 Interpolation en Z
 #########################################
 
-blabla.
\ No newline at end of file
+blabla.
+
+ 
+  :ref:`ref_exempleInondation`
index a7cf78860e338450eb0b11cf27d90a64ded348f4..a00dcbdf941527036cd423ee1d10f0f45b8551be 100644 (file)
@@ -20,4 +20,7 @@
 Lancement du calcul TELEMAC
 #########################################
 
-blabla.
\ No newline at end of file
+blabla.
+
+ 
+  :ref:`ref_exempleInondation`
index 0105ee2f7c3c57ba526ca081ed494b3b32b8fd56..fddacca09b4e1a00b235357d5c6f623dffb926dd 100644 (file)
@@ -20,4 +20,7 @@
 Création du maillage
 #########################################
 
-blabla.
\ No newline at end of file
+blabla.
+
+ 
+  :ref:`ref_exempleInondation`
index 552a9ae71a3fa9bbe24f39d033987acc3849e6f0..8dd39546f609a524571f6829b8f60d9bd8fe7a69 100644 (file)
@@ -20,4 +20,7 @@
 Mise en données TELEMAC
 #########################################
 
-blabla.
\ No newline at end of file
+blabla.
+
+ 
+  :ref:`ref_exempleInondation`
index 7f2aa3759546da580013a3fcf5bb107569f63240..72ed87dc2915996792ab7f89dc26132a705d8c17 100644 (file)
@@ -20,4 +20,7 @@
 Objets Artificiels
 #########################################
 
-blabla.
\ No newline at end of file
+blabla.
+
+ 
+  :ref:`ref_casParticuliers`
index 6e1cf21252f62ca3b24494f881ec78d126b2e525..4589918e5d1796ff31db6a80b96afedfc1b2b358 100644 (file)
@@ -83,3 +83,5 @@ il faut décocher ce paramètre.
 
   |zoneSubmersible|
 
+ 
+  :ref:`ref_exempleInondation`
diff --git a/doc/salome/tutorial/piegesAEviter.rst b/doc/salome/tutorial/piegesAEviter.rst
new file mode 100644 (file)
index 0000000..08bfcbe
--- /dev/null
@@ -0,0 +1,48 @@
+..
+   Copyright (C) 2015-2016 EDF
+
+   This file is part of SALOME HYDRO module.
+
+   SALOME HYDRO module is free software: you can redistribute it and/or modify
+   it under the terms of the GNU General Public License as published by
+   the Free Software Foundation, either version 3 of the License, or
+   (at your option) any later version.
+
+   SALOME HYDRO module is distributed in the hope that it will be useful,
+   but WITHOUT ANY WARRANTY; without even the implied warranty of
+   MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+   GNU General Public License for more details.
+
+   You should have received a copy of the GNU General Public License
+   along with SALOME HYDRO module.  If not, see <http://www.gnu.org/licenses/>.
+
+####################################
+pieges a eviter
+####################################
+
+- chevauchement d'objets ou lignes très proches qui vont conduire à un maillage laid ou trop fin, 
+
+- trop de points dans les splines, quand ils ne sont pas nécessaires, 
+
+- tout ce qui va conduire à une complexité inutile de la partition lors de la création du cas,
+  et empêcher un mode automatique de regroupement des zones en régions 
+
+- changement de repere : il est préférable de définir un repère local au plus tôt. cf tutoriel.
+
+- Les deux systèmes de coordonnées apparaissent, mais il est préférable que la transition de l’un à l’autre
+  se face simplement (on arrondit les coordonnées de la nouvelle origine).
+
+- cohérence des systèmes de coordonnées des données importées : par exemple tout mettre en Lambert 93 avant import
+
+- utilisation du type spline ou du type polyline ?
+
+   * *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.
+ 
+  :ref:`ref_notionsPrealables`
index a91da534462f8de774b6cf5ef36c5b124c8815c9..26fd824f9bf8c62b7f4f42d3392a2506189875ae 100644 (file)
@@ -62,7 +62,7 @@ Nous allons créer trois lignes en dessinant sur les cartes et la bathymétrie.
 
 * 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.
+  correspondant au champ de bathymétrie garonne_point_L93.
 
 * Un contour fermé en lignes brisées qui délimitera notre domaine d'étude.
 
@@ -165,3 +165,5 @@ Une fois le fleuve dessiné, nous poursuivons avec le dessin du contour de la ba
 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`
index 64cdf378f15a137db6d9e360cdac338fa80a1596..ac03bd6eb7291e67f6befcde73e76fb01c638c11 100644 (file)
@@ -17,7 +17,7 @@
    along with SALOME HYDRO module.  If not, see <http://www.gnu.org/licenses/>.
 
 #########################################
-Notions préliminaires
+Notions préliminaires 
 #########################################
 
  * **Géoréférencement** : Le système de projection à utiliser dépend de 
@@ -34,4 +34,518 @@ Notions préliminaires
    Pour améliorer la précision numérique dans les différentes étapes de
    l'étude (géométrie, maillage, calcul...),
    **il est très fortement recommandé de prendre un repère local**.
+
+ * **ligne de contrainte** Ligne sur laquelle le maillage va s'appuyer.
+   Dans SALOME, ces lignes sont définies dans la Géométrie (module GEOM) en tant que "edge".
+   Toutes les lignes que l'on construit dans le module HYDRO ne sont pas forcément gardées dans la géométrie.
+
+ * **axe hydraulique** Ligne d'écoulement d'une rivière.
+   Souvent obtenue en reliant les points bas d'une succession de profils en travers.
+
+ * **ligne de crête** Ligne reliant les points les plus haut d'une digue.
+
+ * **partition** Zones et Régions
+   
+manipulation des vues dans SALOME
+====================================
+
+Zoom
+----
+
+Ctrl + clic gauche
+
+Le zoom est centré par défaut.
+Activation avec la molette de la souris : pour pouvoir activer le zoom avec la molette de la souris :
+file / preferences (sélectionner le module SALOME) / 3D viewer / zooming style / relative au curser
+Un zoom relatif au curseur est centré sur la partie au tour de la position du curseur  
+alors qu’un zoom centré prend en compte toute la zone.
+
+Pour zoomer sur une donnée de l’arbre : 
+
+Sélectionner la donnée de l’arbre.
+Dans la barre d’outils en haut choisir « Fit All »
+
+Rotation
+-----------
+
+Ctrl + clic droit
+
+Translation
+-----------
+
+Ctrl + molette
+
+Affichage des données dans les fenêtres
+---------------------------------------
+
+Par un clic sur le petit œil à côté de la couche d’intérêt dans la fenêtre Object Browser
+Par un clic droit dans l’arbre de gauche (dans la fenêtre Object Browser) sur la couche d’intérêt 
+utiliser les différentes possibilités ::
+
+  /show/ show only / hide / hide only / hide all /
+
+Viewers
+-------
+
+SALOME propose différents viewers : 
+
+VTK pour les vues 3D (module MESH) et OCC pour les vues 2D (pour la géométrie).
+On les retrouve via les onglets qui apparaissent à l’écran.
+
+Principales étapes d'une étude avec SALOME-HYDRO
+==================================================
+
+SALOME contient l’ensemble des modules nécessaires au lancement d’une étude Telemac.
+
+L’application SALOME-HYDRO concentre les modules HYDRO et HYDRO-SOLVER au sein de la plate-forme SALOME      
+et intègre le système Telemac2D.
+
+La figure ci-dessous résume les étapes générales et les outils utilisés au sein de la plate-forme SALOME : 
+lien image
+
+Figure 1 : Etapes d’une étude hydraulique avec la plate-forme Salomé 
+
+L’étude se déroulera en passant par les différents modules de SALOME :
+
+ * HYDRO
+
+ * GEOM : pour dessiner la CAO
+
+ * MESH
+
+ * HYDRO SOLVER ???
+
+ * PARAVIS
+
+Fonctionnement :
+
+ * on crée ou importe des lignes de contour d'objets naturels (rivières, iles...) 
+   et artificiels (digues, canaux, obstacles...), 
+
+ * on importe des champs de bathymétrie / altimétrie, ou des séries de profils de rivière, 
+
+ * on constitue des objets, 
+
+ * on constitue des cas de calculs en choisissant les objets utiles au cas, 
+   on regroupe les zones en régions (= faces de la géométrie finale),
+
+ * on exporte le cas vers GEOM,
+
+ * on ajuste le cas dans GEOM,
+
+ * on maille dans SMESH,
+
+ * on calcule l'interpolation en Z, 
+
+ * on définit le paramétrage physico numérique du calcul (fichier cas), 
+
+ * on exécute le calcul,
+
+ * on dépouille les résultats
+
+Dans le module HYDRO lui-même, la logique d’enchaînement des étapes est la suivante (voir les différents types d’objets manipulés dans l’arbre de gauche) :
+
+ * IMAGES : 
+
+L’idée est de partir d’images satellitaires et/ou de cartes de la zone à mailler 
+pour situer les différents éléments de l’étude., Ces images devront être géoréférencées 
+dans le même système de coordonnées que l’ensemble des données (Lambert93 par exemple). 
+Il peut s’agir de capture d’écran du géoportail par exemple. (cf chapitre 6)
+
+ * BATHYMETRIE :
+
+Les bathymétries constituées de nuages de points et/ ou de profils qui constituent le modèle de terrain 
+sur lequel va s’appuyer le maillage sont importées dans le projet (cf chapitre 7).
+
+ * POLYLINES :
+
+Les polylines (importées et/ou construites dans SALOME) permettent de définir les contours pour 
+le futur maillage et des différents éléments qui seront à prendre en compte. 
+Les poylignes splines permettent de définir des contours sans que le maillage qui 
+s’y appuiera ne doive utiliser strictement les points de la ligne. Seule la forme générale compte. 
+On peut tracer les lignes de contrainte à la souris ou les importer à partir d’un fichier (cf chapitre 8).
+
+ * NATURAL OBJECTS :
+
+Il s’agit des éléments constitués par exemple de l’emprise d’un domaine, d’îles, ….. 
+ou une région du domaine étudié à laquelle on associe une bathymétrie
+
+A compléter
+
+La création d’objets "naturels" et "artificiels" permet de définir les zones à mailler 
+et les bathymétries à y associer (cf. chapitre 9).
+
+ * ARTIFICIAL OBJECTS :
+
+Il s’agit de construire des éléments tels que des digues ou des canaux de géométrie connue.
+
+ * CALCULATION CASES :
+
+Lors de la définition du cas de calcul on sélectionne les objets à mailler et on résout les conflits 
+de recouvrement des bathymétries (cf. chapitre 10)
+
+Il s’agit ici de la description d’un déroulement type, des allers-retours entre les différentes étapes
+sont tout à fait possibles et se produiront certainement.
+ 
+IMPORT D’IMAGES
+================
+
+Il est possible d’importer des plans, cartes, et photos dans le module Hydro dans le dossier Images de l’arbre objet.
+L’idée est de partir d’images satellitaires et/ou de cartes de la zone à mailler, géoréférencées dans le même système de coordonnées que l’ensemble des données (Lambert93 par exemple). (cf chapitre 6)
+Il est possible de récupérer l’intersection de deux images, de les fusionner, de restreindre une image à partir d’une polyline.
+
+lien vers tutoriel
+
+Il est possible de fusionner les images ce qui crée un nouvel objet « Fuse_N »
+
+Autres options de traitement d'images
+
+Import de Bathymetries
+=======================
+
+renvoi vers tutoriel
+
+visualisation : si Z < 0: caché par cartes. inverser la vue, ou decaler Z pour avoir des valeurs positives.
+
+
+Import d'objets de type lignes
+==================================
+
+polylignes
+-----------
+
+définition : lignes dans le plan XY, généralement utilisées pour définir des contours, des zones.
+Il est possible d’importer des polylines au format sinusX dans le dossier Polylines de l’arbre objet du module Hydro.
+
+lien Format sinusX
+
+profils
+----------
+
+Deux types de profils : géoréférencés ou non: 
+les profils géo sont définis dans XYZ, les autres dans XZ (XY)
+Utilité : section de digue, de canal, de rivière
+Une seule section pour un canal ou une digue, une série de profils pour une rivière.
+La valeur Z=0 correspond à la ligne de crête.
+On considère uniquement des profils symétriques (par rapport à la ligne de crête).
+
+Il est également possible d’importer des profils au format sinusX dans le dossier Profils de l’arbre objet du module Hydro
+
+lien Format sinusX
+
+Streams
+--------
+
+rivière décrite par une succession de profils en travers, ordonnés via une ligne amont-aval qui passe par ces profils.
+Cette ligne peut être l'axe hydraulique, mais ce n'est pas obligatoire.
+
+Récupération de données de bathymetrie d'un ancien maillage 
+=============================================================
+
+Il est possible de récupérer un ancien maillage d’un cas d’étude, en le transformant  avec un convertisseur 
+intégré dans SALOME-HYDRO du format selafin (.slf) au format .med (format dédié pour la plate-forme Salomé en général).
+
+ * Mode opératoire ??
+
+A partir de l’ancien maillage, il peut être nécessaire d’appliquer une translation (par exemple +2 000 000) 
+à la position y des nœuds pour passer en système de géoréférencement connu (par exemple LambertIIEtendu). 
+
+ * Mode opératoire ??
+
+Puis la bathymétrie (champ de fond Z) est récupérée à l’aide d’un script Python qui crée un fichier .xyz 
+(position x du nœud, position y du nœud, Champ Z associé). 
+Ce fichier .xyz est converti en Lambert93 grâce au logiciel libre Circé .
+
+ * Mode opératoire ??
+
+Ensuite les positions des nœuds des bords sont récupérées à l’aide d’un script Python qui parcourt les nœuds,
+constate si ils sont au bord et crée un fichier dans lequel chaque bord récupéré est mis en forme pour un import direct
+dans le module HYDRO (la mise en forme est celle du type polyligne, voir paragraphe 8). 
+On peut isoler de cette façon le contour de l’emprise, des piles de ponts, et les îles éventuelles.
+
+ * Mode opératoire ??
+ 
+Dessin de lignes
+=================
+
+Afin de mettre en place notre modèle de terrain, le module Hydro nous permet de définir des contours, des zones.
+
+Les contours types polylines sont nécessaires à la création de la géométrie. 
+Ils permettent la construction de l’emprise du modèle, des îles, du lit mineur d’un fleuve...
+On peut superposer les contours à la bathymétrie ou aux cartes pour s’aider, visualiser. 
+
+On peut créer des digues ou des routes dans le modèle à l’aide de polylines.
+
+polylines
+---------
+
+Dans SALOME les polylignes sont des polylignes (séries de segments, 
+pour décrire un objet géométrique) ou des splines (suite d’arcs, lissé, 
+pour décrire une courbure naturelle, qui s’adaptera à la finesse de la discrétisation).
+L’utilisation de splines permet de définir des contours sans que le maillage qui s’y appuie 
+ne s’accroche à tous les points de la ligne : seule la forme générale compte.
+On choisit l’un des deux modes au départ. 
+Puis la création du contour se fait par clic directement dans l’IHM. 
+Il est possible d’éditer le contour par la suite et de déplacer un ou plusieurs points 
+ou bien d’en ajouter. On peut également changer après coup le type d’une ligne : polyligne simple ou spline.
+
+On peut tracer les lignes de contrainte à la souris, ou les importer à partir d’un fichier.
+
+Pour créer une polyligne :
+
+Dans le module HYDRO :
+
+ * Clic droit sur POLYLINES / Create polyline
+
+ * (ou MenuHYDRO, Create polyline)
+
+On peut définir des « sections », i.e. des portions de polylignes, 
+ce qui peut être utile pour gérer des connexions de polylignes.
+Créer une polyligne de type spline fermée pour délimiter la zone à mailler par exemple.
+
+Dans la partie droite de l’écran une fenêtre apparaît :
+
+ * Saisir le nom de la ligne (par défaut le premier nom est «  Polyline_1 »)
+
+ * Cliquer sur le bouton ‘Insert section’
+
+En bas, à droite de l’écran, apparaît une zone de saisie : « Add element »
+
+ * Saisir le nom de la section
+
+ * Choisir le type (polyline ou spline)
+
+ * Cocher ou décocher : ‘Closed’
+
+ * En haut de la zone section, cliquer sur le bouton « Addition Mode »
+
+ * Cliquer les points de la ligne dans la zone principale de l’écran, sur la carte (onglet OCC Viewer)
+
+ * Terminer la ligne par un double-clic
+
+En recliquant sur « Addition Mode », on peut ajouter des points à la polyligne
+En cliquant sur « Modification mode », on peut sélectionner les points :
+les coordonnées des points apparaissent alors en bas à droite sous forme de table.
+Il est possible d’en modifier les valeurs de X et/ou de Y, ou de déplacer les points sur la vue OCC.
+
+Le clic sur « Apply » ferme la fenêtre de polyline. Pour la  modifier :        
+
+ * clic droit sur le nom de la polyline dans la colonne de gauche et « Edit Polyline ».
+
+« Detection Mode » : permet de sélectionner toute la ligne en cliquant dessus.
+
+L’action « Remove » permet de supprimer une section d’une courbe qui en comporte déjà plusieurs.
+Le bouton « join selected sections » est actif quand deux sections de la même courbe 
+sont sélectionnées (à éviter avec des courbes fermées). 
+Il relie le dernier point de la première courbe sélectionnée au premier point de la deuxième courbe sélectionnée.
+
+Pour transformer une section ouverte en section fermée (ou inversement) après saisie : 
+
+ * sélectionner le mode modification 
+
+ * clic droit sur le nom de la sélection
+
+ * set closed (ou set open) 
+
+profils de digue ou canal
+--------------------------
+
+dessin ou import
+dessin grossier de la forme, selection des points, affichage du tableau de coordonnées et modification
+
+profils de riviere
+------------------
+
+import seulement
+
+Création d'objets "naturels" type "zone immersible"
+===================================================
+
+distinguer les iles du reste
+Bathymétrie associée
+Créer une zone immersible consiste à créer une face géométrique à partir d’un des contours dessinés précédemment. 
+On renseigne donc pour cela la polyline (obligatoire) sur laquelle va reposer la face et la bathymétrie (facultative) 
+que l’on souhaite associer à cette zone géographique.
+Couleur  éditable.
+
+Remarque : la bathymétrie est facultative dans la création d’une zone immersible car on n’a pas forcément
+d’altitudes associées à chaque zone construite mais on souhaite tout de même que les contours de ces zones 
+soient pris en compte pour la partition qui va créer notre modèle plus tard. 
+Par exemple, le cas des îles est typique : nous n’avons pas de topographie associée à l’île de la centrale nucléaire 
+mais nous souhaitons que le contour soit inscrit dans le modèle numérique de terrain.
+Il est également possible de changer l’ordre d’affichage des différentes zones pour une meilleure 
+visibilité du futur modèle (voirFigure 13).
+
+Caractère submersible ou non
+
+Création d'objets "naturels" type "stream"
+==========================================
+
+Il faut, soit l'axe hydraulique, soit une ligne reliant les profils pour les ordonner.
+les profils sont importés.
+
+Création d'objet "artificiel" type digue ou canal
+=================================================
+
+Le module Hydro permet la création de d’objets digues dans le dossier Artificial Objects de l’arbre objet du module Hydro.
+Une digue se crée en 5 étapes : 
+
+ * D’abord, il faut créer l’axe de la digue en tant que polyline  (XY, en vue de dessus),
+
+ * Ensuite, il faut créer la ligne de crête de la digue en tant que profil
+   ((XZ, XY, altitude en fonction de l'abcisse curviligne sur l'axe) 
+
+ * Ainsi que la section de la digue en tant que profil également (XZ, ligne brisée),
+
+ * Puis, il faut créer une polyline3D dans le dossier de même nom dans Hydro. 
+   Cela permet d’associer l’axe de la digue avec le profil d’altitude,
+
+ * Enfin, il faut créer un objet digue dans le dossier Artificial Objects, 
+   en associant la polyline3D avec le profil de section de la digue (voirFigure 10)
+
+Pour un canal, même démarche, mais remplacer ligne de crête par axe hydraulique.
+
+Vérifier effet géoréférencement
+
+Obstacles
+============
+
+objets géométriques complexes (bâtiments...) importés depuis GEOM, pour constituer des zones non submersibles ("iles" ou assimilés)
+
+Tables de coefficients de Strickler
+===================================
+
+a compléter
+
+Land Cover maps
+===============
+
+a compléter
+
+Constitution d'un cas de calcul
+================================
+
+Pour démarrer un nouveau cas de calcul :
+
+ * clic droit sur le dossier CALCULATION CASE de l’arbre objet du module HYDRO
+
+ * create Calculation case
+
+Première étape d’un cas de calcul, l’utilisateur choisit les différents objets métiers créés précédemment 
+qui vont participer au modèle de terrain qu’il souhaite générer.
+Figure 14 : Création d’un cas de calcul
+Dans cette étape, on sélectionne les objets à mailler.
+Dans la deuxième étape, HYDRO propose une série de segments 
+(contours des différents objets choisis précédemment « nomObjet_outer »). 
+L’utilisateur sélectionne ceux qui sont pertinents pour son calcul (ils seront visibles dans le module géométrie). 
+Le choix des contours à considérer permet de définir des régions homogènes et s’affranchir de contraintes 
+supplémentaires dans le maillage.
+En créant le cas de calcul, HYDRO crée une série de groupes de segments qui peuvent être utiles à l’utilisateur pour son calcul.
+
+Première étape d’un cas de calcul, l’utilisateur choisit les différents objets métiers créés précédemment 
+qui vont participer au modèle de terrain qu’il souhaite générer.
+
+etc.
+
+Notion de partition : le decoupage en faces élémentaires ou zones : dessin explicatif
+On peut regrouper des zones en régions homogènes dans la structure du maillage visée, 
+pour s’affranchir des contours que l'on ne veut pas garder en tant que lignes de contraintes.
+
+SALOME indique les zones de recouvrement des différents objets pour lesquelles il faut choisir une bathymétrie 
+(si plusieurs bathymétries existent sur une même zone). 
+Il est possible de sélectionner une des bathymétries 
+(par exemple la campagne de bathymétrie la plus récente, ou le min ou le max des bathy). 
+
+Il faut ensuite exporter le cas de calcul en tant que « géométrie SALOME » (à préciser) : Plus tard ???
+
+ * Clic droit sur Calculation case
+
+ * Export calculation case   = fabrique une entrée dans GEOMETRY
+
+Géométrie: Module GEOM
+======================
+
+Une fois le cas de calcul terminé et exporté il apparait dans le module GEOM 
+il faut se déplacer vers ce module pour pouvoir le visualiser et le modifier.
+Dans GEOM, on voit notre cas de calcul sous le nom HYDRO_Case_N auquel est attaché le (ou les) contour(s) 
+choisis au moment au moment de la définition du cas de calcul.
+
+Il se peut qu’on ait besoin de séparer certaines parties :
+
+ * Faces : pour mailler de façon différentes certaines zones
+
+ * Segments : pour définir les conditions aux limites.
+
+Pour cela on crée des groupes à partir de l’entité géométrique initiale soit par un clic droit 
+sur cette entité ensuite create groupe soit en allant sur New Entity / Group / Create group. 
+Lorsque la fenêtre de dialogue s’ouvre on vérifie bien que le nom de l’entité figure dans Main Shape, 
+ensuite on choisit le type de groupe que l’on souhaite créer (groupe de points, de segments, de faces ou d’objet 3D). 
+Après on sélectionne les parties qui nous intéressent une à une en cliquant à chaque fois sur Add.
+Dans ce module, on peut aussi définir des points fixes de notre maillage 
+(qui vont par exemple correspondre à des points de mesure). 
+Ceci doit être fait avant la définition des groupes. 
+En effet, on  commence par créer nos points (New Entity /Basic /Point en donnant leur coordonnées dans le bon système), 
+ensuite on fusionne ces points avec notre objet de départ en utilisant La fonction Operations / Partion   
+et en sélectionnant les objets à fusionner 
+(il faut maintenir la touche Ctrl enfoncée et cliquer sur les objets dans l’arbre à gauche). 
+Une fois la partition créée on commence la définition des groupes qui nous intéressent 
+(y compris les points qu’on vient de créer). Ces manipulations peuvent paraître redondantes mais elles sont primordiales. 
+On effet la partition permet de créer un lien entre l’entité géométrique de base et les objets qu’on ajoute. 
+Ces liens seront aussi visibles par le mailleur qui va les considérer comme des points fixe du maillage. 
+La définition des différents groupes va nous permettre d’isoler les nœuds qui appartiennent à ces groupes 
+à fin de pouvoir les manipuler de façon différente plus tard.
    
+Maillage: Module SMESH
+=======================
+
+Cf. tutoriel
+
+Contrôle des lignes de contrainte, des tailles de mailles
+Sous maillage /groupe géometrique
+Maillage d'une digue, d'un canal,
+Maillage d'une riviere (lit mineur)
+Maillage des autres régions.
+
+Interpolation en Z
+===================
+
+En hydrodynamique il est primordial de connaître la valeur de la bathymétrie en chaque nœud de calcul.
+Pour le moment on dispose d’un premier script qui permet d’interpoler la bathymétrie sur le maillage. 
+Ce script utilise un algorithme qui prend juste la valeur du Z du point le plus proche. 
+Donc si on ne dispose que d’un seul fichier de bathymétrie on conseille d’utiliser l’algorithme de TELEMAC3D 
+qui fait une interpolation linéaire sur le quadrangle le plus proche en donnant juste le nom du fichier (XYZ) 
+avec le mot clé  FICHIER DES FONDS. Ceci dit TELEMAC n’accepte pas plusieurs fichiers 
+(il n’aime pas quand on a plusieurs valeurs pour le même point).  
+A terme Il faudrait améliorer le script (traduire l’algorithme de TELEMAC3D je le ferai qd j’aurais un peu de temps).
+
+Interpolation avec le Script actuel :
+D’abord exporter le maillage en MED (il faut que des groupes de nœuds soit créés pour chaque région)
+
+Modifier l’entête du script, en indiquant le nom du cas de calcul, 
+le fichier du maillage MED et la correspondance entre les groupes de nœuds et les régions définies dans le cas de calcul 
+(rappelant que c’est à ce niveau qu’on définit la bathymétrie de chaque région) Pour lui dire où lire la bathymétrie::
+
+  nomCas = 'Nom du cas Case 1'
+  fichierMaillage = 'chemin absolu du fichier Mesh.med'
+  dicoGroupeRegion= dict(NomGroupeDeNoeuds1 = 'Case_1_Region1',
+                         NomGroupeDeNoeuds2 = 'Case_1_Region2',
+                         ….
+                         )
+
+Dans l’optique d’utiliser Homard (disponible dans Salomé) à fin de raffiner le maillage selon
+le gradient de bathymétrie, il y a un deuxième script qui crée un champ Z, 
+mais Homard casse le lien entre la géométrie et le maillage et ça devient compliquer de redéfinir les conditions aux limites.
+
+Remarque : 
+
+Si on veut donner la bathymétrie dans le fichier de maillage il faut utiliser le deuxième script 
+tout en changeant le nom de Z pour que l’information soit compréhensible pour TELEMAC3D  
+(TELEMAC3D s’attend à un champ avec un nom appartenant à une liste prédéfinie).
+
+ 
+  :ref:`ref_notionsPrealables`
index 86fc8c1a12be0a8abe620769551cda5a56dc590b..adc5ca2aa9edced2b4c3ed56d658bd41f919454d 100644 (file)
@@ -20,4 +20,7 @@
 Streams
 #########################################
 
-blabla.
\ No newline at end of file
+blabla.
+
+ 
+  :ref:`ref_casParticuliers`