View Source

The DikesOvertopping adapter has been introduced in the RWS 2023.02 branch to replace the PCOverslag Adapter, using the DikesOvertopping and Dam and Foreshore (DaF) kernels that have been developed and used for the WTI2017 project.

The files needed to run the DikesOvertoppingAdapter from Delft-FEWS can be found in the install artifacts in the FEWS adapters build. The following files should be located in the bin directory in the DikesOvertopping Module location:

Currently this adapter is only available for Linux.

fews-dikesovertopping-adapter.jar
castor-0.9.5p.jar
Delft_PI.jar
Delft_PI_castor.jar
Deflt_Util.jar
jna-5.7.0.jar
libDamAndForeshore.so
libDikesOvertopping.so
libFeedbackDll.so
libgfortran.so
libgomp.so
libjnidispatch.so
libquadmath.so
log4j-1.2-api-2.18.0.jar
log4j-api-2.18.0.jar
log4j-core-2.18.0.jar

Input

Wave height
Wave direction
Wave period
Waterlevel

Output

Golf oploop
Golf overslag
Golf oploop niveau
Golf overslag niveau
Overslag debiet

Below is an example of the general adapter configuration file, to be used with version Stable2011.02 onwards.

<?xml version="1.0" encoding="UTF-8"?>
<!-- edited with XMLSpy v2009 sp1 (http://www.altova.com) by ICT (Stichting Deltares) -->
<generalAdapterRun xmlns="http://www.wldelft.nl/fews" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://www.wldelft.nl/fews http://fews.wldelft.nl/schemas/version1.0/generalAdapterRun.xsd">
	<!-- General information for General Adapter run -->
	<general>
		<description>Dikesovertopping model voor het IJsselmeer</description>
		<piVersion>1.8</piVersion>
		<rootDir>%REGION_HOME%/Modules/dikesovertopping/</rootDir>
		<workDir>%ROOT_DIR%/work</workDir>
		<exportDir>%ROOT_DIR%/input</exportDir>
		<exportDataSetDir>%REGION_HOME%/Modules</exportDataSetDir>
		<exportIdMap>IdImportExportDikesOvertopping</exportIdMap>
		<importDir>%ROOT_DIR%/output</importDir>
		<importIdMap>IdImportExportDikesOvertopping</importIdMap>
		<dumpFileDir>$GA_DUMPFILEDIR$</dumpFileDir>
		<dumpDir>%ROOT_DIR%</dumpDir>
		<diagnosticFile>%ROOT_DIR%/diagnostics/diagnostics.xml</diagnosticFile>
		<convertDatum>false</convertDatum>
	</general>
	<activities>
		<startUpActivities>
			<purgeActivity>
				<filter>%ROOT_DIR%/input/*.*</filter>
			</purgeActivity>
			<purgeActivity>
				<filter>%ROOT_DIR%/output/*.*</filter>
			</purgeActivity>
			<purgeActivity>
				<filter>%ROOT_DIR%/diagnostics/*.*</filter>
			</purgeActivity>
		</startUpActivities>
		<exportActivities>
			<exportTimeSeriesActivity>
				<exportFile>input.xml</exportFile>
				<timeSeriesSets>
					<timeSeriesSet>
						<moduleInstanceId>Preprocessing_DikesOvertopping</moduleInstanceId>
						<valueType>scalar</valueType>
						<parameterId>Golf.periode.voorspeld</parameterId>
						<locationSetId>Dijkvak</locationSetId>
						<timeSeriesType>temporary</timeSeriesType>
						<timeStep unit="hour" multiplier="1"/>
						<relativeViewPeriod unit="hour" start="-6" end="48"/>
						<readWriteMode>read only</readWriteMode>
					</timeSeriesSet>
					<timeSeriesSet>
						<moduleInstanceId>Preprocessing_DikesOvertopping</moduleInstanceId>
						<valueType>scalar</valueType>
						<parameterId>Golf.hoogte.voorspeld</parameterId>
						<locationSetId>Dijkvak</locationSetId>
						<timeSeriesType>temporary</timeSeriesType>
						<timeStep unit="hour" multiplier="1"/>
						<relativeViewPeriod unit="hour" start="-6" end="48"/>
						<readWriteMode>read only</readWriteMode>
					</timeSeriesSet>
					<timeSeriesSet>
						<moduleInstanceId>Preprocessing_DikesOvertopping</moduleInstanceId>
						<valueType>scalar</valueType>
						<parameterId>Golf.richting.voorspeld</parameterId>
						<locationSetId>Dijkvak</locationSetId>
						<timeSeriesType>temporary</timeSeriesType>
						<timeStep unit="hour" multiplier="1"/>
						<relativeViewPeriod unit="hour" start="-6" end="48"/>
						<readWriteMode>read only</readWriteMode>
					</timeSeriesSet>
					<timeSeriesSet>
						<moduleInstanceId>Preprocessing_DikesOvertopping</moduleInstanceId>
						<valueType>scalar</valueType>
						<parameterId>H.voorspeld</parameterId>
						<locationSetId>Dijkvak</locationSetId>
						<timeSeriesType>temporary</timeSeriesType>
						<timeStep unit="hour" multiplier="1"/>
						<relativeViewPeriod unit="hour" start="-6" end="48"/>
						<readWriteMode>read only</readWriteMode>
					</timeSeriesSet>
				</timeSeriesSets>
			</exportTimeSeriesActivity>
			<exportDataSetActivity>
				<moduleDataSetName>dikesovertopping_model</moduleDataSetName>			
			</exportDataSetActivity>
			<exportRunFileActivity>
				<description>This pi run file is passes as argument to DikesOvertopping Adapter</description>
				<exportFile>%ROOT_DIR%/pi-run.xml</exportFile>
				<properties>
					<description>Specific configuration required for DikesOvertopping Adapter</description>
					<string value="no" key="WITH_ITERATION"/>
					<string value="%ROOT_DIR%/profiles" key="PROFILE_DIR"/>
					<float value="0.5" key="MINIMUM_STEP_SIZE"/>
					<float value="0.5" key="RATIO_DEPTH"/>
				</properties>
			</exportRunFileActivity>
		</exportActivities>
		<executeActivities>
			<executeActivity>
				<description>DikesOvertopping adapter</description>
				<command>
					<className>nl.deltares.fews.adapter.dikesovertopping.DikesOvertoppingAdapter</className>
					<binDir>$DIKESOVERTOPPINGBINPATH$</binDir>
				</command>
				<arguments>
					<argument>%ROOT_DIR%/pi-run.xml</argument>
				</arguments>
				<timeOut>20000000</timeOut>
			</executeActivity>
		</executeActivities>
		<importActivities>
			<!-- Import DikesOvertopping results-->
			<importTimeSeriesActivity>
				<importFile>output.xml</importFile>
				<timeSeriesSets>
					<timeSeriesSet>
						<moduleInstanceId>DikesOvertopping_forecast</moduleInstanceId>
						<valueType>scalar</valueType>
						<parameterId>Golf.oploop.Z2%.voorspeld</parameterId>
						<locationSetId>DijkvakGolf</locationSetId>
						<timeSeriesType>simulated forecasting</timeSeriesType>
						<timeStep unit="hour" multiplier="1"/>
						<readWriteMode>add originals</readWriteMode>
						<expiryTime unit="day" multiplier="$EXPIRYTIME_DAY_SIMULATED_HISTORICAL$"/>
					</timeSeriesSet>
					<timeSeriesSet>
						<moduleInstanceId>DikesOvertopping_forecast</moduleInstanceId>
						<valueType>scalar</valueType>
						<parameterId>Golf.oploop.Z2%.H.voorspeld</parameterId>
						<locationSetId>DijkvakGolf</locationSetId>
						<timeSeriesType>simulated forecasting</timeSeriesType>
						<timeStep unit="hour" multiplier="1"/>
						<readWriteMode>add originals</readWriteMode>
						<expiryTime unit="day" multiplier="$EXPIRYTIME_DAY_SIMULATED_HISTORICAL$"/>
					</timeSeriesSet>
					<timeSeriesSet>
						<moduleInstanceId>DikesOvertopping_forecast</moduleInstanceId>
						<valueType>scalar</valueType>
						<parameterId>Golf.overslag.MHK.1.voorspeld</parameterId>
						<locationSetId>DijkvakGolf</locationSetId>
						<timeSeriesType>simulated forecasting</timeSeriesType>
						<timeStep unit="hour" multiplier="1"/>
						<readWriteMode>add originals</readWriteMode>
						<expiryTime unit="day" multiplier="$EXPIRYTIME_DAY_SIMULATED_HISTORICAL$"/>
					</timeSeriesSet>
					<timeSeriesSet>
						<moduleInstanceId>DikesOvertopping_forecast</moduleInstanceId>
						<valueType>scalar</valueType>
						<parameterId>Golf.overslag.MKH.1.H.voorspel</parameterId>
						<locationSetId>DijkvakGolf</locationSetId>
						<timeSeriesType>simulated forecasting</timeSeriesType>
						<timeStep unit="hour" multiplier="1"/>
						<readWriteMode>add originals</readWriteMode>
						<expiryTime unit="day" multiplier="$EXPIRYTIME_DAY_SIMULATED_HISTORICAL$"/>
					</timeSeriesSet>
					<timeSeriesSet>
						<moduleInstanceId>DikesOvertopping_forecast</moduleInstanceId>
						<valueType>scalar</valueType>
						<parameterId>Overslag.debiet.voorspeld</parameterId>
						<locationSetId>DijkvakGolf</locationSetId>
						<timeSeriesType>simulated forecasting</timeSeriesType>
						<timeStep unit="hour" multiplier="1"/>
						<readWriteMode>add originals</readWriteMode>
						<expiryTime unit="day" multiplier="$EXPIRYTIME_DAY_SIMULATED_HISTORICAL$"/>
					</timeSeriesSet>
					<!--LocationSet DAM, resultaten zonder DAM-->
					<timeSeriesSet>
						<moduleInstanceId>DikesOvertopping_forecast</moduleInstanceId>
						<valueType>scalar</valueType>
						<parameterId>Golf.oploop.Z2%.voorspeld.dam.weg</parameterId>
						<locationSetId>DijkvakGolfDAM</locationSetId>
						<timeSeriesType>simulated forecasting</timeSeriesType>
						<timeStep unit="hour" multiplier="1"/>
						<readWriteMode>add originals</readWriteMode>
						<expiryTime unit="day" multiplier="$EXPIRYTIME_DAY_SIMULATED_HISTORICAL$"/>
					</timeSeriesSet>
					<timeSeriesSet>
						<moduleInstanceId>DikesOvertopping_forecast</moduleInstanceId>
						<valueType>scalar</valueType>
						<parameterId>Golf.oploop.Z2%.H.voorspeld.dam.weg</parameterId>
						<locationSetId>DijkvakGolfDAM</locationSetId>
						<timeSeriesType>simulated forecasting</timeSeriesType>
						<timeStep unit="hour" multiplier="1"/>
						<readWriteMode>add originals</readWriteMode>
						<expiryTime unit="day" multiplier="$EXPIRYTIME_DAY_SIMULATED_HISTORICAL$"/>
					</timeSeriesSet>
					<timeSeriesSet>
						<moduleInstanceId>DikesOvertopping_forecast</moduleInstanceId>
						<valueType>scalar</valueType>
						<parameterId>Golf.overslag.MHK.1.voorspeld.dam.weg</parameterId>
						<locationSetId>DijkvakGolfDAM</locationSetId>
						<timeSeriesType>simulated forecasting</timeSeriesType>
						<timeStep unit="hour" multiplier="1"/>
						<readWriteMode>add originals</readWriteMode>
						<expiryTime unit="day" multiplier="$EXPIRYTIME_DAY_SIMULATED_HISTORICAL$"/>
					</timeSeriesSet>
					<timeSeriesSet>
						<moduleInstanceId>DikesOvertopping_forecast</moduleInstanceId>
						<valueType>scalar</valueType>
						<parameterId>Golf.overslag.MKH.1.H.voorspel.dam.weg</parameterId>
						<locationSetId>DijkvakGolfDAM</locationSetId>
						<timeSeriesType>simulated forecasting</timeSeriesType>
						<timeStep unit="hour" multiplier="1"/>
						<readWriteMode>add originals</readWriteMode>
						<expiryTime unit="day" multiplier="$EXPIRYTIME_DAY_SIMULATED_HISTORICAL$"/>
					</timeSeriesSet>
					<timeSeriesSet>
						<moduleInstanceId>DikesOvertopping_forecast</moduleInstanceId>
						<valueType>scalar</valueType>
						<parameterId>Overslag.debiet.voorspeld.dam.weg</parameterId>
						<locationSetId>DijkvakGolfDAM</locationSetId>
						<timeSeriesType>simulated forecasting</timeSeriesType>
						<timeStep unit="hour" multiplier="1"/>
						<readWriteMode>add originals</readWriteMode>
						<expiryTime unit="day" multiplier="$EXPIRYTIME_DAY_SIMULATED_HISTORICAL$"/>
					</timeSeriesSet>
					<!--LocationSet DAM, resultaten met DAM-->
					<timeSeriesSet>
						<moduleInstanceId>DikesOvertopping_forecast</moduleInstanceId>
						<valueType>scalar</valueType>
						<parameterId>Golf.oploop.Z2%.voorspeld</parameterId>
						<locationSetId>DijkvakGolfDAM</locationSetId>
						<timeSeriesType>simulated forecasting</timeSeriesType>
						<timeStep unit="hour" multiplier="1"/>
						<readWriteMode>add originals</readWriteMode>
						<expiryTime unit="day" multiplier="$EXPIRYTIME_DAY_SIMULATED_HISTORICAL$"/>
					</timeSeriesSet>
					<timeSeriesSet>
						<moduleInstanceId>DikesOvertopping_forecast</moduleInstanceId>
						<valueType>scalar</valueType>
						<parameterId>Golf.oploop.Z2%.H.voorspeld</parameterId>
						<locationSetId>DijkvakGolfDAM</locationSetId>
						<timeSeriesType>simulated forecasting</timeSeriesType>
						<timeStep unit="hour" multiplier="1"/>
						<readWriteMode>add originals</readWriteMode>
						<expiryTime unit="day" multiplier="$EXPIRYTIME_DAY_SIMULATED_HISTORICAL$"/>
					</timeSeriesSet>
					<timeSeriesSet>
						<moduleInstanceId>DikesOvertopping_forecast</moduleInstanceId>
						<valueType>scalar</valueType>
						<parameterId>Golf.overslag.MHK.1.voorspeld</parameterId>
						<locationSetId>DijkvakGolfDAM</locationSetId>
						<timeSeriesType>simulated forecasting</timeSeriesType>
						<timeStep unit="hour" multiplier="1"/>
						<readWriteMode>add originals</readWriteMode>
						<expiryTime unit="day" multiplier="$EXPIRYTIME_DAY_SIMULATED_HISTORICAL$"/>
					</timeSeriesSet>
					<timeSeriesSet>
						<moduleInstanceId>DikesOvertopping_forecast</moduleInstanceId>
						<valueType>scalar</valueType>
						<parameterId>Golf.overslag.MKH.1.H.voorspel</parameterId>
						<locationSetId>DijkvakGolfDAM</locationSetId>
						<timeSeriesType>simulated forecasting</timeSeriesType>
						<timeStep unit="hour" multiplier="1"/>
						<readWriteMode>add originals</readWriteMode>
						<expiryTime unit="day" multiplier="$EXPIRYTIME_DAY_SIMULATED_HISTORICAL$"/>
					</timeSeriesSet>
					<timeSeriesSet>
						<moduleInstanceId>DikesOvertopping_forecast</moduleInstanceId>
						<valueType>scalar</valueType>
						<parameterId>Overslag.debiet.voorspeld</parameterId>
						<locationSetId>DijkvakGolfDAM</locationSetId>
						<timeSeriesType>simulated forecasting</timeSeriesType>
						<timeStep unit="hour" multiplier="1"/>
						<readWriteMode>add originals</readWriteMode>
						<expiryTime unit="day" multiplier="$EXPIRYTIME_DAY_SIMULATED_HISTORICAL$"/>
					</timeSeriesSet>
				</timeSeriesSets>
			</importTimeSeriesActivity>
		</importActivities>
	</activities>
</generalAdapterRun>

Properties

Two properties must defined for the run-pi.xml export file.

PROFILE_DIR

This is the path where the profile description files are located. The profile description files are ascii files which describe the characteristics and geometry of the profiles which will be computed.

An example of a profile (*.prfl) file is given below:

DAM 	3
DAMHOOGTE	1.8
RICHTING	280
KRUINHOOGTE	3.16
VOORLAND	1
0.000	1.800	0.000
-61.440	-4.500	1.000
-49.500	1.470	1.000
-3.500	2.170	1.000
0.000	3.160	1.000
MEMO
profiel handmatig toegevoegd (MvR, 08/10/2007)
obv rapport 110303/OF2/249/000144/AM, profiel L601dv
hoogte havendam obv AHN_5
Locatie: 177000;539229