User Tools

Site Tools


start:hype_file_reference:damdata.txt

Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Both sides previous revision Previous revision
Next revision
Previous revision
start:hype_file_reference:damdata.txt [2015/06/18 08:23]
cpers
start:hype_file_reference:damdata.txt [2024/01/25 11:37] (current)
Line 1: Line 1:
 ====== 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 [[start:​hype_file_reference:​geodata.txt|GeoData.txt]] and [[start:​hype_file_reference:​par.txt|par.txt]]. Dams defined in //​DamData.txt//​ can not be included in [[start:​hype_file_reference:​lakedata.txt|LakeData.txt]] (with the exception of a [[start:​hype_file_reference:​lakedata.txt|LakeData.txt]] with only nutrient model parameters). Dam properties include physical characteristics,​ e.g. depth, ​and regulation routine parameters. 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 [[start:​hype_file_reference:​lakedata.txt|LakeData.txt]],​ but not totally.+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 [[start:​hype_file_reference:​geodata.txt|GeoData.txt]] and [[start:​hype_file_reference:​par.txt|par.txt]]. Lake depth from [[start:​hype_file_reference:​geodata.txt|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 [[start:​hype_file_reference:​lakedata.txt|LakeData.txt]] (with the exception of a [[start:​hype_file_reference:​lakedata.txt|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 [[start:​hype_file_reference:​lakedata.txt|LakeData.txt]],​ but not totally.
  
-//​DamData.txt//​ can only be used for standard ​olake (ldtype=as defined for [[start:​hype_file_reference:​lakedata.txt|LakeData.txt]]),​ no lakebasins are allowed.+//​DamData.txt//​ can only be used for standard ​olakes ​(ldtype 1, see ''​ldtype''​ definition in [[start:​hype_file_reference:​lakedata.txt|LakeData.txt]]),​ no lakebasins are allowed.
  
-//​DamData.txt//​ is a tab-separated file located in the [[start:​hype_file_reference:​info.txt&#​model_options|modeldir]] folder. Lakes and lake basins ​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, but must not longer than ten characters. Columns containing character strings, e.g. descriptive meta-data, must not exceed a length of 50 characters. The columns may be in any order. A value must exist for every column and row, i.e. empty cells are not allowed. Maximum 50 columns allowed.+//​DamData.txt//​ is a tab-separated file located in the [[start:​hype_file_reference:​info.txt&#​model_options|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, showing an unregulated single basin lake, and a regulated lake with two lake basins+Example snippet of a //DamData.txt// file structure: ​
  
-FORTSÄTT HÄR!!!!!! +  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 ​    ... 
 +  ...     ​... ​  ​... ​       ...    ...  ...  ...   ​... ​     ...     ​... ​    ​... ​    ...
  
  
-  LAKEDATAID LAKEID LDTYPE LAKE_DEPTH ​ AREA W0REF QPROD1 DATUM1 REGVOL REGAMP RATE EXP ... +The table below describes all //DamData.txt// columns read by HYPE
-           ​1 ​     0      1        3.6  5000  7.67      0      0      0      0   ​40 ​  2 ... +
-           ​0 ​     1      2        7.2 34000 21.94   ​13.5 ​   401    200    0.4  155 0.3 ... +
-           ​2 ​     1      3        6.9  4000     ​0 ​     0      0      0      0    0   0 ... +
-           ​3 ​     1      4          5 30000     ​0 ​     0      0      0      0    0   0 ... +
-         ​... ​   ...    ...        ...   ​... ​  ​... ​   ...    ...    ...    ...  ... ... ...+
  
- 
-The table below describes all //​LakeData.txt//​ columns read by HYPE.  
- 
-/** 
- * ____________IMPORTANT!__________IMPORTANT!________________IMPORTANT!_______________________IMPORTANT!______________ 
- * 
- * The table below is maintained in spreadsheed file '​file_reference_tables.xlsx'​ 
- * in the wiki back-up folder on our server. 
- * Please edit table contents there and then copy-paste the updated full table to this page. Ask René if something is  
- * unclear. Thanks. 
- * ___________________________________________________________________________________________________________________ 
- */ 
  
  
 <​sortable>​ <​sortable>​
