User Tools

Site Tools


start:hype_file_reference:info.txt

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
Next revision Both sides next revision
start:hype_file_reference:info.txt [2020/12/16 09:09]
cpers [General]
start:hype_file_reference:info.txt [2021/07/05 17:11]
cpers
Line 39: Line 39:
 | ''​outstatedate all'' ​     |       | defines that a starting state will be output for every timestep of the model simulation. Default is that no output state is written. The starting states are saved in files state_saveyyyymmdd[HHMM].txt. ​                                                                                                                                                                                                            | | ''​outstatedate all'' ​     |       | defines that a starting state will be output for every timestep of the model simulation. Default is that no output state is written. The starting states are saved in files state_saveyyyymmdd[HHMM].txt. ​                                                                                                                                                                                                            |
 | ''​outstatedate period'' ​    | //​date-time//​ //​date-time// ​     | defines that starting state will be output for all time steps within the period between the given dates. The dates should be in the format yyyy-mm-dd [HH:MM]. Default is that no output state is written. The starting states are saved in files state_saveyyyymmdd[HHMM].txt. ​                                                                                                                                                                                                                              | | ''​outstatedate period'' ​    | //​date-time//​ //​date-time// ​     | defines that starting state will be output for all time steps within the period between the given dates. The dates should be in the format yyyy-mm-dd [HH:MM]. Default is that no output state is written. The starting states are saved in files state_saveyyyymmdd[HHMM].txt. ​                                                                                                                                                                                                                              |
 +| ''​instatecompress'' ​    | //​Y/​N// ​     | defines whether the starting state is an compressed file or not. Y for yes, N for no. No is default. The filename of the compressed file is the same as for the ASCII-text state file, but with different file ending (state_saveyyyymmdd[HHMM].tgz). |
 +| ''​outstatecompress'' ​    | //​Y/​N// ​     | defines whether the created outstate files are to be compressed and the text file then deleted. Y for yes, N for no. No is default. The filename of the compressed file is the same as for the ASCII-text state file, but with different file ending (state_saveyyyymmdd[HHMM].tgz). ​                                                                                                                                                                                                                               |
 | ''​resetstatedate'' ​     | //​date-time// ​      | defines that nutrient soil states will be reset to the starting state. The date should be in the format yyyy-mm-dd [HH:MM]. The default is that no reset is done. Maximum 100 dates may be given. The dates may be written on same or different rows. In the latter case, the code first on every row. The reset starting state is saved in file [[start:​hype_file_reference:​reset_state_save|reset_state_save.txt]]. ​                                                                                                                                                                                                                              | | ''​resetstatedate'' ​     | //​date-time// ​      | defines that nutrient soil states will be reset to the starting state. The date should be in the format yyyy-mm-dd [HH:MM]. The default is that no reset is done. Maximum 100 dates may be given. The dates may be written on same or different rows. In the latter case, the code first on every row. The reset starting state is saved in file [[start:​hype_file_reference:​reset_state_save|reset_state_save.txt]]. ​                                                                                                                                                                                                                              |
-| ''​substance'' ​        | //​string// ​         | gives the substances to be simulated. One or several of: //N P C S T1 T2//. N - nitrogen, P - phosphorus, C - organic carbon, S - total suspended sediment, T1 - tracer, and T2 - water temperature. Substances may be defined on one or several rows (with the code preceding the substance on each row) with one or several substances per row (separated by space). The default is to simulate no substances, only water. ​                                                                                                                                                                                                        |+| ''​substance'' ​        | //​string// ​         | gives the substances to be simulated. One or several of: //N P C S Si T1 T2//. N - nitrogen, P - phosphorus, C - organic carbon, S - total suspended sediment, Si - silica, T1 - tracer, and T2 - water temperature. Substances may be defined on one or several rows (with the code preceding the substance on each row) with one or several substances per row (separated by space). The default is to simulate no substances, only water. ​                                                                                                                                                                                                        |
 | ''​calibration'' ​      | //​Y/​N// ​            | defines whether or not automatic calibration is to be done. //Y// for calibration. Default is //N//. Calibration method and parameters are defined in file [[start:​hype_file_reference:​optpar.txt|optpar.txt]]. Note that reading of initial state does not work with automatic calibration of parameters rivvel and damp, or soilcorr. ​                                                                                                                                                                                                                                                               | | ''​calibration'' ​      | //​Y/​N// ​            | defines whether or not automatic calibration is to be done. //Y// for calibration. Default is //N//. Calibration method and parameters are defined in file [[start:​hype_file_reference:​optpar.txt|optpar.txt]]. Note that reading of initial state does not work with automatic calibration of parameters rivvel and damp, or soilcorr. ​                                                                                                                                                                                                                                                               |
 | ''​weightsub'' ​      | //​Y/​N// ​            | defines if the objective function and performance criteria should be weighted by a given trust in each subcatchment (only for criteria that are average of subbasins). Default is no.                                                                                                                                                                                                                                                               | | ''​weightsub'' ​      | //​Y/​N// ​            | defines if the objective function and performance criteria should be weighted by a given trust in each subcatchment (only for criteria that are average of subbasins). Default is no.                                                                                                                                                                                                                                                               |
