SUMO - Simulation of Urban MObility
MSLane Class Reference

Representation of a lane in the micro simulation. More...

#include <MSLane.h>

Inheritance diagram for MSLane:
Inheritance graph
Collaboration diagram for MSLane:
Collaboration graph

Data Structures

class  AnyVehicleIterator
 
class  by_connections_to_sorter
 Sorts edges by their angle relative to the given edge (straight comes first) More...
 
class  edge_finder
 
class  incoming_lane_priority_sorter
 Sorts lanes (IncomingLaneInfos) by their priority or, if this doesn't apply, wrt. the angle difference magnitude relative to the target lane's angle (straight comes first) More...
 
struct  IncomingLaneInfo
 
class  outgoing_lane_priority_sorter
 Sorts lanes (their origin link) by the priority of their noninternal target edges or, if this doesn't yield an unambiguous result, wrt. the angle difference magnitude relative to the target lane's angle (straight comes first) More...
 
class  vehicle_natural_position_sorter
 
class  vehicle_position_sorter
 Sorts vehicles by their position (descending) More...
 
struct  VehPosition
 

Public Types

enum  CollisionAction { COLLISION_ACTION_NONE, COLLISION_ACTION_WARN, COLLISION_ACTION_TELEPORT, COLLISION_ACTION_REMOVE }
 
typedef std::vector< MSVehicle * > VehCont
 Container for vehicles. More...
 

Public Member Functions

void addApproachingLane (MSLane *lane, bool warnMultiCon)
 
void addIncomingLane (MSLane *lane, MSLink *viaLink)
 
void addParameter (const std::string &key, const std::string &value)
 Adds a parameter. More...
 
void addParameter (const std::map< std::string, std::string > &mapArg)
 Adds all given parameter. More...
 
void addParameter (const Parameterised &p)
 Adds all given parameter. More...
 
void addTo (const StoringVisitor &cont) const
 Adds this object to the given container. More...
 
bool allowsVehicleClass (SUMOVehicleClass vclass) const
 
virtual bool appropriate (const MSVehicle *veh)
 
void clearParameter ()
 Clears the parameter map. More...
 
virtual void detectCollisions (SUMOTime timestep, const std::string &stage)
 Check if vehicles are too close. More...
 
bool empty () const
 Returns true if there is not a single vehicle on the lane. More...
 
void enteredByLaneChange (MSVehicle *v)
 
MSLanegetCanonicalPredecessorLane () const
 
MSLanegetCanonicalSuccessorLane () const
 
double getCenterOnEdge () const
 
std::pair< MSVehicle *const, double > getCriticalLeader (double dist, double seen, double speed, const MSVehicle &veh) const
 Returns the most dangerous leader and the distance to him. More...
 
int getCrossingIndex () const
 return the index of the link to the next crossing if this is walkingArea, else -1 More...
 
double getDouble (const std::string &key, const double defaultValue) const
 Returns the value for a given key converted to a double. More...
 
MSEdgegetEdge () const
 Returns the lane's edge. More...
 
MSLinkgetEntryLink () const
 Returns the entry link if this is an internal lane, else 0. More...
 
MSVehiclegetFirstAnyVehicle () const
 returns the first vehicle that is fully or partially on this lane More...
 
MSVehiclegetFirstFullVehicle () const
 returns the first vehicle for which this lane is responsible or 0 More...
 
std::pair< MSVehicle *const, double > getFollower (const MSVehicle *ego, double egoPos, double dist, bool ignoreMinorLinks) const
 Find follower vehicle for the given ego vehicle (which may be on the opposite direction lane) More...
 
MSLeaderDistanceInfo getFollowersOnConsecutive (const MSVehicle *ego, double backOffset, bool allSublanes, double searchDist=-1, bool ignoreMinorLinks=false) const
 return the sublane followers with the largest missing rear gap among all predecessor lanes (within dist) More...
 
const std::string & getID () const
 Returns the id. More...
 
const std::vector< IncomingLaneInfo > & getIncomingLanes () const
 
LinkState getIncomingLinkState () const
 get the state of the link from the logical predecessor to this lane More...
 
MSVehiclegetLastAnyVehicle () const
 returns the last vehicle that is fully or partially on this lane More...
 
MSVehiclegetLastFullVehicle () const
 returns the last vehicle for which this lane is responsible or 0 More...
 
std::pair< MSVehicle *const, double > getLeader (const MSVehicle *veh, const double vehPos, const std::vector< MSLane *> &bestLaneConts, double dist=-1, bool checkTmpVehicles=false) const
 Returns the immediate leader of veh and the distance to veh starting on this lane. More...
 
std::pair< MSVehicle *const, double > getLeaderOnConsecutive (double dist, double seen, double speed, const MSVehicle &veh, const std::vector< MSLane *> &bestLaneConts) const
 Returns the immediate leader and the distance to him. More...
 
void getLeadersOnConsecutive (double dist, double seen, double speed, const MSVehicle *ego, const std::vector< MSLane *> &bestLaneConts, MSLeaderDistanceInfo &result) const
 Returns the immediate leaders and the distance to them (as getLeaderOnConsecutive but for the sublane case) More...
 
const MSLinkContgetLinkCont () const
 returns the container with all links !!! More...
 
MSLinkgetLinkTo (const MSLane *) const
 returns the link to the given lane or 0, if it is not connected More...
 
MSLanegetLogicalPredecessorLane () const
 get the most likely precedecessor lane (sorted using by_connections_to_sorter). The result is cached in myLogicalPredecessorLane More...
 
MSLanegetLogicalPredecessorLane (const MSEdge &fromEdge) const
 return the (first) predecessor lane from the given edge More...
 
const std::map< std::string, std::string > & getMap () const
 Returns the inner key/value map. More...
 
double getMissingRearGap (const MSVehicle *leader, double backOffset, double leaderSpeed) const
 return by how much further the leader must be inserted to avoid rear end collisions More...
 
const MSEdgegetNextNormal () const
 Returns the lane's follower if it is an internal lane, the edge of the lane otherwise. More...
 
MSLanegetOpposite () const
 return the opposite direction lane for lane changing or 0 More...
 
std::pair< MSVehicle *const, double > getOppositeFollower (const MSVehicle *ego) const
 
std::pair< MSVehicle *const, double > getOppositeLeader (const MSVehicle *ego, double dist, bool oppositeDir) const
 
double getOppositePos (double pos) const
 return the corresponding position on the opposite lane More...
 
std::vector< const MSLane * > getOutgoingLanes () const
 get the list of outgoing lanes More...
 
MSLanegetParallelLane (int offset) const
 Returns the lane with the given offset parallel to this one or 0 if it does not exist. More...
 
const std::string & getParameter (const std::string &key, const std::string &defaultValue) const
 Returns the value for a given key. More...
 
MSVehiclegetPartialBehind (const MSVehicle *ego) const
 
int getRightmostSublane () const
 
double getRightSideOnEdge () const
 
void initRestrictions ()
 initialized vClass-specific speed limits More...
 
bool isApproachedFrom (MSEdge *const edge)
 
bool isApproachedFrom (MSEdge *const edge, MSLane *const lane)
 
bool isEmpty () const
 
bool isInternal () const
 
bool isLinkEnd (MSLinkCont::const_iterator &i) const
 
bool isLinkEnd (MSLinkCont::iterator &i)
 
bool knowsParameter (const std::string &key) const
 Returns whether the parameter is known. More...
 
void leftByLaneChange (MSVehicle *v)
 
 MSLane (const std::string &id, double maxSpeed, double length, MSEdge *const edge, int numericalID, const PositionVector &shape, double width, SVCPermissions permissions, int index, bool isRampAccel)
 Constructor. More...
 
virtual MSVehicleremoveVehicle (MSVehicle *remVehicle, MSMoveReminder::Notification notification, bool notify=true)
 
void resetPermissions (long transientID)
 
void setID (const std::string &newID)
 resets the id More...
 
void setLength (double val)
 Sets a new length for the lane (used by TraCI only) More...
 
void setMaxSpeed (double val)
 Sets a new maximum speed for the lane (used by TraCI and MSCalibrator) More...
 
void setPermissions (SVCPermissions permissions, long transientID)
 Sets the permissions to the given value. If a transientID is given, the permissions are recored as temporary. More...
 
void setRightSideOnEdge (double value, int rightmostSublane)
 
void sortPartialVehicles ()
 sorts myPartialVehicles More...
 
void visit (const TraCIServerAPI_Lane::StoringVisitor &cont) const
 Callback for visiting the lane when traversing an RTree. More...
 
void writeParams (OutputDevice &out) const
 
virtual ~MSLane ()
 Destructor. More...
 
Additional initialisation
void addLink (MSLink *link)
 Delayed initialization. More...
 
void addNeigh (const std::string &id)
 Adds a neighbor to this lane. More...
 
interaction with MSMoveReminder
virtual void addMoveReminder (MSMoveReminder *rem)
 Add a move-reminder to move-reminder container. More...
 
const std::vector< MSMoveReminder *> & getMoveReminders () const
 Return the list of this lane's move reminders. More...
 
Vehicle insertion
bool insertVehicle (MSVehicle &v)
 Tries to insert the given vehicle. More...
 
bool isInsertionSuccess (MSVehicle *vehicle, double speed, double pos, double posLat, bool recheckNextLanes, MSMoveReminder::Notification notification)
 Tries to insert the given vehicle with the given state (speed and pos) More...
 
bool checkFailure (MSVehicle *aVehicle, double &speed, double &dist, const double nspeed, const bool patchSpeed, const std::string errorMsg) const
 
bool lastInsertion (MSVehicle &veh, double mspeed, bool patchSpeed)
 inserts vehicle as close as possible to the last vehicle on this lane (or at the end of the lane if there is no leader) More...
 
bool freeInsertion (MSVehicle &veh, double speed, MSMoveReminder::Notification notification=MSMoveReminder::NOTIFICATION_DEPARTED)
 Tries to insert the given vehicle on any place. More...
 
void forceVehicleInsertion (MSVehicle *veh, double pos, MSMoveReminder::Notification notification, double posLat=0)
 Inserts the given vehicle at the given position. More...
 
Handling vehicles lapping into lanes
virtual double setPartialOccupation (MSVehicle *v)
 Sets the information about a vehicle lapping into this lane. More...
 
virtual void resetPartialOccupation (MSVehicle *v)
 Removes the information about a vehicle lapping into this lane. More...
 
const MSLeaderInfogetLastVehicleInformation (const MSVehicle *ego, double latOffset, double minPos=0, bool allowCached=true) const
 Returns the last vehicles on the lane. More...
 
const MSLeaderInfogetFirstVehicleInformation (const MSVehicle *ego, double latOffset, bool onlyFrontOnLane, double maxPos=std::numeric_limits< double >::max(), bool allowCached=true) const
 analogue to getLastVehicleInformation but in the upstream direction More...
 
Access to vehicles
int getVehicleNumber () const
 Returns the number of vehicles on this lane (for which this lane is responsible) More...
 
int getVehicleNumberWithPartials () const
 Returns the number of vehicles on this lane (including partial occupators) More...
 
int getPartialVehicleNumber () const
 Returns the number of vehicles partially on this lane (for which this lane is not responsible) More...
 
virtual const VehContgetVehiclesSecure () const
 Returns the vehicles container; locks it for microsimulation. More...
 
AnyVehicleIterator anyVehiclesBegin () const
 begin iterator for iterating over all vehicles touching this lane in downstream direction More...
 
AnyVehicleIterator anyVehiclesEnd () const
 end iterator for iterating over all vehicles touching this lane in downstream direction More...
 
AnyVehicleIterator anyVehiclesUpstreamBegin () const
 begin iterator for iterating over all vehicles touching this lane in upstream direction More...
 
AnyVehicleIterator anyVehiclesUpstreamEnd () const
 end iterator for iterating over all vehicles touching this lane in upstream direction More...
 
virtual void releaseVehicles () const
 Allows to use the container for microsimulation again. More...
 
Atomar value getter
int getNumericalID () const
 Returns this lane's numerical id. More...
 
const PositionVectorgetShape () const
 Returns this lane's shape. More...
 
double getLengthGeometryFactor () const
 return shape.length() / myLength More...
 
bool isAccelLane () const
 return whether this lane is an acceleration lane More...
 
double interpolateLanePosToGeometryPos (double lanePos) const
 
const Position geometryPositionAtOffset (double offset, double lateralOffset=0) const
 
double interpolateGeometryPosToLanePos (double geometryPos) const
 
double getVehicleMaxSpeed (const SUMOVehicle *const veh) const
 Returns the lane's maximum speed, given a vehicle's speed limit adaptation. More...
 
double getSpeedLimit () const
 Returns the lane's maximum allowed speed. More...
 
double getLength () const
 Returns the lane's length. More...
 
SVCPermissions getPermissions () const
 Returns the vehicle class permissions for this lane. More...
 
double getWidth () const
 Returns the lane's width. More...
 
int getIndex () const
 Returns the lane's index. More...
 
Vehicle movement (longitudinal)
virtual void planMovements (const SUMOTime t)
 Compute safe velocities for all vehicles based on positions and speeds from the last time step. Also registers ApproachingVehicleInformation for all links. More...
 
virtual bool executeMovements (SUMOTime t, std::vector< MSLane *> &lanesWithVehiclesToIntegrate)
 Executes planned vehicle movements with regards to right-of-way. More...
 
virtual bool integrateNewVehicle (SUMOTime t)
 Insert buffered vehicle into the real lane. More...
 
Current state retrieval
double getMeanSpeed () const
 Returns the mean speed on this lane. More...
 
double getWaitingSeconds () const
 Returns the overall waiting time on this lane. More...
 
double getBruttoOccupancy () const
 Returns the brutto (including minGaps) occupancy of this lane during the last step. More...
 
double getNettoOccupancy () const
 Returns the netto (excluding minGaps) occupancy of this lane during the last step (including minGaps) More...
 
double getBruttoVehLenSum () const
 Returns the sum of lengths of vehicles, including their minGaps, which were on the lane during the last step. More...
 
double getCO2Emissions () const
 Returns the sum of last step CO2 emissions. More...
 
double getCOEmissions () const
 Returns the sum of last step CO emissions. More...
 
double getPMxEmissions () const
 Returns the sum of last step PMx emissions. More...
 
double getNOxEmissions () const
 Returns the sum of last step NOx emissions. More...
 
double getHCEmissions () const
 Returns the sum of last step HC emissions. More...
 
double getFuelConsumption () const
 Returns the sum of last step fuel consumption. More...
 
double getElectricityConsumption () const
 Returns the sum of last step electricity consumption. More...
 
double getHarmonoise_NoiseEmissions () const
 Returns the sum of last step noise emissions. More...
 
State saving/loading
void saveState (OutputDevice &out)
 Saves the state of this lane into the given stream. More...
 
void loadState (std::vector< std::string > &vehIDs, MSVehicleControl &vc)
 Loads the state of this segment with the given parameters. More...
 

Static Public Member Functions

static void clear ()
 Clears the dictionary. More...
 
