HomeProjectsMini Digital Twin — Integrated Passenger-Freight Transport
May 2026Solo builderResearch
Mini Digital Twin — Integrated Passenger-Freight Transport
Three-layer Digital Twin prototype for behaviourally-responsive crowd-shipping: FastAPI mock-IoT data layer, mesa agent-based + simpy discrete-event simulation, Streamlit dashboard with interactive disruption injection. Built for Aston PhD application p196342.
Highlights
- Mirrors Sajadi & Al-Bazi's hybrid DES + ABM supervisory methodology
- Disruption Lab makes behavioural-operational response observable in real time
Problem
The Aston PhD project description (p196342) calls for a Digital Twin framework that integrates technical IPFT operations with behavioural responsiveness under disruption. No publicly available reference architecture demonstrates this hybrid simulation pattern at scale.
Approach
- Data layer: FastAPI mock-IoT (WebSocket bus telemetry every 5s + REST parcel demand)
- Simulation layer: mesa-based passenger agents with detour/reward/trust decision rules + simpy-based freight terminal queueing
- Dashboard layer: Streamlit multi-page (Live Map, KPIs, Disruption Lab, About) with live folium map + plotly time series
- Interactive disruption injection: heavy rain (bus speed -60%), bus breakdown (capacity -30%), parcel surge (demand ×2.5)
Stack
PythonFastAPImesa (ABM)simpy (DES)StreamlitfoliumplotlyPydantic
Outcome
- Smoke-tested: 45% acceptance rate over 20 ticks · 62% terminal utilisation
- 12 files, 1045 lines, publicly available on GitHub
- Referenced as the architectural prototype of Phase 1 in the PhD research statement
Tags