Page History

There are several model adapters for URBS:

• URBS parameter adapter (this wiki), which
  
  • creates the *.ini file that will be used by the URBS pre adapter (see next step),
  • incorporating the modifier written by Delft-FEWS if any
  • For more info, see below.
• URBS pre adapter, that does several things:
  • extracts the start date, end date and time increment for the data series from the startDate, endDate and timeStep.
  • creates an individual file for rainfall, gauging station and inflow data (i.e. the “.r”, “.g” or ‘.i” files) as exported by Delf-FEWS.
  • reads the relevant directories to run the URBS model.
  • create the modelAdapter.bat file, to start the URBS model
  • For more info see https://publicwiki.deltares.nl/download/attachments/8684125/Delft-FEWS%20%E2%80%93%20URBS%20Adapters%20v1.0.pdf?version=1&modificationDate=1513747330821&api=v2
• URBS post adapter, which
  
  • converts the URBS output files to a single xml results file and
  • appends log messages from both the model run and the post adapter itself to the log file created by the pre adapter.
  • For more info see https://publicwiki.deltares.nl/download/attachments/8684125/Delft-FEWS%20%E2%80%93%20URBS%20Adapters%20v1.0.pdf?version=1&modificationDate=1513747330821&api=v2

Version control of URBS parameter adapter

• 2018.02 and up: fews-urbs-parameter-adapter.jar (updated version due to upgraded jre version java 2013)
• Pre 2018.02: fews-urbs-parameter-adapter.jar
• Deprecated: UrbsIniAdapter.jar

Properties URBS parameter adapter

For this adapter, some optional properties can be configured

parameterSeriesFile 

When this property is configured, the adapter will read a pi xml file and will extract the first non missing value for each time series and will replace the values in the .ini file that matches the key of the parameter of that time series.

...

<?xml version="1.0" encoding="UTF-8"?>
<TimeSeries xmlns="http://www.wldelft.nl/fews/PI" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://www.wldelft.nl/fews/PI http://fews.wldelft.nl/schemas/version1.0/pi-schemas/pi_timeseries.xsd" version="1.10">
    <timeZone>10.0</timeZone>
    <series>
        <header>
            <type>instantaneous</type>
            <locationId>tweed_uki</locationId>
            <parameterId>URBS_IL</parameterId>
            <ensembleId>IFD</ensembleId>
            <ensembleMemberIndex>0</ensembleMemberIndex>
            <timeStep unit="second" multiplier="86400"/>
            <startDate date="2018-05-21" time="10:00:00"/>
            <endDate date="2018-05-24" time="10:00:00"/>
            <missVal>-99.0</missVal>
            <stationName>tweed_uki</stationName>
            <lat>-28.46995606962717</lat>
            <lon>153.2671548515222</lon>
            <x>153.2671548515222</x>
            <y>-28.46995606962717</y>
            <z>0.0</z>
            <units>mm</units>
        </header>
        <event date="2018-05-21" time="10:00:00" value="-99.0" flag="8"/>
        <event date="2018-05-22" time="10:00:00" value="48" flag="0"/>
        <event date="2018-05-23" time="10:00:00" value="40" flag="0"/>
        <event date="2018-05-24" time="10:00:00" value="-99.0" flag="8"/>
    </series>
</TimeSeries>

locationParameterSeriesFile

When this property is configured, the adapter will read a pi xml file and will extract the first non missing value for each time series and will replace the values in the .ini file that matches the key of the location of that time series.

...

This is only done for the "Initial Dam Volumes and Levels" section in the .ini file.

vecFile

a vec file can be configured which will get the "URBS_VEC_TAGS" group from the Parameters.xml and will replace the corresponding tags is the specified vec file with the values of the parameter.

...