6.3. jules_surface_types.nml

This file configures the surface types used by JULES. It contains one namelist called JULES_SURFACE_TYPES.

6.3.1. JULES_SURFACE_TYPES namelist members

JULES_SURFACE_TYPES::npft
Type:integer
Permitted:>= 1
Default:-32768

The number of plant functional types to be modelled.

JULES_SURFACE_TYPES::ncpft
Type:integer
Permitted:< npft
Default:0

The number of crop plant functional types to be modelled.

JULES_SURFACE_TYPES::nnvg
Type:integer
Permitted:>= 1
Default:-32768

The number of non-plant surface types to be modelled.

Note

The total number of surface types to be modelled is called ntype, and is given by ntype = npft + nnvg.

In the standard setup, JULES models 5 vegetation types and 4 non-vegetation types (npft = 5, nnvg = 4). However, the model domain need not contain all 9 types, e.g. the domain could consist of a single point with 100% grass. The amount of each type in the domain is normally set in JULES_FRAC.

If the crop model is active (i.e. ncpft > 0), then nnpft = npft - ncpft where nnpft is the number of natural PFTs.

Vegetation surfaces must always be present first in any list of surfaces.

Non-vegetated surface types

The indices for the non-veg surface types must be > npft & <= ntype.

JULES_SURFACE_TYPES::urban
Type:integer
Default:-32768

Index of the urban surface type. Can only use if l_urban2t = FALSE.

A negative value indicates no urban surface type.

JULES_SURFACE_TYPES::lake
Type:integer
Default:-32768

Index of the lake surface type.

A negative value indicates no lake surface type.

JULES_SURFACE_TYPES::soil
Type:integer
Permitted:>= 1
Default:-32768

Index of the soil surface type.

Note

A soil surface type must be given (although the fraction may be set to zero).

JULES_SURFACE_TYPES::ice
Type:integer
Default:-32768

Index of the ice surface type.

A negative value indicates no ice surface type.

JULES_SURFACE_TYPES::elev_ice
Type:integer
Default:-32768

Indices of the elevated ice types if multiple ice tiles are allowed in a gridbox - only set if l_elev_land_ice = TRUE.

JULES_SURFACE_TYPES::elev_rock
Type:integer
Default:-32768

Indices of the elevated non-glaciated bedrock types if multiple ice tiles are allowed in a gridbox - only set if l_elev_land_ice = TRUE.

JULES_SURFACE_TYPES::urban_canyon
Type:integer
Default:-32768

Index of the urban canyon surface type. Can only use if l_urban2t = TRUE.

A negative value indicates no urban canyon surface type.

JULES_SURFACE_TYPES::urban_roof
Type:integer
Default:-32768

Index of the urban roof surface type. Can only use if l_urban2t = TRUE.

A negative value indicates no urban roof surface type.

Note

When giving urban fraction data (see JULES_FRAC), total urban fraction may be given instead of the separate canyon and roof fractions by entering it under the canyon fraction. When initialising if the roof fraction is zero, the canyon fraction will be interpreted as the total urban fraction and be partitioned according to the canyon fraction (W/R, see URBAN_PROPERTIES).