Navigation
HYPE Documentation
Quick links to often-used pages:
HYPE links
HYPE OSC (model code)
HYPE Open data access
SMHI Hydrology Research Dep., main developer and maintainer of the HYPE model
Sidebar
start:hype_file_reference:damdata.txt
DamData.txt
This file contains dam properties for outlet lakes that operate as reservoirs (i.e. dams) and which do not use general parameters (so the term olake below refers to those olakes that are reservoirs/dams). Properties defined here override the properties and generic parameters given in GeoData.txt and par.txt. Lake depth from GeoData.txt may also be kept by using -9999 for the value in DamData.txt. Dams defined in DamData.txt can not be included in LakeData.txt (with the exception of a LakeData.txt with only nutrient model parameters). Dam properties include physical characteristics, e.g. depth, regulation routine parameters, and sediment management. In DamData.txt, four different dam types with different purposes may be used. These are irrigation dam, water supply dam, flood control dam and hydropower dam. Each typ has its own rules for regulation. Hydropower dams are regulated similar to the routines in LakeData.txt, but not totally.
DamData.txt can only be used for standard olakes (ldtype 1, see ldtype definition in LakeData.txt), no lakebasins are allowed.
DamData.txt is a tab-separated file located in the modeldir folder. Lakes are listed row-wise. The first row contains a column header with variable names. Variable names are not case-sensitive (max. 10 characters, no spaces). Columns with headings unknown to HYPE are skipped while reading the file. Columns containing character strings, e.g. descriptive meta-data, must not exceed a length of 100 characters. The columns may be in any order. A value must exist for every column and row, i.e. empty cells are not allowed, with the exception of column lake_depth, see first paragraph. Maximum 50 columns allowed.
Example snippet of a DamData.txt file structure:
PURPOSE SUBID LAKE_DEPTH REGVOL RATE EXP W0REF SNOWFRAC QINFJAN QINFFEB QINFMAR ... 4 25 16.7 189 100 1.5 104 0.27 18.8 16.3 16.5 ... 4 34 55.7 85 75 1.5 0 0.61 5.3 5.1 4.1 ... ... ... ... ... ... ... ... ... ... ... ... ...
The table below describes all DamData.txt columns read by HYPE.
| Variable ID | Unit | Purpose | Description |
|---|---|---|---|
subid | - | all | subbasin ID (integer), used to connect lake basins to lakes (mandatory) |
purpose | - | all | the main purpose of the reservoir, 1= irrigation, 2=water supply, 3=flood control, 4=hydropower (mandatory) |
lake_depth | m | all | water depth below threshold for outlet lake (mean depth), can also be defined in GeoData.txt (must be > 0) |
w0ref | m | all | reference water level to be added to simulated water level before print out, for lake outflow threshold |
qprod1 | m3/s | 1/2/4 | parameter for regulated olake, constant production flow down to lowest allowed waterstage for regulation period 1 |
qprod2 | m3/s | 1/2/4 | parameter for regulated olake, constant production flow down to lowest allowed waterstage for regulation period 2 |
datum1 | - | 1/2/4 | parameter for regulated olake, start of regulation period 1 (if not defined only one period is used) (4 character month-day string mmdd) |
datum2 | - | 1/2/4 | parameter for regulated olake, start of regulation period 2 (4 character month-day string mmdd) |
qamp | - | 4 | parameter for regulated olake, seasonally varying flow in regulated volume. Variation defined in form of a sinus wave with this amplitude (as fraction of current qprod: 0-1), where the minimum of the sinus wave occurs for day number qpha |
qpha | - | 4 | parameter for regulated olake, seasonally varying flow below the threshold. Default is qpha = 102. |
snowfrac | - | 4 | fraction of the precipitation in the dam’s catchment that falls as snow (can be taken from a model run with this as output), used to give default seasonal varying production flow for high latitude dams (for snowfrac>0.35: qamp=0.71, qpha must be set) |
rate | - | all | parameter for specific rating curve of unregulated lakes or for spillway flow of regulated olakes above threshold (w0ref), equation q = rate (w - w0)^exp |
exp | - | all | parameter for specific rating curve or for spillway flow of regulated olake above threshold (w0ref), equationq = rate (w - w0)^exp |
regvol | 106 m3 | all | regulation volume for general regulation routine. Determines lowest water stage for production flow. (must be less than lake depth * lake area) (suggest 85% of dam volume if data can’t be found) |
wamp | m | all | regulation amplitude. Usually larger than water depth given by regvol. Used for scaling computed water stage variation (below threshold) similar to variation of observations. Set to -9999 for not to use. |
builddam | - | all | date (yyyy-mm-dd) when the dam with regvol was built, before this date only the rating curve will be used for calculating outflow and at this date the lake threshold will be increased |
removedam | - | all | date (yyyy-mm-dd) when the dam with regvol will be removed, after this date the lake threshold will be lowered and only the rating curve will be used for calculating outflow |
qinfjan | m3/s | all | mean January inflow to reservoir (can be taken from a model run without reservoirs for example) |
qinffeb | m3/s | all | mean Fabruary inflow to reservoir (can be taken from a model run without reservoirs for example) |
qinfmar | m3/s | all | mean March inflow to reservoir (can be taken from a model run without reservoirs for example) |
qinfapr | m3/s | all | mean April inflow to reservoir (can be taken from a model run without reservoirs for example) |
qinfmay | m3/s | all | mean May inflow to reservoir (can be taken from a model run without reservoirs for example) |
qinfjun | m3/s | all | mean June inflow to reservoir (can be taken from a model run without reservoirs for example) |
qinfjul | m3/s | all | mean July inflow to reservoir (can be taken from a model run without reservoirs for example) |
qinfaug | m3/s | all | mean August inflow to reservoir (can be taken from a model run without reservoirs for example) |
qinfsep | m3/s | all | mean September inflow to reservoir (can be taken from a model run without reservoirs for example) |
qinfoct | m3/s | all | mean October inflow to reservoir (can be taken from a model run without reservoirs for example) |
qinfnov | m3/s | all | mean November inflow to reservoir (can be taken from a model run without reservoirs for example) |
qinfdec | m3/s | all | mean December inflow to reservoir (can be taken from a model run without reservoirs for example) |
sm_resop | 0-4 | all | reservoir operation mode, used for sediment density; 1=sediment always submerged or nearly submerged, 2=normally moderate to considerable reservoir drawdown, 3=reservoir normally empty, 4=riverbed sediments |
sm_mode | 0-2 | all | reservoir sediment management methods, decision; 0=no flush, 1=flushing based on reservoir fill up, 2=flushing based on day of year |
sm_dest | 0-1 | all | reservoir sediment management methods, fate; 0=flushed material removed, 1=flushed material added to flow going downstream |
sm_start | -/days | all | threshold to start sediment flushing. For sm_mode=1 fraction of initial storage volume. For sm_mode=2 day of year. |
sm_duradays | days | all | parameter to regulate the rate of flushing, number of days over which to flush. For sm_mode=1 and 2. |
sm_caprest | - | all | parameter to regulate the rate of flushing, the fraction of the reservoir storage capacity that will be restored. For sm_mode=1 and 2. |
sm_yfreq | years | all | number of years between flushing. For sm_mode=2 only. |
start/hype_file_reference/damdata.txt.txt · Last modified: 2023/11/16 14:28 (external edit)
Except where otherwise noted, content on this wiki is licensed under the following license: CC Attribution-Share Alike 4.0 International
