Salome HOME
Merge branch 'BR_H2018_DRAFT' into BR_2018_V8_5
[modules/hydro.git] / doc / salome / tutorial / streams.rst
1 ..
2    Copyright (C) 2015-2016 EDF
3
4    This file is part of SALOME HYDRO module.
5
6    SALOME HYDRO module is free software: you can redistribute it and/or modify
7    it under the terms of the GNU General Public License as published by
8    the Free Software Foundation, either version 3 of the License, or
9    (at your option) any later version.
10
11    SALOME HYDRO module is distributed in the hope that it will be useful,
12    but WITHOUT ANY WARRANTY; without even the implied warranty of
13    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
14    GNU General Public License for more details.
15
16    You should have received a copy of the GNU General Public License
17    along with SALOME HYDRO module.  If not, see <http://www.gnu.org/licenses/>.
18
19 #########################################
20 Streams
21 #########################################
22
23 .. |exemple_profil| image:: /_static/exemple_profil.png
24    :align: middle
25
26 .. |profilsEtLignedo| image:: /_static/profilsEtLignedo.png
27    :align: middle
28
29 .. |iconeImportSinusX| image:: /_static/iconeImportSinusX.png
30    :align: middle
31
32 .. |menuImportSinusX| image:: /_static/menuImportSinusX.png
33    :align: middle
34
35 .. |georeferencementProfiles| image:: /_static/georeferencementProfiles.png
36    :align: middle
37
38 .. |profilsIgnores| image:: /_static/profilsIgnores.png
39    :align: middle
40
41 .. |createStream| image:: /_static/createStream.png
42    :align: middle
43
44 .. |objetStream| image:: /_static/objetStream.png
45    :align: middle
46
47 Les objets Stream permettent de définir des cours d'eau à l'aide d'une succession de profils.
48 Ces profils sont des coupes verticales en travers faites à intervalles réguliers le long du cours d'eau.
49
50   |exemple_profil|
51
52 Pour reconstituer le cours d'eau, il faut une succession de profils (avec leur géoréférencement), et une
53 ligne définissant l'axe du cours d'eau. Cette ligne permet d'ordonner les profils.
54
55   |profilsEtLignedo|
56
57 Nous importons une série de profils géoréférencés ainsi qu'une polyligne XY définissant la ligne d'eau,
58 au format SinusX (ou au format xyz).
59 La polyligne n'a pas besoin d'être très précise, dans la mesure où elle coupe les profils.
60
61 L'import de fichiers au format SinusX se fait à partir de la barre de menu *HYDRO*, commande *Import from SinusX*
62 ou du bouton correspondant dans la barre d'outils du module.
63
64   |iconeImportSinusX|
65
66   |menuImportSinusX|
67
68 Nous importons successivement les fichiers *lignedo.sx* et *garonne_profiles.sx*
69 qui se trouvent dans le répertoire d'installation de l'application SALOME HYDRO ::
70
71   <appli_xxx>/bin/salome/test/HYDRO
72
73 La ligne d'eau apparaît dans la rubrique *POLYLINES* et la série de profils se retrouve
74 dans la rubrique *PROFILES* de l'arbre de l'étude.
75
76
77 Les profils sont nommés individuellement, et éditables.
78
79   |georeferencementProfiles|
80
81 Pour créer l'objet Stream, il faut utiliser la commande *Create stream* du menu contextuel de la rubrique
82 *NATURAL OBJECTS*.
83
84 Nous nommons le stream *garonne_stream*, sélectionnons la polyligne *lignedo* et récupérons la série de profils
85 précédemment importés (il faut les sélectionner dans l'arbre d'étude et utiliser le bouton *Add*
86 du dialogue *create stream*.
87
88 La ligne d'eau ne coupe pas tous les profils, il y en en a en amont et en aval, ils vont être ignorés.
89
90   |profilsIgnores|
91
92 Pour permettre le calcul de la bathymétrie, un nuage de points est généré par interpolation entre les profils,
93 sous forme d'une série de profils intermédiaires constitués de points.
94
95 Le paramètre *Stream spatial step* donne la distance entre ces profils intermédiaires.
96
97 Le paramètre *Stream ddz* donne le pas d'échantillonage vertical pour la discrétisation des profils.
98
99   |createStream|
100
101 Il faut valider avec *Apply and Close*. L'objet Stream apparait dans la vue et dans la rubrique
102 *NATURAL OBJECTS* sous le nom donné précedemment, *garonne_stream*
103
104   |objetStream|
105   
106 Le nuage de point associé apparaît dans la rubrique *BATHYMETRIES* sous le nom *garonne_stream_Altitude_1*.
107
108 .. only:: html
109
110    :ref:`ref_casParticuliers`
111