Use 2.0 Beta 0

.github/workflows/tests.yml

@@ -23,25 +23,30 @@ jobs:
     steps:
       - name: Checkout repo
         uses: actions/checkout@v4
-        with:
-          fetch-depth: 2
 
       - name: Create environment with Micromamba
         uses: mamba-org/setup-micromamba@v1
         with:
-          cache-downloads: true
           cache-environment: true
           environment-file: environment.yml
           post-cleanup: none
 
-      - name: Lint notebooks
-        run: |
-          SKIP=no-commit-to-branch pre-commit run --all-files
+      - name: Cache pre-commit
+        uses: actions/cache@v4
+        with:
+          path: ~/.cache/pre-commit/
+          key: pre-commit-${{ matrix.os }}-${{ hashFiles('.pre-commit-config.yaml') }}
+
+      - name: Run pre-commit checks
+        run: pre-commit run --all-files
+        env:
+          SKIP: no-commit-to-branch
 
       - name: Test notebooks
         run: |
+          ipython -c "import osmnx; print(osmnx.__version__)"
           cd ./notebooks
           rm -r -f *.py
           jupyter nbconvert --to python *.ipynb
-          for f in *.py; do ipython "$f"; done
+          for filename in *.py; do ipython "$filename"; done
           rm -r -f *.py

CITATION.cff

@@ -0,0 +1,21 @@
+cff-version: 1.2.0
+message: "If you use OSMnx, please cite the preferred-citation below."
+title: "OSMnx Examples"
+abstract: "Gallery of OSMnx tutorials, usage examples, and feature demonstations."
+authors:
+- family-names: "Boeing"
+  given-names: "Geoff"
+  orcid: "https://orcid.org/0000-0003-1851-6411"
+  website: "https://geoffboeing.com"
+url: "https://osmnx.readthedocs.org"
+repository-code: "https://github.com/gboeing/osmnx-examples"
+preferred-citation:
+  type: report
+  title: "Modeling and Analyzing Urban Networks and Amenities with OSMnx"
+  authors:
+  - family-names: "Boeing"
+    given-names: "Geoff"
+    orcid: "https://orcid.org/0000-0003-1851-6411"
+    website: "https://geoffboeing.com"
+  year: 2024
+  url: "https://geoffboeing.com/publications/osmnx-paper/"

environment.yml

@@ -1,10 +1,29 @@
 name: osmnx-examples
 channels:
   - conda-forge
+
 dependencies:
+  # OSMnx required/optional dependencies
+  - gdal
+  - geopandas
+  - matplotlib
+  - networkx
+  - numpy
+  - pandas
+  - rasterio
+  - requests
+  - scipy
+  - scikit-learn
+  - shapely
+
+  # other packages needed for CI or running examples
   - jupyterlab
-  - osmnx=1.9.3
   - pillow
   - pre-commit
-  - python=3.11.*
+  - python=3.12.*
   - python-igraph
+
+  # install OSMnx beta via pip
+  - pip
+  - pip:
+      - osmnx==2.0.0b0

notebooks/00-osmnx-features-demo.ipynb

@@ -454,7 +454,7 @@
    "name": "python",
    "nbconvert_exporter": "python",
    "pygments_lexer": "ipython3",
-   "version": "3.11.9"
+   "version": "3.12.3"
   }
  },
  "nbformat": 4,

notebooks/01-overview-osmnx.ipynb

@@ -344,7 +344,7 @@
    "outputs": [],
    "source": [
     "# turn off strict mode and see what nodes we'd remove, in yellow\n",
-    "nc = [\"r\" if ox.simplification._is_endpoint(G, node, None) else \"y\" for node in G.nodes()]\n",
+    "nc = [\"r\" if ox.simplification._is_endpoint(G, node, None, None) else \"y\" for node in G.nodes()]\n",
     "fig, ax = ox.plot_graph(G, node_color=nc)"
    ]
   },
@@ -484,7 +484,7 @@
    "name": "python",
    "nbconvert_exporter": "python",
    "pygments_lexer": "ipython3",
