For URBS there are two adapters, one made by the developers of the URBS code Don Carroll and one made by Deltares. The URBS adapter developed by Don Carroll takes care of the conversion of the time series files from PI XML format to native URBS files and logging. The URBS adapter developed by Deltares supports the conversion of model parameters from standard Delft-FEWS PI-format to URBS ini files.
The model adapters activities for URBS are therefore split in two adapter documentsThere are several model adapters for URBS:
- URBS parameter adapter from Deltares (this wiki), which
responsible for:- Conversion of the Delft-FEWS PI Parameter XML file to creates the *.ini file that will be used by the URBS pre adapter (see next step),incorporating the modifier . This parameters file can incorporate location attribute modifiers written by Delft-FEWS if any For more info, see belowFEWS
- Documentation of this adapter can be found on this page.
- URBS pre and post adapter , that does several thingsfrom Don Carroll, responsible for:
- extracts Extraction of the start date, end date and time increment for the data series from the startDate, endDate and timeStep.
- creates an individual file Conversion of time series files for rainfall, gauging station and inflow data (i.e. the “.r”, “.g” or ‘.i” files) as exported by from Delf-FEWS .
- reads the relevant directories to run the URBS model.
- PI XML to native URBS formatted files.
- Creation of 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
- converts Conversion of the URBS output files to a single xml results file and Delft-FEWS PI XML time series file
- Conversion of appends log messages from both the model run and the pre- and post adapter itself to the log file created by the pre adapter.Delft-FEWS PI XML log files
- 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 pre and post adapter
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
exportActivities
exportTimeSeriesActivity exports
Code Block | ||||
---|---|---|---|---|
| ||||
<exportTimeSeriesActivity>
<exportFile>Input.xml</exportFile>
<timeSeriesSets>
<timeSeriesSet>
....
</timeSeriesSet>
</timeSeriesSets>
</exportTimeSeriesActivity> |
exportParameterActivity exports parameter set for the configured module instance.
Code Block | ||
---|---|---|
| ||
<exportParameterActivity>
<fileName>params.xml</fileName>
<moduleInstanceId>URBS_Parameters</moduleInstanceId>
</exportParameterActivity> |
exportRunFileActivity exports a pi run file in xml format, containing general information about the run. This file is used by the URBS parameter adapter.
Code Block | ||
---|---|---|
| ||
<exportRunFileActivity>
<exportFile>paramAdapter_runinfo.xml</exportFile>
<properties>
<string key="urbsIniFile" value="%ROOT_DIR%\model\$SUBCATCHMENT$.ini"/>
<string key="rdfFile" value="%ROOT_DIR%\model\$SUBCATCHMENT$.rdf"/>
<string key="URBS_BIN" value="$MODULES_BIN$\urbs"/>
</properties>
</exportRunFileActivity> |
Properties URBS parameter adapter
...