Introduction#
Cadyts is a tool to overcome the gap between the real traffic flows, which you should have, in form of induction loop data and the simulated traffic flows produced by SUMO. It adapts the flows by using the script cadytsIterate.py. For further information please consult the Cadyts home page.
Usage#
The Cadyts tool has to be started via cadytsIterate.py, which is a command line application. It has the following parameters:
-r route alternatives file from sumo (comma separated list) (in Cadyts: -choicesetfile)
-d adapt to the traffic flows on the edges defined in a given file (in Cadyts: -measfile)
-c classpath for the calibrator, default= os.path.join(os.path.dirname(sys.argv[0]), "..", "contributed","calibration","cadytsSumoController.jar")
-s last step of the calibration, default=100
-S scaled demand, optional, default=2 (in Cadyts: -demandscale); If -M is defined, this parameter will be used in the calibration.
-F define the number of iterations for stablizing the results in the DTA-calibration, default= 85 (in Cadyts: - freezeit)
-V define variance of the measured traffic flows for the DTA-calibration, default=1, (in Cadyts: varscale)
-P number of preparatory iterations, default = 5 (in Cadyts: PREPITS)
-W prefix of flow evaluation files; only for the calibration with use of detector data, optional (in Cadyts: -flowfile)
-Y fit the traffic counts as accurate as possible, default = False, (in Cadyts: -bruteforce)
-Z minimal traffic count standard deviation"), default = 25 (in Cadyts: -mincountstddev)
-O override depart times according to updated link travel times, default= False (in Cadyts: -overridett)
-M prefix of OD matrix files in VISUM format (in Cadyts: - fmaprefix)
-N postfix attached to clone ids, default='-CLONE' (in Cadyts: -clonepostfix)
-E No summary information is written by the simulation, default=False
-T No tripinfos are written by the simulation, default=False
In additions, the simulation-related parameters in the duaIterate.py can also be defined and applied in cadytsIterate.py, such as a network file, the begin time and the end time of a simulation/routing, main weights aggregation period (default=900, in Cadyts: -binsize).
The script cadytsIterate.py expects at least three parameters: The <NETFILE> (-n), the <ROUTEALTERATIVESFILE> (-r), the <REALFLOWSFILE> (-d).
Example for using the cadytsIterate.py:
cadytsIterate.py -n <NETFILE> -r <ROUTEALTERATIVESFILE> -d <REALFLOWSFILE>
-a <INT> (sets main weights aggregation period) -c <CADTYS-MODEL-PATH>
-b <INT> (sets simulation begin) -e <INT> (sets simulation end)
The <REALFLOWS>-file has to be a XML-file in form of:
<measurements>
<singlelink link="1to21" start="25200" end="32400" value="750" stddev="8" type="COUNT_VEH"/>
<singlelink link="1to22" start="25200" end="32400" value="250" stddev="8" type="COUNT_VEH"/>
</measurements>
The < ROUTEALTERATIVESFILE> has to be a XML-file in form of:
<route-alternatives>
<vehicle id="830" depart="25208.00" departlane="free" departspeed="max" fromtaz="1" totaz="2">
<routeDistribution last="1">
<route cost="154.29" probability="0.57623629" edges="91to1 1to21 out" exitTimes="25240.19 25337.05 25362.30"/>
<route cost="153.69" probability="0.42376371" edges="91to1 1to22 out" exitTimes="25240.19 25336.44 25361.69"/>
</routeDistribution>
</vehicle>
</route-alternatives>
An easy way to get a route-alternatives file is to use the duaIterate.py or the duarouter application.