TraCI

From sumo

Contents 1 Introduction to TraCI 2 SUMO startup 3 Protocol specification 4 TraCI Commands 5 Example use 6 Resources 7 Interface Implementations 7.1 V2X simulation 7.2 By Programming Language 8 Troubleshooting 8.1 Output files are not closed.

Introduction to TraCI

TraCI is the short term for "Traffic Control Interface". The basic idea behind is to give access to a running road traffic simulation. If you have any questions or helpful suggestions, you may use the [sumo-devel] mailing list.

SUMO startup

TraCI uses a TCP based client/server architecture to provide access to SUMO. Thereby, SUMO acts as server that is started with additional command-line options: --remote-port <INT> where <INT> isthe port SUMO will listen on for incoming connections.

When started with the --remote-port <INT> option, SUMO only prepares the simulation and waits for an external application, that takes over the control. Please note, that the --end <TIME> option is ignored when SUMO runs as a TraCI server, SUMO runs until the client demands a simulation end.

Protocol specification

Please see the TraCI Protocol Specification (including Basic Flow, Messages, Data Types).

TraCI Commands

There used to be two "generations" of TraCI commands. The first one mainly uses an internal mapping between the string-typed IDs used in SUMO and an external representation of these which is int-based. The mapping was done internally (within TraCI). The "second generation" uses string-IDs equal to those SUMO reads. If you are bound to the first generation API (for instance if you want to use TraNS) you can only use SUMO up to version 0.12.3. There is also a comparison of the two APIs available.

There are some general commands which don't use ids of any simulation objects

• Control-related commands: perform a simulation step, close the connection
• Environment-related commands convert positions between different formats, compute routes

For the following APIs, the ID is equal to the ID defined in SUMO's input files. Here, you find their general structure.

• Value Retrieval
  • Induction Loop Value Retrieval retrieve information about induction loops
  • Multi-Entry/Multi-Exit Detectors Value Retrieval retrieve information about multi-entry/multi-exit detectors
  • Traffic Lights Value Retrieval retrieve information about traffic lights
  • Lane Value Retrieval retrieve information about lanes
  • Vehicle Value Retrieval retrieve information about vehicles
  • Vehicle Type Value Retrieval retrieve information about vehicle types
  • Route Value Retrieval retrieve information about routes
  • PoI Value Retrieval retrieve information about points-of-interest
  • Polygon Value Retrieval retrieve information about polygons
  • Junction Value Retrieval retrieve information about junctions
  • Edge Value Retrieval retrieve information about edges
  • Simulation Value Retrieval retrieve information about the simulation
  • GUI Value Retrieval retrieve information about the simulation visualization
• State Changing
  • Change Lane State change a lane's state
  • Change Traffic Lights State change a traffic lights' state
  • Change Vehicle State change a vehicle's state
  • Change PoI State change a point-of-interest's state (or add/remove one)
  • Change Polygon State change a polygon's state (or add/remove one)
  • Change Edge State change an edge's state
  • Change GUI State change the simulation visualization
• TraCI/Value Retrieval Subscription

TraCI/Vehicle Signalling explains which signals, etc. are modeled and can be retrieved.

Example use

• There is a tutorial on using TraCI for adaptive traffic lights (using Python).
• The Tutorials/CityMobil tutorial uses TraCI for assigning new routes to vehicles (using Python).

Resources

• Axel Wegener, Michal Piorkowski, Maxim Raya, Horst Hellbrück, Stefan Fischer and Jean-Pierre Hubaux. TraCI: A Framework for Coupling Road Traffic and Network Simulators. Proceedings of the 11th Communications and Networking Simulation Symposium, April 2008. Available at ACM Digital Library
• Axel Wegener, Horst Hellbrück, Christian Wewetzer and Andreas Lübke: VANET Simulation Environment with Feedback Loop and its Application to Traffic Light Assistance. Proceedings of the 3rd IEEE Workshop on Automotive Networking and Applications, New Orleans, LA, USA, 2008. Soon available at IEEEXplore
• SUMO's TraCI Server is a part of the plain distribution. The source code is located in the folder src/traci-server.

Interface Implementations

V2X simulation

TraCI allows to use SUMO in combination with communication network simulators vor simulating vehicular communication. See Topics/V2X for a list of available solutions.

By Programming Language

• Python: the package tools/traci allows to interact with SUMO using Python
• Java: TraCI4J is a Java API implementation; documentation is under work

Troubleshooting

Output files are not closed.

This problem occures if the client tries to access the output while the simulation is still closing down. This can be solved by letting the client wait for the simulation to shut down. The bug report was ticket524