README.md

WUDAPT-to-COSMO

Set of tools to use Local Climate Zone (LCZ)-based urban canopy parameters in DWD's COSMO-CLM NWP and regional climate model.

Citaton

Varentsov, M., Samsonov, T., Demuzere, M., (2020). Impact of urban canopy parameters on a megacity’s modelled thermal environment. Atmosphere 11(12), 1349; https://doi.org/10.3390/atmos11121349.

Context

TERRA_URB is the urban canopy parameterization embedded in TERRA-ML, the land surface model in COSMO-CLM. By default it uses impervious surface area information from the Copernicus Land Monitoring Service (for Europe) / National Geophysical Data Center (global) and anthropogenic heat flux information from Flanner et al. (2010). All other geometrical, thermal and radiative urban canopy parameters are spatially invariant, and set to the bulk values provided in Table 1 of Wouters et al., 2016).

The set of tools provided in this repo allow one to introduce LCZ-based urban canopy parameters, compiled from Stewart and Oke (2012) and Stewart et al. (2014).

This work is an outcome of AEVUS I and II, the COSMO Priority Tasks on "Analysis and evaluation of the TERRA_URB scheme". More info here (project pages only accessible to COSMO members). Preliminary test results of LCZ parameters in COSMO-CLM are also described in Brousse et al. (2019, 2020) and Van de Walle et al. (2021).

Requirements

• Be a member of the COSMO-CLM community, in order to be able to access EXTPAR.
• Have your domain file available from EXTPAR (netcdf file)
• an LCZ map covering the same region of interest. Sources for existing LCZ maps:
  • Global: paper | data
  • Europe: paper | data
  • Continental United States: paper | data
  • Via the LCZ Generator.

Instructions

It is advised to use a python virtual environment:

1. Go into scriptdir: cd /SCRIPT/DIR/
2. Create virtual environment: python3 -m venv venv or virtualenv venv
3. Install module requirements: venv/bin/pip install -r requirements.txt
4. Use venv/bin/python to run scripts.

The requirements.txt can be generated using pipreqs:

cd /SCRIPT/DIR/
pipreqs --ignore=terra/ .

Execute

The run code is currently configured for the Moscow case, as developed in Varentsov et al. CLM and LCZ input data used in this study is provided under data/.

venv/bin/pip/python run.py