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/intro_32.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 :doc:`gui_create_boundary`.
84 .. index:: single: pyramid
88 Default: no advanced option.
90 Nevertheless, some advanced options can be defined :
92 .. image:: images/create_case_7.png
95 HOMARD is able to work with 2D or 3D meshes as well, including the following elements:
104 If pyramids are present into the initial mesh, HOMARD stops with an error. However, if no refinement will be in contact with any edge of those pyramids, the "Authorized pyramids" whould be checked. The adaptation will go on and the pyramids will be back as they are into the initial mesh.
106 The pursuit of a case
107 *********************
108 .. index:: single: pursuit
109 .. index:: single: YACS
111 The pursuit of a case is interesting in the following situation. A list of adaptations was done for a case and, at the end, SALOME is closed. The directories for these iterations are kept. Then, the user wants to go on these iterations from the final point of the previous list. This function is useful with a schema YACS if a long list of adaptations is cut into small parts.
113 The compulsatory condition to pursue an iteration is to keep two files into the same directory:
114 - the configuration file that was a data for the binary module of HOMARD; this file looks like ``HOMARD.Configuration.(n).vers.(n+1)``
115 - the MED file that saves the history of th eprevious adaptations; this file looks like ``maill.(n).hom.med``
117 Either an iteration known by its directory or an iteration identified into the directory of a case can be selected.
119 To pursuit of an iteration known by its directory, the definition of the case is made by the following data:
123 - The directory of the data base
125 .. image:: images/pursue_case_1.png
128 The pursuit of an iteration into a previous case can be operated; the default starting iteration is the last iteration of the case.
130 .. image:: images/pursue_case_2.png
133 If the starting iteration is not the last one, its number must be given:
135 .. image:: images/pursue_case_3.png
139 The governing parameters of the created case are the same as the ones of the strating iteration: same mode for the conformity, for instance.
144 At the end of the creation, the case is included into the object browser. The initial iteration, known by the name of the associated mesh, is shown.
146 .. image:: images/create_case_6.png
151 Corresponding python functions
152 ******************************
153 Look :doc:`tui_create_case`