Warnings (Water Overlay): Difference between revisions

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


==Feature warnings==
==Feature warnings==
For individual [[hydrological features (Water Overlay)|hydrological features]], warnings may be presented when they are improperly configured.
For individual [[hydrological features (Water Overlay)|hydrological features]], warnings may be presented when they are improperly configured. <br>
See also more information about the [[Water_Overlay_Wizard#Feedback|feedback]] and the automatic proposed fixes.  
See also more information about the [[Water_Overlay_Wizard#Feedback|feedback]] and the automatic proposed fixes.  



Revision as of 13:37, 12 May 2021

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 warnings (highlighted yellow) or errors (highlighted red) of Constructions on an individual basis. If applicable, fixes are proposed with the tool icon. By clicking on the icon the fix can be automatically solved. See also: How to apply fixes for multiple components in the Water Overlay Wizard

Warning in the wizard, there is a fix proposed. By clicking on the icon, the fix can be applied when accepted.

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 heightmap 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.

Feature warnings

For individual hydrological features, warnings may be presented when they are improperly configured.
See also more information about the feedback and the automatic proposed fixes.

Water Area

Water level areas 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 height of the terrain, 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 emanating 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 height of the terrain, 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 height of the terrain, 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 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 height of the terrain, 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 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 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.

Construction warnings

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 hydraulic 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.

The weir height is (much) higher than the average land height

The weir height is much higher than the average height of the terrain, which likely means an improper value has been imported as weir height. The effect in the model is that the Weir is many meters higher than the average terrain height, so water needs to be equally excessively high to flow across it..

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

The weir height is (much) lower than the average land height

The weir height is much lower than the average height of the terrain, which likely means an improper value has been imported as weir height. The effect in the model is that the Weir's height is that low, meaning water can almost certainly always flow across the Weir..

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

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

The Weir resides in a Water Level 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 Level 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 Level 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 Level 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 culvert threshold checked so that water can realistically flow across.

The culvert threshold is (much) higher than the average land height

The culvert threshold is much higher than the average height of the terrain, which likely means an improper value has been imported as culvert threshold. The effect in the model is that the Culvert is many meters higher than the average terrain height, so water needs to be equally excessively high to flow across it..

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

The culvert threshold is (much) lower than the average land height

The culvert threshold is much lower than the average height of the terrain, which likely means an improper value has been imported as culvert threshold. The effect in the model is that the Culvert's height is that low, meaning water can almost certainly always flow across the Culvert..

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

Inlets

Inlets are checked for conflicting configurations.

The lower threshold is not functional, because water is never added

This Inlet only has negative inlet q('s) 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

This Inlet only has positive inlet q('s) 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

Sewer Overflows are check for a proper connection to a Sewer Area.

The sewer overflow is (much) higher than the average land height

The sewer overflow is much higher than the average height of the terrain, which likely means an improper value has been imported as sewer overflow. The effect in the model is that Sewer Overflow lies many meters higher than the average terrain height, meaning water can always flow out of the sewer through this Sewer Overflow..

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

The sewer overflow is (much) lower than the average land height

The sewer overflow is much lower than the average height of the terrain, which likely means an improper value has been imported as sewer overflow. The effect in the model is that the Sewer Overflow's height is that low, meaning water can never flow out of the sewer..

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

Sewer overflow is not connected to a sewer

Sewer Overflows move water from a Sewer Area to the surface. This requires that the Sewer Overflow overlaps with a Sewer Area. This Sewer Overflow does not, meaning the Sewer Overflow does not have a Sewer Area to remove water from.

To resolve: Check that the Sewer Area are loaded in correctly. Check whether a Sewer Area should be expanded so that it overlaps with the Sewer Overflow, or the Sewer Overflow should be moved to intersect with the Sewer Area.

Shares a sewer area and is the inactive overflow

A Sewer Area can only have one Sewer Overflow. This Sewer Overflow is not the only Sewer Overflow which intersects with the Sewer Area. Only one Sewer Overflow will actually be functional, and this is not the active one.

To resolve: Find all the Sewer Overflows which intersect with the same Sewer Area, and remove all but one of the Sewer Overflows.