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 | ||
|
start:hype_file_reference:geodata.txt [2022/01/27 09:59] cpers |
start:hype_file_reference:geodata.txt [2024/02/15 09:44] (current) cpers |
||
|---|---|---|---|
| Line 5: | Line 5: | ||
| //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. | //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. | ||
| - | 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. | + | 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. Note that multibasin lakes are calculated at the last lake basin, and thus all downstream basins of the multibasin lakes outlets (main outlet and possible branched outflow from other lake basins) must be taken located after the last lakebasin in the subbasin order. |
| Example for a //GeoData.txt// file structure: | Example for a //GeoData.txt// file structure: | ||
| Line 20: | Line 20: | ||
| <sortable> | <sortable> | ||
| - | ^ Variable ID ^ Unit ^ Requirement ^ Description ^ | + | ^ Variable ID ^ Unit ^ Requirement ^ Description ^ |
| - | | ''area'' | //m<sup>2</sup>// | mandatory | subbasin area | | + | | ''area'' | //m<sup>2</sup>// | mandatory | subbasin area | |
| - | | ''subid'' | //-// | mandatory | id number for subbasins, matched against [[start:hype_file_reference:qobs.txt|Qobs.txt]] and [[start:hype_file_reference:xobs.txt|Xobs.txt]] column headings, integer < 10<sup>7</sup> | | + | | ''subid'' | //-// | mandatory | id number for subbasins, matched against [[start:hype_file_reference:qobs.txt|Qobs.txt]], [[start:hype_file_reference:xobs.txt|Xobs.txt]] or [[start:hype_file_reference:xcgobs.txt|Xcgobs.txt]] column headings, integer < 10<sup>7</sup> | |
| - | | ''maindown'' | //-// | mandatory | subid of downstream sub-basin, i.e. the one to which the subbasin flows (integer, use 0 for subbasins that don’t run to another subbasin, e.g. coastal areas) | | + | | ''maindown'' | //-// | mandatory | subid of downstream sub-basin, i.e. the one to which the subbasin flows (integer, use 0 for subbasins that don’t run to another subbasin, e.g. coastal areas) | |
| - | | ''latitude'' | //°// | optional | latitude in degrees N (-90,90), used for calculation of extraterrestrial radiation in [[start:hype_model_description:processes_above_ground&#alternative_potential_evaporation_models|Hargreaves-Samani evapotranspiration model]] | | + | | ''latitude'' | //°// | optional | latitude in degrees N (-90,90), used for calculation of extraterrestrial radiation in [[start:hype_model_description:processes_above_ground&#alternative_potential_evaporation_models|Hargreaves-Samani evapotranspiration model]] | |
| - | | ''region'' | //-// | optional/mandatory | production region for crops in [[start:hype_file_reference:cropdata.txt|CropData.txt]]. All sub-basins must have a non-zero region defined if CropData.txt is used. | | + | | ''region'' | //-// | optional/mandatory | production region for crops in [[start:hype_file_reference:cropdata.txt|CropData.txt]]. All sub-basins must have a non-zero region defined if CropData.txt is used. | |
| - | | ''parreg'' | //-// | optional | region for correction parameters (e.g. evapcorr). An integer 1,2,3,.., default is 1. | | + | | ''parreg'' | //-// | optional | region for correction parameters (e.g. evapcorr). An integer 1,2,3,.., default is 1. | |
| - | | ''wqparreg'' | //-// | optional | region for water quality correction parameters (e.g. incorr). An integer 1,2,3,.., default is 1. | | + | | ''wqparreg'' | //-// | optional | region for water quality correction parameters (e.g. incorr). An integer 1,2,3,.., default is 1. | |
| - | | ''lakeregion'' | //-// | optional | lake region for watercourse parameter. An integer 1,2,3,.., default is 1. | | + | | ''lakeregion'' | //-// | optional | lake region for watercourse parameter. An integer 1,2,3,.., default is 1. | |
| - | | ''ilregion'' | //-// | optional | lake region for internal lake (ilake) parameters. An integer 1,2,3,.. , default is 1. | | + | | ''ilregion'' | //-// | optional | lake region for internal lake (ilake) parameters. An integer 1,2,3,.. , default is 1. | |
| - | | ''olregion'' | //-// | optional | lake region for outlet lake (olake) parameters. An integer 1,2,3,.. , default is 1. | | + | | ''olregion'' | //-// | optional | lake region for outlet lake (olake) parameters. An integer 1,2,3,.. , default is 1. | |
| - | | ''elev_mean'' | //m// | optional | mean elevation of subbasin | | + | | ''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 | olake 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 | |
| - | | ''loc_rivlen'' | //m// | optional | length of local watercourse within subbasin, default is square root of land area | | + | | ''loc_rivlen'' | //m// | optional | length of local watercourse within subbasin, default is square root of land area | |
| - | | ''slc_nnn'' | //-// | mandatory | soil-type/land-use class number //nnn// (soil-landuse-combination class, hydrological response units in HYPE), fraction of the subbasin’s area belonging to this class (between 0 and 1). A maximum of 999 SLCs can be defined //nn// matches the first column in [[start:hype_file_reference:geoclass.txt|GeoClass.txt]]. Smallest slc fraction allowed is 10<sup>-7</sup>, i.e. 7 decimals. | | + | | ''slc_nnn'' | //-// | mandatory | soil-type/land-use class number //nnn// (soil-landuse-combination class, hydrological response units in HYPE), fraction of the subbasin’s area belonging to this class (between 0 and 1). A maximum of 999 SLCs can be defined //nn// matches the first column in [[start:hype_file_reference:geoclass.txt|GeoClass.txt]]. Smallest slc fraction allowed is 10<sup>-7</sup>, i.e. 7 decimals. | |
| - | | ''scr_nnn'' | //-// | optional | fraction of SLC class nn's area that is sown with secondary crop (between 0 and 1) | | + | | ''scr_nnn'' | //-// | optional | fraction of SLC class nn's area that is sown with secondary crop (between 0 and 1) | |
| - | | ''dhslc_nnn'' | //m// | optional | deviation for each class from mean elevation of subbasin (defaults to 0) | | + | | ''dhslc_nnn'' | //m// | optional | deviation for each class from mean elevation of subbasin (defaults to 0) | |
| - | | ''grwdown'' | //-// | optional | subid for the subbasin to which this subbasin’s lateral/regional groundwater flow runs (use 0 for subbasins whose groundwater flow disappears). If column is missing or all zeros it is assumed that the groundwater flows via maindown. | | + | | ''grwdown'' | //-// | optional | subid for the subbasin to which this subbasin’s lateral/regional groundwater flow runs (use 0 for subbasins whose groundwater flow disappears). If column is missing or all zeros it is assumed that the groundwater flows via maindown. | |
| - | | ''grwolake'' | //-// | optional | fraction of groundwater flow from this subbasin that flows to this subbasins olake instead of to subbasin given in grwdown | | + | | ''grwolake'' | //-// | optional | fraction of groundwater flow from this subbasin that flows to this subbasins olake instead of to subbasin given in grwdown | |
| - | | ''loc_tp'' | //mg/l// | optional | concentration of Tot-P from rural households outflow | | + | | ''loc_vol'' | //m<sup>3</sup>/d// | optional | outflow from rural households (modeloption diffusesource 0). The outflow is given per day regardless of simulation time step. | |
| - | | ''loc_tn'' | //mg/l// | optional | concentration of Tot-N from rural households outflow | | + | | ''loc_tp'' | //mg/l// | optional | concentration of Tot-P from rural households outflow (''loc_vol'') | |
| - | | ''loc_ts'' | //mg/l// | optional | concentration of total suspended material from rural households outflow | | + | | ''loc_sp'' | //-// | optional | fraction of rural household P outlet that is in soluble form | |
| - | | ''loc_vol'' | //m<sup>3</sup>/d// | optional | outflow from rural households | | + | | ''loc_tn'' | //mg/l// | optional | concentration of Tot-N from rural households outflow (''loc_vol'') | |
| - | | ''loc_sp'' | //-// | optional | fraction of rural household P outlet that is in soluble form | | + | | ''loc_in'' | //-// | optional | fraction of rural household N outlet that is inorganic | |
| - | | ''loc_in'' | //-// | optional | fraction of rural household N outlet that is inorganic | | + | | ''loc_ts'' | //mg/l// | optional | concentration of total suspended material from rural households outflow (''loc_vol'') | |
| - | | ''loc_ss'' | //-// | optional | fraction of rural total suspended material outlet that is is suspended material | | + | | ''loc_ss'' | //-// | optional | fraction of rural total suspended material outlet that is is suspended material | |
| - | | ''loc_t1'' | //µU/L// | optional | concentration of tracer T1 from rural households outflow | | + | | ''loc_t1'' | //µU/L// | optional | concentration of tracer T1 from rural households outflow (''loc_vol'') | |
| - | | ''loc_t2'' | //°C// | optional | temperature of rural households outflow (used for T2 simulation) | | + | | ''loc_t2'' | //°C// | optional | temperature of rural households outflow (used for T2 simulation) | |
| - | | ''loc_soil'' | //-// | optional | fraction of emission from rural waste water that is emitted directly to the lowest soil layer (rest goes to the local watercourse). If no column: parameter ''locsoil'' is used. | | + | | ''loc_si'' | //mg/l// | optional | concentration of silica from rural households diffuse source (''loc_vol'') | |
| - | | ''lrwet_area'' | //m<sup>2</sup>// | optional | area of local river wetland | | + | | ''loc_ds'' | //-// | optional | fraction of rural hoursehold silica outlet that is is dissolved silica | |
| - | | ''mrwet_area'' | //m<sup>2</sup>// | optional | area of main river wetland | | + | | ''loc_oc'' | //mg/l// | optional | concentration of organic carbon from rural households diffuse source (''loc_vol'') | |
| - | | ''lrwet_dep'' | //m// | optional | mean depth of local river wetland | | + | | ''loc_soil'' | //-// | optional | fraction of emission from rural waste water (''loc_vol'') that is emitted directly to the lowest soil layer (rest goes to the local river). If no column found, the parameter ''locsoil'' is used. | |
| - | | ''mrwet_dep'' | //m// | optional | mean depth of main river wetland | | + | | ''locltp'' | //kg/yr// | optional | rural household diffuse source in the form of a load added to soil water (used for modeloption diffusesource 1) | |
| - | | ''lrwet_part'' | //-// | optional | part of local river flow through river wetland | | + | | ''loclsp'' | //-// | optional | fraction of locltp that is SP | |
| - | | ''mrwet_part'' | //-// | optional | part of main river flow through river wetland | | + | | ''locltn'' | //kg/yr// | optional | rural household diffuse source in the form of a load added to soil water (used for modeloption diffusesource 1) | |
| - | | ''iwetcatch'' | //-// | optional | fraction of subbasin area that are catchment area of the internal wetland (iwet) | | + | | ''loclin'' | //-// | optional | fraction of locltn that is IN | |
| - | | ''buffer'' | //-// | optional | fraction of watercourse through agricultural land that has a buffer zone (between 0 and 1), mandatory for phosphorus simulation | | + | | ''loclts'' | //kg/yr// | optional | rural household diffuse source in the form of a load added to soil water (used for modeloption diffusesource 1) | |
| - | | ''close_w'' | //-// | optional | fraction of agricultural land that lies near watercourse and which leakage therefore is affected by the buffer zone (between 0 and 1), mandatory for phosphorus simulation | | + | | ''loclss'' | //-// | optional | fraction of loclts that is SS | |
| - | | ''eroindex'' | //-// | optional | erosion index given per subbasin, used for erosion model 1 (defaults to 1) | | + | | ''loclt1'' | //U/yr// | optional | rural household diffuse source in the form of a load added to soil water (used for modeloption diffusesource 1) | |
| - | | ''suspchannel'' | //-// | optional | river channel erodability/vegetation cover modification factor of resuspension (0-1), used for sedresusp model 2 | | + | | ''loclt2'' | //k°C m3/yr // | optional | rural household diffuse source in the form of a load added to soil water (used for modeloption diffusesource 1) | |
| - | | ''sand'' | //-// | optional | sand soil fraction, used for siltation model | | + | | ''loclsi'' | //kg/yr// | optional | rural household diffuse source in the form of a load added to soil water (used for modeloption diffusesource 1) | |
| - | | ''silt'' | //-// | optional | silt soil fraction, used for siltation model | | + | | ''loclds'' | //-// | optional | fraction of loclsi that is dissolved silica (DS) | |
| - | | ''clay'' | //-// | optional | clay soil fraction, used for siltation model | | + | | ''locloc'' | //kg/yr// | optional | rural household diffuse source in the form of a load added to soil water (used for modeloption diffusesource 1) | |
| - | | ''petmodel'' | //-// | optional | defines with alternative potential evapotranspiration model should be used for each subbasin. Default is temperature dependence or use of observations (0), alternatives are temperature dependent (1), modified Jensen-Haise/McGuinness (2), modified Hargreaves-Samani (3), Priestly-Taylor (4), and FAO Penman-Monteith reference crop evapotranspiration (5). Note: will override petmodel given in info.txt | | + | | ''lrwet_area'' | //m<sup>2</sup>// | optional | area of local river wetland | |
| - | | ''ws_nn_d'' | | optional | Winstral coefficient for each class number //nn// and direction //d// | | + | | ''mrwet_area'' | //m<sup>2</sup>// | optional | area of main river wetland | |
| - | | ''cloud_nnn'' | //-// | optional | monthly cloudiness climatology (fraction). //nnn// is the first three letters of the month. | | + | | ''lrwet_dep'' | //m// | optional | mean depth of local river wetland | |
| - | | ''weight_sub'' | //-// | optional | weight of (trust in) subbasin in calculation of average model performace criteria and objective function | | + | | ''mrwet_dep'' | //m// | optional | mean depth of main river wetland | |
| - | | ''lks_num'' | //-// | optional | number of lake section of ilake (maximum 99) | | + | | ''lrwet_part'' | //-// | optional | part of local river flow through river wetland | |
| - | | ''lks_dp_N'' | //m// | optional | lake section N threshold above lake depth at outlet, N=1,2,.. | | + | | ''mrwet_part'' | //-// | optional | part of main river flow through river wetland | |
| - | | ''lks_fi_N'' | //-// | optional | lake section N fraction of icatch, N=1,2,.. | | + | | ''iwetcatch'' | //-// | optional | fraction of subbasin area that are catchment area of the internal wetland (iwet) | |
| - | | ''lks_fa_N'' | //-// | optional | lake section N fraction of ilake area, N=1,2,.. | | + | | ''buffer'' | //-// | optional | fraction of watercourse through agricultural land that has a buffer zone (between 0 and 1), mandatory for phosphorus simulation | |
| + | | ''close_w'' | //-// | optional | fraction of agricultural land that lies near watercourse and which leakage therefore is affected by the buffer zone (between 0 and 1), mandatory for phosphorus simulation | | ||
| + | | ''eroindex'' | //-// | optional | erosion index given per subbasin, used for erosion model 1 (defaults to 1) | | ||
| + | | ''suspchannel'' | //-// | optional | river channel erodability/vegetation cover modification factor of resuspension (0-1), used for sedresusp model 2 | | ||
| + | | ''sand'' | //-// | optional | sand soil fraction, used for siltation model | | ||
| + | | ''silt'' | //-// | optional | silt soil fraction, used for siltation model | | ||
| + | | ''clay'' | //-// | optional | clay soil fraction, used for siltation model | | ||
| + | | ''petmodel'' | //-// | optional | defines with alternative potential evapotranspiration model should be used for each subbasin. Default is temperature dependence or use of observations (0), alternatives are temperature dependent (1), modified Jensen-Haise/McGuinness (2), modified Hargreaves-Samani (3), Priestly-Taylor (4), and FAO Penman-Monteith reference crop evapotranspiration (5). Note: will override petmodel given in info.txt | | ||
| + | | ''ws_nn_d'' | | optional | Winstral coefficient for each class number //nn// and direction //d// | | ||
| + | | ''cloud_nnn'' | //-// | optional | monthly cloudiness climatology (fraction). //nnn// is the first three letters of the month. | | ||
| + | | ''weight_sub'' | //-// | optional | weight of (trust in) subbasin in calculation of average model performace criteria and objective function | | ||
| + | | ''lks_num'' | //-// | optional | number of lake section of ilake (maximum 99) | | ||
| + | | ''lks_dp_N'' | //m// | optional | lake section N threshold above lake depth at outlet, N=1,2,.. | | ||
| + | | ''lks_fi_N'' | //-// | optional | lake section N fraction of icatch, N=1,2,.. | | ||
| + | | ''lks_fa_N'' | //-// | optional | lake section N fraction of ilake area, N=1,2,.. | | ||
| + | | ''tilefrac_n'' | //-// | optional | optional fraction of tile drained area for the classes of this tile group, n=1-10| | ||
| + | | ''xcoord'' | //m// | optional | X/Y coordinate in meter, used for snowfall distribution | | ||
| + | | ''ycoord'' | //m// | optional | X/Y coordinate in meter, used for snowfall distribution | | ||
| + | | ''hds_depth'' | //m// | optional | maximum lake depth of HDS connectivity model| | ||
| </sortable> | </sortable> | ||
| - | Table. Deprecated variables from HYPE version 5.17.0 | + | Table. Deprecated variables from HYPE version 5.17.0. |
| <sortable> | <sortable> | ||
| - | ^ Variable ID ^ Unit ^ Requirement ^ Description ^ | + | ^ Variable ID ^ Unit ^ Description ^ Replacement ^ |
| - | | ''wetdep_n'' | //μg/l// | deprecated | wet deposition of inorganic nitrogen, concentration of precipitation | | + | | ''wetdep_n'' | //μg/l// | wet deposition of inorganic nitrogen, concentration of precipitation | Replaced by column IN_WD in [[start:hype_file_reference:atmdepdata.txt|AtmdepData.txt]]. Note the unit change to //mg/L//. | |
| - | | ''drydep_n1'' | //kg/(km<sup>2</sup> d)// | deprecated | dry deposition of inorganic nitrogen on vegetation type 1 (open) | | + | | ''drydep_n1'' | //kg/(km<sup>2</sup> d)// | dry deposition of inorganic nitrogen on vegetation type 1 (open) | Replaced by column IN_DD_V1 in AtmdepData.txt | |
| - | | ''drydep_n2'' | //kg/(km<sup>2</sup> d)// | deprecated | dry deposition of inorganic nitrogen on vegetation type 2 (forest) | | + | | ''drydep_n2'' | //kg/(km<sup>2</sup> d)// | dry deposition of inorganic nitrogen on vegetation type 2 (forest) | Replaced by column IN_DD_V2 in AtmdepData.txt | |
| - | | ''drydep_n3'' | //kg/(km<sup>2</sup> d)// | deprecated | dry deposition of inorganic nitrogen on "vegetation" type 3 (water) | | + | | ''drydep_n3'' | //kg/(km<sup>2</sup> d)// | dry deposition of inorganic nitrogen on "vegetation" type 3 (water) | Replaced by column IN_DD_V3 in AtmdepData.txt. | |
| - | | ''deploadn1 - deploadn12'' | //kg/(km<sup>2</sup> d)// | deprecated | total deposition of inorganic nitrogen on water, January - December | | + | | ''deploadn1 - deploadn12'' | //kg/(km<sup>2</sup> d)// | total deposition of inorganic nitrogen on water, January - December | Replaced by adding as dry deposition in AtmdepData.txt; columns IN_DD_M1_V3 ... IN_DD_M12_V3. | |
| </sortable> | </sortable> | ||
start/hype_file_reference/geodata.txt.1643273985.txt.gz · 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
