6.20. urban.nml

This file contains two namelists called JULES_URBAN_SWITCHES and JULES_URBAN2T_PARAM.

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