Urban Mobility Decision Intelligence

📖 Documentation

  • Problem Formulation
    • Spatial-Temporal Taxi Zone Recommendation
      • Definition
      • State Space
      • Action Space
      • Objective
      • Reward Model
      • Transition Dynamics
      • Relocation Cost
      • Evaluation Metrics
      • Constraints
  • Methodology
    • Problem definition
    • Temporal protocol
    • Data cleaning
    • Baseline 1: hot zones
    • Baseline 2: single-step utility
    • Finite-horizon continuation model
    • Corrected model-based MDP
    • Static evaluation
    • Rollout evaluation
    • Statistical analysis
    • Counterfactual evaluation
    • Exposure analysis
  • Supervised Forecasting
    • Scope
    • Data and temporal boundary
    • Features
    • Outputs
    • Results and ablation
    • Reproduction
    • Limitations
  • Graph Learning
    • Leakage boundary
    • Features and models
    • Results
    • Reproduction
  • Multi-Agent Simulator
    • Purpose
    • Event semantics
    • Demand/supply ratio
    • Metrics
    • Benchmark
    • Reproduction
    • Remaining limitations
  • DQN and Double-DQN Baselines
    • Scope
    • Temporal isolation
    • Environment
    • Algorithms
    • Benchmark
    • Reproduction
  • Combined Benchmark
    • Endpoint matrix
    • Main conclusions
    • Reproduction
  • Reproducible Sensitivity and Ablation Results
    • Planning horizon
    • Executable parameter grid
    • Stress tests
    • Exposure concentration
    • Unsupported ablations removed

🧭 Platform

  • Decision Engine
    • Overview
    • Architecture
    • Schema
      • Recommendation
      • RankedZone
    • Policies
    • Constraints
    • Usage
    • Important Notes
  • API Documentation
    • Decision Intelligence Platform API
      • Source Label
      • Endpoints
      • Error Handling
      • Model Names
      • Interactive Docs
  • Leaderboard
    • Scope & Honesty Statement
    • Policy Leaderboard
    • Forecast Leaderboard (held-out)
    • External Submissions
    • How to Regenerate
  • Benchmark Protocol v2.0
    • Dataset
    • Task Definition
      • Forecasting Sub-task
      • Decision Making Sub-task
      • Offline RL Sub-task
    • Metrics
      • Forecasting
      • Decision Making
      • Offline RL
    • Baselines
      • Forecasting
      • Decision Making
      • RL
    • Evaluation Procedure
    • Reproducibility Requirements
  • Shadow Evaluation
    • Purpose
    • Principle
    • Current Status
    • Usage
    • Output Schema
    • Limitations
    • Production Path
  • Historical Replay Evaluation
    • Goal
    • Methodology
    • Results
    • Comparison with Simulator
    • Limitations
  • LLM Mobility Agent
    • What it is
    • Design
    • Honesty contract
    • Providers
    • Wire a provider
    • Run
  • Cross-City Extension Framework
    • Goal
    • Current Status
    • City Configuration
    • Required Data for New Cities
    • Extension Steps
    • Limitations
    • Future Work

🔬 Research Notes

  • Decision-Aware Forecasting
    • Research Question
    • Key Finding
    • Experiment Design
      • Models Compared
      • Metrics
    • Hypotheses
      • H1: Forecast MAE correlates with decision quality
      • H2: Decision-aware training outperforms metric-oriented training
      • H3: Oracle forecasting provides an upper bound
    • Experiment Script
    • Research Directions
      • 1. Ranking-Optimized Forecasting
      • 2. Direct Policy Evaluation
      • 3. Calibration-Aware Training
      • 4. Contextual Decision Quality
    • References
  • Multi-Agent Market Effect of AI Policy Adoption
    • Experiment
    • Results
    • Interpretation
    • Limitations (read before citing)
    • Follow-up directions

🔧 API Reference

  • Unified Data Loader
    • DataLoader
      • DataLoader.project_root
      • DataLoader.zone_count
      • DataLoader.slot_count
      • DataLoader.__init__()
      • DataLoader.datetime_to_state()
      • DataLoader.load_train_data()
      • DataLoader.load_travel_time_matrix()
      • DataLoader.load_zone_statistics()
      • DataLoader.next_half_hour()
  • Configuration System
    • get_config()
    • load_config()
    • reload_config()
  • Finite-Horizon Strategy
  • MDP Solver
    • MDPValueIteration
      • MDPValueIteration.q_values()
      • MDPValueIteration.recommend()
    • bellman_backup()
    • recommend()
  • Demo Gallery
    • Scenario: Rainy Friday Evening in Manhattan
      • The problem
      • AI decision process
      • The result
    • Benchmark Dashboard
      • Static diagnostic (3,360 queries)
      • Rollout performance
      • Multi-agent competition
    • NYC Map Visualization
    • Reproducibility
    • More scenarios
Urban Mobility Decision Intelligence
  • Index

Index

_ | B | D | G | L | M | N | P | Q | R | S | Z

_

  • __init__() (src.common.data_loader.DataLoader method)

B

  • bellman_backup() (in module src.mdp.model_based)

D

  • DataLoader (class in src.common.data_loader)
  • datetime_to_state() (src.common.data_loader.DataLoader method)

G

  • get_config() (in module src.common.config)

L

  • load_config() (in module src.common.config)
  • load_train_data() (src.common.data_loader.DataLoader method)
  • load_travel_time_matrix() (src.common.data_loader.DataLoader method)
  • load_zone_statistics() (src.common.data_loader.DataLoader method)

M

  • MDPValueIteration (class in src.mdp.model_based)
  • module
    • src.common.config
    • src.common.data_loader
    • src.mdp.model_based

N

  • next_half_hour() (src.common.data_loader.DataLoader static method)

P

  • project_root (src.common.data_loader.DataLoader attribute)

Q

  • q_values() (src.mdp.model_based.MDPValueIteration method)

R

  • recommend() (in module src.mdp.model_based)
    • (src.mdp.model_based.MDPValueIteration method)
  • reload_config() (in module src.common.config)

S

  • slot_count (src.common.data_loader.DataLoader attribute)
  • src.common.config
    • module
  • src.common.data_loader
    • module
  • src.mdp.model_based
    • module

Z

  • zone_count (src.common.data_loader.DataLoader attribute)

© Copyright 2026, Zefan Cai.

Built with Sphinx using a theme provided by Read the Docs.