NBTrafficLightDefinition.h

Go to the documentation of this file.

/****************************************************************************/
// The base class for traffic light logic definitions
/****************************************************************************/
// SUMO, Simulation of Urban MObility; see http://sumo-sim.org/
// Copyright (C) 2001-2013 DLR (http://www.dlr.de/) and contributors
/****************************************************************************/
//
//   This file is part of SUMO.
//   SUMO 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 3 of the License, or
//   (at your option) any later version.
//
/****************************************************************************/
#ifndef NBTrafficLightDefinition_h
#define NBTrafficLightDefinition_h


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

#include <vector>
#include <string>
#include <bitset>
#include <utility>
#include <set>
#include <utils/common/Named.h>
#include <utils/common/VectorHelper.h>
#include <utils/common/SUMOTime.h>
#include <utils/common/UtilExceptions.h>
#include <utils/common/Parameterised.h>
#include "NBCont.h"
#include "NBConnection.h"
#include "NBConnectionDefs.h"
#include "NBLinkPossibilityMatrix.h"


// ===========================================================================
// class declarations
// ===========================================================================
class NBNode;
class OptionsCont;
class NBTrafficLightLogic;


// ===========================================================================
// class definitions
// ===========================================================================
class NBTrafficLightDefinition : public Named, public Parameterised {
public:

    static const std::string DefaultProgramID;

    enum TLColor {
        TLCOLOR_RED,
        TLCOLOR_YELLOW,
        TLCOLOR_REDYELLOW,
        TLCOLOR_GREEN,
        TLCOLOR_BLINK
    };


    NBTrafficLightDefinition(const std::string& id,
                             const std::vector<NBNode*>& junctions,
                             const std::string& programID,
                             SUMOTime offset,
                             TrafficLightType type);


    NBTrafficLightDefinition(const std::string& id,
                             NBNode* junction,
                             const std::string& programID,
                             SUMOTime offset,
                             TrafficLightType type);


    NBTrafficLightDefinition(const std::string& id, const std::string& programID,
                             SUMOTime offset,
                             TrafficLightType type);


    virtual ~NBTrafficLightDefinition();


    NBTrafficLightLogic* compute(const NBEdgeCont& ec, OptionsCont& oc);




    virtual void addNode(NBNode* node);


    virtual void removeNode(NBNode* node);


    const std::vector<NBNode*>& getNodes() const {
        return myControlledNodes;
    }


    bool mustBrake(const NBEdge* const from, const NBEdge* const to) const;


    bool mustBrake(const NBConnection& possProhibited,
                   const NBConnection& possProhibitor,
                   bool regardNonSignalisedLowerPriority) const;

    bool mustBrake(const NBEdge* const possProhibitedFrom, const NBEdge* const possProhibitedTo,
                   const NBEdge* const possProhibitorFrom, const NBEdge* const possProhibitorTo,
                   bool regardNonSignalisedLowerPriority) const;


    bool forbids(const NBEdge* const possProhibitorFrom, const NBEdge* const possProhibitorTo,
                 const NBEdge* const possProhibitedFrom, const NBEdge* const possProhibitedTo,
                 bool regardNonSignalisedLowerPriority) const;


    bool foes(const NBEdge* const from1, const NBEdge* const to1,
              const NBEdge* const from2, const NBEdge* const to2) const;


    virtual void setTLControllingInformation(const NBEdgeCont& ec) const = 0;


    virtual void setParticipantsInformation();


    void addControlledInnerEdges(const std::vector<std::string>& edges);


    virtual void remapRemoved(NBEdge* removed,
                              const EdgeVector& incoming, const EdgeVector& outgoing) = 0;


    virtual void replaceRemoved(NBEdge* removed, int removedLane,
                                NBEdge* by, int byLane) = 0;


    bool isLeftMover(const NBEdge* const from, const NBEdge* const to) const;


    const EdgeVector& getIncomingEdges() const;


    const NBConnectionVector& getControlledLinks() const {
        return myControlledLinks;
    }


    // @breif returns the controlled nodes
    const std::vector<NBNode*>& getControlledNodes() const {
        return myControlledNodes;
    }


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


    void setProgramID(const std::string& programID) {
        mySubID = programID;
    }


    SUMOTime getOffset() {
        return myOffset;
    }


    TrafficLightType getType() const {
        return myType;
    }

protected:
    virtual NBTrafficLightLogic* myCompute(const NBEdgeCont& ec,
                                           unsigned int brakingTime) = 0;


    virtual void collectLinks() = 0;


    void collectEdges();


    unsigned int computeBrakingTime(SUMOReal minDecel) const;


    // @return whether this traffic light is invalid and should be computed
    virtual bool amInvalid() const;

    void collectAllLinks();


protected:
    std::vector<NBNode*> myControlledNodes;

    EdgeVector myIncomingEdges;

    EdgeVector myEdgesWithin;

    NBConnectionVector myControlledLinks;

    std::set<std::string> myControlledInnerEdges;

    std::string mySubID;

    SUMOTime myOffset;

    TrafficLightType myType;


};


#endif

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