Salome HOME
Revert "Synchronize adm files"
[modules/homard.git] / doc / fr / 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/intro_32.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 .. _options_avancees:
84
85 Les options avancées
86 ********************
87 Par défaut, aucune option avancée n'est active.
88
89 Néanmoins, on peut définir une option avancée :
90
91 .. image:: images/create_case_7.png
92    :align: center
93
94 Par défaut, HOMARD sait traiter des maillages en 2 ou 3 dimensions et comportant les mailles suivantes :
95    - mailles-points
96    - segments
97    - triangles
98    - quadrangles
99    - tétraèdres
100    - hexaèdres
101    - prismes
102
103 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.
104
105
106 La poursuite d'un cas
107 *********************
108 .. index:: single: poursuite
109 .. index:: single: YACS
110
111 La poursuite d'un cas correspond à la situation suivante :
112 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.
113
114 La condition pour reprendre une itération est d'avoir conservé dans un même répertoire deux fichiers :
115    - 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)``
116    - 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``
117
118 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.
119
120 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 :
121
122   - Un nom
123   - Un répertoire
124   - Le répertoire qui contient les archives
125
126 .. image:: images/pursue_case_1.png
127    :align: center
128
129 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.
130
131 .. image:: images/pursue_case_2.png
132    :align: center
133
134 Si on souhaite partir d'une itération qui ne soit pas la dernière, il suffit de le préciser :
135
136 .. image:: images/pursue_case_3.png
137    :align: center
138
139 .. note::
140   Les paramétrages du cas ainsi créé sont ceux de l'itération poursuivie : mode de conformité identique par exemple.
141
142
143 L'arbre d'étude
144 ***************
145 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.
146
147 .. image:: images/create_case_6.png
148    :align: center
149
150
151
152 Méthodes python correspondantes
153 *******************************
154 Consulter :ref:`tui_create_case`
155