.. _gui_create_iteration:

L'itration
===========
.. index:: single: itration
La dfinition d'une itration se fait par la donne des informations suivantes :

  - L'itration prcdente
  - Le nom du maillage rsultat
  - L'hypothse utilise
  - Eventuellement, le fichier du champ d'indicateurs d'erreur

.. image:: images/create_iteration_1.png
   :align: center


Le nom de l'itration
"""""""""""""""""""""
Un nom de cas est propos automatiquement : Iter_0, Iter_1, etc. Ce nom peut tre modifi. Il ne doit pas avoir t utilis pour une itration prcdente.

L'itration prcdente
""""""""""""""""""""""
L'itration prcdente est choisie dans l'arbre d'tude. Le nom du maillage correspondant sera affich.

.. index:: single: maillage;rsultat
Le nom du maillage rsultat
"""""""""""""""""""""""""""
L'itration en cours de cration produira un maillage. Ce maillage sera connu sous un nom. Ce nom est fourni en le tapant dans la zone de texte. Par dfaut, on propose un nom identique  celui de l'itration prcdente.

.. index:: single: champ
.. index:: single: MED
Le champ
""""""""
Pour crer ou utiliser une hypothse d'adaptation base sur un champ exprim sur le maillage, on doit fournir le fichier o se trouve le champ. C'est galement le cas si on veut interpoler des champs du maillage n au maillage n+1. Ce fichier est au format MED. Classiquement, il aura t produit par le logiciel de calcul avec lequel on travaille. Le nom du fichier peut tre fourni, soit en tapant le nom dans la zone de texte, soit en activant la fonction de recherche.


.. image:: images/create_iteration_2.png
   :align: center

Dasn le cas o des pas de temps ont t dfinis, une solution simple consiste  traiter les champs au dernier pas de temps enregistr dans le fichier. Si on veut dfinir un autre pas de temps, on coche le bouton "Choosen time step" ; les valeurs de 'Time Step' et de 'Rank' sont celles correspondant  la convention MED.

.. image:: images/create_iteration_3.png
   :align: center

.. index:: single: hypothse
L'hypothse utilise
""""""""""""""""""""
L'itration en cours pilotera l'adaptation par HOMARD selon un scnario dfini dans une hypothse. Celle-ci est choisi dans la liste des hypothses existantes.

Au dmarrage, il faut crer une premire hypothse par activation du bouton 'New' (voir :ref:`gui_create_hypothese`) :

.. image:: images/create_iteration_4.png
   :align: center

Ensuite, il faut ventuellement crer une nouvelle hypothse par activation du bouton 'New', puis slectionner celle voulue dans la liste propose :

.. image:: images/create_iteration_5.png
   :align: center


.. note::
  Si on envisage une adaptation selon les valeurs d'un champ sur le maillage, il faut avoir renseign les informations sur ce champ avant de crer une nouvelle hypothse.

.. index:: single: arbre d'tude
L'arbre d'tude
"""""""""""""""
A l'issue de cette cration d'itration, l'arbre d'tudes a t enrichi. On y trouve l'itration initiale, identifie par le nom du maillage qui a t lu dans le fichier fourni, l'itration courante, identifie par son nom. On trouve aussi l'hypothse qui lui est attache.

.. image:: images/create_iteration_6.png
   :align: center

Quand plusieurs itrations s'enchanent, leur hypothse est visible dans l'arbre d'tude. On remarquera dans la figure ci-aprs que deux itrations peuvent partager la mme hypothse.

.. image:: images/create_iteration_7.png
   :align: center



