en:tutorials:telemac

Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Both sides previous revision Previous revision
Next revision		 Previous revision
en:tutorials:telemac [2021/03/18 11:28] – ylecoareren:tutorials:telemac [2022/01/17 11:26] (current) – fzaoui
Line 3: Line 3:
 ===== Preamble ===== ===== Preamble =====
  
-The objective of this tutorial is to model the habitat of the adult river barbel from several TELEMAC 2D hydraulic simulations. The results will be visualised in interactive figures, in GIS output and in 3D. The main steps are as follows:+The objective of this tutorial is to model the habitat of the adult barbel from several TELEMAC 2D hydraulic simulations. The results will be visualised in interactive figures, in GIS output and in 3D. The main steps are as follows:
  
   - TELEMAC data will be read by the software to create a hydraulic .hyd file.   - TELEMAC data will be read by the software to create a hydraulic .hyd file.
   - The substrate data will be read by the software to create a .sub substrate file.   - The substrate data will be read by the software to create a .sub substrate file.
   - The .hyd and .sub files will be merged into a .hab file from which HABBY can perform habitat calculations.   - The .hyd and .sub files will be merged into a .hab file from which HABBY can perform habitat calculations.
-  - The biological model of the adult river barbel will be selected.+  - The biological model of the adult barbel will be selected.
   - The habitat calculation will be performed.   - The habitat calculation will be performed.
   - The results will then be visualised and exported.   - The results will then be visualised and exported.
Line 61: Line 61:
  
   substrate_classification_code=Sandre   substrate_classification_code=Sandre
-  substrate_classification_method=coarser-dom+  substrate_classification_method=coarser-dominant
   default_values=12, 12   default_values=12, 12
  
Line 77: Line 77:
 {{:en:tutorials:tuto_projet_creation.png?700|}} {{:en:tutorials:tuto_projet_creation.png?700|}}
  
-  * If necessary, change the <hi #9BFFFF>**Projects folder:**</hi>, by clicking on **[Change folder]**.+  * If necessary, change the <hi #9BFFFF>**Projects folder:**</hi>, by clicking on {{:wiki:recherche_fichier_icon.png?20|}}.
   * Enter in <hi #9BFFFF>**Project name:**</hi>: //'Tuto_TELEMAC'//.   * Enter in <hi #9BFFFF>**Project name:**</hi>: //'Tuto_TELEMAC'//.
   * Choose in <hi #9BFFFF>**Project type:**</hi>: //'physique'//.   * Choose in <hi #9BFFFF>**Project type:**</hi>: //'physique'//.
-  * Click on **[Create Project]**.+  * Click on <hi #47B5E6>**[Create Project]**</hi>.
  
 The project is then created and gives you access to new tabs. The project is then created and gives you access to new tabs.
Line 107: Line 107:
 {{:en:tutorials:tuto_hyd_creation.png?700|}} {{:en:tutorials:tuto_hyd_creation.png?700|}}
  
-  * If this information is valid, you can start the calculation by pressing the **[Create 1 file .hyd]** button.+  * If this information is valid, you can start the calculation by pressing the <hi #47B5E6>**[Create 1 file .hyd]**</hi> button.
  
 Once the process is complete, a file 'd1_to_d9.hyd' is created. Once the process is complete, a file 'd1_to_d9.hyd' is created.
Line 122: Line 122:
     * <hi #9BFFFF>**File (.shp, .gpkg)**</hi>: //'sub_PolygonSandreCoarser-dom.shp'//     * <hi #9BFFFF>**File (.shp, .gpkg)**</hi>: //'sub_PolygonSandreCoarser-dom.shp'//
     * <hi #9BFFFF>**Classification code:**</hi>: //'Sandre'//     * <hi #9BFFFF>**Classification code:**</hi>: //'Sandre'//
-    * <hi #9BFFFF>**Classification method:**</hi> : //'coarser-dom'//+    * <hi #9BFFFF>**Classification method:**</hi> : //'coarser-dominant'//
     * <hi #9BFFFF>**Default values**</hi> : //'12, 12'//     * <hi #9BFFFF>**Default values**</hi> : //'12, 12'//
     * <hi #9BFFFF>**EPSG code**</hi>: //'2154'//     * <hi #9BFFFF>**EPSG code**</hi>: //'2154'//
