6.19. urban.nml

This file contains three namelists called JULES_URBAN_SWITCHES, JULES_URBAN2T_PARAM and URBAN_PROPERTIES.

This section reads in model configuration choices, geometry & material characteristics data for the urban schemes URBAN-2T and MORUSES. Both these schemes must have an urban_roof tile and an urban_canyon tile. Values from this section are only used if either of the two-tile urban schemes are enabled by specifying an urban_roof tile.

For parameters that MORUSES does not parameterise, and for any MORUSES parametrisations that are turned off, values from nveg_params.nml will be used. See the switches below for more information.

Further information on MORUSES, including references, can be found in the technical documentation and under l_moruses.

6.19.1. JULES_URBAN_SWITCHES namelist members

JULES_URBAN_SWITCHES::l_moruses
Type:logical
Default:F

Note

Not used unless an urban_roof tile is present.

Switch for turning on MORUSES.

TRUE
Use MORUSES parameterisations.
FALSE
Do not use MORUSES parameterisations. Use urban tile parameters, set in nveg_params.nml, instead.

See also

References:

  • Porson, A., et al. (2010), Implementation of a new urban energy budget scheme in the MetUM. Part I: Description and idealized simulations, Quarterly Journal of the Royal Meteorological Society, 136: 1514-1529. doi: 10.1002/qj.668
  • Porson, A., et al. (2010), Implementation of a new urban energy budget scheme into MetUM. Part II: Validation against observations and model Intercomparison, Quarterly Journal of the Royal Meteorological Society, 136: 1530-1542. doi: 10.1002/qj.572
JULES_URBAN_SWITCHES::l_urban_empirical
Type:logical
Default:T

Switch to use empirical relationships for urban geometry, based on total urban fraction. Dimensions calculated are W/R, H/W & H.

URBAN-2T uses W/R only.

Used in calculation of the canyon and roof fractions and also to distribute anthropogenic heat between roof and canyon if l_anthrop_heat_src = TRUE.

TRUE
Use empirical relationships for urban geometry.
FALSE
Appropriate data needs to be supplied instead.

Warning

These are only valid for high resolutions (~1 km).

See also

References:

  • Bohnenstengel SI, Evans S, Clark P, Belcher SE (2010). Simulations of the London urban heat island, Quarterly Journal of the Royal Meteorological Society (submitted)
JULES_URBAN_SWITCHES::l_moruses_macdonald
Type:logical
Default:T

MORUSES switch for using MacDonald et al. (1998) to calculate effective roughness length of urban areas and displacement height from urban geometry.

TRUE
Use MacDonald et al. (1998) formulations.
FALSE
Appropriate data needs to be supplied instead.

Note

If l_urban_empirical = TRUE then l_moruses_macdonald = TRUE, which the code enforces.

See also

References:

  • Macdonald RW, Griffiths RF, Hall D. 1998. An improved method for the estimation of surface roughness of obstacle arrays. Atmos. Env. 32: 1857-1864
JULES_URBAN_SWITCHES::l_moruses_albedo
Type:logical
Default:T

MORUSES switch for effective canyon albedo parameterisation.

TRUE
Use MORUSES parameterisation. Requires that l_cosz = TRUE, which the code automatically enables.
FALSE
The canyon albedo is taken from albsnf_nvg_io and albsnc_nvg_io.

In all cases, the roof albedo is taken from albsnf_nvg_io and albsnc_nvg_io.

JULES_URBAN_SWITCHES::l_moruses_emissivity
Type:logical
Default:F

MORUSES switch for effective canyon emissivity parameterisation.

TRUE
Use MORUSES parameterisation.
FALSE
The canyon emmissivity is taken from emis_nvg_io.

In all cases, the roof emissivity is taken from emis_nvg_io.

JULES_URBAN_SWITCHES::l_moruses_rough
Type:logical
Default:T

MORUSES switch for effective roughness length for heat parameterisation.

TRUE
Use MORUSES parameterisation for canyon and roof.
FALSE
Values for canyon and roof are taken from z0_nvg_io and z0hm_nvg_io.
JULES_URBAN_SWITCHES::l_moruses_storage
Type:logical
Default:T

