Is your European region able to provide itself with 100% renewable electricity?
This repository contains the entire research project, including code and report. The philosophy behind this repository is that no intermediary results are included, but all results are computed from raw data and code.
The following dependencies are needed to set up an environment in which the analysis can be run and the paper be build:
When these dependencies are installed, you can create a conda environment from within you can run the analysis:
conda env create -f environment.yaml
Don't forget to activate the environment. To see what you can do now, run:
snakemake --list
Whenever possible, data is downloaded automatically. As this is not always possible, you will need to retrieve the following data sets manually:
- European Settlement Map 2012, Release 2017, 100m, to be placed at
./data/esm-100m-2017/
- World Exclusive Economic Zones v10, to be placed in
./data/World_EEZ_v10_20180221
- capacity factors from renewable.ninja, to be placed in
./data/capacityfactors/{technology}.nc
for technology in ["wind-onshore", "wind-offshore", "rooftop-pv", "open-field-pv"] (where "open-field-pv" and "rooftop-pv" can be the same dataset and hence can be linked instead of copied)(to run simulations, seeManual steps
below)
snakemake --use-conda paper
This will run all analysis steps to reproduce results and eventually build the paper.
You can also run certain parts only by using other snakemake
rules; to get a list of all rules run snakemake --list
.
To generate a PDF of the dependency graph of all steps, run:
snakemake --rulegraph | dot -Tpdf > dag.pdf
(needs dot
: conda install graphviz
).
To run on Euler, use the following command:
snakemake --use-conda --profile config/euler
If you want to run on another cluster, read snakemake's documentation on cluster execution and take config/euler
as a starting point.
At the moment, there is one manual step involved: running renewables.ninja simulations of wind and solar electricity. It is added to the automatic workflow as input data. Should you want to change the simulations, because you want to change parameters of the simulation (see parameters.ninja
in the config), you can do that in three steps:
- Create input files by first changing the config, then running
snakemake -s rules/ninja-input.smk
. - Run the simulations on renewables.ninja.
- Update the data in
data/capacityfactors/{technology}
.
snakemake --use-conda test
report
: contains all files necessary to build the paper; plots and result files are not in here but generated automaticallysrc
: contains the Python source codetests
: contains the test codeconfig
: configurations used in the studyrules
: additional Snakemake rules and workflowsdata
: place for raw data, whether retrieved manually and automaticallybuild
: will contain all results (does not exist initially)
If you use this code or data in an academic publication, please see CITATION.md
.
The code in this repo is MIT licensed, see ./LICENSE.md
. This excludes the KlinicSlab font family (all files in ./report/fonts/
) which is copyright Lost Type.