SkillAgentSearch skills...

UrbanMapper

Spatial Join & Enrich any urban layer given any external urban dataset of interest, streamline your urban analysis with Scikit-Learn-Like pipelines, and share your insights with the urban research community!

Install / Use

/learn @VIDA-NYU/UrbanMapper
About this skill

Quality Score

0/100

Supported Platforms

Universal

README

<div align="center"> <h1>UrbanMapper</h1> <h3>Enrich Urban Layers Given Urban Datasets</h3> <p><i>with ease-of-use API and Sklearn-alike Shareable & Reproducible Urban Pipeline</i></p> <p> <img src="https://img.shields.io/pypi/v/urban-mapper?label=Version&style=for-the-badge" alt="PyPI Version"> <img src="https://img.shields.io/static/v1?label=Beartype&message=compliant&color=4CAF50&style=for-the-badge&logo=https://avatars.githubusercontent.com/u/63089855?s=48&v=4&logoColor=white" alt="Beartype compliant"> <img src="https://img.shields.io/static/v1?label=UV&message=compliant&color=2196F3&style=for-the-badge&logo=UV&logoColor=white" alt="UV compliant"> <img src="https://img.shields.io/static/v1?label=RUFF&message=compliant&color=9C27B0&style=for-the-badge&logo=RUFF&logoColor=white" alt="RUFF compliant"> <img src="https://img.shields.io/badge/Jupyter-F37626?style=for-the-badge&logo=jupyter&logoColor=white" alt="Jupyter"> <img src="https://img.shields.io/static/v1?label=Python&message=3.10%2B&color=3776AB&style=for-the-badge&logo=python&logoColor=white" alt="Python 3.10+"> <img src="https://img.shields.io/github/actions/workflow/status/VIDA-NYU/UrbanMapper/compile.yaml?style=for-the-badge&label=Compilation&logo=githubactions&logoColor=white" alt="Compilation Status"> </p> </div>

UrbanMapper Cover


[!IMPORTANT]

  • 📹 UrbanMapper got its first Model Context Protocol (MCP) 👉https://www.youtube.com/watch?v=6gLkmKevj8Y 👈
  • 🤝 We support JupyterGIS following one of your Urban Pipeline's analysis for collaborative in real-time exploration on Jupyter 🏂 Shout-out to @mfisher87 and JGIS team for their tremendous help.

UrbanMapper, In a Nutshell

UrbanMapper lets you link your data to spatial features—matching, for example, traffic events to streets—to enrich each location with meaningful, location-based information. Formally, it defines a spatial enrichment function $f(X, Y) = X \bowtie Y$, where $X$ represents urban layers (e.g., Streets, Sidewalks, Intersections and more) and $Y$ is a user-provided dataset (e.g., traffic events, sensor data). The operator $\bowtie$ performs a spatial join, enriching each feature in $X$ with relevant attributes from $Y$.

In short, UrbanMapper is a Python toolkit that enriches typically plain urban layers with datasets in a reproducible, shareable, and easily updatable way using minimal code. For example, given traffic accident data and a streets layer from OpenStreetMap, you can compute accidents per street with a Scikit-Learn–style pipeline called the Urban Pipeline—in under 15 lines of code. As your data evolves or team members want new analyses, you can share and update the Urban Pipeline like a trained model, enabling others to run or extend the same workflow without rewriting code.

There are more to UrbanMapper, explore!


Installation

Install UrbanMapper via pip (works in any environment):

pip install urban-mapper

Then launch Jupyter Lab to explore UrbanMapper:

jupyter lab

[!TIP] We recommend installing UrbanMapper in a virtual environment to keep things tidy and avoid dependency conflicts. You can find detailed instructions—including how to install within a virtual environment using uv, conda or from source in the UrbanMapper Installation Guide.


Getting Started with UrbanMapper

We highly recommend exploring the UrbanMapper Documentation, starting with the homepage general information and then the Getting Started section.

Once you have grasped the basics, we recommend exploring the Interactive Examples or running yourself the notebooks through the examples/ directory.


Licence

UrbanMapper is released under the MIT Licence.

Acknowledgments

This work is supported by the NSF and is part of the OSCUR initiative.

<img src="docs/public/resources/oscur_logo_gray.png" width="200px">

Related Skills

View on GitHub
GitHub Stars63
CategoryEducation
Updated21d ago
Forks3

Languages

Python

Security Score

95/100

Audited on Mar 11, 2026

No findings