Salome HOME
Merge branch 'pre/V8_3_BR_izf' into pre/V8_3_BR
[modules/hydro.git] / doc / salome / tutorial / miseEnDonneesTelemac.rst
index 7b25c103757c17951e6235f9cf4b5aa743257792..bd36ab5fd3252003b6b29a72c8e9560b8ef172c8 100644 (file)
 Mise en données TELEMAC
 #########################################
 
+.. |HYDROSolver| image:: /_static/HYDROSolver.png
+   :align: middle
+   :width: 16pt
+   :height: 16pt
+
+.. |eficas_04| image:: /_static/eficas_04.png
+   :align: middle
+   :width: 16pt
+   :height: 16pt
+
 .. |genereCondlim| image:: /_static/genereCondlim.png
    :align: middle
+   
+.. |eficas_01| image:: /_static/eficas_01.png
+   :align: middle
+   
+.. |eficas_02| image:: /_static/eficas_02.png
+   :align: middle
+   
+.. |eficas_03| image:: /_static/eficas_03.png
+   :align: middle
+   
+.. |eficas_20| image:: /_static/eficas_20.png
+   :align: middle
+   
+.. |eficas_21| image:: /_static/eficas_21.png
+   :align: middle
+   
+.. |eficas_22| image:: /_static/eficas_22.png
+   :align: middle
+   
+.. |eficas_23| image:: /_static/eficas_23.png
+   :align: middle
 
 Une fois le maillage généré avec l'altimétrie, il reste à définir la nature des zones de conditions limites,
 les valeurs des conditions limites de débit et de hauteur d'eau au cours du temps, et l'ensemble des
@@ -32,6 +63,10 @@ Ces informations sont regroupées dans plusieurs fichiers de texte (ASCII) à g
 
 **Ces différents fichiers seront rangés dans le même répertoire que le maillage.**
 
+Il faut activer le module HYDROSOLVER, via la liste défilante des modules, ou son icône dans le bandeau : |HYDROSolver|.
+Le module HYDROSOLVER prend en charge la mise en donnée physico-numérique et les calculs pour les codes
+Telemac et Mascaret ainsi que leur couplages.
+
 Caractérisation des zones de conditions limites
 ===============================================
 
@@ -84,7 +119,110 @@ De même que précédemment, il faut se reporter au manuel de Telemac pour la d
 
 .. literalinclude:: init.cas
     :lines: 1-
- 
+
+Edition du fichier cas avec EFICAS
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+Il existe 2 méthodes pour réaliser cette action, avec le module *HYDROSOLVER* : 
+
+* **avec les menus :** dans le menu HYDRO, cliquer sur *Edit cas file*
+
+  |eficas_01|
+
+* **avec les icônes :** quand on active le module Hydrosolver, de nouveaux boutons apparaissent dans la barre d’outils.
+  Cliquer à droite sur Edit cas file
+  
+  |eficas_02|
+  
+Cliquer sur New pour créer un fichier cas. 
+  
+  |eficas_03|
+  
+Renseigner ce qui est rouge. Quand une sous-rubrique ou rubrique est complète elle passe au vert.
+Ce qui est en vert est rempli par défaut mais l’utilisateur a la main dessus.
+Penser à enregistrer régulièrement le cas créé. Pour cela, aller dans *File / Save* ou *Save as*, 
+ou cliquer sur l’icône |eficas_04| le fichier sera enregistré en *.comm* ou *.jdc*.
+
+Comment fonctionne EFICAS ?
+~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+Quand on se place dans l’interface centrale, au niveau de la rubrique, dans la partie de droite intitulée Settings *NOM DE RUBRIQUE*,
+apparaissent des mots clés facultatifs que l’on peut rajouter dans la sous-rubrique correspondante,
+en double cliquant sur le carré devant le mot clé.
+
+**Exemple :** je souhaite rajouter le mot clé *Control_section* dans *Output_Files*. Je double-clique dessus à droite :
+  
+  |eficas_20|
+
+Il apparaît alors dans la sous-rubrique *Output_Files*. Si je me place dessus dans l’écran central, 
+j’ai d’autres mots clés qui se présentent à moi dans la partie de droite sous le titre 
+*Control_Section* que je peux rajouter de la même manière.
+
+  |eficas_21|
+  
+Il est également possible d’avoir l’aide du mot clé en direct. Pour cela, il suffit de se placer sur le mot clé et l’aide apparaît :  
+
+  |eficas_22|
+
+Si on clique sur le mot clé avec la souris l’aide apparaît en bas à gauche :
+
+  |eficas_23|
+
+**Rangement des paramètres par rubriques et sous-rubriques**
+
+Dans *Computation_Environment*, on retrouve par défaut :
+
+ * *Initialization* : concerne les fichiers de données d’entrée comme le fichier de géométrie et le fichier des conditions limites.
+   Pour prendre en compte le titre, taper le nom souhaité et faites entrer.
+   
+ * *Restart* : pour repartir d’un calcul précédent
+ * *Output_files* : concerne les fichiers résultats, le listing et leurs caractéristiques.
+
+Dans *Hydro*, on retrouve par défaut :
+
+ * *Boundary_Conditions* : concerne les fichiers de condition limites
+   (fichier des frontières liquides, fichier des courbes de tarage, cote ou débit imposé…)
+   
+ * *Physical_Parameters_Hydro* : concerne le frottement. L’utilisateur peut rajouter ce qui concerne les vagues,
+   la météorologie, les sources, la qualité d’eau…
+   
+ * *Numerical_Parameters_Hydro* : concerne les équations utilisées, le traitement du système linéaire.
+
+Dans General_Parameters, on retrouve par défaut :
+
+ * *Debugger* : en mode debugger ou non
+
+ * *Time* : concerne le pas de temps, durée de la simulation….
+ * *Location* : concerne l’origine des coordonnées…
+
+Dans Numerical_Parameters, on retrouve par défaut :
+
+ * *Solver_Info* : concerne le solveur
+
+ * *Discretizations_Implicitation* : concerne l’implicitation de la hauteur, de la vitesse, la discrétisation en espace…
+
+ * *Propagation_Info*
+
+ * *Advection_Info* : concerne le mass lumping, la compatibilité du gradient de surface libre…
+
+ * *Diffusion* : concerne la diffusion des vitesses, l’option pour la diffusion des vitesses…
+
+ * *Automatic_Differentiation*
+
+ * *Advanced* : concerne le stockage de matrice, le produit vecteur-matrice…
+
+**Développement à venir**
+
+A terme, l’utilisateur pourra choisir parmi des « fichiers cas modèles » pré-remplis. On trouvera parmi ceux-ci : 
+
+ * un fichier cas modèle inondation,
+
+ * un fichier cas modèle maritime,
+
+ * un fichier cas modèle thermique.
+
 .. only:: html
  
    :ref:`ref_exempleInondation`