User Tools

Site Tools


start:hype_file_reference:xxxxxxx.txt_regional

This is an old revision of the document!


XXXXXXX.txt (region output)

HYPE region output files are one of the standard result files for time series output from HYPE, the other are basin output files, map output files and time output files.

Region output files each contain results for multiple variables of a single output region (as defined in Outregions.txt). This makes it different from time and map output files which always contain results for the whole model domain. To write region output files, specify a regionoutput for the variables of interest in the info.txt file.

Example snippet of a info.txt file:

!! region outputs for yearly snow and runoff
regionoutput variable snow crun
regionoutput outregion 1
regionoutput meanperiod 4
regionoutput decimals 5

Basin output files are written to the resultdir folder. XXXXXXX in the file name is substituted by the subbasin ID (same ID as used in info.txt with leading zeros for SUBID with less than 7 digits, for example 0002452.txt.

Basin output files contain tab-separated data with column-wise HYPE variables and row-wise time periods. All HYPE variable IDs are described in the list of HYPE variables. In addition upstream aggregated variables (e.g. upcrun) may be included in the basin output.

Basin output files are tab-separated and contain two header rows. The first header contains HYPE variable IDs. The second header contains variable units. Below the headers follow the model results. The first column contains a date-time string (format depending on meanperiod specified in info.txt), following columns contain model results of the given variable for all subbasins in the model set-up. Missing values are given as -9999.

Example structure of a basin output file with daily variables, corresponding to the info.txt file example above:

DATE       rout  cout  prec  temp snow evap  upcrun
UNITS      m3/s  m3/s  mm    degC mm   mm    mm
2003-01-01 0.51  0.482 0     7.2  1.2  1.543 0.23
2003-01-02 0.40  0.319 1     6.9  0    1.140 0.31
2003-01-03 0.31  0.273 0     5.4  0    0.98  0.08
2003-01-04 0.24  0.247 0.1   5.0  0    0.87  0.1
2003-01-05 0.22  0.226 0     4.5  0    0.75  0.05
...        ...   ...   ...   ...  ...  ...   ...

It is possible to print out basinoutput files for several mean periods at the same time. This is controlled from the info-file by numbering the different output information rows for the different types (see info.txt for example). If this option is used the second and following outputs will be separated from the first by adding the mean period as a code in the file name, e.g. 0000748_YR.txt holds yearly average (or sum) of variables specified for subbasin 748.

When ensemble or sequence simulations are made, the results from simulations (I = 1 .. n or I = sequence number > 0) are written to files named XXXXXXX_00I.txt, where n is defined by num_ens in optpar.txt. Alternatively, if a Monte Carlo simulation is done with task set to write all simulations (task WS in optpar.txt) files will be named XXXXXXX_000000I.txt. In this case up to 9999999 simulations can be saved.

start/hype_file_reference/xxxxxxx.txt_regional.1493210619.txt.gz ยท Last modified: 2023/11/16 14:28 (external edit)