MSPerson.h

Go to the documentation of this file.

/****************************************************************************/
// Eclipse SUMO, Simulation of Urban MObility; see https://eclipse.org/sumo
// Copyright (C) 2001-2018 German Aerospace Center (DLR) and others.
// This program and the accompanying materials
// are made available under the terms of the Eclipse Public License v2.0
// which accompanies this distribution, and is available at
// http://www.eclipse.org/legal/epl-v20.html
// SPDX-License-Identifier: EPL-2.0
/****************************************************************************/
// The class for modelling person-movements
/****************************************************************************/
#ifndef MSPerson_h
#define MSPerson_h


// ===========================================================================
// included modules
// ===========================================================================
#include <config.h>

#include <string>
#include <vector>
#include <set>
#include <utils/common/SUMOTime.h>
#include <utils/common/Command.h>
#include <utils/geom/Position.h>
#include <utils/geom/PositionVector.h>
#include <microsim/MSTransportable.h>


// ===========================================================================
// class declarations
// ===========================================================================
class MSNet;
class MSEdge;
class MSLane;
class OutputDevice;
class SUMOVehicleParameter;
class MSStoppingPlace;
class SUMOVehicle;
class MSVehicleType;
class MSPModel;
class PedestrianState;
class DummyState;

typedef std::vector<const MSEdge*> ConstMSEdgeVector;

// ===========================================================================
// class definitions
// ===========================================================================
class MSPerson : public MSTransportable {
public:
    class MSPersonStage_Walking : public MSTransportable::Stage {
    public:
        MSPersonStage_Walking(const std::string& personID, const ConstMSEdgeVector& route, MSStoppingPlace* toStop, SUMOTime walkingTime,
                              double speed, double departPos, double arrivalPos, double departPosLat);

        ~MSPersonStage_Walking();

        virtual void proceed(MSNet* net, MSTransportable* person, SUMOTime now, Stage* previous);

        void abort(MSTransportable*);

        void setSpeed(double speed);

        const MSEdge* getEdge() const;
        const MSEdge* getFromEdge() const;
        double getEdgePos(SUMOTime now) const;

        Position getPosition(SUMOTime now) const;

        double getAngle(SUMOTime now) const;

        SUMOTime getWaitingTime(SUMOTime now) const;

        double getSpeed() const;

        ConstMSEdgeVector getEdges() const;

        std::string getStageDescription() const {
            return "walking";
        }
        std::string getStageSummary() const;

        virtual void tripInfoOutput(OutputDevice& os, MSTransportable* transportable) const;

        virtual void routeOutput(OutputDevice& os) const;

        virtual void beginEventOutput(const MSTransportable& p, SUMOTime t, OutputDevice& os) const;

        virtual void endEventOutput(const MSTransportable& p, SUMOTime t, OutputDevice& os) const;

        bool moveToNextEdge(MSPerson* person, SUMOTime currentTime, MSEdge* nextInternal = nullptr);

        void setRouteIndex(MSPerson* person, int routeOffset);


        double getMaxSpeed(const MSPerson* person) const;

        inline double getDepartPos() const {
            return myDepartPos;
        }

        inline double getDepartPosLat() const {
            return myDepartPosLat;
        }

        inline double getArrivalPos() const {
            return myArrivalPos;
        }

        inline const std::vector<const MSEdge*>::iterator getRouteStep() const {
            return myRouteStep;
        }

        inline const MSEdge* getRouteEdge() const {
            return *myRouteStep;
        }
        inline const MSEdge* getNextRouteEdge() const {
            return myRouteStep == myRoute.end() - 1 ? 0 : *(myRouteStep + 1);
        }
        inline const ConstMSEdgeVector& getRoute() const {
            return myRoute;
        }

        PedestrianState* getPedestrianState() const {
            return myPedestrianState;
        }


    private:

        double walkDistance() const;

        /* @brief compute average speed if the total walking duration is given
         * @note Must be called when the previous stage changes myDepartPos from the default*/
        double computeAverageSpeed() const;


    private:
        SUMOTime myWalkingTime;

        ConstMSEdgeVector myRoute;


        ConstMSEdgeVector::iterator myRouteStep;

        MSEdge* myCurrentInternalEdge;

        double myDepartPos;
        double myDepartPosLat;
        double mySpeed;

        PedestrianState* myPedestrianState;

        class arrival_finder {
        public:
            explicit arrival_finder(SUMOTime time) : myTime(time) {}

            bool operator()(double t) const {
                return myTime > t;
            }

