6.9. jules_rivers.nml

This file sets the river routing options. It contains one namelist called JULES_RIVERS.

Warning

The river routing code in JULES is still in development, and is available in this release to support beta testing activities.

Users should ensure that results are as expected, and provide feedback where deficiencies are identified.

Warning

River routing is not currently available as an option with JULES in parallel mode. If river routing is required, please run JULES in serial mode instead.

6.9.1. JULES_RIVERS namelist members

JULES_RIVERS::l_rivers
Type:logical
Default:F

Switch for enabling river routing.

TRUE
Use the river routing algorithm specified by rivers_type to route runoff along river pathways.
FALSE
No river routing.
JULES_RIVERS::rivers_type
Type:character
Default:rfm

Switch to select the river routing algorithm to use for river routing.

rfm

Use a standalone JULES implementation of the RFM kinematic wave model (see Dadson and Bell (2010), Bell et al. (2007)).

For standalone applications, this option should be preferred over all others if possible.

um_rfm

Use an implementation of the RFM kinematic wave model as currently implemented in the Met Office Unified Model.

This option is provided to support the transition of river routing configurations using the Unified Model to rfm.

trip

Use a standalone JULES implementation of the linear TRIP model (see Oki et al. (1999)).

This option should be preferred to um_trip.

um_trip

Use an implementation of the TRIP linear model as currently implemented in the Met Office Unified Model.

This option is provided to support the transition of river routing configurations using the Unified Model to trip (and ultimately to rfm).

JULES_RIVERS::rivers_timestep
Type:integer
Permitted:> 0
Default:-32768

The number of model timesteps per routing timestep.

For example, rivers_timestep = 5 means that runoff will be accumulated for 5 model timesteps before being routed on the 5th timestep.

Warning

The river routing parameter values can be highly dependent on model resolution, so care is required by the user to ensure that appropriate values are selected, tested and adjusted as required.

Suggested values for global and high-resolution runs are listed below, however these should be treated as a starting point.

Values for some typical configurations are included in the jules_riversparm module.

RFM parameters - used if rivers_type = rfm or um_rfm

JULES_RIVERS::cland
Type:real
Default:0.2
Suggested:0.2 (global), 0.4 (high-resolution)

The land wave speed (m s-1). See Bell et al. (2007).

JULES_RIVERS::criver
Type:real
Default:0.62
Suggested:0.62 (global), 0.5 (high-resolution)

The river wave speed (m s-1). See Bell et al. (2007).

JULES_RIVERS::cbland
Type:real
Permitted:<= cland
Default:0.1
Suggested:0.1 (global), 0.05 (high-resolution)

The subsurface land wave speed (m s-1). See Bell et al. (2007).

JULES_RIVERS::cbriver
Type:real
Permitted:<= criver
Default:0.15
Suggested:0.15 (global), 0.05 (high-resolution)

The subsurface river wave speed (m s-1). See Bell et al. (2007).

JULES_RIVERS::retl
Type:real
Permitted:0-1
Default:0.0

The (resolution dependent) land return flow fraction. See Bell et al. (2007).

JULES_RIVERS::retr
Type:real
Permitted:0-1
Default:0.005
Suggested:0.005 (global), 0.005 (high-resolution)

The (resolution dependent) river return flow fraction. See Bell et al. (2007).

JULES_RIVERS::a_thresh
Type:integer
Default:1
Suggested:1 (global), ~10 (high-resolution)

The threshold drainage area (specified in number of cells) draining to a gridbox, above which the gridbox is considered to be a river point. This is resolution dependent.

Remaining points are treated as land (drainage area = 0) or sea (drainage area < 0). See Bell et al. (2007).

JULES_RIVERS::runoff_factor
Type:real
Default:1.0

A runoff volume factor used in the um_rfm implementation. It is highly recommended that this is set to 1.0 (i.e. no runoff adjustment).

TRIP parameters - used if rivers_type = trip or um_trip

JULES_RIVERS::rivers_speed
Type:real
Default:0.4

The effective river velocity (m s-1). See Oki et al. (1999).

JULES_RIVERS::rivers_meander
Type:real
Default:1.4

The ratio of the actual to calculated river lengths in a river routing gridbox. See Oki et al. (1999).

See also

References:

  • Bell, V.A. et al. (2007) Development of a high resolution grid-based river flow model for use with regional climate model output. Hydrology and Earth System Sciences. 11 532-549
  • Dadson, S.J. and Bell, V.A. (2010) Comparison of Grid-2-Grid and TRIP runoff routing schemes. Centre for Ecology & Hydrology Internal Report http://nora.nerc.ac.uk/10890/1/dadson_etal_2010_g2gtrip.pdf
  • Dadson S.J. et al. (2011) Evaluation of a grid-based river flow model configured for use in a regional climate model. Journal of Hydrology. 411 238-250
  • Falloon, P.D. et al (2007) New global river routing scheme in the Unified Model. Hadley Centre Technical Note 72 http://www.metoffice.gov.uk/media/pdf/6/m/HCTN_72_v2.pdf
  • Jones R., Dadson, S. and Bell, V.A. (2007) Report on European grid-based river-flow modelling for application to Regional Climate Models. Met Office Hadley Centre deliverable report.
  • Oki, T., et al (1999) Assessment of annual runoff from land surface models using Total Runoff Integrating Pathways (TRIP). Journal of the Meteorological Society of Japan. 77 235-255