en:tutorials:telemac

Differences

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

en:tutorials:telemac [2021/03/18 11:15] – ylecoareren:tutorials:telemac [2022/01/17 11:26] () – fzaoui
 3:  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.
 61:  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
  
 77:  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.
 107:  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.
 122:  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'//
 129:  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.
 137:  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'//.
 144:  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.
 155:  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]].
 161:  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'//.
 169:  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.
  
 183:  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]]. 
 195:  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.
     - an interactive habitat record for all discharges.     - an interactive habitat record for all discharges.
-  - Create a GIS, 3D and TXT file export.+  - Create GIS, 3D and TXT file exports.
   - View the exported files:   - View the exported files:
     - GIS representing the mesh for all discharges (.gpkg).     - GIS representing the mesh for all discharges (.gpkg).
 230:  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.
 242:  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.
 249:  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.
 271:  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.
 283:  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.
  
  
 302:  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.
 355:  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|}}
 368:  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.1616062517.txt.gz
  • 2021/03/18 11:15
  • ylecoarer