Tools/LISASUMO
LISASumo is a middleware that couples LISA+ and SUMO helping to execute more complex traffic controls on the intersections than SUMO originally permits. SUMO communicates with the LISA+ virtual controller through LISASumo.
LISA+ is a proprietary software tool developed and commercialized by Schlothauer & Wauer used to plan and evaluate complex intersections. The control logics created with it can be directly uploaded to real controllers or tested with SUMO (using LISASumo) and VISSIM, a proprietary microscopic 3D traffic simulator.
LISASumo was built on Java technology and thus can be run on any operating system. LISASUMO is licensed under the GPL and its current version is the 1.0.0.
Contents
Getting started
The first step consists of creating a LISASumo simulation project, which is a directory containing:
- A LISASumo configuration file (lisasumo.xml)
- SUMO files (*.add.xml, *.net.xml, *.rou.xml, *.sumocfg, etc)
- A directory containing the LISA+ control units files (exported from LISA+ to Vissim)
After installing LISASumo, a sample simulation project can be found in the current workspace in sampleSimulation.
The second step is to open LISASumo, set the SUMO path and select a workspace in the system configuration dialog and open a simulation project. In the Tools menu, select "Start Lisa+ Virtual Controller" to start an instance of the LISA+ Virtual Controller. Pressing Ctrl+p or clicking on the "Play" button on the toolbar will open an instance of the SUMO GUI, which will take control over the system. Almost all menus, toolbars and dialog windows of LISASumo get blocked and from hereon the simulation may be started, paused, resumed and stopped from SUMO. Only the Control Units Management dialog window stays enabled so it is possible to change the control units settings during the execution of the simulation.
Configuration file
The LISASumo configuration file is a XML file (always named lisasumo.xml) which contains the necessary information to control the way LISA+ communicates with SUMO during the execution of a simulation by telling LISASumo how to match control units, signal groups and detectors to one another.
The configuration file is basically composed of the mandatory elements input and controlUnits that is composed of the two non-mandatory tags controlUnits and detectors.
Since LISA+ and SUMO use different naming conventions for their elements, the fields controlUnits and detectors tell LISASumo how are they called in each system.
Example:
<simulation>
<input>
<lisa>lisaDirectory</lisa>
</input>
<controlUnits>
<controlUnit lisa="z1_fg1" sumo="gneJ1" >
<signalGroups>
<signalGroup lisa="K1" sumo="0" />
<signalGroup lisa="K2" sumo="1" />
<signalGroup lisa="K3" sumo="2" />
<signalGroup lisa="K4" sumo="3" />
</signalGroups>
<detectors>
<detector lisa="D1" sumo="myLoop1" />
</detectors>
</controlUnit>
<controlUnit lisa="z1_fg2" sumo="gneJ2" >
<signalGroups>
<signalGroup lisa="K1" sumo="0,1,2" />
<signalGroup lisa="K2" sumo="3,4" />
<signalGroup lisa="K3" sumo="5,6,7"/>
<signalGroup lisa="K4" sumo="8" main="K3" />
</signalGroups>
</controlUnit>
</controlUnits>
</simulation>
The configuration file shown above declares the following:
- The LISA+ control unit files are in the directory <SIMULATION_DIRECTORY>/lisaDirectory.
- There are two control units where...
- the first control unit...
- is called z1_fg1 in LISA+ and gneJ1 in SUMO.
- contains one detector.
- matches the LISA+'s control unit z1_fg1 with gneJ1 in SUMO.
- is composed of four signal groups for LISA+ and four for SUMO, it contains one detector too.
- the second control unit...
- is called z1_fg2 in LISA+ and gneJ2 in SUMO.
- contains also four signal groups for LISA+ and 9 for SUMO, where, for example, the LISA+ signal group K2 controls the SUMO signal groups 3 and 4.
- the fourth signal group contains the attribute main set to K3. This means that if the LISA+ signal group K4 is disabled (OFF) at any time of the cycle the SUMO signal group 8 will take the state of K3.
- the first control unit...
Tools
Control Units Management
The Control Units Managemente dialog window gets opened by pressing Ctrl+M or by clicking on the "Grid" button on the simulation toolbar. In this dialog it is possible to change the behaviour of all available control units of the simulation by turning them off and on, selecting the program, or enabling or disabling program settings like VA (Verkehrsabhänhig) and ÖV (Öffentliche Verkehrsmittel).
It is also possible to deactivate the communication with LISA+ by unclicking the check box right of the control units combo box (image below). Per default, LISA+ controls units not being assigned to any Sumo intersection appear disabled.
LISA+ Virtual Controller
LISA+ provides an executable stand-alone Java JAR file containing an application called LISA+ Virtual Controller and is used to simulate control units devices and run control logics on it. Therefore it is not necessary to have LISA+ installed to be able to run LISASumo. This application is originally intended to be used with Vissim. The communication with LISA+ Virtual Controller happens over RESTful web services, the communication protocol is REST/HTTP and the data format is described using WSDL/XSD files, used to describe SOAP services.
It is necessary that, before starting SUMO, an instance of the LISA+ Virtual Controller is opened and running (clicking on Menu: Tools -> Start Lisa+ Virtual Controller or by pressing Ctrl+r).
Per default the LISA+ Virtual Controller and its configuration file (OmlFgServer.ini) are to be found in the OmlFgServer directory located in the LISASumo installation directory. This path can be changed in the System Preferences Window (Menu: Tools -> Preferencies).
Simulations directory
Per default, LisaSumo looks for simulations in the simulations directory, which can be found in the instalation directory (.../DLR/LisaSumo/). The simulations directory can be changed in the System Preferences Window (Menu: Tools -> System Preferences).
Miscellaneous
The green problem
While LISA+ only has with one type of green phase, SUMO has two different: g (no priority) and G (priority). When LISA+ reports a green phase for a certain signal group, LISASumo decides which green phase color will send to SUMO by counting the number of Gs and gs in the simulation's net.xml file and choosing the largest one (G has priority).