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/create_case_1.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 Par défaut, aucune option avancée n'est active.
  89
  90 Néanmoins, on peut définir une oprion avancée :
  91
  92 .. image:: images/create_case_7.png
  93    :align: center
  94
  95 Par défaut, HOMARD sait traiter des maillages en 2 ou 3 dimensions et comportant les mailles suivantes :
  96    - mailles-points
  97    - segments
  98    - triangles
  99    - quadrangles
 100    - tétraèdres
 101    - hexaèdres
 102    - prismes
 103
 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.
 105
 106
 107 The pursuit of a case
 108 *********************
 109 .. index:: single: pursuit
 110 .. index:: single: yacs
 111
 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.
 114
 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``
 118
 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.
 120
 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 :
 122
 123   - Un nom
 124   - Un répertoire
 125   - Le répertoire qui contient les archives
 126
 127 .. image:: images/pursue_case_1.png
 128    :align: center
 129
 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.
 131
 132 .. image:: images/pursue_case_2.png
 133    :align: center
 134
 135 Si on souhaite partir d'une itération qui ne soit pas la dernière, il suffit de le préciser :
 136
 137 .. image:: images/pursue_case_3.png
 138    :align: center
 139
 140 .. note::
 141   Les paramétrages du cas ainsi créé sont ceux de l'itération poursuivie : mode de conformité identique par exemple.
 142
 143
 144 Object browser
 145 **************
 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.
 147
 148 .. image:: images/create_case_6.png
 149    :align: center
 150
 151
 152
 153 Corresponding python functions
 154 ******************************
 155 Look :ref:`tui_create_case`
 156