User Tools

Site Tools


start:hype_tutorials:short_intro

Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Both sides previous revision Previous revision
Next revision
Previous revision
start:hype_tutorials:short_intro [2016/12/29 15:49]
cpers [Basic model parameters]
start:hype_tutorials:short_intro [2024/01/25 11:37] (current)
Line 8: Line 8:
 The code is written in Fortran and is open source under the Lesser GNU Public License. SMHI took the initiative for a HYPE Open Source Community to strengthen international collaboration in hydrological modelling. More information about the initiative can be found at [[http://​hypecode.smhi.se/​|hypecode.smhi.se]].  ​ The code is written in Fortran and is open source under the Lesser GNU Public License. SMHI took the initiative for a HYPE Open Source Community to strengthen international collaboration in hydrological modelling. More information about the initiative can be found at [[http://​hypecode.smhi.se/​|hypecode.smhi.se]].  ​
  
-A HYPE simulation is started from the command line with the path to the model simulation configuration file as argument. Note that the path ends with a slash. For example:+A HYPE simulation is in its simplest way started from the command line with the path to the model simulation configuration file as argument. Note that the path ends with a slash. For example, if your model is put in the folder model1 in the modelsetups folder on the D-drive and your Windows executable is on the P-drive, your command will look like this:
  
 Windows Command Prompt: Windows Command Prompt:
Line 15: Line 15:
   $ ./hype /​data/​hypemodels/​model2/​   $ ./hype /​data/​hypemodels/​model2/​
  
-The HYPE executable return a **//Code 84//** message after a successful run.+In the Windows example your model is put in the folder model1 in the modelsetups folder on the D-drive and your HYPE executable ​is in the current folder, i.e on the P-drive. In the Linux example, your model is put in the folder model2 in the hypemodels folder in the data folder and your HYPE executable is in the current folder.  
 + 
 +Note: Older versions of the HYPE executable (before 5.6.0) ​return a **//Code 84//** message after a successful run.
  
 ===== The HYPE model set-up ===== ===== The HYPE model set-up =====
Line 55: Line 57:
  
  
-==== Basic model parameters ====+==== Eleven basic model parameters ====
  
  
-Model parameters ([[start:​hype_file_reference:​par.txt|par.txt]]) determine the function of the model. The model parameters may depend on land use, soil type or be a general value. The model parameters presented below make up a rudimentary water flow model, but many more exist and add other functions ​to HYPE. The default value of all model parameters are zero, so they need to be set to be included in the calculations. The model parameters are described in more detail in the [[start:​hype_model_description|HYPE model description]]. ​+Model parameters ([[start:​hype_file_reference:​par.txt|par.txt]]) determine the function of the model. The model parameters may depend on land use, soil type or be a general value. The model parameters presented below make up //a rudimentary water flow model for a cold climate catchment with lakes//. Many more model parameters ​exist and add other functionality ​to HYPE. The default value of all model parameters are zero, so they need to be set to be included in the calculations. The model parameters are described in more detail in the [[start:​hype_model_description|HYPE model description]] ​in relation to their process
  
-For a soil runoff model: In a cold climate snow melt is necessary. Snow melt rate (''​cmlt''​) is a land use dependent parameter and need one value per land use defined in [[start:​hype_file_reference:​geoclass.txt|GeoClass.txt]]. Evapotranspiration is governed by a land use dependent parameter (''​cevp''​). For a model with more than one soil layer the maximum amount of percolation (''​mperc1'',​ ''​mperc2''​) need to be set for percolation to occur. The available storage of water in the soil is determined by the model parameters for “field capacity” (''​wcfc''​) and effective porosity (''​wcep''​),​ which both depend on soil type. Runoff from the soil is determined by runoff coefficients. The runoff coefficient of the top soil layer (''​rrcs1''​) ​is necessary and depend on soil type.+For a soil runoff model: In a cold climate snow is present. Snow melt rate (''​cmlt''​) is a land use dependent parameter and need one value per land use defined in [[start:​hype_file_reference:​geoclass.txt|GeoClass.txt]]. The available storage of water in the soil is determined by the model parameters for field capacity (''​wcfc''​) and effective porosity (''​wcep''​),​ which both depend on soil type. Evapotranspiration is governed by a land use dependent parameter (''​cevp''​). For a model with more than one soil layer the maximum amount of percolation (''​mperc1'',​ ''​mperc2''​) need to be set for percolation to occur. Runoff from the soil is determined by runoff coefficients. The runoff coefficient of the top soil layer (''​rrcs1''​) depend on soil type and is necessary. The runoff coefficient of the other soil layers are calculated based on this parameter and others if they are set.
  
-For surface water model: Flow in rivers has a peak velocity (''​rivvel''​). This parameter determines the delay in the system. If you have lakes you can give a general lake depth (''​gldepi''​) and rating curve coefficients (''​gratp'',​ ''​gratk''​). They will be used for internal ​lakes. They will also be used for outlet lakes if no other data is given for them. E.g. outlet lakes may have their lake depth given in [[start:​hype_file_reference:​geodata.txt|GeoData.txt]]. ​+For surface water model: Flow in rivers has a peak velocity (''​rivvel''​). This parameter determines the delay in the system. If you have lakes you can give a general lake depth (''​gldepi''​) and rating curve coefficients (''​gratp'',​ ''​gratk''​). They will be used for all lakes not having specifically defined values elsewhere. E.g. outlet lakes may have their lake depth given in [[start:​hype_file_reference:​geodata.txt|GeoData.txt]]. ​
  
 Typical intervals for above mentioned model parameters: ''​cmlt''​=2-5,​ ''​cevp''​=0.1-0.3,​ ''​mperc1'',''​mperc2''​=5-100,​ ''​wcfc''​=0.05-0.5,​ ''​wcep''​=0.05-0.5,​ ''​rrcs1''​=0.05-0.5,​ ''​rivvel''​=0.5-2,​ ''​gldep''​i=5-10,​ ''​gratk''​=1-100,​ ''​gratp''​=1-2 Typical intervals for above mentioned model parameters: ''​cmlt''​=2-5,​ ''​cevp''​=0.1-0.3,​ ''​mperc1'',''​mperc2''​=5-100,​ ''​wcfc''​=0.05-0.5,​ ''​wcep''​=0.05-0.5,​ ''​rrcs1''​=0.05-0.5,​ ''​rivvel''​=0.5-2,​ ''​gldep''​i=5-10,​ ''​gratk''​=1-100,​ ''​gratp''​=1-2
Line 70: Line 72:
 With no settings given in the [[start:​hype_file_reference:​info.txt|info.txt]] the log-file ([[start:​hype_file_reference:​hyss_yymmddhhmm.log|hyss_seqnr_yymmddHHMM.log]]) is the only result of the simulation. The log-file contains information about running time and input files used. You will also get warning or error messages in the log-file. ​ With no settings given in the [[start:​hype_file_reference:​info.txt|info.txt]] the log-file ([[start:​hype_file_reference:​hyss_yymmddhhmm.log|hyss_seqnr_yymmddHHMM.log]]) is the only result of the simulation. The log-file contains information about running time and input files used. You will also get warning or error messages in the log-file. ​
  
-There are several [[start:​hype_file_reference#​output_files|options for output]] of simulation results, but all result in text-files. The example given above with [[start:​HYPE_file_reference:​timeXXXX.txt|timeseries output]] of discharge will produce a file called ​**timeCOUT.txt** with time series for simulated outflow (''​cout''​) from each subbasin in the model set-up as columns (defined by ''​subid''​). Similarly for other output the variable id and the subbasin id are given in the file name or in the heading of the file. It is also possible to print period mean values of a variable instead of time series. ​+There are several [[start:​hype_file_reference#​output_files|options for output]] of simulation results, but all result in text-files. The example given above with [[start:​HYPE_file_reference:​timeXXXX.txt|timeseries output]] of discharge will produce a file named **timeCOUT.txt** with time series for simulated outflow (''​cout''​) from each subbasin in the model set-up as columns (defined by ''​subid''​). Similarly for other output the variable id and the subbasin id are given in the file name or in the heading of the file. It is also possible to print period mean values of a variable instead of time series. ​
  
 HYPE can calculate performance criteria when observations are provided, e.g file [[start:​hype_file_reference:​qobs.txt|Qobs.txt]] with observed discharge, and the variables to be compared are given in [[start:​hype_file_reference:​info.txt|info.txt]]. A selection of performance criteria will be calculated for every subbasin (with observations) and printed in the [[start:​hype_file_reference:​subassx.txt|subassX.txt]] file, one subbasin per row. Example of performance criteria in [[start:​hype_file_reference:​subassx.txt|subassX.txt]];​ NSE – Nash-Sutcliffe Efficiency, CC – correlation coefficient,​ and MAE – mean absolute error. Some average performance criteria for the whole model set-up are also printed in the log-file and the [[start:​hype_file_reference:​simass.txt|simass.txt]] file. HYPE can calculate performance criteria when observations are provided, e.g file [[start:​hype_file_reference:​qobs.txt|Qobs.txt]] with observed discharge, and the variables to be compared are given in [[start:​hype_file_reference:​info.txt|info.txt]]. A selection of performance criteria will be calculated for every subbasin (with observations) and printed in the [[start:​hype_file_reference:​subassx.txt|subassX.txt]] file, one subbasin per row. Example of performance criteria in [[start:​hype_file_reference:​subassx.txt|subassX.txt]];​ NSE – Nash-Sutcliffe Efficiency, CC – correlation coefficient,​ and MAE – mean absolute error. Some average performance criteria for the whole model set-up are also printed in the log-file and the [[start:​hype_file_reference:​simass.txt|simass.txt]] file.
  
  
start/hype_tutorials/short_intro.1483022950.txt.gz · Last modified: 2023/11/16 14:28 (external edit)