-   "version": "3.11.9"
+   "version": "3.12.3"
   }
  },
  "nbformat": 4,

notebooks/04-simplify-graph-consolidate-nodes.ipynb

@@ -149,7 +149,7 @@
    "outputs": [],
    "source": [
     "# show which nodes we'd remove if we simplify it (yellow)\n",
-    "nc = [\"r\" if ox.simplification._is_endpoint(G, node, None) else \"y\" for node in G.nodes()]\n",
+    "nc = [\"r\" if ox.simplification._is_endpoint(G, node, None, None) else \"y\" for node in G.nodes()]\n",
     "fig, ax = ox.plot_graph(G, node_color=nc)"
    ]
   },
@@ -182,7 +182,9 @@
    "outputs": [],
    "source": [
     "# turn off strict mode and see what nodes we'd remove\n",
-    "nc = [\"r\" if ox.simplification._is_endpoint(G, node, [\"osmid\"]) else \"y\" for node in G.nodes()]\n",
+    "nc = [\n",
+    "    \"r\" if ox.simplification._is_endpoint(G, node, [\"osmid\"], None) else \"y\" for node in G.nodes()\n",
+    "]\n",
     "fig, ax = ox.plot_graph(G, node_color=nc)"
    ]
   },
@@ -233,7 +235,7 @@
    "name": "python",
    "nbconvert_exporter": "python",
    "pygments_lexer": "ipython3",
-   "version": "3.11.9"
+   "version": "3.12.3"
   }
  },
  "nbformat": 4,

notebooks/10-building-footprints.ipynb

@@ -71,7 +71,7 @@
    "source": [
     "# save as a GeoPackage\n",
     "gdf_save = gdf.map(lambda x: str(x) if isinstance(x, list) else x)\n",
-    "gdf_save.drop(labels=\"nodes\", axis=1).to_file(\"./data/piedmont_bldgs.gpkg\", driver=\"GPKG\")"
+    "gdf_save.to_file(\"./data/piedmont_bldgs.gpkg\", driver=\"GPKG\")"
    ]
   },
   {
@@ -110,7 +110,7 @@
    "source": [
     "# get the total area within Piedmont's admin boundary in sq meters\n",
     "place = ox.geocode_to_gdf(\"Piedmont, California, USA\")\n",
-    "place_proj = ox.project_gdf(place)\n",
+    "place_proj = ox.projection.project_gdf(place)\n",
     "place_proj.area.iloc[0]"
    ]
   },
@@ -140,7 +140,7 @@
     "point = (48.873446, 2.294255)\n",
     "dist = 612\n",
     "gdf = ox.features_from_point(point, tags, dist=dist)\n",
-    "gdf_proj = ox.project_gdf(gdf)\n",
+    "gdf_proj = ox.projection.project_gdf(gdf)\n",
     "bbox = ox.utils_geo.bbox_from_point(point=point, dist=dist, project_utm=True)\n",
     "fp = f\"./{img_folder}/paris_bldgs.{extension}\"\n",
     "fig, ax = ox.plot_footprints(\n",
