Tools/Output

generated on 2019-08-26 00:07:10.071840 from the wiki page for Tools/Output for SUMO git

All of the tools described below exist in tools/output directory.

generateITetrisIntersectionMetrics.py

Tool used for generating the intersection metrics, including (but not limited to):

  • CO emission
  • CO2 emission
  • HC emission
  • PMx emission
  • NOx emission
  • fuel consumption

Execute the generateITetrisIntersectionMetrics.py script with --help option to get details about usage and available options.

generateITetrisNetworkMetrics.py

Tool used for generating the network metrics, including (but not limited to):

  • CO emission
  • CO2 emission
  • HC emission
  • PMx emission
  • NOx emission
  • fuel consumption

Execute the generateITetrisINetworkMetrics.py script with --help option to get details about usage and available options.

generateMeanDataDefinitions.py

Script for generating mean data definitions from detector definitions.

Execute the generateITetrisINetworkMetrics.py script with --help option to get details about usage and available options.

generateTLSE1Detectors.py

Script for generating E1 detectors (induction loops) for each junction in the supplied network file.

Execute the generateTLSE1Detectors.pyscript with --help option to get details about usage and available options.

generateTLSE2Detectors.py

Script for generating E2 detectors (lanearea detectors) for each junction in the supplied network file.

Execute the generateTLSE2Detectors.py script with --help option to get details about usage and available options.

generateTLSE3Detectors.py

Script for generating E3 detectors (multi-entry/multi-exit detectors) around all TLS-controlled intersections (default) or for an arbitrary list of intersections (--junction-ids). By default each entry edge gets its own detector. When setting option --joined there will be one detector per junction instead. When setting option --interior, delays within the intersection will be included as well.

Execute the generateTLSE3Detectors.py script with --help option to get details about usage and available options.

netdumpdiff.py

Script creating a diff of two netdump files.

Execute the netdumpdiff.py script with --help option to get details about usage and available options.

netdumpmean.py

Script calculating the mean values from two netdump files.

Execute the netdumpmean.py script with --help option to get details about usage and available options.

timingStats.py

Script for gathering statistics from several SUMO runs.

Execute the timingStats.py script with --help option to get details about usage and available options.

accelerations.py

Script for computing aggregate statistics about vehicle acclerations based on --netstate-dump output.

vehLanes.py

Script for computing vehroute-like output for lanes based on --netstate-dump output. Output data also includes information about the number of lane changes for each vehicle.

usage:

 python vehLanes.py <netstate_dump.xml> <output_file>

edgeDataDiff.py

Computes the numerical difference of edgeData values for each edge and interval. The resulting file can be used to visualize changes between two traffic scenarios. Both input files must contain the same edges and intervals.

usage:

 python edgeDataDiff.py <edgeData1.xml> <edgeData2.xml> <diffFile.xml>

vehrouteDiff.py

Computes the difference in travel times between two sets of --vehroute-output files. The files must contain the same vehicles and the same routes and may only differ in travel times. The must have been generated with the option --vehroute-output.exit-times for the script to work.

usage:

 python vehrouteDiff.py routes1.rou.xml routes2.rou.xml result.xml


tripinfoDiff.py

Computes the difference in travel times, route length, time loss, departure- and arrival times between two sets of --tripinfo-output files. The files should contain the same vehicles.

usage:

 python tripinfoDiff.py tripinfos1.xml tripinfos2.xml result.xml

By default only <tripinfo> elements are considered. By setting option --persons, the difference for <personinfo> elements is computed instead.

tripinfoByTAZ.py

Aggregates tripinfo data by origin/destination TAZ. The TAZ data can either by taken from the original input file (if it contains 'fromTaz' and 'toTaz' attributes) or from a TAZ file.

python tripinfoByTAZ.py -t tripinfos.xml -r trips.xml
python tripinfoByTAZ.py -t tripinfos.xml -z taz.axml

By default traveltime (tripinfo attribute 'duration') is aggregated. Other attributes can be selected using option --attribute (e.g. 'routeLength'). Output is given as plain text on the command line or in xml format if option --output is set.

attributeStates.py

Computes statistics on an arbitrary numerical attribute in a flat xml document. (eg. attribute timeLoss for element tripinfo in tripinfo-output) and writes the results to standard output.

python tools/output/attributeStats --element tripinfo --attribute timeLoss

With option --hist-output <FILE> a histogram data file (e.g. for plotting with gnuplot) is generated.