MSLCM_DK2004.h

Go to the documentation of this file.

/****************************************************************************/
//  »missingDescription«
/****************************************************************************/
// 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 MSLCM_DK2004_h
#define MSLCM_DK2004_h


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

#include <microsim/MSAbstractLaneChangeModel.h>
#include <microsim/MSVehicleQuitReminded.h>
#include <vector>

// ===========================================================================
// enumeration definition
// ===========================================================================
enum MyLCAEnum {
    LCA_AMBLOCKINGLEADER = 256, // 0
    LCA_AMBLOCKINGFOLLOWER = 512,// 1
    LCA_MRIGHT = 1024, // 2
    LCA_MLEFT = 2048,// 3
    LCA_UNBLOCK = 4096,// 4
    LCA_AMBLOCKINGFOLLOWER_DONTBRAKE = 8192,// 5
    LCA_AMBLOCKINGSECONDFOLLOWER = 16384, // 6
    LCA_KEEP1 = 65536,// 8
    LCA_KEEP2 = 131072,// 9
    LCA_AMBACKBLOCKER = 262144,// 10
    LCA_AMBACKBLOCKER_STANDING = 524288// 11

};

// ===========================================================================
// class definitions
// ===========================================================================
class MSLCM_DK2004 : public MSAbstractLaneChangeModel {
public:
    MSLCM_DK2004(MSVehicle &v);

    virtual ~MSLCM_DK2004();

    virtual int wantsChangeToRight(
        MSAbstractLaneChangeModel::MSLCMessager &msgPass, int blocked,
        const std::pair<MSVehicle*, SUMOReal> &leader,
        const std::pair<MSVehicle*, SUMOReal> &neighLead,
        const std::pair<MSVehicle*, SUMOReal> &neighFollow,
        const MSLane &neighLane,
        const std::vector<MSVehicle::LaneQ> &preb,
        /*
        int bestLaneOffset, SUMOReal bestDist, SUMOReal neighDist,
        SUMOReal currentDist,
        */
        MSVehicle **lastBlocked);

    virtual int wantsChangeToLeft(
        MSAbstractLaneChangeModel::MSLCMessager &msgPass, int blocked,
        const std::pair<MSVehicle*, SUMOReal> &leader,
        const std::pair<MSVehicle*, SUMOReal> &neighLead,
        const std::pair<MSVehicle*, SUMOReal> &neighFollow,
        const MSLane &neighLane,
        const std::vector<MSVehicle::LaneQ> &preb,
        /*
        //        bool congested, bool predInteraction,
        int bestLaneOffset, SUMOReal bestDist, SUMOReal neighDist,
        SUMOReal currentDist,
        */
        MSVehicle **lastBlocked);

    virtual void *inform(void *info, MSVehicle *sender);

    virtual SUMOReal patchSpeed(SUMOReal min, SUMOReal wanted, SUMOReal max,
                                SUMOReal vsafe);

    virtual void changed();

    SUMOReal getProb() const;
    virtual void prepareStep();

    SUMOReal getChangeProbability() const {
        return myChangeProbability;
    }


protected:
    /*
    void unblockLeader();
    void unblockFollower();
    */
    void informBlocker(MSAbstractLaneChangeModel::MSLCMessager &msgPass,
                       int &blocked, int dir,
                       const std::pair<MSVehicle*, SUMOReal> &neighLead,
                       const std::pair<MSVehicle*, SUMOReal> &neighFollow);

    inline bool amBlockingLeader() {
        return (myState&LCA_AMBLOCKINGLEADER)!=0;
    }
    inline bool amBlockingFollower() {
        return (myState&LCA_AMBLOCKINGFOLLOWER)!=0;
    }
    inline bool amBlockingFollowerNB() {
        return (myState&LCA_AMBLOCKINGFOLLOWER_DONTBRAKE)!=0;
    }
    inline bool amBlockingFollowerPlusNB() {
        return (myState&(LCA_AMBLOCKINGFOLLOWER|LCA_AMBLOCKINGFOLLOWER_DONTBRAKE))!=0;
    }
    inline bool currentDistDisallows(SUMOReal dist, int laneOffset, SUMOReal lookForwardDist) {
        return dist/(abs(laneOffset))<lookForwardDist;
    }
    inline bool currentDistAllows(SUMOReal dist, int laneOffset, SUMOReal lookForwardDist) {
        return dist/abs(laneOffset)>lookForwardDist;
    }

    typedef std::pair<SUMOReal, int> Info;



protected:
    SUMOReal myChangeProbability;
    SUMOReal myVSafe;
    MSVehicle *myBlockingLeader;
    MSVehicle *myBlockingFollower;
    SUMOReal myUrgency;
};


#endif

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