6.17. jules_water_resources.nml

This file sets options for water resource modelling. It contains a single namelist called JULES_WATER_RESOURCES.

Warning

The water resource code in JULES is still in development. A limited parameterisation exists but it should be used with caution while development continues. At present all demands for water can only be met by abstraction from the same gridbox as where the demand is, which can lead to unrealistically high estimates of water shortage where in reality water infrastructure is used to move water between locations. Consult the developers for further information.

6.17.1. JULES_WATER_RESOURCES namelist members

JULES_WATER_RESOURCES::l_water_resources

Type:

logical

Default:

F

Switch to enable modelling of water resources.

TRUE

Water resources are modelled. This also requires that river routing is selected (l_rivers = TRUE).

FALSE

No water resources. In this case no further values from this namelist are required.

JULES_WATER_RESOURCES::nstep_water_res

Type:

integer

Permitted:

> 0

Default:

none

The number of model timesteps per water resource timestep. (The main model timestep is given by timestep_len.)

For example, nstep_water_res = 12 means that demands for water will be accumulated over 12 model timesteps before the water resource code is called on the 12th timestep.

The water resource and river routing models must be in synchrony (i.e. be called on the same timesteps).

Switches that control which water sectors are considered.

JULES_WATER_RESOURCES::l_water_domestic

Type:

logical

Default:

F

Switch for modelling of water for domestic use.

TRUE

Consider demand for water for domestic use. This requires that the domestic demand is prescribed as an input to the model (see prescribed_data.nml).

FALSE

Do not consider domestic demand.

JULES_WATER_RESOURCES::l_water_environment

Type:

logical

Default:

F

Switch for modelling of water for environmental flow requirements.

TRUE

Consider demand for water for environmental flows. This option is not allowed until further developments are complete.

FALSE

Do not consider environmental demand.

Note

At present l_water_environment must be FALSE as the parameterisation is not yet complete. In the meanwhile this switch is provided to allow the developers to test code.

JULES_WATER_RESOURCES::l_water_industry

Type:

logical

Default:

F

Switch for modelling of water for industrial use. This requires that the industrial demand is prescribed as an input to the model (see prescribed_data.nml).

TRUE

Consider demand for water for industrial use.

FALSE

Do not consider industrial demand.

JULES_WATER_RESOURCES::l_water_irrigation

Type:

logical

Default:

F

Switch for modelling of water for irrigation.

TRUE

Consider demand for water for irrigation. This must be used with l_irrig_dmd = TRUE (to activate the inclusion of irrigation in other aspects of the model) and l_irrig_limit = FALSE (to avoid triggering an alternative approach to calculating the water available for irrigation).

FALSE

Do not consider irrigation demand.

JULES_WATER_RESOURCES::l_water_livestock

Type:

logical

Default:

F

Switch for modelling of water for livestock.

TRUE

Consider demand for water for livestock. This requires that the livestock demand is prescribed as an input to the model (see prescribed_data.nml).

FALSE

Do not consider livestock demand.

JULES_WATER_RESOURCES::l_water_transfers

Type:

logical

Default:

F

Switch for modelling of water for transfers.

TRUE

Consider demand for water for transfers. This requires that the demand for transfers is prescribed as an input to the model (see prescribed_data.nml). This option is not allowed until further developments are complete.

FALSE

Do not consider transfers.

Note

At present l_water_transfers must be FALSE as the parameterisation is not yet complete. In the meanwhile this switch is provided to allow the developers to test code.

Switches that control prioritisation of demands.

JULES_WATER_RESOURCES::l_prioritise

Type:

logical

Default:

F

Switch controlling prioritisation of demands.

TRUE

Rank demands from sectors in priority order.

FALSE

No prioritisation. No further items from this group are required.

JULES_WATER_RESOURCES::priority

Type:

character

Default:

none

A list of water sector names, in order of decreasing priority - see the table below for valid names. Only used if l_prioritise = TRUE. All active sectors (as selected by switches such as l_water_domestic) must be represented in this list. The same prioritisation is used for all points in the domain.

Name	Description
dom	Domestic use
env	Environmental flows
ind	Industrial use
irr	Irrigation
liv	Livestock use
tra	Water transfers

JULES_WATER_RESOURCES::nr_gwater_model

Type:

integer

Permitted:

0,1,2

Default:

none

Choice for the model of non-renewable groundwater. Non-renewable groundwater as defined here is water that is not otherwise explicitly included in the model. It is an idealised, infinite source of water which is typically intended to allow consideration of pumping of groundwater from deep reserves that are difficult to quantify.

Possible values are:

0. No non-renewable groundwater is considered.
1. Non-renewable groundwater is used as a last resort, when no other sources of water are available.
2. Non-renewable groundwater is used as as ‘part of the mix’, in conjunction with other sources of water.

Switches that control how surface and groundwater sources are used.

JULES_WATER_RESOURCES::partition_method

Type:

integer

Permitted:

0,1,2

Default:

none

Method used to calculate the target for the fraction of demand that will be met from surface water versus groundwater.

Possible values are:

0. No target required. This value is required when either or both of groundwater and surface water are not included in the model configuration.
1. The target will be read from an ancillary file (see JULES_WATER_RESOURCES_PROPS).
2. The target will be calculated based on the current availability of water in surface and groundwater stores, using parameter sfc_water_factor.

JULES_WATER_RESOURCES::sfc_water_factor

Type:

real

Permitted:

>= 0

Default:

none

The weight (a factor) applied to surface water when calculating the target for the fraction of demand that will be met from surface water. The target is calculated as sfc_water_factor x surface_water_available / ( sfc_water_factor x surface_water_available + groundwater_available ). Values > 1 mean the target will increasingly be to use surface water rather than groundwater.

JULES_WATER_RESOURCES::rf_domestic

Type:

real

Permitted:

0-1

Default:

none

The fraction of water that is returned after abstraction for domestic use (via sewage systems etc.). Only used if l_water_domestic = TRUE.

JULES_WATER_RESOURCES::rf_industry

Type:

real

Permitted:

0-1

Default:

none

The fraction of water that is returned after abstraction for industrial use. Only used if l_water_industry = TRUE.

JULES_WATER_RESOURCES::rf_livestock

Type:

real

Permitted:

0-1

Default:

none

The fraction of water that is returned after abstraction for livestock. Only used if l_water_livestock = TRUE.