MSEdge.h

Go to the documentation of this file.

/****************************************************************************/
// A road/street connecting two junctions
/****************************************************************************/
// SUMO, Simulation of Urban MObility; see http://sumo.sourceforge.net/
// Copyright 2001-2010 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 MSEdge_h
#define MSEdge_h


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

#include <vector>
#include <map>
#include <string>
#include <iostream>
#include "MSLinkCont.h"
#include <utils/common/SUMOTime.h>
#include <utils/common/SUMOVehicleClass.h>
#include <utils/common/ValueTimeLine.h>
#include <utils/common/UtilExceptions.h>


// ===========================================================================
// class declarations
// ===========================================================================
class MSLane;
class MSLaneChanger;
class OutputDevice;
class SUMOVehicle;


// ===========================================================================
// class definitions
// ===========================================================================
class MSEdge {
public:
    enum EdgeBasicFunction {
        EDGEFUNCTION_UNKNOWN = -1,
        EDGEFUNCTION_NORMAL = 0,
        EDGEFUNCTION_CONNECTOR = 1,
        EDGEFUNCTION_INTERNAL = 2,
        EDGEFUNCTION_DISTRICT = 3
    };


    typedef std::map< const MSEdge*, std::vector<MSLane*>* > AllowedLanesCont;

    typedef std::map< SUMOVehicleClass, AllowedLanesCont > ClassedAllowedLanesCont;


public:
    MSEdge(const std::string &id, unsigned int numericalID) throw();


    virtual ~MSEdge() throw();


    void initialize(MSLane* departLane, std::vector<MSLane*>* lanes, EdgeBasicFunction function) throw();


    void closeBuilding();



    MSLane * const leftLane(const MSLane * const lane) const throw();


    MSLane * const rightLane(const MSLane* const lane) const throw();


    const std::vector<MSLane*> &getLanes() const throw() {
        return *myLanes;
    }


    const std::vector<MSLane*>* allowedLanes(const MSEdge& destination,
            SUMOVehicleClass vclass=SVC_UNKNOWN) const throw();


    const std::vector<MSLane*>* allowedLanes(SUMOVehicleClass vclass=SVC_UNKNOWN) const throw();




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


    EdgeBasicFunction getPurpose() const throw() {
        return myFunction;
    }


    unsigned int getNumericalID() const throw() {
        return myNumericalID;
    }




    void addFollower(MSEdge* edge) throw() {
        mySuccessors.push_back(edge);
    }


    const std::vector<MSEdge*> &getIncomingEdges() const throw() {
        return myPredeccesors;
    }


    unsigned int getNoFollowing() const throw() {
        return (unsigned int) mySuccessors.size();
    }

    const MSEdge * const getFollower(unsigned int n) const throw() {
        return mySuccessors[n];
    }




    bool isVaporizing() const throw() {
        return myVaporizationRequests>0;
    }


    SUMOTime incVaporization(SUMOTime t) throw(ProcessError);


    SUMOTime decVaporization(SUMOTime t) throw(ProcessError);


    SUMOReal getCurrentTravelTime() const throw();




    bool emit(MSVehicle &v, SUMOTime time) const throw(ProcessError);


    MSLane* getFreeLane(const SUMOVehicleClass vclass) const throw();


    MSLane* getDepartLane(const MSVehicle &v) const throw();


    inline SUMOTime getLastFailedEmissionTime() const throw() {
        return myLastFailedEmissionTime;
    }


    inline void setLastFailedEmissionTime(SUMOTime time) const throw() {
        myLastFailedEmissionTime = time;
    }


    virtual void changeLanes(SUMOTime t) throw();


#ifdef HAVE_INTERNAL_LANES
    const MSEdge *getInternalFollowingEdge(MSEdge *followerAfterInternal) const throw();
#endif

    bool prohibits(const SUMOVehicle * const vehicle) const throw();

    void rebuildAllowedLanes() throw();



    static bool dictionary(const std::string &id, MSEdge* edge) throw();

    static MSEdge* dictionary(const std::string &id) throw();

    static MSEdge* dictionary(size_t index) throw();

    static size_t dictSize() throw();

    static void clear() throw();

    static void insertIDs(std::vector<std::string> &into) throw();


public:

    static void parseEdgesList(const std::string &desc, std::vector<const MSEdge*> &into,
                               const std::string &rid) throw(ProcessError);


    static void parseEdgesList(const std::vector<std::string> &desc, std::vector<const MSEdge*> &into,
                               const std::string &rid) throw(ProcessError);


protected:
    class by_id_sorter {
    public:
        explicit by_id_sorter() { }

        int operator()(const MSEdge * const e1, const MSEdge * const e2) const {
            return e1->getID()<e2->getID();
        }

    };


    const std::vector<MSLane*>* allowedLanes(const MSEdge *destination,
            SUMOVehicleClass vclass=SVC_UNKNOWN) const throw();

protected:
    std::string myID;

    unsigned int myNumericalID;

    std::vector<MSLane*>* myLanes;

    MSLane* myDepartLane;

    MSLaneChanger* myLaneChanger;

    EdgeBasicFunction myFunction;

    int myVaporizationRequests;

    mutable SUMOTime myLastFailedEmissionTime;

    std::vector<MSEdge*> mySuccessors;

    std::vector<MSEdge*> myPredeccesors;




    AllowedLanesCont myAllowed;

    ClassedAllowedLanesCont myClassedAllowed;

    bool myHaveClassConstraints;




    typedef std::map< std::string, MSEdge* > DictType;

    static DictType myDict;

    static std::vector<MSEdge*> myEdges;



private:
    MSEdge(const MSEdge&);

    MSEdge& operator=(const MSEdge&);

};


#endif

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