6.7. jules_soil.nml

This file sets the soil options and parameters. It contains one namelist called JULES_SOIL.

6.7.1. JULES_SOIL namelist members

JULES_SOIL::sm_levels
Type:integer
Permitted:>= 1
Default:4

Number of soil layers.

A value of 4 is often used, and the soil layer depths in the examples have been tuned using this.

Warning

If ncpft > 0, sm_levels >= 3 is required.

JULES_SOIL::l_vg_soil
Type:logical
Default:F

Switch for van Genuchten soil hydraulic model.

TRUE
Use van Genuchten model.
FALSE
Use Brooks and Corey model [*].

See also

References:

  • Brooks, R.H. and A.T. Corey, 1964, Hydraulic properties of porous media. Colorado State University Hydrology Papers 3.
  • van Genuchten, M.T., 1980, A Closed-form Equation for Predicting the Hydraulic Conductivity of Unsaturated Soils. Soil Science Society of America Journal, 44:892-898.
JULES_SOIL::l_dpsids_dsdz
Type:logical
Default:F

Switch to calculate vertical gradient of soil suction with the assumption of linearity only for fractional saturation (consistent with the calculation of hydraulic conductivity).

JULES_SOIL::l_soil_sat_down
Type:logical
Default:F

Switch for dealing with supersaturated soil layers. If a soil layer becomes supersaturated, the water in excess of saturation will be put into the layer below or above according to this switch.

TRUE
Any excess is put into the layer below. Any excess from the bottom layer becomes subsurface runoff.
FALSE
Any excess is put into the layer above. Any excess from the top layer becomes surface runoff. This option was used in JULES2.0.
JULES_SOIL::soilhc_method
Type:integer
Permitted:1 or 2
Default:1

Switch for soil thermal conductivity model.

  1. Use approach of Cox et al (1999), as in JULES2.0.
  2. Use approach of Johansen (1975).
JULES_SOIL::cs_min
Type:real
Default:1.0e-6

Minimum allowed soil carbon (kg m-2).

JULES_SOIL::zsmc
Type:real
Permitted:> 0
Default:1.0

If a depth-averaged soil moisture diagnostic is requested, the average is calculated from the surface to this depth (m).

JULES_SOIL::zst
Type:real
Permitted:> 0
Default:1.0

If a depth-averaged soil temperature diagnostic is requested, the average is calculated from the surface to this depth (m).

JULES_SOIL::confrac
Type:real
Permitted:0 <= confrac <= 1
Default:0.3

The fraction of the gridbox assumed to be covered by convective precipitation.

JULES_SOIL::dzsoil_io
Type:real(sm_levels)
Default:None

The soil layer depths (m), starting with the uppermost layer.

Note that the soil layer depths (and hence the total soil depth) are constant across the domain.

In all the examples, JULES uses layer depths of 0.1, 0.25, 0.65 and 2.0m, giving a total depth of 3.0m. It is recommended that this is used unless there is good reason not to.

Footnotes

[*]

In the JULES2.0 User Manual this was described as the ‘Clapp and Hornberger’ model and the JULES code still refers to ‘Clapp and Hornberger’ rather than ‘Brooks and Corey’. In fact there are important differences between these two hydraulic models (Toby Marthews, pers comm.). There has been confusion in the literature and in past documentation of MOSES/JULES, resulting in these differences often being ignored, but JULES uses the Brooks and Corey model. Hopefully this confusion will be removed from future releases.

Reference: Clapp, R.B. and G.M.Hornberger, 1978, Empirical Equations for Some Soil Hydraulic Properties. Water Resources Research 14:601-604.