How traffic-forecasting-thesis-group/antroute works
ANTROUTE combines a React Native client with a FastAPI service and traffic-intelligence code. The main user journey is to enter an origin and destinations, request candidate routes, and view route options and comparison metrics. The backend can use a risk-aware graph-routing pipeline when its monitored network data is available, or fall back to placeholder routes and OSRM geometry. The README also describes traffic-data ingestion, text/vision preprocessing, model development, and routing capabilities. Several of those internal links are documented but their runtime orchestration was not sampled, so they are shown only where supported or marked unverified.
Main entry points: risk_routing.py Risk routing · routes.py Route endpoints · dynamic_weight.py Dynamic weights · AppNavigator.tsx App navigation
Components 26
Mobile app
- App shell
frontend/App.js - App navigation
frontend/src/navigation/AppNavigator.tsx - Route planning UI
frontend/src/screens/HomeScreen.tsx - Account screens
frontend/src/screens - Auth service
frontend/src/api/authService.ts - Route service
frontend/src/api/routeService.ts - HTTP client
frontend/src/api/client.ts
API service
- Route endpoints
traffic_system/app/routers/routes.py - Auth endpoints
traffic_system/app/routers/auth.py - Places endpoints
traffic_system/app/routers/places.py - Route orchestration
traffic_system/app/route_engine.py - Database access
traffic_system/app/database.py
Traffic intelligence
- Risk routing
traffic_system/app/risk_routing.py - Road graph
traffic_system/src/data/graph_data.py - Dynamic weights
traffic_system/src/routing/dynamic_weight.py - ETA calculation
traffic_system/src/routing/eta_engine.py - ACO routing
traffic_system/src/routing/aco_routing.py - Traffic events
traffic_system/src/routing/event_layer.py - Traffic models
traffic_system/src/models
Data pipelines
- Traffic ingestion
traffic_system/src/ingestion - CCTV vision pipeline
traffic_system/src/vision - Text preprocessing
traffic_system/src/preprocessing/nlp_pipeline.py - Text cleaning
traffic_system/src/preprocessing/text_cleaner.py
Other components
- Traveler
- OSRM routing
- Route options
Connections 27
- Traveler → App shell: opens app
frontend/App.js - App shell → App navigation: renders
frontend/App.js - App navigation → Route planning UI: routes to
frontend/src/navigation/AppNavigator.tsx - App navigation → Account screens: routes to
frontend/src/navigation/AppNavigator.tsx - Route planning UI → Route service: requests routes
frontend/src/screens/HomeScreen.tsx - Account screens → Auth service: uses auth
frontend/src/screens/EditProfileScreen.tsx - Auth service → HTTP client: sends requests
frontend/src/api/authService.ts - Route service → HTTP client: sends requests
frontend/src/api/routeService.ts - Route service → Route endpoints: posts route plan
frontend/src/api/routeService.ts - Route endpoints → Route orchestration: plans routes
traffic_system/app/routers/routes.py - Route endpoints → OSRM routing: fetches paths
traffic_system/app/routers/routes.py - Route endpoints → Route options: returns options
traffic_system/app/routers/routes.py - Route orchestration → Risk routing: tries real routes
traffic_system/app/route_engine.py - Risk routing → Road graph: loads graph
traffic_system/app/risk_routing.py - Risk routing → Dynamic weights: builds weighted graph
traffic_system/app/risk_routing.py - Risk routing → ETA calculation: loads travel times
traffic_system/app/risk_routing.py - Risk routing → ACO routing: runs route search
traffic_system/app/risk_routing.py - Risk routing → Traffic events: loads events
traffic_system/app/risk_routing.py - Dynamic weights → Road graph: uses graph
traffic_system/src/routing/dynamic_weight.py - ETA calculation → Dynamic weights: scores path
traffic_system/src/routing/eta_engine.py - ACO routing → Dynamic weights: evaluates paths
traffic_system/src/routing/aco_routing.py - Auth endpoints → Database access: uses sessions
traffic_system/app/routers/auth.py - Places endpoints → Database access: queries places
- Traffic ingestion → Road graph: provides road data
- CCTV vision pipeline → Traffic models: supplies visual inputs
- Text preprocessing → Text cleaning: prepares text
- Text preprocessing → Traffic models: generates embeddings