Tools/Trip

From Sumo
Revision as of 03:55, 29 June 2012 by Behrisch (talk | contribs) (randomTrips.py: typo)
Jump to navigation Jump to search

randomTrips.py

"randomTrips.py" generates a set of random trips for a given network (option "-n"). It does so by choosing source and destination edge either uniformly at random or weighted by length (option "-l"), by number of lanes (option "-L") or both. The resulting trips are stored in an xml file (option "-o", default trips.trips.xml) suitable for the DUAROUTER which is called automatically if the "-r" option (with a filename for the resulting route file) is given. The trips are distributed evenly in an interval defined by begin (option "-b", default 0) and end time (option "-e", default 3600) in seconds. The number of trips is defined by the repetition rate (option "-p", default 1) in seconds. Every trip has an id consisting of a prefix (option "-t", default "t") and a running number. Example call:

randomTrips.py -n input_net.net.xml -e 50 -l

The script does not check whether the chosen destination may be reached from the source. This task is performed by the router.

The option --min-distance <FLOAT> ensures a minimum straight-line distance (in meter) between start and end edges of a trip. The script will keep sampling from the edge distribution until enough trips with sufficient distance are found.

The option --fringe-factor <FLOAT> increases the probability that trips will start/end at the fringe of the network. If the value 10 is given, edges that have no successor or no predecessor will be 10 times more likely to be chosen as start- or endpoint of a trip. This is usefull when modelling through-traffic which starts and ends at the outside of the simulated area.

For additional ways to influence edge probabilities call

randomTrips.py --help
Note:
The fringe is detected by checking for edges which have no successor or predecessor. The network may have to be generated with option --no-turnarounds or patched manually to ensure that the fringe is properly detected.


The script is located in: <SUMO_HOME>/tools/trip

route2trips.py

This script generates a trip file from a route file by stripping all route information except for start and end edge. It has a single parameter which is the route file and prints the trip file to stdout. Example:

route2trips.py input_routes.rou.xml

The script is located in: <SUMO_HOME>/tools/trip