r2x-reeds

R2X Core plugin for translating ReEDS power system models

R2X ReEDS is an R2X Core plugin for parsing Regional Energy Deployment System (ReEDS) power system model data. It provides a comprehensive parser for NREL's ReEDS model, enabling seamless data exchange with other power system modeling platforms through the R2X Core framework.

Features

• Read ReEDS inputs and outputs from multiple file formats including CSV and HDF5
• Automatic component mapping for generators, regions, transmission lines, reserves, and emissions data
• Time series support for capacity factors, load profiles, and reserve requirements
• Pattern-based technology categorization to automatically handle different technology variants and naming conventions
• JSON-based configuration through defaults and file mapping specifications
• Built-in validation against actual data files to ensure data integrity

Quick Start

pip install r2x-reeds

from r2x_reeds import ReEDSParser, ReEDSConfig, ReEDSGenerator
from r2x_core.store import DataStore

# Configure
config = ReEDSConfig(
    solve_year=2030,
    weather_year=2012,
    case_name="test_Pacific"
)

# Load data using the default file mapping
file_mapping = ReEDSConfig.get_file_mapping_path()
data_store = DataStore.from_json(
    file_mapping,
    folder="path/to/reeds/outputs"
)

# Parse
parser = ReEDSParser(config, data_store)
system = parser.build_system()

# Access components
generators = list(system.get_components(ReEDSGenerator))
print(f"Built system with {len(generators)} generators")

Supported Components

• Solar generators including utility-scale photovoltaic, distributed photovoltaic, concentrating solar power, and photovoltaic with battery storage
• Wind generators for both onshore and offshore installations
• Thermal generation including coal, natural gas combined cycle and combustion turbine units, and nuclear power plants
• Hydroelectric facilities and energy storage systems
• Regional components modeled at the balancing authority level with transmission region hierarchies
• Transmission interfaces and lines with bidirectional capacity representation
• Reserve requirements by type including spinning reserves, regulation reserves, and flexibility reserves organized by region
• Demand profiles representing load by region over time
• Emission data including carbon dioxide and nitrogen oxide emission rates for each generator

Documentation

• Installation Guide - Installation instructions
• Configuration Reference - Configuration options and defaults
• API Reference - Complete API documentation
• Parser Reference - Parser implementation details
• Models Reference - Component model documentation
• R2X Core Documentation - Core framework documentation