Salome HOME
Revert "Synchronize adm files"
[modules/homard.git] / 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    :lines: 52-85
40
41 .. note::
42   Téléchargement des fichiers
43
44   * :download:`maillage initial<../files/tutorial_1.00.med.gz>`
45   * :download:`commandes python<../files/tutorial_1.py>`
46   * :download:`commandes python de l'utilitaire de compression<../files/tutorial_util.py>`
47
48
49 Raffinement par des zones
50 *************************
51 .. index:: single: zone
52
53 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.
54
55 .. literalinclude:: ../files/tutorial_2.py
56    :lines: 52-95
57
58 .. note::
59   Téléchargement des fichiers
60
61   * :download:`maillage initial<../files/tutorial_2.00.med.gz>`
62   * :download:`commandes python<../files/tutorial_2.py>`
63   * :download:`commandes python de l'utilitaire de compression<../files/tutorial_util.py>`
64
65
66 Raffinement selon un champ
67 **************************
68 .. index:: single: champ
69
70 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.
71 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.
72
73 .. literalinclude:: ../files/tutorial_3.py
74    :lines: 52-124
75
76 .. note::
77   Téléchargement des fichiers
78
79   * :download:`maillage et champ étape 0<../files/tutorial_3.00.med.gz>`
80   * :download:`maillage et champ étape 1<../files/tutorial_3.01.med.gz>`
81   * :download:`commandes python<../files/tutorial_3.py>`
82   * :download:`commandes python de l'utilitaire de compression<../files/tutorial_util.py>`
83
84
85 Suivi de frontières courbes
86 ***************************
87 .. index:: single: champ
88 .. index:: single: YACS
89
90 On teste ici le suivi des frontières courbes : 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. 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.
91 Le schéma YACS réalisant cette adaptation est téléchargeable.
92
93 .. literalinclude:: ../files/tutorial_4.py
94    :lines: 52-111
95
96 .. note::
97   Téléchargement des fichiers
98
99   * :download:`maillage initial<../files/tutorial_4.00.med.gz>`
100   * :download:`maillage de la frontière discrète<../files/tutorial_4.fr.med.gz>`
101   * :download:`commandes python<../files/tutorial_4.py>`
102   * :download:`commandes python de l'utilitaire de compression<../files/tutorial_util.py>`
103   * :download:`schéma YACS<../files/tutorial_4.xml>`
104
105
106 Instructions spécifiques au 2D
107 ******************************
108 .. index:: single: 2D
109
110 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.
111 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.
112
113 .. literalinclude:: ../files/tutorial_5.py
114    :lines: 52-95
115
116 .. note::
117   Téléchargement des fichiers
118
119   * :download:`maillage initial<../files/tutorial_5.00.med.gz>`
120   * :download:`maillage de la frontière discrète<../files/tutorial_5.fr.med.gz>`
121   * :download:`commandes python<../files/tutorial_5.py>`
122   * :download:`commandes python de l'utilitaire de compression<../files/tutorial_util.py>`
123
124
125 .. toctree::
126    :maxdepth: 2
127