Page History

Summary

This page describes the Hydrotel module adapter, its functions, and provides an example for configuring a Hydrotel run in FEWS.

The pre-adapter converts netcdf file exported by FEWS:

...

It also copies the state files with a timestamp in the filename after start time to the output states directoy

This adapter is specifically created and tested for a time step of 3 hours, some extra changes will be necessary to make it compatible with other time steps.

Pre-adapter

Anchor
preadapter preadapter

Model pre-adapter for running a Hydrotel model from Delft-FEWS.

...

For the source code see HydrotelPreAdapter 

The pre-adapter converts netcdf file exported by FEWS:

...

'DATE DEBUT' - start date
'DATE FIN' - end date + 3 h
'ECRITURE ETAT FONTE NEIGE' - start date + 1 day
'ECRITURE ETAT BILAN VERTICAL' - start date + 1 day
'ECRITURE ETAT RUISSELEMENT SURFACE' - start date + 1 day
'ECRITURE ETAT ACHEMINEMENT RIVIERE' - start date + 1 day

But if property "sauvegardeEtatFinSimulation" is set to true in netcdf run file, it will write the end date instead of start date + 1 day

For an example see: Simulation.csv

Notes for users

• For all files that are written by this adapter, if the file to be written already exists, then it will be overwritten.
• The preadapter writes log messages to a log file called hydrotel_preadapter.log.
• This program uses the information in the specified netcdf run file as input and uses this information to do the following actions:

System requirements

• This program needs Java version 1.8 or higher.
• This program needs the following Java libraries:

• • castor-0.9.5.jar
  • commons-httpclient-3.0.1.jar
  • Delft_NetCDF_Util.jar
  • Delft_TestSupport.jar
  • Delft_Util.jar
  • joda-time-2.8.1.jar
  • junit-4.8.2.jar
  • log4j-1.2.14.jar
  • netcdf-4.6.3.jar
  • slf4j-api-1.5.6.jar
  • slf4j-log4j12-1.5.6.jar
  • xercesImpl.jar

Hydrotel post-adapter

Anchor
postadapter postadapter

Class name: nl.deltares.hydrotel.HydrotelPostAdapter

The post-adapter converts all *.csv files to one netcdf file "resultats.nc" which names are present in the "sortiesHydrotel" ; separated string property value.The

By default the values are weighted by columns specified in "info/uhrh_amont.txt" and all combined to 1 value per time step and parameter.

But if the property "importerValeursExutoireSeulement" is present in the run_info file and has values "false" all values from the csv file are written to the "resultats.nc" as unique locations and not being weighted. For example see "resultats_unique_locations.nc".

When the integer property "resultsOffset" is present it add the value in minutes to the output times.

...

For the source code see HydrotelPostAdapter 

Example configuration generalAdapterRun

A complete example model run configuration file can be found here: Hydrotel general adapter config example