5 .. index:: single: case
7 The definition of a case is done with the following data:
11 - The file of the initial mesh
12 - The type of conformity for the serie of adaptations
13 - Some curved boundaries
15 .. image:: images/create_case_1.png
21 A name is automatically suggested for the case: Case_1, Case_2, etc. This name can be modified. It must be a new name.
25 The directory will countain all the files producted by the successive adaptations. By default, nothing is suggested. The choice is made either by giving a name into the text zone or by a selection through the search window. In this directory, the MED files for the adapted mesh will be stored, with name ``maill.xx.med``, where ``xx`` is a rank number automatically created. These files can be seen into the object browser.
27 .. image:: images/create_case_2.png
30 .. index:: single: mesh;initial
31 .. index:: single: MED
35 The initial mesh must be stored into a MED file. Usually, it is produced by the software that solves the physical problem. But it also can be created by the module SMESH and exported with the MED format. The name of the file is choosen either by giving a name into the text zone or by a selection through the search window.
38 .. image:: images/create_case_3.png
42 Only one mesh into the file.
45 The initial mesh must not be itself the product of an adaptation by HOMARD. If it is, the coherence between the different levels of refinement will be lost.
48 .. index:: single: conformity
52 The future iterations for this case must respect the the same behaviour regarding the type of conformity.
54 The default option, 'conformal', implies that the meshes produced by HOMARD will be conformal, as expected in the finite element method. This is a classical choice for most of the simulation software with the finite element method.
56 Nevertheless, if the computation is available with non conformal meshes, 3 possibilities are available:
59 .. image:: images/create_case_4.png
62 * 1 node per element: an element must not have more than one hanging node with its neighbours.
63 * 1 node per edge: every single edge of an element ban be split once while its neighbour is not.
64 * free: no limit for the number of hanging node.
66 .. index:: single: boundary
70 If the limit of the domain is curved, HOMARD can put the new nodes onto these curved limits to avoid some artificial singularities. This technique is effective for external limits as well for internal limits.
74 * 1D curve: this curve may be defined into a plane, for example for a 2D calculation. It can also be defined into the 3D space, for example to describe the intersection of two surfaces. Such a line is defined with a discrete desription.
75 * a surface: such a surface is defined with an analytical description.
79 .. image:: images/create_case_5.png
82 The definition of the boundaries is described in :ref:`gui_create_boundary`.
84 .. index:: single: pyramid
88 Par défaut, aucune option avancée n'est active.
90 Néanmoins, on peut définir une oprion avancée :
92 .. image:: images/create_case_7.png
95 Par défaut, HOMARD sait traiter des maillages en 2 ou 3 dimensions et comportant les mailles suivantes :
104 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.
107 The pursuit of a case
108 *********************
109 .. index:: single: pursuit
110 .. index:: single: yacs
112 La poursuite d'un cas correspond à la situation suivante :
113 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.
115 La condition pour reprendre une itération est d'avoir conservé dans un même répertoire deux fichiers :
116 - 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)``
117 - 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``
119 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.
121 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 :
125 - Le répertoire qui contient les archives
127 .. image:: images/pursue_case_1.png
130 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.
132 .. image:: images/pursue_case_2.png
135 Si on souhaite partir d'une itération qui ne soit pas la dernière, il suffit de le préciser :
137 .. image:: images/pursue_case_3.png
141 Les paramétrages du cas ainsi créé sont ceux de l'itération poursuivie : mode de conformité identique par exemple.
146 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.
148 .. image:: images/create_case_6.png
153 Corresponding python functions
154 ******************************
155 Look :ref:`tui_create_case`