BC Combined Modelling

Project combining end-to-end workflow combining BC_Nexus, PyPSA_BC and the Bi-directional Linking Tool.

Warning

This library is under active development. Inconsistencies in the illustrations, API and functionality will be harmonized during development and deployment iterations.

BC Combined Modelling is developed to enable reproducible, adaptable assessments of renewable energy potential that integrate multiple modeling frameworks. We developed a structured, modular workflow that combines CLEWs-based resource assessment (BC_Nexus), power system optimization (PyPSA_BC), and bidirectional data linking capabilities to evaluate comprehensive energy system scenarios.

Project Components

The standalone components (repositories) of the project are:

• BC_Nexus - CLEWs-based renewable energy resource assessment

• BC_PyPSA - Power system optimization modeling

• RESource - RESource assessment and capacity disaggregation tool

Workflow Overview

The combined modeling workflow integrates:

1. Resource Assessment (BC_Nexus) - Renewable energy potential analysis using CLEWs framework

2. Power System Optimization (PyPSA_BC) - Detailed electrical system modeling and optimization

3. Data Linking - Bidirectional exchange of results between modeling frameworks

4. Integrated Analysis - Combined insights from both modeling approaches

Key Features

New Components (Version 202409)

• Battery and Hydro Storage modeling

• Timeslice up/down scaling up to 1-hour resolution

• Cascaded hydro power modeling

• Input data preparation automation for CLEWs framework

Key Upgrades

• Input data preparation automation add-on to CLEWs framework (tailored for BC_Nexus Model)

• Enhanced storage modeling capabilities

• Improved temporal resolution handling

Quick Start

Installation

# Clone the repository
git clone https://github.com/DeltaE/BC_Combined_Modelling.git
cd BC_Combined_Modelling

# Install the package
pip install -e .

Basic Usage

from bc_combined_modelling import CombinedModel

# Initialize the combined modeling framework
model = CombinedModel(
    config_file='config/config.yaml',
    region='BC'
)

# Run the integrated workflow
results = model.run_combined_analysis()

Documentation Structure

User Guide:

• Getting Started
  • Prerequisites
  • Installation
  • Project Structure
  • Configuration
  • Quick Start Examples
  • Working with Notebooks
  • Component Setup
  • Data Requirements
  • Troubleshooting
  • Next Steps
  • Development
• Combined Workflow Methodology
  • Workflow Overview
  • Integrated Methodology
  • Key Innovations
  • Scenario Analysis Framework
  • Validation and Uncertainty Analysis
  • Performance Optimization
  • Best Practices
• BC_Nexus Integration
  • Overview
  • Key Features
  • Integration with Combined Framework
  • Model Configuration
  • Running BC_Nexus Analysis
  • Output Data Structure
  • Quality Assurance and Validation
  • Future Enhancements

API Reference:

• API Reference
  • Core Components
  • Quick Reference

Development:

• Development Team
  • Core Developers
  • Principal Investigator & Project Supervision
  • Affiliation
  • Project Funding
  • Contributing
  • Research Publications
  • Contact
• Troubleshooting Guide
  • Installation Issues
  • Runtime Issues
  • Memory and Performance Issues
  • Data Issues
  • Documentation Issues
  • Getting Additional Help

Acknowledgements

This project is developed at the Delta E+ Research Lab, Simon Fraser University (SFU), under the supervision of Dr. Taco Niet with funding support from PICS.

Version Information

• Version: 202409

• Release Date: September 2024

• License: View License

---

For detailed installation instructions, see Getting Started. For API documentation, see API Reference.