User Tools

Site Tools


start:hype_file_reference:lakedata.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:lakedata.txt [2020/10/12 17:55]
cpers
start:hype_file_reference:lakedata.txt [2021/09/16 09:21] (current)
cpers
Line 3: Line 3:
 This file contains lake properties for **outlet lakes** with specific data available. 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]]. If you want to use a generic parameter from [[start:​hype_file_reference:​par.txt|par.txt]] for a particular lake in //​LakeData.txt//,​ use -9999 as parameter value for that lake in //​LakeData.txt//​. Lake depth from [[start:​hype_file_reference:​geodata.txt|GeoData.txt]] may also be kept by using -9999 for the value in //​LakeData.txt//​. Lake properties include physical characteristics,​ e.g. depth, and outlet rating curve, regulation routine parameters, and parameters concerning nutrient cycling within the lake. In //​LakeData.txt//,​ two regulation regimes can be defined; constant flow and seasonally varying sinus-wave shaped flow. For more regulation options, use [[start:​hype_file_reference:​damdata.txt|DamData.txt]],​ which extends the regulation options provided here. This file contains lake properties for **outlet lakes** with specific data available. 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]]. If you want to use a generic parameter from [[start:​hype_file_reference:​par.txt|par.txt]] for a particular lake in //​LakeData.txt//,​ use -9999 as parameter value for that lake in //​LakeData.txt//​. Lake depth from [[start:​hype_file_reference:​geodata.txt|GeoData.txt]] may also be kept by using -9999 for the value in //​LakeData.txt//​. Lake properties include physical characteristics,​ e.g. depth, and outlet rating curve, regulation routine parameters, and parameters concerning nutrient cycling within the lake. In //​LakeData.txt//,​ two regulation regimes can be defined; constant flow and seasonally varying sinus-wave shaped flow. For more regulation options, use [[start:​hype_file_reference:​damdata.txt|DamData.txt]],​ which extends the regulation options provided here.
  
