Welcome to utdf2gmns documentation!
An AMS (Analysis, Modeling and Simulation) tool to convert utdf file to different formats, including GMNS, SUMO etc.
utdf2gmns explored an automatic process of network coordinating, traffic signal integration, traffic flow conversion from Synchro to SUMO, identifying both the feasibility and challenges involved. The approach began with a comparative analysis of traffic network features, data formats, and signal timing schemas between the two platforms. Key challenges in converting Synchro UTDF data into microsimulation-ready networks focusing on signal integration, spatial conversion, and turning flow accuracy. Signal conversion remains a critical bottleneck, requiring precise alignment of phasing, timing, and coordination data to ensure reliable simulation outcomes. Network conversion also presents difficulties, particularly in translating Synchro’s relative coordinate system into georeferenced formats compatible with GIS tools. Additionally, accurately transforming turning movement data is essential for modeling realistic intersection behavior but often involves tedious manual preprocessing.
While previous efforts have made progress in isolated aspects of the conversion process, none offer a fully automated and scalable end-to-end solution. To fill this gap, we introduce utdf2gmns, an open-source Python tool designed to automate the transformation of Synchro UTDF files into GMNS-compliant networks for SUMO simulation. The tool supports automatic geocoding, integration with the Sigma-X engine for intersection analysis, robust SUMO network generation, and extendibility to other microsimulation platforms. Future work will focus on expanding support for adaptive signal systems, incorporating real-time data inputs, and enhancing interoperability with additional simulation frameworks to promote reproducibility and collaborative research in traffic modeling.
Official Document: https://utdf2gmns.readthedocs.io/en/latest/
Official GitHub: https://github.com/xyluo25/utdf2gmns
Previous Development: ASU Trans-AI-LAB (Initial commit Dec 17, 2022, total 144 commits)
utdf2gmns Navigation
- Installation
- Quick Start Guide
- Quick Python Example
- Prepare your UTDF file
- Initialize the UTDF2GMNS
- Geocoding Intersections (Use Automatic Geocoding)
- Geocoding Intersections (Use Manual Geocoding)
- Create GMNS links
- Save GMNS Network (UTDF To GMNS Format)
- Convert UTDF Network to SUMO (GMNS To SUMO Format)
- Visualize the Network
- Signalized Intersection Calculation and Visualization (Optional)
- Quick Example (Full Code)
- Design Framework
- Illustration of Selected Intersection
- Quick Python Example
- Read UTDF Format Data
- Geocoding Intersections
- Signal Conversation
- UTDF To GMNS Format
- GMNS To SUMO Format
- Sigma-x Engine Visualize Intersections
- API Reference
- Citation Request
- Official Links
- License
- Reference
- Acknowledgements