static bool dictionary (const std::string &id, MSLane *lane)
 Static (sic!) container methods {. More...
 
static MSLanedictionary (const std::string &id)
 Returns the MSLane associated to the key id. More...
 
static int dictSize ()
 Returns the number of stored lanes. More...
 
template<class RTREE >
static void fill (RTREE &into)
 Fills the given RTree with lane instances. More...
 
static CollisionAction getCollisionAction ()
 
template<class T >
static std::string getIDSecure (const T *obj, const std::string &fallBack="NULL")
 get an identifier for Named-like object which may be Null More...
 
static void initCollisionOptions (const OptionsCont &oc)
 
static void insertIDs (std::vector< std::string > &into)
 Adds the ids of all stored lanes into the given vector. More...
 
static MSLinkCont::const_iterator succLinkSec (const SUMOVehicle &veh, int nRouteSuccs, const MSLane &succLinkSource, const std::vector< MSLane *> &conts)
 
static bool teleportOnCollision ()
 

Static Public Attributes

static const long CHANGE_PERMISSIONS_GUI = 1
 
static const long CHANGE_PERMISSIONS_PERMANENT = 0
 

Protected Types

typedef std::map< std::string, MSLane *> DictType
 definition of the static dictionary type More...
 

Protected Member Functions

double basePos (const MSVehicle &veh) const
 departure position where the vehicle fits fully onto the lane (if possible) More...
 
bool detectCollisionBetween (SUMOTime timestep, const std::string &stage, MSVehicle *collider, MSVehicle *victim, std::set< const MSVehicle *, SUMOVehicle::ComparatorIdLess > &toRemove, std::set< const MSVehicle *> &toTeleport) const
 detect whether there is a collision between the two vehicles More...
 
double getDepartSpeed (const MSVehicle &veh, bool &patchSpeed)
 
double getMaximumBrakeDist () const
 compute maximum braking distance on this lane More...
 
void handleCollisionBetween (SUMOTime timestep, const std::string &stage, MSVehicle *collider, MSVehicle *victim, double gap, double latGap, std::set< const MSVehicle *, SUMOVehicle::ComparatorIdLess > &toRemove, std::set< const MSVehicle *> &toTeleport) const
 take action upon collision More...
 
virtual void incorporateVehicle (MSVehicle *veh, double pos, double speed, double posLat, const MSLane::VehCont::iterator &at, MSMoveReminder::Notification notification=MSMoveReminder::NOTIFICATION_DEPARTED)
 Inserts the vehicle into this lane, and informs it about entering the network. More...
 
double safeInsertionSpeed (const MSVehicle *veh, const MSLeaderInfo &leaders, double speed)
 return the maximum safe speed for insertion behind leaders (a negative value indicates that safe insertion is impossible) More...
 
virtual void swapAfterLaneChange (SUMOTime t)
 moves myTmpVehicles int myVehicles after a lane change procedure More...
 

Protected Attributes

std::map< MSEdge *, std::vector< MSLane * > > myApproachingLanes
 All direct internal and direct (disregarding internal predecessors) non-internal predecessor lanes of this lane. More...
 
double myBruttoVehicleLengthSum
 The current length of all vehicles on this lane, including their minGaps. More...
 
MSLanemyCanonicalPredecessorLane
 Similar to LogicalPredecessorLane,. More...
 
MSLanemyCanonicalSuccessorLane
 Main successor lane,. More...
 
MSEdge *const myEdge
 The lane's edge, for routing only. More...
 
MSLeaderInfo myFollowerInfo
 followers on all sublanes as seen by vehicles on consecutive lanes (cached) More...
 
SUMOTime myFollowerInfoTime
 time step for which myFollowerInfo was last updated More...
 
std::string myID
 The name of the object. More...
 
std::vector< IncomingLaneInfomyIncomingLanes
 All direct predecessor lanes. More...
 
int myIndex
 The lane index. More...
 
const bool myIsRampAccel
 whether this lane is an acceleration lane More...
 
MSLeaderInfo myLeaderInfo
 leaders on all sublanes as seen by approaching vehicles (cached) More...
 
SUMOTime myLeaderInfoTime
 time step for which myLeaderInfo was last updated More...
 
MSLeaderInfo myLeaderInfoTmp
 
double myLength
 Lane length [m]. More...
 
const double myLengthGeometryFactor
 precomputed myShape.length / myLength More...
 
MSLinkCont myLinks
 
MSLanemyLogicalPredecessorLane
 
double myMaxSpeed
 Lane-wide speedlimit [m/s]. More...
 
std::vector< std::string > myNeighs
 
double myNettoVehicleLengthSum
 The current length of all vehicles on this lane, excluding their minGaps. More...
 
int myNumericalID
 Unique numerical ID (set on reading by netload) More...
 
SVCPermissions myOriginalPermissions
 The original vClass permissions for this lane (before temporary modifications) More...
 
VehCont myPartialVehicles
 The lane's partial vehicles. This container holds all vehicles that are partially on this lane but which are in myVehicles of another lane. Reasons for partial occupancie include the following. More...
 
std::map< long, SVCPermissionsmyPermissionChanges
 
SVCPermissions myPermissions
 The vClass permissions for this lane. More...
 
const std::map< SUMOVehicleClass, double > * myRestrictions
 The vClass speed restrictions for this lane. More...
 
int myRightmostSublane
 the index of the rightmost sublane of this lane on myEdge More...
 
double myRightSideOnEdge
 the combined width of all lanes with lower index on myEdge More...
 
PositionVector myShape
 The shape of the lane. More...
 
VehCont myTmpVehicles
 Container for lane-changing vehicles. After completion of lane-change- process, the containers will be swapped with myVehicles. More...
 
VehCont myVehBuffer
 Buffer for vehicles that moved from their previous lane onto this one. Integrated after all vehicles executed their moves. More...
 
VehCont myVehicles
 The lane's vehicles. This container holds all vehicles that have their front (longitudinally) and their center (laterally) on this lane. These are the vehicles that this lane is 'responsibly' for (i.e. when executing movements) More...
 
const double myWidth
 Lane width [m]. More...
 

Static Protected Attributes

static DictType myDict
 Static dictionary to associate string-ids with objects. More...
 

Private Member Functions

 MSLane (const MSLane &)
 invalidated copy constructor More...
 
MSLaneoperator= (const MSLane &)
 invalidated assignment operator More...
 

Private Attributes

std::vector< MSMoveReminder *> myMoveReminders
 This lane's move reminder. More...
 

Static Private Attributes

static bool myCheckJunctionCollisions
 
static CollisionAction myCollisionAction
 the action to take on collisions More...
 
static SUMOTime myCollisionStopTime
 

Friends

class AnyVehicleIterator
 
class MSLaneChanger
 needs access to myTmpVehicles (this maybe should be done via double-buffering!!!) More...
 
class MSLaneChangerSublane
 
class MSQueueExport
 
class MSXMLRawOut
 

Detailed Description

Representation of a lane in the micro simulation.

Class which represents a single lane. Somekind of the main class of the simulation. Allows moving vehicles.

Definition at line 79 of file MSLane.h.

Member Typedef Documentation

◆ DictType

typedef std::map< std::string, MSLane* > MSLane::DictType
protected

definition of the static dictionary type

Definition at line 1189 of file MSLane.h.

◆ VehCont

typedef std::vector<MSVehicle*> MSLane::VehCont

Container for vehicles.

Definition at line 91 of file MSLane.h.

Member Enumeration Documentation

◆ CollisionAction

Enumerator
COLLISION_ACTION_NONE 
COLLISION_ACTION_WARN 
COLLISION_ACTION_TELEPORT 
COLLISION_ACTION_REMOVE 

Definition at line 162 of file MSLane.h.

Constructor & Destructor Documentation

◆ MSLane() [1/2]

MSLane::MSLane ( const std::string &  id,
double  maxSpeed,
double  length,
MSEdge *const  edge,
int  numericalID,
const PositionVector shape,
double  width,
SVCPermissions  permissions,
int  index,
bool  isRampAccel 
)

Constructor.

Parameters
[in]idThe lane's id
[in]maxSpeedThe speed allowed on this lane
[in]lengthThe lane's length
[in]edgeThe edge this lane belongs to
[in]numericalIDThe numerical id of the lane
[in]shapeThe shape of the lane
[in]widthThe width of the lane
[in]permissionsEncoding of the Vehicle classes that may drive on this lane
[in]indexThe index of this lane within its parent edge
[in]isRampAccelWhether this lane is an acceleratin lane
See also
SUMOVehicleClass

Definition at line 161 of file MSLane.cpp.

References initRestrictions().

◆ ~MSLane()

MSLane::~MSLane ( )
virtual

Destructor.

Definition at line 187 of file MSLane.cpp.

References myLinks.

◆ MSLane() [2/2]

MSLane::MSLane ( const MSLane )
private

invalidated copy constructor

Member Function Documentation

◆ addApproachingLane()

void MSLane::addApproachingLane ( MSLane lane,
bool  warnMultiCon 
)

◆ addIncomingLane()

void MSLane::addIncomingLane ( MSLane lane,
MSLink viaLink 
)

◆ addLink()

void MSLane::addLink ( MSLink link)

Delayed initialization.

Not all lane-members are known at the time the lane is born, above all the pointers to other lanes, so we have to add them later.

Parameters
[in]linkAn outgoing link

Definition at line 201 of file MSLane.cpp.

References myLinks.

Referenced by NLHandler::addConnection().

◆ addMoveReminder()

void MSLane::addMoveReminder ( MSMoveReminder rem)
virtual

Add a move-reminder to move-reminder container.

The move reminder will not be deleted by the lane.

Parameters
[in]remThe move reminder to add

Definition at line 214 of file MSLane.cpp.

References myMoveReminders, and myVehicles.

Referenced by MSMoveReminder::MSMoveReminder().

◆ addNeigh()

void MSLane::addNeigh ( const std::string &  id)

Adds a neighbor to this lane.

Parameters
[in]idThe lane's id

Definition at line 207 of file MSLane.cpp.

References myNeighs.

◆ addParameter() [1/3]

◆ addParameter() [2/3]

void Parameterised::addParameter ( const std::map< std::string, std::string > &  mapArg)
inherited

Adds all given parameter.

Parameters
[in]mapArgThe keys/values to insert

Definition at line 57 of file Parameterised.cpp.

References Parameterised::myMap.

◆ addParameter() [3/3]

void Parameterised::addParameter ( const Parameterised p)
inherited

Adds all given parameter.

Parameters
[in]pThe keys/values to insert

Definition at line 65 of file Parameterised.cpp.

References Parameterised::myMap.

◆ addTo()

void Named::addTo ( const StoringVisitor cont) const
inlineinherited

Adds this object to the given container.

Parameters

Definition at line 129 of file Named.h.

References Named::StoringVisitor::add().

◆ allowsVehicleClass()

◆ anyVehiclesBegin()

AnyVehicleIterator MSLane::anyVehiclesBegin ( ) const
inline

begin iterator for iterating over all vehicles touching this lane in downstream direction

Definition at line 385 of file MSLane.h.

References AnyVehicleIterator, myPartialVehicles, and myVehicles.

Referenced by detectCollisions(), getFollowersOnConsecutive(), getLastVehicleInformation(), getLeader(), and MSLink::getLeaderInfo().

◆ anyVehiclesEnd()

AnyVehicleIterator MSLane::anyVehiclesEnd ( ) const
inline

end iterator for iterating over all vehicles touching this lane in downstream direction

Definition at line 390 of file MSLane.h.

References AnyVehicleIterator, myPartialVehicles, and myVehicles.

Referenced by detectCollisions(), getFollowersOnConsecutive(), getLeader(), and MSLink::getLeaderInfo().

◆ anyVehiclesUpstreamBegin()

AnyVehicleIterator MSLane::anyVehiclesUpstreamBegin ( ) const
inline

begin iterator for iterating over all vehicles touching this lane in upstream direction

Definition at line 395 of file MSLane.h.

References AnyVehicleIterator, myPartialVehicles, and myVehicles.

Referenced by getFirstVehicleInformation(), and getFollower().

◆ anyVehiclesUpstreamEnd()

AnyVehicleIterator MSLane::anyVehiclesUpstreamEnd ( ) const
inline

end iterator for iterating over all vehicles touching this lane in upstream direction

Definition at line 400 of file MSLane.h.

References AnyVehicleIterator.

Referenced by getFollower().

◆ appropriate()

bool MSLane::appropriate ( const MSVehicle veh)
virtual

Returns the information whether this lane may be used to continue the current route

Definition at line 1429 of file MSLane.cpp.

References MSEdge::EDGEFUNCTION_INTERNAL, MSVehicle::getBestLanes(), MSVehicle::getBestLanesContinuation(), MSVehicle::getLaneIndex(), MSEdge::getPurpose(), myEdge, myLinks, MSBaseVehicle::succEdge(), and succLinkSec().

Referenced by executeMovements(), and getIndex().

◆ basePos()

double MSLane::basePos ( const MSVehicle veh) const
protected

departure position where the vehicle fits fully onto the lane (if possible)

Definition at line 512 of file MSLane.cpp.

References MSVehicleType::getLength(), MSBaseVehicle::getVehicleType(), MIN2(), myLength, and POSITION_EPS.

Referenced by insertVehicle().

◆ checkFailure()

bool MSLane::checkFailure ( MSVehicle aVehicle,
double &  speed,
double &  dist,
const double  nspeed,
const bool  patchSpeed,
const std::string  errorMsg 
) const

◆ clear()

void MSLane::clear ( )
static

Clears the dictionary.

Definition at line 1394 of file MSLane.cpp.

References myDict.

Referenced by MSNet::clearAll(), and getEdge().

◆ clearParameter()

void Parameterised::clearParameter ( )
inherited

Clears the parameter map.

Definition at line 99 of file Parameterised.cpp.

References Parameterised::myMap.

◆ detectCollisionBetween()

◆ detectCollisions()

◆ dictionary() [1/2]

bool MSLane::dictionary ( const std::string &  id,
MSLane lane 
)
static

◆ dictionary() [2/2]

MSLane * MSLane::dictionary ( const std::string &  id)
static

Returns the MSLane associated to the key id.

The lane is returned if exists, otherwise 0 is returned.

Parameters
[in]idThe id of the lane
Returns
The lane

Definition at line 1383 of file MSLane.cpp.

References myDict.

◆ dictSize()

static int MSLane::dictSize ( )
inlinestatic

◆ empty()

bool MSLane::empty ( ) const
inline

Returns true if there is not a single vehicle on the lane.

Definition at line 564 of file MSLane.h.

References myVehBuffer, myVehicles, setLength(), and setMaxSpeed().

Referenced by MSQueueExport::writeLane().

◆ enteredByLaneChange()

◆ executeMovements()

bool MSLane::executeMovements ( SUMOTime  t,
std::vector< MSLane *> &  lanesWithVehiclesToIntegrate 
)
virtual

Executes planned vehicle movements with regards to right-of-way.

This method goes through all vehicles calling their executeMove method which causes vehicles to update their positions and speeds. Vehicles wich move to the next lane are stored in the targets lane buffer

See also
MSVehicle::executeMove

Reimplemented in GUILane.

Definition at line 1262 of file MSLane.cpp.

References MSVehicleTransfer::add(), appropriate(), COLLISION_ACTION_REMOVE, COLLISION_ACTION_TELEPORT, MSVehicle::collisionStopTime(), MSVehicle::executeMove(), MSVehicle::getBestLanesContinuation(), getCollisionAction(), getEdge(), Named::getID(), MSBaseVehicle::getID(), MSNet::getInstance(), MSVehicleTransfer::getInstance(), MSVehicle::getLane(), MSVehicleType::getLength(), getLength(), MSVehicleType::getLengthWithGap(), MSVehicle::getPositionOnLane(), getSpeedLimit(), MSNet::getVehicleControl(), MSBaseVehicle::getVehicleType(), MSVehicle::getWaitingTime(), MSGlobals::gLateralResolution, MSGlobals::gTimeToGridlock, MSGlobals::gTimeToGridlockHighways, MSVehicle::hasArrived(), MSVehicle::isParking(), MSVehicle::isStopped(), MSEdge::isVaporizing(), myBruttoVehicleLengthSum, myLinks, myNettoVehicleLengthSum, myVehBuffer, myVehicles, MSMoveReminder::NOTIFICATION_ARRIVED, MSMoveReminder::NOTIFICATION_VAPORIZED, MSVehicle::onRemovalFromNet(), MSVehicleControl::registerCollision(), MSVehicleControl::registerTeleportJam(), MSVehicleControl::registerTeleportWrongLane(), MSVehicleControl::registerTeleportYield(), MSVehicle::resumeFromStopping(), MSVehicleControl::scheduleVehicleRemoval(), succLinkSec(), time2string(), and WRITE_WARNING.

Referenced by GUILane::executeMovements(), and getIndex().

◆ fill()

template<class RTREE >
template void MSLane::fill< LANE_RTREE_QUAL > ( RTREE &  into)
static

◆ forceVehicleInsertion()

void MSLane::forceVehicleInsertion ( MSVehicle veh,
double  pos,
MSMoveReminder::Notification  notification,
double  posLat = 0 
)

Inserts the given vehicle at the given position.

No checks are done, vehicle insertion using this method may generate collisions (possibly delayed).

Parameters
[in]vehThe vehicle to insert
[in]posThe position at which the vehicle shall be inserted
[in]notificationThe cause of insertion (i.e. departure, teleport, parking) defaults to departure
[in]posLatThe lateral position at which the vehicle shall be inserted

Definition at line 831 of file MSLane.cpp.

References getDepartSpeed(), MSVehicle::getSpeed(), MSBaseVehicle::hasDeparted(), incorporateVehicle(), myVehicles, and MSVehicle::updateBestLanes().

Referenced by MSLaneChanger::changeOpposite(), getMoveReminders(), MSVehicle::Influencer::postProcessVTD(), and TraCIServerAPI_Vehicle::processSet().

◆ freeInsertion()

bool MSLane::freeInsertion ( MSVehicle veh,
double  speed,
MSMoveReminder::Notification  notification = MSMoveReminder::NOTIFICATION_DEPARTED 
)

Tries to insert the given vehicle on any place.

Parameters
[in]vehThe vehicle to insert
[in]speedThe maximum insertion speed
[in]notificationThe cause of insertion (i.e. departure, teleport, parking) defaults to departure
Returns
Whether the vehicle could be inserted

Definition at line 313 of file MSLane.cpp.

References MSVehicle::getBackPositionOnLane(), MSVehicle::getCarFollowModel(), getFirstFullVehicle(), MSVehicleType::getLength(), getLength(), MSCFModel::getMaxDecel(), MSVehicleType::getMinGap(), getMissingRearGap(), MSVehicle::getPositionOnLane(), MSCFModel::getSecureGap(), MSVehicle::getSpeed(), MSBaseVehicle::getVehicleType(), MSCFModel::insertionFollowSpeed(), isInsertionSuccess(), MIN2(), myLength, myPartialVehicles, myVehicles, MSMoveReminder::NOTIFICATION_TELEPORT, POSITION_EPS, and MSVehicle::setTentativeLaneAndPosition().

Referenced by MSVehicleTransfer::checkInsertions(), getMoveReminders(), and insertVehicle().

◆ geometryPositionAtOffset()

◆ getBruttoOccupancy()

double MSLane::getBruttoOccupancy ( ) const

◆ getBruttoVehLenSum()

double MSLane::getBruttoVehLenSum ( ) const
inline

Returns the sum of lengths of vehicles, including their minGaps, which were on the lane during the last step.

Returns
The sum of vehicle lengths of vehicles in the last step

Definition at line 863 of file MSLane.h.

References getCO2Emissions(), getCOEmissions(), getElectricityConsumption(), getFuelConsumption(), getHarmonoise_NoiseEmissions(), getHCEmissions(), getNOxEmissions(), getPMxEmissions(), and myBruttoVehicleLengthSum.

Referenced by MSVehicle::checkRewindLinkLanes().

◆ getCanonicalPredecessorLane()

MSLane * MSLane::getCanonicalPredecessorLane ( ) const

Return the main predecessor lane for the current. If there are several incoming lanes, the first attempt is to return the priorized. If this does not yield an unambiguous lane, the one with the least angle difference to the current is selected.

Definition at line 2018 of file MSLane.cpp.

References myCanonicalPredecessorLane, Named::myID, and myIncomingLanes.

Referenced by getEntryLink(), getIncomingLanes(), and MSE2Collector::selectLanes().

◆ getCanonicalSuccessorLane()

MSLane * MSLane::getCanonicalSuccessorLane ( ) const

Return the main successor lane for the current. If there are several outgoing lanes, the first attempt is to return the priorized. If this does not yield an unambiguous lane, the one with the least angle difference to the current is selected.

Definition at line 2038 of file MSLane.cpp.

References myCanonicalSuccessorLane, Named::myID, and myLinks.

Referenced by getIncomingLanes(), and MSE2Collector::selectLanes().

◆ getCenterOnEdge()

◆ getCO2Emissions()

double MSLane::getCO2Emissions ( ) const

Returns the sum of last step CO2 emissions.

Returns
CO2 emissions of vehicles on this lane during the last step

Definition at line 2165 of file MSLane.cpp.

References getVehiclesSecure(), and releaseVehicles().

Referenced by getBruttoVehLenSum(), TraCI_Lane::getCO2Emission(), GUILane::getColorValue(), GUILane::getScaleValue(), and MSFullExport::writeLane().

◆ getCOEmissions()

double MSLane::getCOEmissions ( ) const

Returns the sum of last step CO emissions.

Returns
CO emissions of vehicles on this lane during the last step

Definition at line 2177 of file MSLane.cpp.

References getVehiclesSecure(), and releaseVehicles().

Referenced by getBruttoVehLenSum(), TraCI_Lane::getCOEmission(), GUILane::getColorValue(), GUILane::getScaleValue(), and MSFullExport::writeLane().

◆ getCollisionAction()

static CollisionAction MSLane::getCollisionAction ( )
inlinestatic

Definition at line 1015 of file MSLane.h.

References myCollisionAction.

Referenced by executeMovements(), and MSVehicle::resumeFromStopping().

◆ getCriticalLeader()

std::pair< MSVehicle *const, double > MSLane::getCriticalLeader ( double  dist,
double  seen,
double  speed,
const MSVehicle veh 
) const

Returns the most dangerous leader and the distance to him.

Goes along the vehicle's estimated used lanes (bestLaneConts). For each link, it is determined whether the ego vehicle will pass it. If so, the subsequent lane is investigated. Check all lanes up to the stopping distance of ego. Return the leader vehicle (and the gap) which puts the biggest speed constraint on ego.

If no leading vehicle was found, <0, -1> is returned.

Pretty slow, as it has to go along lanes.

Parameters
[in]distThe distance to investigate
[in]seenThe already seen place (normally the place in front on own lane)
[in]speedThe speed of the vehicle used for determining whether a subsequent link will be opened at arrival time
[in]vehThe (ego) vehicle for which the information shall be computed
Returns

Definition at line 1916 of file MSLane.cpp.

References MSCFModel::brakeGap(), MSVehicle::getBackPositionOnLane(), MSVehicle::getBestLanesContinuation(), MSVehicle::getCarFollowModel(), MSNet::getCurrentTimeStep(), MSBaseVehicle::getImpatience(), MSNet::getInstance(), getLastAnyVehicle(), MSVehicle::getLateralPositionOnLane(), MSVehicleType::getLength(), getLength(), MSCFModel::getMaxDecel(), MSVehicleType::getMinGap(), MSVehicle::getSafeFollowSpeed(), MSVehicle::getSpeed(), getVehicleMaxSpeed(), MSBaseVehicle::getVehicleType(), MSCFModel::insertionFollowSpeed(), isLinkEnd(), max, MAX2(), NUMERICAL_EPS, succLinkSec(), and TIME2STEPS.

Referenced by MSLaneChanger::checkChange(), and getIncomingLanes().

◆ getCrossingIndex()

int MSLane::getCrossingIndex ( ) const

return the index of the link to the next crossing if this is walkingArea, else -1

Definition at line 2095 of file MSLane.cpp.

References myLinks.

Referenced by getIndex().

◆ getDepartSpeed()

◆ getDouble()

double Parameterised::getDouble ( const std::string &  key,
const double  defaultValue 
) const
inherited

Returns the value for a given key converted to a double.

Parameters
[in]keyThe key to ask for
[in]defaultValueThe default value to return if no value is stored under the key
Returns
The value stored under the key

Definition at line 89 of file Parameterised.cpp.

References TplConvert::_2double(), and Parameterised::myMap.

Referenced by MSDevice_Battery::buildVehicleDevices().

◆ getEdge()

MSEdge& MSLane::getEdge ( ) const
inline

Returns the lane's edge.

Returns
This lane's edge

Definition at line 582 of file MSLane.h.

References clear(), dictionary(), getNextNormal(), and myEdge.

Referenced by MSLCM_LC2013::_patchSpeed(), MSLCM_LC2013::_wantsChange(), MSLCM_SL2015::_wantsChangeSublane(), TraCIServerAPI_Lane::StoringVisitor::add(), addApproachingLane(), MSRouteHandler::addStop(), MSVehicle::addStop(), MSEdge::allowedLanes(), MSSwarmTrafficLightLogic::allowLine(), MSSOTLE2Sensors::buildSensorForLane(), MSLaneChanger::changeOpposite(), MSLCM_SL2015::checkBlocking(), MSLaneChanger::checkChange(), MSVehicle::checkRewindLinkLanes(), MSEdge::closeBuilding(), GUILane::closeTraffic(), MSDevice_Tripinfo::computeLengthAndDuration(), GUIDetectorBuilder::createInductLoop(), NLDetectorBuilder::createInductLoop(), MSLCM_LC2013::distanceAlongNextRoundabout(), GUILane::drawLinkNo(), GUILane::drawLinkRules(), GUILane::drawTLSLinkNo(), MSVehicle::enterLaneAtMove(), MSVehicle::executeMove(), executeMovements(), MSDevice_SSM::findFoeConflictLane(), MSDevice_SSM::findSurroundingVehicles(), MSVehicle::getBestLanesContinuation(), MSVehicle::getCenterOnEdge(), TraCI_Vehicle::getDistance(), MSVehicle::getDistanceToPosition(), MSTransportable::Stage_Driving::getEdge(), TraCI_Lane::getEdgeID(), MSLinkContHelper::getInternalFollowingEdge(), MSEdge::getInternalFollowingEdge(), MSVehicle::getLaneIndex(), MSVehicle::getLatOffset(), getLogicalPredecessorLane(), MSPModel_Striping::PState::getNextEdge(), MSPModel_Striping::getNextLane(), MSPModel_Striping::getNextLaneObstacles(), TraCI_Vehicle::getNextTLS(), MSVehicle::getPosition(), TraCI_Vehicle::getRoadID(), MSLCM_LC2013::getRoundaboutAheadInfo(), MSAbstractLaneChangeModel::getShadowDirection(), MSStoppingPlace::hasAccess(), MSVehicle::Influencer::implicitDeltaPosVTD(), MSVehicle::Influencer::implicitSpeedVTD(), MSVehicle::influenceChangeDecision(), MSRailSignal::init(), MSLink::isExitLink(), isInsertionSuccess(), MSJunction::isLeader(), MSLCM_SL2015::keepLatGap(), MSLink::lastWasContMajor(), MESegment::limitedControlOverride(), MSPedestrianPushButton::loadPushButtons(), MSPModel_Striping::moveInDirection(), MSPModel_Striping::moveInDirectionOnLane(), MSPModel_Striping::PState::moveToNextLane(), MSTriggeredRerouter::notifyEnter(), MSDevice_SSM::notifyEnter(), MSDevice_SSM::notifyLeave(), GUIViewTraffic::onCmdAddRerouter(), GUIViewTraffic::onCmdCloseEdge(), MSLane::outgoing_lane_priority_sorter::operator()(), MSLane::edge_finder::operator()(), NLTriggerBuilder::parseAndBuildCalibrator(), MSRouteHandler::parseWalkPositions(), MSLCM_DK2008::patchSpeed(), MSVehicle::planMoveInternal(), MSInternalJunction::postloadInit(), MSLCM_SL2015::prepareStep(), MSContainer::MSContainerStage_Driving::proceed(), MSPerson::MSPersonStage_Driving::proceed(), MSVehicle::processNextStop(), TraCIServerAPI_Vehicle::processSet(), MSPModel_Striping::PState::PState(), MSVehicle::replaceRoute(), MSTriggeredRerouter::rerouteParkingZone(), MSVehicle::resumeFromStopping(), TraCI_Lane::setAllowed(), TraCI_Lane::setDisallowed(), MSLink::setRequestInformation(), MSAbstractLaneChangeModel::startLaneChangeManeuver(), MSVehicle::unsafeLinkAhead(), MSVehicle::updateBestLanes(), MSDevice_SSM::updateEncounter(), MSLCM_SL2015::updateExpectedSublaneSpeeds(), TraCIServerAPI_Vehicle::vtdMap(), MSPModel_Striping::PState::walk(), MSLCM_DK2008::wantsChangeToLeft(), MSLCM_DK2008::wantsChangeToRight(), and MSFCDExport::write().

◆ getElectricityConsumption()

double MSLane::getElectricityConsumption ( ) const

Returns the sum of last step electricity consumption.

Returns
electricity consumption of vehicles on this lane during the last step

Definition at line 2237 of file MSLane.cpp.

References getVehiclesSecure(), and releaseVehicles().

Referenced by getBruttoVehLenSum(), GUILane::getColorValue(), TraCI_Lane::getElectricityConsumption(), GUILane::getScaleValue(), and MSFullExport::writeLane().

◆ getEntryLink()

MSLink * MSLane::getEntryLink ( ) const

Returns the entry link if this is an internal lane, else 0.

Definition at line 1625 of file MSLane.cpp.

References getCanonicalPredecessorLane(), getLinkTo(), and isInternal().

Referenced by getIndex(), and MSDevice_SSM::updateEncounter().

◆ getFirstAnyVehicle()

MSVehicle * MSLane::getFirstAnyVehicle ( ) const

returns the first vehicle that is fully or partially on this lane

Definition at line 1534 of file MSLane.cpp.

References MSVehicle::getPositionOnLane(), myPartialVehicles, and myVehicles.

Referenced by dictSize().

◆ getFirstFullVehicle()

MSVehicle * MSLane::getFirstFullVehicle ( ) const

returns the first vehicle for which this lane is responsible or 0

Definition at line 1511 of file MSLane.cpp.

References myVehicles.

Referenced by dictSize(), and freeInsertion().

◆ getFirstVehicleInformation()

const MSLeaderInfo & MSLane::getFirstVehicleInformation ( const MSVehicle ego,
double  latOffset,
bool  onlyFrontOnLane,
double  maxPos = std::numeric_limits<double>::max(),
bool  allowCached = true 
) const

◆ getFollower()

std::pair< MSVehicle *const, double > MSLane::getFollower ( const MSVehicle ego,
double  egoPos,
double  dist,
bool  ignoreMinorLinks 
) const

Find follower vehicle for the given ego vehicle (which may be on the opposite direction lane)

Parameters
[in]egoThe ego vehicle
[in]egoPosThe ego position mapped to the current lane
[in]distThe look-back distance when looking at consecutive lanes
[in]ignoreMinorLinksWhether backward search should stop at minor links
Returns
the follower vehicle and it's gap to ego

Definition at line 2725 of file MSLane.cpp.

References anyVehiclesUpstreamBegin(), anyVehiclesUpstreamEnd(), DEBUG_COND2, getFollowersOnConsecutive(), Named::getID(), MSBaseVehicle::getID(), MSVehicleType::getLength(), MSVehicle::getPositionOnLane(), and MSBaseVehicle::getVehicleType().

Referenced by getCenterOnEdge(), getOppositeFollower(), and getOppositeLeader().

◆ getFollowersOnConsecutive()

MSLeaderDistanceInfo MSLane::getFollowersOnConsecutive ( const MSVehicle ego,
double  backOffset,
bool  allSublanes,
double  searchDist = -1,
bool  ignoreMinorLinks = false 
) const

◆ getFuelConsumption()

double MSLane::getFuelConsumption ( ) const

Returns the sum of last step fuel consumption.

Returns
fuel consumption of vehicles on this lane during the last step

Definition at line 2225 of file MSLane.cpp.

References getVehiclesSecure(), and releaseVehicles().

Referenced by getBruttoVehLenSum(), GUILane::getColorValue(), TraCI_Lane::getFuelConsumption(), GUILane::getScaleValue(), and MSFullExport::writeLane().

◆ getHarmonoise_NoiseEmissions()

double MSLane::getHarmonoise_NoiseEmissions ( ) const

Returns the sum of last step noise emissions.

Returns
noise emissions of vehicles on this lane during the last step

Definition at line 2249 of file MSLane.cpp.

References getVehiclesSecure(), releaseVehicles(), and HelpersHarmonoise::sum().

Referenced by getBruttoVehLenSum(), GUILane::getColorValue(), TraCI_Lane::getNoiseEmission(), GUILane::getScaleValue(), and MSFullExport::writeLane().

◆ getHCEmissions()

double MSLane::getHCEmissions ( ) const

Returns the sum of last step HC emissions.

Returns
HC emissions of vehicles on this lane during the last step

Definition at line 2213 of file MSLane.cpp.

References getVehiclesSecure(), and releaseVehicles().

Referenced by getBruttoVehLenSum(), GUILane::getColorValue(), TraCI_Lane::getHCEmission(), GUILane::getScaleValue(), and MSFullExport::writeLane().

◆ getID()

const std::string& Named::getID ( ) const
inlineinherited

Returns the id.

Returns
The stored id

Definition at line 66 of file Named.h.

References Named::myID.

Referenced by NIImporter_SUMO::_loadNetwork(), MSVehicle::adaptToLeader(), MSVehicle::adaptToLeaders(), PCPolyContainer::add(), MSVehicleTransfer::add(), TraCIServerAPI_Lane::StoringVisitor::add(), MSDetectorControl::add(), Named::StoringVisitor::add(), ShapeContainer::add(), IntermodalRouter< E, L, N, V >::addAccess(), NLTriggerBuilder::addAccess(), RORouteDef::addAlternative(), addApproachingLane(), MSNet::addBusStop(), MSNet::addChargingStation(), NBLoadedSUMOTLDef::addConnection(), NLHandler::addConnection(), MSNet::addContainerStop(), NIXMLConnectionsHandler::addCrossing(), RODFDetectorCon::addDetector(), RONet::addEdge(), ROJTREdge::addFollowerProbability(), MSTLLogicControl::TLSLogicVariants::addLogic(), RONet::addNode(), MSNet::addParkingArea(), NIImporter_SUMO::addPhase(), GUIEdge::addRerouter(), NBEdge::addRestrictedLane(), RONet::addRouteDef(), NBDistrict::addSink(), NBDistrict::addSource(), NIXMLEdgesHandler::addSplit(), NBTrafficLightLogic::addStep(), MSRouteHandler::addStop(), ROVehicle::addStop(), MSVehicle::addStop(), NBEdge::addStraightConnections(), NIXMLTrafficLightsHandler::addTlConnection(), NIVissimDisturbance::addToNode(), MSVehicle::addTraciStop(), MSVehicle::addTraciStopAtStoppingPlace(), AGActivityTripWriter::addTrip(), GUITrafficLightLogicWrapper::begin2TrackPhases(), MSTransportable::Stage_Waiting::beginEventOutput(), MSTransportable::Stage_Driving::beginEventOutput(), NLEdgeControlBuilder::build(), NIVisumTL::build(), RODFNet::buildApproachList(), MSSOTLE2Sensors::buildContinueSensior(), MSSOTLE2Sensors::buildCountSensorForLane(), MSSOTLE2Sensors::buildCountSensorForOutLane(), NBNode::buildCrossings(), NBNode::buildCrossingsAndWalkingAreas(), NIImporter_VISUM::buildDistrictNode(), NLDetectorBuilder::buildE2Detector(), NIVissimConnection::buildEdgeConnections(), RODFNet::buildEdgeFlowMap(), GNETLSEditorFrame::buildIinternalLanes(), NBEdge::buildInnerEdges(), NGEdge::buildNBEdge(), NIVissimEdge::buildNBEdge(), NBRampsComputer::buildOffRamp(), NBRampsComputer::buildOnRamp(), MELoop::buildSegmentsFor(), MSSOTLE2Sensors::buildSensorForLane(), MSSOTLE2Sensors::buildSensorForOutLane(), NBNode::buildWalkingAreas(), MSBaseVehicle::calculateArrivalParams(), MSSwarmTrafficLightLogic::calculateEtaDiff(), MSSwarmTrafficLightLogic::calculateEtaRatio(), MSSOTLPolicyBasedTrafficLightLogic::canRelease(), MSLaneChanger::changeOpposite(), MELoop::changeSegment(), MSSimpleTrafficLightLogic::changeStepAndDuration(), NBEdge::checkGeometry(), NBEdgeCont::checkGrade(), MSVehicleTransfer::checkInsertions(), NBEdgeCont::checkOverlap(), MSDevice_Battery::checkParam(), MSE2Collector::checkPositioning(), MSVehicle::checkRewindLinkLanes(), MSSwarmTrafficLightLogic::choosePolicy(), ODDistrictHandler::closeDistrict(), NLHandler::closeEdge(), RORouteHandler::closeRouteDistribution(), RORouteHandler::closeVehicle(), NBTrafficLightDefinition::collectAllLinks(), NBLoadedSUMOTLDef::collectEdges(), NBTrafficLightDefinition::collectEdges(), NBLoadedSUMOTLDef::collectEdgeVectors(), NBLoadedTLDef::collectLinks(), ROJTRRouter::compute(), NBTrafficLightDefinition::compute(), NBEdge::computeAngle(), NBEdge::computeLaneShapes(), NBNode::computeLogic(), NBOwnTLDef::computeLogicAndConts(), NBNode::computeNodeShape(), NBNodeShapeComputer::computeNodeShapeDefault(), NBNodeShapeComputer::computeNodeShapeSmall(), RODFNet::computeRoutesFor(), NBTrafficLightLogicCont::computeSingleLogic(), NBNode::computeSmoothShape(), NBTurningDirectionsComputer::computeTurnDirectionsForNode(), NGNet::connect(), MSSOTLWaveTrafficLightLogic::countVehicles(), MSSOTLE2Sensors::countVehicles(), MSDevice_SSM::createEncounters(), GUINet::createTLWrapper(), MSDeterministicHiLevelTrafficLightLogic::decideNextPhase(), MSSOTLPolicyBasedTrafficLightLogic::decideNextPhase(), MSSwarmTrafficLightLogic::decideNextPhase(), MSDeterministicHiLevelTrafficLightLogic::decidePolicy(), MSSwarmTrafficLightLogic::decidePolicy(), detectCollisionBetween(), detectCollisions(), NIVissimDistrictConnection::dict_BuildDistricts(), NBEdge::divideOnEdges(), NBEdge::divideSelectedLanesOnEdges(), MSTransportable::Stage_Waiting::endEventOutput(), MSTransportable::Stage_Driving::endEventOutput(), MSE3Collector::enter(), METriggeredCalibrator::execute(), MSCalibrator::execute(), Command_SaveTLSState::execute(), Command_SaveTLSSwitchStates::execute(), Command_SaveTLSSwitches::execute(), MSVTypeProbe::execute(), MSPModel_Striping::MovePedestrians::execute(), MSTrafficLightLogic::SwitchCommand::execute(), MSVehicle::executeMove(), executeMovements(), NBNodeCont::extract(), NBTrafficLightLogicCont::extract(), NBEdgeCont::extract(), TraCIServerAPI_Vehicle::findCloserLane(), MSDevice_SSM::findFoeConflictLane(), MSDevice_SSM::findSurroundingVehicles(), MSDevice_SSM::flushConflicts(), NBRampsComputer::fulfillsRampConstraints(), RODFDetectorCon::getAggFlowFor(), RODFDetectorCon::getAnyDetectorForEdge(), GNEConnection::getAttribute(), MSVehicle::getBackPosition(), TraCI_Vehicle::getBestLanes(), MSNet::getBusStopID(), MSVehicle::getCenterOnEdge(), MSDevice_Battery::getChargingStationID(), MSNet::getChargingStationID(), NBEdge::getConnection(), NBEdge::getConnectionRef(), MSNet::getContainerStopID(), NBEdge::getCrossingAngle(), RODFNet::getDetectorEdge(), TraCI_Lane::getEdgeID(), MSMeanData::getEdgeID(), NBEdge::getFirstNonPedestrianLane(), getFollower(), getFollowersOnConsecutive(), TraCI_InductionLoop::getLaneID(), TraCI_LaneArea::getLaneID(), TraCI_Vehicle::getLaneID(), getLastVehicleInformation(), MSVehicle::getLatOffset(), getLeader(), MSLink::getLeaderInfo(), getLeaderOnConsecutive(), getLeadersOnConsecutive(), MSLink::getLengthBeforeCrossing(), TraCI_Lane::getLinks(), getLinkTo(), MSTLLogicControl::TLSLogicVariants::getLogicInstantiatingOff(), MSDeterministicHiLevelTrafficLightLogic::getMeanSpeedForInputLanes(), MSDeterministicHiLevelTrafficLightLogic::getMeanSpeedForOutputLanes(), NIImporter_VISUM::getNamedEdgeContinuating(), MSPerson::getNextEdge(), MSPModel_Striping::getNextLane(), getOppositeFollower(), getOppositeLeader(), getOppositePos(), GUIInstantInductLoop::MyWrapper::getParameterWindow(), GUIMEInductLoop::MyWrapper::getParameterWindow(), GUIVehicle::getParameterWindow(), GUIE2Collector::MyWrapper::getParameterWindow(), GUIInductLoop::MyWrapper::getParameterWindow(), MSNet::getParkingAreaID(), getPartialBehind(), MSSOTLTrafficLightLogic::getPhaseIndexWithMaxCTS(), MSSwarmTrafficLightLogic::getPheromoneForInputLanes(), MSSwarmTrafficLightLogic::getPheromoneForOutputLanes(), GUITrafficLightLogicWrapper::getPopUpMenu(), NLTriggerBuilder::getPosition(), NLDetectorBuilder::getPositionChecking(), NBNode::getPossiblySplittedIncoming(), NBNode::getPossiblySplittedOutgoing(), NIImporter_VISUM::getReversedContinuating(), TraCI_Vehicle::getRoadID(), TraCI_Vehicle::getRouteID(), MSDevice_SSM::getUpstreamVehicles(), MSDevice_SSM::getVehiclesOnJunction(), MSVehicleControl::getWaitingVehicle(), MSLink::getZipperSpeed(), NBNode::guessCrossings(), RODFDetectorCon::guessEmptyFlows(), NBEdgeCont::guessSidewalks(), NBNodeCont::guessTLs(), GUITLLogicPhasesTrackerWindow::GUITLLogicPhasesTrackerWindow(), handleCollisionBetween(), NBEdgeCont::ignoreFilterMatch(), MSDeterministicHiLevelTrafficLightLogic::init(), MSRailSignal::init(), MSDelayBasedTrafficLightLogic::init(), MSActuatedTrafficLightLogic::init(), MSTrafficLightLogic::init(), MSSOTLTrafficLightLogic::init(), MSSwarmTrafficLightLogic::init(), MSE2Collector::initAuxiliaries(), NIImporter_SUMO::initTrafficLightLogic(), NIXMLTrafficLightsHandler::initTrafficLightLogic(), NBDistrictCont::insert(), NBNodeCont::insert(), NBTrafficLightLogicCont::insert(), NBEdgeCont::insert(), MSEdge::insertVehicle(), integrateNewVehicle(), IntermodalNetwork< E, L, N, V >::IntermodalNetwork(), GNEJunction::invalidateTLS(), NBNode::invalidateTLS(), MSTLLogicControl::isActive(), MSPedestrianPushButton::isActiveForEdge(), MSPedestrianPushButton::isActiveOnAnySideOfTheRoad(), RODFNet::isDestination(), RODFNet::isFalseSource(), isInsertionSuccess(), RODFNet::isSource(), MSSOTLTrafficLightLogic::isThresholdPassed(), NBNodeCont::joinJunctions(), NBEdgeCont::joinSameNodeConnectingEdges(), MSE3Collector::leave(), MSE3Collector::leaveFront(), MSDevice_BTreceiver::BTreceiverUpdate::leaveRange(), MSPedestrianPushButton::loadCrossingEdgeMap(), NIImporter_OpenDrive::loadNetwork(), MSPedestrianPushButton::loadPushButtons(), NBEdge::MainDirections::MainDirections(), ODDistrictCont::makeDistricts(), MSE2Collector::makeVehicleInfo(), GNEJunction::markAsModified(), MSSOTLE2Sensors::meanVehiclesSpeed(), METriggeredCalibrator::METriggeredCalibrator(), MSPModel_Striping::moveInDirection(), MSPModel_Striping::moveInDirectionOnLane(), NBRampsComputer::moveRampRight(), MSPModel_Striping::PState::moveToNextLane(), MSCalibrator::MSCalibrator(), MSChargingStation::MSChargingStation(), MSDevice_Battery::MSDevice_Battery(), MSE2Collector::MSE2Collector(), NBLoadedTLDef::myCompute(), NIXMLEdgesHandler::myEndElement(), NIImporter_SUMO::myEndElement(), NIXMLConnectionsHandler::myStartElement(), MSLaneSpeedTrigger::myStartElement(), MSTriggeredRerouter::myStartElement(), NBConnection::NBConnection(), NBRequest::NBRequest(), MSDevice_BTreceiver::notifyEnter(), MSDevice_BTsender::notifyEnter(), MSDevice_Example::notifyEnter(), MSDevice_Tripinfo::notifyEnter(), MSTriggeredRerouter::notifyEnter(), MSDevice_SSM::notifyEnter(), MSE2Collector::notifyEnter(), MSDevice_Transportable::notifyLeave(), MSE3Collector::MSE3EntryReminder::notifyLeave(), MSDevice_Example::notifyLeave(), MSDevice_Tripinfo::notifyLeave(), MSDevice_BTreceiver::notifyLeave(), MSDevice_BTsender::notifyLeave(), MSE3Collector::MSE3LeaveReminder::notifyLeave(), MSDevice_SSM::notifyLeave(), MSE2Collector::notifyLeave(), MSDevice_Example::notifyMove(), MSDevice_BTreceiver::notifyMove(), MSDevice_BTsender::notifyMove(), MSMeanData::MeanDataValues::notifyMove(), MSDevice_SSM::notifyMove(), GUIViewTraffic::onGamingClick(), GNEViewNet::onLeftBtnPress(), RORouteHandler::openRoute(), Named::ComparatorIdLess::operator()(), NBTurningDirectionsComputer::combination_by_angle_sorter::operator()(), RODFNet::idComp::operator()(), NBNetBuilder::by_id_sorter::operator()(), NBOwnTLDef::edge_by_incoming_priority_sorter::operator()(), NBContHelper::same_connection_edge_sorter::operator()(), NBContHelper::edge_by_angle_to_nodeShapeCentroid_sorter::operator()(), NBNode::nodes_by_id_sorter::operator()(), MSEdge::by_id_sorter::operator()(), MSLane::incoming_lane_priority_sorter::operator()(), MSLane::outgoing_lane_priority_sorter::operator()(), NIImporter_VISUM::parse_EdgePolys(), NIImporter_VISUM::parse_Lanes(), NIImporter_VISUM::parse_LanesConnections(), NIImporter_VISUM::parse_Turns(), NIImporter_VISUM::parse_TurnsToSignalGroups(), NIXMLConnectionsHandler::parseDeprecatedLaneDefinition(), NIXMLConnectionsHandler::parseLaneBound(), MSRouteHandler::parseWalkPositions(), NBLoadedSUMOTLDef::patchIfCrossingsAdded(), MSLCM_LC2013::patchSpeed(), MSLCM_SL2015::patchSpeed(), NBLoadedTLDef::SignalGroup::patchTYellow(), MSVehicle::planMove(), planMovements(), MSInternalJunction::postloadInit(), MSRightOfWayJunction::postloadInit(), NBEdge::prepareEdgePriorities(), MSAbstractLaneChangeModel::primaryLaneChanged(), AGStreet::print(), MSDevice_SSM::processEncounters(), TraCIServerAPI_TLS::processGet(), TraCIServerAPI_Person::processGet(), MSVehicle::processNextStop(), TraCIServerAPI_Vehicle::processSet(), NIXMLNodesHandler::processTrafficLightDefinitions(), NWWriter_SUMO::prohibitionConnection(), MSDelayBasedTrafficLightLogic::proposeProlongation(), MSPModel_Striping::PState::PState(), NBEdgeCont::recheckLanes(), NBEdge::recheckLanes(), NBEdgeCont::recheckPostProcessConnections(), NIImporter_OpenStreetMap::reconstructLayerElevation(), NBNodeCont::remapIDs(), NBEdgeCont::remapIDs(), NBLoadedTLDef::SignalGroup::remapIncoming(), NBLoadedTLDef::SignalGroup::remapOutgoing(), NBLoadedSUMOTLDef::removeConnection(), NBNodeCont::removeIsolatedRoads(), MSCalibrator::removePending(), NBNode::removeSelfLoops(), NBEdgeCont::removeUnwishedEdges(), NBNodeCont::rename(), NBEdgeCont::rename(), GNENet::renameEdge(), GNENet::renameJunction(), RORouteDef::repairCurrentRoute(), NBConnection::replaceFrom(), MSVehicle::replaceParkingArea(), MSBaseVehicle::replaceRouteEdges(), NBConnection::replaceTo(), NIImporter_DlrNavteq::TrafficlightsHandler::report(), NIImporter_DlrNavteq::ConnectedLanesHandler::report(), MSBaseVehicle::reroute(), MSTriggeredRerouter::rerouteParkingZone(), resetPartialOccupation(), NBEdge::restoreRestrictedLane(), GNEEdge::retrieveConnection(), NIXMLTrafficLightsHandler::retrieveLaneIndex(), RODFNet::revalidateFlows(), RONet::saveAndRemoveRoutesUntil(), MSDevice_Vehroutes::saveState(), MSDevice::saveState(), MSDevice_Tripinfo::saveState(), MSBaseVehicle::saveState(), saveState(), GUIVehicle::selectBlockingFoes(), MSE2Collector::selectLanes(), NBNodeCont::setAsTLControlled(), GNEEdge::setAttribute(), MSChargingStation::setChargeDelay(), MSChargingStation::setChargingPower(), NBEdge::setControllingTLInformation(), MSChargingStation::setEfficency(), GNEJunction::setLogicValid(), MSDevice_Battery::setMaximumBatteryCapacity(), NBEdge::setNodeBorder(), NIXMLEdgesHandler::setNodes(), setPartialOccupation(), MSDevice_Battery::setPowerMax(), MSLink::setRequestInformation(), MSTLLogicControl::TLSLogicVariants::setStateInstantiatingOnline(), MSDevice_Battery::setStoppingTreshold(), NBLoadedSUMOTLDef::setTLControllingInformation(), NBOwnTLDef::setTLControllingInformation(), NBTrafficLightLogicCont::setTLControllingInformation(), NBLoadedTLDef::setTLControllingInformation(), NBEdge::shiftPositionAtNode(), NBEdgeCont::splitAt(), MSStopOut::stopEnded(), succLinkSec(), GUITrafficLightLogicWrapper::switchTLSLogic(), MELoop::teleportVehicle(), toString(), METriggeredCalibrator::tryEmit(), MSSOTLTrafficLightLogic::trySwitch(), MSDevice_SSM::update(), MSVehicle::updateBestLanes(), MSSOTLTrafficLightLogic::updateCTS(), GNETLSEditorFrame::updateDescription(), MSDevice_SSM::updateEncounter(), MSSwarmTrafficLightLogic::updatePheromoneLevels(), MSSwarmTrafficLightLogic::updateSensitivities(), MSDevice_BTreceiver::BTreceiverUpdate::updateVisibility(), TraCIServerAPI_Vehicle::vtdMap(), MSPModel_Striping::PState::walk(), MSLCM_LC2013::wantsChange(), MSLCM_SL2015::wantsChange(), MSLCM_SL2015::wantsChangeSublane(), MSBatteryExport::write(), MSEmissionExport::write(), MSFCDExport::write(), MSInstantInductLoop::write(), MSLink::writeApproaching(), NBSign::writeAsPOI(), NWWriter_DlrNavteq::writeConnectedLanes(), NWWriter_SUMO::writeConnection(), NWWriter_SUMO::writeDistrict(), MSFullExport::writeEdge(), MSXMLRawOut::writeEdge(), NWWriter_SUMO::writeEdge(), MSMeanData::writeEdge(), NWWriter_XML::writeEdgesAndConnections(), RODFDetector::writeEmitterDefinition(), RODFDetectorCon::writeEmitterPOIs(), RODFDetectorCon::writeEmitters(), RODFDetectorCon::writeEndRerouterDetectors(), NWWriter_SUMO::writeInternalConnections(), writeInterval(), NWWriter_SUMO::writeJunction(), MSQueueExport::writeLane(), MSFullExport::writeLane(), NWWriter_DlrNavteq::writeLinksUnsplitted(), NWWriter_OpenDrive::writeNetwork(), NWWriter_XML::writeNodes(), NWWriter_DlrNavteq::writeNodesUnsplitted(), NWWriter_DlrNavteq::writeProhibitedManoeuvres(), NWWriter_SUMO::writeRoundabout(), RODFDetectorCon::writeSpeedTrigger(), NWWriter_DlrNavteq::writeTrafficSignals(), MSFCDExport::writeTransportable(), RODFDetectorCon::writeValidationDetectors(), MSFullExport::writeVehicles(), PointOfInterest::writeXML(), SUMO::Polygon::writeXML(), MSRouteProbe::writeXMLOutput(), MSInductLoop::writeXMLOutput(), MSE2Collector::writeXMLOutput(), and RONet::~RONet().

◆ getIDSecure()

◆ getIncomingLanes()

◆ getIncomingLinkState()

LinkState MSLane::getIncomingLinkState ( ) const

get the state of the link from the logical predecessor to this lane

Definition at line 2059 of file MSLane.cpp.

References MSLinkContHelper::getConnectingLink(), getLogicalPredecessorLane(), MSLink::getState(), and LINKSTATE_DEADEND.

Referenced by getIncomingLanes().

◆ getIndex()

◆ getLastAnyVehicle()

MSVehicle * MSLane::getLastAnyVehicle ( ) const

returns the last vehicle that is fully or partially on this lane

Definition at line 1520 of file MSLane.cpp.

References myPartialVehicles, and myVehicles.

Referenced by MSVehicle::checkRewindLinkLanes(), dictSize(), getCriticalLeader(), isInsertionSuccess(), lastInsertion(), and MSLink::maybeOccupied().

◆ getLastFullVehicle()

MSVehicle * MSLane::getLastFullVehicle ( ) const

returns the last vehicle for which this lane is responsible or 0

Definition at line 1502 of file MSLane.cpp.

References myVehicles.

Referenced by dictSize().

◆ getLastVehicleInformation()

const MSLeaderInfo & MSLane::getLastVehicleInformation ( const MSVehicle ego,
double  latOffset,
double  minPos = 0,
bool  allowCached = true 
) const

Returns the last vehicles on the lane.

The information about the last vehicles in this lanes in all sublanes occupied by ego are returned. Partial occupators are included

Parameters
[in]egoThe vehicle for which to restrict the returned leaderInfo
[in]minPosThe minimum position from which to start search for leaders
[in]allowCachedWhether the cached value may be used
Returns
Information about the last vehicles

Definition at line 859 of file MSLane.cpp.

References MSLeaderInfo::addLeader(), anyVehiclesBegin(), DEBUG_COND2, MSNet::getCurrentTimeStep(), Named::getID(), MSBaseVehicle::getID(), MSNet::getInstance(), MSVehicle::getLatOffset(), MSVehicle::getPositionOnLane(), myLeaderInfo, myLeaderInfoTime, myLeaderInfoTmp, and MSLeaderInfo::toString().

Referenced by detectCollisions(), getLeadersOnConsecutive(), getMoveReminders(), isInsertionSuccess(), and MSVehicle::planMoveInternal().

◆ getLeader()

std::pair< MSVehicle *const, double > MSLane::getLeader ( const MSVehicle veh,
const double  vehPos,
const std::vector< MSLane *> &  bestLaneConts,
double  dist = -1,
bool  checkTmpVehicles = false 
) const

Returns the immediate leader of veh and the distance to veh starting on this lane.

Iterates over the current lane to find a leader and then uses getLeaderOnConsecutive()

Parameters
[in]vehThe vehicle for which the information shall be computed
[in]vehPosThe vehicle position relative to this lane (may be negative)
[in]bestLaneContsThe succeding lanes that shall be checked (if any)
[in]distOptional distance to override default (ego stopDist)
[in]checkTmpVehiclesWhether myTmpVehicles should be used instead of myVehicles
Returns

Definition at line 1765 of file MSLane.cpp.

References anyVehiclesBegin(), anyVehiclesEnd(), MSCFModel::brakeGap(), DEBUG_COND2, MSVehicle::getBackPositionOnLane(), MSVehicle::getCarFollowModel(), Named::getID(), MSBaseVehicle::getID(), getLeaderOnConsecutive(), getLength(), MSVehicleType::getMinGap(), MSVehicle::getPositionOnLane(), MSVehicle::getSpeed(), MSBaseVehicle::getVehicleType(), myTmpVehicles, myVehicles, NUMERICAL_EPS, and toString().

Referenced by MSLaneChanger::checkChange(), getIncomingLanes(), getOppositeFollower(), getOppositeLeader(), and lastInsertion().

◆ getLeaderOnConsecutive()

std::pair< MSVehicle *const, double > MSLane::getLeaderOnConsecutive ( double  dist,
double  seen,
double  speed,
const MSVehicle veh,
const std::vector< MSLane *> &  bestLaneConts 
) const

Returns the immediate leader and the distance to him.

Goes along the vehicle's estimated used lanes (bestLaneConts). For each link, it is determined whether the vehicle will pass it. If so, the subsequent lane is investigated. If a vehicle (leader) is found, it is returned, together with the length of the investigated lanes until this vehicle's end, including the already seen place (seen).

If no leading vehicle was found, <0, -1> is returned.

Pretty slow, as it has to go along lanes.

Todo:
: There are some oddities:
  • what about crossing a link at red, or if a link is closed? Has a following vehicle to be regarded or not?
Parameters
[in]distThe distance to investigate
[in]seenThe already seen place (normally the place in front on own lane)
[in]speedThe speed of the vehicle used for determining whether a subsequent link will be opened at arrival time
[in]vehThe vehicle for which the information shall be computed
[in]bestLaneContsThe lanes the vehicle will use in future
Returns

Definition at line 1830 of file MSLane.cpp.

References MSCFModel::brakeGap(), DEBUG_COND2, MSVehicle::getBackPositionOnLane(), MSVehicle::getCarFollowModel(), MSNet::getCurrentTimeStep(), Named::getID(), MSBaseVehicle::getID(), MSBaseVehicle::getImpatience(), MSNet::getInstance(), MSVehicle::getLateralPositionOnLane(), MSVehicleType::getLength(), getLength(), MSCFModel::getMaxDecel(), MSVehicleType::getMinGap(), MSBaseVehicle::getVehicleType(), MAX2(), myPartialVehicles, NUMERICAL_EPS, succLinkSec(), TIME2STEPS, and toString().

Referenced by getIncomingLanes(), getLeader(), and MSVehicle::getLeader().

◆ getLeadersOnConsecutive()

◆ getLength()

double MSLane::getLength ( ) const
inline

Returns the lane's length.

Returns
This lane's length

Definition at line 484 of file MSLane.h.

References myLength.

Referenced by MSVehicle::adaptLaneEntering2MoveReminder(), MSVehicle::adaptToLeaders(), NLTriggerBuilder::addAccess(), NLHandler::addConnection(), addIncomingLane(), MSVehicle::addStop(), MSSOTLE2Sensors::buildContinueSensior(), MSSOTLE2Sensors::buildCountSensorForLane(), MSSOTLE2Sensors::buildCountSensorForOutLane(), NLDetectorBuilder::buildE2Detector(), MSSOTLE2Sensors::buildSensorForLane(), MSSOTLE2Sensors::buildSensorForOutLane(), MSLaneChanger::changeOpposite(), MSLaneChanger::checkChange(), MSE2Collector::checkPositioning(), MSVehicle::checkRewindLinkLanes(), MSLCM_SL2015::checkStrategicChange(), MSLCM_LC2013::distanceAlongNextRoundabout(), MSPModel_Striping::PState::distToLaneEnd(), GUIVehicle::drawAction_drawRailCarriages(), GUIEdge::drawMesoVehicles(), MSVehicle::executeMove(), executeMovements(), MSDevice_SSM::findFoeConflictLane(), MSDevice_SSM::findSurroundingVehicles(), freeInsertion(), GUILane::getColorValue(), getCriticalLeader(), MSVehicle::getDistanceToPosition(), MSE2Collector::getEstimateQueueLength(), getFollowersOnConsecutive(), MSLink::getInternalLengthsAfter(), TraCI::getLaneChecking(), NLShapeHandler::getLanePos(), getLeader(), MSVehicle::getLeader(), MSLink::getLeaderInfo(), getLeaderOnConsecutive(), MSLaneChangerSublane::getLeaders(), getLeadersOnConsecutive(), TraCI_Lane::getLength(), MSLink::getLengthBeforeCrossing(), MSPModel_Striping::getNextLaneObstacles(), TraCI_Vehicle::getNextTLS(), getOppositePos(), NLTriggerBuilder::getPosition(), NLDetectorBuilder::getPositionChecking(), MSVehicle::getRerouteOrigin(), MSLCM_LC2013::getRoundaboutAheadInfo(), MSVehicle::getSafeFollowSpeed(), MSVehicle::getSpaceTillLastStanding(), TraCI_Lane::getTraveltime(), handleCollisionBetween(), MSDelayBasedTrafficLightLogic::init(), MSActuatedTrafficLightLogic::init(), MSE2Collector::initAuxiliaries(), MSPModel_Striping::initWalkingAreaPaths(), insertVehicle(), isInsertionSuccess(), lastInsertion(), MSLink::maybeOccupied(), MSPModel_Striping::moveInDirectionOnLane(), MSPModel_Striping::PState::moveToNextLane(), MSE2Collector::MSE2Collector(), NLTriggerBuilder::parseAndBeginParkingArea(), NLTriggerBuilder::parseAndBuildChargingStation(), MSVehicle::planMoveInternal(), MSVehicle::Influencer::postProcessVTD(), MSE2Collector::recalculateDetectorLength(), GUIVehicle::selectBlockingFoes(), MSE2Collector::selectLanes(), MSVehicle::setBlinkerInformation(), MSLink::setRequestInformation(), MSVehicle::unsafeLinkAhead(), MSVehicle::updateBestLanes(), TraCIServerAPI_Vehicle::vtdMap(), MSLCM_DK2008::wantsChangeToLeft(), MSLCM_DK2008::wantsChangeToRight(), MSMeanData::writeEdge(), and MSQueueExport::writeLane().

◆ getLengthGeometryFactor()

double MSLane::getLengthGeometryFactor ( ) const
inline

return shape.length() / myLength

Definition at line 431 of file MSLane.h.

References myLengthGeometryFactor.

◆ getLinkCont()

◆ getLinkTo()

MSLink * MSLane::getLinkTo ( const MSLane target) const

◆ getLogicalPredecessorLane() [1/2]

◆ getLogicalPredecessorLane() [2/2]

MSLane * MSLane::getLogicalPredecessorLane ( const MSEdge fromEdge) const

return the (first) predecessor lane from the given edge

Definition at line 2007 of file MSLane.cpp.

References getEdge(), and myIncomingLanes.

◆ getMap()

const std::map<std::string, std::string>& Parameterised::getMap ( ) const
inlineinherited

◆ getMaximumBrakeDist()

double MSLane::getMaximumBrakeDist ( ) const
protected

compute maximum braking distance on this lane

Definition at line 1755 of file MSLane.cpp.

References MSNet::getInstance(), MSVehicleControl::getMaxSpeedFactor(), MSVehicleControl::getMinDeceleration(), getSpeedLimit(), and MSNet::getVehicleControl().

Referenced by getFollowersOnConsecutive().

◆ getMeanSpeed()

double MSLane::getMeanSpeed ( ) const

Returns the mean speed on this lane.

Returns
The average speed of vehicles during the last step; default speed if no vehicle was on this lane

Definition at line 2149 of file MSLane.cpp.

References getVehiclesSecure(), myMaxSpeed, myVehicles, and releaseVehicles().

Referenced by GUILane::getColorValue(), getIncomingLanes(), TraCI_Lane::getLastStepMeanSpeed(), GUILane::getScaleValue(), TraCI_Lane::getTraveltime(), and MSFullExport::writeLane().

◆ getMissingRearGap()

double MSLane::getMissingRearGap ( const MSVehicle leader,
double  backOffset,
double  leaderSpeed 
) const

return by how much further the leader must be inserted to avoid rear end collisions

Definition at line 1739 of file MSLane.cpp.

References MSVehicle::getCarFollowModel(), getFollowersOnConsecutive(), MSCFModel::getMaxDecel(), MSCFModel::getSecureGap(), and MSVehicle::getSpeed().

Referenced by freeInsertion(), getIncomingLanes(), and isInsertionSuccess().

◆ getMoveReminders()

◆ getNettoOccupancy()

double MSLane::getNettoOccupancy ( ) const

Returns the netto (excluding minGaps) occupancy of this lane during the last step (including minGaps)

Returns
The occupancy during the last step

Definition at line 2121 of file MSLane.cpp.

References MSVehicleType::getLength(), MSVehicle::getPositionOnLane(), getVehiclesSecure(), MSBaseVehicle::getVehicleType(), myLength, myNettoVehicleLengthSum, myPartialVehicles, myVehicles, and releaseVehicles().

Referenced by GUILane::getColorValue(), getIncomingLanes(), TraCI_Lane::getLastStepOccupancy(), GUILane::getParameterWindow(), GUILane::getScaleValue(), and MSFullExport::writeLane().

◆ getNextNormal()

const MSEdge * MSLane::getNextNormal ( ) const

Returns the lane's follower if it is an internal lane, the edge of the lane otherwise.

Returns
This lane's follower

Definition at line 1360 of file MSLane.cpp.

References MSEdge::EDGEFUNCTION_INTERNAL, MSEdge::getPurpose(), MSEdge::getSuccessors(), and myEdge.

Referenced by getEdge(), MSVehicle::getRerouteOrigin(), and MSVehicle::updateBestLanes().

◆ getNOxEmissions()

double MSLane::getNOxEmissions ( ) const

Returns the sum of last step NOx emissions.

Returns
NOx emissions of vehicles on this lane during the last step

Definition at line 2201 of file MSLane.cpp.

References getVehiclesSecure(), and releaseVehicles().

Referenced by getBruttoVehLenSum(), GUILane::getColorValue(), TraCI_Lane::getNOxEmission(), GUILane::getScaleValue(), and MSFullExport::writeLane().

◆ getNumericalID()

int MSLane::getNumericalID ( ) const
inline

Returns this lane's numerical id.

Returns
This lane's numerical id

Definition at line 418 of file MSLane.h.

References myNumericalID.

Referenced by MSPModel_Striping::lane_by_numid_sorter::operator()(), and MSPModel_Striping::walkingarea_path_sorter::operator()().

◆ getOpposite()

MSLane * MSLane::getOpposite ( ) const

return the opposite direction lane for lane changing or 0

Definition at line 2704 of file MSLane.cpp.

References dictionary(), and myNeighs.

Referenced by MSLaneChanger::changeOpposite(), MSVehicle::executeMove(), getCenterOnEdge(), getOppositePos(), MSVehicle::planMoveInternal(), MSVehicle::updateBestLanes(), and MSVehicle::updateState().

◆ getOppositeFollower()

◆ getOppositeLeader()

◆ getOppositePos()

double MSLane::getOppositePos ( double  pos) const

◆ getOutgoingLanes()

std::vector< const MSLane * > MSLane::getOutgoingLanes ( ) const

get the list of outgoing lanes

Definition at line 2070 of file MSLane.cpp.

References myLinks.

Referenced by getIncomingLanes(), MSRailSignal::init(), and MSVehicle::replaceRoute().

◆ getParallelLane()

MSLane * MSLane::getParallelLane ( int  offset) const

Returns the lane with the given offset parallel to this one or 0 if it does not exist.

Parameters
[in]offsetThe offset of the result lane

Definition at line 1685 of file MSLane.cpp.

References myEdge, and MSEdge::parallelLane().

Referenced by MSLaneChanger::checkChange(), MSLink::computeParallelLink(), dictSize(), MSAbstractLaneChangeModel::getShadowLane(), and MSVehicle::planMoveInternal().

◆ getParameter()

const std::string & Parameterised::getParameter ( const std::string &  key,
const std::string &  defaultValue 
) const
inherited

Returns the value for a given key.

Parameters
[in]keyThe key to ask for
[in]defaultValueThe default value to return if no value is stored under the key
Returns
The value stored under the key

Definition at line 79 of file Parameterised.cpp.

References Parameterised::myMap.

Referenced by MSTLLogicControl::WAUTSwitchProcedure_Stretch::adaptLogic(), MSDevice_Battery::buildVehicleDevices(), MSDevice_Example::buildVehicleDevices(), MSDevice::equippedByDefaultAssignmentOptions(), MSSOTLTrafficLightLogic::getDecayConstant(), MSDevice_SSM::getDetectionRange(), MSTLLogicControl::WAUTSwitchProcedure::getGSPValue(), MSSOTLTrafficLightLogic::getInputSensorsLength(), MSDevice_SSM::getLoggingFrequency(), MSDevice_SSM::getMeasuresAndThresholds(), MSSOTLRequestPolicy::getMinDecisionalPhaseDuration(), MSSOTLRequestTrafficLightLogic::getMinDecisionalPhaseDuration(), MSSOTLTrafficLightLogic::getMode(), MSDevice_SSM::getOutputFilename(), MSSOTLTrafficLightLogic::getOutputSensorsLength(), TraCI_Polygon::getParameter(), TraCI_VehicleType::getParameter(), TraCI_Route::getParameter(), TraCI_POI::getParameter(), TraCI_Lane::getParameter(), TraCI_Vehicle::getParameter(), MSSOTLTrafficLightLogic::getSpeedThreshold(), MSTLLogicControl::WAUTSwitchProcedure_Stretch::getStretchAreaNo(), MSTLLogicControl::WAUTSwitchProcedure_Stretch::getStretchBereichDef(), MSSOTLTrafficLightLogic::getThreshold(), MSTriggeredRerouter::getWeight(), PushButtonLogic::init(), MSSOTLPhasePolicy::init(), SigmoidLogic::init(), MSSOTLTrafficLightLogic::init(), MSSwarmTrafficLightLogic::init(), NIImporter_OpenStreetMap::insertEdge(), MSSOTLTrafficLightLogic::isDecayThresholdActivated(), MSSOTLTrafficLightLogic::isPushButtonPressed(), MSActuatedTrafficLightLogic::MSActuatedTrafficLightLogic(), MSDelayBasedTrafficLightLogic::MSDelayBasedTrafficLightLogic(), MSSOTLPolicy::MSSOTLPolicy(), MSSOTLPolicy5DFamilyStimulus::MSSOTLPolicy5DFamilyStimulus(), MSSwarmTrafficLightLogic::MSSwarmTrafficLightLogic(), TraCIServerAPI_Edge::processGet(), TraCIServerAPI_TLS::processGet(), TraCIServerAPI_Person::processGet(), MSSOTLPolicyDesirability::readParameter(), MSDevice_SSM::requestsTrajectories(), MSTLLogicControl::WAUTSwitchProcedure_Stretch::stretchLogic(), TraCIServerAPI_Vehicle::vtdMap(), and NWWriter_DlrNavteq::writeLinksUnsplitted().

◆ getPartialBehind()

MSVehicle * MSLane::getPartialBehind ( const MSVehicle ego) const

◆ getPartialVehicleNumber()

int MSLane::getPartialVehicleNumber ( ) const
inline

Returns the number of vehicles partially on this lane (for which this lane is not responsible)

Returns
The number of vehicles touching this lane but with their front on another lane

Definition at line 368 of file MSLane.h.

References myPartialVehicles.

◆ getPermissions()

SVCPermissions MSLane::getPermissions ( ) const
inline

Returns the vehicle class permissions for this lane.

Returns
This lane's allowed vehicle classes

Definition at line 492 of file MSLane.h.

References myPermissions.

Referenced by MSSwarmTrafficLightLogic::allowLine(), TraCI_Lane::getAllowed(), and GUIApplicationWindow::onCmdEditChosen().

◆ getPMxEmissions()

double MSLane::getPMxEmissions ( ) const

Returns the sum of last step PMx emissions.

Returns
PMx emissions of vehicles on this lane during the last step

Definition at line 2189 of file MSLane.cpp.

References getVehiclesSecure(), and releaseVehicles().

Referenced by getBruttoVehLenSum(), GUILane::getColorValue(), TraCI_Lane::getPMxEmission(), GUILane::getScaleValue(), and MSFullExport::writeLane().

◆ getRightmostSublane()

int MSLane::getRightmostSublane ( ) const
inline

Definition at line 928 of file MSLane.h.

References myRightmostSublane.

Referenced by MSLCM_SL2015::_wantsChangeSublane().

◆ getRightSideOnEdge()

◆ getShape()

const PositionVector& MSLane::getShape ( ) const
inline

Returns this lane's shape.

Returns
This lane's shape

Definition at line 426 of file MSLane.h.

References myShape.

Referenced by TraCIServerAPI_Lane::StoringVisitor::add(), GUIBusStop::addAccess(), NLHandler::addConnection(), GUIE3Collector::MyWrapper::buildDefinition(), TraCIServerAPI_Simulation::commandPositionConversion(), MSVehicle::computeAngle(), GUIVehicle::drawAction_drawLinkItems(), GUILane::drawLane2LaneConnections(), fill(), TraCIServerAPI_Vehicle::findCloserLane(), MEVehicle::getAngle(), MSPModel_Striping::PState::getAngle(), MSTransportable::Stage::getLanePosition(), MSPModel_Striping::getNextLaneObstacles(), TraCIServerAPI_InductionLoop::getPosition(), GUIContainer::getPosition(), TraCI_Lane::getShape(), TraCIServerAPI_Lane::getShape(), MEVehicle::getSlope(), MSVehicle::getSlope(), MSVTKExport::getSpeed(), TraCIServerAPI_InductionLoop::getTree(), MSStoppingPlace::getWaitPosition(), GUIBusStop::GUIBusStop(), GUIChargingStation::GUIChargingStation(), GUIContainerStop::GUIContainerStop(), MSPModel_Striping::initWalkingAreaPaths(), MSParkingArea::MSParkingArea(), GUIMEInductLoop::MyWrapper::MyWrapper(), GUIInstantInductLoop::MyWrapper::MyWrapper(), GUIInductLoop::MyWrapper::MyWrapper(), MSLane::by_connections_to_sorter::operator()(), MSLane::incoming_lane_priority_sorter::operator()(), MSLane::outgoing_lane_priority_sorter::operator()(), TraCIServerAPI_Vehicle::processSet(), MSLink::setRequestInformation(), MSLaneChangerSublane::startChangeSublane(), TraCIServerAPI_Vehicle::vtdMap(), and MSBatteryExport::write().

◆ getSpeedLimit()

◆ getVehicleMaxSpeed()

◆ getVehicleNumber()

int MSLane::getVehicleNumber ( ) const
inline

Returns the number of vehicles on this lane (for which this lane is responsible)

Returns
The number of vehicles with their front on this lane

Definition at line 352 of file MSLane.h.

References myVehicles.

Referenced by MSVehicle::checkRewindLinkLanes(), TraCI_Lane::getLastStepVehicleNumber(), MSVehicle::planMoveInternal(), MSFullExport::writeLane(), and MSXMLRawOut::writeLane().

◆ getVehicleNumberWithPartials()

int MSLane::getVehicleNumberWithPartials ( ) const
inline

Returns the number of vehicles on this lane (including partial occupators)

Returns
The number of vehicles with intersecting this lane

Definition at line 360 of file MSLane.h.

References myPartialVehicles, and myVehicles.

◆ getVehiclesSecure()

virtual const VehCont& MSLane::getVehiclesSecure ( ) const
inlinevirtual

◆ getWaitingSeconds()

double MSLane::getWaitingSeconds ( ) const

Returns the overall waiting time on this lane.

Returns
The sum of the waiting time of all vehicles during the last step;

Definition at line 2136 of file MSLane.cpp.

References myVehicles.

Referenced by getIncomingLanes(), and TraCI_Lane::getWaitingTime().

◆ getWidth()

◆ handleCollisionBetween()

void MSLane::handleCollisionBetween ( SUMOTime  timestep,
const std::string &  stage,
MSVehicle collider,
MSVehicle victim,
double  gap,
double  latGap,
std::set< const MSVehicle *, SUMOVehicle::ComparatorIdLess > &  toRemove,
std::set< const MSVehicle *> &  toTeleport 
) const
protected

◆ incorporateVehicle()

void MSLane::incorporateVehicle ( MSVehicle veh,
double  pos,
double  speed,
double  posLat,
const MSLane::VehCont::iterator &  at,
MSMoveReminder::Notification  notification = MSMoveReminder::NOTIFICATION_DEPARTED 
)
protectedvirtual

Inserts the vehicle into this lane, and informs it about entering the network.

Calls the vehicles enterLaneAtInsertion function, updates statistics and modifies the active state as needed

Parameters
[in]vehThe vehicle to be incorporated
[in]posThe position of the vehicle
[in]speedThe speed of the vehicle
[in]posLatThe lateral position of the vehicle
[in]at
[in]notificationThe cause of insertion (i.e. departure, teleport, parking) defaults to departure

Reimplemented in GUILane.

Definition at line 256 of file MSLane.cpp.

References MSVehicle::enterLaneAtInsertion(), MSNet::getEdgeControl(), MSNet::getInstance(), MSVehicleType::getLength(), MSVehicleType::getLengthWithGap(), MSBaseVehicle::getVehicleType(), MSEdgeControl::gotActive(), MSEdge::markDelayed(), myBruttoVehicleLengthSum, myEdge, myLength, myNettoVehicleLengthSum, and myVehicles.

Referenced by forceVehicleInsertion(), GUILane::incorporateVehicle(), isInsertionSuccess(), and loadState().

◆ initCollisionOptions()

◆ initRestrictions()

void MSLane::initRestrictions ( )

initialized vClass-specific speed limits

Definition at line 195 of file MSLane.cpp.

References MSEdge::getEdgeType(), MSNet::getInstance(), MSNet::getRestrictions(), myEdge, and myRestrictions.

Referenced by MSLane(), and setRightSideOnEdge().

◆ insertIDs()

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

Adds the ids of all stored lanes into the given vector.

Parameters

Definition at line 1403 of file MSLane.cpp.

References myDict.

Referenced by dictSize(), and TraCI_Lane::getIDList().

◆ insertVehicle()

bool MSLane::insertVehicle ( MSVehicle v)

Tries to insert the given vehicle.

The insertion position and speed are determined in dependence to the vehicle's departure definition, first.

Then, the vehicle is tried to be inserted into the lane using these values by a call to "isInsertionSuccess". The result of "isInsertionSuccess" is returned.

Parameters
[in]vThe vehicle to insert
Returns
Whether the vehicle could be inserted
See also
isInsertionSuccess
MSVehicle::getDepartureDefinition
MSVehicle::DepartArrivalDefinition

Definition at line 428 of file MSLane.cpp.

References basePos(), DEPART_POS_BASE, DEPART_POS_DEFAULT, DEPART_POS_FREE, DEPART_POS_GIVEN, DEPART_POS_LAST, DEPART_POS_RANDOM, DEPART_POS_RANDOM_FREE, DEPART_POSLAT_CENTER, DEPART_POSLAT_FREE, DEPART_POSLAT_GIVEN, DEPART_POSLAT_LEFT, DEPART_POSLAT_RANDOM, DEPART_POSLAT_RANDOM_FREE, DEPART_POSLAT_RIGHT, SUMOVehicleParameter::departPos, SUMOVehicleParameter::departPosLat, SUMOVehicleParameter::departPosLatProcedure, SUMOVehicleParameter::departPosProcedure, freeInsertion(), getDepartSpeed(), getLength(), MSBaseVehicle::getParameter(), MSBaseVehicle::getVehicleType(), MSVehicleType::getWidth(), getWidth(), isInsertionSuccess(), lastInsertion(), myLength, MSMoveReminder::NOTIFICATION_DEPARTED, and RandHelper::rand().

Referenced by getMoveReminders(), and MSEdge::insertVehicle().

◆ integrateNewVehicle()

◆ interpolateGeometryPosToLanePos()

double MSLane::interpolateGeometryPosToLanePos ( double  geometryPos) const
inline

Definition at line 454 of file MSLane.h.

References myLengthGeometryFactor.

Referenced by GUILane::getPopUpMenu(), and MSLink::setRequestInformation().

◆ interpolateLanePosToGeometryPos()

◆ isAccelLane()

bool MSLane::isAccelLane ( ) const
inline

return whether this lane is an acceleration lane

Definition at line 436 of file MSLane.h.

References myIsRampAccel.

Referenced by MSLCM_LC2013::informFollower().

◆ isApproachedFrom() [1/2]

bool MSLane::isApproachedFrom ( MSEdge *const  edge)

Definition at line 1715 of file MSLane.cpp.

References myApproachingLanes.

Referenced by getIncomingLanes().

◆ isApproachedFrom() [2/2]

bool MSLane::isApproachedFrom ( MSEdge *const  edge,
MSLane *const  lane 
)

Definition at line 1721 of file MSLane.cpp.

References myApproachingLanes.

◆ isEmpty()

bool MSLane::isEmpty ( ) const

Returns the information whether the lane is has no vehicle and no partial occupation

Definition at line 1492 of file MSLane.cpp.

References myPartialVehicles, and myVehicles.

Referenced by dictSize().

◆ isInsertionSuccess()

bool MSLane::isInsertionSuccess ( MSVehicle vehicle,
double  speed,
double  pos,
double  posLat,
bool  recheckNextLanes,
MSMoveReminder::Notification  notification 
)

Tries to insert the given vehicle with the given state (speed and pos)

Checks whether the vehicle can be inserted at the given position with the given speed so that no collisions with leader/follower occur and the speed does not cause unexpected behaviour on consecutive lanes. Returns false if the vehicle can not be inserted.

If the insertion can take place, incorporateVehicle() is called and true is returned.

Parameters
[in]vehicleThe vehicle to insert
[in]speedThe speed with which it shall be inserted
[in]posThe position at which it shall be inserted
[in]posLatThe lateral position at which it shall be inserted
[in]recheckNextLanesForces patching the speed for not being too fast on next lanes
[in]notificationThe cause of insertion (i.e. departure, teleport, parking) defaults to departure
Returns
Whether the vehicle could be inserted
See also
MSVehicle::enterLaneAtInsertion

Definition at line 535 of file MSLane.cpp.

References ARRIVAL_SPEED_GIVEN, SUMOVehicleParameter::arrivalSpeed, SUMOVehicleParameter::arrivalSpeedProcedure, MSRoute::begin(), MSCFModel::brakeGap(), checkFailure(), DEBUG_COND2, MSInsertionControl::descheduleDeparture(), MSVehicle::Stop::endPos, MSCFModel::freeSpeed(), MSVehicle::getBackPositionOnLane(), MSVehicle::getBestLanesContinuation(), MSVehicle::getCarFollowModel(), MSNet::getCurrentTimeStep(), getEdge(), getFollowersOnConsecutive(), Named::getID(), MSBaseVehicle::getID(), MSBaseVehicle::getImpatience(), MSNet::getInsertionControl(), MSNet::getInstance(), getLastAnyVehicle(), MSRoute::getLastEdge(), getLastVehicleInformation(), MSVehicleType::getLength(), getLength(), MSCFModel::getMaxDecel(), MSVehicleType::getMinGap(), getMissingRearGap(), MSVehicle::getNextStop(), MSBaseVehicle::getParameter(), MSBaseVehicle::getRoute(), MSCFModel::getSecureGap(), MSVehicle::getSpeed(), getVehicleMaxSpeed(), MSBaseVehicle::getVehicleType(), MSVehicle::hasStops(), incorporateVehicle(), MSCFModel::insertionFollowSpeed(), MSCFModel::insertionStopSpeed(), isLinkEnd(), MSVehicle::Stop::lane, LINKSTATE_ALLWAY_STOP, LINKSTATE_EQUAL, LINKSTATE_MINOR, LINKSTATE_STOP, MAX2(), Named::myID, myLength, myVehicles, NUMERICAL_EPS, MSLeaderInfo::numFreeSublanes(), MSLeaderInfo::numSublanes(), safeInsertionSpeed(), MSVehicle::setTentativeLaneAndPosition(), SIMTIME, MSCFModel::stopSpeed(), succLinkSec(), SUMO_const_haltingSpeed, TIME2STEPS, toString(), MSLeaderInfo::toString(), MSVehicle::updateBestLanes(), WRITE_ERROR, and WRITE_WARNING.

Referenced by MSVehicleTransfer::checkInsertions(), freeInsertion(), getMoveReminders(), insertVehicle(), and lastInsertion().

◆ isInternal()

◆ isLinkEnd() [1/2]

bool MSLane::isLinkEnd ( MSLinkCont::const_iterator &  i) const

Returns the information whether the given link shows at the end of the list of links (is not valid)

Definition at line 1481 of file MSLane.cpp.

References myLinks.

Referenced by MSLaneChanger::checkChange(), dictSize(), getCriticalLeader(), getLeadersOnConsecutive(), TraCI_Vehicle::getNextTLS(), isInsertionSuccess(), MSVehicle::planMoveInternal(), and MSVehicle::unsafeLinkAhead().

◆ isLinkEnd() [2/2]

bool MSLane::isLinkEnd ( MSLinkCont::iterator &  i)

Returns the information whether the given link shows at the end of the list of links (is not valid)

Definition at line 1487 of file MSLane.cpp.

References myLinks.

◆ knowsParameter()

bool Parameterised::knowsParameter ( const std::string &  key) const
inherited

◆ lastInsertion()

bool MSLane::lastInsertion ( MSVehicle veh,
double  mspeed,
bool  patchSpeed 
)

◆ leftByLaneChange()

◆ loadState()

void MSLane::loadState ( std::vector< std::string > &  vehIDs,
MSVehicleControl vc 
)

Loads the state of this segment with the given parameters.

This method is called for every internal que the segment has. Every vehicle is retrieved from the given MSVehicleControl and added to this lane.

Parameters
[in]vehIDsThe vehicle ids for the current que
[in]vcThe vehicle control to retrieve references vehicles from
Todo:

What about throwing an IOError?

What about throwing an error if something else fails (a vehicle can not be referenced)?

Definition at line 2458 of file MSLane.cpp.

References MSVehicle::getLateralPositionOnLane(), MSVehicle::getPositionOnLane(), MSVehicle::getSpeed(), MSVehicleControl::getVehicle(), incorporateVehicle(), myVehicles, MSMoveReminder::NOTIFICATION_JUNCTION, MSVehicle::processNextStop(), and MSVehicle::updateBestLanes().

Referenced by getCenterOnEdge().

◆ operator=()

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

invalidated assignment operator

Referenced by MSLane::edge_finder::operator()().

◆ planMovements()

void MSLane::planMovements ( const SUMOTime  t)
virtual

Compute safe velocities for all vehicles based on positions and speeds from the last time step. Also registers ApproachingVehicleInformation for all links.

This method goes through all vehicles calling their "planMove" method.

See also
MSVehicle::planMove

Reimplemented in GUILane.

Definition at line 962 of file MSLane.cpp.

References MSLeaderInfo::addLeader(), DEBUG_COND, Named::getID(), myPartialVehicles, myVehicles, SIMTIME, toString(), and MSLeaderInfo::toString().

Referenced by getIndex(), and GUILane::planMovements().

◆ releaseVehicles()

◆ removeVehicle()

◆ resetPartialOccupation()

void MSLane::resetPartialOccupation ( MSVehicle v)
virtual

Removes the information about a vehicle lapping into this lane.

Parameters
[in]vThe vehicle which laps into this lane

Reimplemented in GUILane.

Definition at line 236 of file MSLane.cpp.

References DEBUG_COND2, Named::getID(), MSBaseVehicle::getID(), myPartialVehicles, and SIMTIME.

Referenced by MSAbstractLaneChangeModel::cleanupShadowLane(), getMoveReminders(), GUILane::resetPartialOccupation(), and MSAbstractLaneChangeModel::updateShadowLane().

◆ resetPermissions()

void MSLane::resetPermissions ( long  transientID)

◆ safeInsertionSpeed()

double MSLane::safeInsertionSpeed ( const MSVehicle veh,
const MSLeaderInfo leaders,
double  speed 
)
protected

return the maximum safe speed for insertion behind leaders (a negative value indicates that safe insertion is impossible)

Definition at line 840 of file MSLane.cpp.

References MSVehicle::getBackPositionOnLane(), MSVehicle::getCarFollowModel(), MSCFModel::getMaxDecel(), MSVehicleType::getMinGap(), MSVehicle::getPositionOnLane(), MSVehicle::getSpeed(), MSBaseVehicle::getVehicleType(), MSCFModel::insertionFollowSpeed(), MIN2(), and MSLeaderInfo::numSublanes().

Referenced by isInsertionSuccess().

◆ saveState()

void MSLane::saveState ( OutputDevice out)

Saves the state of this lane into the given stream.

Basically, a list of vehicle ids

Parameters

Definition at line 2447 of file MSLane.cpp.

References OutputDevice::closeTag(), Named::getID(), myVehicles, OutputDevice::openTag(), SUMO_ATTR_VALUE, SUMO_TAG_LANE, SUMO_TAG_VIEWSETTINGS_VEHICLES, and OutputDevice::writeAttr().

Referenced by getCenterOnEdge().

◆ setID()

void Named::setID ( const std::string &  newID)
inlineinherited

resets the id

Parameters
[in]newIDThe new id of this object

Definition at line 74 of file Named.h.

References Named::myID.

Referenced by Distribution_Parameterized::Distribution_Parameterized(), NBNodeCont::remapIDs(), NBEdgeCont::remapIDs(), NBNodeCont::rename(), and NBEdgeCont::rename().

◆ setLength()

void MSLane::setLength ( double  val)

Sets a new length for the lane (used by TraCI only)

Parameters
[in]valthe new length in m

Definition at line 1649 of file MSLane.cpp.

References myEdge, myLength, and MSEdge::recalcCache().

Referenced by empty(), and TraCI_Lane::setLength().

◆ setMaxSpeed()

void MSLane::setMaxSpeed ( double  val)

Sets a new maximum speed for the lane (used by TraCI and MSCalibrator)

Parameters
[in]valthe new speed in m/s

Definition at line 1642 of file MSLane.cpp.

References myEdge, myMaxSpeed, and MSEdge::recalcCache().

Referenced by empty(), and TraCI_Lane::setMaxSpeed().

◆ setPartialOccupation()

double MSLane::setPartialOccupation ( MSVehicle v)
virtual

Sets the information about a vehicle lapping into this lane.

This vehicle is added to myVehicles and may be distinguished from regular vehicles by the disparity between this lane and v->getLane()

Parameters
[in]vThe vehicle which laps into this lane
Returns
This lane's length

Reimplemented in GUILane.

Definition at line 223 of file MSLane.cpp.

References DEBUG_COND2, Named::getID(), MSBaseVehicle::getID(), myLength, myPartialVehicles, and SIMTIME.

Referenced by getMoveReminders(), GUILane::setPartialOccupation(), and MSAbstractLaneChangeModel::updateShadowLane().

◆ setPermissions()

void MSLane::setPermissions ( SVCPermissions  permissions,
long  transientID 
)

Sets the permissions to the given value. If a transientID is given, the permissions are recored as temporary.

Parameters
[in]permissionsThe new permissions
[in]transientIDThe id of the permission-modification or the special value PERMANENT

Definition at line 2810 of file MSLane.cpp.

References CHANGE_PERMISSIONS_PERMANENT, myOriginalPermissions, myPermissionChanges, myPermissions, and resetPermissions().

Referenced by GUILane::closeTraffic(), dictSize(), TraCI_Lane::setAllowed(), and TraCI_Lane::setDisallowed().

◆ setRightSideOnEdge()

void MSLane::setRightSideOnEdge ( double  value,
int  rightmostSublane 
)
inline

Definition at line 916 of file MSLane.h.

References initRestrictions(), myRightmostSublane, and myRightSideOnEdge.

◆ sortPartialVehicles()

void MSLane::sortPartialVehicles ( )

sorts myPartialVehicles

Definition at line 1474 of file MSLane.cpp.

References myPartialVehicles.

Referenced by getCenterOnEdge(), integrateNewVehicle(), and swapAfterLaneChange().

◆ succLinkSec()

MSLinkCont::const_iterator MSLane::succLinkSec ( const SUMOVehicle veh,
int  nRouteSuccs,
const MSLane succLinkSource,
const std::vector< MSLane *> &  conts 
)
static

◆ swapAfterLaneChange()

void MSLane::swapAfterLaneChange ( SUMOTime  t)
protectedvirtual

moves myTmpVehicles int myVehicles after a lane change procedure

Reimplemented in GUILane.

Definition at line 1656 of file MSLane.cpp.

References myTmpVehicles, myVehicles, and sortPartialVehicles().

Referenced by GUILane::swapAfterLaneChange().

◆ teleportOnCollision()

static bool MSLane::teleportOnCollision ( )
inlinestatic

Definition at line 1011 of file MSLane.h.

References COLLISION_ACTION_TELEPORT, and myCollisionAction.

Referenced by MSVehicleControl::getTeleportCount().

◆ visit()

void MSLane::visit ( const TraCIServerAPI_Lane::StoringVisitor cont) const
inline

Callback for visiting the lane when traversing an RTree.

This is used in the TraCIServerAPI_Lane for context subscriptions.

Parameters
[in]contThe context doing all the work
See also
TraCIServerAPI_Lane::StoringVisitor::add

Definition at line 1004 of file MSLane.h.

References TraCIServerAPI_Lane::StoringVisitor::add(), and initCollisionOptions().

Referenced by TraCIServer::collectObjectsInRange().

◆ writeParams()

Friends And Related Function Documentation

◆ AnyVehicleIterator

friend class AnyVehicleIterator
friend

◆ MSLaneChanger

friend class MSLaneChanger
friend

needs access to myTmpVehicles (this maybe should be done via double-buffering!!!)

Definition at line 82 of file MSLane.h.

◆ MSLaneChangerSublane

friend class MSLaneChangerSublane
friend

Definition at line 83 of file MSLane.h.

◆ MSQueueExport

friend class MSQueueExport
friend

Definition at line 87 of file MSLane.h.

◆ MSXMLRawOut

friend class MSXMLRawOut
friend

Definition at line 85 of file MSLane.h.

Field Documentation

◆ CHANGE_PERMISSIONS_GUI

const long MSLane::CHANGE_PERMISSIONS_GUI = 1
static

Definition at line 1020 of file MSLane.h.

Referenced by GUILane::closeTraffic().

◆ CHANGE_PERMISSIONS_PERMANENT

const long MSLane::CHANGE_PERMISSIONS_PERMANENT = 0
static

◆ myApproachingLanes

std::map<MSEdge*, std::vector<MSLane*> > MSLane::myApproachingLanes
protected

All direct internal and direct (disregarding internal predecessors) non-internal predecessor lanes of this lane.

Definition at line 1157 of file MSLane.h.

Referenced by addApproachingLane(), and isApproachedFrom().

◆ myBruttoVehicleLengthSum

double MSLane::myBruttoVehicleLengthSum
protected

The current length of all vehicles on this lane, including their minGaps.

Definition at line 1147 of file MSLane.h.

Referenced by enteredByLaneChange(), executeMovements(), getBruttoOccupancy(), getBruttoVehLenSum(), incorporateVehicle(), integrateNewVehicle(), leftByLaneChange(), and removeVehicle().

◆ myCanonicalPredecessorLane

MSLane* MSLane::myCanonicalPredecessorLane
mutableprotected

Similar to LogicalPredecessorLane,.

See also
getCanonicalPredecessorLane()

Definition at line 1141 of file MSLane.h.

Referenced by getCanonicalPredecessorLane().

◆ myCanonicalSuccessorLane

MSLane* MSLane::myCanonicalSuccessorLane
mutableprotected

Main successor lane,.

See also
getCanonicalSuccessorLane()

Definition at line 1144 of file MSLane.h.

Referenced by getCanonicalSuccessorLane().

◆ myCheckJunctionCollisions

bool MSLane::myCheckJunctionCollisions
staticprivate

Definition at line 1200 of file MSLane.h.

Referenced by detectCollisions(), and initCollisionOptions().

◆ myCollisionAction

MSLane::CollisionAction MSLane::myCollisionAction
staticprivate

the action to take on collisions

Definition at line 1199 of file MSLane.h.

Referenced by detectCollisionBetween(), detectCollisions(), getCollisionAction(), handleCollisionBetween(), initCollisionOptions(), and teleportOnCollision().

◆ myCollisionStopTime

SUMOTime MSLane::myCollisionStopTime
staticprivate

Definition at line 1201 of file MSLane.h.

Referenced by handleCollisionBetween(), and initCollisionOptions().

◆ myDict

MSLane::DictType MSLane::myDict
staticprotected

Static dictionary to associate string-ids with objects.

Definition at line 1192 of file MSLane.h.

Referenced by clear(), dictionary(), dictSize(), fill(), and insertIDs().

◆ myEdge

◆ myFollowerInfo

MSLeaderInfo MSLane::myFollowerInfo
mutableprotected

followers on all sublanes as seen by vehicles on consecutive lanes (cached)

Definition at line 1162 of file MSLane.h.

Referenced by getFirstVehicleInformation().

◆ myFollowerInfoTime

SUMOTime MSLane::myFollowerInfoTime
mutableprotected

time step for which myFollowerInfo was last updated

Definition at line 1169 of file MSLane.h.

Referenced by getFirstVehicleInformation().

◆ myID

◆ myIncomingLanes

std::vector<IncomingLaneInfo> MSLane::myIncomingLanes
protected

All direct predecessor lanes.

Definition at line 1135 of file MSLane.h.

Referenced by addIncomingLane(), getCanonicalPredecessorLane(), getFollowersOnConsecutive(), getIncomingLanes(), and getLogicalPredecessorLane().

◆ myIndex

int MSLane::myIndex
protected

The lane index.

Definition at line 1077 of file MSLane.h.

Referenced by GUILane::drawMarkings(), and getIndex().

◆ myIsRampAccel

const bool MSLane::myIsRampAccel
protected

whether this lane is an acceleration lane

Definition at line 1175 of file MSLane.h.

Referenced by isAccelLane().

◆ myLeaderInfo

MSLeaderInfo MSLane::myLeaderInfo
mutableprotected

leaders on all sublanes as seen by approaching vehicles (cached)

Definition at line 1160 of file MSLane.h.

Referenced by getLastVehicleInformation().

◆ myLeaderInfoTime

SUMOTime MSLane::myLeaderInfoTime
mutableprotected

time step for which myLeaderInfo was last updated

Definition at line 1167 of file MSLane.h.

Referenced by getLastVehicleInformation().

◆ myLeaderInfoTmp

MSLeaderInfo MSLane::myLeaderInfoTmp
mutableprotected

Definition at line 1164 of file MSLane.h.

Referenced by getFirstVehicleInformation(), and getLastVehicleInformation().

◆ myLength

◆ myLengthGeometryFactor

const double MSLane::myLengthGeometryFactor
protected

◆ myLinks

◆ myLogicalPredecessorLane

MSLane* MSLane::myLogicalPredecessorLane
mutableprotected

Definition at line 1138 of file MSLane.h.

Referenced by getLogicalPredecessorLane().

◆ myMaxSpeed

double MSLane::myMaxSpeed
protected

Lane-wide speedlimit [m/s].

Definition at line 1123 of file MSLane.h.

Referenced by GUILane::getColorValue(), getMeanSpeed(), GUILane::getScaleValue(), getSpeedLimit(), getVehicleMaxSpeed(), and setMaxSpeed().

◆ myMoveReminders

std::vector< MSMoveReminder* > MSLane::myMoveReminders
private

This lane's move reminder.

Definition at line 1196 of file MSLane.h.

Referenced by addMoveReminder(), and getMoveReminders().

◆ myNeighs

std::vector<std::string> MSLane::myNeighs
protected

Definition at line 1183 of file MSLane.h.

Referenced by addNeigh(), getOpposite(), and integrateNewVehicle().

◆ myNettoVehicleLengthSum

double MSLane::myNettoVehicleLengthSum
protected

The current length of all vehicles on this lane, excluding their minGaps.

Definition at line 1150 of file MSLane.h.

Referenced by enteredByLaneChange(), executeMovements(), getNettoOccupancy(), incorporateVehicle(), integrateNewVehicle(), leftByLaneChange(), and removeVehicle().

◆ myNumericalID

int MSLane::myNumericalID
protected

Unique numerical ID (set on reading by netload)

Definition at line 1071 of file MSLane.h.

Referenced by getNumericalID().

◆ myOriginalPermissions

SVCPermissions MSLane::myOriginalPermissions
protected

The original vClass permissions for this lane (before temporary modifications)

Definition at line 1129 of file MSLane.h.

Referenced by resetPermissions(), and setPermissions().

◆ myPartialVehicles

VehCont MSLane::myPartialVehicles
protected

The lane's partial vehicles. This container holds all vehicles that are partially on this lane but which are in myVehicles of another lane. Reasons for partial occupancie include the following.

  • the back is still on this lane during regular movement
  • the vehicle is performing a continuous lane-change maneuver
  • sub-lane simulation where vehicles can freely move laterally among the lanes of an edge

The entering vehicles are inserted at the front of this container and the leaving ones leave from the back.

Definition at line 1102 of file MSLane.h.

Referenced by anyVehiclesBegin(), anyVehiclesEnd(), anyVehiclesUpstreamBegin(), detectCollisions(), freeInsertion(), getBruttoOccupancy(), getFirstAnyVehicle(), getLastAnyVehicle(), getLeaderOnConsecutive(), getLeadersOnConsecutive(), getNettoOccupancy(), getPartialBehind(), getPartialVehicleNumber(), MSLaneChanger::getRealLeader(), getVehicleNumberWithPartials(), integrateNewVehicle(), isEmpty(), MSLane::AnyVehicleIterator::nextIsMyVehicles(), MSLane::AnyVehicleIterator::operator*(), planMovements(), resetPartialOccupation(), setPartialOccupation(), and sortPartialVehicles().

◆ myPermissionChanges

std::map<long, SVCPermissions> MSLane::myPermissionChanges
protected

◆ myPermissions

◆ myRestrictions

const std::map<SUMOVehicleClass, double>* MSLane::myRestrictions
protected

The vClass speed restrictions for this lane.

Definition at line 1132 of file MSLane.h.

Referenced by getVehicleMaxSpeed(), and initRestrictions().

◆ myRightmostSublane

int MSLane::myRightmostSublane
protected

the index of the rightmost sublane of this lane on myEdge

Definition at line 1180 of file MSLane.h.

Referenced by getRightmostSublane(), and setRightSideOnEdge().

◆ myRightSideOnEdge

double MSLane::myRightSideOnEdge
protected

the combined width of all lanes with lower index on myEdge

Definition at line 1178 of file MSLane.h.

Referenced by getCenterOnEdge(), getRightSideOnEdge(), and setRightSideOnEdge().

◆ myShape

◆ myTmpVehicles

VehCont MSLane::myTmpVehicles
protected

Container for lane-changing vehicles. After completion of lane-change- process, the containers will be swapped with myVehicles.

Definition at line 1106 of file MSLane.h.

Referenced by getLeader(), and swapAfterLaneChange().

◆ myVehBuffer

VehCont MSLane::myVehBuffer
protected

Buffer for vehicles that moved from their previous lane onto this one. Integrated after all vehicles executed their moves.

Definition at line 1110 of file MSLane.h.

Referenced by empty(), executeMovements(), integrateNewVehicle(), and MSXMLRawOut::writeLane().

◆ myVehicles

VehCont MSLane::myVehicles
protected

The lane's vehicles. This container holds all vehicles that have their front (longitudinally) and their center (laterally) on this lane. These are the vehicles that this lane is 'responsibly' for (i.e. when executing movements)

The entering vehicles are inserted at the front of this container and the leaving ones leave from the back, e.g. the vehicle in front of the junction (often called first) is myVehicles.back() (if it exists). And if it is an iterator at a vehicle, ++it points to the vehicle in front. This is the interaction vehicle.

Definition at line 1090 of file MSLane.h.

Referenced by addMoveReminder(), anyVehiclesBegin(), anyVehiclesEnd(), anyVehiclesUpstreamBegin(), detectCollisions(), empty(), executeMovements(), GUILane::firstWaitingTime(), forceVehicleInsertion(), freeInsertion(), getBruttoOccupancy(), getFirstAnyVehicle(), getFirstFullVehicle(), getLastAnyVehicle(), getLastFullVehicle(), getLeader(), getMeanSpeed(), getNettoOccupancy(), getVehicleNumber(), getVehicleNumberWithPartials(), GUILane::getVehiclesSecure(), getVehiclesSecure(), getWaitingSeconds(), incorporateVehicle(), integrateNewVehicle(), isEmpty(), isInsertionSuccess(), loadState(), MSLane::AnyVehicleIterator::nextIsMyVehicles(), MSLane::AnyVehicleIterator::operator*(), planMovements(), removeVehicle(), saveState(), swapAfterLaneChange(), MSQueueExport::writeLane(), and MSXMLRawOut::writeLane().

◆ myWidth


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