@@ -262,9 +262,9 @@
  "metadata": {
   "anaconda-cloud": {},
   "kernelspec": {
-   "display_name": "Python (ox)",
+   "display_name": "Python 3 (ipykernel)",
    "language": "python",
-   "name": "ox"
+   "name": "python3"
   },
   "language_info": {
    "codemirror_mode": {
@@ -276,7 +276,7 @@
    "name": "python",
    "nbconvert_exporter": "python",
    "pygments_lexer": "ipython3",
-   "version": "3.11.9"
+   "version": "3.12.3"
   }
  },
  "nbformat": 4,

notebooks/11-interactive-web-mapping.ipynb

@@ -272,9 +272,9 @@
  "metadata": {
   "anaconda-cloud": {},
   "kernelspec": {
-   "display_name": "Python (ox)",
+   "display_name": "Python 3 (ipykernel)",
    "language": "python",
-   "name": "ox"
+   "name": "python3"
   },
   "language_info": {
    "codemirror_mode": {
@@ -286,7 +286,7 @@
    "name": "python",
    "nbconvert_exporter": "python",
    "pygments_lexer": "ipython3",
-   "version": "3.11.9"
+   "version": "3.12.3"
   }
  },
  "nbformat": 4,

notebooks/12-node-elevations-edge-grades.ipynb

@@ -344,9 +344,9 @@
  ],
  "metadata": {
   "kernelspec": {
-   "display_name": "Python (ox)",
+   "display_name": "Python 3 (ipykernel)",
    "language": "python",
-   "name": "ox"
+   "name": "python3"
   },
   "language_info": {
    "codemirror_mode": {
@@ -358,7 +358,7 @@
    "name": "python",
    "nbconvert_exporter": "python",
    "pygments_lexer": "ipython3",
-   "version": "3.11.9"
+   "version": "3.12.3"
   }
  },
  "nbformat": 4,

notebooks/13-isolines-isochrones.ipynb

@@ -234,9 +234,9 @@
  ],
  "metadata": {
   "kernelspec": {
-   "display_name": "Python (ox)",
+   "display_name": "Python 3 (ipykernel)",
    "language": "python",
-   "name": "ox"
+   "name": "python3"
   },
   "language_info": {
    "codemirror_mode": {
@@ -248,7 +248,7 @@
    "name": "python",
    "nbconvert_exporter": "python",
    "pygments_lexer": "ipython3",
-   "version": "3.11.9"
+   "version": "3.12.3"
   }
  },
  "nbformat": 4,

notebooks/14-osmnx-to-igraph.ipynb

@@ -209,9 +209,9 @@
  ],
  "metadata": {
   "kernelspec": {
-   "display_name": "Python (ox)",
+   "display_name": "Python 3 (ipykernel)",
    "language": "python",
-   "name": "ox"
+   "name": "python3"
   },
   "language_info": {
    "codemirror_mode": {
@@ -223,7 +223,7 @@
    "name": "python",
    "nbconvert_exporter": "python",
    "pygments_lexer": "ipython3",
-   "version": "3.11.9"
+   "version": "3.12.3"
   }
  },
  "nbformat": 4,

notebooks/15-advanced-plotting.ipynb

@@ -316,9 +316,9 @@
  ],
  "metadata": {
   "kernelspec": {
-   "display_name": "Python (ox)",
+   "display_name": "Python 3 (ipykernel)",
    "language": "python",
-   "name": "ox"
+   "name": "python3"
   },
   "language_info": {
    "codemirror_mode": {
@@ -330,7 +330,7 @@
    "name": "python",
    "nbconvert_exporter": "python",
    "pygments_lexer": "ipython3",
-   "version": "3.11.9"
+   "version": "3.12.3"
   }
  },
  "nbformat": 4,

notebooks/16-download-osm-geospatial-features.ipynb

@@ -123,9 +123,9 @@
  ],
  "metadata": {
   "kernelspec": {
-   "display_name": "Python (ox)",
+   "display_name": "Python 3 (ipykernel)",
    "language": "python",
-   "name": "ox"
+   "name": "python3"
   },
   "language_info": {
    "codemirror_mode": {
@@ -137,7 +137,7 @@
    "name": "python",
    "nbconvert_exporter": "python",
    "pygments_lexer": "ipython3",
-   "version": "3.11.9"
+   "version": "3.12.3"
   }
  },
  "nbformat": 4,

notebooks/17-street-network-orientations.ipynb

@@ -131,9 +131,9 @@
  ],
  "metadata": {
   "kernelspec": {
-   "display_name": "Python (ox)",
+   "display_name": "Python 3 (ipykernel)",
    "language": "python",
-   "name": "ox"
+   "name": "python3"
   },
   "language_info": {
    "codemirror_mode": {
@@ -145,7 +145,7 @@
    "name": "python",
    "nbconvert_exporter": "python",
    "pygments_lexer": "ipython3",
-   "version": "3.11.9"
+   "version": "3.12.3"
   }
  },
  "nbformat": 4,