doc/gui_create_case_en.rst

   1 .. _gui_create_case_en:
   2
   3 The creation of a case
   4 ======================
   5 .. index:: single: case
   6
   7 La définition du cas se fait par la donnée des informations suivantes :
   8
   9   - Un nom
  10   - Un répertoire
  11   - Le fichier du maillage initial
  12   - Le type de conformité pour la série d'adaptations envisagées
  13   - Les éventuelles frontières courbes à respecter
  14
  15 .. image:: images/create_case_1.png
  16    :align: center
  17
  18
  19 Name of the case
  20 """"""""""""""""
  21 Un nom de cas est proposé automatiquement : Case_1, Case_2, etc. Ce nom peut être modifié. Il ne doit pas avoir déjà été utilisé pour un autre cas.
  22
  23 The directory
  24 """""""""""""
  25 Le répertoire est celui qui contiendra les fichiers produits par les adaptations successives. Par défaut, rien n'est proposé. Le choix est fait, soit en tapant le nom dans la zone de texte, soit en activant la fonction de recherche. C'est dans ce répertoire que seront exportés les maillages au format MED, dans des fichiers de nom ``maill.xx.med``, où ``xx`` est un numéro d'ordre créé automatiquement. Ces fichiers seront visibles dans l'arbre d'études.
  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 Le maillage initial doit se trouver dans un fichier au format MED. Classiquement, il aura été produit par le logiciel de calcul avec lequel on travaille. Mais il peut également avoir été créé avec le module SMESH et exporté au format MED. Le nom du fichier peut être fourni, soit en tapant le nom dans la zone de texte, soit en activant la fonction de recherche.
  36
  37 .. image:: images/create_case_3.png
  38    :align: center
  39
  40 .. note::
  41   Le fichier ne doit contenir qu'un seul maillage.
  42
  43 .. warning::
  44   Le maillage ne doit pas être lui-même le produit d'une adaptation de maillage par HOMARD, sous peine de perdre la cohérence entre les différents niveaux de raffinement/déraffinement
  45
  46 .. index:: single: conformity
  47
  48 Type of conformity
  49 """"""""""""""""""
  50 Les itérations qui seront calculées pour ce cas devront toutes respecter le même comportement vis-à-vis de la conformité.
  51
  52 L'option par défaut, 'conforme', implique que les maillages produits par HOMARD seront conformes au sens des éléments finis. C'est le choix classique de la plupart des logiciels de simulation par éléments finis.
  53
  54 Néanmoins, si le calcul est possible avec des maillages non conformes, on a le choix entre 3 possibilités :
  55
  56 .. image:: images/create_case_4.png
  57    :align: center
  58
  59 * 1 noeud par maille : une maille ne peut posséder qu'un seul noeud de non conformité avec ses voisines.
  60 * 1 noeud par arête : chaque arête d'une maille peut être découpée sans que la maille voisine par cette arête ne le soit.
  61 * quelconque : aucune limitation sur les raccords de conformité d'une maille à l'autre.
  62
  63 .. index:: single: boundary
  64
  65 The boundaries
  66 """"""""""""""
  67 Quand le bord du domaine est courbe, HOMARD sait placer les nouveaux noeuds sur ces frontières pour éviter des singularités artificielles. Cette technique est aussi applicable à une courbure intérieure à un domaine.
  68
  69 Deux cas de figure sont présents :
  70
  71 * courbe 1D : cette courbe peut être définie dans un plan, par exemple pour un calcul 2D. Elle peut également être définie dans l'espace 3D, par exemple pour l'intersection de deux surfaces. Une ligne à suivre est décrite de manière discrète.
  72 * surface : une surface à suivre est décrite de manière analytique.
  73
  74 On cochera le ou les boutons voulus :
  75
  76 .. image:: images/create_case_5.png
  77    :align: center
  78
  79 La définition des frontières est décrite dans :ref:`gui_create_boundary_en`.
  80
  81 .. index:: single: pyramid
  82
  83 Advanced options
  84 """"""""""""""""
  85 Par défaut, aucune option avancée n'est active.
  86
  87 Néanmoins, on peut définir une oprion avancée :
  88
  89 .. image:: images/create_case_7.png
  90    :align: center
  91
  92 Par défaut, HOMARD sait traiter des maillages en 2 ou 3 dimensions et comportant les mailles suivantes :
  93    - mailles-points
  94    - segments
  95    - triangles
  96    - quadrangles
  97    - tétraèdres
  98    - hexaèdres
  99    - prismes
 100
 101 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.
 102
 103
 104 The pursuit of a case
 105 =====================
 106 .. index:: single: pursuit
 107 .. index:: single: yacs
 108
 109 La poursuite d'un cas correspond à la situation suivante :
 110 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.
 111
 112 La condition pour reprendre une itération est d'avoir conservé dans un même répertoire deux fichiers :
 113    - 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)``
 114    - 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``
 115
 116 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.
 117
 118 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 :
 119
 120   - Un nom
 121   - Un répertoire
 122   - Le répertoire qui contient les archives
 123
 124 .. image:: images/pursue_case_1.png
 125    :align: center
 126
 127 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.
 128
 129 .. image:: images/pursue_case_2.png
 130    :align: center
 131
 132 Si on souhaite partir d'une itération qui ne soit pas la dernière, il suffit de le préciser :
 133
 134 .. image:: images/pursue_case_3.png
 135    :align: center
 136
 137 .. note::
 138   Les paramétrages du cas ainsi créé sont ceux de l'itération poursuivie : mode de conformité identique par exemple.
 139
 140
 141 Object browser
 142 """"""""""""""
 143 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.
 144
 145 .. image:: images/create_case_6.png
 146    :align: center
 147
 148
 149
 150 Corresponding python functions
 151 """"""""""""""""""""""""""""""
 152 Look :ref:`tui_create_case_en`
 153