How kevinnguyen20/dcaiti-ride-pooling works
This repository implements centralized ride-pooling applications for Eclipse MOSAIC simulations. Ride orders enter the dispatcher, which tracks bookings and shuttle status, assigns compatible rides, and sends stop/route plans to vehicle applications; shuttles execute those plans and report status and completed or declined rides. Rebalancing apps manage idle shuttle movement. The README documents the wider MOSAIC traffic, cellular, and application-simulation context and the BeST Berlin scenario. Unsampled modules are represented only where the README or tree supports their role; edges are limited to relationships shown in excerpts or explicitly documented.
Main entry points: AbstractRidePoolingServiceApp.java Dispatcher runtime · AbstractRidePoolingVehicleApp.java Vehicle runtime · RidePoolingServiceApp.java Ride pooling service · RestrictedSubgraphMatching.java Subgraph matching
Components 21
Dispatch and assignment
- Dispatcher runtime
src/main/java/com/dcaiti/mosaic/app/ridehailing/AbstractRidePoolingServiceApp.java - Ride pooling service
src/main/java/com/dcaiti/mosaic/app/ridehailing/ridepooling/RidePoolingServiceApp.java - Ride provider
src/main/java/com/dcaiti/mosaic/app/ridehailing/RidePoolingProvider.java - Subgraph matching
src/main/java/com/dcaiti/mosaic/app/ridehailing/heuristics/RestrictedSubgraphMatching.java - Heuristic base
src/main/java/com/dcaiti/mosaic/app/ridehailing/heuristics/AbstractHeuristics.java - Assignment grid
src/main/java/com/dcaiti/mosaic/app/ridehailing/strategies/assignment/Grid.java - Service configuration
src/main/java/com/dcaiti/mosaic/app/ridehailing/ridepooling/CRidePoolingServiceApp.java
Shuttle operations
- Vehicle runtime
src/main/java/com/dcaiti/mosaic/app/ridehailing/AbstractRidePoolingVehicleApp.java - Ride pooling vehicle
src/main/java/com/dcaiti/mosaic/app/ridehailing/ridepooling/RidePoolingVehicleApp.java - Return-to-base driving
src/main/java/com/dcaiti/mosaic/app/ridehailing/strategies/rebalancing/ReturningToPointOfBusinessVehicleApp.java - Dropoff waiting
src/main/java/com/dcaiti/mosaic/app/ridehailing/strategies/rebalancing/WaitingAtDropoffLocationVehicleApp.java - Vehicle configuration
src/main/java/com/dcaiti/mosaic/app/ridehailing/config/CAbstractRidePoolingVehicleApp.java
Ride domain and messaging
- Ride booking state
src/main/java/com/dcaiti/mosaic/app/ridehailing/utils/server/Ride.java - Vehicle status
src/main/java/com/dcaiti/mosaic/app/ridehailing/utils/server/VehicleStatus.java - Booking message
src/main/java/com/dcaiti/mosaic/app/ridehailing/utils/messages/RideBookingMessage.java - Status message
src/main/java/com/dcaiti/mosaic/app/ridehailing/utils/messages/VehicleStatusMessage.java - Vehicle stops
src/main/java/com/dcaiti/mosaic/app/ridehailing/utils/vehicle/VehicleStop.java - Stop event
src/main/java/com/dcaiti/mosaic/app/ridehailing/utils/vehicle/StopEvent.java
Simulation context
- Eclipse MOSAIC
- BeST scenario
resources/scenarios/best-scenario
Other components
- Ride orders
Connections 27
- Ride orders → Ride provider: supplies orders
- Ride pooling service → Dispatcher runtime: extends
src/main/java/com/dcaiti/mosaic/app/ridehailing/ridepooling/RidePoolingServiceApp.java - Ride pooling service → Ride provider: creates provider
src/main/java/com/dcaiti/mosaic/app/ridehailing/ridepooling/RidePoolingServiceApp.java - Dispatcher runtime → Ride provider: fetches bookings
src/main/java/com/dcaiti/mosaic/app/ridehailing/AbstractRidePoolingServiceApp.java - Ride pooling service → Subgraph matching: assigns bookings
src/main/java/com/dcaiti/mosaic/app/ridehailing/ridepooling/RidePoolingServiceApp.java - Subgraph matching → Heuristic base: uses heuristic base
src/main/java/com/dcaiti/mosaic/app/ridehailing/heuristics/RestrictedSubgraphMatching.java - Subgraph matching → Ride booking state: matches rides
src/main/java/com/dcaiti/mosaic/app/ridehailing/heuristics/RestrictedSubgraphMatching.java - Subgraph matching → Vehicle status: evaluates shuttles
src/main/java/com/dcaiti/mosaic/app/ridehailing/heuristics/RestrictedSubgraphMatching.java - Dispatcher runtime → Ride booking state: stores bookings
src/main/java/com/dcaiti/mosaic/app/ridehailing/AbstractRidePoolingServiceApp.java - Dispatcher runtime → Vehicle status: tracks fleet status
src/main/java/com/dcaiti/mosaic/app/ridehailing/AbstractRidePoolingServiceApp.java - Dispatcher runtime → Booking message: sends plans
src/main/java/com/dcaiti/mosaic/app/ridehailing/AbstractRidePoolingServiceApp.java - Vehicle runtime → Status message: sends status
src/main/java/com/dcaiti/mosaic/app/ridehailing/AbstractRidePoolingVehicleApp.java - Vehicle runtime → Booking message: receives plans
src/main/java/com/dcaiti/mosaic/app/ridehailing/AbstractRidePoolingVehicleApp.java - Vehicle runtime → Return-to-base driving: updates stops/routes
src/main/java/com/dcaiti/mosaic/app/ridehailing/AbstractRidePoolingVehicleApp.java - Ride pooling vehicle → Vehicle runtime: extends
src/main/java/com/dcaiti/mosaic/app/ridehailing/ridepooling/RidePoolingVehicleApp.java - Status message → Vehicle status: carries status
src/main/java/com/dcaiti/mosaic/app/ridehailing/utils/messages/VehicleStatusMessage.java - Booking message → Ride booking state: carries rides
src/main/java/com/dcaiti/mosaic/app/ridehailing/utils/messages/RideBookingMessage.java - Booking message → Vehicle stops: carries stops
src/main/java/com/dcaiti/mosaic/app/ridehailing/utils/messages/RideBookingMessage.java - Return-to-base driving → Stop event: notifies apps
src/main/java/com/dcaiti/mosaic/app/ridehailing/strategies/rebalancing/ReturningToPointOfBusinessVehicleApp.java - Stop event → Vehicle stops: references stop
src/main/java/com/dcaiti/mosaic/app/ridehailing/utils/vehicle/StopEvent.java - Ride pooling service → Service configuration: uses configuration
src/main/java/com/dcaiti/mosaic/app/ridehailing/ridepooling/RidePoolingServiceApp.java - Vehicle runtime → Vehicle configuration: uses configuration
src/main/java/com/dcaiti/mosaic/app/ridehailing/AbstractRidePoolingVehicleApp.java - Eclipse MOSAIC → BeST scenario: runs scenario
README.md - Eclipse MOSAIC → Dispatcher runtime: hosts applications
README.md - Eclipse MOSAIC → Ride pooling vehicle: hosts applications
README.md - Eclipse MOSAIC → Return-to-base driving: maps shuttle logic
README.md - Dropoff waiting → Eclipse MOSAIC: runs as shuttle app