tum-ewk / message_ix_south_africa

This repository contains the scripts and data of the manuscript: "South Africa After Paris - Fracking Its Way to the NDCs?"

MESSAGEix South Africa

License

Copyright (C) 2019 TUM EWK

This program is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.

This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.

You should have received a copy of the GNU General Public License along with this program. If not, see http://www.gnu.org/licenses/.

Overview

This repository contains the scripts and data for the following manuscript:

Clara Luisa Orthofer, Daniel Huppmann, and Volker Krey (2019).
South Africa After Paris - Fracking Its Way to the NDCs?
Frontiers in Energy Research 7(20).
doi: 10.3389/fenrg.2019.00020

Dependencies

The code included in this repository depends on the open-source, dynamic systems-optimization model MESSAGEix. MESSAGEix will be installed when the environment is created.

Setup Environment

1. Install Python via Anaconda

2. Open a command prompt and type

   conda env create -f environment.yml
   

3. To activate the message-sa environment each time. On Windows:

   conda activate message-sa
   

Git Tracking recommendation

Before running or editing scenarios, it is recommended to tell git not to track the changes you make to the local database db/message_sa. To do so, open a git bash in your local repository (message_ix_south_africa) and run git update-index --skip-worktree db/* .

Baseline Scenario

The folder db contains the ixmp-HSQLDB database with the calibrated baseline scenario.

Runing Scenarios

The described shale gas and carbon price scenarios can be reproduced by running the run.py script. The functions required for running the scenarios, post-processing results, and generating the figures used in the manuscript can be found in the utils folder.

Acknowledgement

This research was initiated as part of the Young Scientists Summer Program (YSSP) at the International Institute for Systems Analysis, Laxenburg (Austria) with financial support from the Austrian Academy of Sciences, the Austrian National Member Organization of IIASA.

Clara Luisa Orthofer (@ClaraLuisa) received the Peccei Award for an earlier version of the published manuscript.