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.

JULES_SURFACE_TYPES::urban
Type:integer
Default:-32768

Index of the urban surface type.

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.

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::urban_canyon
Type:integer
Default:-32768

Index of the urban canyon surface type.

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.

A negative value indicates no urban roof surface type.

Note

The values of urban, urban_canyon and urban_roof are used to determine what urban scheme to use.

  • At most one of urban and urban_canyon can be given.
  • If urban_roof is present, then JULES will use one of the 2-tile urban schemes (and so either urban or urban_canyon must be present, and will represent the urban canyon surface type).
  • If urban_roof is not present, urban_canyon cannot be given and, if present, urban is used as the single urban surface type.

When giving urban fraction data (see JULES_FRAC), total urban fraction should be given in the urban or urban_canyon tile, whichever is present. This is partitioned internally into roof and canyon.