Salome HOME
insertion de la documentation en anglais - phase 1
[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 trois types de frontière analytique :
75
76   - Cylindre
77   - Sphère
78   - Cône, décrit par un axe et un angle ou par deux rayons
79
80 .. note::
81   Les valeurs numériques proposées par défaut tiennent compte de la géométrie du maillage.
82
83
84 Un cylindre
85 """""""""""
86 .. index:: single: cylindre
87
88 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.
89
90 .. image:: images/create_boundary_an_cy.png
91    :align: center
92
93 Une sphère
94 """"""""""
95 .. index:: single: sphere
96
97 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.
98
99 .. image:: images/create_boundary_an_sp.png
100    :align: center
101
102 .. index:: single: arbre d'étude
103
104 Un cône
105 """""""
106 .. index:: single: cone
107
108 Un cône est défini de deux manières différentes : le centre, l'axe et l'angle d'ouverture en degré ou par deux points centrés sur l'axe et le rayon associé. 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.
109
110 Création par une origine, un axe et un angle d'ouverture :
111
112 .. image:: images/create_boundary_an_co_1.png
113    :align: center
114
115 Création par deux points centrés sur l'axe et le rayon associé :
116
117 .. image:: images/create_boundary_an_co_2.png
118    :align: center
119
120 .. index:: single: arbre d'étude
121
122 L'arbre d'étude
123 """""""""""""""
124 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.
125
126 .. image:: images/create_boundary_1.png
127    :align: center
128
129
130 Méthodes python correspondantes
131 """""""""""""""""""""""""""""""
132 Consulter : :ref:`tui_create_boundary`
133
134
135