search

ucsusa / pypsa-illinois

A model of the Illinois electricity system built with PyPSA.
GNU General Public License v3.0
4 stars 0 forks source link

readme

pypsa-illinois

A model of the Illinois electricity system built with PyPSA.

Installation

Requirements

[!WARNING] Running conda update --all may downgrade pypsa to 0.25.x to accomodate an update to pyomo. This will break the code. After running update, run conda update pypsa to fix.

  1. Clone the repository
git clone https://github.com/ucsusa/pypsa-illinois.git
  1. Set up the environment
cd pypsa-illinois
mamba env create  # mamba and conda may be used interchangeably, here
mamba activate pypsa-illinois
  1. Creating the .env file

Users should copy the .env.template file into a new file simply called .env. This file contains "secret" information, such as API keys, emails, and other data that should remain local. In order to run the current model, users must have API keys from the following organizations:

These keys may be added directly to the .env file.

Running the model

This project uses the workflow management tool, snakemake, to create a reproducible data pipeline. Running the command

snakemake --cores=1

will run the workflow illustrated in the directed acyclic graph (DAG) shown below.

Model DAG

Running the sensitivity

To reproduce the sensitivity runs follow all of the set up steps described above (through step three). Then run

python sensivitiy-script.py

Users can optionally use the 01-results-process notebook in the notebooks folder to aggregate the capacity and the generation results.