Contributed/SUMOPlayer

Meta-Information

 * Location: The build-file and the sources can be found in /tools/contributed/sumoplayer
 * Language: Java >=1.5
 * Author: Michael Willigens

From README

 * 1) This is file gives a brief overview on SUMPlayer usage.
 * 2) SUMOPlayer can be used to play SUMO network-dump files
 * 3) in realtime (if possible) to latitude/longitude coordinates.
 * 4) It can be customized in any way by implemting
 * 5) de.psi.telco.sumoplayer.SUMOLocationListener
 * 6) SEE:
 * 7) public interface SUMOLocationListener {
 * 8) 	public void LocationUpdated(String vehicleId, int timestep, double lon, double lat, double speed);
 * }
 * 1) You can call SUMOPlayer with your own implementation by using the
 * 2) -l " " parameter.
 * 3) If not used, SUMOPlayer uses STDOUT CVS style like:
 * 4) | | | |


 * 1) Eclipse integration is easily possible by:
 * 2) new-project -> from existing ant buildfile (build.xml)

$> ant -projecthelp
 * 1) see possible ant tasks:

$> ant sumoplayer.jar
 * 1) compile

$> ant sumplayer.run $> java -jar sumoplayer.jar
 * 1) run sumoPlayer with:
 * 1) ... or even better integrated in your project by jarfile:
 * 1) possible parameters:
 * 2) ANT param                         # desctiption
 * 3) JAR param

-Dnetfile= # the used sumo network file -n                                # needed for geo coordinate lookups

-Dndump=     # sumo network-dump simulation file -d

-Dequipped=          # a floating value between 0 and 1 -e                                # defining the number of tracked # vehicles. 0.01 is 1%

-Djitter=        # a random GPS jitter in meters -j

-Dlistener=  # the used java implementation of -l                                 # SUMOLocationListener # default: # de.psi.telco.sumoplayer.SUMOPipedLocationListener #   (stdout CSV style data)

$> ant javadoc                     # creates JAVA DOCS in /build/javadoc
 * 1) JAVA DOC

Additional Information
You can run the player as following: sumo ... --no-step-log --netstate-dump - | java -jar SUMOPlayer.jar -d - -c -n  ...

("-" redirects the dump to stdout)

The basic functionality is as following
 * the player reads the network file for projection information
 * the player reads projected lanes
 * the player tries to put each output into one second
 * the player chooses vehicles randomly
 * the player writes the longitude and latitude of every vehicle into a file or prints them