...
Configuration Manual for HEC-RAS versions 5.0.3: Config manual RAS 5.0.3.
Configuration Manual for HEC-RAS versions 5.0.7: Config manual RAS 5.0.7 and RAS Mapper
Configuration Manual for HEC-RAS version 6.0: Config manual RAS 6.0
Interface between FEWS and HEC-RAS
...
The features of the are listed in the tables below.
Preprocessing 01 | Clean up work and output folder |
Preprocessing 02 | Create module diagnostics file in Published Interface (PI) format |
Preprocessing 03 | Read the time series from PI time series |
Preprocessing 04 | Convert input PI time series into RAS *.b01 files |
Launcher 01 | Run HEC-RAS with run period and model alternative |
Postprocessing 01 | Open/create module diagnostics file in PI format |
Postprocessing 02 | Read the output time series from the RAS DSS and binary output files |
Postprocessing 03 | Write the time series to the output.xml |
Postprocessing 04 | Write the time series to the binary-output.xml |
Postprocessing 05 | Write the updated PI state file to export folder |
ID Mapping
The location parameters used in FEWS can be coupled to HEC-RAS DSS path names through ID-mapping. The configuration files for ID-mapping should be created separately for each HEC-RAS model. Please consult 08 Mapping Id's flags and units for more information on how to configure id mapping in FEWS system.
...
Table 1 List of files to be read and written by adapter
Extension | Description | pre-adapter input | pre-adapter output | post-adapter input | post-adapter output |
---|---|---|---|---|---|
.prj | project file |
.p01 | plan files |
.g01 | geometry files |
.f01 | flow files |
.u01 | unsteady flow files |
.b01 | unsteady run files |
.x01 | input file for geometry preprocessor |
.r01 | steady run file |
.O01 | binary output file |
.bco | model log file |
.c01 | output of geometry preprocessor |
.dss | input / output files |
.hyd01 | input file for geometry preprocessor |
Configuring Configuring HEC-RAS adapter
HEC-RAS model adapter follows standard way of integrating external models into the Delft-FEWS system by use of General Adapter. For more details about configuration of General Adapter please check 05 General Adapter Module.
...
Code Block | ||||||
---|---|---|---|---|---|---|
| ||||||
<TimeSeries
xsi:schemaLocation="http://www.wldelft.nl/fews/PI http://fews.wldelft.nl/schemas/version1.0/pi-schemas/pi_timeseries.xsd"
version="1.2" xmlns="http://www.wldelft.nl/fews/PI" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
<timeZone>0.0</timeZone>
<series>
<header>
<type>instantaneous</type>
<locationId>CT RIVER R1/0.00</locationId>
<parameterId>FLOW</parameterId>
<timeStep unit="second" multiplier="3600"/>
<startDate date="2008-11-06" time="00:00:00"/>
<endDate date="2008-11-08" time="00:00:00"/>
<missVal>NaN</missVal>
<units>CFS</units>
</header>
<event date="2008-11-06" time="00:00:00" value="24.38823" flag="0"/>
<event date="2008-11-06" time="01:00:00" value="-5.8442316" flag="0"/>
<event date="2008-11-06" time="02:00:00" value="68.705124" flag="0"/>
<event date="2008-11-06" time="03:00:00" value="391.09784" flag="0"/>
...
<event date="2008-11-07" time="23:00:00" value="438.6425" flag="0"/>
<event date="2008-11-08" time="00:00:00" value="-5259.6562" flag="0"/>
</series>
<series>
<header>
<type>instantaneous</type>
<locationId>CT RIVER R1/0.00</locationId>
<parameterId>STAGE</parameterId>
<timeStep unit="second" multiplier="3600"/>
<startDate date="2008-11-06" time="00:00:00"/>
<endDate date="2008-11-08" time="00:00:00"/>
<missVal>NaN</missVal>
<units>FEET</units>
</header>
<event date="2008-11-06" time="00:00:00" value="5.0" flag="0"/>
<event date="2008-11-06" time="01:00:00" value="5.0" flag="0"/>
<event date="2008-11-06" time="02:00:00" value="5.0" flag="0"/>
<event date="2008-11-06" time="03:00:00" value="5.0" flag="0"/>
...
|
Beste Practise Considerations
The HEC-RAS adapter requires quite some synergy between FEWS, Java and the actual HEC-RAS software versions. While a FEWS General Adapter config that uses embedded Java adapters is technically preferred above a custom JRE, it very sensitive to any software update. From past implementations we experience that using old models that run with older RAS versions, do not run anymore with actual adapter and Java versions. Therefore from an organizational and robustness perspective, it is preferred to have your both softwares as independent as possible, so with a custom JRE.
So instead of using the below default config:
Code Block | ||||
---|---|---|---|---|
| ||||
<executeActivity>
<command>
<className>nl.wldelft.fews.adapter.hec.HecRasAdapter</className>
<binDir>$HECRASBINDIR$</binDir>
</command>
<arguments>
<argument>%ROOT_DIR%/run_info.xml</argument>
</arguments>
<timeOut>3600000</timeOut>
</executeActivity>
|
one can better use a config like:
Code Block | ||||
---|---|---|---|---|
| ||||
<executeActivity>
<command>
<className>nl.wldelft.fews.adapter.hec.HecRasAdapter</className>
<binDir>$HECRASBINDIR$</binDir>
<!-- use old Java 8, while 2023.02 uses 11-->
<customJreDir>$CUSTOMJRE_64B_DIR$</customJreDir>
<!-- in case of custom JRE, pass correct default Parser definition-->
<jvmArg>-Dorg.xml.sax.parser=com.sun.org.apache.xerces.internal.parsers.SAXParser</jvmArg>
</command>
<arguments>
<argument>%ROOT_DIR%/run_info.xml</argument>
</arguments>
<console>
<!-- dump console in txt file, so in case of a crash, you see what happend-->
<redirectToLogFile>%ROOT_DIR%/log/adapter_console_logging.txt</redirectToLogFile>
</console>
<timeOut>3600000</timeOut>
</executeActivity>
|
Running model from FEWS
Check Using Delft-FEWS - User Guide on how to run configured model from the Delft-FEWS system.