-Outlet lakes in HYPE can cover a fraction of a subbasin or the whole subbasin. Large lake systems can be split into several subbasins themselves. Each such subbasin'​s olake is then a lake basins of the multi-basin lake. This allows for different properties in different lake basins (e.g. depth). Flow between lakebasins of such a multi-basin lake is not defined in LakeData (outflow parameters should be zero). Outflow parameters for a multi-basin lake are defined only for lake basin which has an outlet to the outside of the multi-basin lake. The main outlet leaves by the last lakebasin, while additional outlets leaves through branches of upstream lakebasins. Maximum five outflows of a multi-basin lake is allowed. Lakes that are not multi-basin lakes may have two outlets defined in LakeData.txt (see [[start:​hype_model_description:​hype_routing#​outlet_lake_with_two_outlets|model description]]). These outlets are defined by ''​ldtype''​ 5 and 6 for the main outlet and the branch outlet. For lakes with several outputs defined in //​LakeData.txt//​ only the downstream subid of the branch need to be given in [[start:​hype_file_reference:​branchdata.txt|BranchData.txt]].+Outlet lakes in HYPE can cover a fraction of a subbasin or the whole subbasin. Large lake systems can be split into several subbasins themselves. Each such subbasin'​s olake is then a lake basins of the **multi-basin lake**. This allows for different properties in different lake basins (e.g. depth). Flow between lakebasins of such a multi-basin lake is not defined in LakeData (outflow parameters should be zero). Outflow parameters for a multi-basin lake are defined only for lake basin which has an outlet to the outside of the multi-basin lake. The main outlet leaves by the last lakebasin, while additional outlets leaves through branches of upstream lakebasins. Maximum five outflows of a multi-basin lake is allowed. ​
  
 +Lakes that are not multi-basin lakes may have **two outlets** defined in LakeData.txt (see [[start:​hype_model_description:​hype_routing#​outlet_lake_with_two_outlets|model description]]). These outlets are defined by ''​ldtype''​ 5 and 6 for the main outlet and the branch outlet. For lakes with two outlets defined in //​LakeData.txt//​ only the downstream subid of the branch need to be given in [[start:​hype_file_reference:​branchdata.txt|BranchData.txt]].
  
-//​LakeData.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 the column heading must not be longer than ten characters. Columns containing character strings, e.g. descriptive data, must not exceed a length of 100 characters. The columns may be in any order. A value must exist for all columns which cannot be alternatively defined in [[start:​hype_file_reference:​par.txt|par.txt]],​ see column description in table below. ​+ 
 +//​LakeData.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 the column heading must not be longer than ten characters. Columns containing character strings, e.g. descriptive data, must not exceed a length of 100 characters. The columns may be in any order. A value must exist for all columns which cannot be alternatively defined in [[start:​hype_file_reference:​par.txt|par.txt]],​ see column description in table below. A row with data is skipped if ldtype is zero and the lakedataid is not found in GeoData (e.g. is zero). This can be used to temporary not use the specific lake properties on a row.
  
 Example snippet of a //​LakeData.txt//​ file structure, showing an unregulated single basin lake, and a regulated lake with two lake basins: ​ Example snippet of a //​LakeData.txt//​ file structure, showing an unregulated single basin lake, and a regulated lake with two lake basins: ​
Line 23: Line 25:
 ^ Variable ID     ^ Unit                              ^ Type                    ^ LdType ​        ^ Description ​                                                                                                                                                                                                                                                                                                                                                                          ^ ^ Variable ID     ^ Unit                              ^ Type                    ^ LdType ​        ^ Description ​                                                                                                                                                                                                                                                                                                                                                                          ^
 | ''​lakedataid'' ​ | //-//                             | //​general// ​            | //​1/​5/​7// ​   | lake/lake basin ID (integer), used to connect lakes/lake basins to subbasins in [[start:​hype_file_reference:​geodata.txt|GeoData.txt]] (mandatory). Only main outlet of lake with two outlets have lakedataid. The second outlet should have lakedataid=0. Otherwise the lakedataid must be a unique positive integer. ​                                                                | | ''​lakedataid'' ​ | //-//                             | //​general// ​            | //​1/​5/​7// ​   | lake/lake basin ID (integer), used to connect lakes/lake basins to subbasins in [[start:​hype_file_reference:​geodata.txt|GeoData.txt]] (mandatory). Only main outlet of lake with two outlets have lakedataid. The second outlet should have lakedataid=0. Otherwise the lakedataid must be a unique positive integer. ​                                                                |
-| ''​lakeid'' ​     | //-//                             | //​general// ​            | //​5/​6/​7// ​ | lake ID (integer), used to connect lake basins to multi-basin ​lakes and and outlets ​to same lake with two outlets. ​Unique ​positive integer, ​for simple outlet lakes (''​ldtype''​ = 1)                                                                                                                                                                                                |+| ''​lakeid'' ​     | //-//                             | //​general// ​            | //​5/​6/​7// ​ | lake ID (integer), used to connect lake basins to its multi-basin ​lake and outlets ​of a lake with two outlets ​to that lakeUse unique ​positive integer ​for these lakesbut for simple outlet lakes (''​ldtype''​ = 1) an arbitrary number can be used, e.g. 0.                                                                                                                                                                                                |
 | ''​ldtype'' ​     | //-//                             | //​general// ​            | //​all// ​       | code for lake data type, integer (mandatory):​\\ **1** - simple outlet lake\\ **2**, **3**, **4** - not used anymore\\ **5** - lake with two outlets, main outlet\\ **6** - lake with two outlets, second outlet\\ **7** - lake basin of multibasin lake that will have a equal water level  | | ''​ldtype'' ​     | //-//                             | //​general// ​            | //​all// ​       | code for lake data type, integer (mandatory):​\\ **1** - simple outlet lake\\ **2**, **3**, **4** - not used anymore\\ **5** - lake with two outlets, main outlet\\ **6** - lake with two outlets, second outlet\\ **7** - lake basin of multibasin lake that will have a equal water level  |
 | ''​lake_depth'' ​ | //m//                             | //physical property// ​  | //​1/​5/​7// ​   | 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). Not used for second outlet of lake with two outlets. ​                                                                                                                                                                                | | ''​lake_depth'' ​ | //m//                             | //physical property// ​  | //​1/​5/​7// ​   | 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). Not used for second outlet of lake with two outlets. ​                                                                                                                                                                                |
-| ''​area'' ​       | //​m<​sup>​2</​sup>// ​                | //physical property// ​  | //​1/​5/​7// ​       | lake or lake basin area, used for multi-basin lakes and to check the fraction of the subbasin covered by the outlet lake for simple outlet lakes (compared with SLC class fraction in [[start:​hype_file_reference:​geodata.txt|GeoData.txt]]) ​                 |+| ''​area'' ​       | //​m<​sup>​2</​sup>// ​                | //physical property// ​  | //​1/​5/​7// ​       | lake or lake basin area, optional, used for check the fraction of the subbasin covered by the outlet lake for simple outlet lakes (compared with SLC class fraction in [[start:​hype_file_reference:​geodata.txt|GeoData.txt]]) ​                 |
 | ''​w0ref'' ​      | //m//                             | //​general// ​            | //​1/​5/​6/​7// ​   | reference water level to be added to simulated water level before print out, for lake outflow threshold. This column has a different meaning for ldtype=6, where it is used as the relative difference to the threshold (w0ref) of outlet 1. Only for the last lakebasin of multi-basin lake, the other use the same reference. ​                                                                                                                                         | | ''​w0ref'' ​      | //m//                             | //​general// ​            | //​1/​5/​6/​7// ​   | reference water level to be added to simulated water level before print out, for lake outflow threshold. This column has a different meaning for ldtype=6, where it is used as the relative difference to the threshold (w0ref) of outlet 1. Only for the last lakebasin of multi-basin lake, the other use the same reference. ​                                                                                                                                         |
 | ''​rate'' ​       | //-//                             | //​general/​regulation// ​ | //​1/​5/​6/​7// ​   | parameter for specific rating curve of unregulated lakes or for spillway flow of regulated lakes above threshold (''​w0ref''​),​ equation //q = rate (w - w0)<​sup>​exp</​sup>//​. ​                                                                                                                                                                                                          | | ''​rate'' ​       | //-//                             | //​general/​regulation// ​ | //​1/​5/​6/​7// ​   | parameter for specific rating curve of unregulated lakes or for spillway flow of regulated lakes above threshold (''​w0ref''​),​ equation //q = rate (w - w0)<​sup>​exp</​sup>//​. ​                                                                                                                                                                                                          |
Line 43: Line 45:
 | ''​obsflow'' ​    | //-//                             | //​regulation// ​         | //6//          | flag for using wanted water transfer flow for second outlet, 0=no (default), 1=yes. Only used for lakes with 2 outlets. ​                                                                                                                                                                                                                                                              | | ''​obsflow'' ​    | //-//                             | //​regulation// ​         | //6//          | flag for using wanted water transfer flow for second outlet, 0=no (default), 1=yes. Only used for lakes with 2 outlets. ​                                                                                                                                                                                                                                                              |
 | ''​limqprod'' ​   | //-//                             | //​regulation// ​         | //​1/​5/​7// ​   | water level below which there is reduced production flow from a dam (fraction of regulating volume), the flow reduction is linear to //wmin// (lowest water stage for production flow). Can also be defined in [[start:​hype_file_reference:​par.txt|par.txt]] ​                                                                                                                         | | ''​limqprod'' ​   | //-//                             | //​regulation// ​         | //​1/​5/​7// ​   | water level below which there is reduced production flow from a dam (fraction of regulating volume), the flow reduction is linear to //wmin// (lowest water stage for production flow). Can also be defined in [[start:​hype_file_reference:​par.txt|par.txt]] ​                                                                                                                         |
 +| ''​w0adjdays'' ​   | //​days// ​                         | //​regulation// ​         | //​1/​5/​6/​7// ​   | number of days over which a change in seasonal threshold for number of days over which a change in seasonal threshold for regulation with two rating curves (''​deltaw0''​) is to take place. Can also be defined in [[start:​hype_file_reference:​par.txt|par.txt]] ​                                                                                                                         |
 | ''​prodpp'' ​     | //​m/​d// ​                          | //nutrient cycling// ​   | //​1/​5/​7// ​   | parameter for internal load of Part-P ​                                                                                                                                                                                                                                                                                                                                                | | ''​prodpp'' ​     | //​m/​d// ​                          | //nutrient cycling// ​   | //​1/​5/​7// ​   | parameter for internal load of Part-P ​                                                                                                                                                                                                                                                                                                                                                |
 | ''​prodsp'' ​     | //​m/​d// ​                          | //nutrient cycling// ​   | //​1/​5/​7// ​   | parameter for internal load of SRP                                                                                                                                                                                                                                                                                                                                              | | ''​prodsp'' ​     | //​m/​d// ​                          | //nutrient cycling// ​   | //​1/​5/​7// ​   | parameter for internal load of SRP                                                                                                                                                                                                                                                                                                                                              |
Line 52: Line 55:
 | ''​sedpp'' ​      | //​m/​d// ​                          | //nutrient cycling// ​   | //​1/​5/​7// ​   | sedimentation rate for PP in lakes. Can also be defined in [[start:​hype_file_reference:​par.txt|par.txt]] ​                                                                                                                                                                                                                                                                             | | ''​sedpp'' ​      | //​m/​d// ​                          | //nutrient cycling// ​   | //​1/​5/​7// ​   | sedimentation rate for PP in lakes. Can also be defined in [[start:​hype_file_reference:​par.txt|par.txt]] ​                                                                                                                                                                                                                                                                             |
 | ''​sedoc'' ​      | //​m/​d// ​                          | //nutrient cycling// ​   | //​1/​5/​7// ​   | sedimentation rate for OC in lakes. Can also be defined in [[start:​hype_file_reference:​par.txt|par.txt]] ​                                                                                                                                                                                                                                                                             | | ''​sedoc'' ​      | //​m/​d// ​                          | //nutrient cycling// ​   | //​1/​5/​7// ​   | sedimentation rate for OC in lakes. Can also be defined in [[start:​hype_file_reference:​par.txt|par.txt]] ​                                                                                                                                                                                                                                                                             |
 +| ''​sedss'' ​      | //​m/​ts// ​                          | //nutrient cycling// ​   | //​1/​5/​7// ​   | sedimentation rate for SS in lakes. Can also be defined in [[start:​hype_file_reference:​par.txt|par.txt]] ​                                                                                                                                                                                                                                                                             |
 +| ''​sedsi'' ​      | //​m/​ts// ​                          | //nutrient cycling// ​   | //​1/​5/​7// ​   | sedimentation rate for algae silica (AS) in lakes. Can also be defined in [[start:​hype_file_reference:​par.txt|par.txt]] ​                                                                                                                                                                                                                                                                             |
 | ''​wprodn'' ​     | //​kg/​(m<​sup>​3</​sup>​ d)//          | //nutrient cycling// ​   | //​1/​5/​7// ​   | production/​degradation in water for N. Can also be defined in [[start:​hype_file_reference:​par.txt|par.txt]] ​                                                                                                                                                                                                                                                                          | | ''​wprodn'' ​     | //​kg/​(m<​sup>​3</​sup>​ d)//          | //nutrient cycling// ​   | //​1/​5/​7// ​   | production/​degradation in water for N. Can also be defined in [[start:​hype_file_reference:​par.txt|par.txt]] ​                                                                                                                                                                                                                                                                          |
 | ''​wprodp'' ​     | //​kg/​(m<​sup>​3</​sup>​ d)//          | //nutrient cycling// ​   | //​1/​5/​7// ​   | production/​degradation in water for P. Can also be defined in [[start:​hype_file_reference:​par.txt|par.txt]] ​                                                                                                                                                                                                                                                                          | | ''​wprodp'' ​     | //​kg/​(m<​sup>​3</​sup>​ d)//          | //nutrient cycling// ​   | //​1/​5/​7// ​   | production/​degradation in water for P. Can also be defined in [[start:​hype_file_reference:​par.txt|par.txt]] ​                                                                                                                                                                                                                                                                          |
 | ''​wprodc'' ​     | //​kg/​(m<​sup>​3</​sup>​ d)//          | //nutrient cycling// ​   | //​1/​5/​7// ​   | production/​degradation in water for OC. Can also be defined in par.txt. ​                                                                                                                                                                                                                                                                                                              | | ''​wprodc'' ​     | //​kg/​(m<​sup>​3</​sup>​ d)//          | //nutrient cycling// ​   | //​1/​5/​7// ​   | production/​degradation in water for OC. Can also be defined in par.txt. ​                                                                                                                                                                                                                                                                                                              |
 +| ''​wprodsi'' ​     | //​kg/​(m<​sup>​3</​sup>​ d)//          | //nutrient cycling// ​   | //​1/​5/​7// ​   | production/​degradation of algae silica in water. Can also be defined in par.txt. ​                                                                                                                                                                                                                                                                                                              |
 | ''​denitwl'' ​    | //​kg/​(m<​sup>​2</​sup>​ d)//          | //nutrient cycling// ​   | //​1/​5/​7// ​   | parameter for denitrification in lakes. Can also be defined in [[start:​hype_file_reference:​par.txt|par.txt]] ​                                                                                                                                                                                                                                                                         | | ''​denitwl'' ​    | //​kg/​(m<​sup>​2</​sup>​ d)//          | //nutrient cycling// ​   | //​1/​5/​7// ​   | parameter for denitrification in lakes. Can also be defined in [[start:​hype_file_reference:​par.txt|par.txt]] ​                                                                                                                                                                                                                                                                         |
 +| ''​muptn'' ​     | //​kg/​(m<​sup>​2</​sup>​ d)//          | //nutrient cycling// ​   | //​1/​5/​7// ​   | macrophyte uptake of IN in lake water. Can also be defined in [[start:​hype_file_reference:​par.txt|par.txt]] ​                                                                                                                                                                                                                                                                          |
 +| ''​muptp'' ​     | //​kg/​(m<​sup>​2</​sup>​ d)//          | //nutrient cycling// ​   | //​1/​5/​7// ​   | macrophyte uptake of SP in lake water. Can also be defined in [[start:​hype_file_reference:​par.txt|par.txt]] ​                                                                                                                                                                                                                                                                          |
 | ''​t2mix'' ​      | //-//                             | //physical property// ​  | //​1/​5/​7// ​   | switch for using mixed lake T2 temperature on outflow of lake (0/1). Can also be defined in [[start:​hype_file_reference:​par.txt|par.txt]] ​                                                                                                                                                                                                                                            | | ''​t2mix'' ​      | //-//                             | //physical property// ​  | //​1/​5/​7// ​   | switch for using mixed lake T2 temperature on outflow of lake (0/1). Can also be defined in [[start:​hype_file_reference:​par.txt|par.txt]] ​                                                                                                                                                                                                                                            |
 +| ''​sm_resop'' ​      | //​0-4// ​                       | //sediment management// ​  | //​1/​5/​7// ​   | 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// ​                       | //sediment management// ​  | //​1/​5/​7// ​   | reservoir sediment management methods; 0=no flush, 1=flush based on reservoir fill up, 2=flushing based on day of year                                                                                                                                                                                                                                             |
 +| ''​sm_dest'' ​      | //​0-1// ​                       | //sediment management// ​  | //​1/​5/​7// ​   | reservoir sediment management methods; 0=flushed material is removed, 1=flushed material added to flow going downstream ​                                                                                                                                                                                                                                            |
 +| ''​sm_start'' ​      | //​-/​days// ​                   | //sediment management// ​  | //​1/​5/​7// ​   | threshold to start sediment flushing. For sm_mode=1 fraction of initial storage volume. For sm_mode=2 day of year.                                                                                                                                                                                                                                             |
 +| ''​sm_duradays'' ​   | //​days// ​                       | //sediment management// ​  | //​1/​5/​7// ​   | parameter to regulate the rate of flushing, number of days over which to flush. For sm_mode=1 and 2.                                                                                                                                                                                                                                             |
 +| ''​sm_caprest'' ​      | //-//                        | //sediment management// ​  | //​1/​5/​7// ​   | parameter to regulate the rate of flushing, the fraction of the reservoir storage capacity that will be removed. For sm_mode=1 and 2.                                                                                                                                                                                                                                             |
 +| ''​sm_yfreq'' ​      | //​years// ​                      | //sediment management// ​  | //​1/​5/​7// ​   | number of years between flushing. For sm_mode=2 only.                                                                                                                                                                                                                                             |
 </​sortable>​ </​sortable>​
  
start/hype_file_reference/lakedata.txt.1602518153.txt.gz · Last modified: 2020/10/12 17:55 by cpers