PCOverslag

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

For more details on the PCOverslag application see the helpdeskwater pages and the PCOverslag programming guide (in Dutch).

Page tree