User Tools

Site Tools


start:hype_file_reference:geodata.txt

GeoData.txt

This file contains characteristics of the spatially delineated sub-basins in a HYPE model domain. This includes e.g. SUBIDs (sub-basin IDs) and SUBIDs of downstream sub-basins, fractions of SLC classes (hydrological response units) within each sub-basin, different model region (sub-domain) identifiers, and nutrient point source properties. As a general rule, information included in GeoData.txt is time-invariant within HYPE.

GeoData.txt is a tab-separated file located in the modeldir folder. Sub-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 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 sub-basin and sub-basin the computation sequence follows GeoData.txt rows. Note that bifurcations as given in input file 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:

subid maindown area parreg lakedataid rivlen slc_1 slc_2 slc_3 slc_4 scr_1 ...
1     3        5000 1      1          0      0.54  0.23  0.1   0.13  0.1   ...
2     3        3000 1      0          0      0.45  0.5   0.05  0           ...
3     0        6000 2      2          500    0.45  0     0.25  0.3   0.2   ...
...   ...      ...  ...    ...        ...    ...   ...   ...   ...   ...   ...

All GeoData.txt variables are described in the table below. For point source variables (beginning with ps) it is recommended to use input file PointSourceData.txt instead, because this allows to define unlimited point sources per sub-basin, whereas in GeoData.txt only three can be defined.

Variable ID Unit Requirement Description
aream2mandatorysubbasin area
subid-mandatoryid number for subbasins, matched against Qobs.txt and Xobs.txt column headings, integer < 107
maindown-mandatorysubid 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°optionallatitude in degrees N (-90,90), used for calculation of extraterrestrial radiation in Hargreaves-Samani evapotranspiration model
region-optionalproduction region (or other region number system) for crops in CropData.txt, optional for nutrient modelling
parreg-optionalregion for correction parameters (e.g. evapcorr), integer > 0
wqparreg-optionalregion for water quality correction parameters (e.g. incorr), integer > 0
lakeregion-optional/mandatorylake region for watercourse parameters, mandatory for nutrient simulation, integer > 0
ilregion-optionallake region for ilake parameters, integer > 0, default is 1
olregion-optionallake region for olake parameters, integer > 0, default is 1
elev_meanmoptionalmean elevation of sub-basin
elev_stdmoptionalvariation (standard deviation) in elevation in a subbasin
slope_mean%optional/mandatoryslope (>= 0%), mandatory for nutrient modelling
slope_std%optionalvariation (standard deviation) of slope in a subbasin
lake_depthmoptionalwater 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 LakeData.txt or 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-optionallake or lake basin ID, coupled to lakedataid in LakeData.txt, 0 if no such coupling exists
icatch-optionalfraction of local runoff which runs through the local lake (ilake), the rests runs directly into the main watercourse. Can use parameter values; set to -9999 to use ilakeregion value from par.txt
rivlenmmandatorylength of main watercourse within subbasin
loc_rivlenmoptionallength of local watercourse within subbasin, default is square root of land area
slc_nn-mandatorysoil-type/land-use class number nn (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 99 SLCs can be defined nn matches the first column in GeoClass.txt
scr_nn-optionalfraction of SLC class nn's area that is sown with secondary crop (between 0 and 1)
dhslc_nnmoptionaldeviation for each class from mean elevation of subbasin (defaults to 0)
grwdown-optionalsubid 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-optionalfraction of groundwater flow from this subbasin that flows to this subbasins olake instead of to subbasin given in grwdown
loc_tpmg/loptionalconcentration of Tot-P from rural households outflow
loc_tnmg/loptionalconcentration of Tot-N from rural households outflow
loc_volm3/doptionaloutflow from rural households
loc_sp-optionalfraction of rural household P outlet that is in soluble form
loc_in-optionalfraction of rural household N outlet that is in soluble form
wetdep_nμg/loptionalwet deposition of inorganic nitrogen, concentration of precipitation
drydep_n1kg/(km2 d)optionaldry deposition of inorganic nitrogen on vegetation type 1 (open)
drydep_n2kg/(km2 d)optionaldry deposition of inorganic nitrogen on vegetation type 2 (forest)
drydep_n3kg/(km2 d)optionaldry deposition of inorganic nitrogen on “vegetation” type 3 (water)
lrwet_aream2optionalarea of local river wetland
mrwet_aream2optionalarea of main river wetland
lrwet_depmoptionalmean depth of local river wetland
mrwet_depmoptionalmean depth of main river wetland
lrwet_part-optionalpart of local river flow through wetland
mrwet_part-optionalpart of main river flow through wetland
buffer-optionalfraction of watercourse through agricultural land that has a buffer zone (between 0 and 1), mandatory for phosphorus simulation
close_w-optionalfraction 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
ps1_tpmg/loptionalconcentration of Tot-P in point source 1 outflow
ps1_tnmg/loptionalconcentration of Tot-N in point source 1 outflow
ps1_volm3/doptionaloutflow from point source 1
ps1_sp-optionalfraction of point source 1 P that is in soluble form
ps1_in-optionalfraction of point source 1 N that is in inorganic form
ps2_tpmg/loptionalconcentration of Tot-P in point source 2 outflow
ps2_tnmg/loptionalconcentration of Tot-N in point source 2 outflow
ps2_volm3/doptionaloutflow from point source 2
ps2_sp-optionalfraction of point source 2 P that is in soluble form
ps2_in-optionalfraction of point source 2 N that is in inorganic form
ps3_tpmg/loptionalconcentration of Tot-P in point source 3 outflow
ps3_tnmg/loptionalconcentration of Tot-N in point source 3 outflow
ps3_volm3/doptionaloutflow from point source 3
ps3_sp-optionalfraction of point source 3 P that is in soluble form
ps3_in-optionalfraction of point source 3 N that is in inorganic form
petmodel-optionaldefines 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
eroindex-optionalerosion index given per subbasin, used for erosion model 1
start/hype_file_reference/geodata.txt.txt · Last modified: 2017/08/29 08:37 by cpers