-^ Variable ID ^ Unit ^ Type ^ LdType ​^ Description ^ +^ Variable ID     ​^ Unit                              Purpose ​   ​^ Description ​                                                                                                                                                                                                                                                ​
-|''​lakedataid''​|//​-//​|//​general//|//​1/​3/​4//​|lake/​lake basin ID (integer), used to connect ​lakes/lake basins to subbasins in [[start:​hype_file_reference:​geodata.txt|GeoData.txt]] ​(mandatory)| +| ''​subid'' ​      ​| //-//                             ​| //all//    subbasin ​ID (integer), used to connect lake basins to lakes (mandatory) ​                                                                                                                                                                                    ​
-|''​lakeid''​|//​-//​|//​general//|//​2/​3/​4//​|lake ID (integer)used to connect lake basins to multi-basin lakes. Unique integer0 for simple outlet lakes (''​ldtype'' ​1)| +| ''​purpose'' ​    ​| //-//                             ​| //all//    the main purpose of the reservoir1= irrigation2=water supply, 3=flood control, 4=hydropower ​(mandatory) ​                                                                                                                                                ​
-|''​ldtype''​|//​-//​|//​general//​|//​all//​|code for lake data type (//​LdType//​)integer betwen 1 and 4 (mandatory):\\ **1** - simple outlet lake\\ **2** - multi-basin lake, i.e. covering several HYPE sub-basins, generic lake/​outflow properties\\ **3** - upstream lake basin of a multi-basin lake\\ **4** - last/outlet lake basin of a multi-basin lake+| ''​lake_depth'' ​ | //m//                             ​| //​all// ​   | water depth below threshold for outlet lake (mean depth), can also be defined in [[start:​hype_file_reference:​geodata.txt|GeoData.txt]] (must be > 0)                                                                                                        
-|''​lake_depth''​|//​m//​|//physical property//|//​all//​|water depth below threshold for outlet lake (mean depth), can also be defined in [[start:​hype_file_reference:​geodata.txt|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 ​                                                                                                                                                    ​
-|''​area''​|//​m<​sup>​2</​sup>//​|//​physical property//|//all//|lake or lake basin area, used for multi-basin lakes and to check which fraction of the sub-basin is covered by the outlet lake for simple outlet lakes (compared with SLC class fraction in [[start:​hype_file_reference:​geodata.txt|GeoData.txt]]),​ mandatory for ''​ldtype''​ = 2| +| ''​qprod1'' ​     | //​m<​sup>​3</​sup>/​s// ​              ​| //1/2/4//  | parameter for regulated olake, constant production flow down to lowest allowed waterstage for regulation period 1                                                                                                                                           ​
-|''​w0ref''​|//​m//​|//​general//​|//​1/​3/​4//​|reference water level to be added to simulated water level before print out, for lake outflow threshold+| ''​qprod2'' ​     | //​m<​sup>​3</​sup>/​s// ​              ​| //1/2/4//  | parameter for regulated olake, constant production flow down to lowest allowed waterstage for regulation period 2                                                                                                                                           ​
-|''​deltaw0''​|//​m//​|//​regulation//​|//​1/​3/​4//​|difference in lake threshold for regulation with two rating curves (m). Determines the lake threshold for regulation period 2 (w0=''​w0ref''​ + ''​deltaw0''​),​ see ''​qprod1''​ and ''​qprod2''​+| ''​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//​) ​                                                                                                               
-|''​qprod1''​|//​m<​sup>​3</​sup>/​s//​|//​regulation//​|//1/3/​4//​|parameter for regulated olake, constant production flow down to lowest allowed waterstage for regulation period 1| +| ''​datum2'' ​     | //-//                             ​| //1/2/4//  | parameter for regulated olake, start of regulation period 2 (4 character month-day string //​mmdd//​) ​                                                                                                                                                        ​
-|''​qprod2''​|//​m<​sup>​3</​sup>/​s//​|//​regulation//​|//1/3/​4//​|parameter for regulated olake, constant production flow down to lowest allowed waterstage for regulation period 2| +| ''​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'' ​      ​
-|''​datum1''​|//​-//​|//​regulation//​|//1/3/​4//​|parameter for regulated olake, start of regulation period 1 (if not defined only one period is used) (4 character month-day string //​mmdd//​)| +| ''​qpha'' ​       | //-//                             ​| //4//      | parameter for regulated olake, seasonally varying flow below the threshold. Default is ''​qpha''​ = 102.                                                                                                                                                      
-|''​datum2''​|//​-//​|//​regulation//​|//1/3/​4//​|parameter for regulated olake, start of regulation period 2 (4 character month-day string //​mmdd//​)| +| ''​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)  | 
-|''​qamp''​|//​-//​|/​/​regulation//​|//​1/​3/​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''​),​ where the minimum of the sinus wave occurs for day number ''​qpha''​| +| ''​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// ​                                                                                          ​
-|''​qpha''​|//​-//​|/​/​regulation//​|//​1/​3/​4//​|parameter for regulated olake, seasonally varying flow below the threshold. day number for the minimum of the sinus wave. Default is ''​qpha''​ = 102.| +| ''​exp'' ​        ​| //-//                             ​| //all//    | parameter for specific rating curve or for spillway flow of regulated olake above threshold (w0ref), equation//q = rate (w - w0)^exp// ​                                                                                                                     
-|''​rate''​|//​m<​sup>​2</​sup>/​time step//|//regulation//|//1/3/4//​|parameter for specific rating curve of unregulated lakes or for spillway flow of regulated olakes above threshold (''​w0ref''​),​ equation //q = rate (w - w0)^exp//​| +| ''​regvol'' ​     | //​10<​sup>​6</​sup>​ m<​sup>​3</​sup>// ​ | //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) ​                                                         ​
-|''​exp''​|//​-//​|//​regulation//​|//​1/​3/​4//​|parameter for specific rating curve or for spillway flow of regulated olake above threshold (w0ref), equation//q = rate (w - w0)^exp//​| +| ''​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.                                                 
-|''​regvol''​|//​10<​sup>​6</​sup>​ m<​sup>​3</​sup>//​|//​regulation//​|//​1/​3/​4//​|regulation volume for general regulation routine. Determines lowest water stage for production flow. (must be less than lake depth * lake area)| +| ''​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 ​                                                | 
-|''​prodpp''​|//​m/d//|//nutrient cycling//|//​1/​2//​|parameter ​for internal load of Part-P+| ''​removedam'' ​  | //-//                             | //​all// ​   ​date (yyyy-mm-ddwhen 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 ​                                                
-|''​prodsp''​|//​m/d//|//nutrient cycling//|//1/2//|parameter for internal load of SRP (m/d)| +| ''​qinfjan'' ​    ​| //m<​sup>​3<​/sup>/s//               ​| //all//    | mean January inflow to reservoir (can be taken from a model run without reservoirs for example) ​                                                                                                                                                            
-|''​Qmean''​|//​mm/y//​|//​physical property//|//1/2//|initial value for calculation of mean flow, can also be defined in [[start:​hype_file_reference:​par.txt|par.txt]]+| ''​qinffeb'' ​    ​| //m<​sup>​3<​/sup>/s//               ​| //all//    | mean Fabruary inflow to reservoir (can be taken from a model run without reservoirs for example) ​                                                                                                                                                           ​
-|''​tpmean''​|//​mg/l//​|//​nutrient cycling//|//1/2//​|mean ​concentration of total P, used for production if P is not simulated. Also used as initial value of particulate P concentration in lakes. Can also be defined in [[start:​hype_file_reference:​par.txt|par.txt]]+| ''​qinfmar'' ​    ​| //m<​sup>​3<​/sup>/s//               ​| //all//    | mean March inflow to reservoir ​(can be taken from a model run without reservoirs for example                                                                                                                                                              ​
-|''​tnmean''​|//​mg/l//​|//​nutrient cycling//|//1/2//​|mean ​concentration of total N (mg/l), used as initial value N concentration in lakes. Can also be defined in [[start:​hype_file_reference:​par.txt|par.txt]]+| ''​qinfapr'' ​    ​| //m<​sup>​3<​/sup>/s//               ​| //all//    | mean April inflow to reservoir ​(can be taken from a model run without reservoirs for example                                                                                                                                                              ​
-|''​tocmean''​|//​mg/l//​|//​nutrient cycling//|//1/2//​|mean ​concentration of TOC (mg/l), used as initial value of TOC concentration in lakes. Can also be defined in [[start:​hype_file_reference:​par.txt|par.txt]]+| ''​qinfmay'' ​    ​| //m<​sup>​3<​/sup>/s//               ​| //all//    mean May inflow to reservoir (can be taken from a model run without reservoirs for example                                                                                                                                                                ​
-|''​limqprod''​|//​-//|//​regulation//|//1/2//|parameter for water level below which there is reduced production flow from a dam (fraction of regulating volume), the flow reduction is linear to wmin. Can also be defined in [[start:​hype_file_reference:​par.txt|par.txt]]+| ''​qinfjun'' ​    ​| //m<​sup>​3<​/sup>/s//               ​| //all//    mean June inflow to reservoir (can be taken from a model run without reservoirs ​for example) ​                                                                                                                                                               ​
-|''​sedon''​|//​m/​d//​|//​nutrient cycling//|//1/2//|sedimentation rate for ON in lakes. Can also be defined in [[start:​hype_file_reference:​par.txt|par.txt]]+| ''​qinfjul'' ​    ​| //m<​sup>​3<​/sup>/s//               ​| //all//    mean July inflow to reservoir (can be taken from a model run without reservoirs ​for example) ​                                                                                                                                                               ​
-|''​sedpp''​|//​m/​d//​|//​nutrient cycling//|//1/2//|sedimentation rate for PP in lakes. Can also be defined in [[start:​hype_file_reference:​par.txt|par.txt]]+| ''​qinfaug'' ​    ​| //m<​sup>​3<​/sup>/s//               ​| //all//    mean August inflow to reservoir (can be taken from a model run without reservoirs ​for example) ​                                                                                                                                                             ​
-|''​sedoc''​|//​m/​d//​|//​nutrient cycling//|//1/2//|sedimentation rate for OC in lakes. Can also be defined in [[start:​hype_file_reference:​par.txt|par.txt]]+| ''​qinfsep'' ​    ​| //​m<​sup>​3</​sup>/​s//               ​| //all//    mean September inflow to reservoir (can be taken from a model run without reservoirs ​for example) ​                                                                                                                                                          
-|''​wprodn''​|//​kg/(m<​sup>​3</​sup> ​d)//​|//​nutrient cycling//|//1/2//|production/​degradation in water for N. Can also be defined in [[start:​hype_file_reference:​par.txt|par.txt]]+| ''​qinfoct'' ​    ​| //​m<​sup>​3</​sup>/​s//               ​| //all//    mean October inflow to reservoir (can be taken from a model run without reservoirs ​for example) ​                                                                                                                                                            
-|''​wprodp''​|//​kg/(m<​sup>​3</​sup> ​d)//​|//​nutrient cycling//|//1/2//|production/​degradation in water for P. Can also be defined in [[start:​hype_file_reference:​par.txt|par.txt]]+| ''​qinfnov'' ​    ​| //​m<​sup>​3</​sup>/​s//               ​| //all//    mean November inflow to reservoir (can be taken from a model run without reservoirs ​for example) ​                                                                                                                                                           ​
-|''​wprodc''​|//​kg/(m<​sup>​3</​sup> ​d)//​|//​nutrient cycling//|//1/2//|production/​degradation in water for C. Can also be defined in par.txt.+| ''​qinfdec'' ​    ​| //​m<​sup>​3</​sup>​/s//               ​| //all//    | mean December inflow to reservoir (can be taken from a model run without reservoirs for example) ​                                                                                                                                                           | 
-|''​denitwl''​|//​kg/(m<​sup>​2</​sup> ​d)//|//nutrient cycling//|//1/2//|parameter for denitrification in lakes. Can also be defined in [[start:​hype_file_reference:​par.txt|par.txt]]+| ''​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 ​                                                                                                                                                                                                                                            | 
-|''​deeplake''​|//​-//​|//​physical property//|//1/2//|fraction of the lake'​s ​initial volume ​which is considered as slow (SLP), between 0 and 10 means that the lake is not divided into a slow and a fast partCan also be defined in [[start:​hype_file_reference:​par.txt|par.txt]]+| ''​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                                                                                                                                                                                                                                             
-|''​fastlake''​|//​-//|//physical property//|//1/2//|fraction of lake outflow that comes from the fast lake part (FLP), between 0 and 1. Can also be defined in [[start:​hype_file_reference:​par.txt|par.txt]]|+| ''​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 restoredFor sm_mode=1 and 2.                                                                                                                                                                                                                                             | 
 +| ''​sm_yfreq'' ​      | //​years// ​                      | //​all// ​  | number of years between flushingFor sm_mode=2 only.                                                                                                                                                                                                                                             |
 </​sortable>​ </​sortable>​
  
start/hype_file_reference/damdata.txt.1434608582.txt.gz · Last modified: 2023/11/16 14:28 (external edit)