Audit every document in the repository, convert the non-markdown ones into markdown reports, and split current documentation from outdated material. docs/ — 31 markdown documents in seven numbered sections. Twenty are new reports generated from .docx / .pdf / .xlsx / .mlx / .m sources that were previously unreadable in the browser and undiffable in git. Each report carries a provenance block (source path, format, MD5) and links back to its original; all 13 recorded checksums verify against the files on disk. Machine-extraction losses (PDF table column interleaving, Word OMML equations, embedded figures) are called out explicitly rather than silently smoothed over. superseded/ — outdated material with a documented reason per entry: two byte-identical ClickUp re-exports, an older revision of the BIDMC/UCSD energy-flow doc (the retained copy adds the SoC Violation Rate KPI), a duplicate of Shift input data.docx, the May 2026 simulation plan, the root PV+Battery.md now covered by a fuller report, GitHub's stock demo-repository template, and a zero-byte placeholder. Its README also records what was deliberately NOT retired and why — the "Old Frameworks" and "Old Simulations" folders hold unique Simulink revisions, and "Big Ugly Folder" holds the only copy of framework revision 1.3. Findings worth flagging, all documented in the reports: - Simulink lineage recovered from each .slx's internal coreProperties.xml revision counter. The current model is Current Framework/Bobert0206_Initial_Simulation_Framework.slx (rev 2.7); the top-level copy is rev 1.3, five revisions behind. - Simulations/Constants.m is a truncated byte-prefix of the Current Framework copy, silently missing H2_leak, H2_cap and E_H2_vol_h. - The PEM electrolyser and fuel cell are unmodified MathWorks Simscape examples still at vendor defaults; the "10x bigger" sizing TODO recorded in Constants.m was never carried out. - controller-claude.m does not compile — undefined P_Electro_max, outputs unassigned on several paths. - The specification set uses two incompatible variable naming conventions and disagrees on action-space size (5 vs 16). - MA_hourly_load.csv (13.7 MB) is the same 35,040 rows as 89993-0.parquet (2.4 MB). - Clinical data is the MIMIC-IV *demo* (ODbL, 100 patients), not full MIMIC-IV — redistributable, but the licence and citation are unrecorded. Housekeeping: untrack 21 Simulink build artefacts (slprj/, *.slxc) and add ignore rules for them. Root README rewritten around the new layout. Recruitment notes naming individual candidates are excluded from version control via .gitignore rather than committed; the generic question template is kept in docs/07-team-and-operations/. Co-Authored-By: Claude Opus 5 <noreply@anthropic.com> |
||
|---|---|---|
| .github | ||
| docs | ||
| pre_model_01 | ||
| Shift Matlab Drive/Shift Matlab Drive | ||
| superseded | ||
| website | ||
| .gitignore | ||
| README.md | ||
ALLSHIFT
Umbrella repository for Team SHIFT — an AI-driven hydrogen microgrid energy-management system for hospitals.
ALLSHIFT is the central hub tying together the team's models, data, planning documents, and repositories. It links the four clusters — Energy Management, Simulations, Business & Economics, and AI & Control Systems — under one roof.
Mission
Accelerate the transition to resilient, low-carbon energy systems through AI-driven energy management. We develop intelligent control for critical infrastructure that optimizes renewables, storage, hydrogen technologies, and grid interaction — improving reliability, reducing emissions, and increasing efficiency where uninterrupted power matters most.
Founded in 2021 at the TU/e Innovation Space and Neuron (Eindhoven). Case studies: Beth Israel Deaconess Medical Center (BIDMC) and UC San Diego (UCSD).
The challenge
Hospitals need reliable, uninterrupted power while the grid grows more congested, less predictable, and more weather-dependent. With the Dutch "balancing system" being phased out from 2025, energy returned to the grid is only partially compensated. SHIFT answers with an AI-driven hydrogen microgrid that forecasts hospital demand, optimizes solar and battery use, and controls electrolyzers and fuel cells so every component runs at its full potential.
System architecture
Forecasters ──► Simulator (Gym-style env) ──► RL / rule-based controller
(PV, demand, wraps physical models (dispatch policy)
price) PV · battery · PEM │
▲ electrolyser · PEM fuel ▼
│ cell · H2 tank · grid KPIs: unmet critical load ≈ 0,
weather/ cost (€), CO₂, curtailment
market data │
▼
Business & Economics analysis
Dispatch priority cascade: PV → battery → hydrogen (fuel cell discharge / electrolyser charge) → external grid. Critical hospital load is always prioritised — "critical load is sacred".
Repository layout
ALLSHIFT/
├── docs/ ← all current documentation, in markdown
│ ├── 01-project/ vision, work packages, efficiency targets
│ ├── 02-specifications/ simulator contract, RL state/action/reward, forecasting
│ ├── 03-energy-management/ BIDMC & UCSD case studies, datasets, equipment
│ ├── 04-simulations/ Simulink models, controller, PEM models, PowerWorld
│ ├── 05-business-economics/ cost parameter register, SCBA methodology
│ ├── 06-data/ dataset inventory
│ ├── 07-team-and-operations/
│ └── _originals/ the .docx / .pdf sources for root-level reports
├── superseded/ ← outdated docs, each with a documented reason
├── Shift Matlab Drive/ ← MATLAB/Simulink models and raw data (mirrors MATLAB Drive)
├── website/ ← public site (Astro + Tailwind, Cloudflare Pages)
├── pre_model_01/ ← modelling sandbox
└── .github/ ← organization profile
Why documents appear twice
Anything that arrived as Word, PDF, Excel, or a MATLAB Live Script has a markdown report in
docs/ — readable on the web, diffable in git, greppable. The original binary stays alongside.
Each report records its source path and the file's MD5, so you can tell whether the original has
moved on since the report was written.
Clusters
- Energy Management — hospital load characterisation, PV/solar data, datasets and manuals.
- Simulations — MATLAB/Simulink physical models: PEM electrolyser, PEM fuel cell, hydrogen storage, battery, gravity storage; the dispatch controller.
- Business & Economics — cost and CO₂ accounting, viability analysis.
- AI & Control Systems — forecasting stack and the RL/rule-based control policy.
Key documents
| Simulator I/O Interface | The typed contract between the simulator and everything that talks to it — conventions, static config, per-timestep inputs and outputs, KPIs, priority rules |
| Forecasting Requirements | Specs for three forecasters — PV generation, hospital demand, day-ahead price — with model stacks, metrics, and targets |
| RL State · Action · Reward | The reinforcement-learning problem definition |
| Simulink Model Inventory | Which model is the live one, and how the nine framework copies relate |
| Dataset Inventory | Every data file — provenance, size, and licence obligations |
| Cost Analysis | 48-parameter economic register with per-row confidence status |
Related repositories
| Repo | Purpose |
|---|---|
.github |
Organization profile — mission, vision, public face |
website |
Public site (Astro + Tailwind, Cloudflare Pages) |
pre_model_01 |
Modeling sandbox — early model approaches |
| ALLSHIFT | This repo — project hub and documentation index |
website/andpre_model_01/are also vendored into this repository as directories. The GitHub links above are their standalone homes; this repo's own remote isgit.teamshiftenergy.com/pepe/ALLSHIFT.
Status
Early development. Physical models and planning specs are in place; the simulator environment, forecasters, and control policy are being built out.
The honest picture, as of the July 2026 documentation audit:
- Specifications are the most mature layer — but not yet mutually consistent (two variable naming conventions, action spaces of 5 vs 16, reward weights undefined).
- Physical models exist but the PEM electrolyser and fuel cell are still at MathWorks demo parameters; no SHIFT-specific hydrogen sizing has been applied.
- The dispatch controller is a draft that does not yet compile.
- Data covers PV and hospital load well (via simulated proxies), but has no measured hospital load, no electricity price series, and no carbon intensity series.
Every one of these is tracked in Open questions across the project.
Contact
info@shifthydrogen.nl