Skip to content
jtang25Public

About

Emergency-response risk forecasting and vehicle rebalancing using machine learning and optimization

Resources

Stars

0 stars

Watchers

0 watching

Forks

Latest commit

 

History

13 Commits

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Seattle Emergency Risk Optimizer (SERO)

SERO is a map-based emergency fleet planning app.

It ingests Seattle fire/police 911 open data into a Supabase (Postgres) backend, learns a spatio-temporal risk model over the city, and computes optimized vehicle deployments across stations. Planners can visualize risk in real-time, edit station layouts, and run an optimizer that recommends concrete rebalancing moves to better cover predicted demand.

sero_demo.1.mp4

Features

  • Live risk heatmap

    • City grid over Seattle with per-cell risk scores in “the next few hours”.
    • Shows both probability of at least one incident and expected incident volume.
  • Station editor

    • Configure fire/police/EMS s tations with current vehicle counts.
    • Visualize deployments and station catchments on an interactive map.
  • Optimization engine

    • Two-stage decision layer:
      1. Aggregates predicted demand into local risk around each station.
      2. Solves a min-cost flow to compute vehicle moves between stations while preserving fleet size.
    • Returns explicit moves: “Send 2 vehicles from FS3 → FS1”.
  • AIP-style web UI

    • React + TypeScript + Mapbox dashboard.
    • Risk grid, stations, and rebalancing moves rendered together for human-in-the-loop planning.

Tech Stack

Data & Storage

  • Supabase (managed Postgres) for:
    • fire_incidents – raw fire calls
    • police_calls – raw police calls
    • incident_counts – per-grid-cell, per-hour counts used by the risk model

Backend

  • Python 3
  • FastAPI (REST APIs)
  • SQLAlchemy for DB access
  • XGBoost for classification / regression
  • scikit-learn for preprocessing (SimpleImputer, etc.)
  • OR-Tools (CBC solver) for min-cost flow optimization
  • Uvicorn for local dev server

Frontend

  • Next.js / React / TypeScript
  • Mapbox GL JS via react-map-gl
  • Tailwind CSS

High-Level Architecture

Raw 911 Data ──► Supabase/Postgres ──► Offline Training (notebooks/)
                                       │
                                       ▼
                             risk_xgb.pkl (classifier)
                             risk_xgb_total.pkl (regressor)
                             risk_imputer.pkl
                                       │
                       ┌───────────────┴────────────────┐
                       ▼                                ▼
                 /risk/latest                     /optimize/deployment
              (FastAPI router)                   (FastAPI router)
                       │                                │
                       ▼                                ▼
              React/TS + Mapbox UI  ◄─────────────── User

---

## RAG Chatbot (911 Q&A)

SERO includes a retrieval-augmented chat assistant that answers questions using
incident records, cell summaries, and the current map context.

Setup:

1. Enable pgvector and create the embedding tables/functions.
   - Run `backend/sql/vector_search.sql` in the Supabase SQL editor.
2. Generate embeddings for existing data.
   - `python backend/scripts/embed_records.py --target all`
3. Configure environment variables.
   - `OPENAI_API_KEY` (required)
   - `OPENAI_EMBED_MODEL` (default: `text-embedding-3-small`)
   - `OPENAI_CHAT_MODEL` (default: `gpt-4o-mini`)
4. Use the chat endpoints.
   - `POST /chat/stream` for SSE streaming
   - `POST /chat` for a single response payload

Notes:

- The chat panel sends map center, selected cell, and deployment summary in
  `view_state` to ground answers.
- Re-run the embedding script periodically to keep new incidents searchable.

About

Emergency-response risk forecasting and vehicle rebalancing using machine learning and optimization

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages