MESH_parameters_hydrology.ini

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

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

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

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

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

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

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.

 

 

Related content