How hytangs/vigo works
VIGO builds a portable City from GTFS and OpenStreetMap, then answers Route, Matrix, and Reach queries through its Rust engine. The compiler, standalone engine, Studio, and Python package are distinct interfaces to this workflow. Studio also supports visual network and live-service inspection and scenario exploration; agency analysis provides service and network assessments. The graph preserves these documented capabilities, but sampled source is incomplete, so some documented links use README evidence rather than inspected call sites.
Main entry points: query.rs Standalone query API · App.tsx Studio application · serviceInspection.mjs Service inspection · vigo.ts City compiler
Components 21
City preparation
- City compiler
src/cli/vigo.ts - Portable City
src/server/national-gtfs-store.mjs - Street data
src/server/national-osm-store.mjs
Routing engine
- Standalone query API
native/vigo-routing-kernel/src/standalone/query.rs - Journey routing
native/vigo-routing-kernel/src/exact_routing.rs - Travel-time matrix
native/vigo-routing-kernel/src/endpoint_batch.rs - Reach analysis
src/reach.ts - Result formatting
native/vigo-routing-kernel/src/presentation.rs
VIGO Studio
- Studio application
src/App.tsx - Routing controls
src/app/useNationalRouting.ts - Application API
src/app/api.ts - Map and results
src/components/studio/RouteSurface.tsx - Scenario planning
src/reach.ts
Agency intelligence
- Service inspection
src/agency/serviceInspection.mjs - Network assessment
src/agency/serviceAssessment.mjs - Live service data
src/agency/realtimeIntelligence.mjs
Other interfaces
- Python interface
python/vigo/runtime.py - Engine CLI and HTTP
native/vigo-routing-kernel/src/bin/vigo.rs
Other components
- GTFS and OSM
- Studio user
- Agency analyst
Connections 21
- GTFS and OSM → City compiler: builds from
README.md - City compiler → Portable City: prepares City
- City compiler → Street data: prepares streets
- Portable City → Standalone query API: queries
- Street data → Standalone query API: queries
- Studio user → Studio application: uses
README.md - Studio application → Routing controls: starts routing
src/App.tsx - Routing controls → Application API: requests routes
src/app/useNationalRouting.ts - Application API → Standalone query API: sends queries
- Standalone query API → Journey routing: routes journeys
- Standalone query API → Travel-time matrix: computes matrices
README.md - Standalone query API → Reach analysis: computes reach
README.md - Standalone query API → Result formatting: formats results
native/vigo-routing-kernel/src/standalone/query.rs - Application API → Map and results: supplies map data
src/components/studio/RouteSurface.tsx - Studio application → Scenario planning: plans scenarios
- Agency analyst → Service inspection: investigates service
- Service inspection → Live service data: uses feed state
src/agency/serviceInspection.mjs - Service inspection → Network assessment: diagnoses network
src/agency/serviceInspection.mjs - Studio application → Service inspection: inspects live service
README.md - Python interface → Standalone query API: runs queries
README.md - Engine CLI and HTTP → Standalone query API: runs queries
README.md