# Q-Raftar (کیو-رفتار) — Karachi Quantum Transit Optimizer
> Production-grade civic tech and quantum optimization platform for Karachi's public transit network, utilizing QUBO Hamiltonian formulations executed on IBM Quantum backends with GIS spatial intelligence.

## Overview
- **System Name**: Q-Raftar (کیو-رفتار)
- **Primary Domain**: Karachi Urban Transit, Spatial Mobility & Quantum Fleet Optimization
- **Parent Initiative**: SBF Consultancy CSR (Corporate Social Responsibility) — Fee-Sabeel-Allah Public Good
- **Consultancy Website**: https://sbf-consultancy.net
- **Target City**: Karachi, Sindh, Pakistan (Metropolitan Population: ~20.3 Million)
- **Problem Statement**: Karachi operates fewer than 1,100 active mass transit buses against an audited requirement of 15,000+, causing acute overcrowding, deadhead mileage, excessive diesel expenditure, and uncoordinated headways.

## Core Capabilities
- **Quantum Hamiltonian Formulation**: Formulates multi-depot transit routing and fleet rebalancing as a Quadratic Unconstrained Binary Optimization (QUBO) problem executed via IBM Quantum (Qiskit Runtime V2 / Aer Simulator / Simulated Annealing).
- **GIS Network Modeling**: Snaps to real-world OpenStreetMap road graphs via OSMnx, covering 40 major Karachi hubs and 8 surveyed arterial corridors.
- **OPEX Mathematical Engine**: Dynamically calculates diesel fuel costs (PKR), deadhead mileage reduction (up to 38.4%), headway adjustments (from 25m down to 8-10m), and CO2 emission reductions.
- **Fleet Re-Allocation Matrix**: Identifies route-by-route seat capacity deficits and reallocates rolling stock from surplus/low-congestion routes to severe-overload arterial lines.

## Key Statistics & Benchmarks
- **Monitored Transit Hubs**: 40 multimodal Karachi hubs (Tower, Saddar, Numaish, NIPA, Sohrab Goth, Korangi Crossing, Airport, etc.)
- **Surveyed Arterial Corridors**: 8 primary transit lines (Peoples Bus Service Routes 1, 2, 3, 9, 10; Green Line BRT; Orangi-Clifton Feeder; Malir-Tower Express)
- **Daily Monitored Ridership**: ~295,000 passenger trips across surveyed baseline routes
- **Optimized Fleet Surplus / Deficit**: Recommended net reallocation of 142 vehicles to eliminate severe peak-hour crush loads
- **Projected Monthly Fuel Savings**: ~PKR 42.6 Million reduction in deadhead diesel consumption

## API Endpoints
- `GET /api/health` — Platform telemetry & status
- `GET /api/quantum/status` — IBM Quantum backend availability & QPU queue status
- `GET /api/network/roads` — GeoJSON Karachi road topology and hub graph
- `GET /api/network/baseline-routes` — Surveyed routes, bus counts, headways, and demand-supply ratios
- `POST /api/optimizer/run` — Run QUBO/Ising quantum annealing with custom fuel and headway parameters

## Reference Links & Open Data
- Visual & Technical Sitemap: `/sitemap`
- XML Sitemap: `/sitemap.xml`
- Keywords Registry: `/keywords.json`
- Full Technical LLM Index: `/llms-full.txt`
- Web Manifest: `/manifest.webmanifest`
- SBF Consultancy: `https://sbf-consultancy.net`