TraCI4J is a Java library for interfacing SUMO (Simulation of Urban MObility) with a Java program to control and/or watch a traffic simulation via SUMO's TraCI interface.
It is developed by members at ApPeAL (Applied Pervasive Architectures Lab) at Politecnico di Torino.
The library can act as a complete front-end for a SUMO instance. The simulation can be started, stopped and advanced step by step.
The SUMO instance che be run by the library itself or can be already running. Since the TraCI communication is done via TCP, the existing SUMO instance can be in the same machine or in another host.
While the simulation is running, many informations can be retrieved, both static (e.g. the road network topology) and dynamic (e.g. position and speed of vehicles). A set of TraCI4J classes match the corresponding TraCI objects, each with methods that allow for value reading and state changing.
The library is currently in alpha development stage. Some of the TraCI features are available as TraCI4J classes and work as expected (although more testing is needed), while some others still need to be written.
You can download TraCI4J right here with the tools provided via GitHub.
There are no binaries: the library is available as source code in an Eclipse project. Import it in your workspace and Eclipse will try to automatically build it.
The library can also be built outside Eclipse via Ant. The default target in the build.xml file will try to compile all code to .class files.
You can use the tracu4j-user mailing list to ask for information to the authors and/or other users.
Bug reports and feature requests can be posted in the Issues tab.
- A working SUMO installation (0.16.0 or higher)
- Be familiar with SUMO, i.e. know its basic principles, how to set up the input files, how to run it...
- A SUMO file set (a config file, a net description file and a routes file at least)
- A Java SE 1.6 virtual machine
In order to run, all examples need the PATH environment variable to point to your SUMO bin directory.
Otherwise, the JVM should be run with the system property it.polito.appeal.traci.sumo_exe set to the full path of the SUMO executable.
Here is an example command line for Windows:
java "-Dit.polito.appeal.traci.sumo_exe=C:\Program Files\sumo-0.16.0\bin\sumo.exe" -cp [your-class-path] [your-class-name]
And here's one for Linux:
java "-Dit.polito.appeal.traci.sumo_exe=/usr/local/bin/sumo" -cp [your-class-path] [your-class-name]
This code runs an instance of SUMO, queries the map bounds and does ten simulation steps. For each step, it prints which and how many vehicles are active.
The specified configuration file is relative to the TraCI4J package's base directory.
System.out.println("Map bounds are: " + conn.queryBounds());
for (int i = 0; i < 10; i++) {
int time = conn.getCurrentSimStep();
Set<String> vehicles = conn.getActiveVehicles();
System.out.println("At time step " + time + ", there are "
+ vehicles.size() + " vehicles: " + vehicles);
conn.nextSimStep();
}
conn.close();
}
catch(Exception e) {
e.printStackTrace();
}
}
}
This code picks a vehicle from the active ones and queries its current route.
import java.util.Set;
public class GetVehicleInfo {
public static void main(String[] args) {
SumoTraciConnection conn = new SumoTraciConnection(
"test/sumo_maps/box1l/test.sumo.cfg", // config file
12345, // random seed
false // look for geolocalization info in the map
);
try {
conn.runServer();
// the first two steps of this simulation have no vehicles.
conn.nextSimStep();
conn.nextSimStep();
Set<String> vehicles = conn.getActiveVehicles();
String aVehicleID = vehicles.iterator().next();
Vehicle aVehicle = conn.getVehicle(aVehicleID);
System.out.println("Vehicle " + aVehicleID
+ " will traverse these edges: "
+ aVehicle.getCurrentRoute());
conn.close();
}
catch(Exception e) {
e.printStackTrace();
}
}
}
TraCI4J is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.
TraCI4J is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.