doc/fr/tutorials.rst

   1 Exemples
   2 ########
   3 .. index:: single: exemple
   4 .. index:: single: python
   5
   6 On trouvera ici les instructions python pour quelques configurations caractéristiques. Les fichiers de données associés sont téléchargeables. Il faut penser à adapter la valeur de la variable ``data_dir`` : c'est le répertoire dans lequel les fichiers med auront été enregistrés.
   7 C'est dans le répertoire ``dircase`` que seront écrits les fichiers résultant des adaptations successives. Ce répertoire est créé par défaut dans ``/tmp``.
   8
   9 Chargement du module HOMARD
  10 ***************************
  11 .. index:: single: YACS
  12
  13 Le chargement du module HOMARD se fait de manière analogue aux autres modules.
  14
  15  ::
  16
  17   import HOMARD
  18   homard = salome.lcc.FindOrLoadComponent('FactoryServer','HOMARD')
  19   homard.SetCurrentStudy(salome.myStudy)
  20
  21 Pour utiliser le module HOMARD au sein d'un schéma YACS distribué, le chargement se fait ainsi :
  22
  23  ::
  24
  25   import HOMARD
  26   my_container.load_component_Library('HOMARD')
  27   homard = my_container.create_component_instance('HOMARD',0)
  28   homard.SetCurrentStudy(salome.myStudy)
  29
  30 Raffinement uniforme
  31 ********************
  32 .. index:: single: raffinement;uniforme
  33
  34 On fera ici trois raffinements uniformes successifs du maillage contenu dans le fichier ``tutorial_1.00.med``. Quelques remarques :
  35   * la même hypothèse est utilisée à chaque itération
  36   * le maillage produit porte toujours le même nom. Cela ne pose pas de problème car il est stocké dans des fichiers différents.
  37
  38 .. literalinclude:: ../files/tutorial_1.py
  39    :start-after: Début des commandes
  40    :end-before: Fin des commandes
  41
  42 .. note::
  43   Téléchargement des fichiers
  44
  45   * :download:`maillage initial<../files/tutorial_1.00.med.gz>`
  46   * :download:`commandes python<../files/tutorial_1.py>`
  47   * :download:`commandes python de l'utilitaire de compression<../files/tutorial_util.py>`
  48
  49
  50 Raffinement par des zones
  51 *************************
  52 .. index:: single: zone
  53
  54 On procède ici au raffinement selon des zones. Pour passer du maillage initial au maillage 'M_1', on utilise une boîte encadrant le plan z=1 et une sphère centrée sur l'origine de rayon 1.05. Puis pour passer du maillage 'M_1' au maillage 'M_2', on remplace la sphère par une boîte encadrant le cube de côté 0.5, pointant sur l'origine et on déraffine les mailles contenues dans la toute première zone.
  55
  56 .. literalinclude:: ../files/tutorial_2.py
  57    :start-after: Début des commandes
  58    :end-before: Fin des commandes
  59
  60 .. note::
  61   Téléchargement des fichiers
  62
  63   * :download:`maillage initial<../files/tutorial_2.00.med.gz>`
  64   * :download:`commandes python<../files/tutorial_2.py>`
  65   * :download:`commandes python de l'utilitaire de compression<../files/tutorial_util.py>`
  66
  67
  68 Raffinement selon un champ
  69 **************************
  70 .. index:: single: champ
  71
  72 On procède ici au raffinement selon un champ. Les hypothèses servent à définir le nom du champ et les seuils de raffinement/déraffinement. La donnée du fichier et des instants est faite dans l'itération. Des champs sur les noeuds ou sur les mailles sont interpolés.
  73 Pour adapter le maillage H_1 issu de l'itération Iter_1, deux variantes sont appliquées. Dans la première, Iter_2, le champ est un champ scalaire d'indicateurs d'erreur et on découpe les 1.5% de mailles où l'erreur est la plus grande. Dans la seconde variante, Iter_2_bis, on se base sur un champ vectoriel et on examine le saut de ce vecteur entre une maille et ses voisines : on découpera là où la norme infinie de ce saut est supérieure au seuil absolu de 0.0001.
  74
  75 .. literalinclude:: ../files/tutorial_3.py
  76    :start-after: Début des commandes
  77    :end-before: Fin des commandes
  78
  79 .. note::
  80   Téléchargement des fichiers
  81
  82   * :download:`maillage et champ étape 0<../files/tutorial_3.00.med.gz>`
  83   * :download:`maillage et champ étape 1<../files/tutorial_3.01.med.gz>`
  84   * :download:`commandes python<../files/tutorial_3.py>`
  85   * :download:`commandes python de l'utilitaire de compression<../files/tutorial_util.py>`
  86
  87
  88 Suivi de frontières courbes
  89 ***************************
  90 .. index:: single: frontière
  91 .. index:: single: CAO
  92 .. index:: single: YACS
  93
  94 On teste ici le suivi des frontières courbes en fournissant la géométrie représentée par la CAO de la pièce. Cette CAO est fournie dans un fichier au format XAO.
  95 Le pilotage du raffinement est le suivant : raffinement uniforme de toutes les mailles contenues dans des groupes désignés. On commence par raffiner les faces internes aux tuyaux ; ensuite, on raffine deux fois de suite les faces externes aux tuyaux.
  96 Le schéma YACS réalisant cette adaptation est téléchargeable.
  97
  98 .. literalinclude:: ../files/tutorial_4.py
  99    :start-after: Début des commandes
 100    :end-before: Fin des commandes
 101
 102 .. note::
 103   Téléchargement des fichiers
 104
 105   * :download:`maillage initial<../files/tutorial_4.00.med.gz>`
 106   * :download:`la frontière en CAO<../files/tutorial_4.xao.gz>`
 107   * :download:`commandes python<../files/tutorial_4.py>`
 108   * :download:`commandes python de l'utilitaire de compression<../files/tutorial_util.py>`
 109   * :download:`schéma YACS<../files/tutorial_4.xml>`
 110
 111 Si la géométrie sous forme de CAO n'est pas disponible, on peut l'approcher ainsi :
 112 des frontières analytiques pour décrire les différentes surfaces des tuyaux et une frontière discrète pour décrire les lignes d'intersection des deux tuyaux. Il suffit de remplacer la définition des frontières.
 113
 114 .. literalinclude:: ../files/tutorial_6.py
 115    :start-after: Début des commandes
 116    :end-before: Fin des commandes
 117
 118 .. note::
 119   Téléchargement des fichiers
 120
 121   * :download:`maillage initial<../files/tutorial_4.00.med.gz>`
 122   * :download:`maillage de la frontière discrète<../files/tutorial_6.fr.med.gz>`
 123   * :download:`commandes python<../files/tutorial_6.py>`
 124   * :download:`commandes python de l'utilitaire de compression<../files/tutorial_util.py>`
 125   * :download:`schéma YACS<../files/tutorial_6.xml>`
 126
 127
 128 Instructions spécifiques au 2D
 129 ******************************
 130 .. index:: single: 2D
 131
 132 Les instructions pour adapter un maillage 2D sont exactement identiques à celles nécessaires à l'adaptation d'un maillage 3D. La seule exception concerne le raffinement selon des zones géométriques : des fonctions différentes sont utilisées pour pouvoir définir des zones 2D. On donne alors les coordonnées 2D des zones, en précisant l'orientation du plan du maillage.
 133 Dans le cas présenté ici, on raffine une première fois toutes les mailles contenues dans un disque percé, puis dans une seconde itération, toutes les mailles contenues dans un rectangle. On notera l'utilisation du suivi des frontières circulaires du domaine.
 134
 135 .. literalinclude:: ../files/tutorial_5.py
 136    :start-after: Début des commandes
 137    :end-before: Fin des commandes
 138
 139 .. note::
 140   Téléchargement des fichiers
 141
 142   * :download:`maillage initial<../files/tutorial_5.00.med.gz>`
 143   * :download:`maillage de la frontière discrète<../files/tutorial_5.fr.med.gz>`
 144   * :download:`commandes python<../files/tutorial_5.py>`
 145   * :download:`commandes python de l'utilitaire de compression<../files/tutorial_util.py>`
 146
 147
 148 .. toctree::
 149    :maxdepth: 2
 150