Salome HOME
Corrections of examples path after install with scbi
[modules/hydro.git] / doc / salome / tutorial / english / english_landCoverMap.rst
index 52a6e2258ab0108c6f595d184cccb713d35d77de..3403beab053b8de8aa66d15da159f8079aa6cf82 100644 (file)
@@ -21,129 +21,129 @@ Land Cover Map
 #########################################
 
 
-.. |stricklerTable_1| image:: /../_static/stricklerTable_1.png
+.. |stricklerTable_1| image:: ../_static/stricklerTable_1.png
    :align: middle
 
-.. |importLandCoverMap| image:: /../_static/importLandCoverMap.png
+.. |importLandCoverMap| image:: ../_static/importLandCoverMap.png
    :align: middle
 
-.. |importLandCoverMap_2| image:: /../_static/importLandCoverMap_2.png
+.. |importLandCoverMap_2| image:: ../_static/importLandCoverMap_2.png
    :align: middle
 
-.. |importLandCoverMap_3| image:: /../_static/importLandCoverMap_3.png
+.. |importLandCoverMap_3| image:: ../_static/importLandCoverMap_3.png
    :align: middle
 
-.. |casLandCoverMap| image:: /../_static/casLandCoverMap.png
+.. |casLandCoverMap| image:: ../_static/casLandCoverMap.png
    :align: middle
 
-.. |BottomFriction| image:: /../_static/BottomFriction.png
+.. |BottomFriction| image:: ../_static/BottomFriction.png
    :align: middle
 
 
-Import d'une Land Cover Map
+Import of a Land Cover Map
 ===========================
-Nous allons reprendre l'exemple précedent "garonne_1" pour ajouter une carte des coefficients de Strickler.
-La carte à importer peur être téléchargée et éditée préalablement dans qgis. Les *Corine Land Cover* couvrent généralement 
-un grand territoire et sont très détaillées.
 
-**Remarque :** Pour que ces cartes ne soient pas trop lourdes à manipuler dans SALOME HYDRO,
-il est préférable de les découper dans qgis de façon à les restreindre autant que possible au domaine d'étude.
-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
-(Une carte découpée est fournie avec ce tutoriel). La carte comprend une base de données qui donne, pour chaque zone,
-le code de type de territoire associé, selon la nomenclature *Corine Land Cover*.
+The previous example "garonne_1" is taken to add a map of the Strickler coefficients.
+The map can be downloaded and modified in qgis. The *Corine Land Cover* overlap a large territory
+and are very detailed.
 
-Avant d'importer la carte, il faut disposer d'une table définissant les codes  *Corine Land Cover*, la couleur de représentation 
-des types de zones, les coefficients de Strickler associés.
+**Note:** To simplify handle of Corine Land Cover maps in SALOME-HYDRO,
+It is recomended to cut them into qgis in order to restrict them as much as possible to the field of study.
+We will define a cutting polygon covering the field of study, making sure that no zone is lost when cutting
+(A cuted map is provided with this tutorial). The map includes a database which gives, for each zone,
+the associated land type code, according to the *Corine Land Cover* nomenclature.
 
-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
-*Strickler table_1*. Il est possible de l'éditer avec le menu contextuel *Edit Strickler table*.
-La plupart des champs sont éditables,
-**notamment les coefficients de Strickler qu'il faudra de toutes façon adapter pour une étude réaliste**.
+Before importing the map, you must have a table defining the *Corine Land Cover* codes, the colour representation
+of the zone types and the associated Strickler coefficients.
+
+A default table is available in SALOME-HYDRO, visible in the study tree, in the *STRICKLER TABLES* section, with the name
+*Strickler table_1*. The table can be edited with the context menu *Edit Strickler table*.
+Most fields are editable,
+**in particular the Strickler coefficients that will have to be adapted in any case for a realistic study**.
 
   |stricklerTable_1|
-  
-Le champ *Attribute Name* doit correspondre au champ de codification des types de zones dans la base de donnée
-associée au *Corine Land Cover* importé : *CODE_06* correspond aux cartes de 2006, *CODE_12* aux cartes de 2012.
-Ce champ n'est pas éditable dans le dialogue ci-dessus.
 
-Dans l'exemple fourni, la carte date de 2006, il nous faut donc une autre table de Strickler.
-Ces tables sont enregistrées dans des fichiers texte éditables.
-Nous chargeons une table 2006 fournie dans le répertoire d'installation de l'application SALOME HYDRO
-avec la commande *Import Strickler table* du menu contextuel de la rubrique *STRICKLER TABLES* ::
+The *Attribute Name* field must match the field type field in the database associated with
+the imported *Corine Land Cover*: *CODE_06* corresponds to the 2006 maps, *CODE_12* to the 2012 maps.
+This field is not editable in the above dialog box. FIXME: pas clair
+
+In the example provided, the map is from 2006, another Strickler table is needed.
+These tables are saved in editable text files.
+We load a 2006 table provided in the installation directory of the SALOME HYDRO application
+With the *Import Strickler* command from the context menu of the topic *TABLES STRICKLER* ::
 
   <appli_xxx>/share/salome/resources/hydro/def_strickler_table_06.txt
 
-Il faut effacer la table précédente *Strickler table_1*, pour que la nouvelle table soit correctement utilisée
-lors de l'import de la Land Cover Map (menu contextuel *Delete*). 
+You must delete the previous table *Strickler table_1*, so that the new table is correctly used
+When importing the Land Cover Map (context menu *Delete*).
 
