/lausanne-heat-islands

Simulation of urban heat islands in Lausanne with the InVEST urban cooling model

Primary LanguageJupyter NotebookGNU General Public License v3.0GPL-3.0

GitHub license

Lausanne heat islands

A reusable computational workflow to use the InVEST urban cooling model to simulate urban heat islands, illustrated with an example application to the Swiss urban agglomeration of Lausanne.

Citation: Bosch, M., Locatelli, M., Hamel, P., Remme, R. P., Chenal, J., and Joost, S. 2021. "A spatially-explicit approach to simulate urban heat mitigation with InVEST (v3.8.0)". Geoscientific Model Development 14(6), 3521-3537. 10.5194/gmd-14-3521-2021

Example figure

Instructions to reproduce

The computational workflow to reproduce the results makes use of a Makefile which orchestrates the execution of all the steps to transform the raw data into tables and figures1. To reproduce the computational workflow in your computer, you can follow the steps below:

  1. Clone the repository and change the working directory to the repository's root:
git clone https://github.com/martibosch/lausanne-heat-islands
cd lausanne-heat-islands
  1. Create the environment (this requires conda) and activate it:
conda env create -f environment.yml
# the above command creates a conda environment named `lausanne-heat-islands`
conda activate lausanne-heat-islands
  1. Register the IPython kernel of the lausanne-heat-islands environment:
python -m ipykernel install --user --name lausanne-heat-islands --display-name \
    "Python (lausanne-heat-islands)"
  1. You can use make to download the data data required to reproduce the results (which is available at a dedicated Zenodo repository) as in:
make download_zenodo_data
  1. Finally, you can launch a Jupyter Notebook server and generate the tables and figures interactively by executing the notebooks of the notebooks directory. The first cell of each notebook features a call to a target of the Makefile, which will download and process all the data required to execute the subsequent cells. The following notebooks are provided:

Notes

  1. Many of the datasets used here are open and therefore all the processing steps can be reproduced by anyone. However, some other datasets are proprietary and thus cannot be shared openly. In the latter case, in order to allow the maximum reproducibility of our results, the following interim files are provided:

    • station-tair.csv: temperature measurements at the monitoring stations for the reference dates
    • ref-et.nc: reference evapotranspiration raster for the reference dates
    • bldg-cover.tif: raster with the percentage of building cover in each pixel of the Lausanne agglomeration

    The sources for the first two files are detailed at the Zenodo repository for this paper, whereas the source of bldg-cover.tif is detailed at 10.5281/zenodo.4314832. If you use these files, their sources must be properly acknowledged.

See also

Acknowledgments