Description

On request of the Dutch water boards a FEWS Explorer plugin has been developed (FEWS 2023.01 branch) that allows a user to select groundwater monitoring locations in the Netherlands from the map and review the availability of data for specific locations by temporarily importing data. This data is managed by BRO (Bureau Registratie Ondergrond) and can be accessed using their public webservices. 

This plugin will activate itself under 2 conditions:

1. Presence of a map layer with a name containing the string "BRO"
   Normally this is realized using the PDOK WMS layer "Grondwatermonitoringput (GMW)"
   
   
2. Presence of a Filter with the ID "BRO_GMW"
   This filter can be any (dummy) filter, which is used to get a relative period for BRO queries

When both conditions are met the BRO temporary import "plugin" will activate at startup of the FEWS Standalone or Operator client. The plugin has no user interface except a pop-up selection dialog, it will integrate with the standard map of the Netherlands. The GMW (Groundwater Monitoring Well) locations managed by BRO will appear on the map as small blue rectangles:

Map of GMW locations

After zooming in on the area of interest, there are a few buttons that can be used to control how selections are made from the map:

1. If you activate the info button (7th button from the right) this will enable queries to PDOK using the WMS layer, which will appear in a yellow pop-up tooltip. 
   
   
2. If you do not activate any of the pan or zoom modes (this is the default at startup) than you can double-click (left button) on any of the blue triangles to query for data.
   If the GMW you select contains one more GLD's (grondwaterstandonderzoek) that hold data for the search period (defined by the filter) a temporary import is started, the status of this import is visible in the Log panel and if the import is successful the locations (GLD's) and a parameter "Waterstand" will appear in the Data Viewer panel, in this example docked on the left side of FEWS explorer.
   
   
3. If you activate the rectangle selection button (5th button from the right) you will be able to select all GMW's within a rectangular area, in which case a selection dialog will appear. A maximum of 50 GMW locations will automatically be selected so you can simply proceed to query all of them, if the rectangle you selected contains more than 50 GMW's you will need to select individual ones from the dialog (to prevent putting too much of a load on the BRO webservices by selecting large areas at once)

Selection dialog

After making a selection of station and clicking OK, each individual GMW is queried to find the GLD's it contains, then each individual GLD is queried for the availability of data, and if there are 'series' found that overlap a temporary import is started. These series will be imported completely. So even with the default search period of 3 years, series going back in time further than that may be imported completely simply because they overlap the search period.

You can follow the progress in the log panel, and will see locations appear one by one in the data viewer, nested under the BRO filter.

Temporary import

The data imports done by this plugin are always of a temporary nature, facilitating a review of data availability for your area of interest, this temporary data is not input to the data store and will disappear when you close the FEWS session. To actually use this data in FEWS you will need to manually configure a Time series import workflow using the BroGldAddition parser, configured for each GLD separately.

Configuration examples

In the FEWS Explorer configuration where the map uses WGS84 datum, the GMW layer provided by PDOK can be configured as follows

	<map>
	...
   		<layerGroup id="NL">
			<wmsLayer id="brogmw" name="BRO GMW">
				<url>https://service.pdok.nl/bzk/bro-gminsamenhang-karakteristieken/wms/v1_0</url>
				<wmsLayerName>gm_gmw</wmsLayerName>
				<imageFormat>png</imageFormat>
				<transparent>true</transparent>
				<visible>true</visible>
				<toolTipAvailable>true</toolTipAvailable>
				<cacheDir>$CACHE_FOLDER$/WMSLayers/brogmw</cacheDir>
			</wmsLayer>
	...	

In the Region Filter configuration a Filter can be added as follows (for a search period of 3 years)

	...
	<filter id="BRO_GMW" name="BRO Groundwater">
		<timeSeries>
			<moduleInstanceId>BRO_GLD_temporary</moduleInstanceId>
			<parameterId>waterstand</parameterId>
			<timeSeriesType>temporary</timeSeriesType>
			<timeStep unit="nonequidistant"/>
		</timeSeries>
		<relativeViewPeriod start="-1095" end="0" unit="day"/>
	</filter>
	...