Tools/TraceExporter

=From 30.000 feet= traceExporter.py converts SUMO fcd output to different "trace file" formats: OMNET, Shawn, ns2/ns3, PHEM.
 * Purpose: trace file conversion/generation
 * System: portable (Linux/Windows is tested); runs on command line
 * Input (mandatory): SUMO fcd-output
 * Output: One or more "trace file(s)" and other complementary files
 * Programming Language: Python

=Introduction= Different applications read "vehicular traces", files containing mainly positions of vehicles over time. traceExporter.py generates such files by converting SUMO's fcd output into several supported formats. Following files can be generated, sorted by application: Tools/TraceExporter succeeds the old Java trace exporter, ("traceExporter.jar").
 * OMNET: mobility-traces (.xml)
 * Shawn: snapshot-files (.xml)
 * ns2/ns3: trace-files, activity-files, and mobility-files (all *.tcl)
 * PHEM: .dri-files, .str-files, .fzp-files, .flt-files
 * GPSDAT (unknown)
 * GPX
 * POIs (can visualize GPS distortions and sampling in SUMO-GUI)

=Installation= traceExporter.py comes with SUMO and is located in /tools/bin/. Python must be installed.

=Usage Description= You convert a given fcd output into a format using a command like this: traceExporter.py --fcd-input myFCDoutput.xml --omnet-output myOMNETfile.xml In the case given above, a file for OMNET will be built.

In the following, the command line options are described.

Input Options
traceExporter.py often needs only the fcd output as input. In some cases, the network used while obtaining the fcd output must be given. traceExporter.py gives an error message if the wanted output needs additional files, such as the network, but no such file is specified. The options for defining the input files are:

Output Options
In the following, the output options of traceExporter.py are given, divided by the application,

Processing Options
Several options allow to fine-tune the processing.

Processing Options
=See Also=
 * This tutorial on using TraceExporter
 * working around bugs in version 0.19.0

=Acknowledgements=