Currently, oemof-B3 needs python 3.7 or 3.8 (newer versions may be supported, but installation can take very long).
In order to install oemof-B3, proceed with the following steps:
git-clone oemof-B3 into local folder: git clone https://github.com/rl-institut/oemof-B3.git
create virtual environment using conda: conda env create environment.yml
activate environment: conda activate oemof-B3
install oemof-B3 package using poetry, via: poetry install
Alternatively, you can create a virtual environment using other approaches, such as virtualenv.
To create reports oemof-B3 requires pandoc (version > 2). Pandoc is included in conda environment config (environment.yml). If the environment is build otherwise, pandoc must be installed manually. It can be installed following instructions from Pandoc Installation.
For the optimization, oemof-B3 needs a solver. Check out the oemof.solph documentation for installation notes.
To test if everything works, you can run the examples. To do this, please follow the instructions in chapter Examples.
For developers: Please activate pre-commit hooks (via pre-commit install) in order to follow our coding styles.
Required: An LP-solver¶
To use oemof-solph, which does the energy system optimization in oemof-B3, a LP/MILP solver must be installed. To use the CBC solver install the coinor-cbc package. For further details, read the installation instructions on oemof.solph.
If you have installation problems, consider opening an issue.
How to install geopandas under Windows¶
Geopandas is necessary in oemof-B3 for a small subset of the modeling steps. Therefore it is part of the extras requirements. The installation of geopandas on Windows can be challenging. According to the geopandas documentation (https://geopandas.org/getting_started/install.html) there are multiple ways to install it. We recommend to use the conda-forge channel:
conda install --channel conda-forge geopandas
in the Anaconda prompt.
Raw input data is currently not provided with the github repository but will be published at a later stage. More information about the raw data format can be found here: Raw data
Workflow management with snakemake: Separating the steps¶
The modeling of energy systems in most cases entails multiple distinct steps with different processing times (e.g. computations, aggregation, filtering in preprocessing, optimization, establishing derived results, plots and reports in postprocessing).
Separating these steps allows to work on a certain part of the model pipeline without having to re-run all steps that are not affected by it. This can save a lot of time.
The model oemof-B3 uses snakemake to keep the execution of these steps reproducible, adaptable and transparent. Visit the snakemake docs to learn more about snakemake and how to install it.
How can snakemake help at workflow management? The main characteristics of snakemake  are:
Lightweight workflow management
Text-based, python syntax
split large data-/workflow into single steps, defined by rules
Infers dependencies and execution order (DAG)
Reproducible and scalable data analyses
Supported languages: BASH commands, Python, Inline python code, R script, R markdown files
More features which facilitate the workflow management are
Parallelization (threads, can be even run on clusters such as AWS S3)
Resource allocation (entire workflow or per rule)
Suspend and resume
How to run the model¶
Snakemake on Linux¶
To run the scenarios, execute:
snakemake -j<NUMBER_OF_CPU_CORES> results/<scenario_name>/postprocessed
whereby scenario_name corresponds to the name in the YAML file of the respective scenario in scenarios directory. To run the scenarios, the corresponding raw data in the raw directory is required.
Alternatively, to create just the output file or directory of one rule, run:
snakemake -j<NUMBER_OF_CPU_CORES> <output file or folder>
Snakemake on Windows¶
When running snakemake with output files in subfolders on Windows with
MissingRuleException is raised. The process is unable to specify the output files in subfolders.
This bug is an open issue
A current workaround is described in pypsa-eur.
is to run snakemake with the flag
--keep-target-files to the command.
snakemake -j<NUMBER_OF_CPU_CORES> --keep-target-files
You can write issues to announce bugs or to propose enhancements.