Salome HOME
mise a jour pour la poursuite d'iterations
[modules/homard.git] / doc / gui_create_case.rst
1 .. _gui_create_case:
2
3 La création d'un cas
4 ====================
5 .. index:: single: cas
6
7 La définition du cas se fait par la donnée des informations suivantes :
8
9   - Un nom
10   - Un répertoire
11   - Le fichier du maillage initial
12   - Le type de conformité pour la série d'adaptations envisagées
13   - Les éventuelles frontières courbes à respecter
14
15 .. image:: images/create_case_1.png
16    :align: center
17
18
19 Le nom du cas
20 """""""""""""
21 Un nom de cas est proposé automatiquement : Case_1, Case_2, etc. Ce nom peut être modifié. Il ne doit pas avoir déjà été utilisé pour un autre cas.
22
23 Le répertoire
24 """""""""""""
25 Le répertoire est celui qui contiendra les fichiers produits par les adaptations successives. Par défaut, rien n'est proposé. Le choix est fait, soit en tapant le nom dans la zone de texte, soit en activant la fonction de recherche. C'est dans ce répertoire que seront exportés les maillages au format MED, dans des fichiers de nom ``maill.xx.med``, où ``xx`` est un numéro d'ordre créé automatiquement. Ces fichiers seront visibles dans l'arbre d'études.
26
27 .. image:: images/create_case_2.png
28    :align: center
29
30 .. index:: single: maillage;initial
31 .. index:: single: MED
32
33 Le maillage initial
34 """""""""""""""""""
35 Le maillage initial doit se trouver dans un fichier au format MED. Classiquement, il aura été produit par le logiciel de calcul avec lequel on travaille. Mais il peut également avoir été créé avec le module SMESH et exporté au format MED. Le nom du fichier peut être fourni, soit en tapant le nom dans la zone de texte, soit en activant la fonction de recherche.
36
37 .. image:: images/create_case_3.png
38    :align: center
39
40 .. note::
41   Le fichier ne doit contenir qu'un seul maillage.
42
43 .. warning::
44   Le maillage ne doit pas être lui-même le produit d'une adaptation de maillage par HOMARD, sous peine de perdre la cohérence entre les différents niveaux de raffinement/déraffinement
45
46 .. index:: single: type de conformité
47
48 Le type de conformité
49 """""""""""""""""""""
50 Les itérations qui seront calculées pour ce cas devront toutes respecter le même comportement vis-à-vis de la conformité.
51
52 L'option par défaut, 'conforme', implique que les maillages produits par HOMARD seront conformes au sens des éléments finis. C'est le choix classique de la plupart des logiciels de simulation par éléments finis.
53
54 Néanmoins, si le calcul est possible avec des maillages non conformes, on a le choix entre 3 possibilités :
55
56 .. image:: images/create_case_4.png
57    :align: center
58
59 * 1 noeud par maille : une maille ne peut posséder qu'un seul noeud de non conformité avec ses voisines.
60 * 1 noeud par arête : chaque arête d'une maille peut être découpée sans que la maille voisine par cette arête ne le soit.
61 * quelconque : aucune limitation sur les raccords de conformité d'une maille à l'autre.
62
63 .. index:: single: frontière
64
65 Les frontières courbes
66 """"""""""""""""""""""
67 Quand le bord du domaine est courbe, HOMARD sait placer les nouveaux noeuds sur ces frontières pour éviter des singularités artificielles. Cette technique est aussi applicable à une courbure intérieure à un domaine.
68
69 Deux cas de figure sont présents :
70
71 * courbe 1D : cette courbe peut être définie dans un plan, par exemple pour un calcul 2D. Elle peut également être définie dans l'espace 3D, par exemple pour l'intersection de deux surfaces. Une ligne à suivre est décrite de manière discrète.
72 * surface : une surface à suivre est décrite de manière analytique.
73
74 On cochera le ou les boutons voulus :
75
76 .. image:: images/create_case_5.png
77    :align: center
78
79 La définition des frontières est décrite dans :ref:`gui_create_boundary`.
80
81 .. index:: single: pyramide
82
83 Les options avancées
84 """"""""""""""""""""
85 Par défaut, aucune option avancée n'est active.
86
87 Néanmoins, on peut définir une oprion avancée :
88
89 .. image:: images/create_case_7.png
90    :align: center
91
92 Par défaut, HOMARD sait traiter des maillages en 2 ou 3 dimensions et comportant les mailles suivantes :
93    - mailles-points
94    - segments
95    - triangles
96    - quadrangles
97    - tétraèdres
98    - hexaèdres
99    - prismes
100
101 Si le maillage initial comporte des pyramides, il y a arrêt en erreur. Toutefois, si on est certain que les raffinements ultérieurs ne toucheront aucune des arêtes des pyramides, on cochera la case "Pyramides autorisées". Les adaptations se dérouleront normalement et les pyramides seront restituées telles quelles dans le maillage final.
102
103
104 La poursuite d'un cas
105 =====================
106 .. index:: single: poursuite
107
108 La poursuite d'un cas correspond à la situation suivante :
109 Une série d'adaptations ont été conduites sur un cas puis Salome est fermé. On a gardé les répertoires de travail de ces itérations. On souhaite ensuite reprendre ces itérations pour les poursuivre là où on s'est arrêté. Cette fonctionnalité est particulièrement utile dans le cas de schémas YACS pour lesquels on scinde en plusieurs parties une longue série d'adaptations.
110
111 La condition pour reprendre une itération est d'avoir conservé dans un même répertoire deux fichiers :
112    - le fichier de configuration qui a servi de données au module exécutable de HOMARD ; ce fichier se présente sous la forme ``HOMARD.Configuration.(n).vers.(n+1)``
113    - le fichier au format MED qui conserve l'historique des adaptations réalisées ; ce fichier se présente sous la forme ``maill.(n).hom.med``
114
115 On peut choisir de partir d'une itération archivée désignée explicitement par son répertoire ou d'une itération repérée dans le répertoire archivant un cas.
116
117 Pour poursuivre une itération connue par son répertoire d'archive, la définition du cas se fait par la donnée des informations suivantes :
118
119   - Un nom
120   - Un répertoire
121   - Le répertoire qui contient les archives
122
123 .. image:: images/pursue_case_1.png
124    :align: center
125
126 On peut choisir de partir d'un cas déjà calculé ; par défaut, le nouveau cas sera créé en partant de la dernière itération précédemment calculée.
127
128 .. image:: images/pursue_case_2.png
129    :align: center
130
131 Si on souhaite partir d'une itération qui ne soit pas la dernière, il suffit de le préciser :
132
133 .. image:: images/pursue_case_3.png
134    :align: center
135
136 .. note::
137   Les paramétrages du cas ainsi créé sont ceux de l'itération poursuivie : mode de conformité identique par exemple.
138
139
140 L'arbre d'étude
141 """""""""""""""
142 A l'issue de cette création de cas, l'arbre d'études a été enrichi de ce nouveau cas. On y trouve l'itération initiale, identifiée par le nom du maillage qui a été lu dans le fichier fourni.
143
144 .. image:: images/create_case_6.png
145    :align: center
146
147
148
149 Méthodes python correspondantes
150 """""""""""""""""""""""""""""""
151 Consulter :ref:`tui_create_case`
152