Water Module getting started: Difference between revisions

From Tygron Preview Support Wiki
Jump to navigation Jump to search
No edit summary
 
(68 intermediate revisions by 6 users not shown)
Line 1: Line 1:
{{Water Module buttons}}
[[File:Flooding_overview.png|300px|middle]]
[[File:Flooding_overview.png|300px|middle]]


There are several approaches for getting started with the [[Water_Module|Water Module]]:
There are several approaches for getting started with the [[Water_Module|Water Module]], which are listed below.
 


=== Tutorials ===
=== Tutorials ===
* If you want to start by practising with the basics of the Water Module in a real situation, follow the [[Rainfall_Overlay_tutorial|Rainfall Overlay Tutorial]]
* If you want to start by practising with the basics of the Water Module in a theoretical setting, follow the [[Testbed_tutorial|Testbed Tutorial]].
* If you want to start by practising with the basics of the Water Module in a theoretical setting, follow the [[Testbed_tutorial|Testbed Tutorial]].
* If you want to start by practising with the basics of the Water Module in a real situation, follow the [[Rainfall_Overlay_tutorial|Rainfall Overlay Tutorial]]


=== How-to's and instructions for specific configurations ===
=== Testbeds ===
* If you prefer to get started with setting up the water model in a project area of your own choice, follow the steps in [[Basic_water_model_use_case_(Water_Overlay)|How to create a Basic Water Model]].
* More examples of specific configurations of the water overlays are found on our [[How_to_configure_the_Water_Overlays| 'How to']] Instructions Page
 
=== Test beds ===
* If you would like to get familiar with the different components of the Water Module first, check out the [[Testbed_water_module|Water Module Testbed]]. This Testbed is available to you as a project in the {{software}}.
* If you would like to get familiar with the different components of the Water Module first, check out the [[Testbed_water_module|Water Module Testbed]]. This Testbed is available to you as a project in the {{software}}.


==Also See==
=== How-to's and instructions for specific configurations ===
[[Getting_started|Getting started]] with the {{software}}.
More examples of specific configurations of the water overlays are found on our [[How_to_configure_the_Water_Overlays| 'Configurations']] Page
<br style="clear right">


====Water Overlays====
*[[Basic_water_model_use_case_(Water_Overlay)|How to configure a Water Overlay]]
* [[How to add a timeframe for initial conditions of a simulation (Water Overlay)]]
* [[How to configure two overlays with different settings for hydraulic structures and hydrological features]]


====Buildings====
*[[How to add and configure hydraulic structures (Water Overlay)]]


{{Water Module buttons}}
====Breach====
*[[How to add a breach with external area manually]]
*[[How to add a breach with input area manually]]
*[[How to import a breach with input area]]
*[[How to set dynamic breach height]]
*[[How to visualize multiple sequential breaches (Water Overlay)]]
* [[How to simulate water overflowing river barrier]]


====Sewers====
*[[How to add sewer data (Water Overlay)]]
*[[How to generate a sewer]]
*[[How to import sewers]]
*[[How to import sewer overflows]]


<!--
====Evaporation====
Getting started with the [[Water Module|water module]] in the {{software}} can seem to be a difficult process. By following a few basic steps and completing the [[Wizard|wizard]] belonging to the selected [[Water Overlay|water overlay(s)]], completing this process will be much easier.
*[[How to load in dynamic evaporation rate (Water Overlay)]]
*[[How to set linear evaporation rate (Water Overlay)]]
====Rainfall====
*[[How to set linear rain and simulation time (Water Overlay)]]
*[[How to load in dynamic rain and simulation time (Water Overlay)]]
*[[How to create a Rain area]]
*[[How to add rain barrels to your project]]


To use the water module and its calculations in the [[3D World|three dimensional world]] of the {{software}}, a couple of [[Overlay|overlays]] are available. These overlays use the water module to calculate and simulate the water model in the project area. Results will be visualized as a two dimensional layer imposed over the 3D world.
====Surface====
*[[How to import a GeoJSON of waterways]]
*[[How to import a GeoTIFF of waterway depths]]
*[[How to investigate increasing water levels in waterways]]


