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 and are used to check the surface type configuration at runtime, they are not yet used by the JULES I/O.
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 <= ntypeORelev_ice = -1to 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 <= ntypeORelev_rock = -1to 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 required to allow the surface type configuration to be checked at runtime and for surface types to be identified in the output headers. These are 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).
