Waterwijzer Module overview

From Tygron Support wiki
Jump to navigation Jump to search
This functionality is currently unavailable or non-functional.

The Waterwijzer Overlay communicates with the Waterwijzer API to calculate the yield loss for agriculture crops.


  1. User generates a project for an area in the Netherlands using the Tygron Platform.
    • The Dutch BRP geo-plugin retrieves the known agriculture plots. Each agriculture plot has an identification number for the type of plot, which is stored in the BRP_CODE attribute.
    • The Dutch BRO geo-plugin retrieves the known soil types, stored as underground terrain. The simplified BOFEK_ID is configured by default for each terrain type of these terrain.
  2. User adds a Waterwijzer Overlay and configures:
    1. The climate scenario and weather station are configured using the Waterwijzer Overlay Wizard
    2. The groundwater levels can also be configured using the Waterwijzer Overlay Wizard. These ground water levels can be provided as a Grid Overlay prequel representing either the low or the high ground water level.
  3. User triggers the calculation of the overlay. The Waterwijzer Module sends the data to Waterwijzer API and receives data on yield losses.
  4. The Waterwijzer module then stores the grid data under following result type overlays, categorized as:
    • Dry: low water levels cause crops to dry out;
    • Wet: high water levels cause crops' roots to suffocate;
    • Indirect: Indirect causes, related to combinations of crop, soil, weather and water levels
    • Salt: salt water irrigation causes damage to crops;
    • Total: the sum of the previous four categories.
  • Waterwijzer damage dry.jpeg
  • Waterwijzer damage wet.jpeg
  • Waterwijzer damage indirect.jpeg
  • Waterwijzer damage salt.jpeg
  • Waterwijzer damage total.jpeg


The Waterwijzer Overlay is a Grid Overlay. The project area is rasterized into grid cells, each containing a value for:

  • the type of crop, identified by their BRP Code.
  • the soil: BOFEK_ID
  • the lowest (average) groundwater depth: distance to surface, from the configured prequel Grid Overlay for LOW_GROUND_WATER.
  • the highest (average) groundwater depth: distance of surface, from the configured prequel Grid Overlay for HIGH_GROUND_WATER.

The climate scenario and weather station are a defined for the overlay and therefore the same for each grid cell.

Each unique combination of crop, soil, groundwater depths, climate scenario and weather station leads to four yield loss values, one for each category, which were described above. To make it more efficient, we send each combination only once. The groundwater levels have the most variance. However, the Waterwijzer API interprets the groundwater levels with a precision of 0.1 meter.

Once the yield loss has been sent back for each combination, we process all grid cells and store it's yield loss, depending on the result types configured for the Waterwijzer Overlay.


  • Currently we round the groundwater values to the nearest value based on the 0.1 meter precision. However, in the near future we will replace this with bi-linear interpolation between the 4 combinations of floored and ceiled groundwater levels, which is similar to the calculation done by the Waterwijzer's standalone application.