Skip to content
forked from kit-algo/ULTRA

UnLimited TRAnsfers for Multi-Modal Route Planning

License

Notifications You must be signed in to change notification settings

bliksemlabs/ULTRA

 
 

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

16 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

License: MIT

ULTRA: UnLimited TRAnsfers for Multimodal Route Planning

ULTRA is a C++ framework for efficient journey planning in multimodal networks consisting of public transit and non-schedule-based transfer modes (e.g., walking, cycling, e-scooter). It was developed at KIT in the group of Prof. Dorothea Wagner. This repository contains code for the following publications:

  • UnLimited TRAnsfers for Multi-Modal Route Planning: An Efficient Solution Moritz Baum, Valentin Buchhold, Jonas Sauer, Dorothea Wagner, Tobias Zündorf In: Proceedings of the 27th Annual European Symposium on Algorithms (ESA'19), Leibniz International Proceedings in Informatics, pages 14:1–14:16, 2019 pdf arXiv

  • Integrating ULTRA and Trip-Based Routing Jonas Sauer, Dorothea Wagner, Tobias Zündorf In: Proceedings of the 20th Symposium on Algorithmic Approaches for Transportation Modelling, Optimization, and Systems (ATMOS'20), OpenAccess Series in Informatics, pages 4:1–4:15, 2020 pdf

  • Fast Multimodal Journey Planning for Three Criteria Moritz Potthoff, Jonas Sauer In: Proceedings of the 24th Workshop on Algorithm Engineering and Experiments (ALENEX'22), SIAM, pages 145–157, 2022 pdf arXiv

  • Efficient Algorithms for Fully Multimodal Journey Planning Moritz Potthoff, Jonas Accepted for publication at the 22nd Symposium on Algorithmic Approaches for Transportation Modelling, Optimization, and Systems (ATMOS'22)

Usage

All query algorithms and preprocessing steps are available via the console application ULTRA, which can be compiled using the Makefile located in the Runnables folder. It includes the following commands:

  • CH computation:
    • buildCH performs a regular CH precomputation. The output is required by the (Mc)ULTRA query algorithms, which use it to perform the Bucket-CH precomputation.
    • buildCoreCH performs a Core-CH precomputation. The output is required by the (Mc)ULTRA shortcut computation and by the MCSA and M(C)R query algorithms.
  • (Mc)ULTRA shortcut computation:
    • computeStopToStopShortcuts computes stop-to-stop ULTRA shortcuts for use with ULTRA-RAPTOR.
    • computeEventToEventShortcuts computes event-to-event ULTRA shortcuts for use with ULTRA-TB.
    • computeMcStopToStopShortcuts computes stop-to-stop McULTRA shortcuts for use with ULTRA-McRAPTOR and UBM-RAPTOR.
    • computeMcEventToEventShortcuts computes event-to-event McULTRA shortcuts for use with ULTRA-McTB and UBM-TB.
    • augmentTripBasedShortcuts performs the shortcut augmentation step that is required for UBM-TB.
    • validateStopToStopShortcuts and validateEventToEventShortcuts test the validity of the computed shortcuts by comparing them to paths in the original transfer graph.
  • Original TB preprocessing:
    • raptorToTripBased takes a network in RAPTOR format as input and runs the TB preprocessing algorithm.
    • With a transitively closed transfer graph as input, this performs the original TB preprocessing.
    • With stop-to-stop ULTRA shortcuts as input, this performs the sequential ULTRA-TB preprocessing.
    • The parameter "Route-based pruning?" enables the optimized preprocessing proposed by Lehoux and Loiodice.
  • Query algorithms:
Command Algorithm Transfers Query type Criteria
runTransitiveCSAQueries CSA Transitive Stop-to-stop Arrival time
runDijkstraCSAQueries MCSA Unlimited Vertex-to-vertex Arrival time
runHLCSAQueries HL-CSA Unlimited Vertex-to-vertex Arrival time
runULTRACSAQueries ULTRA-CSA Unlimited Vertex-to-vertex Arrival time
runTransitiveRAPTORQueries RAPTOR Transitive Stop-to-stop Arrival time, number of trips
runDijkstraRAPTORQueries MR Unlimited Vertex-to-vertex Arrival time, number of trips
runHLRAPTORQueries HL-RAPTOR Unlimited Vertex-to-vertex Arrival time, number of trips
runULTRARAPTORQueries ULTRA-RAPTOR Unlimited Vertex-to-vertex Arrival time, number of trips
runTransitiveMcRAPTORQueries McRAPTOR Transitive Stop-to-stop Arrival time, number of trips, transfer time (full)
runMCRQueries MCR Unlimited Vertex-to-vertex Arrival time, number of trips, transfer time (full)
runULTRAMcRAPTORQueries ULTRA-McRAPTOR Unlimited Vertex-to-vertex Arrival time, number of trips, transfer time (full)
runTransitiveBoundedMcRAPTORQueries BM-RAPTOR Transitive Stop-to-stop Arrival time, number of trips, transfer time (restricted)
runUBMRAPTORQueries UBM-RAPTOR Unlimited Vertex-to-vertex Arrival time, number of trips, transfer time (restricted)
runTransitiveTripBasedQueries TB Transitive Stop-to-stop Arrival time, number of trips
runULTRATripBasedQueries ULTRA-TB Unlimited Vertex-to-vertex Arrival time, number of trips
runULTRAMcTripBasedQueries ULTRA-McTB Unlimited Vertex-to-vertex Arrival time, number of trips, transfer time (full)
runBoundedULTRAMcTripBasedQueries UBM-TB Unlimited Vertex-to-vertex Arrival time, number of trips, transfer time (restricted)

Networks

We use custom data formats for loading the public transit network and the transfer graph: The Intermediate format allows for easy network manipulation, while the RAPTOR format is required by the preprocessing and all query algorithms except for CSA, which uses its own format. The Switzerland and London networks used in our experiments are available at https://i11www.iti.kit.edu/PublicTransitData/ULTRA/ in the required formats. Unfortunately, we cannot provide the Germany and Stuttgart networks because they are proprietary.

The Network application provides commands for manipulating the network data and for converting public transit data to our custom format. It includes the following commands:

  • parseGTFS converts GFTS data in CSV format to a binary format.
  • gtfsToIntermediate converts GFTS binary data to the Intermediate network format.
  • intermediateToCSA converts a network in Intermediate format to CSA format.
  • intermediateToRAPTOR converts a network in Intermediate format to RAPTOR format.
  • loadDimacsGraph converts a graph in the format used by the 9th DIMACS Implementation Challenge to our custom binary graph format.
  • duplicateTrips duplicates all trips in the network and shifts them by a specified time offset. This is used to extend networks that only comprise a single day to two days, in order to allow for overnight journeys.
  • addGraph adds a transfer graph to a network in Intermediate format. Existing transfer edges in the network are preserved.
  • replaceGraph replaces the transfer graph of a network with a specified transfer graph.
  • reduceGraph contracts all vertices with degree less than 3 in the transfer graph.
  • reduceToMaximumConnectedComponent reduces a network to its largest connected component.
  • applyBoundingBox removes all parts of a network that lie outside a predefined bounding box.
  • applyCustomBoundingBox removes all parts of a network that lie outside a specified bounding box.
  • makeOneHopTransfers computes one-hop transfers for all stops whose distance is below a specified threshold. This is used to create a transitively closed network for comparison with non-multi-modal algorithms.
  • applyMaxTransferSpeed applies a maximum transfer speed to all edges in the transfer graph.
  • applyConstantTransferSpeed applies a constant transfer speed to all edges in the transfer graph and computes the travel times accordingly.

An example script that combines all steps necessary to load a public transit network is provided at Runnables/BuildNetworkExample.script. It can be run from the Network application using runScript BuildNetworkExample.script. It takes as input GFTS data in CSV format located at Networks/Switzerland/GTFS/ and a road graph in DIMACS format located at Networks/Switzerland/OSM/dimacs.

Multiple Transfer Modes

The algorithms listed above support public transit plus one transfer mode. Additionally, this framework provides algorithms for multimodal networks with multiple transfer modes. The required multimodal data structures can be built with the following commands in Network:

  • buildMultimodalRAPTORData converts unimodal RAPTOR data into multimodal RAPTOR data. Note that it does not add any transfer graphs.
  • addModeToMultimodalRAPTORData adds a transfer graph for a specified transfer mode to the given multimodal RAPTOR data.
  • buildMultimodalTripBasedData converts unimodal TB data into multimodal TB data. Note that it does not add any transfer graphs.
  • addModeToMultimodalTripBasedData adds a shortcut graph for a specified transfer mode to the given multimodal TB data.

ULTRA shortcuts for networks with multiple transfer modes can be computed with the following commands in ULTRA:

  • computeMultimodalMcStopToStopShortcuts computes multimodal stop-to-stop McULTRA shortcuts for use with ULTRA-McRAPTOR and UBM-RAPTOR.
  • computeMultimodalMcEventToEventShortcuts computes multimodal event-to-event McULTRA shortcuts for use with UBM-HydRA.

The ULTRA application offers the following query algorithms. All algorithms optimize arrival time, number of trips and one transfer time criterion per transfer mode.

  • runMultimodalMCRQueries: MCR for full Pareto sets
  • runMultimodalULTRAMcRAPTORQueries: ULTRA-McRAPTOR with stop-to-stop shortcuts for full Pareto sets
  • runMultimodalUBMRAPTORQueries: UBM-RAPTOR with stop-to-stop shortcuts for restricted Pareto sets
  • runMultimodalUBMHydRAQueries: UBM-HydRA with event-to-event shortcuts for restricted Pareto sets

About

UnLimited TRAnsfers for Multi-Modal Route Planning

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages

  • C++ 100.0%