Salome HOME
essai tableau simple, pas concluant
[modules/hydro.git] / doc / salome / tutorial / preliminaires.rst
index b0dec6215cf4fa0079193836b7ccb04225dd1704..1a43d2cb1432cb84f9bc73913913da0c3cdea849 100644 (file)
@@ -24,8 +24,8 @@ Notions préliminaires
    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.
@@ -36,7 +36,7 @@ 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**.
-   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.
@@ -52,6 +52,12 @@ Notions préliminaires
    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.
+   
+ * **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.
 
 
 ################################################
@@ -84,6 +90,72 @@ L’étude se déroulera en passant par les différents modules de SALOME :
 
 Fonctionnement :
 
+  =============  ============  ===================  ================================================================== 
+  Module         Rubrique      Action / Menu        Détail                                                            
+  =============  ============  ===================  ================================================================== 
+  **HYDRO**      \             \                    \                                                                    
+  \              IMAGES        Import images        - Positionnement des cordonnées                                   
+                                                    - Définition d’un repère local                                    
+  \              BATHYMETRY    Import bathymetry    \                                                                  
+  \              POLYLINES     Create Polyline      Construction des lignes pour l’étude : 
+                           
+                                                    - contour fermé débordant du domaine = « lit mineur »,            
+                                                    - contour fermé « lit majeur » contenant le champ de topo         
+                                                      à utiliser,                                                     
+                                                    - contour fermé, en ligne brisée,= « limite du domaine            
+                                                      d’étude » (qui inclut les frontières amont et aval)             
+  \              NATURAL       Create immersible    Définition de 3 zones immersibles : lit mineur, lit majeur et     
+                 OBJECTS       zone                 domaine d’étude. Définition de la bathymétrie associée            
+  \              STRICKLER     Import Strickler     \                                                                  
+                 TABLE         table                                                                                 
+  \              LAND COVER    Import Land Cover    \                                                                  
+                 MAP           Map                                                                                   
+  \              CALCULATION   Create               - Choix de la limite du domaine,                                  
+                 CASE          calculation case     - objets à conserver,                                             
+                                                    - sélection de la table de Strickler et de la Land Cover Map,     
+                                                    - choix de la bathymétrie pour les zones de chevauchement,        
+                                                    - regroupement des zones dans des régions                         
+  \              \             Export               Cette opération crée la géométrie avec les groupes de faces       
+                               calculation case     et de nœuds correspondant aux régions à mailler                   
+  **GEOM**       \             \                    \                                                   
+  \              Geometry      Create Group         - Création de groupes de type « edge » pour les bords du domaine  
+                                                      sur lesquels seront appliquées les conditions limites           
+                                                    - Création de groupes de type « face » si nécessaires             
+  **SMESH**      \             \                    Sélectionner la géométrie 
+  \              Mesh          Create Mesh          Choix de l’algorithme de maillage et hypothèses de maillage       
+  \              \             Create sub mesh      Create sub mesh                                                   
+                                                    (ici maillage particulier pour le lit mineur),                    
+                                                    donner les priorités concernant l’ordre de maillage               
+                                                    des différents maillages et sous-maillages                        
+  \              \             Compute              Génération du maillage                                            
+  \              \             Modification         Pour réorienter les mailles pour TELEMAC                          
+                               Orientation                                                                           
+  \              \             Controls             Contrôle des triangles surcontraints et modification si besoin    
+  \              \             Create Groups        Définition des groupes dans le  maillage                          
+                               from Geometry                                                                         
+  \              \             File / Export        Export du maillage au format MED                                  
+  **HYDROSOL**   \             \                    (il faut avoir activé HYDRO avant cette étape pour que les 
+                                                    données soient chargées)              
+  \              \             Generate             Génération du script pour l'interpolation en z aux noeuds du      
+                               Interpolz.py         maillage, puis exécution du script (File / Load Script)           
+  \              \             \                    Création et exécution du script qui construit le champ de         
+                                                    Strickler aux noeuds du maillage                                  
+  **MED**        \             \                    (optionnel, pour contrôles rapides)  
+  \              \             File /               Contrôle des champs d'altitude et de coefficients de Strickler    
+                               Add data Source                                                                       
+  **HYDROSOL**   \             \                    (il faut avoir activé HYDRO avant cette étape pour que les
+                                                    données soient chargées)              
+  \              \             Edit boundary        Génération du fichier de conditions limites (xxx.bcd)             
+                               conditions file                                                                       
+  \              \             \                    Fichier d'évolutions temporelle des conditions limites (xxx.lqd)  
+  \              \             Edit cas file        Edition du fichier cas (mise en données Telemac                   
+  \              \             Create case for      Procédure de lancement Télemac (chemin fichier cas)               
+                               Pytel execution                                                                       
+  \              \             Compute case         Exécution de Telemac                                              
+  **PARAVIS**    \             \                    \                                                                   
+  \              \             \                    Dépouillement des résultats                                       
+  =============  ============  ===================  ================================================================== 
  * 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...)
@@ -92,11 +164,14 @@ Fonctionnement :
  * 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 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,
    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,
 
@@ -105,11 +180,19 @@ Fonctionnement :
 
  * 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,
 
- * HYDROSOLVEUR : on définit le paramétrage physico numérique du calcul (fichier cas),
+ * 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,
 
- * HYDROSOLVEUR : on exécute le calcul,
+ * HYDROSOLVER : on définit les zones de conditions limites (fichier xxx.bcd)
+
+ * HYDROSOLVER : on definit les évolutions des valeurs des conditions limites au cours du temps (fichier xxx.lqd ?)
+
+ * 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
 
@@ -167,6 +250,9 @@ données préalables
 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
 ================
 
@@ -180,7 +266,7 @@ Les manipulations d'images sont introduites dans l'exercice plus bas.
 Choix d'un repère local
 =======================
 
-Il est vivement conseillé de changer l’origine du système de coordonnées 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.
 
 Pour cela il faut utiliser le menu *Hydro/change local CS* et renseigner les coordonnées de la nouvelle origine.
@@ -214,7 +300,7 @@ ne sont pas fournis avec cette version, is nécesitent des adaptations au cas pa
  * 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 sils 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.
@@ -278,6 +364,9 @@ ne s’accroche à tous les points de la ligne : seule la forme générale compt
 
 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
 --------------------------
 
@@ -367,6 +456,9 @@ Une fois le cas de calcul terminé et exporté il apparaît dans le module GEOM.
 
 Il faut activer ce module pour pouvoir visualiser et modifier le cas exporté.
 
+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.
 
@@ -390,7 +482,7 @@ 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
 ===================
@@ -410,7 +502,8 @@ Le calcul de la bathymétrie est fait zone par zone, a chaque zone est associé
 
  * à 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.
+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.
 
@@ -419,28 +512,30 @@ 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).
 
-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.