User Tools

Site Tools


start:hype_file_reference

HYPE file reference

This part of the HYPE documentation is a reference guide to all mandatory and optional HYPE files. HYPE works with plain text files for model setup, data input/output, and calibration.

The tables in the following sections contain file names and short descriptions of mandatory and optional input and output files for HYPE, grouped by content type. More detailed descriptions on file content, format and requirements are found in the section of each file.

Input files marked mandatory in the tables below must exist for a basic HYPE setup. Other files are required only for optional model components, e.g. glaciers, or for specific model tasks, e.g. parameter calibration.

As a shortcut, here are three links to frequently used references when running an existing HYPE setup:

  • info.txt, which is the main instruction file of HYPE where all options are specified for a model simulation
  • par.txt, which holds the values of model parameters
  • HYPE variables, a list of variable names used for HYPE inputs and outputs

Setup files

Setup files contain information about a HYPE model domain, model parameters, model options (model choice and simulation settings).

File name Requirement Description
filedir.txtoptionalprovides location of info.txt
info.txtmandatorymodel options and simulation settings
pmsf.txtoptionalpartial model setup, defines part of model domain to simulate
update.txtoptionalfor updating of model variables with observations
GeoClass.txtmandatorySLC class definition (HRUs)
GeoData.txtmandatorysubcatchment characteristics and flow connections between them
BranchData.txtoptionalbifurcations in the flow network
LakeData.txtoptionalproperties of specific lakes (including regulated dams)
DamData.txtoptionalproperties of specific regulated lakes, extends LakeData.txt
CropData.txtoptionalinformation about crops and vegetation
PointSourceData.txtoptionalinformation about point sources and water abstraction
MgmtData.txtoptionalinformation about irrigation
AquiferData.txtoptionalinformation about regional aquifers
FloodData.txtoptionalinformation about floodplain
GlacierData.txtoptionalinformation about glaciers
par.txtmandatorymodel parameters, some is calibrated
state_saveoptionalfiles containing saved model states for model initialisation
reg_par.txtoptionalfile containing regional regression coefficients, for parameter regionalization method
CatchDes.txtoptionallist of catchment descriptors, for parameter regionalization method
CatchGroup.txtoptionallist of catchment group membership of all subbasins, for parameter regionalization method
Outregions.txtoptionalinformation about output regions
ForcKey.txtoptionallink list between subcatchment IDs and forcing data IDs, as well as temperature observation elevations

Observation data files

Observation data files are HYPE input files which contain time series, both forcing data and evaluation data.

All HYPE variable IDs are described in the complete HYPE variable list, while HYPE variable IDs useable in Xobs.txt are also described in the Xobs.txt section.

File name Requirement Description
Pobs.txtmandatoryprecipitation forcing (HYPE variable ID: prec)
Tobs.txtmandatoryair temperature forcing (HYPE variable ID: temp)
Qobs.txtoptionaldischarge observations (HYPE variable ID: rout)
Xobs.txtoptionalobservations of evaluation variables for subbasins, e.g. nutrient concentrations, lake water stage
Xoregobs.txtoptionalobservations of evaluation variables for output regions, e.g. snow
RHobs.txtoptionalrelative humidity forcing
SFobs.txtoptionalsnowfall fraction of precipitation forcing
SWobs.txtoptionalshortwave radiation forcing
TMINobs.txtoptionaldaily minimum air temperature forcing
TMAXobs.txtoptionaldaily maximum air temperature forcing
Uobs.txtoptionalwind speed forcing
XobsXOMn.txtoptionalobservations of evaluation variables, one per file (HYPE variable ID: xom0-xom9)
XobsXOSn.txtoptionalobservations of evaluation variables, one per file (HYPE variable ID: xos0-xos9)

Output files

Output files contain model results. This includes time series of simulations and observations (for each time step or averaged/summed over a longer period) as well as model performance results.

All HYPE variable IDs used in HYPE output files are described in the complete HYPE variable list.

File name Requirement Description
hyss_seqnr_yymmdd_HHMM.logautomaticlog file, created for each model run
XXXXXXX.txtoptionalbasin output file, several output variables for one subbasin (subid=XXXXXXX)
XXXXXXX.txt (regional)optionalregion output file, several output variables for one output region (outregid=XXXXXXX)
timeXXXX.txtoptionaltime output file, output of single variable (HYPE variable ID=XXXX) for all subbasins
mapXXXX.txtoptionalmap output file, output of single variable (HYPE variable ID=XXXX) for all subbasins, formatted for GIS
subassX.txtoptionalsubbasin assessment, performance criteria for subbasins
simass.txtoptionalsimulation assessment, summarising performance criteria over model domain
yyyy_ss.txtoptionalresult files with annual nutrient transports per subbasin and source
Wbf_xxx.txtoptionalwater balance: flows per subbasin and day
Wbff_xxx.txtoptionalwater balance: floodplain related flows per subbasin and day
Wbfs_xxx.txtoptionalwater balance: irrigation flows per subbasin and day
Wbs_xxx.txtoptionalwater balance: storage per subbasin and day
state_saveyyyymmdd[HHMM] optionalfiles containing saved model states for model initialisation

Calibration files

Calibration files are files related to the parameter calibration model option in HYPE, both for setup and results. Additional calibration information is given in info.txt where the objective function for the optimization (see performance criteria) is set and calibration turned on.

All HYPE variable IDs used in HYPE calibration files are described in the complete HYPE variable list.

File name Requirement Description
optpar.txtoptionalcalibration simulation settings including parameter ranges
qNstartpar.txtoptionalstarting values for parameter optimization using quasiNewton methods (including Brent)
respar.txtoptionaloptimal parameter values of calibration
bestsims.txtoptionalbest performance criteria and parameter values of calibration
allsim.txtoptionalperformance results (criteria and parameter values) of all runs during calibration
calibration.logautomaticcalibration log file

Water balance files

A set of output files giving subbasin water balance. The water balance is calculated for each time step and subbasin, and one file holds one flow or store.

File prefix Type Unit Description
WBsstorem3water volume in each store for each time step for all subbasins or for selected subbasins (irrigation, floodplains) or for aquifers
WBfflowm3 ts-1horizontal flows between subbasins and regional groundwater flows
WBfflowm3 ts-1vertical or horizontal flows within subbasin
WBfs/WBfflowm3 ts-1water management flows; irrigation (WBfs) for selected subbasins and point sources (WBf) for all subbasins
WBffflowm3 ts-1floodplain related flows

A description of these will come (HYPE water balance).

start/hype_file_reference.txt ยท Last modified: 2017/07/10 11:14 by cpers