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 Nevertheless, if the computation is available with non conformal meshes, 3 possibilities are available:
  57
  58
  59 .. image:: images/create_case_4.png
  60    :align: center
  61
  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.
  65
  66 .. index:: single: boundary
  67
  68 The boundaries
  69 **************
  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.
  71
  72 Two situations:
  73
  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.
  76
  77 Check the button:
  78
  79 .. image:: images/create_case_5.png
  80    :align: center
  81
  82 The definition of the boundaries is described in :ref:`gui_create_boundary`.
  83
  84 .. index:: single: pyramid
  85
  86 Advanced options
  87 ****************
  88 Default: no advanced option.
  89
  90 Nevertheless, some advanced options can be defined :
  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    - tetraedron
 101    - hexaedron
 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
 106
 107 The pursuit of a case
 108 *********************
 109 .. index:: single: pursuit
 110 .. index:: single: yacs
 111
 112 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
 114 The compulsatory condition to pursue an iteration is to keep two files into the same directory:
 115    - the configuration file that was a data for the binary module of HOMARD; this file looks like ``HOMARD.Configuration.(n).vers.(n+1)``
 116    - the MED file that saves the history of th eprevious adaptations; this file looks like ``maill.(n).hom.med``
 117
 118 Either an iteration known by its directory or an iteration identified into the directory of a case can be selected.
 119
 120 To pursuit of an iteration known by its directory, the definition of the case is made by the following data:
 121
 122   - A name
 123   - A directory
 124   - The directory of the data base
 125
 126 .. image:: images/pursue_case_1.png
 127    :align: center
 128
 129 The pursuit of an iteration into a previous case can be operated; the default starting iteration is the last iteration of the case.
 130
 131 .. image:: images/pursue_case_2.png
 132    :align: center
 133
 134 If the starting iteration is not the last one, its number must be given:
 135
 136 .. image:: images/pursue_case_3.png
 137    :align: center
 138
 139 .. note::
 140   The governing parameters of the created case are the same as the ones of the strating iteration: same mode for the conformity, for instance.
 141
 142
 143 Object browser
 144 **************
 145 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
 147 .. image:: images/create_case_6.png
 148    :align: center
 149
 150
 151
 152 Corresponding python functions
 153 ******************************
 154 Look :ref:`tui_create_case`
 155