Salome HOME
Merge branch 'BR_2018_V8_5' into BR_PY3
[modules/hydro.git] / doc / salome / tutorial / preliminaires.rst
index 9b7bb11c6197a985145992ac0ad8dc04b806e639..51b9bc8dfe72348f59abce7d2b4b71b7ae0999fd 100644 (file)
@@ -67,6 +67,9 @@ 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
@@ -88,107 +91,10 @@ L’étude se déroulera en passant par les différents modules de SALOME :
 
  * PARAVIS
 
-Fonctionnement :
-
-.. table:: Principales étapes de la construction d'un cas (exemple simple d'inondation)
-   :widths: 10, 20, 30, 140
-
-+-------------+------------+-------------------+------------------------------------------------------------------+
-| 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                                 |
-+-------------+------------+-------------------+------------------------------------------------------------------+
-| **HYDROSOLVER** (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   |                                                                  |
-+-------------+------------+-------------------+------------------------------------------------------------------+
-| **HYDROSOLVER** (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                                      |
-+-------------+------------+-------------------+------------------------------------------------------------------+
+-------------------------------------
 
+**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...)
@@ -270,6 +176,17 @@ Il s’agit de construire des éléments tels que des digues ou des canaux de g
 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
 ==================
 
@@ -558,7 +475,8 @@ Dans le module HYDROSOLVER, un outil permet d'associer des types de condition li
 é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 par TELEMAC 2D
 -----------------------------------------------
@@ -576,4 +494,5 @@ 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.
+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