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:xxxxxxx.txt_regional [2017/04/26 14:38] cpers |
start:hype_file_reference:xxxxxxx.txt_regional [2017/06/15 09:41] cpers |
||
---|---|---|---|
Line 3: | Line 3: | ||
HYPE region output files are one of the standard result files for time series output from HYPE, the other are [[start:hype_file_reference:xxxxxxx.txt|basin output files]], [[start:hype_file_reference:mapxxxx.txt|map output files]] and [[start:hype_file_reference:timexxxx.txt|time output files]]. | HYPE region output files are one of the standard result files for time series output from HYPE, the other are [[start:hype_file_reference:xxxxxxx.txt|basin output files]], [[start:hype_file_reference:mapxxxx.txt|map output files]] and [[start:hype_file_reference:timexxxx.txt|time output files]]. | ||
- | Region output files each contain results for multiple variables of a single output region. This makes it different from time and map output files which always contain results for the whole model domain. Basin output files are intended for model analyses at the subbasin scale, and they are arguably the most commonly used HYPE output type. To write basin output files, specify a ''basinoutput'' for the variables of interest in the [[start:hype_file_reference:info.txt#output_options|info.txt]] file. | + | Region output files each contain results for multiple variables of a single output region (as defined in [[start:hype_file_reference:outregions.txt|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 [[start:hype_file_reference:info.txt#output_options|info.txt]] file. |
Example snippet of a info.txt file: | Example snippet of a info.txt file: | ||
- | !! time outputs for measured and simulated discharge | + | !! region outputs for yearly snow and runoff |
- | timeoutput variable rout cout prec temp snow evap upcrun | + | regionoutput variable snow crun |
- | basinoutput subbasin 2452 2353 1244 2424 | + | regionoutput outregion 1 |
- | timeoutput meanperiod 4 | + | regionoutput meanperiod 1 |
- | timeoutput decimals 5 | + | regionoutput decimals 3 |
+ | regionoutput outregion 74 | ||
- | Basin output files are written to the [[start:hype_file_reference:info.txt&#model_options|resultdir]] folder. **XXXXXXX** in the file name is substituted by the subbasin ID (same ID as used in [[start:hype_file_reference:info.txt#output_options|info.txt]] with leading zeros for SUBID with less than 7 digits, for example //0002452.txt//. | + | Region output files are written to the [[start:hype_file_reference:info.txt&#model_options|resultdir]] folder. **XXXXXXX** in the file name is substituted by the outregion ID (same ID as used in [[start:hype_file_reference:info.txt#output_options|info.txt]] with leading zeros for OUTREGID with less than 7 digits, for example //0000001.txt//. Note that outregid:s may not overlap subid:s. |
- | 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 **[[start:hype_file_reference:info.txt:variables|list of HYPE variables]]**. In addition upstream aggregated variables (e.g. upcrun) may be included in the basin output. | + | Region output files contain tab-separated data with column-wise HYPE variables and row-wise time periods. All HYPE variable IDs are described in the **[[start:hype_file_reference:info.txt:variables|list of HYPE variables]]**. Of these the corresponding output regional variables (e.g. ''rgcrun'') may be included in the region 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. | + | Region output files are tab-separated and contain two header rows. The first header contains 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 chosen variables. Missing values are given as -9999. |
- | Example structure of a basin output file with daily variables, corresponding to the //info.txt// file example above: | + | Example structure of a region output file with daily variables, corresponding to the //info.txt// file example above: |
- | DATE rout cout prec temp snow evap upcrun | + | DATE rgsnow rgcrun |
- | UNITS m3/s m3/s mm degC mm mm mm | + | UNITS mm mm |
- | 2003-01-01 0.51 0.482 0 7.2 1.2 1.543 0.23 | + | 2003-01-01 5.511 0.082 |
- | 2003-01-02 0.40 0.319 1 6.9 0 1.140 0.31 | + | 2003-01-02 3.403 0.319 |
- | 2003-01-03 0.31 0.273 0 5.4 0 0.98 0.08 | + | 2003-01-03 2.31 0.273 |
- | 2003-01-04 0.24 0.247 0.1 5.0 0 0.87 0.1 | + | 2003-01-04 2.244 0.047 |
- | 2003-01-05 0.22 0.226 0 4.5 0 0.75 0.05 | + | 2003-01-05 0.22 0.226 |
- | ... ... ... ... ... ... ... ... | + | ... ... ... |
- | 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 [[start:hype_file_reference:info.txt|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. | + | It is possible to print out region output 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 [[start:hype_file_reference:info.txt|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 output region 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 [[start:hype_file_reference:optpar.txt|optpar.txt]]. Alternatively, if a Monte Carlo simulation is done with task set to write all simulations (''task WS'' in [[start:hype_file_reference:optpar.txt|optpar.txt]]) files will be named //XXXXXXX_000000I.txt//. In this case up to 9999999 simulations can be saved. | 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 [[start:hype_file_reference:optpar.txt|optpar.txt]]. Alternatively, if a Monte Carlo simulation is done with task set to write all simulations (''task WS'' in [[start:hype_file_reference:optpar.txt|optpar.txt]]) files will be named //XXXXXXX_000000I.txt//. In this case up to 9999999 simulations can be saved. | ||