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
+ * **Géoréférencement** : Le système de projection à utiliser dépend de
la localisation géographique de l'étude et doit être choisi et noté
pour faciliter la reprise de l'étude. En France métropolitaine, la
projection de référence est Lambert 93.
-
+ **Toutes les données importées dans SALOME-HYDRO doivent être dans le même réferentiel.**
+ SALOME-HYDRO ne propose pas de convertisseur.
+
* **Repère Local** : Les coordonnées planes, **toujours exprimées en mètres**,
dans la projection utilisée correspondent souvent à des grands nombres.
Par exemple, les coordonnées en Lambert 93 d'un point du territoire
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**.
+ SALOME-HYDRO affiche les coordonnées dans les deux repères (local et global)
+ et assure les translations automatiquement à l'import et à l'export.
- * **ligne de contrainte** Ligne sur laquelle le maillage va s'appuyer.
+ * **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.
+ * **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.
+ * **ligne de crête** : Ligne reliant les points les plus hauts d'une digue.
- * **partition** Zones et Régions
+ * **partition** : Il s'agit d'une partition de l'espace en **zones** et **régions**.
+ Les concepts de zones et de régions sont introduits par la pratique dans l'exercice plus bas.
+ Les frontières d'une région correspondent aux lignes de contrainte du maillage. Les régions peuvent
+ être découpées en plusieurs zones. Une zone correspond à un mode de calcul de la bathymétrie.
-manipulation des vues dans SALOME
-====================================
+ * **Land Cover Map** : Carte d'occupation des sols, qui donne la nature des terrains, selon une codification
+ *Corine Land Cover*.
+
+ * **Table de Strickler** : Donne le *coefficient de Stricker* (frottement au sol) par type de Zone *Corine Land Cover*.
+ Ces coefficients sont à ajuster au cas par cas, selon le type de calcul.
-Zoom
-----
-Ctrl + clic gauche
+################################################
+Principales étapes d'une étude avec SALOME-HYDRO
+################################################
-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.
+.. |etapesEtude| image:: /_static/etapesEtude.png
+ :align: middle
-Pour zoomer sur une donnée de l’arbre :
+.. |SALOME_Memo| image:: /_static/SALOME_Memo.png
+ :align: middle
-Sélectionner la donnée de l’arbre.
-Dans la barre d’outils en haut choisir « Fit All »
+SALOME contient l’ensemble des modules nécessaires au lancement d’une étude Telemac.
-Rotation
------------
+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.
-Ctrl + clic droit
+La figure ci-dessous résume les étapes générales et les outils utilisés au sein de la plate-forme SALOME.
-Translation
------------
+ |etapesEtude|
-Ctrl + molette
+L’étude se déroulera en passant par les différents modules de SALOME :
-Affichage des données dans les fenêtres
----------------------------------------
+ * HYDRO
-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 ::
+ * GEOM
- /show/ show only / hide / hide only / hide all /
+ * MESH
-Viewers
--------
+ * HYDROSOLVER
-SALOME propose différents viewers :
+ * PARAVIS
-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
-==================================================
+**Les prinicpales étapes :**
+
+ * HYDRO : on importe des images et/ou des plans
-SALOME contient l’ensemble des modules nécessaires au lancement d’une étude Telemac.
+ * HYDRO : on crée ou importe des lignes de contour d'**objets naturels** (rivières, iles...)
+ et **artificiels** (digues, canaux, obstacles...),
-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.
+ * HYDRO : on importe des champs de bathymétrie / altimétrie, ou des séries de profils de rivière,
-La figure ci-dessous résume les étapes générales et les outils utilisés au sein de la plate-forme SALOME :
+ * HYDRO : on constitue des objets naturels et artificiels,
-lien image
+ * HYDRO : on importe ou crée une carte des occupations des sols (Land Cover Map)
+ et une table donnant les coefficients de Strickler par type de zone (frottements au sol),
-Figure 1 : Etapes d’une étude hydraulique avec la plate-forme Salomé
+ * HYDRO : on constitue un **cas de calcul** en choisissant les objets utiles au cas,
+ on regroupe les **zones** (une zone correspond à un mode de calcul particulier de la bathymétrie)
+ en **régions** (Les frontières des régions correspondent aux lignes de contrainte du maillage,
+ ce sont les faces de la géométrie finale SALOME), on associe au cas la Land Cover Map et la table de Strickler,
-L’étude se déroulera en passant par les différents modules de SALOME :
+ * HYDRO : on exporte le cas vers GEOM,
- * HYDRO
+ * GEOM : on reprend le cas dans GEOM, pour compléter l'identification des groupes liés aux différentes régions du domaine
+ et des conditions limites,
- * GEOM : pour dessiner la CAO
+ * SMESH : on choisit les algorithmes et hypothèses de maillage, on calcule le maillage et exporte le fichier MED du maillage,
- * MESH
+ * HYDROSOLVER : on génère et exécute le script Python qui permet le calcul de l'interpolation en Z aux noeuds du maillage,
+ à partir du fichier MED et du cas de calcul,
- * HYDRO SOLVER ???
+ * HYDROSOLVER : on génère et exécute le script Python qui permet l'affectation des coefficients de Strickler aux noeuds du maillage,
+ à partir du fichier MED et du cas de calcul,
- * PARAVIS
+ * HYDROSOLVER : on définit les zones de conditions limites (fichier xxx.bcd)
-Fonctionnement :
+ * HYDROSOLVER : on definit les évolutions des valeurs des conditions limites au cours du temps (fichier xxx.lqd ?)
- * on crée ou importe des lignes de contour d'objets naturels (rivières, iles...)
- et artificiels (digues, canaux, obstacles...),
+ * HYDROSOLVER : on définit le paramétrage physico numérique du calcul (fichier cas),
- * on importe des champs de bathymétrie / altimétrie, ou des séries de profils de rivière,
+ * HYDROSOLVER : on exécute le calcul,
- * on constitue des objets,
+ * PARAVIS : on dépouille les résultats
- * 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),
+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) :
- * on exporte le cas vers GEOM,
+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.
- * on ajuste le cas dans GEOM,
+ * IMAGES :
- * on maille dans SMESH,
+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.
- * on calcule l'interpolation en Z,
+ * BATHYMETRIE :
- * on définit le paramétrage physico numérique du calcul (fichier cas),
+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.
- * on exécute le calcul,
+ * POLYLINES :
- * on dépouille les résultats
+Les polylignes (importées et/ou construites dans SALOME) permettent de définir les contours des différents objets
+naturels et artificiels qui vont intervenir dans le cas de calcul. Ce sont des lignes fermées dans le cas général.
+Certaines de ces lignes constitueront les lignes de contrainte du maillage.
+Les polylignes 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 à la souris ou les importer à partir d’un fichier.
-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) :
+ * NATURAL OBJECTS :
- * IMAGES :
+Il s’agit des éléments constitués par exemple de l’emprise d’un domaine, d’îles, de lacs...
+On sait en général leur associer une bathymétrie.
-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)
+ * ARTIFICIAL OBJECTS :
- * BATHYMETRIE :
+Il s’agit de construire des éléments tels que des digues ou des canaux de géométrie connue.
-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).
+ * CALCULATION CASES :
- * POLYLINES :
+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.
-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 :
+**Résumé des étapes :** également `disponible en pdf`__.
-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
+.. _SALOME_Memo_pdf: SALOME_Memo.pdf
-A compléter
+__ SALOME_Memo_pdf_
-La création d’objets "naturels" et "artificiels" permet de définir les zones à mailler
-et les bathymétries à y associer (cf. chapitre 9).
+ |SALOME_Memo|
- * ARTIFICIAL OBJECTS :
-Il s’agit de construire des éléments tels que des digues ou des canaux de géométrie connue.
+données préalables
+==================
- * CALCULATION CASES :
+* 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 (suffisament éloignés pour améliorer la précision).
+ Avec trois points, on peut faire une transformation affine de l'image, pour le cas improbable ou celle-ci ne
+ correspondrait pas à une projection verticale.
-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)
+* Disposer des données de bathy au format ASCII.
-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
+Pour l’instant les fichiers de bathymetrie doivent porter l’extension .xyz (3 colonnes x,y,z) ou .asc
+(format de type grille a pas régulier, tel que fourni dans la BD Alti de l'IGN, par exemple).
+
+* Si l'on dispose de profils en travers pour le lit mineur, il peuvent être fournis au format .xyz
+ avec une ligne blanche séparant chaque profil, ou au format SinusX décrit plus loin.
+
+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 d’importer des plans, cartes, et photos dans le module Hydro dans le dossier Images de l’arbre de l'étude.
+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).
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
+Les manipulations d'images sont introduites dans l'exercice plus bas.
-Il est possible de fusionner les images ce qui crée un nouvel objet « Fuse_N »
+Choix d'un repère local
+=======================
+
+**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.
-Autres options de traitement d'images
+Pour cela il faut utiliser le menu *Hydro/change local CS* et renseigner les coordonnées de la nouvelle origine.
Import de Bathymetries
=======================
-renvoi vers tutoriel
+Le mode opératoire est expliqué dans l'exercice plus bas.
+
+ * **remarque** : Si les altitudes sont inférieures à 0, la bathymétrie peut être cachée par les cartes ou photos
+ (qui sont à Z = 0 par convention). Si l'on a besoin de voir simultanément la bathymétrie et les images,
+ on peut, par exemple, soit passer en vue de dessous, soit éditer la bathymetrie (menu contextuel "edit imported bathymetry")
+ pour inverser les z, le temps de contrôler la superposition des cartes et de la bathymétrie
+ (ne pas oublier d'enlever l'inversion de z après !).
+
+Récupération de données de bathymétrie d'un ancien maillage
+-----------------------------------------------------------
+
+Pour les différentes opérations ci-dessous, le mode opératoire précis reste à détailler. Les scripts Python cités
+ne sont pas fournis avec cette version, is nécesitent des adaptations au cas par cas.
+
+ * 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).
+
+ * 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).
-visualisation : si Z < 0: caché par cartes. inverser la vue, ou decaler Z pour avoir des valeurs positives.
+ * 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é (sous Windows).
+
+ * 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 s'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.
+
+ * On peut isoler de cette façon le contour de l’emprise, des piles de ponts, et les îles éventuelles.
Import d'objets de type lignes
==================================
+Le format SinusX (ASCII) décrit en annexe permet de décrire plusieurs types de lignes et de profils.
+Les fichiers au format SinusX qui respectent les conventions décrites en annexe peuvent être importés
+dans SALOME HYDRO.
+
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
---------
+Deux types de profils : géoréférencés ou non.
-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.
+Les profils géoréférencés sont définis dans XYZ, les autres dans XZ (XY).
+Utilité : section de digue, de canal, de rivière.
-Récupération de données de bathymetrie d'un ancien maillage
-=============================================================
+On définit une seule section pour un canal ou une digue, une série de profils pour une rivière.
-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).
+Pour une digue, la valeur Z=0 correspond à la ligne de crête, pour un canal, c'est la ligne de fond.
- * Mode opératoire ??
+On considère uniquement des profils symétriques (par rapport à la ligne de crête ou de fond).
-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 ??
+Streams
+--------
-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é .
+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.
- * Mode opératoire ??
+Les fichiers de stream peuvent être des fichiers XYZ pour lequels chaque profil est séparé par une ligne vide.
-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.
+Les contours de type polyligne 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, ainsi que des digues, des canaux, des routes...
-On peut créer des digues ou des routes dans le modèle à l’aide de polylines.
+On peut afficher la bathymetrie ou les cartes lors de la saisie des contours pour se repérer.
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.
+Dans SALOME les polylignes sont de deux types :
-Pour créer une polyligne :
+ * polylignes (ligne brisée constituée d'une série de segments droits, pour décrire un objet géométrique)
-Dans le module HYDRO :
+ * splines (suite d’arcs qui donne une courbe à dérivée continue,
+ pour décrire une courbure naturelle, qui s’adaptera à la finesse de la discrétisation).
- * Clic droit sur POLYLINES / Create polyline
+L’utilisation de splines permet de définir des contours sans que le maillage qui s’appuie dessus
+ne s’accroche à tous les points de la ligne : seule la forme générale compte.
- * (ou MenuHYDRO, Create polyline)
+Le mode opératoire est détaillé dans l'exercice ci-dessous.
-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.
+Il est possible de créer des lignes combinant polylignes et splines.
+Voir plus loin le pararaphe de manipulation des polylignes.
-Dans la partie droite de l’écran une fenêtre apparaît :
+profils de digue ou canal
+--------------------------
- * Saisir le nom de la ligne (par défaut le premier nom est « Polyline_1 »)
+On peut importer ou dessiner ce type de profils.
+Le mode opératoire du dessin est détaillé dans l'exercice ci-dessous.
- * Cliquer sur le bouton ‘Insert section’
+profils de rivière
+------------------
-En bas, à droite de l’écran, apparaît une zone de saisie : « Add element »
+Seul l'import de ces profils est prévu.
- * Saisir le nom de la section
+Création d'objets "naturels" type "zone immersible"
+===================================================
- * Choisir le type (polyline ou spline)
+Une **zone immersible** est une zone qui sera maillée. Les iles qui ne sont pas submersibles peuvent être exclues du maillage.
+Dans SALOME HYDRO, on distingue les îles du reste en désactivant leur attribut **Submersible**.
- * Cocher ou décocher : ‘Closed’
+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.
- * En haut de la zone section, cliquer sur le bouton « Addition Mode »
+ * Remarque : la bathymétrie est facultative dans la création des objets naturels, notamment dans le cas des îles.
- * Cliquer les points de la ligne dans la zone principale de l’écran, sur la carte (onglet OCC Viewer)
+ * Remarque : Il est possible de changer l’ordre d’affichage des différents objets naturels et artificiels qui sont tous par convention
+ dans le plan z=0, pour remettre "dessus" les petits objets.
- * Terminer la ligne par un double-clic
+Création d'objets "naturels" type "stream"
+==========================================
-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 mode opératoire est détaillé dans l'exemple plus bas.
-Le clic sur « Apply » ferme la fenêtre de polyline. Pour la modifier :
+Création d'objet "artificiel" type digue ou canal
+=================================================
- * clic droit sur le nom de la polyline dans la colonne de gauche et « Edit Polyline ».
+Le mode opératoire est détaillé dans l'exemple plus bas.
-« Detection Mode » : permet de sélectionner toute la ligne en cliquant dessus.
+Obstacles
+============
-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.
+Objets géométriques complexes (bâtiments...) importés depuis GEOM,
+pour constituer des zones non submersibles ("iles" ou assimilés).
+Il faut mettre ces objets dans le repère local avant des les importer.
-Pour transformer une section ouverte en section fermée (ou inversement) après saisie :
+Tables de coefficients de Strickler, Land Cover maps
+====================================================
- * sélectionner le mode modification
+Il est possible définir une carte des coefficients de Strickler (frottements sur le fond) couvrant le domaine d'étude.
- * clic droit sur le nom de la sélection
+Des cartes décrivant la nature des sols (Land cover Map) peuvent être récupérées sur différents sites.
+Il est notamment possible de télécharger et d'éditer dans un outil de SIG (Systeme d'Information Géographique)
+comme *qgis* les cartes "Corine Land Cover".
+Ces cartes s'appuient sur une nomenclature standard des différents types de territoire.
- * set closed (ou set open)
+On définit en parallèle une table des coefficients de Strickler qui donne le coefficient pour chaque type défini dans la nomenclature.
+Les coefficients de Strickler sont en général ajustés pour une étude donnée, pour recaler le modèle.
-profils de digue ou canal
---------------------------
+Les Land Cover Map peuvent être importées depuis qgis ou créées "from scratch" dans SALOME-HYDRO.
+Il est également possible d'éditer ces cartes dans SALOME-HYDRO : ajout, suppression, regroupement, modification de zones...
-dessin ou import
-dessin grossier de la forme, selection des points, affichage du tableau de coordonnées et modification
+Constitution d'un cas de calcul
+================================
-profils de riviere
-------------------
+Lors de la constitution d'un cas de calcul, il est possible de ne sélectionner que certains des objets définis précedemment.
+A partir d'une même base d'objets, on peut créer plusieurs cas de calculs plus ou moins complexes (prise en compte ou non
+de détails comme des piles de ponts, par exemple).
-import seulement
+L'emprise du domaine est définie par un contour polygonal particulier.
-Création d'objets "naturels" type "zone immersible"
-===================================================
+Le chevauchement des différents objets crée des zones "en conflit" pour lesquelles il faut faire des choix pour le calcul de
+la bathymétrie.
-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.
+Le résultat du découpage en zones des différents objets se chevauchant constitue l'opération dite de **partition**.
-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).
+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.
-Caractère submersible ou non
+Dans le cas de calcul, il est possible d'identifier certaines lignes qui serviront de support aux conditions limites.
-Création d'objets "naturels" type "stream"
-==========================================
+Le resultat est exporté dans le module de géométrie.
-Il faut, soit l'axe hydraulique, soit une ligne reliant les profils pour les ordonner.
-les profils sont importés.
+Le mode opératoire est détaillé dans l'exemple plus bas.
-Création d'objet "artificiel" type digue ou canal
-=================================================
+Géométrie: Module GEOM
+======================
-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 :
+Une fois le cas de calcul terminé et exporté il apparaît dans le module GEOM.
- * D’abord, il faut créer l’axe de la digue en tant que polyline (XY, en vue de dessus),
+Il faut activer ce module pour pouvoir visualiser et modifier le cas exporté.
- * 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)
+Il est conseillé de faire un *show only* sur la géométrie :
+dans l'arbre, se placer sur le cas de calcul dans la géométrie et menu contextuel clic droit *show only*.
- * Ainsi que la section de la digue en tant que profil également (XZ, ligne brisée),
+Dans GEOM, on voit notre cas de calcul sous le nom <nom de cas>_N auquel est attaché le (ou les) contour(s)
+choisis au moment au moment de la définition du cas de calcul.
- * 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,
+Il se peut qu’on ait besoin d'identifier certaines parties :
- * 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)
+ * Faces : pour mailler de façon différentes certaines zones
-Pour un canal, même démarche, mais remplacer ligne de crête par axe hydraulique.
+ * Segments : pour définir les conditions aux limites.
-Vérifier effet géoréférencement
+Le mode opératoire est détaillé dans l'exemple plus bas.
-Obstacles
-============
+ * remarque : Il est possible d'utiliser le module de géométrie pour définir un certain nombre de
+ contraintes sur le maillage. par exemple, on peut définir des points fixes de notre maillage
+ (qui vont par exemple correspondre à des points de mesure).
+ **Toute modification de la géométrie se traduit par la création d'un nouvel objet et la perte des groupes
+ définis dans l'objet initial. Il faut donc créer les groupes en dernier, sur la géométrie finale,
+ et, si possible éviter les modifications qui font perdre les définitions automatiques du module HYDRO.**
-objets géométriques complexes (bâtiments...) importés depuis GEOM, pour constituer des zones non submersibles ("iles" ou assimilés)
+Maillage: Module SMESH
+=======================
-Tables de coefficients de Strickler
-===================================
+On se réferera aux formations SALOME pour l'utilisation du module SMESH.
-a compléter
+Le mode opératoire pour SALOME-HYDRO est détaillé dans l'exemple plus bas.
-Land Cover maps
-===============
+Interpolation en Z
+===================
-a compléter
+principes
+---------
-Constitution d'un cas de calcul
-================================
+En hydrodynamique il est primordial de connaître la valeur de la bathymétrie en chaque nœud de calcul.
-Pour démarrer un nouveau cas de calcul :
+Le calcul de la bathymétrie est fait zone par zone, a chaque zone est associé un mode de calcul de la bathymétrie :
- * clic droit sur le dossier CALCULATION CASE de l’arbre objet du module HYDRO
+ * à partir des nuages de points
- * create Calculation case
+ * à partir des profils de rivière
-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.
+ * à partir de l'axe et de la section des digues et canaux
-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.
+ * à partir de la CAO des obstacles
-etc.
+Pour les nuages de points, on dispose dans HYDROSOLVER d’un utilitaire générant un script Python
+qui permet d’interpoler la bathymétrie sur le maillage.
+Ce script utilise un algorithme qui prend soit la valeur du Z du point le plus proche, soit la valeur Z interpolée
+sur une triangulation préalable du nuage.
-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.
+Le mode opératoire est détaillé dans l'exemple plus bas.
-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).
+Mise en données Physico-numérique pour TELEMAC
+===============================================
-Il faut ensuite exporter le cas de calcul en tant que « géométrie SALOME » (à préciser) : Plus tard ???
+Cette mise en données fait intervenir le module HYDROSOLVER pour l'assemblage du cas de calcul.
- * Clic droit sur Calculation case
+description des conditions limites
+----------------------------------
- * Export calculation case = fabrique une entrée dans GEOMETRY
+Chaque zone de condition limite correspond à un groupe nommé dans le maillage.
+Les types de conditon limites associés à un groupe sont définis dans un fichier.
+Dans le module HYDROSOLVER, un outil permet d'associer des types de condition limites aux groupes concernés ans le maillage,
-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.
+édition du fichier Cas
+----------------------
-Il se peut qu’on ait besoin de séparer certaines parties :
+Les paramètres de calcul sont définis dans le fichier Cas avec la syntaxe TELEMAC 2D
+(avec l'editeur EFICAS accessible depuis le module HYDROSOLVER ou avec un éditeur de texte standard).
- * Faces : pour mailler de façon différentes certaines zones
+inventaire des fichiers utilisés par TELEMAC 2D
+-----------------------------------------------
- * Segments : pour définir les conditions aux limites.
+A compléter, voir l'exemple ci-dessous.
-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
-=======================
+Lancement et suivi du calcul
+============================
-Cf. tutoriel
+Le module HYDROSOLVER permet de lancer TELEMAC 2D.
-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.
+Le mode opératoire est détaillé dans l'exemple plus bas.
-Interpolation en Z
-===================
+Dépouillement des résultats
+===========================
-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`
+Le module PARAVIS est utilisé pour l'exploitation des résultats.
+On se réfèrera aux formations SALOME pour l'utilisation du module PARAVIS.
+Certains filtres spécifiques à l’hydraulique sont détaillés dans l’exemple plus bas.
\ No newline at end of file
