start:hype_file_reference:geodata.txt
Differences
This shows you the differences between two versions of the page.
| Both sides previous revision Previous revision Next revision | Previous revision Next revision Both sides next revision | ||
|
start:hype_file_reference:geodata.txt [2020/04/28 11:23] cpers [Table] |
start:hype_file_reference:geodata.txt [2020/04/30 07:25] cpers |
||
|---|---|---|---|
| Line 1: | Line 1: | ||
| ====== GeoData.txt ====== | ====== GeoData.txt ====== | ||
| - | This file contains characteristics of the spatially delineated sub-basins in a HYPE model domain. This includes e.g. SUBIDs (subbasin IDs) and SUBIDs of downstream subbasins, fractions of SLC classes (hydrological response units) within each subbasin, different model region (sub-domain) identifiers. As a general rule, information included in //GeoData.txt// is time-invariant within HYPE. | + | This file contains characteristics of the spatially delineated subbasins in a HYPE model domain. This includes e.g. SUBIDs (subbasin IDs) and SUBIDs of downstream subbasins, fractions of SLC classes (hydrological response units) within each subbasin, different model region (sub-domain) identifiers. As a general rule, information included in //GeoData.txt// is time-invariant within HYPE. |
| - | //GeoData.txt// is a tab-separated file located in the [[start:hype_file_reference:info.txt&#model_options|modeldir]] folder. Subbasins are listed row-wise. The first row contains a column header with variable names. Variable names are not case-sensitive (max. 11 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 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. | + | //GeoData.txt// is a tab-separated file located in the [[start:hype_file_reference:info.txt&#model_options|modeldir]] folder. Subbasins are listed row-wise. The first row contains a column header with variable names. Variable names are not case-sensitive (max. 11 characters, no spaces). Columns with headings unknown to HYPE are skipped while reading the file, but must not longer than eleven characters. 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. |
| - | Sub-basins have to be ordered in down-stream sequence in //GeoData.txt//, starting at headwaters and ending at outlet basins. This is because HYPE requires upstream contributions whe computing fluxes at each subbasin and subbasin the computation sequence follows //GeoData.txt// rows. Note that bifurcations as given in input file [[start:hype_file_reference:branchdata.txt|BranchData.txt]] will create additional upstream areas and the row order in //GeoData.txt// must also take those contributions into account. | + | Subbasins have to be ordered in down-stream sequence in //GeoData.txt//, starting at headwaters and ending at outlet basins. This is because HYPE requires upstream contributions when computing fluxes at each subbasin and subbasin the computation sequence follows //GeoData.txt// rows. Note that bifurcations as given in input file [[start:hype_file_reference:branchdata.txt|BranchData.txt]] will create additional upstream areas and the row order in //GeoData.txt// must also take those contributions into account. |
| Example for a //GeoData.txt// file structure: | Example for a //GeoData.txt// file structure: | ||
| Line 40: | Line 40: | ||
| | ''ilregion'' | //-// | optional | lake region for ilake parameters, integer > 0, default is 1 | | | ''ilregion'' | //-// | optional | lake region for ilake parameters, integer > 0, default is 1 | | ||
| | ''olregion'' | //-// | optional | lake region for olake parameters, integer > 0, default is 1 | | | ''olregion'' | //-// | optional | lake region for olake parameters, integer > 0, default is 1 | | ||
| - | | ''elev_mean'' | //m// | optional | mean elevation of sub-basin | | + | | ''elev_mean'' | //m// | optional | mean elevation of subbasin | |
| | ''elev_std'' | //m// | optional | variation (standard deviation) in elevation in a subbasin | | | ''elev_std'' | //m// | optional | variation (standard deviation) in elevation in a subbasin | | ||
| | ''slope_mean'' | //%// | optional/mandatory | slope (>= 0%), mandatory for nutrient modelling | | | ''slope_mean'' | //%// | optional/mandatory | slope (>= 0%), mandatory for nutrient modelling | | ||
| | ''slope_std'' | //%// | optional | variation (standard deviation) of slope in a subbasin | | | ''slope_std'' | //%// | optional | variation (standard deviation) of slope in a subbasin | | ||
| | ''lake_depth'' | //m// | optional | water depth from outflow threshold, below which outlet flow ceases, down to mean depth for outlet lake, used for general lake discharge curve. Can also be defined in [[start:hype_file_reference:lakedata.txt|LakeData.txt]] or [[start:hype_file_reference:par.txt|par.txt]]. Definition in LakeData takes precedence. Must be > 0, or set to -9999 to use general or region parameter value from par.txt. | | | ''lake_depth'' | //m// | optional | water depth from outflow threshold, below which outlet flow ceases, down to mean depth for outlet lake, used for general lake discharge curve. Can also be defined in [[start:hype_file_reference:lakedata.txt|LakeData.txt]] or [[start:hype_file_reference:par.txt|par.txt]]. Definition in LakeData takes precedence. Must be > 0, or set to -9999 to use general or region parameter value from par.txt. | | ||
| - | | ''lakedataid'' | //-// | optional | lake or lake basin ID, coupled to //lakedataid// in [[start:hype_file_reference:lakedata.txt|LakeData.txt]], 0 if no such coupling exists | | + | | ''lakedataid'' | //-// | optional | olake ID, coupled to //lakedataid// in [[start:hype_file_reference:lakedata.txt|LakeData.txt]], 0 if no such coupling exists | |
| | ''icatch'' | //-// | optional | fraction of local runoff that goes through the local lake (ilake), the rests runs directly into the main watercourse. To instead use parameter values (''gicatch'', ''ilicatch'' in [[start:hype_file_reference:par.txt|par.txt]]) for a single simulation set value to -9999 in GeoData or remove the column completely. | | | ''icatch'' | //-// | optional | fraction of local runoff that goes through the local lake (ilake), the rests runs directly into the main watercourse. To instead use parameter values (''gicatch'', ''ilicatch'' in [[start:hype_file_reference:par.txt|par.txt]]) for a single simulation set value to -9999 in GeoData or remove the column completely. | | ||
| | ''rivlen'' | //m// | mandatory | length of main watercourse within subbasin | | | ''rivlen'' | //m// | mandatory | length of main watercourse within subbasin | | ||
| Line 80: | Line 80: | ||
| | ''eroindex'' | //-// | optional | erosion index given per subbasin, used for erosion model 1 (defaults to 1) | | | ''eroindex'' | //-// | optional | erosion index given per subbasin, used for erosion model 1 (defaults to 1) | | ||
| | ''ws_nn_d'' | | optional | Winstral coefficient for each class number //nn// and direction //d// | | | ''ws_nn_d'' | | optional | Winstral coefficient for each class number //nn// and direction //d// | | ||
| - | | ''mrratck_noi'' | //-// | optional | coefficient in rating curve (//k//) for main river water level during no ice conditions (q=k*(w-w0)^p) | | + | | ''mrratck_noi'' | //-// | optional | coefficient in rating curve (//k//) for main river water level during no ice conditions (q=k*(w-w0)<sup>p</sup>) | |
| - | | ''mrratcp_noi'' | //-// | optional | coefficient in rating curve (//p//) for main river water level during no ice conditions (q=k*(w-w0)^p) | | + | | ''mrratcp_noi'' | //-// | optional | coefficient in rating curve (//p//) for main river water level during no ice conditions (q=k*(w-w0)<sup>p</sup>) | |
| - | | ''mrratck_ice'' | //-// | optional | coefficient in rating curve (//k//) for main river water level during ice conditions (q=k*(w-w0)^p) | | + | | ''mrratck_ice'' | //-// | optional | coefficient in rating curve (//k//) for main river water level during ice conditions (q=k*(w-w0)<sup>p</sup>) | |
| - | | ''mrratcp_ice'' | //-// | optional | coefficient in rating curve (//p//) for main river water level during ice conditions (q=k*(w-w0)^p) | | + | | ''mrratcp_ice'' | //-// | optional | coefficient in rating curve (//p//) for main river water level during ice conditions (q=k*(w-w0)<sup>p</sup>) | |
| | ''mrratcw0'' | //m// | optional | reference water level at zero water level of main river | | | ''mrratcw0'' | //m// | optional | reference water level at zero water level of main river | | ||
| </sortable> | </sortable> | ||
start/hype_file_reference/geodata.txt.txt · Last modified: 2024/02/15 09:44 by cpers
Except where otherwise noted, content on this wiki is licensed under the following license: CC Attribution-Share Alike 4.0 International
