Salome HOME
Passage en utf8, copyright et coquille
[modules/homard.git] / doc / fr / 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, sphère, cône ou tore. 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 quatre 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   - Tore
80
81 .. note::
82   Les valeurs numériques proposées par défaut tiennent compte de la géométrie du maillage.
83
84
85 Un cylindre
86 ===========
87 .. index:: single: cylindre
88
89 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.
90
91 .. image:: images/create_boundary_an_cy.png
92    :align: center
93
94 Une sphère
95 ==========
96 .. index:: single: sphere
97
98 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.
99
100 .. image:: images/create_boundary_an_sp.png
101    :align: center
102
103 Un cône
104 =======
105 .. index:: single: cone
106
107 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.
108
109 Création par une origine, un axe et un angle d'ouverture :
110
111 .. image:: images/create_boundary_an_co_1.png
112    :align: center
113
114 Création par deux points centrés sur l'axe et le rayon associé :
115
116 .. image:: images/create_boundary_an_co_2.png
117    :align: center
118
119 Un tore
120 =======
121 .. index:: single: tore
122
123 Le tore est défini par son centre, son axe, le rayon de révolution et le rayon primaire. 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.
124
125 .. image:: images/create_boundary_an_to.png
126    :align: center
127
128 L'arbre d'étude
129 ***************
130 .. index:: single: arbre d'étude
131
132 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.
133
134 .. image:: images/create_boundary_1.png
135    :align: center
136
137
138 Méthodes python correspondantes
139 *******************************
140 Consulter : :doc:`tui_create_boundary`
141
142
143