Line 67: Line 69:
 | ''​indatachecklevel'' ​ | //​0-2// ​            | Printout level for verification and validation checks: 0) only passed/​failed,​ 1) also show which tests were performed, 2) also show parameters/​inputs ​                                                                                                                                                                                                                                                                                                                                                                                                                                                                               | | ''​indatachecklevel'' ​ | //​0-2// ​            | Printout level for verification and validation checks: 0) only passed/​failed,​ 1) also show which tests were performed, 2) also show parameters/​inputs ​                                                                                                                                                                                                                                                                                                                                                                                                                                                                               |
 | ''​usestop84'' ​        | //​Y/​N// ​            | flag to use the old return code 84 for a successful run                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              | | ''​usestop84'' ​        | //​Y/​N// ​            | flag to use the old return code 84 for a successful run                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              |
 +| ''​useicecurves'' ​     | //​Y/​N// ​            | defines if provided ice season river rating curves should be used (default is Y) |
 </​sortable>​ </​sortable>​
  
Line 113: Line 116:
 The principal outputs are specified with two codes in //​info.txt//,​ first code giving the output type and second specifying content options. After the codes follow the arguments. Content option codes are identical for all basic output types. All outputs are technically optional. The principal outputs are specified with two codes in //​info.txt//,​ first code giving the output type and second specifying content options. After the codes follow the arguments. Content option codes are identical for all basic output types. All outputs are technically optional.
  
-It is possible to get output for several different aggregation periods for the same type of output (basin- , class-, region- or time-output) by specifying several groups of the same type of output with ordinal number between **Code 1** and **Code 2**. See example below the table. The files will then have a suffix to their name to separate them, e.g. //​timeCRUN_DD.txt//​. If only one non-numbered group is used no meanperiod suffix will be added to the file(s). The number between **Code 1** and **Code 2** is also used to hold together classoutput information for different variables/​groups/​meanperiods.+Output can be given for each time step or aggregated to longer periods. This is specified by the code ''​meanperiod''​. For available aggregation periods see table [[info.txt#​aggregation_period_codes|below]]. The aggregation works best if it is in alignment with the simulation and output start date, e.g. yearly output that start 1 January.  
 + 
 +It is possible to get output for several different aggregation periods for the same type of output (basin- , class-, region- or time-output) by specifying several groups of the same type of output with an ordinal number between **Code 1** and **Code 2**. See example below the table. The files will then have a suffix to their name to separate them, e.g. //​timeCRUN_DD.txt//​. If only one non-numbered group is used no meanperiod suffix will be added to the file(s). The number between **Code 1** and **Code 2** is also used to hold together classoutput information for different variables/​groups/​meanperiods. Note that the ordinal number need to begin at 1 and go up, no gaps allowed.
  
  
Line 134: Line 139:
  
 === Aggregation period codes === === Aggregation period codes ===
-Aggregation ​period codes (used for ''​meanperiod''​) and corresponding file name suffix. Simulation period (''​5''​) aggregates are means of annual aggregates. ​+The table below shows aggregation ​period codes (used for ''​meanperiod''​) and corresponding file name suffix. Simulation period (''​5''​) aggregates are means of annual aggregates. ​
  
 ^ Code ^ Suffix ^ Description ^ ^ Code ^ Suffix ^ Description ^
Line 197: Line 202:
 ===== Updating options ===== ===== Updating options =====
  
-HYPE allows updating of simulated discharge and lake water level with observations during model run as well as updating of nitrogen and phosphorus concentrations using correction factors in individual subbasins. Discharge can be updated ​directly ​by discharge ​observations,​ by previously saved errors of simulated discharge, ​or previously saved errors of simulated lake water level. An auto-regressive (AR) model is used to model the errors for the last two methods. Lake water level can be updated by water level observations, or by previously saved errors of simulated lake water level+HYPE allows updating of simulated discharge and lake water level with observations during model run as well as updating of nitrogen and phosphorus concentrations using correction factors ​or observations ​in individual subbasins. Discharge can be updated by discharge or water level observations by various ​methods. Lake water level can be updated by water level observations. ​
  