Line 129: Line 129:
 {{:en:tutorials:tuto_sub_creation.png?700|}} {{:en:tutorials:tuto_sub_creation.png?700|}}
  
-  * If the information displayed in this tab is valid, you can start the calculation by pressing the **[Create .sub file]** button.+  * If the information displayed in this tab is valid, you can start the calculation by pressing the <hi #47B5E6>**[Create .sub file]**</hi> button.
  
 Once the process is finished, a file 'sub_PolygonSandreCoarser-dom.sub' is created. Once the process is finished, a file 'sub_PolygonSandreCoarser-dom.sub' is created.
Line 137: Line 137:
 ==== Creating a .hab file ==== ==== Creating a .hab file ====
  
-  * Stay in the <hi #9BFFFF>**Substrat**</hi> tab.+  * Stay in the <hi #9BFFFF>**Substrate**</hi> tab.
   * In the <hi #9BFFFF>**Merging of hydraulics and substrate data**</hi> group, check that the file names are selected for:   * In the <hi #9BFFFF>**Merging of hydraulics and substrate data**</hi> group, check that the file names are selected for:
     * <hi #9BFFFF>**.hyd filename**</hi>: //'d1_to_d9.hyd'//.     * <hi #9BFFFF>**.hyd filename**</hi>: //'d1_to_d9.hyd'//.
Line 144: Line 144:
 {{:en:tutorials:tuto_hab_creation.png?700|}} {{:en:tutorials:tuto_hab_creation.png?700|}}
  
-  * Then launch the merge with the **[Create .hab file]** button.+  * Then launch the merge with the <hi #47B5E6>**[Create .hab file]**</hi> button.
  
 Once the process is finished, a //'d1_to_d9_sub_PolygonSandreCoarser-dom.hab'// file is created. Once the process is finished, a //'d1_to_d9_sub_PolygonSandreCoarser-dom.hab'// file is created.
Line 155: Line 155:
   * Open the tab <hi #9BFFFF>**Calc. Habitat**</hi> tab.   * Open the tab <hi #9BFFFF>**Calc. Habitat**</hi> tab.
   * Check for <hi #9BFFFF>**Habitat File(s)**</hi> that the //'d1_to_d9_sub_PolygonSandreCoarser-dom.hab'// file is selected.   * Check for <hi #9BFFFF>**Habitat File(s)**</hi> that the //'d1_to_d9_sub_PolygonSandreCoarser-dom.hab'// file is selected.
-  * To add biological models to be calculated, click on the **[Add Models]** button.+  * To add biological models to be calculated, click on the <hi #9BFFFF>**[Add Models]**</hi> button.
  
 This opens the [[en:user_guide:explo_biological_models|biological model explorer]]. This opens the [[en:user_guide:explo_biological_models|biological model explorer]].
Line 161: Line 161:
   * In the first tab <hi #9BFFFF>**Model filter**</hi>, refine your search by the following criteria:   * In the first tab <hi #9BFFFF>**Model filter**</hi>, refine your search by the following criteria:
     * <hi #9BFFFF>**Country**</hi>: //'France'//.     * <hi #9BFFFF>**Country**</hi>: //'France'//.
-    * <hi #9BFFFF>**Type of aquatic animal**</hi>: //'fish'//.+    * <hi #9BFFFF>**Aquatic animal type**</hi>: //'fish'//.
     * <hi #9BFFFF>**Stage and size**</hi>: //'adult'//.     * <hi #9BFFFF>**Stage and size**</hi>: //'adult'//.
     * <hi #9BFFFF>**Code alternative filter**</hi> : //'BAF'//.     * <hi #9BFFFF>**Code alternative filter**</hi> : //'BAF'//.
Line 169: Line 169:
   * In the second tab <hi #9BFFFF>**Model selection**</hi>:   * In the second tab <hi #9BFFFF>**Model selection**</hi>:
     * Click on the model //'Barbus barbus - adult - BAF01'// in the left-hand list <hi #9BFFFF>**Available models**</hi>.      * Click on the model //'Barbus barbus - adult - BAF01'// in the left-hand list <hi #9BFFFF>**Available models**</hi>. 
