Salome HOME
Merge branch 'BR_H2018_DRAFT' into BR_2018_V8_5
[modules/hydro.git] / doc / salome / tutorial / importBathy.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 Import de bathymétrie
21 #######################
22
23 .. |import_bathy1| image:: /_static/bathy1.png
24    :align: middle
25
26 Le module HYDRO permet l'importation de types de fichiers de bathymétrie, correspondant
27 aux extensions .xyz et .asc. Ce sont des fichiers texte ASCII.
28 Les fichiers .xyz comprennent un point par ligne, avec les coordonnées x y z.
29 les fichiers .asc correspondent à un maillage cartésien structuré en x, y. 
30 Après un entête donnant le nombre de lignes, de colonnes, les coordonnées
31 du coin sud ouest, le pas en x et en y, on trouve la matrice des altitudes z.
32 Il est également possible d'importer des bathymétries contenues dans des fichiers au
33 format SinusX, qui sera décrit plus loin.
34
35 Nous allons importer deux fichiers pour les besoins de notre étude.  
36 Ils se trouvent dans le répertoire d'installation de l'application SALOME HYDRO ::
37
38   <appli_xxx>/bin/salome/test/HYDRO/cloud_02.xyz 
39
40   <appli_xxx>/bin/salome/test/HYDRO/garonne_point_L93.xyz 
41
42 Le fichier *cloud_02.xyz* est un extrait de données IGN sur une matrice régulière avec un point tout les 75 m, en accès libre.
43 Le fichier *garonne_point_L93.xyz* correspond à une étude antérieure, couvre le lit majeur du fleuve sur la région,
44 et est potentiellement plus précis que le précédent, au moins sur le lit mineur.
45
46 Pour importer ces fichiers, nous utilisons le menu contextuel de la rubrique *BATHYMETRIES*
47 dans l'arbre de l'étude SALOME. Le dialogue d'import permet de sélectionner le fichier à importer
48 et de changer son nom dans l'arbre d'étude.
49 Nous validons l'import avec le bouton *Apply and Close*.
50
51 pour afficher la bathymétrie, il faut cliquer sur l'oeil en face de son nom, et recentrer l'image
52 à l'aide du bouton *fit all*.
53
54 Les points sont colorés selon leur altitudes, et les plages de couleurs sont ajustées en fonction
55 du minimum et du maximum de l'ensemble des champs affichés. La légende correspondante est 
56 systématiquement affichée.
57
58 Nous devrions obtenir une vue ressemblant à ceci :
59
60   |import_bathy1|
61
62
63 .. only:: html
64
65    :ref:`ref_exempleInondation`