PCOverslag

The PC overslag adapter has been replaced with the DikesOvertopping adapter, which has the same functionality but uses new kernels developed for the WTI2017 project and currently runs only on Linux.

The PCOverslag adapter therefor is no longer supported, even though it is still available in most of the FEWS SVN repositories, if for some reason you still need to use the old PCOverslag adapter, please do NOT take it from the RWS branches as the RWS2022.02 branch contains an experimental version where it was ported to Linux and the new kernels but had not been renamed to DikesOvertopping yet.

PCOverslag can be connected to Delft-FEWS using the PCOverslagAdapter developed by Deltares.

The files needed to run the PCOverslagAdapter from Delft-FEWS can be found in the install artifacts fews-adapters-bin.zip. The following files should be located in the bin directory in the PCOverslag Module location:

Adapters_PCOverslag.jar
castor-0.9.5.jar
Delft_PI.jar
Delft_PI_castor.jar
Deflt_Util.jar
log4j-1.2.14.jar
pco.dll
pcomkh.dll
xercesImpl.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"?>
<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>PC Overslag model voor het IJsselmeer</description>
		<rootDir>%REGION_HOME%/Modules/PCOverslag</rootDir>
		<workDir>%ROOT_DIR%/work</workDir>
		<exportDir>%WORK_DIR%/input</exportDir>
		<exportDataSetDir>%ROOT_DIR%/profiles</exportDataSetDir>
		<exportIdMap>Id_PCOverslag</exportIdMap>
		<importDir>%WORK_DIR%/output</importDir>
		<importIdMap>Id_PCOverslag</importIdMap>
		<dumpFileDir>%REGION_HOME%/DumpFiles</dumpFileDir>
		<dumpDir>%ROOT_DIR%</dumpDir>
		<diagnosticFile>%WORK_DIR%/diagnostics/diagnostics.xml</diagnosticFile>
		<convertDatum>false</convertDatum>
	</general>
	<activities>
		<startUpActivities>
			<purgeActivity>
				<filter>%WORK_DIR%/input/*.*</filter>
			</purgeActivity>
			<purgeActivity>
				<filter>%WORK_DIR%/output/*.*</filter>
			</purgeActivity>
			<purgeActivity>
				<filter>%ROOT_DIR%/profiles/*.*</filter>
			</purgeActivity>
			<purgeActivity>
				<filter>%WORK_DIR%/*.*</filter>
			</purgeActivity>
		</startUpActivities>
		<exportActivities>
			<exportTimeSeriesActivity>
				<exportFile>input.xml</exportFile>
				<timeSeriesSets>
					<timeSeriesSet>
						<moduleInstanceId>Kopieer_Hydra_naar_Dijkvak</moduleInstanceId>
						<valueType>scalar</valueType>
						<parameterId>Golf.periode.voorspeld</parameterId>
						<locationSetId>Dijkvak</locationSetId>
						<timeSeriesType>simulated forecasting</timeSeriesType>
						<timeStep unit="hour" multiplier="1"/>
						<relativeViewPeriod unit="hour" start="-6" end="12"/>
						<readWriteMode>read only</readWriteMode>
					</timeSeriesSet>
					<timeSeriesSet>
						<moduleInstanceId>Kopieer_Hydra_naar_Dijkvak</moduleInstanceId>
						<valueType>scalar</valueType>
						<parameterId>Golf.hoogte.voorspeld</parameterId>
						<locationSetId>Dijkvak</locationSetId>
						<timeSeriesType>simulated forecasting</timeSeriesType>
						<timeStep unit="hour" multiplier="1"/>
						<relativeViewPeriod unit="hour" start="-6" end="12"/>
						<readWriteMode>read only</readWriteMode>
					</timeSeriesSet>
					<timeSeriesSet>
						<moduleInstanceId>Kopieer_Hydra_naar_Dijkvak</moduleInstanceId>
						<valueType>scalar</valueType>
						<parameterId>Golf.richting.voorspeld</parameterId>
						<locationSetId>Dijkvak</locationSetId>
						<timeSeriesType>simulated forecasting</timeSeriesType>
						<timeStep unit="hour" multiplier="1"/>
						<relativeViewPeriod unit="hour" start="-6" end="12"/>
						<readWriteMode>read only</readWriteMode>
					</timeSeriesSet>
					<timeSeriesSet>
						<moduleInstanceId>Kopieer_Hydra_naar_Dijkvak</moduleInstanceId>
						<valueType>scalar</valueType>
						<parameterId>H.voorspeld</parameterId>
						<locationSetId>Dijkvak</locationSetId>
						<timeSeriesType>simulated forecasting</timeSeriesType>
						<timeStep unit="hour" multiplier="1"/>
						<relativeViewPeriod unit="hour" start="-6" end="12"/>
						<readWriteMode>read only</readWriteMode>
					</timeSeriesSet>
				</timeSeriesSets>
			</exportTimeSeriesActivity>
			<exportDataSetActivity>
				<moduleInstanceId>PCOverslag_Voorspelling</moduleInstanceId>
			</exportDataSetActivity>
			<exportRunFileActivity>
				<description>This pi run file is passes as argument to PcOverslagAdapter</description>
				<exportFile>%WORK_DIR%/pi-run.xml</exportFile>
				<properties>
					<description>Specific configuration required for PcOverslagAdapter</description>
					<string value="no" key="WITH_ITERATION"/>
					<string value="%ROOT_DIR%/profiles" key="PROFILE_DIR"/>
				</properties>
			</exportRunFileActivity>
		</exportActivities>
		<executeActivities>
			<executeActivity>
				<description>PC Overslag Adapter</description>
				<command>
					<className>nl.wldelft.fews.adapter.pcoverslag.PcOverslagAdapter</className>
					<binDir>%ROOT_DIR%/bin</binDir>
				</command>
				<arguments>
					<argument>%WORK_DIR%/pi-run.xml</argument>
				</arguments>
				<timeOut>300000</timeOut>
			</executeActivity>
		</executeActivities>
		<importActivities>
			<!-- Import PC Overslag results-->
			<importTimeSeriesActivity>
				<importFile>output.xml</importFile>
				<timeSeriesSets>
					<timeSeriesSet>
						<moduleInstanceId>PCOverslag_Voorspelling</moduleInstanceId>
						<valueType>scalar</valueType>
						<parameterId>Golf.oploop.voorspeld</parameterId>
						<locationSetId>DijkvakGolf</locationSetId>
						<timeSeriesType>simulated forecasting</timeSeriesType>
						<timeStep unit="hour" multiplier="1"/>
						<readWriteMode>add originals</readWriteMode>
					</timeSeriesSet>
					<timeSeriesSet>
						<moduleInstanceId>PCOverslag_Voorspelling</moduleInstanceId>
						<valueType>scalar</valueType>
						<parameterId>Golf.oploop.niveau.voorspeld</parameterId>
						<locationSetId>DijkvakGolf</locationSetId>
						<timeSeriesType>simulated forecasting</timeSeriesType>
						<timeStep unit="hour" multiplier="1"/>
						<readWriteMode>add originals</readWriteMode>
					</timeSeriesSet>
					<timeSeriesSet>
						<moduleInstanceId>PCOverslag_Voorspelling</moduleInstanceId>
						<valueType>scalar</valueType>
						<parameterId>Golf.overslag.voorspeld</parameterId>
						<locationSetId>DijkvakGolf</locationSetId>
						<timeSeriesType>simulated forecasting</timeSeriesType>
						<timeStep unit="hour" multiplier="1"/>
						<readWriteMode>add originals</readWriteMode>
					</timeSeriesSet>
					<timeSeriesSet>
						<moduleInstanceId>PCOverslag_Voorspelling</moduleInstanceId>
						<valueType>scalar</valueType>
						<parameterId>Golf.overslag.niveau.voorspeld</parameterId>
						<locationSetId>DijkvakGolf</locationSetId>
						<timeSeriesType>simulated forecasting</timeSeriesType>
						<timeStep unit="hour" multiplier="1"/>
						<readWriteMode>add originals</readWriteMode>
					</timeSeriesSet>
					<timeSeriesSet>
						<moduleInstanceId>PCOverslag_Voorspelling</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>
					</timeSeriesSet>
				</timeSeriesSets>
			</importTimeSeriesActivity>
		</importActivities>
	</activities>
</generalAdapterRun>

Properties

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

WITH_ITERATION

With this option there is a choice between running the PCOverslag dll's with or without iteration (Default is no).

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

Page tree