Versions Compared

Key

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

scrollbar

Table of Contents

...

Hydrotel

XBeach is a two-dimensional model for wave propagation, long waves and mean flow, sediment transport and morphological changes of the nearshore area, beaches, dunes and backbarrier during storms.

...

Hydrotel is hydrological and environmental telemetry monitoring and database system. https://www.hyquestsolutions.com/products-services/products-software/hydrotel-telemetry-system/

Summary

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

The pre-adapter creates the model specific output by replacing tags in template files: converts netcdf file exported by FEWS:

  • netcdf run file (given to the preadpter as input)
  • meteo.nc (required)
  • corrections.nc (required)
  • hydro.nc (optional)
  • zs0file.txt for water level input file zs0file.txt
  • bcfile.txt and bc.timeXXX.sp2 for SWAN spectrum input files
  • params.txt for run information

Furthermore, the pre-adapter writes log messages to a log file called xbeachhydrotel_preadapter.log.

There is no The post-adapter , since XBeach can be configured to use netcdf as output format that is readable by FEWS.

...

converts all *.csv files to one netcdf file "resultats.nc" which names are present in the "sortiesHydrotel" ; separated string property value.The values are weighted by columns specified in "info/uhrh_amont.txt".

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

Pre-adapter
Anchor
preadapter
preadapter

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

Class name: nl.deltares.xbeachhydrotel.XBeachPreAdapterHydrotelPreAdapter

Properties

No specific properties need to be configured for a model run.

The Hydrotel PreAdapter will look for property "sortiesHydrotel" in netcdf run file and expects a ; separated string with all the the output parameters that are desired for Hydrotel.

It will write the output parameter to output.csv with a ; and a 1 behind them.

<see example>

 There is however extra functionality provided via the properties but this is not needed if the model is setup correctly.
Configured properties starting with "PARAM_" will be added or replaced literally without "PARAM_" (and in lower case) in the params.txt file which defines the parameters for an XBeach model run. 
This functionality should only be used as a debug option and only by someone that understands the XBeach properties in params.txt. To setup a model make sure you use a correctly configured params.txt so this functionality is not needed.

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.
  • This program The preadapter writes log messages to a log file called xbeach.log.This program does not make use of a template file, parameters are automatically added and replaced in params.txt without the use of tagshydrotel_preadapter.log.
  • This program uses the information in the specified netcdf run file as input and uses this information to do the following actions:
    1. Create the water level input file: zs0file.txt, see water level conversion
    2. Create the SWAN spectrum input files bcfile.txt and bc.timeXXX.sp2, see wave spectrum conversion
    3. Replace or add the parameters 'tstart' and 'tstop' in params.txt, see parameter conversion

...