-Nous pouvons maintenant charger la Land Cover Map.
-Nous utilisons pour cela la commande *Import land cover map from file(s)* du menu contextuel de la rubrique
+We can now load the Land Cover Map.
+To do this, we use the *Import land cover map from file (s)* command in the context menu section
 *LAND COVER MAPS* ::
-  
+
   <appli_xxx>/bin/salome/test/HYDRO/HYDRO/CLC_decoupe.shp
 
-La carte comprend déjà un grand nombre de polygones noirs (plus de 600) dont on peut voir le contour en les selectionnant.
-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,
+The map already contains a large number of black polygons (more than 600) whose outline can be seen by selecting them.
+FIXME: 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,
 sur les bords. Elles sont hors de la zone d'étude.
 
   |importLandCoverMap|
-  
-En pratique, on sélectionne tous les polygones (<crtl> A dans la liste), avant d'appuyer sur le bouton *Next>*.
-Il y a plusieurs attributs trouvés dans la base importée. Nous selectionnons l'attribut qui nous intéresse,
-le type de zone : *CODE_06*, avant d'appuyer sur le bouton *Next>*.
-Les codes de zones sont correctement associés à leur définition fournie dans la nouvelle table de Strickler.
+
+In practice, we select all polygons (<crtl> A in the list), before pressing the *Next>* button.
+There are several attributes found in the imported database. We select the attribute that interests us,
+the zone type: *CODE_06*, before pressing the *Next>* button.
+The zone codes are well associated with their definition provided in the new Strickler table.
 
   |importLandCoverMap_2|
 
-Nous appuyons sur le bouton *Finish*. Le traitement prend quelques dizaines de secondes.
-La Land Cover Map ne s'affiche pas automatiquement : commande *show* du menu contextuel de l'objet *CLC_decoupe* 
-dans la rubrique *LAND COVER MAPS*. On peut voir le cas de calcul sous la carte, en transparence.
+We press the *Finish* button. The treatment takes few seconds.
+The Land Cover Map is not displayed automatically: *show* command in the context menu of the object *CLC_decoupe*
+In the *LAND COVER MAPS* section. One can see the calculation under the card, in transparency.
 
   |importLandCoverMap_3|
 
-Création, édition de Land Cover Map
+Creation, edition of Land Cover Map
 ===================================
 
-Il est possible de créer de toutes pièces une Land Cover Map, à l'aide de polygones créés dans SALOME-HYDRO
-ou importés.
-
-Le menu contextuel de la Land Cover Map offre des possibilités d'édition des zones : 
-ajouter, enlever, découper, regrouper, changer le type.
+It is possible to create a Land Cover Map from scratch, using polygons created from SALOME-HYDRO
+or imported.
 
-Nous ne détaillons pas ces opérations ici.
+The context menu of the Land Cover Map offers options for editing zones:
+adding, removing, cutting, grouping, changing the type.
 
-Utilisation d'une Land Cover Map dans le cas de calcul
-======================================================
+We do not detail these operations here.
 
-Pour exploiter la Land Cover Map, il faut éditer le cas de calcul. 
-Nous éditons le cas de calcul *garonne_1* avec la commande *edit calculation case* du menu contextuel du cas de calcul.
-Il faut avancer jusqu'au panneau *Land cover map* avec les boutons *Next>* et sélectionner le Land Cover Map et la 
-table de Strickler
+Use of Land Cover Map in calculation case
+=========================================
 
-  |casLandCoverMap| 
+To use the Land Cover Map, the computation case must be edited.
+We edit the *garonne_1* calculation case with the *edit calculation case* command in the context menu of the calculation case.
+You must go to the *Land Cover map* tab with the *Next>* buttons and select the Land Cover Map and
+table of Strickler
 
-Nous poursuivons avec les boutons *Next>* et *Finish* pour valider le cas.
+  |casLandCoverMap|
 
+We continue with the *Next>* and *Finish* buttons to validate the case.
 
-Création d'un champ de STrickler aux noeuds du maillage
-=======================================================
+Creating a Strickler field at mesh nodes
+========================================
 
-Telemac exploite un champ des coefficients de Strickler aux noeuds du maillage. Ce champ a pour nom *BOTTOM_FRICTION*.
-Ce champ est ajouté au fichier MED du maillage, comme le champ d'altitude aux noeuds.
+TELEMAC can use a field of Strickler coefficients at the nodes of the mesh. This field has the name *BOTTOM FRICTION*.
+This field is added to the MED file of the mesh, such as the elevation field at the nodes.
 
-Il faut adapter manuellement le script ci-dessous :
+You have to manually adapt the script below:
 
-Il faut recopier le script ci-dessous et l'adapter en fonction du cas de calcul
-et des noms de de fichiers en entrée et en sortie.
-Il est possible d'utiliser le même fichier MED en entrée et en sortie.
+It is necessary to copy the script below and to adapt it according to the case of computation
+and file names for input and output.
+It is possible to use the same MED file as input and output.
 
 .. literalinclude:: ../interpolStrickler.py
     :lines: 1-
-    
-Nous pouvons voir le champ résultat avec le module MED, comme pour le champ d'altitude.
-    
+
+We can see the result field with the MED module, as for the elevation field.
+
   |BottomFriction|
- 
+
 .. only:: html
- 
-   :ref:`ref_casParticuliers`
+
+   :ref:`ref_english_casParticuliers`