r2x-reeds 0.3.6

ReEDS model plugin

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 import DataStore, PluginContext

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

# Create data store
run_path = "path/to/reeds_folder/"
store = DataStore.from_plugin_config(config, path=run_path)

# Create plugin context and run parser
ctx = PluginContext(config=config, store=store)
parser = ReEDSParser.from_context(ctx)
ctx = parser.run()

# Access system and components
system = ctx.system
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