SUMO - Simulation of Urban MObility
 All Data Structures Namespaces Files Functions Variables Typedefs Enumerations Enumerator Friends Macros Groups Pages
MSLaneChanger Class Reference

Performs lane changing of vehicles. More...

#include <MSLaneChanger.h>

Data Structures

struct  ChangeElem
 

Public Types

typedef std::vector< ChangeElemChanger
 The list of changers; For each lane, a ChangeElem is being build. More...
 
typedef Changer::iterator ChangerIt
 the iterator moving over the ChangeElems More...
 
typedef Changer::const_iterator ConstChangerIt
 the iterator moving over the ChangeElems More...
 

Public Member Functions

void laneChange (SUMOTime t)
 Start lane-change-process for all vehicles on the edge'e lanes. More...
 
 MSLaneChanger (std::vector< MSLane * > *lanes, bool allowSwap)
 Constructor. More...
 
 ~MSLaneChanger ()
 Destructor. More...
 

Protected Member Functions

bool change ()
 
int change2left (const std::pair< MSVehicle *const, SUMOReal > &leader, const std::pair< MSVehicle *const, SUMOReal > &rLead, const std::pair< MSVehicle *const, SUMOReal > &rFollow, const std::vector< MSVehicle::LaneQ > &preb) const
 
int change2right (const std::pair< MSVehicle *const, SUMOReal > &leader, const std::pair< MSVehicle *const, SUMOReal > &rLead, const std::pair< MSVehicle *const, SUMOReal > &rFollow, const std::vector< MSVehicle::LaneQ > &preb) const
 
ChangerIt findCandidate ()
 Find current candidate. If there is none, myChanger.end() is returned. More...
 
std::pair< MSVehicle *const,
SUMOReal
getRealFollower (const ChangerIt &target) const
 
std::pair< MSVehicle *const,
SUMOReal
getRealLeader (const ChangerIt &target) const
 
std::pair< MSVehicle *const,
SUMOReal
getRealThisLeader (const ChangerIt &target) const
 
void initChanger ()
 Initialize the changer before looping over all vehicles. More...
 
bool overlapWithHopped (ChangerIt target) const
 
void updateChanger (bool vehHasChanged)
 
void updateLanes (SUMOTime t)
 
MSVehicleveh (ConstChangerIt ce) const
 
bool vehInChanger () const
 Check if there is a single change-candidate in the changer. Returns true if there is one. More...
 

Protected Attributes

bool myAllowsSwap
 Whether blocking vehicles may be swapped. More...
 
ChangerIt myCandi
 
Changer myChanger
 Container for ChangeElemements, one for every lane in the edge. More...
 

Private Member Functions

 MSLaneChanger ()
 Default constructor. More...
 
 MSLaneChanger (const MSLaneChanger &)
 Copy constructor. More...
 
MSLaneChangeroperator= (const MSLaneChanger &)
 Assignment operator. More...
 

Detailed Description

Performs lane changing of vehicles.

Definition at line 54 of file MSLaneChanger.h.

Member Typedef Documentation

typedef std::vector< ChangeElem > MSLaneChanger::Changer

The list of changers; For each lane, a ChangeElem is being build.

Definition at line 91 of file MSLaneChanger.h.

typedef Changer::iterator MSLaneChanger::ChangerIt

the iterator moving over the ChangeElems

Definition at line 94 of file MSLaneChanger.h.

typedef Changer::const_iterator MSLaneChanger::ConstChangerIt

the iterator moving over the ChangeElems

Definition at line 97 of file MSLaneChanger.h.

Constructor & Destructor Documentation

MSLaneChanger::~MSLaneChanger ( )

Destructor.

Definition at line 80 of file MSLaneChanger.cpp.

MSLaneChanger::MSLaneChanger ( )
private

Default constructor.

MSLaneChanger::MSLaneChanger ( const MSLaneChanger )
private

Copy constructor.

Member Function Documentation

