Versions Compared

Key

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

Contents

Table of Contents

Introduction

Two modes of working of HEC-HMS are supported by the General adapter. Given a calibrated model, the modes of working are:

...

  1. FEWS CEMIG (Jan Talsma, Dirk Schwanenberg)
  2. FEWS Salto Grande (Jan Talsma, Otto de Keizer)
  3. FEWS Colombia (Micha Werner, Otto de Keizer)
  4. FEWS Pakistan (Jan Talsma)

Download

Download of the model adapter is not available here: pls e-mail to Delft-FEWS Product Management for more information.
A tutorial of how to add a HEC-HMS model as an adapter in FEWS is attached.

...

Note that only binary and configuration files relevant to the HEC-RAS adapter are included, in a real configuration a lot more files can be involved used by another modules of the FEWS system.

No Format

+---bin
|       <FEWS binaries>
\---FEWS_sa

    |
    +---Config
    |   +---ColdStateFiles
    |   |       HECHMS_UpdateStates Default.zip....cold state files
    |   |
    |   +---IdMapFiles
    |   |       IdExportHECHMS.xml
    |	|	IdImportHECHMS.xml.......................... custom mappings for the HEC-HMS variables and locations
    |   |
    |   +---ModuleConfigFiles
    |   |        HECHMS_Forecast.xml
    |	|	 HECHMS_Update.xml............ main configuration file of the adapter
    |   |
    |   \---ModuleDataSetFiles
    |            HECHMS_model.zip.........zipped hechms files, transported to Models directory
    |
    \---Models
        \---hec/hecras
            +---bin........................................ directory which contains all HEC-HMS executables for Windows and Linux platforms
            |
	    +---binAdapter................................. directory which contains allHEC-HMS adapter java files
            |
            \---model

		|    run_info.xml.......................... a file generated by FEWS containing paths, run options
                |
                +---basinStates.................................. folder containing the start/end statesinput directory of the adapter, input FEWS-PI time series files
                |
		+---map
		|
		+---optimizer
		|
                |
                +---piInputTimeseries.................................... input FEWS-PI time series files
                |       input.xml
                |
                +---piOutputTimeseriesoutput................................. output FEWS-PI time series files
                |       output.xml
                |
                |

		|model files
		|.dssfiles/results
		|debugfiles

...

Example configuration of the HEC-HMS adapter:

Code Block
xml
xml

