Add upload-ready PDFs and Zenodo metadata sheet

This commit is contained in:
Noel Sabia committed 2026-11-14 10:29:41 +01:00
1 parent d335bdf87b
commit 26ad713653
8 files changed
+104 -17

No files matched your search

+17 -13
View File
@@ -4,31 +4,35 @@ Two versions of the paper, plus the research trail.
| File | What it is | Status |
|---|---|---|
| `main.md` | Version A — 4–5 page hackathon technical report | Draft; ~3,600 words, 5 figures, 4 tables |
| `main-extended.md` | Version B — 10–12 page Zenodo paper | Draft; ~10,000 words, 44 references |
| `PulseCast-Hackathon-Report.pdf` | Upload-ready 4-page A4 hackathon report | Final draft |
| `PulseCast-Extended-Paper.pdf` | Upload-ready 11-page A4 Zenodo paper | Final draft |
| `main.md` | Markdown source for the hackathon report | Final draft |
| `main-extended.md` | Markdown source for the extended paper | Final draft |
| `ZENODO.md` | Copy-paste Zenodo metadata and upload checklist | Ready |
| `references.md` | Canonical reference list and verification checklist | Draft |
| `OUTLINE.md` | Writing plan, claims/non-claims, figures/tables | Working document |
| `figures/` | Generated figures used by both versions | Draft figures |
| `research/` | Research notes (code audit, privacy law, sensing, heatmap, PETs, applications, data quality) | Complete |
| `figures/` | Generated figures used by both versions | Final |
| `research/` | Research notes (code audit, privacy law, sensing, heatmap, PETs, applications, data quality) | Private; do not upload |
| `build/` | HTML/CSS/PDF build artifacts | Working files |
## Build
There is no Pandoc/LaTeX in this workspace. Render with any Markdown-to-PDF tool, or use a two-column template. Figure paths are relative to `paper/`:
The upload-ready PDFs were generated from Markdown via `marked` and headless Chrome with `build/style.css` (A4; 4 pages for the short report, 11 pages for the extended paper). `build/` is a working directory, not an upload artifact. Figure paths are relative to the repository root:
```text
paper/figures/fig_sensor_map.png
paper/figures/fig_hourly_profile.png
paper/figures/fig_quantization.png
paper/figures/fig_architecture.png
paper/figures/fig_plan.png
paper/figures/fig_forecast.png
figures/fig_sensor_map.png
figures/fig_hourly_profile.png
figures/fig_quantization.png
figures/fig_architecture.png
figures/fig_plan.png
figures/fig_forecast.png
```
`fig_plan.png` is a print reconstruction of the live plan screen for `scenario=sunny-saturday-market`, `standard=standard` (live API query, 14 Nov 2026; values: 5 peak staff, 172 staff-hours, €2,752, 100% coverage, €5,600 flat schedule). Replace it with the raw screenshot file if you prefer the exact pixels.
## Verification status
- Numbers: checked against `OKF_Vault/mission/data.md`, the generated `metrics.json`, and `paper/research/07-data-quality.md`.
- Numbers: checked against `OKF_Vault/mission/data.md`, the generated `metrics.json`, and `research/07-data-quality.md`.
- Canonical metrics: production 7-day **3.32 / 27.5% / 0.777**; day-ahead weather **3.36 / 27.8% / 0.763**; seasonal naive **5.40 / 44.7% / 0.462**. The mission brief’s 3.36/27.8/0.779 was the quick baseline; the paper explains the difference once.
- Deployment: live app https://pulse.noelsabia.dev; API https://api-pulse.noelsabia.dev.
- v1.1 images: api 16.9 MB, web 249 MB, ml 952 MB.
@@ -47,7 +51,7 @@ paper/figures/fig_forecast.png
- [ ] Plan figure: currently reconstructed from the provided screenshot for print legibility. Replace with the raw screenshot file if you prefer the exact pixels.
- [x] Code release timing documented (after the hackathon); public URL to be added then.
- [x] Author name and ORCID (Noel Sabia, 0009-0008-3064-7573); affiliation intentionally blank.
- [ ] Cold deployment time.
- [x] Cold deployment time documented as not measured.
- [ ] Replace internal project-note citations with public artifacts if a venue requires it.
- [ ] Final page-count trim for Version A if a strict 4–5 page limit applies.