## Navigation

### HYPE Documentation

*Quick links to often-used pages:*

### HYPE links

HYPE OSC (model code)

HYPE Open data access

SMHI Hydrology Research Dep., main developer and maintainer of the HYPE model

*Quick links to often-used pages:*

HYPE OSC (model code)

HYPE Open data access

SMHI Hydrology Research Dep., main developer and maintainer of the HYPE model

start:hype_file_reference:subassx.txt

This is a file with an assessment of each subbasin's performance, or each output region if regional output variables are used. The file is located in the resultdir folder. One file is printed for each unique combination of simulated and recorded variable among the performance criterion included in the objective function given in info.txt. X is the ordinal number of the performance criterion and the subbasin assessment is calculated for the same variables as that performace criterion. If more than nine criteria are included, the following are denoted by capital letters. Definitions of equations for calculating the criteria is found here. Settings in *info.txt* decide which performance criteria is written.

When ensemble or sequence simulations are made, the results from simulations (I=1 .. *n* or I=sequence number>0) are written to files named subassX_00I.txt. For a Monte Carlo calibration *n* is defined by `num_ens`

in optpar.txt. For a DE calibration *n* is `num_ngen`

plus one, where the first one is a simulation with median of the others parameter values.

For the calculation of criterion for lake water stage, the combination of variables `wcom`

and `wstr`

are exchanged for the internal variables `clwc`

and `clws`

by the program. These variables are the water stages cleaned from `w0ref`

reference level (`clwc`

=`wcom`

-`w0ref`

, `clws`

=`wstr`

-`w0ref`

). This makes the criterion calculation more accurate, but note that relative criteria, e.g. relative bias, are relative to the smaller cleaned water stage level.

The first row of the file let you know the average period (0=timesteply, 1=daily, 2=weekly, 3=monthly, 4=yearly) used for calculation of the values that are compared in the criteria. This period corresponds to the setting `meanperiod`

in info.txt. Variable names and unit of the variables are also listed on row one.
The second row is column headings. Thereafter follow subbasins which has observations, one on each row. The data limitation for calculating the subbasin criteria is the same as that of the calibration criteria. This limitation is not used for calculation of minimum and maximum values though. Missing values are indicated as -9999. Note: minimum and maximum values are based on the average period, e.g. maximum of monthly average flows.

Columns of subassX.txt:

Header | Unit | Description |
---|---|---|

`SUBID / OUTREGID` | - | subbasin id (as defined in GeoData.txt) or outregion id (as defined in Outregions.txt) |

`NSE` | - | Nash-Sutcliffe efficiency |

`CC` | - | Pearson correlation coefficient (part 1 of Kling-Gupta efficiency) |

`RE(%)` | % | relative bias in mean |

`RSDE(%)` | % | relative bias in standard deviation |

`Sim` | in first row | mean of simulated variable |

`Rec` | in first row | mean of observed variable |

`SDSim` | in first row | standard deviation of simulated variable |

`SDRec` | in first row | standard deviation of observed variable |

`MAE` | in first row | mean absolute error |

`RMSE` | in first row | root mean square error |

`Bias` | in first row | bias |

`SDE` | in first row | bias of standard deviation |

`KGE` | - | Kling-Gupta efficiency |

`KGESD` | - | part 2 of Kling-Gupta efficiency (std-quotient) |

`KGEM` | - | part 3 of Kling-Gupta efficiency (mean-quotient) |

`NRMSE` | - | normalised root mean square error |

`NSEW` | - | Nash-Sutcliffe efficiency adjusted for bias |

`Nrec` | - | number of observations |

`MinRec` | in first row | minimum value of observed variable |

`MaxRec` | in first row | maximum value of observed variable |

`MinSim` | in first row | minimum value of simulated variable |

`MaxSim` | in first row | maximum value of simulated variable |

Example of subass1.txt:

Subbasin assessment. Criteria is calculated for period 1. Variables: rout, cout Unit: m3/s SUBID NSE CC RE(%) RSDE(%) Sim Rec SDSim SDRec MAE RMSE Bias SDE KGE KGESD KGEM NRMSE NSEW Nrec 112 0.5071 0.721 22.6492 -68.38 0.058 0.0472 0.0681 0.1 0.0385 0.072 0.0131 -0.0132 0.5182 0.6781 1.2265 0.0662 0.5122 783 135 0.722 0.8811 -20.802 0.3982 0.3081 0.3887 0.4089 0.4071 0.1464 0.2143 -0.0811 0.0021 0.76 1.004 0.7922 0.0752 0.7223 1052

start/hype_file_reference/subassx.txt.txt ยท 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