Time sequence (Water Overlay): Difference between revisions
mNo edit summary |
mNo edit summary |
||
| (16 intermediate revisions by 2 users not shown) | |||
| Line 1: | Line 1: | ||
In the [[Water Overlay]], a number of elements can be configured as a time sequence rather than a single value. This means that during the simulation, the value used for calculations changes over time. | In <!--some calculation models, such as the [[Water Overlay]] and the [[Heat Overlay]]-->the [[Water Overlay]], a number of elements can be configured as a time sequence rather than a single value. This means that during the simulation, the value used for calculations changes over time. | ||
Time sequences can be loaded in via two methods: directly as attributes of [[Import Geo data|imported Geo data]], or by importing a [[CSV]] file via the [[Water Overlay Wizard|configuration wizard]]. | Time sequences can be loaded in via two methods: directly as attributes of [[Import Geo data|imported Geo data]], or by importing a [[CSV]] file via the [[Water Overlay Wizard|configuration wizard]]. | ||
==Structure of a time sequence== | ==Structure of a time sequence== | ||
Time sequences are stored in project data in the form of [[attribute array]]s. It consists of a sequence of pairs of a time and a value to use for that time. A maximum of | Time sequences are stored in project data in the form of [[attribute array]]s. It consists of a sequence of pairs of a time and a value to use for that time. A maximum of {{array max|pairs}} can be used for any single sequence, | ||
Conceptually, a time sequence is always structures as follows: | |||
{|class=wikitable | |||
!Time (seconds) | |||
!Value | |||
|- | |||
| 3600 | |||
| 0.03 | |||
|- | |||
| 7200 | |||
| 0 | |||
|- | |||
| 9000 | |||
| 0.03 | |||
|- | |||
| 10800 | |||
| 0.06 | |||
|} | |||
The unit for time is stored in seconds. The unit for the value is dependant on the element for which the time sequence is used. | |||
Depending on the type of element you wish to configure using a time sequence, the interpretation of a time sequence can differ. | Depending on the type of element you wish to configure using a time sequence, the interpretation of a time sequence can differ. | ||
===Definition by end=== | ===Definition by end=== | ||
[[ | <!--Time sequence end--> | ||
[[File:graph-dbe.JPG|thumb|right|300px|Up until specific times, a certain value is applicable.]] | |||
[[Rain model (Water Overlay)|Rainfall]] and [[Evaporation model (Water Overlay)|evaporation]] use an interpretation by which the times indicate up to when the value is used. | |||
{{clear}} | |||
===Definition by start=== | ===Definition by start=== | ||
[[Hydraulic structures (Water Overlay)| | <!--Time sequence start--> | ||
[[File:graph-dbs.JPG|thumb|right|300px|From certain times onward, a certain value is applicable.]] | |||
The speeds of [[Hydraulic structures (Water Overlay)|hydraulic structures]] use an interpretation by which the times indicate from when onward a value is used. | |||
{{clear}} | |||
===Interpolated=== | ===Interpolated=== | ||
[[ | <!--Time sequence interpolated--> | ||
[[File:graph-i.JPG|thumb|right|300px|The applicable value is interpolated.]] | |||
Heights and target water levels of [[Breach (Water Overlay)|breaches]] and [[Hydraulic structures (Water Overlay)|hydraulic structures]] use an interpretation by which the used value is interpolated based on the current time in the simulation, the preceding and upcoming defined time in the time sequence, and the associated value. | |||
{{clear}} | |||
==Structure of data== | ==Structure of data== | ||
There are multiple methods to load a time sequence in the {{software}}, and depending on the method the data will be structured slightly different to load it in. | |||
===CSV=== | ===CSV=== | ||
See the [[CSV_(comma_separated_values)#How-to.27s|How-to's]] on the [[CSV]] page. | |||
===Attribute=== | ===Attribute=== | ||
When importing a time sequence in an attribute while [[Import Geo data|importing geo data]], the attribute should contain a list of values which looks as follows: | When importing a time sequence in an attribute while [[Import Geo data|importing geo data]], the attribute should contain a list of values which looks as follows: | ||
{{code|1= | {{code|1= | ||
[3600, 0.03, 7200, 0, 9000, 0.03, | [3600, 0.03, 7200, 0, 9000, 0.03, 10800, 0.06] | ||
}} | }} | ||
The first value is the time for the first time-value pair, the second value is the value of that pair. The third value is the time for the second time-value pair, and so forth. | The first value is the time for the first time-value pair, the second value is the value of that pair. The third value is the time for the second time-value pair, and so forth. | ||
{{article end | |||
|notes=* When exporting data which has a time sequence for an attribute, it is formatted in the same structure which can be used to load it back in as an attribute. | |||
* When exporting data which has a time sequence for an attribute, it is formatted in the same structure which can be used to load it back in as an attribute. | | seealso=* https://www.tygron.com/en/2020/04/20/water-module-time-sequence/ | ||
* [[CSV]] | |||
}} | |||
Latest revision as of 08:37, 27 April 2021
In the Water Overlay, a number of elements can be configured as a time sequence rather than a single value. This means that during the simulation, the value used for calculations changes over time.
Time sequences can be loaded in via two methods: directly as attributes of imported Geo data, or by importing a CSV file via the configuration wizard.
Structure of a time sequence
Time sequences are stored in project data in the form of attribute arrays. It consists of a sequence of pairs of a time and a value to use for that time. A maximum of 10.000 values (5.000 pairs) can be used for any single sequence,
Conceptually, a time sequence is always structures as follows:
| Time (seconds) | Value |
|---|---|
| 3600 | 0.03 |
| 7200 | 0 |
| 9000 | 0.03 |
| 10800 | 0.06 |
The unit for time is stored in seconds. The unit for the value is dependant on the element for which the time sequence is used.
Depending on the type of element you wish to configure using a time sequence, the interpretation of a time sequence can differ.
Definition by end
Rainfall and evaporation use an interpretation by which the times indicate up to when the value is used.
Definition by start
The speeds of hydraulic structures use an interpretation by which the times indicate from when onward a value is used.
Interpolated
Heights and target water levels of breaches and hydraulic structures use an interpretation by which the used value is interpolated based on the current time in the simulation, the preceding and upcoming defined time in the time sequence, and the associated value.
Structure of data
There are multiple methods to load a time sequence in the Tygron Platform, and depending on the method the data will be structured slightly different to load it in.
CSV
See the How-to's on the CSV page.
Attribute
When importing a time sequence in an attribute while importing geo data, the attribute should contain a list of values which looks as follows:
[3600, 0.03, 7200, 0, 9000, 0.03, 10800, 0.06]
The first value is the time for the first time-value pair, the second value is the value of that pair. The third value is the time for the second time-value pair, and so forth.
Notes
- When exporting data which has a time sequence for an attribute, it is formatted in the same structure which can be used to load it back in as an attribute.