Salome HOME
aaac4a777aebb3cafe84ee0996074e633efdcfd9
[modules/homard.git] / doc / gui_create_case.rst
1 .. _gui_create_case:
2
3 Le 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. Ce répertoire doit exister. Par défaut, Salome propose ``/tmp``. Ce choix peut être modifié, 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 noms de 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 L'arbre d'étude
104 """""""""""""""
105 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.
106
107 .. image:: images/create_case_6.png
108    :align: center
109
110
111
112 Méthodes python correspondantes
113 """""""""""""""""""""""""""""""
114 Consulter :ref:`tui_create_case`
115