Warnings (Water Overlay)

From Tygron Preview Support Wiki
Jump to navigation Jump to search

This is a listing of all possible warnings which may be encountered when working with the Water Overlay.

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.

For individual hydraulic structures, warnings may be presented when they are improperly configured.

For some warnings, clear steps can be followed to resolve them.

All structures

All structures are checked for whether they can be related to the grid properly.

Incorrectly positioned for this grid size

This structure is placed such that it cannot be related to the grid properly. The following situations will all trigger this warning:

  • The center or either of the endpoints of the structure are on an inactive cell.
  • The center or either of the endpoints share a cell with the center or endpoint of another structure.
  • The structure should be a line, but the endpoints are on the same cell.

To resolve: Check the advanced options in the Water Overlay Wizard, that object correction is active, which will allow the Tygron Platform to automatically attempt to fix this issue for all constructions. If this does not correct the issue for any given structure, inspect the indivual structure and move it if neccesary, to ensure the centerpoint or endpoints of the structure (as applicable) are on cells which are part of the calculation, and no other structures have their center or endpoint on the same cell.

Weirs

Weirs have their height checked so that water can realistically flow across.

Template:Water overlay height warning

The covering water area is (much) higher than the weir height

The weir resides in a Water Area, the water level of which greatly exceeds the weir's height. This likely means an improper value has been imported as weir height.

To resolve: Ensure that the configured weir height is not set to a placeholder value, and that the Water Area's water level is not set to a placehoder value. Note that if both Attribute's are indeed correct but the warning persists, the warning can be ignored.

The covering water area is (much) lower than the weir height

The weir resides in a Water Area, the water level of which is much lower than the weir's height. This likely means an improper value has been imported as weir height.

To resolve: Ensure that the configured weir height is not set to a placeholder value, and that the Water Area's water level is not set to a placehoder value. Note that if both Attribute's are indeed correct but the warning persists, the warning can be ignored.

Culverts

Culverts have their height checked so that water can realistically flow across.

Template:Water overlay height warning

Inlets

Inlets are checked for conflicting configurations.

The lower threshold is not functional, because water is never added. Use an upper threshold instead

This Inlet only has negative inlet q configured, meaning water will only flow out, not in. However, the configured lower threshold can only affect the proces of water flowing in.

To resolve: Check whether the inlet q is configured correctly, and whether the intent of the lower threshold is interpreted correctly.


The upper threshold is not functional, because water is never removed. Use a lower threshold instead

This Inlet only has positive inlet q configured, meaning water will only flow in, not out. However, the configured upper threshold can only affect the proces of water flowing out.

To resolve: Check whether the inlet q is configured correctly, and whether the intent of the upper threshold is interpreted correctly.

Sewer overflows

Feature warnings

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

Water Area

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

Template:Water overlay height warning

Inundation Area

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

Template:Water overlay height warning

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 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 input 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 breach inpupt area, and therefor defaults to using an externa area. However, the externa area's size is no a non-zero positive integer.

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