6.3. jules_surface_types.nml

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

The surface type IDs, which were introduced in the UM in order to identify the surface types present in input and output, have been made available to standalone. The defined surface type IDs are given in the description here in brackets (#). In order to keep the GUI from appearing cluttered, the surface types have been added with compulsory=false, unless they are attached to specific science options allowing them to be triggered off, which would be the preferred method. A compulsory=false surface type, can be added and removed in the GUI window as described in the table below. To:

Add “Add latent variable” using the right click menu, which opens a list of defined surface types.
Remove “Remove” the variable using the cog menu.

Note

Please be aware that while the surface type IDs have been made available, they currently do not have any functionality and are not used by the JULES I/O yet.

6.3.1. JULES_SURFACE_TYPES namelist members

Note

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

In the original 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.

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

The number of plant functional types (PFTs) 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.

Non-vegetated surface types

A negative value, when permitted, indicates that the surface type is not in use.

JULES_SURFACE_TYPES::urban
Type:integer
Permitted:-1, npft+1:ntype
Default:-32768

Index of the urban surface type (#6).

Can only be used if l_urban2t = FALSE.

JULES_SURFACE_TYPES::lake
Type:integer
Permitted:npft+1:ntype
Default:-32768

Index of the lake surface type (#7).

JULES_SURFACE_TYPES::soil
Type:integer
Permitted:npft+1:ntype
Default:-32768

Index of the soil surface type (#8).

Note

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

JULES_SURFACE_TYPES::ice
Type:integer
Permitted:npft+1:ntype
Default:-32768

Index of the ice surface type (#9).

Note

In the UM the ice surface type must be specified (although the fraction may be set to zero).

Multiple ice tiles allowed to exist in an ice gridbox

These surface types can only be used when multiple ice tiles are allowed in a gridbox i.e. when l_elev_land_ice = TRUE.

JULES_SURFACE_TYPES::elev_ice
Type:integer
Permitted:-1,npft+1:ntype
Default:-32768

Indices of the elevated ice types (#901-925).

Must be grouped together with values npft < elev_ice <= ntype OR elev_ice = -1 to indicate they are not used (i.e. all elevated rock instead).

JULES_SURFACE_TYPES::elev_rock
Type:integer
Permitted:-1,npft+1:ntype
Default:-32768

Indices of the elevated non-glaciated bedrock types (#926-950).

Must be grouped together, with values npft < elev_rock <= ntype OR elev_rock = -1 to indicate they are not used (i.e. all elevated ice instead).

Two-tile urban schemes including MORUSES

These surface types can only be used when l_urban2t = TRUE.

JULES_SURFACE_TYPES::urban_canyon
Type:integer
Permitted:npft+1:ntype
Default:-32768

Index of the urban canyon surface type (#601).

JULES_SURFACE_TYPES::urban_roof
Type:integer
Permitted:npft+1:ntype
Default:-32768

Index of the urban roof surface type (#602).

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).

Surface types with compulsory=false

These are only used when l_surface_type_ids = TRUE and can be added as a latent variable. Remove the surface type if it is not required (see explanation at the top of this page).

JULES_SURFACE_TYPES::usr_type
Type:integer
Permitted:1:ntype
Default:-32768

Index of user specified surface type (#10-99).

A user surface type can be used when experimenting with new surface configurations without a code change. These can be either vegetated or non-vegetated and are used solely to assign an ID number.

Vegetated surface types

A negative value, when permitted, indicates that the surface type is not in use.

JULES_SURFACE_TYPES::brd_leaf
Type:integer
Permitted:1:npft
Default:-32768

Index of the original broadleaf PFT surface type (#1).

JULES_SURFACE_TYPES::brd_leaf_dec
Type:integer
Permitted:1:npft
Default:-32768

Index of broadleaf (decidous) PFT surface type (#101)

JULES_SURFACE_TYPES::brd_leaf_eg_trop
Type:integer
Permitted:1:npft
Default:-32768

Index of broadleaf (evergreen tropical) PFT surface type (#102).

JULES_SURFACE_TYPES::brd_leaf_eg_temp
Type:integer
Permitted:1:npft
Default:-32768

Index of broadleaf (evergreen temperate) PFT surface type (#103).

JULES_SURFACE_TYPES::ndl_leaf
Type:integer
Permitted:1:npft
Default:-32768

Index of original needleleaf PFT surface type (#2).

JULES_SURFACE_TYPES::ndl_leaf_dec
Type:integer
Permitted:1:npft
Default:-32768

Index of needleleaf (deciduous) PFT surface type (#201).

JULES_SURFACE_TYPES::ndl_leaf_eg
Type:integer
Permitted:1:npft
Default:-32768

Index of needleleaf (evergreen) PFT surface type (#202).

JULES_SURFACE_TYPES::c3_grass
Type:integer
Permitted:1:npft
Default:-32768

Index of original C3 grass PFT surface type (#3).

JULES_SURFACE_TYPES::c3_crop
Type:integer
Permitted:1:npft
Default:-32768

Index of C3 crop PFT surface type (#301).

JULES_SURFACE_TYPES::c3_pasture
Type:integer
Permitted:1:npft
Default:-32768

Index of C3 pasture PFT surface type (#302).

JULES_SURFACE_TYPES::c4_grass
Type:integer
Permitted:1:npft
Default:-32768

Index of original C4 grass PFT surface type (#4).

JULES_SURFACE_TYPES::c4_crop
Type:integer
Permitted:1:npft
Default:-32768

Index of C4 crop PFT surface type (#401).

JULES_SURFACE_TYPES::c4_pasture
Type:integer
Permitted:1:npft
Default:-32768

Index of C4 pasture PFT surface type (#402).

JULES_SURFACE_TYPES::shrub
Type:integer
Permitted:1:npft
Default:-32768

Index of original shrub PFT surface type (#5).

JULES_SURFACE_TYPES::shrub_dec
Type:integer
Permitted:1:npft
Default:-32768

Index of shrub (deciduous) PFT surface type (#501).

JULES_SURFACE_TYPES::shrub_eg
Type:integer
Permitted:1:npft
Default:-32768

Index of shrub (evergreen) PFT surface type (#502).