Salome HOME
PR: modifs Gerald 20120216
[modules/homard.git] / doc / gui_create_boundary.rst
1 .. _gui_create_boundary:
2
3 La frontière
4 ============
5 .. index:: single: boundary
6 .. index:: single: frontière
7
8 L'objet frontière contient toutes les définitions géométriques permettant de décrire une frontière courbe à suivre.
9
10 Il existe deux modes de description d'une frontière :
11
12   - Discrète : ce mode est utilisé pour décrire une courbe 1D
13   - Analytique : ce mode est utilisé pour décrire une surface
14
15
16 Frontière discrète
17 ==================
18
19 Le suivi d'une frontière discrète se fera en sélectionnant une frontière choisie dans la liste des frontières discrètes existantes.
20
21 Au démarrage, la liste est vide. Il faut créer une première frontière discrète par activation du bouton "*Nouveau*" :
22
23 .. image:: images/create_boundary_di_1.png
24    :align: center
25
26 La fenêtre proposée invite au choix d'un fichier de maillage. Ce maillage est celui de toutes les lignes constituant la frontière. Un nom de frontière est proposé automatiquement : Boun_1, Boun_2, etc. Ce nom peut être modifié. Il ne doit pas avoir déjà été utilisé pour une autre frontière.
27
28 .. image:: images/create_boundary_di_2.png
29    :align: center
30
31 .. note::
32   Le fichier ne doit contenir qu'un seul maillage.
33
34 Si des frontières discrètes ont déjà été définies pour un autre cas, on peut sélectionner l'une d'elles. On peut également créer une nouvelle frontière discrète par activation du bouton "*Nouveau*", comme expliqué précédemment.
35
36 .. image:: images/create_boundary_di_3.png
37    :align: center
38
39
40
41 Frontière analytique
42 ====================
43 Au démarrage, Salome affiche un tableau avec un seule colonne. Cette colonne contient la liste de tous les groupes du maillage initial définissant le cas.
44
45 .. image:: images/create_boundary_an_1.png
46    :align: center
47
48 Il faut créer une première frontière analytique par activation du bouton "*Nouveau*". On aura le choix entre cylindre ou sphère. Une fois que la frontière sera validée, son nom figurera en en-tête d'une deuxième colonne.
49
50 .. image:: images/create_boundary_an_2.png
51    :align: center
52
53 Il faut maintenant établir le lien entre le maillage définissant le cas et cette frontière décrite analytiquement. Cela se fait en cochant les groupes des faces qui doivent se trouver sur la frontière.
54
55 .. image:: images/create_boundary_an_3.png
56    :align: center
57
58 Cette opération est répétée autant de fois que l'on souhaite placer des faces du maillages sur une surface courbe :
59
60 .. image:: images/create_boundary_an_4.png
61    :align: center
62
63 .. note::
64
65   Un groupe peut très bien ne jamais être coché : cela signifie que les mailles qu'il définit n'appartiennent à aucune des frontières décrites.
66
67   Un groupe ne peut être coché qu'une seule fois. En effet, des mailles surfaciques ne peuvent pas appartenir à plus d'une surface.
68
69   Plusieurs groupes peuvent être cochés pour une même frontière. Cela arrive quand le maillage initial de la zone a été subdivisé en plusieurs groupes : toutes les mailles surfaciques appartiennent à cette surface mais ont été réparties en plusieurs groupes.
70
71   Inversement, une frontière peut très bien n'être retenue par aucun groupe. Cela arrive si elle a été définie pour un cas précédent et qu'elle est sans objet pour le cas en cours de définition.
72
73
74 Il existe deux types de frontière analytique :
75
76   - Cylindre
77   - Sphère
78
79 .. note::
80   Les valeurs numériques proposées par défaut tiennent compte de la géométrie du maillage.
81
82
83 Un cylindre
84 """""""""""
85 .. index:: single: cylindre
86
87 Le cylindre est défini par un point de l'axe, son axe et son rayon. L'axe est défini par un vecteur. La norme de ce vecteur n'est pas nécessairement égale à 1 ; de même, son orientation n'a aucune importance. Un nom de frontière est proposé automatiquement : Boun_1, Boun_2, etc. Ce nom peut être modifié. Il ne doit pas avoir déjà été utilisé pour une autre frontière.
88
89 .. image:: images/create_boundary_an_cy.png
90    :align: center
91
92 Une sphère
93 """"""""""
94 .. index:: single: sphere
95
96 La sphère est définie par son centre et son rayon. Un nom de frontière est proposé automatiquement : Boun_1, Boun_2, etc. Ce nom peut être modifié. Il ne doit pas avoir déjà été utilisé pour une autre frontière.
97
98 .. image:: images/create_boundary_an_sp.png
99    :align: center
100
101 .. index:: single: arbre d'étude
102
103 L'arbre d'étude
104 """""""""""""""
105 A l'issue de cette création de frontières, l'arbre d'études a été enrichi. On y trouve toutes les frontières créées, identifiées par leur nom, avec la possibilité de les éditer.
106
107 .. image:: images/create_boundary_1.png
108    :align: center
109
110
111 Méthodes python correspondantes
112 """""""""""""""""""""""""""""""
113 Consulter : :ref:`tui_create_boundary`
114
115
116