        private:
            SUMOTime myTime;
        };

    private:
        MSPersonStage_Walking(const MSPersonStage_Walking&);

        MSPersonStage_Walking& operator=(const MSPersonStage_Walking&);

    };

    class MSPersonStage_Driving : public MSTransportable::Stage_Driving {
    public:
        MSPersonStage_Driving(const MSEdge* destination, MSStoppingPlace* toStop,
                              const double arrivalPos, const std::vector<std::string>& lines,
                              const std::string& intendedVeh = "", SUMOTime intendedDepart = -1);

        ~MSPersonStage_Driving();

        virtual void proceed(MSNet* net, MSTransportable* person, SUMOTime now, Stage* previous);

        std::string getStageDescription() const;
        std::string getStageSummary() const;

        virtual void tripInfoOutput(OutputDevice& os, MSTransportable* transportable) const;

        virtual void routeOutput(OutputDevice& os) const;
    };

    class MSPersonStage_Access : public MSTransportable::Stage {
    public:
        MSPersonStage_Access(const MSEdge* destination, MSStoppingPlace* toStop,
                             const double arrivalPos, const double dist, const bool isExit);

        ~MSPersonStage_Access();

        virtual void proceed(MSNet* net, MSTransportable* person, SUMOTime now, Stage* previous);

        std::string getStageDescription() const;
        std::string getStageSummary() const;

        Position getPosition(SUMOTime now) const;

        double getAngle(SUMOTime now) const;

        void tripInfoOutput(OutputDevice& os, MSTransportable* transportable) const;

        void routeOutput(OutputDevice&) const {};

        void beginEventOutput(const MSTransportable&, SUMOTime, OutputDevice&) const {};

        void endEventOutput(const MSTransportable&, SUMOTime, OutputDevice&) const {};

    private:
        class ProceedCmd : public Command {
        public:
            ProceedCmd(MSTransportable* person, MSEdge* edge) : myPerson(person), myStopEdge(edge) {}
            ~ProceedCmd() {}
            SUMOTime execute(SUMOTime currentTime);
        private:
            MSTransportable* const myPerson;
            MSEdge* myStopEdge;
        private:
            ProceedCmd& operator=(const ProceedCmd&);
        };

    private:
        const double myDist;
        const bool myAmExit;
        SUMOTime myEstimatedArrival;
        PositionVector myPath;
    };

public:
    MSPerson(const SUMOVehicleParameter* pars, MSVehicleType* vtype, MSTransportable::MSTransportablePlan* plan, const double speedFactor);

    virtual ~MSPerson();

    /* @brief proceeds to the next step of the route,
     * @return Whether the persons plan continues  */
    bool proceed(MSNet* net, SUMOTime time);

    const std::string& getNextEdge() const;

    const MSEdge* getNextEdgePtr() const;

    virtual void tripInfoOutput(OutputDevice& os, MSTransportable* transportable) const;

    virtual void routeOutput(OutputDevice& os) const;

    virtual bool isSelected() const {
        return false;
    }

    inline double getSpeedFactor() const {
        return myChosenSpeedFactor;
    }

    void reroute(ConstMSEdgeVector& newEdges, double departPos, int firstIndex, int nextIndex);


    class Influencer {
    public:
        Influencer();


        ~Influencer();


        void setRemoteControlled(Position xyPos, MSLane* l, double pos, double posLat, double angle, int edgeOffset, const ConstMSEdgeVector& route, SUMOTime t);

        SUMOTime getLastAccessTimeStep() const {
            return myLastRemoteAccess;
        }

        void postProcessRemoteControl(MSPerson* p);

        bool isRemoteControlled() const;

        bool isRemoteAffected(SUMOTime t) const;

    private:
        Position myRemoteXYPos;
        MSLane* myRemoteLane;
        double myRemotePos;
        double myRemotePosLat;
        double myRemoteAngle;
        int myRemoteEdgeOffset;
        ConstMSEdgeVector myRemoteRoute;
        SUMOTime myLastRemoteAccess;
    };


    Influencer& getInfluencer();

    const Influencer* getInfluencer() const;

    bool hasInfluencer() const {
        return myInfluencer != 0;
    }

    void setRemoteState(Position xyPos);

private:
    Influencer* myInfluencer;

    const double myChosenSpeedFactor;

    static DummyState myDummyState;

private:
    MSPerson(const MSPerson&);

    MSPerson& operator=(const MSPerson&);

};


#endif

/****************************************************************************/