R2X ReEDS Documentation¶
R2X ReEDS is an R2X Core plugin for parsing Regional Energy Deployment System (ReEDS) power system model data.
About R2X ReEDS¶
R2X ReEDS provides a comprehensive parser for NREL’s ReEDS model, enabling seamless data exchange with other power system modeling platforms through the R2X Core framework.
Key Features¶
Read ReEDS inputs and outputs from multiple file formats including CSV and H5
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
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 CO2 and NOX rates for each generator
Quick Start¶
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")
Documentation Sections¶
Tutorials - Step-by-step learning guides
How-To Guides - Task-focused recipes
Explanations - Architecture and design
References - API and configuration reference
Resources¶
Configuration Reference - Configuration options and defaults
API Reference - Complete API documentation
Parser Reference - Parser implementation details
Models Reference - Component model documentation
R2X Core - Core framework documentation