Skip to content

Plan, apply and roll back changes to a production ontology, with a blast radius report and a proof an auditor can re-check.

heritage-aerial: add Canada/US/three-country maps to the write-ups

FABIOTESS2bf29ee67e6c
diff --git a/case-studies/heritage-aerial/assets/README.md b/case-studies/heritage-aerial/assets/README.md
index 45cff813..dd70463a 100644
--- a/case-studies/heritage-aerial/assets/README.md
+++ b/case-studies/heritage-aerial/assets/README.md
@@ -11,6 +11,22 @@ harvested 2 Jul 2026). Draft captions below — edit to taste. No em dashes per
| `stack.png` | Positioning | "The gap nobody had filled: a crosswalk binding the archival stack (Records in Contexts, PROV-O) to the geospatial/imagery stack (STAC, GeoSPARQL, IIIF) for historic aerial photography. NAPH is that bridge, wrapped in FAIR and CARE, across three incrementally-adoptable tiers." |
| `real-demo-world.png` | Hero / scope | "292 real NCAP frames, harvested live and auto-lifted to a computation-ready standard. Hong Kong 1924 to the Caribbean, 1924 to 1956, every one queryable by space and time. Open source." |
| `real-demo-europe.png` | Detail view | "Every frame becomes a full linked-data record: sortie, ISO date, WGS84 footprint, perspective, camera, collection context and a link back to the source. Click any footprint." |
+| `real-demo-three-country.png` | Hero / portability | "One standard, three national collections. NCAP (UK), NAPL (Canada) and WHAIFinder (USA), harvested live from public endpoints and lifted to the same NAPH Baseline, 0 SHACL violations. Each archive was missing a different Baseline piece (rights in the UK, frame granularity in Canada, footprint geometry in the US) and each was closed by a different single transform, with the ontology, shapes and crosswalk unchanged." |
+| `real-demo-canada.png` | Canada proof | "Canada's National Air Photo Library, lifted to NAPH Baseline from the open Government of Canada CKAN API. 8 temporal-series regions, native-WGS84 footprints, 100% machine-readable Open Government Licence rights, 0 SHACL violations." |
+| `real-demo-usa.png` | US proof | "225 real Wisconsin Historic Aerial Imagery frames (1937 to 1967, public-domain USDA) from the open ArcGIS FeatureServer, no token needed. The US index publishes a centerpoint not a polygon, so each footprint is reconstructed closed-form from centerpoint plus map scale. 0 SHACL violations." |
+
+The three-country maps are generated by `demo/world-maps.html` (Leaflet + CARTO
+basemap), screenshotted with headless Chrome at `#all`, `#canada`, `#usa`:
+
+```bash
+python3 -m http.server 8799 &
+CHROME="/Applications/Google Chrome.app/Contents/MacOS/Google Chrome"
+for v in all:three-country canada:canada usa:usa; do
+ "$CHROME" --headless=new --window-size=1680,1000 --virtual-time-budget=11000 \
+ --force-device-scale-factor=2 --screenshot="assets/real-demo-${v#*:}.png" \
+ "http://localhost:8799/demo/world-maps.html#${v%:*}"
+done
+```
## Regenerate
diff --git a/case-studies/heritage-aerial/assets/real-demo-canada.png b/case-studies/heritage-aerial/assets/real-demo-canada.png
new file mode 100644
index 00000000..dd31ab56
Binary files /dev/null and b/case-studies/heritage-aerial/assets/real-demo-canada.png differ
diff --git a/case-studies/heritage-aerial/assets/real-demo-three-country.png b/case-studies/heritage-aerial/assets/real-demo-three-country.png
new file mode 100644
index 00000000..2f1134ad
Binary files /dev/null and b/case-studies/heritage-aerial/assets/real-demo-three-country.png differ
diff --git a/case-studies/heritage-aerial/assets/real-demo-usa.png b/case-studies/heritage-aerial/assets/real-demo-usa.png
new file mode 100644
index 00000000..a301f9a9
Binary files /dev/null and b/case-studies/heritage-aerial/assets/real-demo-usa.png differ
diff --git a/case-studies/heritage-aerial/demo/world-maps.html b/case-studies/heritage-aerial/demo/world-maps.html
new file mode 100644
index 00000000..8b81f2c6
--- /dev/null
+++ b/case-studies/heritage-aerial/demo/world-maps.html
@@ -0,0 +1,122 @@
+<!DOCTYPE html>
+<html lang="en">
+<head>
+<meta charset="utf-8">
+<meta name="viewport" content="width=device-width, initial-scale=1">
+<title>NAPH — Three national aerial collections, one standard</title>
+<link rel="stylesheet" href="https://unpkg.com/[email protected]/dist/leaflet.css"
+ integrity="sha256-p4NxAoJBhIIN+hmNHrzRCf9tD/miZyoHS5obTRR9BMY="
+ crossorigin="">
+<script src="https://unpkg.com/[email protected]/dist/leaflet.js"
+ integrity="sha256-20nQCchB9co0qIjJZRGuk2/Z9VM+kNiyxNV1lvTlZBo="
+ crossorigin=""></script>
+<style>
+ * { box-sizing: border-box; }
+ html, body { margin: 0; padding: 0; height: 100%; font-family: -apple-system, BlinkMacSystemFont, "Segoe UI", system-ui, sans-serif; color: #1a1a2a; }
+ #map { position: absolute; inset: 0; }
+ .titlecard {
+ position: absolute; z-index: 1000; top: 18px; left: 18px; max-width: 520px;
+ background: rgba(49,59,69,0.94); color: #fff; padding: 16px 20px; border-radius: 10px;
+ box-shadow: 0 6px 22px rgba(0,0,0,0.28);
+ }
+ .titlecard h1 { margin: 0 0 6px 0; font-size: 1.25em; font-weight: 650; }
+ .titlecard p { margin: 0; font-size: 0.86em; line-height: 1.4; opacity: 0.92; }
+ .live { display:inline-block; background:#3a9e99; color:#fff; font-size:0.62em; font-weight:700;
+ padding:0.18em 0.6em; border-radius:0.35em; letter-spacing:0.05em; vertical-align:middle; margin-left:0.4em; }
+ .legend {
+ position: absolute; z-index: 1000; bottom: 22px; left: 18px;
+ background: #fff; padding: 12px 16px; border-radius: 9px; box-shadow: 0 4px 16px rgba(0,0,0,0.2);
+ font-size: 0.85em;
+ }
+ .legend .row { display:flex; align-items:center; gap:8px; margin: 4px 0; }
+ .legend .sw { width: 15px; height: 15px; border-radius: 3px; display:inline-block; border: 1px solid rgba(0,0,0,0.25); }
+ .legend b { font-weight: 650; }
+ .legend .n { color:#666; font-size: 0.92em; }
+ .attribution-note { position:absolute; z-index:1000; bottom: 4px; right: 8px; font-size: 0.7em; color:#555; background: rgba(255,255,255,0.7); padding: 2px 6px; border-radius: 4px; }
+</style>
+</head>
+<body>
+<div id="map"></div>
+<div class="titlecard">
+ <h1 id="tc-title">Three national aerial collections, one standard <span class="live">REAL DATA</span></h1>
+ <p id="tc-sub">NCAP (UK), NAPL (Canada) and WHAIFinder (USA) harvested live from public
+ endpoints and lifted to the same NAPH Baseline. 0 SHACL violations. The ontology,
+ shapes and crosswalk are identical across all three; only the harvester differs.</p>
+</div>
+<div class="legend" id="legend"></div>
+<div class="attribution-note">Basemap © OpenStreetMap, © CARTO · Footprints: NCAP · NRCan NAPL (OGL) · WHAIFinder (USDA, public domain)</div>
+
+<script>
+const SETS = {
+ uk: { file: "../reports/real-footprints.geojson", color: "#2f9e99", label: "NCAP — United Kingdom", note: "292 frames · polygon footprints (reprojected EPSG:3857→WGS84)" },
+ canada: { file: "../reports/real-napl-footprints.geojson", color: "#c0392b", label: "NAPL — Canada", note: "40 dated mosaics · native-WGS84 footprints · 100% OGL rights" },
+ usa: { file: "../reports/real-whai-footprints.geojson", color: "#e08a1e", label: "WHAIFinder — United States", note: "225 frames · footprints reconstructed from centerpoint + scale" },
+};
+
+const map = L.map("map", { zoomControl: true, attributionControl: false }).setView([30, -40], 3);
+L.tileLayer("https://{s}.basemaps.cartocdn.com/light_all/{z}/{x}/{y}{r}.png", {
+ maxZoom: 19, subdomains: "abcd"
+}).addTo(map);
+
+function centroid(feat) {
+ const g = feat.geometry; let ring;
+ if (g.type === "Polygon") ring = g.coordinates[0];
+ else if (g.type === "Point") return [g.coordinates[1], g.coordinates[0]];
+ else ring = g.coordinates[0][0];
+ let x=0,y=0; ring.forEach(p=>{x+=p[0];y+=p[1];});
+ return [y/ring.length, x/ring.length];
+}
+
+const layers = {};
+let pending = Object.keys(SETS).length;
+const hash = (location.hash || "#all").replace("#","");
+
+Object.entries(SETS).forEach(([key, s]) => {
+ fetch(s.file).then(r=>r.json()).then(gj => {
+ const grp = L.featureGroup();
+ L.geoJSON(gj, {
+ style: { color: s.color, weight: 1.2, fillColor: s.color, fillOpacity: 0.28 },
+ pointToLayer: (f, ll) => L.circleMarker(ll, { radius: 4, color: s.color, fillColor: s.color, fillOpacity: 0.7, weight: 1 })
+ }).addTo(grp);
+ // always-visible centroid dots so small footprints read at world scale
+ gj.features.forEach(f => {
+ if (f.geometry.type !== "Point")
+ L.circleMarker(centroid(f), { radius: 3.5, color: s.color, fillColor: s.color, fillOpacity: 0.85, weight: 0.8 }).addTo(grp);
+ });
+ grp.addTo(map);
+ layers[key] = grp;
+ s.count = gj.features.length;
+ }).catch(e => console.error(key, e)).finally(() => {
+ if (--pending === 0) finalize();
+ });
+});
+
+function finalize() {
+ // legend
+ const leg = document.getElementById("legend");
+ leg.innerHTML = "<b>Collection</b>";
+ Object.entries(SETS).forEach(([k, s]) => {
+ leg.innerHTML += `<div class="row"><span class="sw" style="background:${s.color}"></span>`
+ + `<span><b>${s.label}</b><br><span class="n">${s.note}</span></span></div>`;
+ });
+
+ // view + optional single-country focus
+ if (hash === "canada" && layers.canada) {
+ map.fitBounds(layers.canada.getBounds().pad(0.15));
+ setTitle("Canada — NAPL open data, lifted to NAPH Baseline",
+ "8 National Air Photo Library temporal-series regions (1932–2004) harvested from the open Government of Canada CKAN API. Native-WGS84 footprints, 100% machine-readable OGL rights, 0 SHACL violations.");
+ } else if (hash === "usa" && layers.usa) {
+ map.fitBounds(layers.usa.getBounds().pad(0.15));
+ setTitle("United States — WHAIFinder frames, footprints reconstructed",
+ "225 real Wisconsin Historic Aerial Imagery frames (1937–1967, public-domain USDA) from the open ArcGIS FeatureServer. Each footprint reconstructed closed-form from centerpoint + map scale. 0 SHACL violations.");
+ } else {
+ const all = L.featureGroup(Object.values(layers));
+ try { map.fitBounds(all.getBounds().pad(0.05)); } catch(e){}
+ }
+ document.body.setAttribute("data-ready", "1");
+}
+function setTitle(t, s){ document.getElementById("tc-title").innerHTML = t + ' <span class="live">REAL DATA</span>';
+ document.getElementById("tc-sub").textContent = s; }
+</script>
+</body>
+</html>
diff --git a/case-studies/heritage-aerial/docs/canada-napl-findings.md b/case-studies/heritage-aerial/docs/canada-napl-findings.md
index 6a65af0d..67f5cdb9 100644
--- a/case-studies/heritage-aerial/docs/canada-napl-findings.md
+++ b/case-studies/heritage-aerial/docs/canada-napl-findings.md
@@ -15,6 +15,13 @@ the ontology, SHACL shapes and RiC-O × STAC crosswalk are unchanged — only th
thin harvester adapter differs. A US adapter pattern is documented at
[`pipeline/scrapers/usgs_earthexplorer.py`](../pipeline/scrapers/usgs_earthexplorer.py).
+![NAPL Temporal Series regions across Canada, harvested live and lifted to NAPH
+Baseline](../assets/real-demo-canada.png)
+
+*8 NAPL Temporal Series regions (red) harvested live from the open Government of
+Canada CKAN API and lifted to NAPH Baseline. The amber cluster is the US
+WHAIFinder sample; teal is NCAP (UK) — same standard, three collections.*
+
## Headline
> Where NCAP was missing exactly one Baseline field (machine-readable rights,
diff --git a/case-studies/heritage-aerial/docs/usa-whaifinder-findings.md b/case-studies/heritage-aerial/docs/usa-whaifinder-findings.md
index c54f4cfd..63807cce 100644
--- a/case-studies/heritage-aerial/docs/usa-whaifinder-findings.md
+++ b/case-studies/heritage-aerial/docs/usa-whaifinder-findings.md
@@ -8,6 +8,13 @@ public-domain USDA survey photography — read from its public **ArcGIS
FeatureServer** on 2 July 2026. Metadata only; read-only; no authentication. See
[`pipeline/scrapers/whaifinder_arcgis.py`](../pipeline/scrapers/whaifinder_arcgis.py).*
+![225 real WHAIFinder frames across Wisconsin, footprints reconstructed from
+centerpoint and scale](../assets/real-demo-usa.png)
+
+*225 real Wisconsin Historic Aerial Imagery frames (1937–1967, public-domain USDA),
+harvested live from the open ArcGIS FeatureServer. Each footprint reconstructed
+closed-form from the published centerpoint plus map scale.*
+
## Why not USGS
The obvious US target is the USGS EROS "Aerial Photo Single Frames" archive (6.5M
@@ -61,6 +68,13 @@ the substrate (centerpoint + scale) was already in the data.
## Three collections, three different transforms — same standard
+![Three national aerial collections — NCAP (UK), NAPL (Canada), WHAIFinder (USA) —
+on one map, all lifted to the same NAPH Baseline](../assets/real-demo-three-country.png)
+
+*NCAP (teal, UK), NAPL (red, Canada) and WHAIFinder (amber, USA), harvested live
+from public endpoints and lifted to the same NAPH Baseline with 0 SHACL violations.
+Same ontology, shapes and crosswalk throughout; only the harvester differs.*
+
| | **NCAP (UK)** | **NAPL (Canada)** | **WHAIFinder (USA)** |
|---|---|---|---|
| Geometry | polygon, **EPSG:3857** | polygon, **native WGS84** | **point centerpoint** |