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

Stores edges and lanes, performs moving of vehicle. More...

#include <MSEdgeControl.h>

Data Structures

struct  LaneUsage
 A structure holding some basic information about a simulated lane. More...

Public Types

typedef std::vector< MSEdge * > EdgeCont
 Container for edges.

Public Member Functions

void changeLanes (SUMOTime t)
 Moves (precomputes) critical vehicles.
void detectCollisions (SUMOTime timestep)
 Detect collisions.
std::vector< std::string > getEdgeNames () const
 Returns the list of names of all known edges.
const std::vector< MSEdge * > & getEdges () const
 Returns loaded edges.
void gotActive (MSLane *l)
 Informs the control that the given lane got active.
 MSEdgeControl (const std::vector< MSEdge * > &edges)
 Constructor.
void patchActiveLanes ()
 Resets information whether a lane is active for all lanes.
 ~MSEdgeControl ()
 Destructor.
Interfaces for longitudinal vehicle movement
void moveCritical (SUMOTime t)
 Moves (precomputes) critical vehicles.
void moveFirst (SUMOTime t)
 Really moves critical vehicles.

Private Types

typedef std::vector< LaneUsageLaneUsageVector
 Definition of a container about a lane's number of vehicles and neighbors.

Private Member Functions

 MSEdgeControl (const MSEdgeControl &)
 Copy constructor.
MSEdgeControloperator= (const MSEdgeControl &)
 Assignment operator.

Private Attributes

std::list< MSLane * > myActiveLanes
 The list of active (not empty) lanes.
std::set< MSLane
*, Named::ComparatorIdLess
myChangedStateLanes
 Lanes which changed the state without informing the control.
std::vector< MSEdge * > myEdges
 Loaded edges.
LaneUsageVector myLanes
 Information about lanes' number of vehicles and neighbors.
std::vector< SUMOTimemyLastLaneChange
 The list of active (not empty) lanes.
std::vector< MSLane * > myWithVehicles2Integrate
 A storage for lanes which shall be integrated because vehicles have moved onto them.

Detailed Description

Stores edges and lanes, performs moving of vehicle.

In order to avoid touching all lanes, even the empty ones, this class stores and updates the information about "active" lanes, those that have at least one vehicle on them. During longitudinal movement, this can be simply achieved through return values of the MSLane-methods, signalling either that the lane got active or inactive. This is but not possible when changing lanes, we have to go through the lanes, here. Also, we have to add lanes on which a vehicle was inserted, separately, doing this into ("myChangedStateLanes") which entries are integrated at the begin of is step in "patchActiveLanes".

Definition at line 74 of file MSEdgeControl.h.


Member Typedef Documentation

typedef std::vector< MSEdge* > MSEdgeControl::EdgeCont

Container for edges.

Definition at line 77 of file MSEdgeControl.h.

typedef std::vector<LaneUsage> MSEdgeControl::LaneUsageVector
private

Definition of a container about a lane's number of vehicles and neighbors.

Definition at line 220 of file MSEdgeControl.h.


Constructor & Destructor Documentation

MSEdgeControl::MSEdgeControl ( const std::vector< MSEdge * > &  edges)

Constructor.

Builds LaneUsage information for each lane and assigns them to lanes.

Parameters:
[in]edgesThe loaded edges
Todo:
Assure both containers are not 0

Definition at line 48 of file MSEdgeControl.cpp.

References myEdges, myLanes, and myLastLaneChange.

MSEdgeControl::~MSEdgeControl ( )

Destructor.

Definition at line 78 of file MSEdgeControl.cpp.

MSEdgeControl::MSEdgeControl ( const MSEdgeControl )
private

Copy constructor.


Member Function Documentation

void MSEdgeControl::changeLanes ( SUMOTime  t)

Moves (precomputes) critical vehicles.

Calls "changeLanes" of each of the multi-lane edges. Check then for this edge whether a lane got active, adding it to "myActiveLanes" and marking it as active in such cases.

See also:
MSEdge::changeLanes

Definition at line 141 of file MSEdgeControl.cpp.

References MSEdgeControl::LaneUsage::amActive, MSEdge::changeLanes(), MSEdge::getLanes(), MSEdge::getNumericalID(), MSEdgeControl::LaneUsage::haveNeighbors, myActiveLanes, myLanes, and myLastLaneChange.

Referenced by MSNet::simulationStep().

void MSEdgeControl::detectCollisions ( SUMOTime  timestep)

Detect collisions.

Calls "detectCollisions" of each lane. Shouldn't be necessary if model-implementation is correct. The parameter is simply passed to the lane-instance for reporting.

Parameters:
[in]timestepThe current time step

Definition at line 171 of file MSEdgeControl.cpp.

References myActiveLanes.

