Salome HOME
Merge branch 'pre/V8_3_BR_izf' into pre/V8_3_BR
[modules/hydro.git] / doc / salome / tutorial / miseEnDonneesTelemac.rst
index 6a7bca3729d5effa9f742662e6de5009f04214b9..bd36ab5fd3252003b6b29a72c8e9560b8ef172c8 100644 (file)
 Mise en données TELEMAC
 #########################################
 
-blabla.
+.. |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
+paramètres physiques et numériques du calcul.
+Il faut se reporter au manuel de Telemac pour la définition de ces différents paramètres.
+
+Ces informations sont regroupées dans plusieurs fichiers de texte (ASCII) à générer ou éditer manuellement.
+
+**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
+===============================================
+
+Les zones de conditions limites ont été définies dans les étapes précédentes,
+et sont concrétisées par des groupes nommés d'éléments dans le maillage.
+
+Le fichier *condlim.bcd* associe à chaque groupe ses caractéristiques :
+entrée, sortie, paroi... Quatre valeurs entières définissent un type de condition limite.
+
+La première ligne indique le nombre de conditions limites définies, il y a ensuite une ligne par condition limite.
+Chaque ligne comprend 4 entiers (le type) et le nom du groupe.
+
+Nous pouvons générer le fichier à partir de la commande *Edit boundary conditions file* du module *HYDROSOLVER*.
+
+Il faut définir en entrée le chemin du fichier MED utilisé, et en sortie, le chemind du fichier des zones de conditions limites.
+L'entree *Boundary condition file* ne sert que pour lire un fichier existant.
+
+Il faut sélectionner le type de condition limite sur les zones amont, aval, bord gauche et droit, et ne rien mettre sur les autres groupes.
+
+  |genereCondlim|
+  
+Le fichier résultat ressemble à ceci :
+
+.. literalinclude:: condlim.bcd
+    :lines: 1-
+
+* **Remarque** : Il n'est plus nécessaire de créer le fichier *.cli* prévu dans le manuel de Telemac, 
+  qui liste l'ensemble des noeuds de conditions limites avec les types associés. Ce fichier est généré
+  automatiquement.
+
+Valeurs des conditions limites de débit et hauteur d'eau
+========================================================
+
+Le fichier *init.lqd* donne les valeurs des conditions limites de débit et de hauteur d'eau au cours du temps.
+Il faut se reporter au manuel de Telemac pour sa définition précise.
+
+.. literalinclude:: init.lqd
+    :lines: 1-
+
+Paramètres physiques et numériques du calcul
+============================================
+
+Le fichier *init.cas* liste les autres fichiers, qui doivent être dans le même répertoire.
+Il donne ensuite les différents paramètres physico-numériques nécessaires au calcul.
+De même que précédemment, il faut se reporter au manuel de Telemac pour la définition de ces paramètres.
+
+* **Remarque importante** : pour la version 1.0 de mars 2016, la présence d'un fichier Fortran est obligatoire,
+  même si celui-ci ne comprend qu'une ligne de commentaire (il faut forcer la recompilation de l'éxécutable TELEMAC).
+  Dans le fichier *init.cas*, Il faut enlever le commentaire devant le mot clé *FICHIER FORTRAN* et créer le fichier correspondant.
+
+.. 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`