Warnings (Water Overlay): Difference between revisions

From Tygron Preview Support Wiki
Jump to navigation Jump to search
Line 74: Line 74:


===Aquifer===
===Aquifer===
[[Aquifer]]s are checked for physically impossible models.
[[Aquifer (Water Overlay)|Aquifer]]s are checked for physically impossible models.


====Aquifer does not have a positive non-zero KD value.====
====Aquifer does not have a positive non-zero KD value.====
The Sewer Area is configured to have a negative hydraulic conductivity, which directly dictates maximum flow speed. The hydraulic conductivity must be positive and no-zero, otherwise the underground flow speed would be similarly negative or zero.
The [[Aquifer (Water Overlay)|Aquifer]] is configured to have a negative hydraulic conductivity, which directly dictates maximum flow speed. The hydraulic conductivity must be positive and no-zero, otherwise the underground flow speed would be similarly negative or zero.


'''To resolve:''' Check your aquifer data and adjust the [[aquifer kd (Water Overlay)|aquifer kd]] values where possible.
'''To resolve:''' Check your aquifer data and adjust the [[aquifer kd (Water Overlay)|aquifer kd]] values where possible.

Revision as of 11:14, 11 June 2020



Calculation warnings

When the Water Overlay is selected in the Editor, a number of warnings may appear in the right panel when a calculation is performed.

Calculation was cancelled

The calculation did not run to completion, because it was cancelled by the user. Depending on the calculation being performed, partial results may be available.

Calc too long forced timeout

The calculation exceeded the allowed calculation time. During business hours (9-17, GMT+1, during weekdays), there is a maximum calculation time of 1 hour. If during business hours a calculation has been calculating for an hour, the calculation times out automatically. Depending on the calculation being performed, partial results may be available.

Error in GPU calculation

During the calculation, an unknown error has occurred. This may be due to an unexpected configuration of the specific calculation, or an internal error in the calculation infrastructure. Please contact support with a description of the calculation and its related settings to further investigate the issue.

Prequel

When a Grid Overlay encounters an error, its results may not be valid. Any other Grid Overlay which uses that first Grid Overlay as a prequel will warn about that error in one of the prequels taking place. Subsequent Grid Overlays relying on that one will also report the error.

Limited cycles. Inaccurate results

It took too many calculation cycles to perform the calculation. The maximum amount of calculation cycles is 2147483647. The amount of cycles is dictated by the complexity, size, and duration of the simulation. More water with a higher maximum impulse across a larger calculation area over a longer period of time requires more computational cycles to accurately compute.

To resolve: Reduce the complexity of the calculation. Prioritize reducing the calculation time, and consider running the Water Overlay calculation in low impulse mode.

Invalid constructions

One or more constructions used in the calculation are invalid. They may be incorrectly configured, or interfered with by the presence of other Constructions. More information for the individual Constructions with errors can be found in the Water Overlay Wizard, or under the Construction warnings header.

To resolve: Open the Water Overlay configuration wizard, continue to the step of the Constructions, and investigate the errors of Constructions on an individual basis.

Large cell size. Inacurate results

The grid cell size has been configured as greater than 4 meters. This means water may have difficulty flowing into alleys or through fair-sized waterways, and other accuracy-related artifacts may present themselves in the calculation results.

To resolve: Reduce the grid cell size.

Heightmap resolution is too low

The resolution of the heightmap is lower than the grid cell resolution, meaning that even though more accurate results might be expected, it's not possible to refine the detail of water flow to the configured accuracy. The only way to enhance the height map accuracy is to load in a new Project with a more detailed DEM resolution.

To resolve: As a stop-gap measure, increase the grid cell size. For a more permanent resolution, recreate the Project with a more detailed DEM resolution.

Construction warnings

This section is a stub.

Feature warnings

For individual hydrological features, warnings may be presented when they are improperly configured.

Water Area

Water Overlays are checked to see if their configured water level is realistic.

The water level is much higher than the average land height

The water level is much higher than the average terrain height, which likely means an improper value has been imported as water level. The effect in the model is that water will be initialized in waterways as a high block exceeding the average terrain height, so the simulation will start with a sudden flood emenating from the waterways.

To resolve: Ensure that the configured water level is not set to a placeholder value. Note that if the water level is indeed correct but the warning persists, the warning can be ignored.

The water level is much lower than the average land height

The water level is much lower than the average terrain height, which likely means an improper value has been imported as water level. The effect in the model is that waterways will be initialized with excessively low water levels, if they are even deep enough to contain any water.

To resolve: Ensure that the configured water level is not set to a placeholder value. Note that if the water level is indeed correct but the warning persists, the warning can be ignored.

Inundation Area

Inundation Areas are checked to see if their configured inundation level is realistic.

The inundation level is much higher than the average land height

The inundation level is much higher than the average terrain height, which likely means an improper value has been imported as inundation level. The effect in the model is that water will be initialized on the surface many meters high, which is an unrealistic starting situation.

To resolve: Ensure that the configured [Inundation level (Water Overlay)|inundation level]] is not set to a placeholder value. Note that if the inundation level is indeed correct but the warning persists, the warning can be ignored.

The inundation level is much lower than the average land height

The inundation level is much lower than the average terrain height, which likely means an improper value has been imported as inundation level. The effect in the model is that no water will actually be placed on the surface, except in points where the terrain dips far below the average terrain height (without being a waterway).

To resolve: Ensure that the configured [Inundation level (Water Overlay)|inundation level]] is not set to a placeholder value. Note that if the inundation level is indeed correct but the warning persists, the warning can be ignored.

Sewer Area

Sewer Areas are checked for physically impossible models.

Sewer Storage is negative, which is not allowed

The Sewer area is configured to have a negative amount of sewer storage. All sewer storage must be strictly positive and non-zero.

To resolve: Check your Sewer area and adjust the sewer storage values where possible.

Sewer Pump Speed is negative, which is not allowed

The Sewer area is configured to have a negative sewer pump speed. This would mean water is structurally pumped into the sewer. Sewer pump speeds must be 0 or positive.

To resolve: Check your Sewer area and adjust the sewer pump speed values where possible.

Aquifer

Aquifers are checked for physically impossible models.

Aquifer does not have a positive non-zero KD value.

The Aquifer is configured to have a negative hydraulic conductivity, which directly dictates maximum flow speed. The hydraulic conductivity must be positive and no-zero, otherwise the underground flow speed would be similarly negative or zero.

To resolve: Check your aquifer data and adjust the aquifer kd values where possible.

Breach

Breaches are checked for improper configurations for water inflow.

Breach shares its Input Area with another Breach

The Breach is properly connected to an input area, but another Breach is connected to the same input area. Make sure every breach using an input area has its own input area.

To resolve: Either change the input area of this Breach, or find the other Breach which refers to the same input area and change the input area of that breach.

Breach uses an empty Input Area, which will have no effect

The Breach is properly connected to an input area, but the input area is not a polygon in the 3D world.

To resolve: Ensure that the input area has a polygon in the 3D World.

Breach has an invalid Input Area

The Breach refers to an Area as Input Area, but the referred Area is not configured to be an Input Area.

To resolve: Add a breach inpupt area Attribute to the area the Breach uses as input area. Alternatively, use the Water Overlay configuration wizard to select a different (or no) input area.

Breach uses an external area as input, but it is not allowed to be empty

The Breach does not have a configured Input Area, and therefor defaults to using an external area. However, the external area's size is no a non-zero positive integer.

To resolve: Change the externa area Attribute to a positive value.