Salome HOME
Introduction de la doculmentation en anglais - phase 3
[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: 53-86
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
47
48 Raffinement par des zones
49 """""""""""""""""""""""""
50 .. index:: single: zone
51
52 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. On notera que le type de raffinement n'a pas été précisé ; par défaut, il sera donc conforme.
53
54 .. literalinclude:: ../files/tutorial_2.py
55    :lines: 53-98
56
57 .. note::
58   Téléchargement des fichiers
59
60   * :download:`maillage initial<../files/tutorial_2.00.med.gz>`
61   * :download:`commandes python<../files/tutorial_2.py>`
62
63
64 Raffinement selon un champ
65 """"""""""""""""""""""""""
66 .. index:: single: champ
67
68 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.
69 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.
70
71 .. literalinclude:: ../files/tutorial_3.py
72    :lines: 53-128
73
74 .. note::
75   Téléchargement des fichiers
76
77   * :download:`maillage et champ étape 0<../files/tutorial_3.00.med.gz>`
78   * :download:`maillage et champ étape 1<../files/tutorial_3.01.med.gz>`
79   * :download:`commandes python<../files/tutorial_3.py>`
80
81
82 Suivi de frontières courbes
83 """""""""""""""""""""""""""
84 .. index:: single: champ
85 .. index:: single: yacs
86
87 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.
88 Le schéma YACS réalisant cette adaptation est téléchargeable.
89
90 .. literalinclude:: ../files/tutorial_4.py
91    :lines: 53-112
92
93 .. note::
94   Téléchargement des fichiers
95
96   * :download:`maillage initial<../files/tutorial_4.00.med.gz>`
97   * :download:`maillage de la frontière discrète<../files/tutorial_4.fr.med.gz>`
98   * :download:`commandes python<../files/tutorial_4.py>`
99   * :download:`schéma YACS<../files/tutorial_4.xml>`
100
101
102 Instructions spécifiques au 2D
103 """"""""""""""""""""""""""""""
104 .. index:: single: 2D
105
106 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.
107 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.
108
109 .. literalinclude:: ../files/tutorial_5.py
110    :lines: 53-98
111
112 .. note::
113   Téléchargement des fichiers
114
115   * :download:`maillage initial<../files/tutorial_5.00.med.gz>`
116   * :download:`maillage de la frontière discrète<../files/tutorial_5.fr.med.gz>`
117   * :download:`commandes python<../files/tutorial_5.py>`
118
119
120 .. toctree::
121    :maxdepth: 2