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
+
+.. |salomeShell| image:: /_static/salomeShell.png
+ :align: middle
+
+.. |initialisationHauteurEau| image:: /_static/initialisationHauteurEau.png
+ :align: middle
+
+.. |choixCodeEficas| image:: /_static/choixCodeEficas.png
+ :align: middle
+
+.. |rechercheEficas| image:: /_static/rechercheEficas.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) que nous allons éditer manuellement
-(des outils d'aide à la saisie de de ces paramètres sont en cours de développement et devraient être disponibles fin 2016).
+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
===============================================
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 chemin du fichier des zones de conditions limites.
+L'entrée *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.
+* **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
========================================================
.. literalinclude:: init.lqd
:lines: 1-
+Ajout d'un champ initial dans le fichier MED
+============================================
+
+Afin d'initialiser le calcul, on peut utiliser le script suivant pour imposer une hauteur
+d'eau initiale ou une cote initiale dans les groupes de faces qui nous intéressent,
+en l'occurence, ici, dans le lit mineur.
+
+.. literalinclude:: add_field_h_on_group.py
+ :lines: 1-
+
+Il suffit de remplir :
+
+ * le nom du fichier MED,
+ * le nom du maillage (dans le module SMESH) à partir duquel il a été construit,
+ * les groupes de faces auxquels on souhaite ajouter une cote ou une hauteur d'eau initiale,
+ * le nom du champ ajouté (*WATER_DEPTH* ou *WATER ELEVATION*).
+
+Pour lancer le script :
+
+ * ouvrir un SALOME shell.
+
+ |salomeShell|
+
+ * se placer dans le répertoire où l'on a rangé le script *add_field_h_on_group.py*,
+
+ * exécuter le script : *python add_field_h_on_group.py*.
+
+Le champ *hauteur d'eau* est ajouté au fichier MED. Penser à enregistrer le fichier précédent
+(comprenant Z et Ks) sous un autre nom pour le conserver pour réutilisation en cas de besoin.
+
+ |initialisationHauteurEau|
+
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.
+Le fichier *CasGaronne.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.
-.. literalinclude:: init.cas
+Voici la version générée avec EFICAS (voir ci-dessous l'utilisation d'EFICAS)
+
+.. literalinclude:: CasGaronne.cas
+ :lines: 1-
+
+Et la version plus légère, ou seuls figurent les mots clefs différents de leur valeur par défaut.
+
+.. literalinclude:: CasGaronne.Lcas
: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.
+
+Sélectionner le code souhaité : dans notre cas, *telemac2d*.
+
+ |choixCodeEficas|
+
+ |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*.
+
+Les puces vertes sont de deux couleurs :
+
+ * Quand la valeur renseignée est la valeur par défaut, la puce est vert foncé.
+ * Quand la valeur renseignée est différente de la valeur par défaut, la puce est vert clair.
+
+Comment fonctionne EFICAS ?
+~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+**remarque** : Pour chercher où est rangé un mot clé, aller dans le menu *Edit / Find Keyword*.
+
+La fenêtre suivante donne l'emplacement du mot clé ainsi que la documentation associée.
+
+ |rechercheEficas|
+
+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`
