How to configure the Water Overlays: Difference between revisions

From Tygron Preview Support Wiki
Jump to navigation Jump to search
No edit summary
No edit summary
 
(67 intermediate revisions by 7 users not shown)
Line 1: Line 1:
{{being_updated}}
{{being_updated}}
This page describes several use cases and examples of configurations in different [[Water Overlay|water overlays]] based on the [[Water module|water module]].
This page describes how to realize specific use cases by using the [[Water Module|water module]].
==Simulate a levee breach scenario 1==
In this scenario we want to simulate a levee breach near an adjacent waterbody. ''In this example, the whole waterbody is present in the 3D project.'' This is important to notice, to model the correct volume of the waterbody. If your waterbody is too large or your project is smaller, you can model the breach area differently, see therefore the use case below.
In this scenario you would want to have the breach connected to the water body, since we are going to use the water level of the waterbody to determine the flooding.  


In the steps here, the breach area is drawn in the Editor. It is also possible to import a [[GeoJSON]] file with the location of the breach.
==Water system model==
* [[How to import a GeoTIFF of waterway depths]]
* [[How_to_add_Subsidence_(Water_Overlay)|Add subsidence calculation results to a water system's input]]


{{Editor steps|title= set-up the breach area
==Flooding==
|In the Editor go to GEO Data --> Areas
These configurations can be implemented best using the [[Flooding (Overlay)|Flooding Overlay]].
|Add a new area by clicking in the bottom left corner.
* [[Visualize levee breach from water body inside project area use case (Water Overlay)|Visualize levee breach from water body inside project area (river, small lake)]]
|Select the newly created area (named Area) and give it a fitting name on the right
* [[Visualize levee breach from water body outside project area use case (Water Overlay)|Visualize levee breach with water from outside the project area (large lake, sea)]]
|Zoom in to the location where you want to have the breach and click on the Adjust area button
* [[Flood_wave_use_case_(Water_Overlay)|Create a flood wave across a river]]
|Select the location of your breach and click on Apply settings. Make sure the breach is connected to the water body.
<!--===Rain===
|Go to the tab attributes and set the breach floor attribute by adding the attribute name, value and clicking on save.
These configurations can be implemented best using the [[Rainfall (Overlay)|Rainfall Overlay]].
}}
* [[Rain_in_project_area_use_case_(Water_Overlay)|Rain falling in the project area]]-->
<gallery mode=nolines>
File:Create_area.JPG
File:Location_area.JPG
File:Draw_area.JPG
File:Area_attributes.JPG
</gallery>


{{Editor steps|title= configure the flooding
==Water shortage==
|Add a [[Flooding_(Overlay)|Flooding Overlay]] and go to the [[Water_Overlay#Configuration_Wizard|Configuration Wizard]] of the Flooding Overlay.
These configurations can be implemented best using the [[Groundwater (Overlay)|Groundwater Overlay]].
|In step 2.1 select the attribute that specifies your breach floor so the software knows which area is your breach area.
* [[Drought_excessive_drain_use_case_(Water_Overlay)|Drought from excessive drains in the project area]]
|Click on ''Next''.
* [[Drought_excessive_evaporation_use_case_(Water_Overlay)|Drought from excessive evaporation in the project area]]
|In the dropdown menu choose the name of your breach area and check if the attributes correspond with what you have set as attributes or change them here.
|In step 2.2 import your water level areas with at least a water level attribute.
|Finish the Wizard and refresh the Overlay.
|After the flooding is calculated, check the [[Water_Overlay#Show_Water_Balance|Water Balance]] to get more insight in your scenario.
}}
<gallery mode=nolines>
</gallery>


==Simulate a levee breach scenario 2==
==Water quality==
In this scenario we want to simulate a levee breach near an adjacent water body, ''but in this case, the water body is not fully in 3D in the project.'' For example, if your project is of a part of Flevoland and you don't want to create a project of the whole IJsselmeer, you can simulate the flooding by the IJsselmeer.
* [[How to trace water through project area (Water Overlay)|How to trace water flow in a hydrological system over time]]
In this scenario you would not want to have the breach connected to the water body, since we are not going to import the water level of this water body. This means the water body will not have a water level and thus the flooding will go to the lowest point which is probably to the water body and not the land.


In the steps here, the breach area is drawn in the Editor. It is also possible to import a [[GeoJSON]] file with the location of the breach.
==Stationary analyses==
* [[Calculate_stable_water_level_use_case_(Water_Overlay)|Manually calculate at what level the water level is stable]]


{{Editor steps|title= set-up the breach area
{{WaterOverlay usecases nav}}
|In the Editor go to GEO Data --> Areas
[[Category:How-to's]][[Category:Water]]
|Add a new area by clicking in the bottom left corner.
|Select the newly created area (named Area) and give it a fitting name on the right
|Zoom in to the location where you want to have the breach and click on the Adjust area button
|Select the location of your breach and click on Apply settings. Make sure the breach is not connected to the water body and ideally draw it on the inside of the dike. 
|Go to the tab attributes and add the [[Flooding_(Overlay)#Define_a_Breach_area|breach floor attribute]] and the [[Flooding_(Overlay)#Define_a_Breach_area|outlet capacity]]. The outlet capacity is the volume of the waterbody. Also add either the [[Flooding_(Overlay)#Define_a_Breach_area|outlet Q]] or the [[Flooding_(Overlay)#Define_a_Breach_area|outlet level]] to determine how much water will flow through the breach.
}}
<gallery mode=nolines>
File:Breach_scenario_2.JPG
</gallery>
 
{{Editor steps|title= configure the flooding
|Then follow the steps above to configure the flooding.
|In step 2.2 when you import the water level areas, don't import the water level area for the large water body near your breach area.
|Finish the Wizard and refresh the Overlay.
|After the flooding is calculated, check the [[Water_Overlay#Show_Water_Balance|Water Balance]] to get more insight in your scenario.
}}
<gallery mode=nolines>
File:Waterbalance_scenario2.JPG
</gallery>
 
==Time-controlled flow rate in a breach area==
To create a variable Outlet Q in a breach area, a CSV (comma-separated values) file can be imported.
Below the steps on how to create such a breach area. For this example we create the CSV in Excel, but you can also use another program to create the CSV.
{{Editor steps|title= set-up your CSV in Excel
|Open Excel.
|In the first column, define your time steps. This can be in seconds, minutes, hours or days.
|Add the corresponding flow rates per step in the second column.
|Save the Excel as a CSV.
}}
<gallery mode=nolines>
File:Csv_example.JPG
File:Save.JPG
</gallery>
{{Editor steps|title= import the CSV as the flow rate
|Either add a breach area or have your [[GeoJSON]] file with your breach area ready. The area should have at least a [[Flooding_(Overlay)#Define_a_Breach_area|breach floor attribute]].
|Add a [[Flooding_(Overlay)|Flooding Overlay]].
|Go to the [[Water_Overlay#Configuration_Wizard|Configuration Wizard]] of the Flooding Overlay.
|In step 2.1 either select the attribute that specifies your breach floor or import your [[GeoJSON]] file.
|Click on ''Next''.
|In the dropdown menu, select your breach area. Now click on ''Edit''.
|Import your CSV file by selecting the CSV file.
|Select the time units in your file.
|Select the seperator for your file.
|Click on Apply.
}}
<gallery mode=nolines>
File:Select_breach.JPG
File:Edit_breach.JPG
File:Import_csv.JPG
File:Time_units.JPG
File:Seperator.JPG
File:Apply_file.JPG
</gallery>
 
==Multi breach simulation==
It is also possible to simulate a situation in where there is first one levee breach, following by another (or multiple).
Therefore we also make use of the variable Outlet Q and a CSV file as mentioned above in the previous use case. In the steps below, two breaches are demonstrated, but the same steps apply to multiple breaches.
{{Editor steps|title= set up a multi breach scenario
|First create a CSV file in where you structure the data in a way that at the start of the simulation, the outlet is 0. See for an example the image below.
|Either add two breach areas or have your [[GeoJSON]] file with your breach areas ready. The areas should have at least a [[Flooding_(Overlay)#Define_a_Breach_area|breach floor attribute]].
|Add a [[Flooding_(Overlay)|Flooding Overlay]].
|Go to the [[Water_Overlay#Configuration_Wizard|Configuration Wizard]] of the Flooding Overlay.
|In step 2.1 either select the attribute that specifies your breach floor or import your [[GeoJSON]] file.
|Click on ''Next''.
|In the dropdown menu, select the breach area that breaks second.
|Click on ''Edit'' and import the CSV file.
|Finish the Wizard and refresh the Overlay.
}}
<gallery mode=nolines>
File:Breach_2_csv.JPG
File:Breach_areas.JPG
File:Breach_two.JPG
</gallery>
 
==Import waterdepth data==
For modelling the correct volume of a waterbody, it is important that the depth of a waterbody is accurately modelled. If you have data of your waterbodies and the depth of the soil, for example sections of water bodies, it is possible to import this data as part of the DEM (Digital Elevation Model). Together with importing your water level areas, the volume of the waterbody can then be more accurately calculated. Below the steps on how to import the data.
 
The steps below assume you have already a digital dataset of your waterdepth data available (no PDF's with sections).
Either a vector dataset of the waterbodies with an attribute value for the depth or a raster dataset is sufficient to use. In this example we use a vector (shapefile) polygon dataset and make use of a GIS (QGIS) to transform the vector data to a raster dataset to import in the {{software}}.
 
{{Editor steps|title= create the raster dataset
|Open the vector dataset in a GIS.
|Now we want to create the raster by making use of the rasterize menu. This menu can be found in the tab Raster > conversion > rasterize (vector to raster)
|Define in the panel the shapefile, the attribute containing the depth values, the name and location of the output raster and either the raster size or resolution. In this case we recommend to set the resolution. Choose the same resolution as chosen for the [[Terrain_height#Terrain_height_in_the_Tygron_Platform|DEM when generating the project]].
|When these settings have been set, click on the pencil icon to edit the text. It is important to also add a nodata value to create a partial raster. On the places where there is a nodata value, the {{software}} will use the values from the default DEM.  Add the following statement to the text box to create the nodata value: ''-a_nodata <number to replace with nodata>'', for example: ''-a_nodata 0'' (see also the image below). This means that where there is a value of 0 in the vector dataset, it is replaced with a nodata value in the raster dataset.
|Click on OK and wait till the raster data is created. Now you can close the GIS program.
}}
<gallery mode=nolines>
File:Data.JPG
File:Rasterize.JPG
File:Raster_settings.JPG
</gallery>
The next step is to import the created raster to replace the DEM only on the locations of waterbodies with the new raster values.
 
{{Editor steps|title= import the raster to replace the DEM partially
|(See for more explanation and images on the following steps [[Terrain_height#Import_your_own_DTM|this Wiki page]]). Go to the tab Terrain > Select Elevation Geotiff
|Click on import new Geotiffs in the bottom right corner and choose the created raster. Depending on the file size and the internet speed, it make take some time to upload the file to the server.
|When the file is uploaded, select it and click on Apply
|Refresh the Heightmap overlay and click on the location of a waterbody to check the new height.
}}
 
==Simulate a flood wave with in- and outlet areas==
To simulate a scenario of for example a flood wave in a river, you can create in- and outlet areas.
These are basically breach areas. The inlet area demonstrates the inflow of water, the outlet area demonstrates the outflow of water.
The images show an example with invented values for the attributes.
{{Editor steps|title= set up a flood wave scenario
|Draw two areas at the one side of the river where water will flow in and at the other side of the river where the water flows out. It is also possible to import a [[GeoJSON]] file with these areas.
|The areas should have a [[Flooding_(Overlay)#Define_a_Breach_area|breach floor attribute]]. Give the inlet area an [[Flooding_(Overlay)#Define_a_Breach_area|outlet level]] and/or [[Flooding_(Overlay)#Define_a_Breach_area|outlet Q]]. This depends on the data you have of the scenario. If you know for example the water level of a flood wave, use the outlet level. If you know the flow rate, use the outlet Q. Both is also possible, then the outlet level has precedence over the outlet Q. For the outlet area, enter, a negative outlet Q value and/or an outlet level.
|Add a [[Flooding_(Overlay)|Flooding Overlay]] and go to the [[Water_Overlay#Configuration_Wizard|Configuration Wizard]] of the Flooding Overlay.
|In step 2.1 either select the attribute that specifies your breach floor or import your [[GeoJSON]] file.
|Click on ''Next''.
|In the dropdown menu, check if the attributes of the areas correspond with what you have set as attributes.
|In step 2.2 import your water level areas with at least a water level attribute.
|Finish the Wizard and refresh the Overlay.
|After the flooding is calculated, check [[Water_Overlay#Show_Water_Balance|Water Balance]] to get more insight in the scenario.
}}
<gallery mode=nolines>
File:Areas_location.JPG
File:Inflow.JPG
File:Outflow.JPG
File:Waterbalance_panel.JPG
</gallery>
 
==Track flow in a hydrological system over time==
To track water in a hydrological system, i.e. find where water from a specific point flows to, it is possible to artificially add a chemical emitter in the water system. Any water passing through that construction will pick up the chemical. By having a result type added which highlights that chemical, the flow of the water can be tracked quite accurately.
 
For the purposes of this scenario, a simple hydrological model will be assumed, although the same technique can be used for [[Water Overlay#breach|breach]]es and other calamitous scenarios. We will also assume we can use the CHLORIDE particle as our "tracker". We will track any water flowing in from outside the system through a specific inlet.
{{Editor steps|title=set up water flow tracking
|Configure a base hydrological system. For the specified scenario, use the [[Groundwater (Overlay)|groundwater overlay]].
|Ensure the simulation is set up to output a reasonable amount of timeframes. For most simulation durations, 25 to 50 timeframes will suffice.
|Also ensure the hydrological system has at least one [[Water Overlay#inlets|inlet]] configured to simulate flow into the hydrological system.
|Also ensure the hydrological system has a CHLORIDE [[Water Overlay#Result_types|result type]], either as main result or as a child result type.
|Find the inlet, the water of which you want to track, in the 3D world.
|Add the "CHLORIDE" attribute to the inlet, with a value of "1".
|Ensure the overlay is recalculated.
|Inspect the "Chloride" result overlay. The greater the concentration of chloride in any given location, the more water from the inlet has flowed there.
|Select the "play" option in the overlay's legend. The animation will show the flow of the water from the inlet.
}}
To track water from different sources (different inlets, or other hydrological constructons), add the chemical attribute to the construction of which you wish to track the water.
 
To track water from different sources collectively, each source can be configured with the same chemical attribute. (In the specified example, multiple sources can be provided with the CHLORIDE attribute.)
 
To track water from different sources with the ability to differentiate between what water came from which specific source, each source can be given a different chemical to produce.

Latest revision as of 16:57, 30 January 2024