-    * (Optional) You can click on **[Show habitat suitability indices]** to display the biological model in an interactive figure +    * (Optional) You can click on <hi #9BFFFF>**[Show habitat suitability indices]**</hi> to display the biological model in an interactive figure 
-    * Drag and drop from left to right the //'Barbus barbus - adult - BAF01'// model into the right-hand list <hi #9BFFFF>**Selected models (0)**</hi>.+    * Drag and drop from left to right the //'Barbus barbus - adult - BAF01'// model into the right-hand list <hi #9BFFFF>**Selected models**</hi>.
  
 {{:en:tutorials:tuto_calc_hab_glisser_dep.png?700|}} {{:en:tutorials:tuto_calc_hab_glisser_dep.png?700|}}
  
-    * Validate with the **[Validate selected models]** button.+    * Validate with the <hi #9BFFFF>**[Validate selected models]**</hi> button.
 The model //'Barbus barbus - adult - BAF01'// has been added to the list of models to be calculated. The model //'Barbus barbus - adult - BAF01'// has been added to the list of models to be calculated.
  
Line 183: Line 183:
 {{:en:tutorials:tuto_calc_hab.png?700|}} {{:en:tutorials:tuto_calc_hab.png?700|}}
  
-  * You can now start the habitat calculation for the adult river barbel with the **[Compute habitat]** button.+  * You can now start the habitat calculation for the adult barbel with the <hi #47B5E6>**[Compute habitat]**</hi> button.
  
-Once the process is finished, the result of the model 'BAF01_adult_HV_Dominant' has been added to the file 'd1_to_d9_sub_PolygonSandreCoarser-dom.hab'. By default, at each calculation, the text habitat calculation result file is created: 'd1_to_d9_sub_PolygonSandreCoarser-dom_spu.txt' describing the habitat values and the weighted usable area of adult river barbel for each simulated discharge.+Once the process is finished, the result of the model 'BAF01_adult_HV_Dominant' has been added to the file 'd1_to_d9_sub_PolygonSandreCoarser-dom.hab'. By default, at each calculation, the text habitat calculation result file is created: 'd1_to_d9_sub_PolygonSandreCoarser-dom_spu.txt' describing the habitat values and the weighted usable area of adult barbel for each simulated discharge.
  
 You can view the results in detail, either via the figures or via exports from the [[en:guide_utilisateur:modeles_2d:data_explorer|explorateur de données]].  You can view the results in detail, either via the figures or via exports from the [[en:guide_utilisateur:modeles_2d:data_explorer|explorateur de données]]. 
Line 195: Line 195:
 === Preamble === === Preamble ===
  
-In this tutorial, for the adult river barbel, we will :+In this tutorial, for the adult barbel, we will :
   - Create figures to visualise:   - Create figures to visualise:
     - an interactive habitat map for a discharge of 74.7 m<sup>3</sup>/s.     - an interactive habitat map for a discharge of 74.7 m<sup>3</sup>/s.
Line 230: Line 230:
       * <hi #9BFFFF>**mode**</hi>: //'interactive'//.       * <hi #9BFFFF>**mode**</hi>: //'interactive'//.
  
-  * Start the figure creation process with the **[run]** button.+  * Start the figure creation process with the <hi #47B5E6>**[run]**</hi> button.
  
 An interactive habitat map is then displayed. An interactive habitat map is then displayed.
Line 242: Line 242:
   * In this group <hi #9BFFFF>**Figure viewer/exporter**</hi>, choose:   * In this group <hi #9BFFFF>**Figure viewer/exporter**</hi>, choose:
     * <hi #9BFFFF>**tronçon(s)**</hi>: //'Tronçon D'//.      * <hi #9BFFFF>**tronçon(s)**</hi>: //'Tronçon D'//. 
-    * <hi #9BFFFF>**discharge [m<sup>3</sup>/s]**</hi>: all discharges (from //'9.2'// to //'259'//).  +    * <hi #9BFFFF>**discharge [m<sup>3</sup>/s]**</hi></hi>: all discharges (from //'9.2'// to //'259'//).  
-    * <hi #9BFFFF>**variables to mesh**</hi>: //'BAF01_adult_HV_Dominant'//. +    * <hi #9BFFFF>**mesh variables**</hi>: //'BAF01_adult_HV_Dominant'//. 
     * Figure options:     * Figure options:
       * <hi #9BFFFF>**map**</hi>: disabled.       * <hi #9BFFFF>**map**</hi>: disabled.
Line 249: Line 249:
       * <hi #9BFFFF>**mode**</hi>: //'interactive'//.       * <hi #9BFFFF>**mode**</hi>: //'interactive'//.
  
