A monorepo for the EnergyScope-Québec energy system model and its research extensions.
energyscope-quebec/
├── shared/
│ ├── model/ # AMPL model files of the shared base EnergyScope-Québec model
│ ├── data/ # AMPL data files of the shared base EnergyScope-Québec model
│ ├── scenarios/ # AMPL files of shared scenarios
│ ├── plots/ # Scripts for shared plotting functions and styles
│ ├── utilities/ # Utility functions and scripts used across projects
│ └── docs/ # Shared methodology notes and references
└── projects/
├── front_commun/ # Evaluation of Front Commun's energy transition scenarios
├── lca/ # Integration of life-cycle assessment (LCA) metrics
├── peaks/ # Modeling of end-use demand peaks
└── pathway/ # Transition pathway modeling (2020–2050)
| Project | Description | Lead |
|---|---|---|
front_commun |
Evaluation of Front Commun's energy transition scenarios | Matthieu Souttre |
lca |
Coupling of the energy system model with LCA metrics via mescal |
Matthieu Souttre |
peaks |
Explicit modeling of end-demand peaks | Julien Pedneault |
pathway |
Multi-period transition pathway modeling from 2020 to 2050 | Mattia Zimmermann |
The shared/model/ directory contains a versioned snapshot of the base EnergyScope-Québec AMPL model.
See shared/docs/model-versioning.md for the update protocol.
To access the shared models and methods, run the following command in your virtual environment:
pip install -e .Then, in your python files or notebooks, you can import the shared modules as follows:
from shared.models import energyscope_quebec- Changes to
shared/model/require approval from all project leads (enforced via CODEOWNERS). - Changes within a project folder require approval from that project's lead only.
- Please use the appropriate issue template when opening issues.
- Branch naming convention:
<project-or-shared>/<short-description>(e.g.lca/biogenic-flows,shared/fix-storage-constraint).
See CONTRIBUTING.md for details.
Apache License 2.0 — see LICENSE for the full text.