-The updating methods are described ​in detail ​in the [[http://​www.smhi.net/​hype/​wiki/​doku.php?​id=start:​hype_tutorials:​updating|tutorial]]. Some updating routines require further settings in additional input file [[start:​hype_file_reference:​update.txt|update.txt]].+The updating methods are described in the [[http://​www.smhi.net/​hype/​wiki/​doku.php?​id=start:​hype_tutorials:​updating|tutorial]]. Some updating routines require further settings in an additional input file [[start:​hype_file_reference:​update.txt|update.txt]].
  
  
Line 206: Line 211:
 |''​update''​|''​quseobs''​|//​none/​keyword//​|updating of Q. Thereafter may follow one of the two keywords: '​allstation'​ for updating using all Q-stations in [[start:​hype_file_reference:​qobs.txt|Qobs.txt]] or '​nostation'​ for no updating. If no keyword is given stations given in file [[start:​hype_file_reference:​update.txt|update.txt]] is updated.| |''​update''​|''​quseobs''​|//​none/​keyword//​|updating of Q. Thereafter may follow one of the two keywords: '​allstation'​ for updating using all Q-stations in [[start:​hype_file_reference:​qobs.txt|Qobs.txt]] or '​nostation'​ for no updating. If no keyword is given stations given in file [[start:​hype_file_reference:​update.txt|update.txt]] is updated.|
 |''​update''​|''​qar''​|//​none/​keyword//​|AR updating of Q on days without observed Q. Uses the switch(1/0) on column ‘qarupd’ in [[start:​hype_file_reference:​update.txt|update.txt]] for on/off on individual stations. Can be followed by keyword '​nostation'​ for no AR updating.| |''​update''​|''​qar''​|//​none/​keyword//​|AR updating of Q on days without observed Q. Uses the switch(1/0) on column ‘qarupd’ in [[start:​hype_file_reference:​update.txt|update.txt]] for on/off on individual stations. Can be followed by keyword '​nostation'​ for no AR updating.|
 +|''​update''​|''​wendupd wstr''​|//​none/​keyword//​|updating of lake water levels from W observations. Thereafter there may follow one of the two keywords: '​allstation'​ for updating using all W-stations in [[start:​hype_file_reference:​xobs.txt|Xobs.txt]] or '​nostation'​ for no updating.|
 +|''​update''​|''​war wstr''​|//​none/​keyword//​|AR updating of lake water level used to calculate Q. The lake water state variable is not updated. Uses the switch(1/0) on column ‘warupd’ in [[start:​hype_file_reference:​update.txt|update.txt]] for on/off on individual stations. Can be followed by keyword '​nostation'​ for no AR updating|
 |''​update''​|''​cuseobs''​|//​none/​keyword//​|updating of all concentrations. Thereafter may follow one of the two keywords: '​allstation'​ for updating using all stations in [[start:​hype_file_reference:​xobs.txt|Xobs.txt]] or '​nostation'​ for no updating. If no keyword is given stations given in file [[start:​hype_file_reference:​update.txt|update.txt]] is updated.| |''​update''​|''​cuseobs''​|//​none/​keyword//​|updating of all concentrations. Thereafter may follow one of the two keywords: '​allstation'​ for updating using all stations in [[start:​hype_file_reference:​xobs.txt|Xobs.txt]] or '​nostation'​ for no updating. If no keyword is given stations given in file [[start:​hype_file_reference:​update.txt|update.txt]] is updated.|
 |''​update''​|''​tpcorr''​|//​none//​|updating of total phosphorus. No further keywords may be given. Which stations and how much is given in file [[start:​hype_file_reference:​update.txt|update.txt]].| |''​update''​|''​tpcorr''​|//​none//​|updating of total phosphorus. No further keywords may be given. Which stations and how much is given in file [[start:​hype_file_reference:​update.txt|update.txt]].|
Line 211: Line 218:
 |''​update''​|''​tncorr''​|//​none//​|updating of total nitrogen. No further keywords may be given. Which stations and how much is given in file [[start:​hype_file_reference:​update.txt|update.txt]].| |''​update''​|''​tncorr''​|//​none//​|updating of total nitrogen. No further keywords may be given. Which stations and how much is given in file [[start:​hype_file_reference:​update.txt|update.txt]].|
 |''​update''​|''​tnloccorr''​|//​none//​|updating of local nitrogen. No further keywords may be given. Which stations and how much is given in file [[start:​hype_file_reference:​update.txt|update.txt]].| |''​update''​|''​tnloccorr''​|//​none//​|updating of local nitrogen. No further keywords may be given. Which stations and how much is given in file [[start:​hype_file_reference:​update.txt|update.txt]].|
-|''​update''​|''​wendupd wstr''​|//​none/​keyword//​|updating of lake water levels from W observations. Thereafter there may follow one of the two keywords: '​allstation'​ for updating using all W-stations in [[start:​hype_file_reference:​xobs.txt|Xobs.txt]] or '​nostation'​ for no updating.| 
-|''​update''​|''​war wstr''​|//​none/​keyword//​|AR updating of lake water level used to calculate Q. The lake water state variable is not updated. Uses the switch(1/0) on column ‘warupd’ in [[start:​hype_file_reference:​update.txt|update.txt]] for on/off on individual stations. Can be followed by keyword '​nostation'​ for no AR updating| 
 </​sortable>​ </​sortable>​
  
start/hype_file_reference/info.txt.txt · Last modified: 2024/02/21 08:47 by cpers