GRIM is an open-source MATLAB toolbox for power system restoration decision support. It computes restoration milestones — critical decision points during the process of restoring a power grid after a blackout — using graph-theoretic algorithms, optimal power flow, and intelligent search strategies.
GRIM is part of the GriRes™ (Grid Resilience) Suite.
- Milestone-based restoration planning with greedy and backtracking solvers
- Interactive GUI for restoration scenario visualization and editing
- Full AC-OPF integration with reactive power modeling
- Multiple test systems — IEEE 14, 30, 39, 57, 118 bus; RTS-24; and custom grids
- Comprehensive reporting — Markdown reports, MAT exports, CSV time-series
- Data editor for creating and modifying grid restoration scenarios
- Configurable restoration parameters including cranking paths, generator priorities, and load dispatch
- MATLAB R2020b or later
- MATPOWER 7.0+ (matpower.org)
- Install MATPOWER and ensure it is on your MATLAB path.
- Clone or download this repository.
- In MATLAB, navigate to the
GRIM_v3.0.0directory. - Run:
This opens the GRIM GUI where you can load grid data, configure restoration parameters, and run simulations.
GRIM_Launch
See the included manual:
If you use GRIM in academic work, please cite:
@article{hou2011milestones,
author = {Y. Hou and C.-C. Liu and K. Sun and P. Zhang and S. Liu and D. Mizumura},
title = {Computation of Milestones for Decision Support during System Restoration},
journal = {IEEE Transactions on Power Systems},
volume = {26},
number = {3},
pages = {1399--1409},
year = {2011}
}
@book{sun2019cascading,
author = {K. Sun and Y. Hou and W. Sun and J. Qi},
title = {Power System Control Under Cascading Failures},
publisher = {John Wiley \& Sons},
year = {2019}
}GRIM is available under a dual license:
| Open Source | Commercial | |
|---|---|---|
| License | GPL-3.0-or-later | Contact author |
| Use cases | Any use under copyleft terms | Proprietary / closed-source products |
| Cost | Free | Negotiated |
| Source code | Must share modifications (copyleft) | No obligation to share |
Open-source users: This software is free under the terms of the GPL-3.0. You may use, modify, and redistribute it, provided that derivative works are also distributed under GPL-3.0 and proper attribution is given.
Commercial users: For proprietary or closed-source use, a separate commercial license is available. Contact yunhe.hou@gmail.com.
See NOTICE for full licensing details, trademark information, and citation requirements.
Contributions are welcome! Please see CONTRIBUTING.md for guidelines.
Dr. Francis Yunhe Hou
- Email: yunhe.hou@gmail.com
This software builds upon the Generic Restoration Milestone (GRM) methodology and the HITS (Healing Touch for Power Systems) toolbox. Portions were developed with AI-assisted programming tools (including OpenAI ChatGPT, Anthropic Claude, and xAI Grok); all code has been reviewed, tested, and validated by the author.