-  * Start the figure creation process with the **[run]** button.+  * Start the figure creation process with the <hi #47B5E6>**[run]**</hi> button.
  
 An interactive habitat chronicle is then displayed. An interactive habitat chronicle is then displayed.
Line 271: Line 271:
 {{:en:tutorials:tuto_data_explorer_export.png?700|}} {{:en:tutorials:tuto_data_explorer_export.png?700|}}
  
-  * Start the export process with the **[run]** button.+  * Start the export process with the <hi #47B5E6>**[run]**</hi> button.
  
 At the end of the process, all the requested files have been exported. At the end of the process, all the requested files have been exported.
Line 283: Line 283:
   * Open this file 'd1_to_d9_sub_PolygonSandreCoarser-dom_Troncon D_mesh.gpkg' in the project directory ('...\Tuto_TELEMAC\output\GIS') in your GIS software.    * Open this file 'd1_to_d9_sub_PolygonSandreCoarser-dom_Troncon D_mesh.gpkg' in the project directory ('...\Tuto_TELEMAC\output\GIS') in your GIS software. 
  
-This Geopackage file contains several layers (each equivalent to a Shapefile). Either a layer of triangular polygons (mesh data) for each discharge.+This Geopackage file contains several layers (each equivalent to a Shapefile) of triangular polygons (mesh data) for each discharge.
  
 {{:fr:tutorials:tuto_qgis.png?850|}} {{:fr:tutorials:tuto_qgis.png?850|}}
  
-The attribute tables of these layers contain all the gridded data including the habitat data of the adult river barbel.+The attribute tables of these layers contain all the mesh data including the habitat data of the adult barbel.
  
  
Line 302: Line 302:
 {{:fr:tutorials:tuto_paraview_stl.png?600|}} {{:fr:tutorials:tuto_paraview_stl.png?600|}}
  
-In a third step, we will look at the exports <hi #9BFFFF>**3D (.pvd, .vtu) Mesh by units**</hi>, namely:+In a third step, we will look at the exports <hi #9BFFFF>**3D (.pvd, .vtu) Mesh units**</hi>, namely:
   * the file 'd1_to_d9_sub_PolygonSandreCoarser-dom_Troncon D_water level.pvd'.    * the file 'd1_to_d9_sub_PolygonSandreCoarser-dom_Troncon D_water level.pvd'. 
   * the 'd1_to_d9_sub_PolygonSandreCoarser-dom_Troncon D_XXXX_water level.vtu' files.   * the 'd1_to_d9_sub_PolygonSandreCoarser-dom_Troncon D_XXXX_water level.vtu' files.
Line 355: Line 355:
   * If necessary, close the <hi #9BFFFF>**Data available**</hi> group.   * If necessary, close the <hi #9BFFFF>**Data available**</hi> group.
   * If necessary, click on the <hi #9BFFFF>**Desired data**</hi> group to open it.   * If necessary, click on the <hi #9BFFFF>**Desired data**</hi> group to open it.
-  * Select the discharge chronicle file //'discharge_chronicle.txt'// with the **[run]** button of the group <hi #9BFFFF>**from .txt file**</hi>.+  * Select the discharge chronicle file //'discharge_chronicle.txt'// with the <hi #47B5E6>**[load and run]**</hi> button of the group <hi #9BFFFF>**from .txt file**</hi>.
  
 {{:en:tutorials:tuto_interp_target.png?700|}} {{:en:tutorials:tuto_interp_target.png?700|}}
Line 368: Line 368:
 {{:en:tutorials:tuto_interp_resultgui.png?700|}} {{:en:tutorials:tuto_interp_resultgui.png?700|}}
  
-  * Click the **[run]** button of <hi #9BFFFF>**View interpolated chronicle:**</hi> to display the interpolated chronicle.+  * Click the <hi #47B5E6>**[run]**</hi> button of <hi #9BFFFF>**View interpolated chronicle:**</hi> to display the interpolated chronicle.
  
 {{:en:tutorials:tuto_interp_chronique_mpl.png?500|}} {{:en:tutorials:tuto_interp_chronique_mpl.png?500|}}
  
  
  • en/tutorials/telemac.1616063337.txt.gz
  • Last modified: 2021/03/18 11:28
  • by ylecoarer