It is possible to map the results of a simulation over time, by using the [[Timeframes model attribute (Water Overlay)|timeframes]] function. This will enable the overlay to "play" the simulation over time, independent of the session time settings.
====Groundwater====
<br clear=all>
*[[How to upload and use a groundwater GeoTIFF (Water Overlay)]]
==Preparing the project==
*[[How to use a default groundwater GeoTIFF (Water Overlay)]]
To be able to use the water module, a valid project needs to be loaded in the editor of the {{software}}.<br>
*[[How to generate an initialized groundwater situation]]
#<code>Start the {{software}} client.</code><br>
#<code>Create or load a project at the required location.</code><br>
<gallery>
File:LogIn1.png|thumb|200px|Start the client and log in
File:CreateOrLoadProject1.png|200px|Load or create a project in the [[Editor]]
File:ProjectInEditor1.png|200px|Project is loaded and ready in the Editor
</gallery>


==Selecting the overlay==
{{article end
When the project is loaded in to the editor, we are ready to start using the water module. To do so, we need to select the water overlay that best suits the needs of our project.
|seealso=* [[Getting started]]
<gallery>
}}
File:SelectCurrentSituation1.jpg|1. Select 'Current Situation'
{{Water Module buttons}}
File:SelectOverlay2.jpg|2. Select Overlays
File:SelectWaterOverlayPopUp1.jpg|3. Select desired Water Overlay from pop up menu
</gallery>
The table below shows all available water overlays and a short description of these overlays.
{| class="wikitable"
||[[File:Overlay_rainfall.png]]
|[[Rainfall_(Overlay)|Rainfall Overlay]]
|provides insight into the water stress and impact caused by (excessive) rainfall
|-
||[[File:Overlay_flooding.png]]
|[[Flooding_(Overlay)|Flooding Overlay]]
|provides insight into water stress and impact caused by breaches in levees or other sources causing excessive water inflow
|-
||[[File:Overlay_groundwater.png]]
|[[Groundwater_(Overlay)|Groundwater Overlay]]
|provides insight into long-term processes of water flow both on the surface and underground
|}
 
When the overlay is added, the water module will immediately calculate the results. Based on the size of the project area and the size of the [[Grid overlay|grid cell]], this can take a while. The results of this initial calculation are based on default settings of the overlay, which are often not that accurate.
<gallery>
File:Rainfall-Overlay.jpg|thumb|right|200px|Rainfall overlay
File:FloodingOverlay2.png|right|thumb|200px|Flooding overlay
File:GroundwaterOverlay2.png|right|thumb|200px|Groundwater overlay
</gallery>
==Water Module Results==
There are four main methods to view results from a water overlay:
===The actual 2D overlay with mini map===
When the water overlay that was just added is selected, the overlay will be imposed as a 2D layer over the 3D world. When the overlay icon on the right side of the main view is selected, a mini map appears that enables navigating in the 3D world while using the overlay image as guide.
<gallery>
File:RainfallOverlay3.jpg|2D Water Overlay (Rainfall) selected
File:RainfallOverlayminiMap1.jpg|Rainfall Overlay Mini Map
</gallery>
 
===A running simulation of the overlay===
When the water overlay is selected, 'player' buttons become available in the legend of the overlay. These buttons enable to play/ pause and skip forward and backward in the overlay simulation.
<gallery>
File:GridOverlayPlayerBtns2.jpg|'Player' buttons in Legend
File:PlaceholderImg1.png|Simulation (GIF)
</gallery>
 
===A hover panel with relevant information for a speciffic point in the 3D world===
With the water overlay selected, when clicking on a point in the 3D world, a hover panel appears, containing data and results related to the selected overlay.
<gallery>
File:RainfallHoverpanel1.jpg|Rainfall overlay hover panel
</gallery>
 
