Salome HOME
Small fix to make it working with -j make option
[modules/homard.git] / doc / gui_create_iteration_en.rst
1 .. _gui_create_iteration_en:
2
3 The iteration
4 =============
5 .. index:: single: iteration
6
7 La définition d'une iteration se fait par la donnée des informations suivantes :
8
9   - L'iteration précédente
10   - Le nom du maillage résultat
11   - L'hypothesis utilisée
12   - Eventuellement, le fichier du champ d'indicateurs d'erreur
13
14 .. image:: images/create_iteration_1.png
15    :align: center
16
17 Name of the iteration
18 """""""""""""""""""""
19 Un nom de cas est proposé automatiquement : Iter_1, Iter_2, etc. Ce nom peut être modifié. Il ne doit pas avoir été utilisé pour une iteration précédente.
20
21 The previous iteration
22 """"""""""""""""""""""
23 L'iteration précédente est choisie dans l'arbre d'étude. Le nom du maillage correspondant sera affiché.
24
25 .. index:: single: mesh;result
26
27 The name of the resulting mesh
28 """"""""""""""""""""""""""""""
29 L'iteration en cours de création produira un maillage. Ce maillage sera connu sous un nom. Ce nom est fourni en le tapant dans la zone de texte. Par défaut, on propose un nom identique à celui de l'iteration précédente.
30
31 .. index:: single: field
32 .. index:: single: MED
33
34 The field
35 """""""""
36 Pour créer ou utiliser une hypothesis d'adaptation basée 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.
37
38
39 .. image:: images/create_iteration_2.png
40    :align: center
41
42 Dans le cas où des pas de temps ont été définis, une solution simple consiste à traiter les champs au dernier pas de temps enregistré dans le fichier. Si on veut définir un autre pas de temps, on coche le bouton "*Pas de temps choisi*". Les valeurs de 'Pas de temps' et de 'Numéro d'ordre' sont celles correspondant à la convention MED (time step / rank). Ces valeurs dépendent de la logique qui a été retenue par le logiciel qui a écrit le fichier. Souvent ces deux valeurs sont identiques mais il arrive que l'on disjoigne les pas de temps et les intervalles d'archivage.
43
44 .. image:: images/create_iteration_3.png
45    :align: center
46
47 .. index:: single: hypothesis
48
49 The hypothesis
50 """"""""""""""
51 L'iteration en cours pilotera l'adaptation par HOMARD selon un scénario défini dans une hypothesis. Celle-ci est choisie dans la liste des hypothesiss existantes.
52
53 Au démarrage, il faut créer une première hypothesis par activation du bouton "*Nouveau*" (voir :ref:`gui_create_hypothese_en`) :
54
55 .. image:: images/create_iteration_4.png
56    :align: center
57
58 Ensuite, si une hypothesis précédemment définie convient, il suffit de la sélectionner dans la liste proposée. Sinon, il faut créer une nouvelle hypothesis par activation du bouton "*Nouveau*", puis la sélectionner dans la liste proposée :
59
60 .. image:: images/create_iteration_5.png
61    :align: center
62
63
64 .. note::
65   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 créer une nouvelle hypothesis.
66
67 .. index:: single: object browser
68
69 Object browser
70 """"""""""""""
71 A l'issue de cette création d'iteration, l'arbre d'études a été enrichi. On y trouve l'iteration initiale, identifiée par le nom du maillage qui a été lu dans le fichier fourni, l'iteration courante, identifiée par son nom. On trouve aussi l'hypothesis qui lui est attachée. L'icône en regard de l'iteration permet de différencier les iterations calculées ou non.
72
73 .. image:: images/create_iteration_6.png
74    :align: center
75
76 Quand plusieurs iterations s'enchaînent, leur hypothesis est visible dans l'arbre d'étude. On remarquera dans la figure ci-après que deux iterations peuvent partager la même hypothesis.
77
78 .. image:: images/create_iteration_7.png
79    :align: center
80
81 Corresponding python functions
82 """"""""""""""""""""""""""""""
83 Look :ref:`tui_create_iteration_en`