MSTriggeredRerouter.h

Go to the documentation of this file.

/****************************************************************************/
// Eclipse SUMO, Simulation of Urban MObility; see https://eclipse.dev/sumo
// Copyright (C) 2001-2024 German Aerospace Center (DLR) and others.
// This program and the accompanying materials are made available under the
// terms of the Eclipse Public License 2.0 which is available at
// https://www.eclipse.org/legal/epl-2.0/
// This Source Code may also be made available under the following Secondary
// Licenses when the conditions for such availability set forth in the Eclipse
// Public License 2.0 are satisfied: GNU General Public License, version 2
// or later which is available at
// https://www.gnu.org/licenses/old-licenses/gpl-2.0-standalone.html
// SPDX-License-Identifier: EPL-2.0 OR GPL-2.0-or-later
/****************************************************************************/
// Reroutes vehicles passing an edge
/****************************************************************************/
#pragma once
#include <config.h>
 
#include <string>
#include <vector>
#include <utils/common/Command.h>
#include <utils/common/Named.h>
#include <utils/xml/SUMOSAXHandler.h>
#include <utils/distribution/RandomDistributor.h>
#include <microsim/MSMoveReminder.h>
 
 
// ===========================================================================
// class declarations
// ===========================================================================
class MSNet;
class MSLane;
class MSRoute;
class SUMOVehicle;
class MSParkingArea;
 
 
// ===========================================================================
// class definitions
// ===========================================================================
class MSTriggeredRerouter :
    public Named, public MSMoveReminder,
    public SUMOSAXHandler {
 
    friend class GUIEdge; // dynamic instantiation
 
public:
    MSTriggeredRerouter(const std::string& id, const MSEdgeVector& edges,
                        double prob, bool off, bool optional, SUMOTime timeThreshold,
                        const std::string& vTypes, const Position& pos);
 
 
    virtual ~MSTriggeredRerouter();
 
    typedef std::pair<MSParkingArea*, bool> ParkingAreaVisible;
 
    struct RerouteInterval {
        long long int id;
        SUMOTime begin;
        SUMOTime end;
        MSEdgeVector closed;
        std::vector<MSLane*> closedLanes;
        MSEdgeVector closedLanesAffected;
        RandomDistributor<MSEdge*> edgeProbs;
        RandomDistributor<ConstMSRoutePtr> routeProbs;
        SVCPermissions permissions;
        RandomDistributor<ParkingAreaVisible> parkProbs;
        bool isVia = false;
    };
 
    bool notifyEnter(SUMOTrafficObject& veh, MSMoveReminder::Notification reason, const MSLane* enteredLane = 0);
 
 
    bool notifyMove(SUMOTrafficObject& veh, double oldPos, double newPos, double newSpeed);
 
    bool notifyLeave(SUMOTrafficObject& veh, double lastPos, MSMoveReminder::Notification reason, const MSLane* enteredLane = 0);
 
    bool triggerRouting(SUMOTrafficObject& veh, MSMoveReminder::Notification reason);
 
    const RerouteInterval* getCurrentReroute(SUMOTime time, SUMOTrafficObject& obj) const;
 
    SUMOTime setPermissions(const SUMOTime currentTime);
 
    const RerouteInterval* getCurrentReroute(SUMOTime time) const;
 
    void setUserMode(bool val);
 
    void setUserUsageProbability(double prob);
 
    bool inUserMode() const;
 
    double getProbability() const;
 
    double getUserProbability() const;
 
    // @brief return whether this moveReminder triggers parking reroute
    bool isParkingRerouter() const {
        return myHaveParkProbs;
    }
 
    const Position& getPosition() {
        return myPosition;
    }
 
    static double getWeight(SUMOVehicle& veh, const std::string param, const double defaultWeight);
 
    static MSParkingArea* rerouteParkingArea(const MSTriggeredRerouter::RerouteInterval* rerouteDef,
            SUMOVehicle& veh, bool& newDestination, ConstMSEdgeVector& newRoute);
 
    static const std::map<std::string, MSTriggeredRerouter*>& getInstances() {
        return myInstances;
    }
 
    static void checkParkingRerouteConsistency();
 
protected:
 
 
    virtual void myStartElement(int element,
                                const SUMOSAXAttributes& attrs);
 
 
    virtual void myEndElement(int element);
 
    bool applies(const SUMOTrafficObject& obj) const;
 
    static bool affected(const std::set<SUMOTrafficObject::NumericalID>& edgeIndices, const MSEdgeVector& closed);
 
    typedef std::map<std::string, double> ParkingParamMap_t;
    typedef std::map<MSParkingArea*, ParkingParamMap_t, ComparatorIdLess> MSParkingAreaMap_t;
 
    static bool addParkValues(SUMOVehicle& veh, double brakeGap, bool newDestination,
                              MSParkingArea* pa, double paOccupancy, double prob,
                              SUMOAbstractRouter<MSEdge, SUMOVehicle>& router,
                              MSParkingAreaMap_t& parkAreas,
                              std::map<MSParkingArea*, ConstMSEdgeVector>& newRoutes,
                              std::map<MSParkingArea*, ConstMSEdgeVector>& parkApproaches,
                              ParkingParamMap_t& maxValues);
 
protected:
    const MSEdgeVector myEdges;
 
    std::vector<RerouteInterval> myIntervals;
 
    double myProbability, myUserProbability;
 
    bool myAmInUserMode;
 
    bool myAmOptional;
 
    Position myPosition;
 
    // @brief waiting time threshold for activation
    SUMOTime myTimeThreshold;
 
    std::set<std::string> myVehicleTypes;
 
    RerouteInterval myParsedRerouteInterval;
 
    bool myHaveParkProbs;
 
    static MSEdge mySpecialDest_keepDestination;
    static MSEdge mySpecialDest_terminateRoute;
 
    static std::map<std::string, MSTriggeredRerouter*> myInstances;
 
private:
    MSTriggeredRerouter(const MSTriggeredRerouter&);
 
    MSTriggeredRerouter& operator=(const MSTriggeredRerouter&);
 
 
};