MSTrafficLightLogic.h

Go to the documentation of this file.

/****************************************************************************/
// The parent class for traffic light logics
/****************************************************************************/
// SUMO, Simulation of Urban MObility; see http://sumo.sourceforge.net/
// Copyright (C) 2001-2011 DLR (http://www.dlr.de/) and contributors
/****************************************************************************/
//
//   This program is free software; you can redistribute it and/or modify
//   it under the terms of the GNU General Public License as published by
//   the Free Software Foundation; either version 2 of the License, or
//   (at your option) any later version.
//
/****************************************************************************/
#ifndef MSTrafficLightLogic_h
#define MSTrafficLightLogic_h


// ===========================================================================
// included modules
// ===========================================================================
#ifdef _MSC_VER
#include <windows_config.h>
#else
#include <config.h>
#endif

#include <map>
#include <string>
#include <bitset>
#include <utils/common/Command.h>
#include <microsim/MSLogicJunction.h>
#include <microsim/MSLink.h>
#include "MSPhaseDefinition.h"


// ===========================================================================
// class declarations
// ===========================================================================
class MSNet;
class MSLink;
class MSTLLogicControl;
class NLDetectorBuilder;


// ===========================================================================
// class definitions
// ===========================================================================
class MSTrafficLightLogic {
public:

    typedef std::vector<MSPhaseDefinition*> Phases;

    typedef std::vector<MSLink*> LinkVector;

    typedef std::vector<LinkVector> LinkVectorVector;

    typedef std::vector<MSLane*> LaneVector;

    typedef std::vector<LaneVector> LaneVectorVector;


public:
    MSTrafficLightLogic(MSTLLogicControl& tlcontrol,
                        const std::string& id, const std::string& programID, SUMOTime delay);


    virtual void init(NLDetectorBuilder& nb);


    virtual ~MSTrafficLightLogic();




    void addLink(MSLink* link, MSLane* lane, unsigned int pos);


    virtual void adaptLinkInformationFrom(const MSTrafficLightLogic& logic);


    std::map<MSLink*, LinkState> collectLinkStates() const;


    void resetLinkStates(const std::map<MSLink*, LinkState> &vals) const;




    virtual SUMOTime trySwitch(bool isActive) = 0;


    bool setTrafficLightSignals(SUMOTime t) const;




    const std::string& getID() const {
        return myID;
    }


    const std::string& getProgramID() const {
        return myProgramID;
    }


    const LaneVectorVector& getLanes() const {
        return myLanes;
    }


    const LaneVector& getLanesAt(unsigned int i) const {
        return myLanes[i];
    }


    const LinkVectorVector& getLinks() const {
        return myLinks;
    }


    const LinkVector& getLinksAt(unsigned int i) const {
        return myLinks[i];
    }


    int getLinkIndex(const MSLink* const link) const;


    virtual unsigned int getPhaseNumber() const = 0;


    virtual const Phases& getPhases() const = 0;


    virtual const MSPhaseDefinition& getPhase(unsigned int givenstep) const = 0;




    virtual unsigned int getCurrentPhaseIndex() const = 0;


    virtual const MSPhaseDefinition& getCurrentPhaseDef() const = 0;


    SUMOTime getDefaultCycleTime() const {
        return myDefaultCycleTime;
    }


    SUMOTime getNextSwitchTime() const;




    virtual SUMOTime getPhaseIndexAtTime(SUMOTime simStep) const = 0;


    virtual SUMOTime getOffsetFromIndex(unsigned int index) const = 0;


    virtual unsigned int getIndexFromOffset(SUMOTime offset) const = 0;




    void addOverridingDuration(SUMOTime duration);


    void setCurrentDurationIncrement(SUMOTime delay);


    virtual void changeStepAndDuration(MSTLLogicControl& tlcontrol,
                                       SUMOTime simStep, unsigned int step, SUMOTime stepDuration) = 0;





    void setParameter(const std::map<std::string, std::string> &params);


    std::string getParameterValue(const std::string& key) const;


protected:
    class SwitchCommand : public Command {
    public:
        SwitchCommand(MSTLLogicControl& tlcontrol,
                      MSTrafficLightLogic* tlLogic,
                      SUMOTime nextSwitch);

        ~SwitchCommand();

        SUMOTime execute(SUMOTime currentTime);


        void deschedule(MSTrafficLightLogic* tlLogic);


        SUMOTime getNextSwitchTime() const {
            return myAssumedNextSwitch;
        }


    private:
        MSTLLogicControl& myTLControl;

        MSTrafficLightLogic* myTLLogic;

        SUMOTime myAssumedNextSwitch;

        bool myAmValid;

    private:
        SwitchCommand(const SwitchCommand&);

        SwitchCommand& operator=(const SwitchCommand&);

    };

protected:
    std::map<std::string, std::string> myParameter;

    std::string myID, myProgramID;

    LinkVectorVector myLinks;

    LaneVectorVector myLanes;

    std::vector<SUMOTime> myOverridingTimes;

    SUMOTime myCurrentDurationIncrement;

    SwitchCommand* mySwitchCommand;

    SUMOTime myDefaultCycleTime;


private:
    MSTrafficLightLogic(const MSTrafficLightLogic& s);

    MSTrafficLightLogic& operator=(const MSTrafficLightLogic& s);

};


#endif

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