Add cached OSM test mode

.gitignore

@@ -27,6 +27,7 @@ examples/research/**/*.json
 
 # OSM cache and large outputs
 cache/
+nomad/tests/tmp_osm_cache/
 examples/output/
 examples/research/virtual_philadelphia/*.gpkg
 
@@ -42,6 +43,7 @@ pip
 tutorials/IC2S2-2025/tutorial-sample/*
 
 # Development environment configurations (personal/local only)
+AGENTS.md
 .vscode/
 .idea/
 *.code-workspace

README.md

@@ -34,6 +34,9 @@ The examples/ folder contains notebooks and small sample datasets that demonstra
 
 ## Contribute 
 For development clone the repository and ensure unit tests, located in `nomad\tests\' are passed before submitting a pull request.
+
+Mapping tests use a local OSM cache by default. Create or refresh it with `python -m nomad.data.generate_osm_test_cache`, then run `pytest nomad/tests/test_maps.py`. To run against live OSM instead, set `NOMAD_OSM_TEST_CACHE=0` first (PowerShell: `$env:NOMAD_OSM_TEST_CACHE = "0"`). This mode uses pytest's built-in `monkeypatch` fixture; do not install a separate monkeypatch package. If cached files are missing or stale, rerun the cache script. Keep generated geospatial artifacts out of git unless their size has been reviewed, since OSM extracts can bloat repository history quickly.
+
 ## License 
 MIT © University of Pennsylvania 2025.
 

examples/hdbscan_demo.ipynb

@@ -33,6 +33,7 @@
     "from shapely.geometry import box\n",
     "from nomad.stop_detection.viz import plot_stops_barcode, plot_time_barcode, plot_stops, plot_pings\n",
     "import nomad.stop_detection.hdbscan as HDBSCAN\n",
+    "import time\n",
     "\n",
     "# Load data\n",
     "import nomad.data as data_folder\n",
@@ -92,7 +93,7 @@
  ],
  "metadata": {
   "kernelspec": {
-   "display_name": "Python 3",
+   "display_name": ".venv",
    "language": "python",
    "name": "python3"
   },
@@ -106,7 +107,7 @@
    "name": "python",
    "nbconvert_exporter": "python",
    "pygments_lexer": "ipython3",
-   "version": "3.12.3"
+   "version": "3.9.6"
   }
  },
  "nbformat": 4,