Add wrapper scripts using the new OSM submodule.

Author: njhenry

exploratory/osm_download.py

@@ -8,7 +8,7 @@
 """
 import datetime
 import os
-from openpois.osm_download import (
+from openpois.osm.download import (
     build_date_range,
     collect_element_ids,
     download_element_histories,

exploratory/osm_format_tabular.py

@@ -0,0 +1,49 @@
+"""
+Exploratory script for reformatting OSM data into a tabular format.
+
+This script:
+1. Reads in the OSM versions and changes data from CSV files.
+2. Reconfigures POI changesets into 'observations', which are either changes to the
+   relevant POI tag or confirmation that the tag is unchanged.
+3. Saves the observations to a new CSV file.
+"""
+
+import pandas as pd
+from pathlib import Path
+
+from openpois.osm.format_observations import format_observations
+
+
+# ----------------------------------------------------------------------------------------
+# Configuration constants
+# ----------------------------------------------------------------------------------------
+
+DATA_VERSION = "20260129"
+SAVE_DIR = Path("~/data/openpois").expanduser() / DATA_VERSION
+OSM_KEYS = ["amenity", "shop", "healthcare", "leisure"]
+TAG_KEY = "shop"
+
+
+# ----------------------------------------------------------------------------------------
+# Main workflow
+# ----------------------------------------------------------------------------------------
+
+if __name__ == "__main__":
+    # Read files
+    changes_df = pd.read_csv(SAVE_DIR / "osm_changes.csv")
+    versions_df = pd.read_csv(SAVE_DIR / "osm_versions.csv")
+
+    # Format changes and versions into observations
+    observations_df = format_observations(
+        changes_df = changes_df,
+        versions_df = versions_df,
+        tag_key = TAG_KEY,
+        keep_keys = OSM_KEYS,
+    )
+
+    # Save observations
+    observations_df.to_csv(
+        SAVE_DIR / f"osm_observations_{TAG_KEY}.csv",
+        index = False,
+    )
+    print(f"Saved {len(observations_df)} observations to {out_fp}")