pepe
72dd781dbc
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>
102 lines
5.2 KiB
Markdown
102 lines
5.2 KiB
Markdown
# 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](#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](#the-csv-input-profile) |
|
||
|
||
`.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](generation-profiles-workbook.md).
|
||
|
||
```
|
||
;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](generation-profiles-workbook.md#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](../03-energy-management/ucsd-equipment-manual.md) (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
|
||
|
||
- [Generation Profiles Workbook](generation-profiles-workbook.md) — the input profile and the results analysis
|
||
- [Simulink Model Inventory](simulink-model-inventory.md) — the MATLAB-side models
|
||
- [UCSD Equipment Manual](../03-energy-management/ucsd-equipment-manual.md) — the campus-scale case study
|