README.md

---
title: NYC Taxi Mobility Equity Dashboard
colorFrom: blue
colorTo: green
sdk: docker
pinned: false
license: mit
---

# NYC Mobility Equity Dashboard
_Debayan Mandal_

An interactive Voilà + gridstack dashboard analyzing whether **FHV** and
**Yellow Taxi** services are equitably distributed across NYC neighborhoods
relative to demographic baselines.

## Features

- **Pickup & Drop-off choropleth maps** for FHV and Yellow Taxi by month
- **Diverging demographic maps** showing deviation from citywide population baselines
- **Top-10 stats tables** split by service and direction
- **Month slider** to explore Jan–Mar 2025 data

## Data Sources

- [NYC TLC Trip Record Data](https://www.nyc.gov/site/tlc/about/tlc-trip-record-data.page) (parquet via CloudFront)
- [NYC Taxi Zones](https://data.source.coop/cholmes/nyc-taxi-zones/) (Source Cooperative)
- [NYC Census Blocks](https://opengeos.org/data/duckdb/nyc_data.db.zip) (OpenGeos)

## Architecture

| File | Purpose |
|------|---------|
| `data_pipeline.py` | DuckDB setup, spatial joins, trip ingestion, relative risk |
| `dashboard_helpers.py` | Reusable map and stats-table builder functions |
| `app.ipynb` | Slim notebook — imports, widgets, layout, trigger |
| `Dockerfile` | Container setup for Hugging Face Spaces |

## Local Development

```bash
pip install -r requirements.txt
voila app.ipynb --template=gridstack
```

## Course

GIS 322: GIS Programming II, Arizona State University