Please note that the content of the MESH User Support space continues to be updated as we transition to new tools.
Support and contact: MESH@ec.gc.ca | GitHub: https://github.com/MESH-Model
MESH_parameters_hydrology.ini
Overview
MESH_parameters_hydrology.ini contains four sections: Option flags, River roughness factors, hydrologic parameters that are not tied to any one GRU, and hydrologic parameters that are tied to GRUs.
Consult the Parameters Selection page for more information about specific parameters and recommended parameter values.
This page contains the following sections:
Sample File
Download a sample MESH_parameters_hydrology.ini file.
Header Information
Header information is stored in the first line of the file.
Line | Column | Variable | Format | Type | Description | Units |
---|---|---|---|---|---|---|
1 | 1 | FILE_VER | a8 | Char | Version of the file; newer versions of the code may use a newer version of the file | -- |
Option Flags
Option flags are listed immediately following the section of Header Information. The section begins with two comment lines.
Line | Column | Variable | Format | Type | Description | Units |
---|---|---|---|---|---|---|
4 | 1 | OPTFLAGS | * | Int | Number of option flags to read from the file | -- |
5+ | 1 | -- | * | -- | (No option flags currently exist) | -- |
Notes:
+A new line is read for as many option flags as are defined by OPTFLAGS.
Format=* denotes free-formatting; all values are to be separated by one or more spaces.
Option flags
There are no option flags currently in use by the model.
River Roughness Coefficients for Channel Routing
River roughness coefficients are listed immediately following the section of Option Flags. The section begins with two comment lines.
River Classification
Values for all five river classes must exist and be greater than zero, even if only one river class is used. River classes are defined by "IAK" in MESH_drainage_database.txt. In many cases, only one river class is active and only the first WF_R2 value is used.
Line | Column | Variable | Format | Type | Description | Units |
---|---|---|---|---|---|---|
8 | 1-5 | WF_R2 | * | Real | River channel roughness factor for channel routing, which incorporates a channel shape and width to depth ratio as well as Manning's n; typical values range from 0.3 to 1.0; a higher number corresponds to an increased river roughness | s m-1/3 |
Notes:
Format=* denotes free-formatting; all values are to be separated by one or more spaces.
GRU-Independent Hydrologic Parameters
Hydrologic parameters that are not tied to any one GRU are listed immediately following the section of River Roughness Coefficients. The section beings with two comment lines.
Hydrologic parameters and Control Flags
Many of the hydrologic parameters are tied to and only enabled when certain Control Flags are enabled.
Line | Column | Variable | Format | Type | Control Flag | Description | Units |
---|---|---|---|---|---|---|---|
11 | 1 | INDEPPAR | * | Int | -- | Number of GRU-independent hydrologic parameters to read from file | -- |
12 | 1 | SOIL_POR_MAX | * | Real | FROZENSOILINFILFLAG | Maximum porosity of the soil | -- |
13 | 1 | SOIL_DEPTH | * | Real | FROZENSOILINFILFLAG | Maximum permeable depth of the soil (of the rooting zone) | m |
14 | 1 | S0 | * | Real | FROZENSOILINFILFLAG | Maximum saturation of the soil during melt; from 0.75-1.0 | mm3 mm-3 |
15 | 1 | T_ICE_LENS | * | Real | FROZENSOILINFILFLAG | Minimum temperature to allow formation of an ice sheet at the surface of the soil; from -50.0-0.0 | deg C |
16+ | 1 | t0_ACC | * | Real | FROZENSOILINFILFLAG | Opportunity time of infiltration into the frozen or freezing soil; one is required for as many years as are simulated; set to 0.0 to allow the model to calculate this | hr |
Notes:
+A parameter to t0_ACC is required for as many years as are simulated, even if set to 0.0.
+A new line is read for as many GRU-independent hydrologic parameters as are defined by INDEPPAR.
Format=* denotes free-formatting; all values are to be separated by one or more spaces.
FROZENSOILINFILFLAG
See also the FROZENSOILINFILFLAG control flag.
GRU-Dependent Hydrologic Parameters
Hydrologic parameters that are tied to the GRUs defined by MESH_parameters_CLASS.ini are listed immediately following the section of GRU-Independent Hydrologic Parameters. The section begins with two comment lines.
Hydrologic parameters and Control Flags
Many of the hydrologic parameters are tied to and only enabled when certain Control Flags are enabled.
Line | Column | Variable | Format | Type | Control Flag | Description | Units |
---|---|---|---|---|---|---|---|
19 | 1 | DEPPAR | * | Int | -- | Number of GRU-dependent hydrologic parameters to read from file | -- |
20 | 1 | NM | * | Int | -- | Number of GRUs; must match NM from MESH_parameters_CLASS.ini | -- |
The section contains one intermediary comment line.
Line | Column | Variable | Format | Type | Control Flag | Description | Units |
---|---|---|---|---|---|---|---|
22 | 1-((NM)) | ZSNL, SNOLIM | * | Real | -- | Minimum depth to consider 100% cover of snow on the ground surface | m |
23 | 1-((NM)) | ZPLS, ZPLMS0, ZPLMCS/GS | * | Real | -- | Maximum depth of liquid water allowed to be stored on the ground surface for snow-covered areas | m |
24 | 1-((NM)) | ZPLG, ZPLMG0, ZPLIMC/G | * | Real | -- | Maximum depth of liquid water allowed to be stored on the ground surface for snow-free areas | m |
25 | 1-((NM)) | FRZC | * | Real | FROZENSOILINFILFLAG | Coefficient of the equation for the infiltration of meltwater into frozen or freezing soils; from 1-3 | -- |
26 | 1-((NM)) | CMAX | * | Real | IWF (PDMROF) | Maximum storage | m |
27 | 1-((NM)) | CMIN | * | Real | IWF (PDMROF) | Minimum storage capacity | m |
28 | 1-((NM)) | B | * | Real | IWF (PDMROF) | Shape factor | -- |
29 | 1-((NM)) | K1 | * | Real | IWF (PDMROF) | Time constant for the first linear reservoir | hr |
30 | 1-((NM)) | K2 | * | Real | IWF (PDMROF) | Time constant for the second linear reservoir | hr |
31 | 1-((NM)) | fetch | * | Real | PBSMFLAG | ? | ? |
32 | 1-((NM)) | Ht | * | Real | PBSMFLAG | ? | ? |
33 | 1-((NM)) | N | * | Real | PBSMFLAG | ? | ? |
34 | 1-((NM)) | A | * | Real | PBSMFLAG | ? | ? |
35+ | 1-((NM)) | Distrib | * | Real | PBSMFLAG | ? | ? |
Notes:
+A new line is read for as many GRU-independent hydrology parameters as are defined by DEPPAR.
Column=1-((NM)) symbolizes that as many columns are expected to exist as there are GRUs defined in MESH_parameters_CLASS.ini.
Format=* denotes free-formatting; all values are to be separated by one or more spaces.
PDMROF GRU-Dependent Parameters
Note in versions of this page prior to July 30, 2015, there was an error in the ordering of the PDMROF variables in the GRU-dependent parameter section, particularly of the CMAX and B parameters. This page and its excerpts of the sample file were corrected to match the proper ordering of the variables, as they are read in the code.
FROZENSOILINFILFLAG
See also the FROZENSOILINFILFLAG control flag.
PBSMFLAG
See also the PBSMFLAG control flag.