doc/en/gui_create_case.rst

   1 .. _gui_create_case:
   2
   3 The creation of a case
   4 ######################
   5 .. index:: single: case
   6
   7 The definition of a case is done with the following data:
   8
   9   - A name
  10   - A directory
  11   - The file of the initial mesh
  12   - The type of conformity for the serie of adaptations
  13   - Some curved boundaries
  14
  15 .. image:: images/intro_32.png
  16    :align: center
  17
  18
  19 Name of the case
  20 ****************
  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.
  22
  23 The directory
  24 *************
  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.
  26
  27 .. image:: images/create_case_2.png
  28    :align: center
  29
  30 .. index:: single: mesh;initial
  31 .. index:: single: MED
  32
  33 The initial mesh
  34 ****************
  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.
  36
  37
  38 .. image:: images/create_case_3.png
  39    :align: center
  40
  41 .. note::
  42   Only one mesh into the file.
  43
  44 .. warning::
  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.
  46
  47
  48 .. index:: single: conformity
  49
  50 Type of conformity
  51 ******************
  52 The future iterations for this case must respect the the same behaviour regarding the type of conformity.
  53
  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.
  55
  56 The treatment of non conformal meshes is possible.
  57
  58 .. image:: images/create_case_4.png
  59    :align: center
  60
  61 Some extra options can be given by the advanced options.
  62
  63 .. index:: single: boundary
  64
  65 The boundaries
  66 **************
  67 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.
  68
  69 Two situations:
  70
  71 * 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.
  72 * a surface: such a surface is defined with an analytical description.
  73
  74 Check the button:
  75
  76 .. image:: images/create_case_5.png
  77    :align: center
  78
  79 The definition of the boundaries is described in :doc:`gui_create_boundary`.
  80
  81 .. index:: single: pyramid
  82
  83 Advanced options
  84 ****************
  85 Default: no advanced option. Nevertheless, some advanced options can be defined :
  86
  87 The pyramids
  88 ============
  89
  90 The first option is about the pyramids.
  91
  92 .. image:: images/create_case_7.png
  93    :align: center
  94
  95 HOMARD is able to work with 2D or 3D meshes as well, including the following elements:
  96    - nodal element
  97    - segment
  98    - triangle
  99    - quadrangle
 100    - tetrahedron
 101    - hexahedron
 102    - prism
 103
 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.
 105 Nevertheless, if the computation is available with non conformal meshes, 3 possibilities are available:
 106
 107 Which conformity?
 108 =================
 109
 110 With a conformal refinement, the choice is given between the standard conformal refinement, default option, and a refinement into boxes, e.g. without any staircases.
 111
 112 .. image:: images/create_case_8.png
 113    :align: center
 114
 115 Which non conformity?
 116 =====================
 117
 118 With a non conformal refinement, 4 choices are available:
 119
 120 * standard non conformal refinement, default option
 121 * refinement into boxes, e.g. without any staircases
 122 * 1 node per edge: every single edge of an element ban be split once while its neighbour is not.
 123 * free: no limit for the number of hanging node.
 124
 125 .. image:: images/create_case_9.png
 126    :align: center
 127
 128 The external format
 129 ===================
 130 .. index:: single: MED
 131 .. index:: single: Saturne
 132
 133 By default, the external format is MED. When coupled with Saturne 2D, it is necessary to precise it to correctly deal with the pseudo 2D situation.
 134
 135 .. image:: ../images/create_case_1.png
 136    :align: center
 137
 138 The pursuit of a case
 139 *********************
 140 .. index:: single: pursuit
 141 .. index:: single: YACS
 142
 143 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.
 144
 145 The compulsatory condition to pursue an iteration is to keep two files into the same directory:
 146    - the configuration file that was a data for the binary module of HOMARD; this file looks like ``HOMARD.Configuration.(n).vers.(n+1)``
 147    - the MED file that saves the history of th eprevious adaptations; this file looks like ``maill.(n).hom.med``
 148
 149 Either an iteration known by its directory or an iteration identified into the directory of a case can be selected.
 150
 151 To pursuit of an iteration known by its directory, the definition of the case is made by the following data:
 152
 153   - A name
 154   - A directory
 155   - The directory of the data base
 156
 157 .. image:: images/pursue_case_1.png
 158    :align: center
 159
 160 The pursuit of an iteration into a previous case can be operated; the default starting iteration is the last iteration of the case.
 161
 162 .. image:: images/pursue_case_2.png
 163    :align: center
 164
 165 If the starting iteration is not the last one, its number must be given:
 166
 167 .. image:: images/pursue_case_3.png
 168    :align: center
 169
 170 .. note::
 171   The governing parameters of the created case are the same as the ones of the strating iteration: same mode for the conformity, for instance.
 172
 173
 174 Object browser
 175 **************
 176 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.
 177
 178 .. image:: images/create_case_6.png
 179    :align: center
 180
 181
 182
 183 Corresponding python functions
 184 ******************************
 185 Look :doc:`tui_create_case`
 186