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.
-
+ **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)
+ 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.
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.
+ * **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.
+
################################################
Principales étapes d'une étude avec SALOME-HYDRO
.. |etapesEtude| image:: /_static/etapesEtude.png
:align: middle
+.. |SALOME_Memo| image:: /_static/SALOME_Memo.png
+ :align: middle
+
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
+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.
+La figure ci-dessous résume les étapes générales et les outils utilisés au sein de la plate-forme SALOME.
|etapesEtude|
* PARAVIS
-Fonctionnement :
+-------------------------------------
+**Les prinicpales étapes :**
+
* HYDRO : on importe des images et/ou des plans
- * HYDRO : on crée ou importe des lignes de contour d'**objets naturels** (rivières, iles...)
- et **artificiels** (digues, canaux, obstacles...),
+ * HYDRO : on crée ou importe des lignes de contour d'**objets naturels** (rivières, iles...)
+ et **artificiels** (digues, canaux, obstacles...),
- * HYDRO : on importe des champs de bathymétrie / altimétrie, ou des séries de profils de rivière,
+ * HYDRO : on importe des champs de bathymétrie / altimétrie, ou des séries de profils de rivière,
- * HYDRO : on constitue des objets naturels et artificiels,
+ * HYDRO : on constitue des objets naturels et artificiels,
+
+ * 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),
- * HYDRO : on constitue un **cas de calcul** en choisissant les objets utiles au cas,
+ * 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),
+ ce sont les faces de la géométrie finale SALOME), on associe au cas la Land Cover Map et la table de Strickler,
* HYDRO : on exporte le cas vers GEOM,
- * GEOM : on reprend le cas dans GEOM, pour compléter l'identification des groupes liés aux différentes régions du domaine
+ * 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,
* SMESH : on choisit les algorithmes et hypothèses de maillage, on calcule le maillage et exporte le fichier MED du maillage,
- * HYDRO : on calcule l'interpolation en Z, a partir du fichier MED et du cas de calcul,
+ * 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,
+
+ * 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,
+
+ * HYDROSOLVER : on définit les zones de conditions limites (fichier xxx.bcd)
- * HYDROSOLVEUR : on définit le paramétrage physico numérique du calcul (fichier cas),
+ * HYDROSOLVER : on definit les évolutions des valeurs des conditions limites au cours du temps (fichier xxx.lqd ?)
- * HYDROSOLVEUR : on exécute le calcul,
+ * HYDROSOLVER : on définit le paramétrage physico numérique du calcul (fichier cas),
+
+ * HYDROSOLVER : on exécute le calcul,
* PARAVIS : on dépouille les résultats
-Dans le module HYDRO lui-même, la logique d’enchaînement des étapes est la suivante
+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) :
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.
- * IMAGES :
+ * 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).
+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.
* BATHYMETRIE :
-Les bathymétries constituées de nuages de points et/ ou de profils qui constituent le modèle de terrain
+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.
* POLYLINES :
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.
+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.
* NATURAL OBJECTS :
* CALCULATION CASES :
-Lors de la définition du cas de calcul on sélectionne les objets à mailler et on résout les conflits
+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.
+-------------------------------------
+
+**Résumé des étapes :** également `disponible en pdf`__.
+
+.. _SALOME_Memo_pdf: SALOME_Memo.pdf
+
+__ SALOME_Memo_pdf_
+
+ |SALOME_Memo|
+
+
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
+* 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.
-
+
* Disposer des données de bathy au format ASCII.
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 de l'étude.
-L’idée est de partir d’images satellitaires et/ou de cartes de la zone à mailler,
+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.
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.
+**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 utiliser le menu *Hydro/change local CS* et renseigner les coordonnées de la nouvelle origine.
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
+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
+ * 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).
+ * 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).
- * 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
+ * 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 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
+ 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
Dessin de lignes
=================
-Les contours de type polyligne sont nécessaires à la création de la géométrie.
+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 afficher la bathymetrie ou les cartes lors de la saisie des contours pour se repérer.
+
+On peut afficher la bathymetrie ou les cartes lors de la saisie des contours pour se repérer.
polylines
---------
* polylignes (ligne brisée constituée d'une série de segments droits, pour décrire un objet géométrique)
- * splines (suite d’arcs qui donne une courbe à dérivée continue,
+ * 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).
L’utilisation de splines permet de définir des contours sans que le maillage qui s’appuie dessus
Le mode opératoire est détaillé dans l'exercice ci-dessous.
+Il est possible de créer des lignes combinant polylignes et splines.
+Voir plus loin le pararaphe de manipulation des polylignes.
+
profils de digue ou canal
--------------------------
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**.
-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)
+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.
- * Remarque : la bathymétrie est facultative dans la création des objets naturels, notamment dans le cas des îles.
+ * Remarque : la bathymétrie est facultative dans la création des objets naturels, notamment dans le cas des îles.
* 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.
Obstacles
============
-Objets géométriques complexes (bâtiments...) importés depuis GEOM,
+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.
Tables de coefficients de Strickler, Land Cover maps
====================================================
-A compléter, la prise en compte des coefficients de strickler et des Land Cover Maps n'est pas finalisée dans la version 1.0 de mars 2016.
+Il est possible définir une carte des coefficients de Strickler (frottements sur le fond) couvrant le domaine d'étude.
+
+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.
+
+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.
+
+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...
Constitution d'un cas de calcul
================================
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
+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).
L'emprise du domaine est définie par un contour polygonal particulier.
la bathymétrie.
Le résultat du découpage en zones des différents objets se chevauchant constitue l'opération dite de **partition**.
-
-On peut regrouper des zones en régions homogènes dans la structure du maillage visée,
+
+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.
Dans le cas de calcul, il est possible d'identifier certaines lignes qui serviront de support aux conditions limites.
Il faut activer ce module pour pouvoir visualiser et modifier le cas exporté.
-Dans GEOM, on voit notre cas de calcul sous le nom <nom de cas>_N auquel est attaché le (ou les) contour(s)
+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*.
+
+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.
Il se peut qu’on ait besoin d'identifier certaines parties :
Le mode opératoire est détaillé dans l'exemple plus bas.
* 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
+ 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.**
-
+
Maillage: Module SMESH
=======================
On se réferera aux formations SALOME pour l'utilisation du module SMESH.
-Le mode opératoire pour SALOME HYDRO est détaillé dans l'exemple plus bas.
+Le mode opératoire pour SALOME-HYDRO est détaillé dans l'exemple plus bas.
Interpolation en Z
===================
* à partir de la CAO des obstacles
-Pour les nuages de points, en version 1.0 on dispose d’un 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.
-
-L'amélioration de ce script est prévue dans les prochaines versions.
-
-Plusieurs approches possibles, quand la bathymétrie n'est pas assez dense par rapport au maillage :
-
- * densifier artificiellement la bathymétrie (interpolation linéaire, outils et scripts à proposer)
- * utiliser TELEMAC avec le mot clé FICHIER DES FONDS (il faut regrouper les bathymétries dans un fichier unique).
-
-L'amélioration du script est prévue en 2016.
+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.
Le mode opératoire est détaillé dans l'exemple plus bas.
Mise en données Physico-numérique pour TELEMAC
===============================================
-Cette mise en données fait intervenir le module HYDROSOLVEUR pour l'assemblage du cas de calcul.
+Cette mise en données fait intervenir le module HYDROSOLVER pour l'assemblage du cas de calcul.
description des conditions limites
----------------------------------
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 dont la syntaxe est donnée en exemple plus bas.
+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,
+
édition du fichier Cas
----------------------
-Les paramètres de calcul sont définis dans le fichier Cas avec la syntaxe TELEMAC 2D (avec un éditeur de texte standard).
+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).
-inventaire des fichiers utilisés
---------------------------------
+inventaire des fichiers utilisés par TELEMAC 2D
+-----------------------------------------------
A compléter, voir l'exemple ci-dessous.
Lancement et suivi du calcul
============================
-Le module HYDROSOLVEUR permet de lancer TELEMAC 2D.
+Le module HYDROSOLVER permet de lancer TELEMAC 2D.
Le mode opératoire est détaillé dans l'exemple plus bas.
Dépouillement des résultats
===========================
-Le module PARAVIS est utilisé pour l'exploitation des résultats.
-On se réferera aux formations SALOME pour l'utilisation du module PARAVIS.
+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
