Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

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.For more details on the PCOverslag applicatie see the helpdeskwater pages..

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.

No Format
<?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:

No Format
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