Skip to content

Commit e37cd93

Browse files
committed
docs(perturbation-sim): publish ODbL topology as a Release asset (not committed)
Created GitHub Release perturbation-sim-data-v0.1 on AdaWorldAPI/lance-graph with buses.csv + lines.csv (PyPSA-Eur/OSM, ODbL, © OSM contributors) attached as assets — so clones never auto-pull the data and the repo stays lean. Official Spanish PDFs remain links-only (not re-hosted, licensing). DATA_SOURCES.md + HARVESTING.md updated with the release mirror curl recipe and a no-data-in-git note.
1 parent 71e5696 commit e37cd93

2 files changed

Lines changed: 10 additions & 0 deletions

File tree

crates/perturbation-sim/DATA_SOURCES.md

Lines changed: 6 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -5,11 +5,17 @@ with format / openness / extraction reality. Keeps provenance in one place
55
(anti-dilution: one ledger, not URLs scattered across commits). Honesty column
66
flags what is actually usable today vs needs extraction.
77

8+
> **No data is committed to the repo.** The consumable ODbL topology lives as a
9+
> GitHub **Release** asset (`perturbation-sim-data-v0.1`, §1) so clones stay
10+
> lean and nothing auto-pulls; official Spanish PDFs are referenced by link, not
11+
> re-hosted (licensing). Fetch on demand with the `curl` recipes below.
12+
813
## 1. Topology + electrical parameters (→ `ingest.rs`, the `Grid`)
914

1015
| Source | Feeds | Format | Open | Note |
1116
|---|---|---|---|---|
1217
| [Zenodo 13358976 — PyPSA-Eur/OSM prebuilt network](https://zenodo.org/records/13358976) | buses+lines, 35 ctry incl. ES | CSV | ODbL | **primary.** v0.3 is topology + voltage + circuits + length only → `r`/`x`/`s_nom` estimated (see `HARVESTING.md`) |
18+
| [**Release mirror** `perturbation-sim-data-v0.1`](https://github.com/AdaWorldAPI/lance-graph/releases/tag/perturbation-sim-data-v0.1) | `buses.csv` + `lines.csv` | CSV | ODbL (© OSM contributors) | the ODbL data attached as a **GitHub Release asset** so it is **never committed / auto-pulled** by a clone — `curl -L .../releases/download/perturbation-sim-data-v0.1/buses.csv`. Official Spanish PDFs are NOT re-hosted (links only) |
1319
| [Nature SciData 2025](https://www.nature.com/articles/s41597-025-04550-7) · [arXiv 2408.17178](https://arxiv.org/pdf/2408.17178) | the method | paper | open | how the OSM grid was built (5 km substation aggregation) |
1420
| [PyPSA-Eur](https://github.com/PyPSA/pypsa-eur/) | full workflow → real `x,r,s_nom` | code | open | run upstream if you want PyPSA's own line parameters |
1521
| [OSM Power networks](https://wiki.openstreetmap.org/wiki/Power_networks) (Overpass) | raw lines/substations | XML/JSON | ODbL | full control; you estimate electrical params |

crates/perturbation-sim/HARVESTING.md

Lines changed: 4 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -18,8 +18,12 @@ already understands, or add an alias."
1818

1919
```sh
2020
mkdir -p /tmp/pypsa && cd /tmp/pypsa
21+
# Either the canonical Zenodo source …
2122
curl -L -o buses.csv 'https://zenodo.org/records/13358976/files/buses.csv?download=1'
2223
curl -L -o lines.csv 'https://zenodo.org/records/13358976/files/lines.csv?download=1'
24+
# … or our ODbL release mirror (same files, kept out of git):
25+
# R=https://github.com/AdaWorldAPI/lance-graph/releases/download/perturbation-sim-data-v0.1
26+
# curl -L -o buses.csv $R/buses.csv ; curl -L -o lines.csv $R/lines.csv
2327
cargo run --manifest-path crates/perturbation-sim/Cargo.toml --example iberian -- \
2428
/tmp/pypsa/buses.csv /tmp/pypsa/lines.csv ES # ← any ISO-2 code: FR, PT, DE, IT…
2529
```

0 commit comments

Comments
 (0)