CUI

A Suite of Tools

Microgrid Planner is a peer-reviewed open-source suite of web tools designed to assist with the early stages of microgrid planning. Our technology stack includes Python, MySQL, Flask, JavaScript, jQuery, Bootstrap, HTML, CSS, and Docker. We are distributing our codebase as open-source software for two reasons: (1) allow others in the scientific community to deploy microgrid planning methods that would otherwise be purely methodological research endeavors, due to a lack of resources to develop the infrastructure required for deployment; and (2) encourage others to contribute to the future development of our suite of tools. We welcome both feedback and collaboration opportunities.

Note: registering an account is required to access the complete set of software features; the guest account demonstrates a limited number of the available features.

Intro Video

Citing our Platform

To cite this software, please cite both our paper Microgrid Planner: An Open-Source Software Platform published in INFORMS Journal on Computing and its corresponding GitHub repository.

Software Contributors

Microgrid Planner was developed by

with contributions from

  • Hyatt Moore, proof of concept JavaScript and MySQL contributor, 2021-2022
  • Bruce Chiarelli, Docker contributor and deployment lead 2021-2023
  • Jeff Haferman, Naval Postgraduate School High-Performance Computing support, 2023-present
  • Philip McCullick, Docker contributor and deployment lead 2023-present
  • Eldor Magat, deployment support 2024-2025
  • Taylor Conn, frontend contributor, 2024-2025
  • Richard Alves, photovoltaic and wind modeling contributor, 2024-present
  • Joseph Martineau, deployment support 2025-present
Our front-end authentication code is a modified and extended version of the Advanced Secure Login & Registration System developed by CodeShack.

Release Notes

Version 3.1 - February 2025

  • Consent banner and labels for Controlled Unclassified Information (CUI)
  • Configuration option for deactivating local login with username and password

Version 3.0 - August 2025

  • Resilience analysis method
  • Framework for supporting multiple resilience analysis methods
  • Disturbance and repair data collection, handling, and visualization
  • JavaScript helper methods for waiting for analyses to complete, submitting analyses, and retrieving results
  • GUI updates, including improved date/time input handling
  • Refactored code with improved organization and efficiency
  • Upgraded password authentication from SHA-1 to Argon2
  • Updated package installation for compliance with PEP 517/518 standards

Version 2.1 - June 2024

Version 2.0 - April 2024

  • Location-based analyses
  • Enhanced solar and wind models
  • Integration with weather data from the National Solar Radiation Database (NSRDB), hosted by the National Renewable Energy Laboratory (NREL)
  • Slurm job queuing to enable computationally intensive algorithms
  • Automated microgrid sizing method
  • Simulation history with caching
  • Selectable energy management systems
  • Improved power load data handling
  • Updated GUI with widgets
  • Refactored code with improved organization and efficiency

Version 1.1 - September 2023

  • Updated GUI
  • Refactored code with improved organization and efficiency

Version 1.0 - March 2023

  • User accounts with authentication
  • User-defined components for diesel generators, photovoltaic systems, wind turbines and battery energy storage systems
  • User-defined grids
  • Upload and storage of powerload data
  • Integration of Version 0.0 simulation methods with user-defined grids and powerload data
  • Simulation method for measuring resilience of user-defined grids, using user-defined disturbance probabilities and repair times
  • Data farming method for performing sensitivity analysis on grids (offline only)

Version 0.0 - November 2021

  • Simulation with parameter inputs for one diesel generator, one photovoltaic system, one wind turbine and one battery energy storage system
  • Simulation with parameter inputs for multiple diesel generators, photovoltaic systems, wind turbines and battery energy storage systems (offline only)
  • Distributed energy resource sizing method for one diesel generator, one photovoltaic system and one battery energy storage system (offline only)

Future Release Plans

Additional features planned for release in upcoming updates include

  • Cost modeling
  • Enhanced methods for distributed energy resource sizing

Controlled by:Department of the Navy / Naval Postgraduate School (NPS)
CUI Category: Critical Energy Infrastructure Information (CEII)
Limited Dissemination Control: None
POC: microgridplanner@nps.edu
CUI