# Canada OSM power layers - provenance manifest
Prepared 2026-11-15 (America/Chicago). EPSG:4326 GeoJSON.

## Source
Geofabrik Canada per-province extracts (13 provinces/territories), all downloaded 2026-11-15 from
https://download.geofabrik.de/north-america/canada/<province>-latest.osm.pbf
(provinces: alberta, british-columbia, manitoba, new-brunswick, newfoundland-and-labrador, northwest-territories, nova-scotia, nunavut, ontario, prince-edward-island, quebec, saskatchewan, yukon).
Underlying OSM snapshot: 2026-11-14T21:20:41Z (per Geofabrik canada-latest metadata).

Input integrity: all 13 province downloads byte-match the official Geofabrik content-length listings (verified 2026-11-15):
alberta 352,402,332; british-columbia 1,249,517,753; manitoba 216,671,167; new-brunswick 66,617,401; newfoundland-and-labrador 259,516,616; northwest-territories 410,160,063; nova-scotia 99,621,634; nunavut 1,513,908,680; ontario 1,017,668,533; prince-edward-island 11,589,826; quebec 1,167,057,984; saskatchewan 118,290,249; yukon 71,006,203 bytes.

Correction (2026-11-15): an earlier revision of this README cited the whole-country file canada-261114.osm.pbf with a byte size and MD5 as if locally verified. That claim is withdrawn: the whole-country download was never completed to the listed size (6,502,858,272 bytes) nor checksum-verified, and it was NOT an input to these layers. Only the 13 province extracts above were used.

## License
OpenStreetMap data, Open Database License (ODbL) 1.0. Credit "© OpenStreetMap contributors" (https://www.openstreetmap.org/copyright). Derived databases carry ODbL share-alike obligations for the produced-database layer; attribute per layer/source.

## Phrasing requirement
"Recently retrieved community mapping (OSM snapshot 2026-11-14), asset currentness not universally verified." A 2026 extract date does NOT prove each mapped asset was updated or verified in 2026; individual features may be older or stale. Do not label as a current verified national inventory; no completeness claim.

## Files and counts (post-dedup)
| file | content | features |
|---|---|---|
| ca_power_lines_hv.geojson | power=line ways (transmission) | 20,530 |
| ca_power_lines_minor.geojson | power=minor_line (64,490) + power=cable ways | 66,393 (64,490 minor_line + 1,903 cable) |
| ca_power_substations.geojson | power=substation nodes + area ways | 6,827 |
| ca_power_plants.geojson | power=plant (1,007) + power=generator (30,663) nodes + area ways | 31,670 |

Cross-province duplicates removed by osm_id before these counts: 483 line ways, 23 substations, 25 plants/generators (Geofabrik keeps boundary-crossing ways complete in both adjacent extracts).

## Schema (per feature properties)
osm_id (way or node id), power (line|minor_line|cable|substation|plant|generator), and where mapped: name, voltage (raw OSM string, may be semicolon-separated multi-voltage), operator, circuits, ref, wikidata, plant:source, generator:source. Geometry: LineString for lines; Point or Polygon for facilities. plant vs generator: OSM "plant" is the site, "generator" is an individual unit; generator counts dominate and are NOT site counts.

## Processing notes for the writer
- Line geometries simplified (Douglas-Peucker): hv tolerance 0.0001 deg (~10 m), minor 0.0003 deg (~30 m); coordinates rounded to 5 decimals. Facility points/areas rounded only.
- Plants file mixes site polygons and unit points; dedupe/display policy is the writer's call (same as USA/Mexico layers).
- Border spillover possible at province and US borders (extract overlap kept whole ways); no clip applied.
- Relation-assembled plant/substation multipolygons (Mexico-style relation pass) NOT run for Canada yet; ways+nodes only. Available as a follow-up if wanted.

## Gap labels (Canada vs USA equivalence)
- Transmission lines, substations, plants/generators: covered by these OSM layers (same classes as USA/Mexico OSM layers).
- Pipelines: no geometry anywhere in the $0 verified set (NACEI pipeline layers are border-crossing points; CER CSV is attributes only).
- Refineries/LNG/gas processing: only the NACEI 2013-2017 historical layers (separate manifest ca_nacei_README.md).
- Storage facilities: no Canada-specific $0 layer found yet.

## Website delivery names
ca_power_lines_hv.geojson = transmission.geojson; ca_power_lines_minor.geojson = distribution.geojson; ca_power_substations.geojson = substations.geojson; ca_power_plants.geojson = plants-generators.geojson. Source attributes and coordinates retained. Plant and generator display layers are filtered views of the same complete download, not additive unique sites.

Data source: https://download.geofabrik.de/north-america/canada.html
License: https://opendatacommons.org/licenses/odbl/1-0/
