nfisu/nigeria-hospital-microgrid-twin

# 🏥 Nigeria Hospital Microgrid Digital Twin A full-stack digital twin simulating a Nigerian general hospital's energy system — solar panels, battery storage, a scheduled-blackout national grid connection, and diesel backup — optimized to minimize cost while keeping the hospital powered through daily outages. Built as a personal learning project extending an earlier microgrid digital twin (dorm-microgrid-digital-twin) to a higher-stakes, real-world-grounded scenario. --- ## The problem Nigeria's electricity grid has a well-documented structural gap between installed and actually available capacity. As of April 2026, only 4,286 MW of the nation's 13,625 MW installed generation capacity was available for dispatch — a plant availability factor of just 31 percent, according to Nigeria's Electricity Regulatory Commission (NERC). To manage this shortfall, NERC classifies electricity customers into five service tiers (Bands A–E) under its Service-Based Tariff scheme, each guaranteeing a different minimum number of supply hours per day: Band A guarantees 20+ hours, while Band E guarantees as little as 4. A hospital would realistically be classified as **Band A** — the top tier — but even that guarantee leaves a real gap (up to ~4 hours/day of scheduled unavailability), and national grid collapses still occur regardless of band classification. For a hospital, that gap isn't a cost inconvenience like it would be for a dorm — it's a matter of keeping ventilators, refrigerated medicine, and ward lighting running. This project simulates a Band A hospital's response to that gap: solar generation during the day, battery storage to bridge shorter shortfalls, and diesel backup as the last resort when both run out — with a linear optimizer determining the cost-minimizing schedule for using each. ## Real-world data grounding Unlike a fully synthetic scenario, several inputs here are anchored to real, cited 2026 figures: | Parameter | Value | Source | |---|---|---| | Grid ta …