Demo Iteration Project: Difference between revisions

From Tygron Preview Support Wiki
Jump to navigation Jump to search
No edit summary
No edit summary
Line 8: Line 8:


==Calculations using the Iteration option==
==Calculations using the Iteration option==
The implementations demonstrated here strike a balance between leveraging the {{software}}'s effective means of calculation and the flexibility and verisimilitude of the results. As such, they serve as a powerful springboard for creating ones own accepted means of calculation.
The demo project simulates a Dutch polder to demonstrate how rainfall infiltration can be modeled using the iteration option. A hypothetical formula is applied to calculate the infiltration rate per time step, based on the saturation level of the unsaturated zone. This iterative process determines the soil's saturation step by step, which in turn influences the potential infiltration.


==Using the Rainfall overlay for calculating the groundwater infiltration speed ==
The purpose of this demo project is to illustrate the capabilities of this iterative calculation method.
Set up
Rain event. Duration of the Rain event. De volledige tijdsduur wordt opgegeven.
Watersystem - Advanced: Select Ggrid Overaly to set initial water level and also flow UV
Groundwater - Advanced: Select a Grid Ovelay as Groundwater Level (datum
Unsaturaed Zone


Output Overlays
==Setup of the Demo Project==
Deze output is nodig.  
The demo includes several essential components for performing these calculations. Each component is explained, along with the rationale for its use.
Surface Last Value
Rain
Ground Last Value
Ground Watertable
Ground Last Unsaturated Storage
Ground Last Unsaturated Fraction
Surface Last U
Surface Last V


Timeframes
Components:


De uitkomsten van elke iteratiestap worden door de volgende combo-overlay's gebruikt om de data weer klaar te zetten voor de volgende stap. Dit is bedoeld om de volgende iteratiestap te rekenen met de juiste inputdata. We lopen de verschillende combo-overlay's door:
Combo Overlays
Rainfall Overlay
Iteration Collector
Indicator
Number of Iterations


Combo Surface U en Combo Surface V. In de formula van deze combooverlay is te zien dat de formule er op gericht is om er voor te zorgen dat hij rekent met de data uit de vorige tijdstap. Echter, indien de vorige iteratiestap stap 0 was, dan kan gerekend worden met 0.
IF(EQ(ITERATION, 0), 0, A)


Combo Fraction
==Combo Overlays==
Combo Surface
Several overlays need to be prepared as inputs for the various iteration steps. Each step's outputs are set up for use in the subsequent iteration. The combo overlays include:
Combo Grondwaterdiepte
 
Combo Infil Speed


Combo Surface U and Combo Surface V:
These represent the initial velocity of surface water in the x and y directions. When water flows downhill, the velocity at the end of an iteration is used as the initial velocity for the next iteration.
Formula:
IF(EQ(ITERATION, 0), 0, A)


Iteration Collector
Combo Fraction and Combo Groundwater Depth:
Dit laat de resultaten zien van elke iteratiestap. Wanneer je de modulus niet op 1 (defealt) zet, maar bijvoorbeeld op 2
These calculate inputs based on previous iterations unless it’s iteration 0, where global values are used:
Overlays - Grid calculations - Iteration Collector
Iteration Input Overlay -> Rain event


Saturation percentage: GLOBAL_DEFAULT_FRACTION
Groundwater level: GLOBAL_DEFAULT_TABLE
Formula examples:
IF(EQ(ITERATION, 0), GLOBAL_DEFAULT_FRACTION, IF(EQ(A, NO_DATA), GLOBAL_DEFAULT_FRACTION, A))
IF(EQ(ITERATION, 0), GLOBAL_DEFAULT_TABLE, A)


Combo Surface:
Determines input from previous iterations unless it’s iteration 0.
Formula:
IF(EQ(ITERATION, 0), 0, A)


Partial_Start_SEC
Combo Infiltration Speed:
Partial_End_SEC
Calculates infiltration speed based on soil saturation using the Ground BOFEK ID overlay to identify soil type.
Formula example:
MAX(0, SUB(GLOBAL_DEFAULT_INFIL, SWITCH(B, 0, 1004, MUL(10, SUB(A, GLOBAL_DEFAULT_FRACTION)), 1006, MUL(5, SUB(A, GLOBAL_DEFAULT_FRACTION)))))


Indicator
==Rainfall Overlay==
UPDATE_OVERLAY_PARTIAL_END_SEC_WHERE_OVERLAY_IS_10 
Default settings are used for the rainfall overlay, with some exceptions:


Hiermee stel je de start en de eindtijd van de gedeeltelijke doorrekening van de regenwateroverlay. Met andere woorden een iteratiestap. Bij de volgende stap worden deze waarden aangepast en wordt de tweede iteratie doorgerekend.
Rain Event Duration: The total duration is specified and later divided into iterations.
Water System – Water Level: Set initial water level and UV flow using the Surface combo overlay.
Groundwater: Initialize groundwater level using the Groundwater Depth combo overlay.
Unsaturated Zone: Initialize saturation and storage percentages per grid cell using the Fraction combo overlay.
Generated Output Overlays:


Het aantal iteraties wordt door de indicator opgevraagd met de TQL: SELECT_ITERATIONS_WHERE.
Surface Last Value
De iteratie waar momenteel mee wordt gerekend wordt opgevraagd met de TQL: SELECT_ITERATION_WHERE
Rain
 
Ground Last Value
De totale simulatie tijd wordt ook opgevraagd: Query: SELECT_ATTRIBUUT_WHERE_NAME_IS_RAIN_M_AND_OVERLAY_IS_10_AND_RELATION_IS_WEATHER_AND_INDEX_IS_2
Ground Watertable
 
Ground Last Unsaturated Storage
Fraction Start en Fraction End geven de start en end als fractie. Bij Start en End wordt dit uitgedrukt in seconden door deze fractie te vermenigvuldigen met de totale simulatietijd.
Ground Last Unsaturated Fraction
Surface Last U
Surface Last V
The number of timeframes is set to 1.


Je kan de debug niet downloaden per iteratie.
==Iteration Collector==
Displays results of each iteration step. The input overlay is the Rain Event.


Je kan per iteratie wel wegschrijven.
Modulus: Set to 1 by default, meaning one output is saved per iteration as a timeframe in the collector.


Je kan bepaalde updates wel doen. Dus wanneer je in je scenario bijvoorbeeld het attribuut van een specifiek gebouwtype wil updaten tijdens een bepaalde iteratiestap 5, dan kan dat.  
==Indicator==
UPDATE_BUILDING_ARGICULTURE_BUYOUT_COST_M2_WHERE BUILDING_IS_35_AND_ITERATION_IS_5
Handles partial updates for specific timeframes.
Example formulas:


Je zit initieel altijd in iteratiestap 0. Dus met een TQL querie kan dit niet voor iteratiestap 5. Het kan wel via de API en de indicator.
UPDATE_OVERLAY_PARTIAL_END_SEC_WHERE_OVERLAY_IS_10
Queries like SELECT_ITERATIONS_WHERE and SELECT_ITERATION_WHERE retrieve the number of iterations and the current iteration.


==Number of Iterations==
Set through the interface (default is 1).


Select_
==Notes and Limitations==
Debugging cannot be downloaded per iteration but can be saved for each iteration.
Specific updates (e.g., updating attributes for certain building types in iteration 5) can be executed using the API and indicator but not through TQL for non-initial iterations.


Modulus





Revision as of 15:13, 15 November 2024

An overview of Demo Iteration.

The Demo Iteration project is available for all users and can be found in the main menu under Edit projects. This project does not count towards your license.

This project is intended for hydrologists and other water experts.

This project showcases the rainfall overlay in a iteration mode.

The demo show the iteration functionality that can be used to adjust the ground infiltration speed using a combo formula.

Calculations using the Iteration option

The demo project simulates a Dutch polder to demonstrate how rainfall infiltration can be modeled using the iteration option. A hypothetical formula is applied to calculate the infiltration rate per time step, based on the saturation level of the unsaturated zone. This iterative process determines the soil's saturation step by step, which in turn influences the potential infiltration.

The purpose of this demo project is to illustrate the capabilities of this iterative calculation method.

Setup of the Demo Project

The demo includes several essential components for performing these calculations. Each component is explained, along with the rationale for its use.

Components:

Combo Overlays Rainfall Overlay Iteration Collector Indicator Number of Iterations


Combo Overlays

Several overlays need to be prepared as inputs for the various iteration steps. Each step's outputs are set up for use in the subsequent iteration. The combo overlays include:

Combo Surface U and Combo Surface V: These represent the initial velocity of surface water in the x and y directions. When water flows downhill, the velocity at the end of an iteration is used as the initial velocity for the next iteration. Formula: IF(EQ(ITERATION, 0), 0, A)

Combo Fraction and Combo Groundwater Depth: These calculate inputs based on previous iterations unless it’s iteration 0, where global values are used:

Saturation percentage: GLOBAL_DEFAULT_FRACTION Groundwater level: GLOBAL_DEFAULT_TABLE Formula examples: IF(EQ(ITERATION, 0), GLOBAL_DEFAULT_FRACTION, IF(EQ(A, NO_DATA), GLOBAL_DEFAULT_FRACTION, A)) IF(EQ(ITERATION, 0), GLOBAL_DEFAULT_TABLE, A)

Combo Surface: Determines input from previous iterations unless it’s iteration 0. Formula: IF(EQ(ITERATION, 0), 0, A)

Combo Infiltration Speed: Calculates infiltration speed based on soil saturation using the Ground BOFEK ID overlay to identify soil type. Formula example: MAX(0, SUB(GLOBAL_DEFAULT_INFIL, SWITCH(B, 0, 1004, MUL(10, SUB(A, GLOBAL_DEFAULT_FRACTION)), 1006, MUL(5, SUB(A, GLOBAL_DEFAULT_FRACTION)))))

Rainfall Overlay

Default settings are used for the rainfall overlay, with some exceptions:

Rain Event Duration: The total duration is specified and later divided into iterations. Water System – Water Level: Set initial water level and UV flow using the Surface combo overlay. Groundwater: Initialize groundwater level using the Groundwater Depth combo overlay. Unsaturated Zone: Initialize saturation and storage percentages per grid cell using the Fraction combo overlay. Generated Output Overlays:

Surface Last Value Rain Ground Last Value Ground Watertable Ground Last Unsaturated Storage Ground Last Unsaturated Fraction Surface Last U Surface Last V The number of timeframes is set to 1.

Iteration Collector

Displays results of each iteration step. The input overlay is the Rain Event.

Modulus: Set to 1 by default, meaning one output is saved per iteration as a timeframe in the collector.

Indicator

Handles partial updates for specific timeframes. Example formulas:

UPDATE_OVERLAY_PARTIAL_END_SEC_WHERE_OVERLAY_IS_10 Queries like SELECT_ITERATIONS_WHERE and SELECT_ITERATION_WHERE retrieve the number of iterations and the current iteration.

Number of Iterations

Set through the interface (default is 1).

Notes and Limitations

Debugging cannot be downloaded per iteration but can be saved for each iteration. Specific updates (e.g., updating attributes for certain building types in iteration 5) can be executed using the API and indicator but not through TQL for non-initial iterations.


Exploring the project

To begin exploring the project, see the outlet located on the left side.