===Results from the measurement tool(point/ distance)===
By using the [[Measuring tool|overlay measurement tool]] with the water overlay selected, measurements over time (using the timeframes) can be made, both for point and for line distances. These measurements can be stored and retrieved for later use too.
<gallery>
File:PointMeasurementRainfall1.jpg|Point measurement
File:LineMeasurementRainfall1.jpg|Line measurement
File:StoredMeasurementsRainfall1.jpg|Stored measurements
</gallery>
 
==Further configuration of the overlay==
[[File:GridOverlayRightSidePanel1.png|right|thumb|left|Grid overlay right side panel]]
To make the overlay calculations more accurate and better suitable for the actual situation at hand, some configurations can be made to the overlay. Some are directly accesible from the editor, but most configurations can be done in the dedicated wizards.
===Grid cell size===
[[File:GridCellWarning1.png|left|thumb|Grid cell warning]]<br clear=left>
When a grid based overlay is added to a project, the default size of 10m x 10m is usually not acurate enough. This will be indicated by a (yellow flashing) warning on the right side panel when the overlay is selected. This grid size can be adjusted by selecting the "Change grid" option on the right side panel. Selecting this option opens a new panel. When adjusting the grid size, please note that the smaller the grid size, the longer the calculations will take. If the new grid size is set to 5m x 5m, the amount of cells quadruples. A grid of 4 cells will now contain 16 cells!
<gallery>
File:AdjustGridSizePanel1.png|thumb|Adjust Grid size panel
File:GridSize1.png|thumb|Changing grid size from 10x10m to 5x5m
</gallery><br>
 
===Result type===
[[File:ResultTypeDropDownMenu1.jpg|thumb|200px|left|Result type drop down menu]]
From the right side panel it is also possible to select which [[Result type (Water Overlay)|result type]] is used for the overlay. Only one result type per overlay can be selected, however, in the wizard it is possible to select multiple result types as child overlays, to complement the main result type selected here.
 
Result types such as [[Waterstress result type (Water Overlay)|WATER_STRESS]] or [[Surface last value result type (Water Overlay)|SURFACE_LAST_VALUE]] are good choices to begin with here.<br clear=left>
 
===Calculation preference===
This option is a choice between fast but less accurate calculations ("Speed"), accurate but slow calculations ("Accuracy") or an average ("Avg") setting in between "Speed" and "Accuracy" settings.
[[File:SetCalculationPrefs1.jpg|thumb|left|Set calculation preferences]]<br clear=left>
===Overlay wizards===
For each of the above mentioned water overlays, a dedicated [[Water Overlay Wizard|water overlay wizard]] is available for further configuration of the overlay. These wizards will take a user step by step through this configuration proces. In the table below are direct links to more infomation about these wizards.
{| class="wikitable"
!colspan="6"|Water Overlay Wizards
|-
||[[File:Overlay_rainfall.png]]
|[[Rainfall Overlay Wizard]]
||[[File:Overlay_flooding.png]]
|[[Flooding Overlay Wizard]]
||[[File:Overlay_groundwater.png]]
|[[Groundwater Overlay Wizard]]
|}
 
==How-to's==
* [[How-to add and remove an overlay|Add and remove an overlay]]
* [[How-to edit an overlay legend|Edit an overlay legend]]
 
 
<br style="clear right">

Latest revision as of 16:50, 30 January 2024


Flooding overview.png

There are several approaches for getting started with the Water Module, which are listed below.

Tutorials

  • If you want to start by practising with the basics of the Water Module in a real situation, follow the Rainfall Overlay Tutorial
  • If you want to start by practising with the basics of the Water Module in a theoretical setting, follow the Testbed Tutorial.

Testbeds

  • If you would like to get familiar with the different components of the Water Module first, check out the Water Module Testbed. This Testbed is available to you as a project in the Tygron Platform.

How-to's and instructions for specific configurations

More examples of specific configurations of the water overlays are found on our 'Configurations' Page

Water Overlays

Buildings

Breach

Sewers

Evaporation

Rainfall

Surface

Groundwater

See also