<?xml version="1.0" encoding="UTF-8"?>
<!-- edited with XMLSpy v2009 sp1 (http://www.altova.com) by ICT (Stichting Deltares) -->
<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>
		<rootDir>%REGION_HOME%/Modules/hechms</rootDir>
		<workDir>%ROOT_DIR%/bin</workDir>
		<exportDir>%ROOT_DIR%/UpperBlueNile/piInputTimeSeries</exportDir>
		<exportIdMap>IdExportHECHMS</exportIdMap>
		<importDir>%ROOT_DIR%/UpperBlueNile/piOutputTimeSeries</importDir>
		<importIdMap>IdImportHECHMS</importIdMap>
		<dumpFileDir>$GA_DUMPFILEDIR$</dumpFileDir>
		<dumpDir>%ROOT_DIR%/UpperBlueNile</dumpDir>
		<diagnosticFile>%ROOT_DIR%/UpperBlueNile/piDiagnostic.xml</diagnosticFile>
		<missVal>-901.0</missVal>
		<convertDatum>true</convertDatum>
	</general>
	<activities>
		<startUpActivities>
			<purgeActivity>
				<filter>%ROOT_DIR%/UpperBlueNile/piInputTimeSeries/*.*</filter>
			</purgeActivity>
			<purgeActivity>
				<filter>%ROOT_DIR%/UpperBlueNile/piOutputTimeSeries/*.*</filter>
			</purgeActivity>
			<purgeActivity>
				<filter>%ROOT_DIR%/UpperBlueNile/*.ds*</filter>
			</purgeActivity>
		</startUpActivities>
		<exportActivities>
			<!-- Export state (warm state)-->
			<exportStateActivity>
				<moduleInstanceId>UpperBlueNile_HEC-HMS_historical</moduleInstanceId>
				<stateExportDir>%ROOT_DIR%/UpperBlueNile/basinStates</stateExportDir>
				<stateConfigFile>%ROOT_DIR%/UpperBlueNile/State.xml</stateConfigFile>
				<stateLocations type="file">
					<stateLocation>
						<readLocation>UpperBlueNile_hist_state.state</readLocation>
						<writeLocation>UpperBlueNile_hist_state.state</writeLocation>
					</stateLocation>
				</stateLocations>
				<stateSelection>
					<warmState>
						<stateSearchPeriod unit="hour" start="-240" end="-1"/>
					</warmState>
				</stateSelection>
			</exportStateActivity>
			<!-- Export time series -->
			<exportTimeSeriesActivity>
				<description>Export rainfall as input for HecHms model</description>
				<exportFile>FEWS2DSS.xml</exportFile>
				<timeSeriesSets>
					<timeSeriesSet>
						<moduleInstanceId>Catchments_Aggregate_Precipitation_Historical</moduleInstanceId>
						<valueType>scalar</valueType>
						<parameterId>P.merged</parameterId>
						<locationId>UpperBlueNile</locationId>
						<timeSeriesType>external historical</timeSeriesType>
						<timeStep times="21:00"/>
						<relativeViewPeriod unit="day" startOverrulable="true" end="0"/>
						<readWriteMode>read only</readWriteMode>
					</timeSeriesSet>
				</timeSeriesSets>
				<checkMissing>true</checkMissing>
			</exportTimeSeriesActivity>
		</exportActivities>
		<executeActivities>
			<executeActivity>
				<command>
					<className>nl.wldelft.fews.adapter.hec.HmsPreAdapter</className>
					<binDir>%ROOT_DIR%/binAdapter</binDir>
				</command>
				<arguments>
					<argument>%ROOT_DIR%/work/RunInfo.xml</argument>
				</arguments>
				<timeOut>120000</timeOut>
			</executeActivity>
			<executeActivity>
				<command>
					<executable>%WORK_DIR%/HEC-HMS.cmd</executable>
				</command>
				<arguments>
					<argument>-s</argument>
					<argument>%ROOT_DIR%/UpperBlueNile/UpperBlueNile.script </argument>
				</arguments>
				<timeOut>120000</timeOut>
			</executeActivity>
			<executeActivity>
				<command>
					<className>nl.wldelft.fews.adapter.hec.HmsPostAdapter</className>
					<binDir>%ROOT_DIR%/binAdapter</binDir>
				</command>
				<arguments>
					<argument>%ROOT_DIR%/work/RunInfo.xml</argument>
				</arguments>
				<timeOut>120000</timeOut>
			</executeActivity>
		</executeActivities>
		<importActivities>
			<!-- Import state -->
			<importStateActivity>
				<stateConfigFile>%ROOT_DIR%/UpperBlueNile/piOutputState.xml</stateConfigFile>
			</importStateActivity>
			<!-- Import HMS results-->
			<importTimeSeriesActivity>
				<description>Import XML file</description>
				<importFile>simulation.xml</importFile>
				<timeSeriesSets>
					<timeSeriesSet>
						<moduleInstanceId>UpperBlueNile_HEC-HMS_historical</moduleInstanceId>
						<valueType>scalar</valueType>
						<parameterId>Q.simulated.historical</parameterId>
						<locationId>900012</locationId>
						<timeSeriesType>simulated historical</timeSeriesType>
						<timeStep times="21:00"/>
						<readWriteMode>add originals</readWriteMode>
					</timeSeriesSet>
				</timeSeriesSets>
			</importTimeSeriesActivity>
		</importActivities>
	</activities>
</generalAdapterRun>

...