Main Page and Groundwater Overlay: Difference between pages

From Tygron Support wiki
(Difference between pages)
Jump to navigation Jump to search
No edit summary
 
 
Line 1: Line 1:
__NOTOC__
{{stub}}


The groundwater overlay is an implementation of the [[Water model]] optimized for calculating the flow of underground watertables. This implementation focuses on water flowing at a low speed, and on the functioning of the water system without calamitous events such as [[Water model#Breach|breaches]].


<!--Main content-->
==Use cases==
<div style="position:relative; background-color:transparent; margin: 0 -1em;">
The groundwater overlay can be used and is recommended when exploring the following use-cases:
* Modeling a static, low-speed water system
* Modeling the long-term effects of excessive rain or excessive drought on the water table
* Modeling the spread of chemicals through the underground, carried along by water


<!--Menu-->
==Preparing to use the overlay==
<div style="position:relative; background-color:transparent; margin:0px; text-align: center;">
To use the overlay, it is recommended that the project meets a number of prerequisites. Next, data can be prepared which define the functioning and flow of the water model. This includes a clear idea of what kind out output is desired. After that data is prepared, you can begin the actual steps of adding the overlay.
<!--Wrapper-->
<div style="display:inline-block; max-width:1030px;">
{| id="mainpagenavigation" width="100%"
|- class="header"


It is important to model a fully functional static water system for any relevant use of the groundwater overlay. After setting up the static water model, additional effects can be modeled to account for special circumstances. This has the added benefit of creating a control-state, to which results of modifications or calamities can be compared.


! colspan="4" | Welcome
===Prerequisites===
|-
When creating your [[project]], make sure it meets the following [[Water model#Usage|criteria]]:
| class="content separator" colspan="4"|
* Your project has been loaded in with a high-resolution DEM. This can be configured during the [[new project wizard]].
<!--Images-->
* Your project is large enough to account for edge effects. A buffer of at least 1km around your actual project area is recommended.
<imagemap>
* The project's eventual use does not require immediate results. The calculations will take longer than most other calculations in the {{software}}, so sessions with live interaction are discouraged.
Image:Header_image_new.png|975px|left
desc none
</imagemap>
On the Tygron Engine Support Wiki you will find documentation related to the Tygron Engine, including tutorials, a glossary, technical requirements, the roadmap for the Tygron Engine and the latest release notes.
This page provides a start to the most used features in the Tygron Engine. If you can't find what you are looking for, please use the search bar in the upper right corner to search for other articles. If you notice anything is missing or outdated or you want to contact us, please see our email in the Links section.


===Data===
Before creating and configuring the overlay, it is best to prepare the data you wish to use in your model.


|- class="header"
====Geographical data====
The following data needs to be prepared, so that it can be loaded in and used by the water model's calculations:
{{OverlayChecklist|table=true}}
{{OverlayChecklist|Water areas|link=Water model#Water_area|
  importance=Required for proper water levels|
  description=Water areas set the water level of all open water in the area they envelop.}}
{{OverlayChecklist|Ground water|link=Water model#Groundwater_geotiff|
  importance=Required for proper water levels|
  description=The ground water geotiff sets the underground water level.}}
{{OverlayChecklist|Weirs|link=Water model#Weir|
  importance=Required for proper water flow|
  description=Weirs connect otherwise separate sections of open water, allowing water to flow over the weir.}}
{{OverlayChecklist|Culverts|link=Water model#Culvert|
  importance=Required for proper water flow|
  description=Culverts connect otherwise separate sections of open water, allowing water to flow through the culvert.}}
{{OverlayChecklist|Pumps|link=Water model#Pump|
  importance=Required for proper water flow|
  description=Pumps connect otherwise separate sections of open water, moving water unidirectionally from the lower terrain level to the higher terrain level.}}
{{OverlayChecklist|Inlets|link=Water model#Inlet|
  importance=Required for proper water flow into and out of the project area|
  description=Inlets are points in the water model where water is added or removed from the hydrological system.}}
{{OverlayChecklist|Sewer areas|link=Water model#Sewer|
  importance=Recommended for proper water levels|
  description=Sewer areas intersect with [[sewered]] [[constructions]] in the area they envelop to form sewers which can store water.}}
{{OverlayChecklist|Sewer overflows|link=Water model#Sewer_overflow|
  importance=Recommended for proper water flow|
  description=Sewer overflows allow water to flow from a sewer out into open water.}}
{{OverlayChecklist|Chemical producers|link=Water model#Chemical_hotspots|
  importance=Required for modelling chemical flows|
  description=Chemical producers create some quantity of chloride, phosphorus, or nitrogen.}}
{{OverlayChecklist|table-end=true}}


====Calculation properties====
Consider the duration you want your simulation to last, and whether you wish to account for rainfall in your model. The following environmental data needs to be prepared, so that it can be configured and used by the water model's calculations:
{{OverlayChecklist|table=true}}
{{OverlayChecklist|Simulation time|link=Water model#Simulation_time|
  importance=Required|
  description=How long should the simulation last in total. Groundwater calculations often look at timespans of weeks or months.}}
{{OverlayChecklist|Timeframes|link=Water model#Timeframes|
  importance=Recommended|
  description=How many result snapshots should be generated by the calculation, for inspection after the calculation completes.}}
{{OverlayChecklist|Rain|link=Water model#Weather|
  importance=Optional|
  description=How long should rain last at the start of the simulation, and how much rain should fall in total.}}
{{OverlayChecklist|table-end=true}}


! width="25%" | News >>
====Result types====
! width="25%" | Links >>
After the calculation completes, consider what kind of output is relevant to your use-case. The following [[Water model#Result_types|result types]] can be considered, so that it can be configured and used by the water model's calculations:
! width="25%" | Getting started >>
{{OverlayChecklist|table=true}}
! width="25%" | 3D-world interaction >>
{{OverlayChecklist|SURFACE_LAST_VALUE|link=Water model#Result_types|
|-
  importance=Required for insight into amount of water|
| class="content separator" |
  description=The amount of water in any given location.}}
{{OverlayChecklist|UNDERGROUND_LAST_VALUE|link=Water model#Result_types|
  importance=Required for insight into amount of water|
  description=The groundwater level rise in any given location.}}
{{OverlayChecklist|SURFACE_FLOW|link=Water model#Result_types|
  importance=Recommended for insight into movement of water|
  description=The flow of water across the land and water in total.}}
{{OverlayChecklist|EVAPORATED|link=Water model#Result_types|
  importance=Recommended for insight into water leaving the system|
  description=The amount of water which evaporated in total.}}
{{OverlayChecklist|UNDERGROUND_WATERTABLE|link=Water model#Result_types|
  importance=Optional for insight into groundwater|
  description=The groundwater level in any given location, relative to NAP.}}
{{OverlayChecklist|CHLORIDE, NITROGEN, PHOSPHORUS|link=Water model#Result_types|
  importance=Required for insight into chemical flow and impact|
  description=The amount of certain compounds present in any location.}}
{{OverlayChecklist|table-end=true}}


===== =====<!--SECTION-->
==Adding and configuring the overlay==
'''May 18th, 2018'''<br >
{{Editor ribbon|header=current situation|bar=Overlays|dropdown=Groundwater overlay}}
'''Update''' on LTS to [[Version_2018.3.0.2|Version 2018.3.0.2]]


*[[Release_Notes|Older release notes]]<br>
{{Editor steps|title=use the groundwater overlay
*[[Roadmap]]<br>
|Check that your project sufficiently matches the stated {{inlink|prerequisites}}
*[[Ground_Truth_2.0|Ground Truth 2.0 project]]<br>
|Make sure that you have prepared all {{inlink|data}} you wish to use
<!--DONT EDIT BELOW THIS LINE-->
|Add the groundwater overlay to your project
| class="content separator" |
|Start and follow the steps in the [[Water model#Configuration_wizard|configuration wizard]]
|When the configuration wizard is completed, the overlay will automatically recalculate. (If it does not, select [[Grid_overlay#Grid_recalculation|refresh grid]].)
|When the recalculation has completed, you can inspect the results
}}


===== =====<!--SECTION-->
==Data analysis==
*[//www.tygron.com Tygron Website]<br>
When the calculation has completed, results of the calculation inspected by selecting the overlay in the [[session interface]]. The quickest means of inspecting the results are listed here. For a more complete overview, see [[Water_Overlays#Result_analysis|result analysis]].
*[//tygronsupport.freshdesk.com/support/tickets/new Contact Tygron Support]<br>
*[[Alliander:Main_Page|Alliander Edition Wiki]]<br>
<!--DONT EDIT BELOW THIS LINE-->
| class="content separator" |


===== =====<!--SECTION-->
===Overlay map===
*[[Requirements|Hardware requirements]]<br>
To check directly whether the model functions as expected, you can activate the overlay, and see the end-results directly. If multiple [[Water_model#Timeframes|timeframes]] have been recorded, the results can be replayed, to see the progression of the results over time.
*[[Install|Installation]]<br>
*[[Log_in|Logging in]]<br>
*[[Account_Management|User management]]<br>
*[[Wizard|Create a new project]]<br>
*[[Training|Training & Certification]]<br>
<!--DONT EDIT BELOW THIS LINE-->
| class="content" |


===== =====<!--SECTION-->
===Water balance===
*[[Constructions]]<br>
Besides directly inspecting the results geographically, when verifying the functioning of a hydrological model it can be insightful to check the [[Water_model#Water balance|water balance]]. This option allows a net tally of where water ends up in the hydrological system.
*[[Functions]]<br>
*[[Stakeholders]]<br>
*[[Actions]]<br>
*[[Financial_System|Financial system]]<br>
*[[Environment]]<br>
<!--DONT EDIT BELOW THIS LINE-->


==Refining the model==
Based on the results from the initial calculation, you can tweak your data to refine your model. You can update your relevant datasets, and then step through the configuration wizard again.


<!--DONT EDIT BELOW THIS LINE-->
{{Editor steps|title=refine the groundwater overlay
|- class="header"
|Reopen the configuration wizard of the overlay
|In any step where you want to update your data, either change the individual values or clear, and reupload the data
|Skip through all steps which concern data you do not wish to change
|When you finish the configuration wizard, the overlay will automatically recalculate. (If it does not, select [[Grid_overlay#Grid_recalculation|refresh grid]].)
|When the recalculation has completed, you can inspect the results
}}


Every step where no data has changed can be skipped, and the dataset which has been uploaded can be reuploaded in the relevant step. Alternatively, you can do this directly by changing the relevant data in your project. For example, it is possible to directly change the [[attributes]] of [[constructions]].


 
===Saving the results===
 
If the results of the calculation provide a proper baseline hydrological model, the result of the overlay can be [[Grid_overlay#Save_overlay_result|saved]] as an inactive copy. This means that the overlay, including its direct settings and its results, are duplicated into a new overlay. The duplicate is then set to "inactive". This means the data in that overlay won't change as further changes are made. This means you can set up a new scenario in your original overlay, and after performing another calculation compare the results of the first and the second situation.
! Data & Analysis >>
! Impact session >>
! Templates >>
! Tutorials >>
|-
| class="content separator" |
 
===== =====<!--SECTION-->
*[[Geo_Data_Wizard|Import data]]<br>
*[[Calculation_Models|Create a calculation model]]<br>
Default calculation models:  <br>
*[[Rainfall_(Overlay)|Inundation]]<br>
*[[Subsidence_(Overlay)|Subsidence]]<br>
*[[Heat_(Overlay)|Heatstress]]<br>
*[[Livability_(Overlay)|Livability]]<br>
*[[Traffic_Noise_(Overlay)|Traffic noise disturbance]] <br>
*[[Traffic_NO2(Overlay)|Traffic air pollution]]<br>
<!--DONT EDIT BELOW THIS LINE-->
| class="content separator" |
 
===== =====<!--SECTION-->
*[[Project_Session|Setting up a multi-stakeholder session]]<br>
*[[Project_Session_Checklists|Impact session checklist]]<br>
*[[Web_Interface|Create a 2D-viewer for sharing]]<br>
<!--DONT EDIT BELOW THIS LINE-->
| class="content separator" |
 
===== =====<!--SECTION-->
*[[Climategame]]<br>
*[[RE:PEAT|RE:PEAT (subsidence)]]<br>
*[[Waterschadeschatter]]<br>
*[[Stresstest]]<br>
<!--DONT EDIT BELOW THIS LINE-->
| class="content" |
 
===== =====<!--SECTION-->
*[[Practice|Basic skills tutorial]]<br>
*[[Rainfall_Overlay_tutorial|Rainfall Overlay tutorial]]<br>
*[[Panels_tutorial|Panels tutorial]]<br>
*[[Glossary]]<br>
 
<!--DONT EDIT BELOW THIS LINE-->
 
 
|}
</div>
</div>
</div>

Revision as of 08:31, 4 January 2019

This article is a stub.

The groundwater overlay is an implementation of the Water model optimized for calculating the flow of underground watertables. This implementation focuses on water flowing at a low speed, and on the functioning of the water system without calamitous events such as breaches.

Use cases

The groundwater overlay can be used and is recommended when exploring the following use-cases:

  • Modeling a static, low-speed water system
  • Modeling the long-term effects of excessive rain or excessive drought on the water table
  • Modeling the spread of chemicals through the underground, carried along by water

Preparing to use the overlay

To use the overlay, it is recommended that the project meets a number of prerequisites. Next, data can be prepared which define the functioning and flow of the water model. This includes a clear idea of what kind out output is desired. After that data is prepared, you can begin the actual steps of adding the overlay.

It is important to model a fully functional static water system for any relevant use of the groundwater overlay. After setting up the static water model, additional effects can be modeled to account for special circumstances. This has the added benefit of creating a control-state, to which results of modifications or calamities can be compared.

Prerequisites

When creating your project, make sure it meets the following criteria:

  • Your project has been loaded in with a high-resolution DEM. This can be configured during the new project wizard.
  • Your project is large enough to account for edge effects. A buffer of at least 1km around your actual project area is recommended.
  • The project's eventual use does not require immediate results. The calculations will take longer than most other calculations in the Tygron Platform, so sessions with live interaction are discouraged.

Data

Before creating and configuring the overlay, it is best to prepare the data you wish to use in your model.

Geographical data

The following data needs to be prepared, so that it can be loaded in and used by the water model's calculations: Template:OverlayChecklist Template:OverlayChecklist Template:OverlayChecklist Template:OverlayChecklist Template:OverlayChecklist Template:OverlayChecklist Template:OverlayChecklist Template:OverlayChecklist Template:OverlayChecklist Template:OverlayChecklist Template:OverlayChecklist

Calculation properties

Consider the duration you want your simulation to last, and whether you wish to account for rainfall in your model. The following environmental data needs to be prepared, so that it can be configured and used by the water model's calculations: Template:OverlayChecklist Template:OverlayChecklist Template:OverlayChecklist Template:OverlayChecklist Template:OverlayChecklist

Result types

After the calculation completes, consider what kind of output is relevant to your use-case. The following result types can be considered, so that it can be configured and used by the water model's calculations: Template:OverlayChecklist Template:OverlayChecklist Template:OverlayChecklist Template:OverlayChecklist Template:OverlayChecklist Template:OverlayChecklist Template:OverlayChecklist Template:OverlayChecklist

Adding and configuring the overlay

Template:Editor ribbon

How to use the groundwater overlay:
  1. Check that your project sufficiently matches the stated prerequisites
  2. Make sure that you have prepared all data you wish to use
  3. Add the groundwater overlay to your project
  4. Start and follow the steps in the configuration wizard
  5. When the configuration wizard is completed, the overlay will automatically recalculate. (If it does not, select refresh grid.)
  6. When the recalculation has completed, you can inspect the results

Data analysis

When the calculation has completed, results of the calculation inspected by selecting the overlay in the session interface. The quickest means of inspecting the results are listed here. For a more complete overview, see result analysis.

Overlay map

To check directly whether the model functions as expected, you can activate the overlay, and see the end-results directly. If multiple timeframes have been recorded, the results can be replayed, to see the progression of the results over time.

Water balance

Besides directly inspecting the results geographically, when verifying the functioning of a hydrological model it can be insightful to check the water balance. This option allows a net tally of where water ends up in the hydrological system.

Refining the model

Based on the results from the initial calculation, you can tweak your data to refine your model. You can update your relevant datasets, and then step through the configuration wizard again.

How to refine the groundwater overlay:
  1. Reopen the configuration wizard of the overlay
  2. In any step where you want to update your data, either change the individual values or clear, and reupload the data
  3. Skip through all steps which concern data you do not wish to change
  4. When you finish the configuration wizard, the overlay will automatically recalculate. (If it does not, select refresh grid.)
  5. When the recalculation has completed, you can inspect the results

Every step where no data has changed can be skipped, and the dataset which has been uploaded can be reuploaded in the relevant step. Alternatively, you can do this directly by changing the relevant data in your project. For example, it is possible to directly change the attributes of constructions.

Saving the results

If the results of the calculation provide a proper baseline hydrological model, the result of the overlay can be saved as an inactive copy. This means that the overlay, including its direct settings and its results, are duplicated into a new overlay. The duplicate is then set to "inactive". This means the data in that overlay won't change as further changes are made. This means you can set up a new scenario in your original overlay, and after performing another calculation compare the results of the first and the second situation.