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.UpdateStudy()
  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.UpdateStudy()
  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    :language: python
  40    :start-after: Début des commandes
  41    :end-before: Fin des commandes
  42
  43 .. note::
  44   Téléchargement des fichiers
  45
  46   * :download:`maillage initial<../files/tutorial_1.00.med.gz>`
  47   * :download:`commandes python<../files/tutorial_1.py>`
  48   * :download:`commandes python de l'utilitaire de compression<../files/tutorial_util.py>`
  49
  50
  51 Raffinement par des zones
  52 *************************
  53 .. index:: single: zone
  54
  55 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.
  56
  57 .. literalinclude:: ../files/tutorial_2.py
  58    :language: python
  59    :start-after: Début des commandes
  60    :end-before: Fin des commandes
  61
  62 .. note::
  63   Téléchargement des fichiers
  64
  65   * :download:`maillage initial<../files/tutorial_2.00.med.gz>`
  66   * :download:`commandes python<../files/tutorial_2.py>`
  67   * :download:`commandes python de l'utilitaire de compression<../files/tutorial_util.py>`
  68
  69
  70 Raffinement selon un champ
  71 **************************
  72 .. index:: single: champ
  73
  74 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.
  75 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.
  76
  77 .. literalinclude:: ../files/tutorial_3.py
  78    :language: python
  79    :start-after: Début des commandes
  80    :end-before: Fin des commandes
  81
  82 .. note::
  83   Téléchargement des fichiers
  84
  85   * :download:`maillage et champ étape 0<../files/tutorial_3.00.med.gz>`
  86   * :download:`maillage et champ étape 1<../files/tutorial_3.01.med.gz>`
  87   * :download:`commandes python<../files/tutorial_3.py>`
  88   * :download:`commandes python de l'utilitaire de compression<../files/tutorial_util.py>`
  89
  90
  91 Suivi de frontières courbes
  92 ***************************
  93 .. index:: single: frontière
  94 .. index:: single: CAO
  95 .. index:: single: YACS
  96
  97 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.
  98 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.
  99 Le schéma YACS réalisant cette adaptation est téléchargeable.
 100
 101 .. literalinclude:: ../files/tutorial_4.py
 102    :language: python
 103    :start-after: Début des commandes
 104    :end-before: Fin des commandes
 105
 106 .. note::
 107   Téléchargement des fichiers
 108
 109   * :download:`maillage initial<../files/tutorial_4.00.med.gz>`
 110   * :download:`la frontière en CAO<../files/tutorial_4.xao.gz>`
 111   * :download:`commandes python<../files/tutorial_4.py>`
 112   * :download:`commandes python de l'utilitaire de compression<../files/tutorial_util.py>`
 113   * :download:`schéma YACS<../files/tutorial_4.xml>`
 114
 115 Si la géométrie sous forme de CAO n'est pas disponible, on peut l'approcher ainsi :
 116 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.
 117
 118 .. literalinclude:: ../files/tutorial_6.py
 119    :language: python
 120    :start-after: Début des commandes
 121    :end-before: Fin des commandes
 122
 123 .. note::
 124   Téléchargement des fichiers
 125
 126   * :download:`maillage initial<../files/tutorial_4.00.med.gz>`
 127   * :download:`maillage de la frontière discrète<../files/tutorial_6.fr.med.gz>`
 128   * :download:`commandes python<../files/tutorial_6.py>`
 129   * :download:`commandes python de l'utilitaire de compression<../files/tutorial_util.py>`
 130   * :download:`schéma YACS<../files/tutorial_6.xml>`
 131
 132
 133 Instructions spécifiques au 2D
 134 ******************************
 135 .. index:: single: 2D
 136
 137 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.
 138 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.
 139
 140 .. literalinclude:: ../files/tutorial_5.py
 141    :language: python
 142    :start-after: Début des commandes
 143    :end-before: Fin des commandes
 144
 145 .. note::
 146   Téléchargement des fichiers
 147
 148   * :download:`maillage initial<../files/tutorial_5.00.med.gz>`
 149   * :download:`maillage de la frontière discrète<../files/tutorial_5.fr.med.gz>`
 150   * :download:`commandes python<../files/tutorial_5.py>`
 151   * :download:`commandes python de l'utilitaire de compression<../files/tutorial_util.py>`
 152
 153
 154 .. toctree::
 155    :maxdepth: 2
 156