Referenced by MSNet::simulationStep().

std::vector< std::string > MSEdgeControl::getEdgeNames ( ) const

Returns the list of names of all known edges.

Returns:
a vector of names of all known edges

Definition at line 180 of file MSEdgeControl.cpp.

References myEdges.

Referenced by TraCIServerAPI_Simulation::convertCartesianToRoadMap().

const std::vector<MSEdge*>& MSEdgeControl::getEdges ( ) const
inline

Returns loaded edges.

Returns:
the container storing one-lane edges
Todo:
Check: Is this secure?

Definition at line 170 of file MSEdgeControl.h.

References myEdges.

Referenced by MSDevice_Routing::adaptEdgeEfforts(), MSDevice_Routing::buildVehicleDevices(), MSMeanData::init(), and MSXMLRawOut::write().

void MSEdgeControl::gotActive ( MSLane l)

Informs the control that the given lane got active.

Parameters:
[in]lThe activated lane
Todo:
Check for l==0?

Definition at line 190 of file MSEdgeControl.cpp.

References myChangedStateLanes.

Referenced by MSLane::incorporateVehicle().

void MSEdgeControl::moveCritical ( SUMOTime  t)

Moves (precomputes) critical vehicles.

"Critical" are those vehicles that interact with the next junction and all first vehicles. They are not moved, in fact, but their speed along the next path is precomputed.

This method goes through all active lanes calling their "moveCritical" implementation. If this call returns true, the lane is removed from the list of active lanes.

See also:
MSLane::moveCritical

Definition at line 101 of file MSEdgeControl.cpp.

References myActiveLanes, and myLanes.

Referenced by MSNet::simulationStep().

void MSEdgeControl::moveFirst ( SUMOTime  t)

Really moves critical vehicles.

"Critical" are those vehicles that interact with the next junction and all first vehicles.

At first, this method goes through all active lanes calling their "setCritical" implementation. If this call returns true, the lane is removed from the list of active lanes. During this call, "myWithVehicles2Integrate" is filled with lanes that obtain new vehicles.

Then, myWithVehicles2Integrate is gone through, calling "integrateNewVehicle" of each of the stored instances. If this call returns true and the lane was not active before, it is added to the list of active lanes.

See also:
MSLane::setCritical
MSLane::integrateNewVehicle
Todo:
When moving to parallel processing, the usage of myWithVehicles2Integrate would get insecure!!

Definition at line 114 of file MSEdgeControl.cpp.

References MSEdgeControl::LaneUsage::amActive, MSEdgeControl::LaneUsage::haveNeighbors, myActiveLanes, myLanes, and myWithVehicles2Integrate.

Referenced by MSNet::simulationStep().

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

Assignment operator.

void MSEdgeControl::patchActiveLanes ( )

Resets information whether a lane is active for all lanes.

For each lane in "myChangedStateLanes": if the lane has at least one vehicle and is not marked as being active, it is added to the list og active lanes and marked as being active.

Definition at line 83 of file MSEdgeControl.cpp.

References MSEdgeControl::LaneUsage::amActive, MSEdgeControl::LaneUsage::haveNeighbors, myActiveLanes, myChangedStateLanes, and myLanes.

Referenced by MSNet::simulationStep().


Field Documentation

std::list<MSLane*> MSEdgeControl::myActiveLanes
private

The list of active (not empty) lanes.

Definition at line 226 of file MSEdgeControl.h.

Referenced by changeLanes(), detectCollisions(), moveCritical(), moveFirst(), and patchActiveLanes().

std::set<MSLane*, Named::ComparatorIdLess> MSEdgeControl::myChangedStateLanes
private

Lanes which changed the state without informing the control.

Definition at line 232 of file MSEdgeControl.h.

Referenced by gotActive(), and patchActiveLanes().

std::vector<MSEdge*> MSEdgeControl::myEdges
private

Loaded edges.

Definition at line 217 of file MSEdgeControl.h.

Referenced by getEdgeNames(), getEdges(), and MSEdgeControl().

LaneUsageVector MSEdgeControl::myLanes
private

Information about lanes' number of vehicles and neighbors.

Definition at line 223 of file MSEdgeControl.h.

Referenced by changeLanes(), moveCritical(), moveFirst(), MSEdgeControl(), and patchActiveLanes().

std::vector<SUMOTime> MSEdgeControl::myLastLaneChange
private

The list of active (not empty) lanes.

Definition at line 235 of file MSEdgeControl.h.

Referenced by changeLanes(), and MSEdgeControl().

std::vector<MSLane*> MSEdgeControl::myWithVehicles2Integrate
private

A storage for lanes which shall be integrated because vehicles have moved onto them.

Definition at line 229 of file MSEdgeControl.h.

Referenced by moveFirst().


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