MORUSES switch for thermal inertia and coupling with underlying soil parameterisation.

TRUE
Use MORUSES parameterisation.
FALSE
Values are taken from ch_nvg_io and vf_nvg_io.
JULES_URBAN_SWITCHES::l_moruses_storage_thin
Type:logical
Default:T

MORUSES switch to use a thin roof to simulate the effects of insulation.

Only used if l_moruses_storage = TRUE.

TRUE
Use thin, insulated roof.
FALSE
Use damping depth diffusivity of roofing materials.

6.19.2. JULES_URBAN2T_PARAM namelist members

JULES_URBAN2T_PARAM::anthrop_heat_scale
Type:real
Default:1.0

Distribution scaling factor, which allows the anthropogenic heat flux to be spread between the urban_canyon and urban_roof tiles such that:

  • H_roof = anthrop_heat_scale x H_canyon
  • H_canyon x (W/R) + H_roof x ( 1.0 - W/R ) = anthrop_heat

Has a value between 0.0 and 1.0 where the extremes correspond to:

  • 0.0 = all released within the canyon.
  • 1.0 = evenly spread between canyon and roof.

Only used if l_anthrop_heat_src = TRUE.

6.19.3. URBAN_PROPERTIES namelist members

URBAN_PROPERTIES::file
Type:character
Default:None

The file to read urban properties from.

If use_file (see below) is FALSE for every variable, this will not be used.

This file name can use variable name templating.

URBAN_PROPERTIES::nvars
Type:integer
Permitted:>= 0
Default:0

The number of urban property variables that will be provided.

The required variables depend on whether MORUSES is used or not:

  • If MORUSES is on, all variables must be given. However, depending on the configuration of MORUSES, not all given variables will be used. Those that will not be used could be set to constant values to avoid setting them from file.
  • If MORUSES is not on, only wrr is required.
URBAN_PROPERTIES::var
Type:character(nvars)
Default:None

List of urban property variable names as recognised by JULES (see List of urban properties). Names are case sensitive.

Note

For ASCII files, variable names must be in the order they appear in the file.

URBAN_PROPERTIES::use_file
Type:logical(nvars)
Default:T

For each JULES variable specified in var, this indicates if it should be read from the specified file or whether a constant value is to be used.

TRUE
The variable will be read from the file.
FALSE
The variable will be set to a constant value everywhere using const_val below.
URBAN_PROPERTIES::var_name
Type:character(nvars)
Default:‘’ (empty string)

For each JULES variable specified in var where use_file = TRUE, this is the name of the variable in the file containing the data.

If the empty string (the default) is given for any variable, then the corresponding value from var is used instead.

This is not used for variables where use_file = FALSE, but a placeholder must still be given.

Note

For ASCII files, this is not used - only the order in the file matters, as described above.

URBAN_PROPERTIES::tpl_name
Type:character(nvars)
Default:None

For each JULES variable specified in var, this is the string to substitute into the file name in place of the variable name substitution string.

If the file name does not use variable name templating, this is not used.

URBAN_PROPERTIES::const_val
Type:real(nvars)
Default:None

For each JULES variable specified in var where use_file = FALSE, this is a constant value that the variable will be set to at every point in every layer.

This is not used for variables where use_file = TRUE, but a placeholder must still be given.

6.19.3.1. List of urban properties

All of the urban property variables listed below are expected to have no levels dimensions and no time dimension.

Variable name Decription [*] Notes
wrr Repeating width ratio (or canyon fraction, W/R) If l_urban_empirical = TRUE then this is updated with calculated values.
The following apply to MORUSES only
hwr Height-to-width ratio (H/W) See for wrr above.
hgt Building height (H) See for wrr above.
ztm Effective roughness length of urban areas If l_moruses_macdonald = TRUE (or l_urban_empirical = TRUE), then this is updated with calculated values.
disp Displacement height See for ztm above.
albwl Wall albedo Data only used if l_moruses_albedo = TRUE.
albrd Road albedo See for albwl above.
emisw Wall emissivity Data only used if l_moruses_emissivity = TRUE.
emisr Road emissivity See for emisw above.

Footnotes

[*]For more information on the urban geometry used please see the JULES technical documentation.