ReEDS 2.0

Welcome to the Regional Energy Deployment System (ReEDS) Model

This GitHub repository contains the source code for NREL's ReEDS model. The ReEDS model source code is available at no cost from the National Renewable Energy Laboratory. The ReEDS model can be downloaded or cloned from https://github.com/NREL/ReEDS-2.0.

For more information about the model, see the open source ReEDS-2.0 Documentation.

ReEDS training videos are available on the NREL YouTube channel at https://youtu.be/aGj3Jnspk9M?si=iqCRNn5MbGZc8ZIO.

Introduction

ReEDS is a capacity planning and dispatch model for the U.S. electricity system.

As NREL's flagship long-term power sector model, ReEDS has served as the primary analytic tool for many studies of electricity sector research questions. Example model results are available in the Scenario Viewer.

Quick-start guide

The ReEDS model is written in Python, GAMS, and Julia. Python and Julia are free, open-source languages; GAMS requires a software license from the vendor. A step-by-step guide for getting started with ReEDS is available here, and a quick-start guide for advanced users is outlined below.

1. Install Python using the Anaconda Distribution: https://www.anaconda.com/download/success
2. Set up GAMS:
   1. Install GAMS: https://www.gams.com/download/
   2. Obtain a combined GAMS/CPLEX license: https://www.gams.com/sales/licensing/
      1. Small ReEDS systems have been solved using the open-source COIN-OR solver as described here, but this capability is not actively maintained.
      2. Other commercial solvers have also been succussfully applied to ReEDS, but setup details and some solver tuning are specific to the CPLEX solver.
3. Install Julia: https://julialang.org/downloads/
4. Open a command-line interface and set up your environments:
   1. Clone the ReEDS repository: git clone [email protected]:NREL/ReEDS-2.0.git or git clone https://github.com/NREL/ReEDS-2.0.git
   2. Navigate to the cloned repository
   3. Create the reeds2 conda environment: conda env create -f environment.yml
      1. Linux and Mac users can use the environment.yml directly. Windows users need to comment out the - julia=1.8 line from the environment.yml file before creating the enviroment and use the version of Julia installed above.
   4. Activate the reeds2 environment: conda activate reeds2
   5. Instantiate the Julia environment: julia --project=. instantiate.jl
5. Run ReEDS on a test case from the root of the cloned repository:
   1. For interactive setup: python runbatch.py
   2. For one-line operation: python runbatch.py -b v20250314_main -c test. In this example, "v20250314_main" is the prefix for a batch of cases, and "test" is the suffix of a cases_{}.csv file located in the root of the repository (in this case, cases_test.csv).

Contact Us

If you have comments and/or questions, you can contact the ReEDS team at [email protected] or post a question on the discussion pages.

Alternatively, you can post questions at ReEDS repository discussion page.