pepe/ALLSHIFT
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions
ALLSHIFT/docs/04-simulations/powerworld-microgrid.md
pepe 72dd781dbc Organize documentation into docs/ and superseded/ 
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>
2026-07-25 21:20:33 -07:00

5.2 KiB
Raw Blame History

PowerWorld Microgrid Model

Markdown report of non-markdown source files.
Sources Shift Matlab Drive/Shift Matlab Drive/Simulations/PowerWorld/New Powerworld/
Formats PowerWorld binary case files, CSV export, MP4 screen recording
Owner Simulations cluster
Status Current
Report generated 2026-07-25

Folder contents

File Size Format What it is
Shift Powerworld Microgrid EASI.mp4 10.9 MB MP4 video Screen recording / demonstration of the model — see The video
microgrid_OG.PWB 28 kB PowerWorld Binary The case file — the actual network model (buses, lines, generators, loads)
final_base_v5.tsb 14 kB PowerWorld Time Step Base Time-step simulation definition — v5 implies at least five iterations
microgrid_OG.pwd 5.6 kB PowerWorld Display The one-line diagram / display layout for microgrid_OG.PWB
Profiles SHIFT(Generators Factors + Battery).csv 9 kB CSV Input profile — see The CSV

.PWB/.pwd/.tsb are proprietary PowerWorld Simulator formats. They are binary and unreadable without a PowerWorld licence, and nothing in this repository records which PowerWorld version or licence tier is required to open them.

Note

microgrid_OG — "OG" reads as original. final_base_v5.tsb carries both "final" and "v5". The two naming schemes do not agree about which artefact is the settled one. The .tsb version number is the only explicit version marker anywhere in this folder.

The CSV input profile

Profiles SHIFT(Generators Factors + Battery).csv is a semicolon-delimited, comma-decimal export — European locale — of the first sheet of the Generation Profiles Workbook.

;Solar Capacity Factor;Wind Capacity Factor;Max Power PV (MW);Max Power Wind;Actual Pv Power (MW);Actual Wind Power (MW);Min Power (MW)
00:00;0;0,448;151,095442;2;0;0,896;0
01:00;0;0,462;151,095442;2;0;0,924;0
...

The values match the workbook exactly — 151.095442 MW max PV, 2 MW max wind, the same hourly capacity factors. It is a derived export, not an independent source: 24 hourly rows, followed by trailing empty columns from the spreadsheet's used range.

This closes the loop on where the workbook's "Results Analysis" section came from — the workbook supplies the generation profile to PowerWorld via this CSV, PowerWorld runs the time-step study, and the results are pasted back into the workbook.

The decimal-comma format means this CSV will parse incorrectly under a default (US-locale) reader. PVBatteryRead.mlx handles exactly this case for the .xlsx (col = strrep(col, ',', '.')), but nothing in the repository reads this CSV programmatically.

What the model shows

The findings from the PowerWorld run are recorded in the workbook rather than here, and are reproduced in Generation Profiles Workbook → PowerWorld results analysis. In summary:

  • No major voltage problems; generators work as intended.
  • The grid does not pull energy when the battery is active, but pulls more when the battery is also pulling — the recommendation is shorter, stronger midday charge cycles and night-time discharge.
  • The line/transformer is overloaded in 19 of 24 hours, peaking at 428% of MVA limit. The workbook's own conclusion is that the line rating and distance data are unrealistic rather than the dispatch being wrong.

That unresolved line-rating question is the main open item for this model.

Scale

This model runs at 151 MW PV / 140 MWh storage / 600 MWh per day — campus or distribution-network scale, roughly 300× the single-hospital scale used everywhere else in the project (a 2,300 m² rooftop array is ~0.46 MW peak). It is closer to the UCSD campus microgrid (30 MW CHP) than to BIDMC.

Whether that is deliberate — a network-level study to complement the building-level Simulink work — or an uncorrected placeholder is not recorded anywhere. Worth a note in the folder.

The video

Shift Powerworld Microgrid EASI.mp4 (10.9 MB) is the third-largest file in the repository and the only video. Its content cannot be transcribed into this report — it is a screen recording, and no accompanying description exists.

Recommendation, not yet applied: a 10.9 MB binary video in git is the kind of file that is better hosted alongside the team's other media (ClickUp, Drive, or the website) with a link from here. If it is a demo of the model running, a few captioned screenshots plus a paragraph would serve the repository better and cost ~100 kB. Left in place pending the team's decision — deleting the only recording of a model nobody can open without PowerWorld would be the wrong call to make unilaterally.

Related