| --- |
| title: SF Taxi Mobility Equity Dashboard |
| emoji: 🚕 |
| colorFrom: blue |
| colorTo: yellow |
| sdk: docker |
| app_port: 7860 |
| pinned: True |
| --- |
| |
| # SF Taxi Mobility Equity Dashboard |
|
|
| An interactive Plotly Dash dashboard analyzing spatial equity in San Francisco taxi services. Compares **Street-Hail** vs **App-Based** trip patterns across SF's 41 Analysis Neighborhoods and evaluates service representation relative to demographic baselines using Representative Ratios. |
|
|
| _Debayan Mandal_ |
|
|
| ## Features |
|
|
| - **Interactive choropleth maps** — click any neighborhood to cross-filter all views |
| - **Representative Ratio visualizations** — bar chart and heatmap showing the central equity metric (overrepresentation vs underrepresentation by demographic group) |
| - **Neighborhood detail panel** — click to see full profile: trips, demographics, deviations, and trends |
| - **Monthly comparison** — side-by-side difference maps revealing temporal trends |
| - **Dynamic narrative** — auto-generated equity insights that update with your selections |
| - **CSV data export** — download filtered trip + demographic data |
| - **Publication-ready image export** — high-resolution PNG via the camera icon on each map |
| - **Guided tour** — step-by-step walkthrough for non-technical audiences |
| - **Colorblind-safe palettes** — Viridis, Cividis, and RdBu scales |
|
|
| ## Data Sources |
|
|
| - **SF Taxi Trips**: [DataSF Taxi Trips (m8hk-2ipk)](https://data.sfgov.org/Transportation/Taxi-Trips/m8hk-2ipk/) |
| - **SF Analysis Neighborhoods**: [DataSF Analysis Neighborhoods (j2bu-swwd)](https://data.sfgov.org/resource/j2bu-swwd.geojson) |
| - **Census Demographics**: [ACS 5-Year 2022, Table B02001](https://api.census.gov/data/2022/acs/acs5.html), Block Groups for SF County (FIPS 06075) |
| - **Block Group Geometries**: [TIGER/Line 2022](https://www2.census.gov/geo/tiger/TIGER2022/BG/tl_2022_06_bg.zip) |
|
|
| ## Local Setup |
|
|
| ```bash |
| pip install -r requirements.txt |
| python data_pipeline.py # builds sf_dashboard.db |
| python app.py # opens dashboard at http://localhost:7860 |
| ``` |
|
|
| ## Docker |
|
|
| ```bash |
| docker build -t sf-taxi-dashboard . |
| docker run -p 7860:7860 sf-taxi-dashboard |
| ``` |
|
|
| Then open http://localhost:7860. |
|
|
| ## Architecture |
|
|
| | File | Purpose | |
| |------|---------| |
| | `data_pipeline.py` | Downloads taxi trips, neighborhoods, and census data; builds `sf_dashboard.db` | |
| | `dashboard_helpers.py` | Plotly figure builders and data query helpers | |
| | `app.py` | Plotly Dash application layout and callbacks | |
| | `assets/styles.css` | Custom CSS | |
| | `requirements.txt` | Python dependencies | |
| | `Dockerfile` | Containerization for Hugging Face Spaces | |
|
|
