Salome HOME
Merge V9_dev branch into master
[modules/homard.git] / doc / en / gui_create_case.rst
index 6cb19b096c8f0040ee095c841b824c7b19aefbf9..268db819bf6339dc8e9408a72e73322750c07874 100644 (file)
@@ -12,7 +12,7 @@ The definition of a case is done with the following data:
   - The type of conformity for the serie of adaptations
   - Some curved boundaries
 
-.. image:: images/create_case_1.png
+.. image:: images/intro_32.png
    :align: center
 
 
@@ -53,15 +53,12 @@ The future iterations for this case must respect the the same behaviour regardin
 
 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.
 
-Nevertheless, if the computation is available with non conformal meshes, 3 possibilities are available:
-
+The treatment of non conformal meshes is possible.
 
 .. image:: images/create_case_4.png
    :align: center
 
-* 1 node per element: an element must not have more than one hanging node with its neighbours.
-* 1 node per edge: every single edge of an element ban be split once while its neighbour is not.
-* free: no limit for the number of hanging node.
+Some extra options can be given by the advanced options.
 
 .. index:: single: boundary
 
@@ -71,79 +68,115 @@ If the limit of the domain is curved, HOMARD can put the new nodes onto these cu
 
 Two situations:
 
-* 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.
-* a surface: such a surface is defined with an analytical description.
+- CAO: the CAO of the domain is available. The computtion will rely on it to project the nodes.
+- No CAO: if no CAO is available, an approximative approach is possible:
+
+  * 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.
+  * a surface: such a surface is defined with an analytical description.
 
 Check the button:
 
-.. image:: images/create_case_5.png
+.. image:: images/create_boundary_1.png
    :align: center
 
-The definition of the boundaries is described in :ref:`gui_create_boundary`.
+The definition of the boundaries is described in :doc:`gui_create_boundary`.
 
 .. index:: single: pyramid
 
 Advanced options
 ****************
-Par défaut, aucune option avancée n'est active.
+Default: no advanced option. Nevertheless, some advanced options can be defined :
+
+The pyramids
+============
 
-Néanmoins, on peut définir une oprion avancée :
+The first option is about the pyramids.
 
 .. image:: images/create_case_7.png
    :align: center
 
-Par défaut, HOMARD sait traiter des maillages en 2 ou 3 dimensions et comportant les mailles suivantes :
-   - mailles-points
-   - segments
-   - triangles
-   - quadrangles
-   - tétraèdres
-   - hexaèdres
-   - prismes
+HOMARD is able to work with 2D or 3D meshes as well, including the following elements:
+   - nodal element
+   - segment
+   - triangle
+   - quadrangle
+   - tetrahedron
+   - hexahedron
+   - prism
+
+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.
+Nevertheless, if the computation is available with non conformal meshes, 3 possibilities are available:
+
+Which conformity?
+=================
+
+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.
+
+.. image:: images/create_case_8.png
+   :align: center
+
+Which non conformity?
+=====================
+
+With a non conformal refinement, 4 choices are available:
+
+* standard non conformal refinement, default option
+* refinement into boxes, e.g. without any staircases
+* 1 node per edge: every single edge of an element ban be split once while its neighbour is not.
+* free: no limit for the number of hanging node.
+
+.. image:: images/create_case_9.png
+   :align: center
+
+The external format
+===================
+.. index:: single: MED
+.. index:: single: Saturne
 
-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.
+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.
 
+.. image:: ../images/create_case_1.png
+   :align: center
 
 The pursuit of a case
 *********************
 .. index:: single: pursuit
-.. index:: single: yacs
+.. index:: single: YACS
 
-La poursuite d'un cas correspond à la situation suivante :
-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.
+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.
 
-La condition pour reprendre une itération est d'avoir conservé dans un même répertoire deux fichiers :
-   - 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)``
-   - 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``
+The compulsatory condition to pursue an iteration is to keep two files into the same directory:
+   - the configuration file that was a data for the binary module of HOMARD; this file looks like ``HOMARD.Configuration.(n).vers.(n+1)``
+   - the MED file that saves the history of th eprevious adaptations; this file looks like ``maill.(n).hom.med``
 
-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.
+Either an iteration known by its directory or an iteration identified into the directory of a case can be selected.
 
-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 :
+To pursuit of an iteration known by its directory, the definition of the case is made by the following data:
 
-  - Un nom
-  - Un répertoire
-  - Le répertoire qui contient les archives
+  - A name
+  - A directory
+  - The directory of the data base
 
 .. image:: images/pursue_case_1.png
    :align: center
 
-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.
+The pursuit of an iteration into a previous case can be operated; the default starting iteration is the last iteration of the case.
 
 .. image:: images/pursue_case_2.png
    :align: center
 
-Si on souhaite partir d'une itération qui ne soit pas la dernière, il suffit de le préciser :
+If the starting iteration is not the last one, its number must be given:
 
 .. image:: images/pursue_case_3.png
    :align: center
 
 .. note::
-  Les paramétrages du cas ainsi créé sont ceux de l'itération poursuivie : mode de conformité identique par exemple.
+  The governing parameters of the created case are the same as the ones of the strating iteration: same mode for the conformity, for instance.
 
 
 Object browser
 **************
-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.
+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.
 
 .. image:: images/create_case_6.png
    :align: center
@@ -152,5 +185,5 @@ A l'issue de cette cr
 
 Corresponding python functions
 ******************************
-Look :ref:`tui_create_case`
+Look :doc:`tui_create_case`