]> SALOME platform Git repositories - modules/hydro.git/blob - doc/salome/tutorial/landCoverMap.rst
Salome HOME
Corrections of examples path after install with scbi
[modules/hydro.git] / doc / salome / tutorial / landCoverMap.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 Land Cover Map
21 #########################################
22
23
24 .. |stricklerTable_1| image:: /_static/stricklerTable_1.png
25    :align: middle
26
27 .. |importLandCoverMap| image:: /_static/importLandCoverMap.png
28    :align: middle
29
30 .. |importLandCoverMap_2| image:: /_static/importLandCoverMap_2.png
31    :align: middle
32
33 .. |importLandCoverMap_3| image:: /_static/importLandCoverMap_3.png
34    :align: middle
35
36 .. |casLandCoverMap| image:: /_static/casLandCoverMap.png
37    :align: middle
38
39 .. |BottomFriction| image:: /_static/BottomFriction.png
40    :align: middle
41
42 .. |GenerateKs| image:: /_static/GenerateKs.png
43    :align: middle
44
45 .. |InterfaceScriptKs| image:: /_static/InterfaceScriptKs.png
46    :align: middle
47
48
49 Import d'une Land Cover Map
50 ===========================
51 Nous allons reprendre l'exemple précédent "garonne_1" pour ajouter une carte des coefficients de Strickler.
52 La carte à importer peur être téléchargée et éditée préalablement dans qgis. Les *Corine Land Cover* couvrent généralement 
53 un grand territoire et sont très détaillées.
54
55 **Remarque :** Pour que ces cartes ne soient pas trop lourdes à manipuler dans SALOME HYDRO,
56 il est préférable de les découper dans qgis de façon à les restreindre autant que possible au domaine d'étude.
57 On définira un polygone de découpe englobant le domaine d'étude, en vérifiant que l'on ne perd pas de zone lors de la découpe
58 (Une carte découpée est fournie avec ce tutoriel). La carte comprend une base de données qui donne, pour chaque zone,
59 le code de type de territoire associé, selon la nomenclature *Corine Land Cover*.
60
61 Avant d'importer la carte, il faut disposer d'une table définissant les codes  *Corine Land Cover*, la couleur de représentation 
62 des types de zones, les coefficients de Strickler associés.
63
64 Une table par défaut est proposée dans SALOME-HYDRO, visible dans l'arbre d'étude, dans la rubrique *STRICKLER TABLES*, sous le nom
65 *Strickler table_1*. Il est possible de l'éditer avec le menu contextuel *Edit Strickler table*.
66 La plupart des champs sont éditables,
67 **notamment les coefficients de Strickler qu'il faudra de toutes façon adapter pour une étude réaliste**.
68
69   |stricklerTable_1|
70   
71 Le champ *Attribute Name* doit correspondre au champ de codification des types de zones dans la base de donnée
72 associée au *Corine Land Cover* importé : *CODE_06* correspond aux cartes de 2006, *CODE_12* aux cartes de 2012.
73 Ce champ n'est pas éditable dans le dialogue ci-dessus.
74
75 Dans l'exemple fourni, la carte date de 2006, il nous faut donc une autre table de Strickler.
76 Ces tables sont enregistrées dans des fichiers texte éditables.
77 Nous chargeons une table 2006 fournie dans le répertoire d'installation de l'application SALOME HYDRO
78 avec la commande *Import Strickler table* du menu contextuel de la rubrique *STRICKLER TABLES* ::
79
80   <appli_xxx>/share/salome/resources/hydro/def_strickler_table_06.txt
81
82 Il faut effacer la table précédente *Strickler table_1*, pour que la nouvelle table soit correctement utilisée
83 lors de l'import de la Land Cover Map (menu contextuel *Delete*). 
84
85 Nous pouvons maintenant charger la Land Cover Map.
86 Nous utilisons pour cela la commande *Import land cover map from file(s)* du menu contextuel de la rubrique
87 *LAND COVER MAPS* ::
88   
89   <appli_xxx>/bin/salome/test/HYDRO/HYDRO/CLC_decoupe.shp
90
91 La carte comprend déjà un grand nombre de polygones noirs (plus de 600) dont on peut voir le contour en les sélectionnant.
92 La découpe déborde très largement de la zone d'étude. On voit les zones "oubliées" lors de la découpe dans qgis,
93 sur les bords. Elles sont hors de la zone d'étude.
94
95   |importLandCoverMap|
96   
97 En pratique, on sélectionne tous les polygones (<crtl> A dans la liste), avant d'appuyer sur le bouton *Next>*.
98 Il y a plusieurs attributs trouvés dans la base importée. Nous sélectionnons l'attribut qui nous intéresse,
99 le type de zone : *CODE_06*, avant d'appuyer sur le bouton *Next>*.
100 Les codes de zones sont correctement associés à leur définition fournie dans la nouvelle table de Strickler.
101
102   |importLandCoverMap_2|
103
104 Nous appuyons sur le bouton *Finish*. Le traitement prend quelques dizaines de secondes.
105 La Land Cover Map ne s'affiche pas automatiquement : commande *show* du menu contextuel de l'objet *CLC_decoupe* 
106 dans la rubrique *LAND COVER MAPS*. On peut voir le cas de calcul sous la carte, en transparence.
107
108   |importLandCoverMap_3|
109
110 Création, édition de Land Cover Map
111 ===================================
112
113 Il est possible de créer de toutes pièces une Land Cover Map, à l'aide de polygones créés dans SALOME-HYDRO
114 ou importés.
115
116 Le menu contextuel de la Land Cover Map offre des possibilités d'édition des zones : 
117 ajouter, enlever, découper, regrouper, changer le type.
118
119 Nous ne détaillons pas ces opérations ici.
120
121 Utilisation d'une Land Cover Map dans le cas de calcul
122 ======================================================
123
124 Pour exploiter la Land Cover Map, il faut éditer le cas de calcul. 
125 Nous éditons le cas de calcul *garonne_1* avec la commande *edit calculation case* du menu contextuel du cas de calcul.
126 Il faut avancer jusqu'au panneau *Land cover map* avec les boutons *Next>* et sélectionner le Land Cover Map et la 
127 table de Strickler
128
129   |casLandCoverMap| 
130
131 Nous poursuivons avec les boutons *Next>* et *Finish* pour valider le cas.
132
133
134 Création d'un champ de Strickler aux noeuds du maillage
135 =======================================================
136
137 Telemac exploite un champ des coefficients de Strickler aux noeuds du maillage. Ce champ a pour nom *BOTTOM FRICTION*.
138 Ce champ est ajouté au fichier MED du maillage, comme le champ d'altitude aux noeuds.
139
140 Aller dans HYDROSOLVER / Hydro et cliquer sur Generate assignStrickler.py.
141
142   |GenerateKs|
143
144   |InterfaceScriptKs|
145
146 Il faut sélectionner le cas de calcul dans la rubrique HYDRO / CALCULATION CASE de l’arbre d’étude. Son nom apparaît dans la première ligne Calculation case du dialogue.
147
148 Le chemin complet du script à créer doit être renseigné dans la rubrique Output path.
149
150 Il faut désigner le fichier du maillage de départ construit à l’étape précédente dans rubrique MED file.
151    
152 Nous pouvons voir le champ résultat avec le module MED, comme pour le champ d'altitude.
153     
154   |BottomFriction|
155
156 .. only:: html
157
158    :ref:`ref_casParticuliers`