Line data    Source code

       1             : /****************************************************************************/
       2             : // Eclipse SUMO, Simulation of Urban MObility; see https://eclipse.dev/sumo
       3             : // Copyright (C) 2007-2024 German Aerospace Center (DLR) and others.
       4             : // This program and the accompanying materials are made available under the
       5             : // terms of the Eclipse Public License 2.0 which is available at
       6             : // https://www.eclipse.org/legal/epl-2.0/
       7             : // This Source Code may also be made available under the following Secondary
       8             : // Licenses when the conditions for such availability set forth in the Eclipse
       9             : // Public License 2.0 are satisfied: GNU General Public License, version 2
      10             : // or later which is available at
      11             : // https://www.gnu.org/licenses/old-licenses/gpl-2.0-standalone.html
      12             : // SPDX-License-Identifier: EPL-2.0 OR GPL-2.0-or-later
      13             : /****************************************************************************/
      14             : /// @file    MSDispatch_GreedyShared.h
      15             : /// @author  Jakob Erdmann
      16             : /// @date    16.12.2019
      17             : ///
      18             : // An algorithm that performs dispatch for the taxi device
      19             : /****************************************************************************/
      20             : #pragma once
      21             : #include <config.h>
      22             : 
      23             : #include <set>
      24             : #include <vector>
      25             : #include <map>
      26             : #include <utils/common/SUMOTime.h>
      27             : #include "MSDispatch_Greedy.h"
      28             : #include "MSDevice_Taxi.h"
      29             : 
      30             : 
      31             : /**
      32             :  * @class MSDispatch_Greedy
      33             :  * @brief A dispatch algorithm that services customers in reservation order but also tries to do ride sharing
      34             :  */
      35             : class MSDispatch_GreedyShared : public MSDispatch_Greedy {
      36             : public:
      37          96 :     MSDispatch_GreedyShared(const Parameterised::Map& params) :
      38             :         MSDispatch_Greedy(params),
      39         192 :         myAbsoluteLossThreshold(StringUtils::toDouble(getParameter("absLossThreshold", "300"))),
      40         288 :         myRelativeLossThreshold(StringUtils::toDouble(getParameter("relLossThreshold", "0.2")))
      41          96 :     {}
      42             : 
      43             : protected:
      44             :     /// @brief trigger taxi dispatch. @note: method exists so subclasses can inject code at this point (ride sharing)
      45             :     virtual int dispatch(MSDevice_Taxi* taxi, std::vector<Reservation*>::iterator& resIt, SUMOAbstractRouter<MSEdge, SUMOVehicle>& router, std::vector<Reservation*>& reservations);
      46             : 
      47             :     /// @brief absolute time threshold for declining shared ride in s
      48             :     const double myAbsoluteLossThreshold;
      49             : 
      50             :     /// @brief relative time threshold for declining shared ride
      51             :     const double myRelativeLossThreshold;
      52             : };