MSNet.h

Go to the documentation of this file.

/****************************************************************************/
// The simulated network and simulation perfomer
/****************************************************************************/
// 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 MSNet_h
#define MSNet_h


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

#include <typeinfo>
#include <vector>
#include <map>
#include <string>
#include <fstream>
#include <iostream>
#include <cmath>
#include <iomanip>
#include "MSVehicleControl.h"
#include "MSEventControl.h"
#include <utils/geom/Boundary.h>
#include <utils/geom/Position.h>
#include <utils/common/SUMOTime.h>
#include <microsim/trigger/MSBusStop.h>
#include <utils/common/UtilExceptions.h>
#include <utils/common/NamedObjectCont.h>
#include <utils/common/SUMOAbstractRouter.h>
#include <utils/common/DijkstraRouterTT.h>
#include <utils/common/DijkstraRouterEffort.h>
#include <utils/common/AStarRouter.h>
#include <utils/common/NamedRTree.h>


// ===========================================================================
// class declarations
// ===========================================================================
class MSEdge;
class MSEdgeControl;
class MSJunctionControl;
class MSInsertionControl;
class SUMORouteLoaderControl;
class MSPersonControl;
class MSVehicle;
class MSRoute;
class MSLane;
class MSTLLogicControl;
class MSDetectorControl;
class ShapeContainer;
class BinaryInputDevice;
class MSEdgeWeightsStorage;
class SUMOVehicle;


// ===========================================================================
// class definitions
// ===========================================================================
class MSNet {
public:
    enum SimulationState {
        SIMSTATE_RUNNING,
        SIMSTATE_END_STEP_REACHED,
        SIMSTATE_NO_FURTHER_VEHICLES,
        SIMSTATE_CONNECTION_CLOSED,
        SIMSTATE_ERROR_IN_SIM,
        SIMSTATE_TOO_MANY_VEHICLES
    };


public:
    static MSNet* getInstance();


    MSNet(MSVehicleControl* vc, MSEventControl* beginOfTimestepEvents,
          MSEventControl* endOfTimestepEvents, MSEventControl* insertionEvents,
          ShapeContainer* shapeCont = 0);


    virtual ~MSNet();


    void closeBuilding(MSEdgeControl* edges, MSJunctionControl* junctions,
                       SUMORouteLoaderControl* routeLoaders, MSTLLogicControl* tlc,
                       std::vector<SUMOTime> stateDumpTimes, std::vector<std::string> stateDumpFiles);


    static void clearAll();


    int simulate(SUMOTime start, SUMOTime stop);


    void simulationStep();


    void loadRoutes();


    void closeSimulation(SUMOTime start);


    SimulationState simulationState(SUMOTime stopTime) const;


    static std::string getStateMessage(SimulationState state);


    SUMOTime getCurrentTimeStep() const;


    void writeOutput();


    bool logSimulationDuration() const;





    void preSimStepOutput() const;


    void postSimStepOutput() const;
    //}




    MSVehicleControl& getVehicleControl() {
        return *myVehicleControl;
    }


    virtual MSPersonControl& getPersonControl();


    MSEdgeControl& getEdgeControl() {
        return *myEdges;
    }


    MSInsertionControl& getInsertionControl() {
        return *myInserter;
    }


    MSDetectorControl& getDetectorControl() {
        return *myDetectorControl;
    }


    MSTLLogicControl& getTLSControl() {
        return *myLogics;
    }


    MSJunctionControl& getJunctionControl() {
        return *myJunctions;
    }


    MSEventControl& getBeginOfTimestepEvents() {
        return *myBeginOfTimestepEvents;
    }


    MSEventControl& getEndOfTimestepEvents() {
        return *myEndOfTimestepEvents;
    }


    MSEventControl& getInsertionEvents() {
        return *myInsertionEvents;
    }


    ShapeContainer& getShapeContainer() {
        return *myShapeContainer;
    }


    MSEdgeWeightsStorage& getWeightsStorage();




    bool addBusStop(MSBusStop* busStop);


    MSBusStop* getBusStop(const std::string& id) const;


    std::string getBusStopID(const MSLane* lane, const SUMOReal pos) const;




    enum VehicleState {
        VEHICLE_STATE_BUILT,
        VEHICLE_STATE_DEPARTED,
        VEHICLE_STATE_STARTING_TELEPORT,
        VEHICLE_STATE_ENDING_TELEPORT,
        VEHICLE_STATE_ARRIVED,
        VEHICLE_STATE_NEWROUTE,
        VEHICLE_STATE_STARTING_PARKING,
        VEHICLE_STATE_ENDING_PARKING,
        VEHICLE_STATE_STARTING_STOP,
        VEHICLE_STATE_ENDING_STOP
    };


    class VehicleStateListener {
    public:
        VehicleStateListener() { }

        virtual ~VehicleStateListener() { }

        virtual void vehicleStateChanged(const SUMOVehicle* const vehicle, VehicleState to) = 0;

    };


    void addVehicleStateListener(VehicleStateListener* listener);


    void removeVehicleStateListener(VehicleStateListener* listener);


    void informVehicleStateListener(const SUMOVehicle* const vehicle, VehicleState to);



    static SUMOReal getTravelTime(const MSEdge* const e, const SUMOVehicle* const v, SUMOReal t);


    static SUMOReal getEffort(const MSEdge* const e, const SUMOVehicle* const v, SUMOReal t);


    /* @brief get the router, initialize on first use
     * @param[in] prohibited The vector of forbidden edges (optional)
     */
    SUMOAbstractRouter<MSEdge, SUMOVehicle>& getRouterTT(
        const std::vector<MSEdge*>& prohibited = std::vector<MSEdge*>()) const;
    SUMOAbstractRouter<MSEdge, SUMOVehicle>& getRouterEffort(
        const std::vector<MSEdge*>& prohibited = std::vector<MSEdge*>()) const;


    const NamedRTree& getLanesRTree() const;


protected:
    static MSNet* myInstance;

    SUMORouteLoaderControl* myRouteLoaders;

    SUMOTime myStep;




    MSVehicleControl* myVehicleControl;
    MSPersonControl* myPersonControl;
    MSEdgeControl* myEdges;
    MSJunctionControl* myJunctions;
    MSTLLogicControl* myLogics;
    MSInsertionControl* myInserter;
    MSDetectorControl* myDetectorControl;
    MSEventControl* myBeginOfTimestepEvents;
    MSEventControl* myEndOfTimestepEvents;
    MSEventControl* myInsertionEvents;
    ShapeContainer* myShapeContainer;
    MSEdgeWeightsStorage* myEdgeWeights;




    bool myLogExecutionTime;

    bool myLogStepNumber;

    long mySimStepBegin, mySimStepEnd, mySimStepDuration;

    long mySimBeginMillis;

    SUMOLong myVehiclesMoved;
    //}




    std::vector<SUMOTime> myStateDumpTimes;
    std::vector<std::string> myStateDumpFiles;



    int myTooManyVehicles;

    NamedObjectCont<MSBusStop*> myBusStopDict;

    std::vector<VehicleStateListener*> myVehicleStateListeners;


    /* @brief The router instance for routing by trigger and by traci
     * @note MSDevice_Routing has its own instance since it uses a different weight function
     * @note we provide one member for every switchable router type
     * because the class structure makes it inconvenient to use a superclass*/
    mutable bool myRouterTTInitialized;
    mutable DijkstraRouterTT_ByProxi<MSEdge, SUMOVehicle, prohibited_withRestrictions<MSEdge, SUMOVehicle> >* myRouterTTDijkstra;
    mutable AStarRouterTT_ByProxi<MSEdge, SUMOVehicle, prohibited_withRestrictions<MSEdge, SUMOVehicle> >* myRouterTTAStar;
    mutable DijkstraRouterEffort_ByProxi<MSEdge, SUMOVehicle, prohibited_withRestrictions<MSEdge, SUMOVehicle> >* myRouterEffort;


    mutable std::pair<bool, NamedRTree> myLanesRTree;


private:
    MSNet(const MSNet&);

    MSNet& operator=(const MSNet&);


};


#endif

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