perfect-postcode/pipeline/download/arcgis.py
2026-06-02 20:14:32 +01:00

51 lines
1.9 KiB
Python

import argparse
import tempfile
import polars as pl
from pathlib import Path
from pipeline.local_temp import local_tmp_dir
from pipeline.utils import code_col_overrides, download, extract_zip
URL = "https://www.arcgis.com/sharing/rest/content/items/36b718ad00de49afb9ad364f8b815b9e/data"
def convert_to_parquet(data_path: Path, parquet_path: Path) -> None:
# Classification code columns (e.g. ruc21ind, oac11ind, imd20ind) look
# numeric in early rows but contain string codes like "UN1" (Unclassified)
# later on. Force them to String to avoid mid-stream dtype inference
# failures. NSPL renames these year suffixes each release, and polars
# silently ignores overrides for missing columns, so match on the
# suffix-free stem (read from the header) rather than hard-coding suffixes.
csv_path = data_path / "Data/NSPL_FEB_2026_UK.csv"
names = pl.scan_csv(csv_path).collect_schema().names()
df = pl.scan_csv(
csv_path,
try_parse_dates=True,
schema_overrides=code_col_overrides(names),
)
print(f"Columns: {df.collect_schema().names()}")
parquet_path.parent.mkdir(parents=True, exist_ok=True)
df.sink_parquet(parquet_path, compression="zstd")
print(f"Saved to {parquet_path}")
def main() -> None:
parser = argparse.ArgumentParser(
description="Download and convert ArcGIS postcode data"
)
parser.add_argument(
"--output", type=Path, required=True, help="Output parquet file path"
)
args = parser.parse_args()
with tempfile.TemporaryDirectory(dir=local_tmp_dir()) as cache_dir:
download_path = Path(cache_dir) / "arcgis_data.zip"
extract_path = Path(cache_dir) / "arcgis_extracted"
download(URL, download_path)
extract_zip(download_path, extract_path)
convert_to_parquet(extract_path, args.output)
if __name__ == "__main__":
main()