int MSLaneChanger::change2left ( const std::pair< MSVehicle *const, SUMOReal > &  leader,
const std::pair< MSVehicle *const, SUMOReal > &  rLead,
const std::pair< MSVehicle *const, SUMOReal > &  rFollow,
const std::vector< MSVehicle::LaneQ > &  preb 
) const
protected
int MSLaneChanger::change2right ( const std::pair< MSVehicle *const, SUMOReal > &  leader,
const std::pair< MSVehicle *const, SUMOReal > &  rLead,
const std::pair< MSVehicle *const, SUMOReal > &  rFollow,
const std::vector< MSVehicle::LaneQ > &  preb 
) const
protected
MSLaneChanger::ChangerIt MSLaneChanger::findCandidate ( )
protected

Find current candidate. If there is none, myChanger.end() is returned.

Definition at line 445 of file MSLaneChanger.cpp.

References max, myChanger, and veh().

Referenced by change().

std::pair< MSVehicle *const, SUMOReal > MSLaneChanger::getRealFollower ( const ChangerIt target) const
protected
void MSLaneChanger::initChanger ( )
protected

Initialize the changer before looping over all vehicles.

Definition at line 100 of file MSLaneChanger.cpp.

References myChanger.

Referenced by laneChange().

void MSLaneChanger::laneChange ( SUMOTime  t)

Start lane-change-process for all vehicles on the edge'e lanes.

Definition at line 84 of file MSLaneChanger.cpp.

References change(), initChanger(), updateChanger(), updateLanes(), and vehInChanger().

Referenced by MSEdge::changeLanes().

MSLaneChanger& MSLaneChanger::operator= ( const MSLaneChanger )
private

Assignment operator.

bool MSLaneChanger::overlapWithHopped ( ChangerIt  target) const
inlineprotected

Returns true if candidate overlaps with a vehicle, that already changed the lane.

Definition at line 159 of file MSLaneChanger.h.

References myCandi, MSVehicle::overlap(), and veh().

Referenced by change2left(), and change2right().

void MSLaneChanger::updateChanger ( bool  vehHasChanged)
protected

After the possible change, update the changer.

Definition at line 402 of file MSLaneChanger.cpp.

References myCandi, and veh().

Referenced by laneChange().

void MSLaneChanger::updateLanes ( SUMOTime  t)
protected

During lane-change a temporary vehicle container is filled within the lanes (bad pratice to modify foreign members, I know). Swap this container with the real one.

Definition at line 428 of file MSLaneChanger.cpp.

References myChanger.

Referenced by laneChange().

MSVehicle* MSLaneChanger::veh ( ConstChangerIt  ce) const
inlineprotected

Returns a pointer to the changer-element-iterator vehicle, or 0 if there is none.

Definition at line 118 of file MSLaneChanger.h.

Referenced by change(), change2left(), change2right(), findCandidate(), getRealFollower(), getRealLeader(), getRealThisLeader(), overlapWithHopped(), updateChanger(), and vehInChanger().

bool MSLaneChanger::vehInChanger ( ) const
inlineprotected

Check if there is a single change-candidate in the changer. Returns true if there is one.

Definition at line 105 of file MSLaneChanger.h.

References myChanger, and veh().

Referenced by laneChange().

Field Documentation

bool MSLaneChanger::myAllowsSwap
protected

Whether blocking vehicles may be swapped.

Definition at line 184 of file MSLaneChanger.h.

Referenced by change().

ChangerIt MSLaneChanger::myCandi
protected

Change-candidate. Last of the vehicles in changer. Only this one will try to change. Every vehicle on the edge will be a candidate once in the change-process.

Definition at line 181 of file MSLaneChanger.h.

Referenced by change(), change2left(), change2right(), getRealFollower(), getRealLeader(), getRealThisLeader(), overlapWithHopped(), and updateChanger().

Changer MSLaneChanger::myChanger
protected

Container for ChangeElemements, one for every lane in the edge.

Definition at line 176 of file MSLaneChanger.h.

Referenced by change(), findCandidate(), initChanger(), MSLaneChanger(), updateLanes(), and vehInChanger().


The documentation for this class was generated from the following files: