MSInductLoop.h

Go to the documentation of this file.

/****************************************************************************/
// An unextended detector measuring at a fixed position on a fixed lane.
/****************************************************************************/
// 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 MSInductLoop_h
#define MSInductLoop_h


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

#include <string>
#include <deque>
#include <map>
#include <functional>
#include <microsim/MSMoveReminder.h>
#include <microsim/MSVehicle.h>
#include <microsim/MSNet.h>
#include <microsim/output/MSDetectorFileOutput.h>
#include <utils/iodevices/OutputDevice.h>
#include <utils/common/Named.h>


// ===========================================================================
// class declarations
// ===========================================================================
class MSLane;
class GUIDetectorWrapper;
class GUIGlObjectStorage;
class GUILaneWrapper;


// ===========================================================================
// class definitions
// ===========================================================================
class MSInductLoop
        : public MSMoveReminder, public MSDetectorFileOutput,
            public MSVehicleQuitReminded, public Named {
public:
    MSInductLoop(const std::string& id,
                 MSLane * const lane,
                 SUMOReal positionInMeters) throw();


    ~MSInductLoop() throw();


    void reset() throw();



    bool isStillActive(MSVehicle& veh, SUMOReal oldPos, SUMOReal newPos, SUMOReal newSpeed) throw();


    void notifyLeave(MSVehicle& veh, bool isArrival, bool isLaneChange) throw();


    bool notifyEnter(MSVehicle& veh, bool isEmit, bool isLaneChange) throw();




    SUMOReal getCurrentSpeed() const throw();


    SUMOReal getCurrentLength() const throw();


    SUMOReal getCurrentOccupancy() const throw();


    SUMOReal getCurrentPassedNumber() const throw();


    std::vector<std::string> getCurrentVehicleIDs() const throw();


    SUMOReal getTimestepsSinceLastDetection() const throw();




    unsigned getNVehContributed() const throw();




    void writeXMLOutput(OutputDevice &dev, SUMOTime startTime, SUMOTime stopTime) throw(IOError);


    void writeXMLDetectorProlog(OutputDevice &dev) const throw(IOError);




    void removeOnTripEnd(MSVehicle *veh) throw();


protected:

    void enterDetectorByMove(MSVehicle& veh, SUMOReal entryTimestep) throw();


    void leaveDetectorByMove(MSVehicle& veh, SUMOReal leaveTimestep) throw();


    void leaveDetectorByLaneChange(MSVehicle& veh) throw();


protected:
    struct VehicleData {
        VehicleData(const std::string &id, SUMOReal vehLength, SUMOReal entryTimestep, SUMOReal leaveTimestep) throw()
                : idM(id), lengthM(vehLength), entryTimeM(entryTimestep), leaveTimeM(leaveTimestep),
                speedM(lengthM / ((leaveTimeM - entryTimeM))) {}

        std::string idM;
        SUMOReal lengthM;
        SUMOReal entryTimeM;
        SUMOReal leaveTimeM;
        SUMOReal speedM;
    };


protected:

    static inline SUMOReal speedSum(SUMOReal sumSoFar, const MSInductLoop::VehicleData& data) throw() {
        return sumSoFar + data.speedM;
    }

    static inline SUMOReal lengthSum(SUMOReal sumSoFar, const MSInductLoop::VehicleData& data) throw() {
        return sumSoFar + data.lengthM;
    }


    std::vector<VehicleData> collectVehiclesOnDet(SUMOTime t) const throw();


protected:
    MSVehicle *myCurrentVehicle;

    const SUMOReal myPosition;

    SUMOReal myLastLeaveTime;

    SUMOReal myLastOccupancy;

    unsigned myDismissedVehicleNumber;


    typedef std::deque< VehicleData > VehicleDataCont;

    VehicleDataCont myVehicleDataCont;

    VehicleDataCont myLastVehicleDataCont;


    typedef std::map< MSVehicle*, SUMOReal > VehicleMap;

    VehicleMap myVehiclesOnDet;


private:
    MSInductLoop(const MSInductLoop&);

    MSInductLoop& operator=(const MSInductLoop&);


};


#endif

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