SUMO - Simulation of Urban MObility
MSVehicleControl Class Reference

The class responsible for building and deletion of vehicles. More...

#include <MSVehicleControl.h>

Inheritance diagram for MSVehicleControl:
Inheritance graph
Collaboration diagram for MSVehicleControl:
Collaboration graph

Public Types

typedef std::map< std::string, SUMOVehicle * >::const_iterator constVehIt
 Definition of the internal vehicles map iterator. More...
 

Public Member Functions

void abortWaiting ()
 informes about all waiting vehicles (deletion in destructor) More...
 
void addWaiting (const MSEdge *const edge, SUMOVehicle *vehicle)
 Adds a vehicle to the list of waiting vehiclse to a given edge. More...
 
SUMOTime computeRandomDepartOffset () const
 compute (optional) random offset to the departure time More...
 
void discountStateLoaded (bool removed=false)
 avoid counting a vehicle twice if it was loaded from state and route input More...
 
double getMaxSpeedFactor () const
 return the maximum speed factor for all vehicles that ever entered the network More...
 
double getMinDeceleration () const
 return the minimum deceleration capability for all vehicles that ever entered the network More...
 
SUMOVehiclegetWaitingVehicle (const MSEdge *const edge, const std::set< std::string > &lines, const double position, const std::string ridingID)
 
 MSVehicleControl ()
 Constructor. More...
 
void registerCollision ()
 registers one collision-related teleport More...
 
void registerEmergencyStop ()
 register emergency stop More...
 
void registerOneWaitingForContainer ()
 increases the count of vehicles waiting for a container to allow recogniztion of container related deadlocks More...
 
void registerOneWaitingForPerson ()
 increases the count of vehicles waiting for a person to allow recogniztion of person related deadlocks More...
 
void registerTeleportJam ()
 register one non-collision-related teleport More...
 
void registerTeleportWrongLane ()
 register one non-collision-related teleport More...
 
void registerTeleportYield ()
 register one non-collision-related teleport More...
 
void removeWaiting (const MSEdge *const edge, SUMOVehicle *vehicle)
 Removes a vehicle from the list of waiting vehicles to a given edge. More...
 
void unregisterOneWaitingForContainer ()
 decreases the count of vehicles waiting for a container to allow recogniztion of container related deadlocks More...
 
void unregisterOneWaitingForPerson ()
 decreases the count of vehicles waiting for a person to allow recogniztion of person related deadlocks More...
 
virtual ~MSVehicleControl ()
 Destructor. More...
 
Vehicle creation
virtual SUMOVehiclebuildVehicle (SUMOVehicleParameter *defs, const MSRoute *route, const MSVehicleType *type, const bool ignoreStopErrors, const bool fromRouteFile=true)
 Builds a vehicle, increases the number of built vehicles. More...
 
Insertion, deletion and retrieval of vehicles
virtual bool addVehicle (const std::string &id, SUMOVehicle *v)
 Tries to insert the vehicle into the internal vehicle container. More...
 
SUMOVehiclegetVehicle (const std::string &id) const
 Returns the vehicle with the given id. More...
 
virtual void deleteVehicle (SUMOVehicle *v, bool discard=false)
 Deletes the vehicle. More...
 
void scheduleVehicleRemoval (SUMOVehicle *veh)
 Removes a vehicle after it has ended. More...
 
constVehIt loadedVehBegin () const
 Returns the begin of the internal vehicle map. More...
 
constVehIt loadedVehEnd () const
 Returns the end of the internal vehicle map. More...
 
Setting vehicle statistics
void vehicleDeparted (const SUMOVehicle &v)
 Informs this control about a vehicle's departure. More...
 
Retrieval of vehicle statistics (always accessable)
int getLoadedVehicleNo () const
 Returns the number of build vehicles. More...
 
int getEndedVehicleNo () const
 Returns the number of removed vehicles. More...
 
int getRunningVehicleNo () const
 Returns the number of build and inserted, but not yet deleted vehicles. More...
 
int getDepartedVehicleNo () const
 Returns the number of inserted vehicles. More...
 
int getQuota (double frac=-1) const
 Returns the number of instances of the current vehicle that shall be emitted considering that "frac" of all vehicles shall be emitted overall if a negative fraction is given the demand scaling factor is used (–scale) More...
 
int getActiveVehicleCount () const
 Returns the number of build vehicles that have not been removed or need to wait for a passenger or a container. More...
 
int getCollisionCount () const
 return the number of collisions More...
 
int getTeleportsJam () const
 return the number of teleports due to jamming More...
 
int getTeleportsYield () const
 return the number of teleports due to vehicles stuck on a minor road More...
 
int getTeleportsWrongLane () const
 return the number of teleports due to vehicles stuck on the wrong lane More...
 
int getTeleportCount () const
 return the number of teleports (including collisions) More...
 
int getEmergencyStops () const
 return the number of emergency stops More...
 
double getTotalDepartureDelay () const
 Returns the total departure delay. More...
 
double getTotalTravelTime () const
 Returns the total travel time. More...
 
Insertion and retrieval of vehicle types
bool addVType (MSVehicleType *vehType)
 Adds a vehicle type. More...
 
void removeVType (const MSVehicleType *vehType)
 
bool addVTypeDistribution (const std::string &id, RandomDistributor< MSVehicleType *> *vehTypeDistribution)
 Adds a vehicle type distribution. More...
 
bool hasVTypeDistribution (const std::string &id) const
 Asks for a vehicle type distribution. More...
 
MSVehicleTypegetVType (const std::string &id=DEFAULT_VTYPE_ID, MTRand *rng=0)
 Returns the named vehicle type or a sample from the named distribution. More...
 
void insertVTypeIDs (std::vector< std::string > &into) const
 Inserts ids of all known vehicle types and vehicle type distributions to the given vector. More...
 
State I/O
void setState (int runningVehNo, int loadedVehNo, int endedVehNo, double totalDepartureDelay, double totalTravelTime)
 Sets the current state variables as loaded from the stream. More...
 
void saveState (OutputDevice &out)
 Saves the current state into the given stream. More...
 

Protected Attributes

Vehicle statistics (always accessable)
int myLoadedVehNo
 The number of build vehicles. More...
 
int myRunningVehNo
 The number of vehicles within the network (build and inserted but not removed) More...
 
int myEndedVehNo
 The number of removed vehicles. More...
 
int myDiscarded
 The number of vehicles which were discarded while loading. More...
 
int myCollisions
 The number of collisions. More...
 
int myTeleportsJam
 The number of teleports due to jam. More...
 
int myTeleportsYield
 The number of teleports due to vehicles stuck on a minor road. More...
 
int myTeleportsWrongLane
 The number of teleports due to vehicles stuck on the wrong lane. More...
 
int myEmergencyStops
 The number of emergency stops. More...
 
Vehicle statistics
double myTotalDepartureDelay
 The aggregated time vehicles had to wait for departure (in seconds) More...
 
double myTotalTravelTime
 The aggregated time vehicles needed to aacomplish their route (in seconds) More...
 

Private Member Functions

bool checkVType (const std::string &id)
 Checks whether the vehicle type (distribution) may be added. More...
 

Vehicle container

typedef std::map< std::string, SUMOVehicle *> VehicleDictType
 Vehicle dictionary type. More...
 
VehicleDictType myVehicleDict
 Dictionary of vehicles. More...
 

Vehicle type container

typedef std::map< std::string, MSVehicleType *> VTypeDictType
 Vehicle type dictionary type. More...
 
typedef std::map< std::string, RandomDistributor< MSVehicleType * > *> VTypeDistDictType
 Vehicle type distribution dictionary type. More...
 
VTypeDictType myVTypeDict
 Dictionary of vehicle types. More...
 
VTypeDistDictType myVTypeDistDict
 A distribution of vehicle types (probability->vehicle type) More...
 
bool myDefaultVTypeMayBeDeleted
 Whether no vehicle type was loaded. More...
 
bool myDefaultPedTypeMayBeDeleted
 Whether no pedestrian type was loaded. More...
 
std::map< const MSEdge *const, std::vector< SUMOVehicle * > > myWaiting
 the lists of waiting vehicles to a given edge More...
 
int myWaitingForPerson
 the number of vehicles wainting for persons contained in myWaiting which can only continue by being triggered More...
 
int myWaitingForContainer
 the number of vehicles wainting for containers contained in myWaiting which can only continue by being triggered More...
 
double myScale
 The scaling factor (especially for inc-dua) More...
 
SUMOTime myMaxRandomDepartOffset
 The maximum random offset to be added to vehicles departure times (non-negative) More...
 
double myMaxSpeedFactor
 The maximum speed factor for all vehicles in the network. More...
 
double myMinDeceleration
 The minimum deceleration capability for all vehicles in the network. More...
 
 MSVehicleControl (const MSVehicleControl &s)
 invalidated copy constructor More...
 
MSVehicleControloperator= (const MSVehicleControl &s)
 invalidated assignment operator More...
 

Detailed Description

The class responsible for building and deletion of vehicles.

This class is responsible for vehicle building and deletion. It stores vehicle types, vehicles and statistics about the last.

This class also realizes the tripinfos and the vehroutes - outputs, both generated when a vehicle is removed from the simulation, see scheduleVehicleRemoval.

Use this class for the pure microsim and GUIVehicleControl within the gui.

See also
GUIVehicleControl

Definition at line 74 of file MSVehicleControl.h.

Member Typedef Documentation

◆ constVehIt

typedef std::map<std::string, SUMOVehicle*>::const_iterator MSVehicleControl::constVehIt

Definition of the internal vehicles map iterator.

Definition at line 77 of file MSVehicleControl.h.

◆ VehicleDictType

typedef std::map< std::string, SUMOVehicle* > MSVehicleControl::VehicleDictType
protected

Vehicle dictionary type.

Definition at line 520 of file MSVehicleControl.h.

◆ VTypeDictType

typedef std::map< std::string, MSVehicleType* > MSVehicleControl::VTypeDictType
protected

Vehicle type dictionary type.

Definition at line 530 of file MSVehicleControl.h.

◆ VTypeDistDictType

typedef std::map< std::string, RandomDistributor<MSVehicleType*>* > MSVehicleControl::VTypeDistDictType
protected

Vehicle type distribution dictionary type.

Definition at line 535 of file MSVehicleControl.h.

Constructor & Destructor Documentation

◆ MSVehicleControl() [1/2]

◆ ~MSVehicleControl()

MSVehicleControl::~MSVehicleControl ( )
virtual

Destructor.

Definition at line 80 of file MSVehicleControl.cpp.

References myVehicleDict, myVTypeDict, and myVTypeDistDict.

◆ MSVehicleControl() [2/2]

MSVehicleControl::MSVehicleControl ( const MSVehicleControl s)
private

invalidated copy constructor

Member Function Documentation

◆ abortWaiting()

void MSVehicleControl::abortWaiting ( )

informes about all waiting vehicles (deletion in destructor)

Definition at line 366 of file MSVehicleControl.cpp.

References myVehicleDict, and WRITE_WARNING.

Referenced by discountStateLoaded(), and MSNet::simulationState().

◆ addVehicle()

bool MSVehicleControl::addVehicle ( const std::string &  id,
SUMOVehicle v 
)
virtual

Tries to insert the vehicle into the internal vehicle container.

Checks whether another vehicle with the same id exists; returns false if so. Otherwise, the vehicle is added to "myVehicleDict" and true is returned.

The vehicle control gets responsible for vehicle deletion.

Parameters
[in]idThe id of the vehicle
[in]vThe vehicle
Returns
Whether the vehicle could be inserted (no other vehicle with the same id was inserted before)

Reimplemented in GUIVehicleControl, and GUIMEVehicleControl.

Definition at line 186 of file MSVehicleControl.cpp.

References myVehicleDict.

Referenced by GUIMEVehicleControl::addVehicle(), GUIVehicleControl::addVehicle(), MSRouteHandler::closeVehicle(), MSInsertionControl::determineCandidates(), MSCalibrator::execute(), TraCIServerAPI_Vehicle::processSet(), and METriggeredCalibrator::tryEmit().

◆ addVType()

bool MSVehicleControl::addVType ( MSVehicleType vehType)

Adds a vehicle type.

If another vehicle type (or distribution) with the same id exists, false is returned. Otherwise, the vehicle type is added to the internal vehicle type container "myVTypeDict".

This control get responsible for deletion of the added vehicle type.

Parameters
[in]vehTypeThe vehicle type to add
Returns
Whether the vehicle type could be added

Definition at line 247 of file MSVehicleControl.cpp.

References checkVType(), MSVehicleType::getID(), and myVTypeDict.

Referenced by getTotalTravelTime().

◆ addVTypeDistribution()

bool MSVehicleControl::addVTypeDistribution ( const std::string &  id,
RandomDistributor< MSVehicleType *> *  vehTypeDistribution 
)

Adds a vehicle type distribution.

If another vehicle type (or distribution) with the same id exists, false is returned. Otherwise, the vehicle type distribution is added to the internal vehicle type distribution container "myVTypeDistDict".

This control get responsible for deletion of the added vehicle type distribution.

Parameters
[in]idThe id of the distribution to add
[in]vehTypeDistributionThe vehicle type distribution to add
Returns
Whether the vehicle type could be added

Definition at line 266 of file MSVehicleControl.cpp.

References checkVType(), and myVTypeDistDict.

Referenced by getTotalTravelTime().

◆ addWaiting()

void MSVehicleControl::addWaiting ( const MSEdge *const  edge,
SUMOVehicle vehicle 
)

Adds a vehicle to the list of waiting vehiclse to a given edge.

Definition at line 313 of file MSVehicleControl.cpp.

References myWaiting.

Referenced by MSRouteHandler::closeVehicle(), getTotalTravelTime(), and MSVehicle::processNextStop().

◆ buildVehicle()

SUMOVehicle * MSVehicleControl::buildVehicle ( SUMOVehicleParameter defs,
const MSRoute route,
const MSVehicleType type,
const bool  ignoreStopErrors,
const bool  fromRouteFile = true 
)
virtual

Builds a vehicle, increases the number of built vehicles.

Builds a MSVehicle instance using the given parameter. Increases the number of loaded vehicles ("myLoadedVehNo").

Parameters
[in]defsThe parameter defining the vehicle
[in]routeThe route of this vehicle
[in]typeThe type of this vehicle
[in]ignoreStopErrorswhether invalid stops trigger a warning only
[in]fromRouteFilewhether we are just reading the route file or creating via trigger, traci, ...
Returns
The built vehicle (MSVehicle instance)

Reimplemented in GUIVehicleControl, GUIMEVehicleControl, and MEVehicleControl.

Definition at line 109 of file MSVehicleControl.cpp.

References MSBaseVehicle::addStops(), MSVehicleType::computeChosenSpeedDeviation(), computeRandomDepartOffset(), SUMOVehicleParameter::depart, MSNet::getInstance(), MSRouteHandler::getParsingRNG(), MSNet::informVehicleStateListener(), myLoadedVehNo, and MSNet::VEHICLE_STATE_BUILT.

Referenced by MSRouteHandler::closeVehicle(), MSInsertionControl::determineCandidates(), METriggeredCalibrator::execute(), MSCalibrator::execute(), and TraCIServerAPI_Vehicle::processSet().

◆ checkVType()

bool MSVehicleControl::checkVType ( const std::string &  id)
private

Checks whether the vehicle type (distribution) may be added.

This method checks also whether the default type may still be replaced

Parameters
[in]idThe id of the vehicle type (distribution) to add
Returns
Whether the type (distribution) may be added

Definition at line 221 of file MSVehicleControl.cpp.

References DEFAULT_PEDTYPE_ID, DEFAULT_VTYPE_ID, myDefaultPedTypeMayBeDeleted, myDefaultVTypeMayBeDeleted, myVTypeDict, and myVTypeDistDict.

Referenced by addVType(), addVTypeDistribution(), and getMinDeceleration().

◆ computeRandomDepartOffset()

SUMOTime MSVehicleControl::computeRandomDepartOffset ( ) const

◆ deleteVehicle()

◆ discountStateLoaded()

void MSVehicleControl::discountStateLoaded ( bool  removed = false)
inline

avoid counting a vehicle twice if it was loaded from state and route input

Definition at line 434 of file MSVehicleControl.h.

References abortWaiting(), computeRandomDepartOffset(), myDiscarded, myEndedVehNo, myLoadedVehNo, and myRunningVehNo.

Referenced by MSStateHandler::closeVehicle(), and MSInsertionControl::determineCandidates().

◆ getActiveVehicleCount()

int MSVehicleControl::getActiveVehicleCount ( ) const
inline

Returns the number of build vehicles that have not been removed or need to wait for a passenger or a container.

Returns
Number of active vehicles

Definition at line 243 of file MSVehicleControl.h.

References myEndedVehNo, myLoadedVehNo, myWaitingForContainer, and myWaitingForPerson.

Referenced by MSNet::simulationState().

◆ getCollisionCount()

int MSVehicleControl::getCollisionCount ( ) const
inline

return the number of collisions

Definition at line 249 of file MSVehicleControl.h.

References myCollisions.

Referenced by GUIApplicationWindow::checkGamingEvents(), MSNet::closeSimulation(), and GUINet::getParameterWindow().

◆ getDepartedVehicleNo()

int MSVehicleControl::getDepartedVehicleNo ( ) const
inline

Returns the number of inserted vehicles.

Returns
The number of vehicles that have entered the simulation so far

Definition at line 225 of file MSVehicleControl.h.

References getQuota(), myDiscarded, myEndedVehNo, and myRunningVehNo.

Referenced by MSNet::closeSimulation(), GUINet::getParameterWindow(), MSNet::postSimStepOutput(), and MSNet::writeOutput().

◆ getEmergencyStops()

int MSVehicleControl::getEmergencyStops ( ) const
inline

return the number of emergency stops

Definition at line 272 of file MSVehicleControl.h.

References myEmergencyStops.

Referenced by MSNet::closeSimulation().

◆ getEndedVehicleNo()

int MSVehicleControl::getEndedVehicleNo ( ) const
inline

Returns the number of removed vehicles.

Returns
The number of vehicles that have left the simulation

Definition at line 209 of file MSVehicleControl.h.

References myEndedVehNo.

Referenced by GUINet::getParameterWindow(), and MSNet::writeOutput().

◆ getLoadedVehicleNo()

int MSVehicleControl::getLoadedVehicleNo ( ) const
inline

Returns the number of build vehicles.

Returns
The number of loaded (build) vehicles

Definition at line 201 of file MSVehicleControl.h.

References myLoadedVehNo.

Referenced by MSNet::closeSimulation(), GUINet::getParameterWindow(), and MSNet::writeOutput().

◆ getMaxSpeedFactor()

double MSVehicleControl::getMaxSpeedFactor ( ) const
inline

return the maximum speed factor for all vehicles that ever entered the network

Definition at line 453 of file MSVehicleControl.h.

References myMaxSpeedFactor.

Referenced by MSLane::getMaximumBrakeDist().

◆ getMinDeceleration()

double MSVehicleControl::getMinDeceleration ( ) const
inline

return the minimum deceleration capability for all vehicles that ever entered the network

Definition at line 458 of file MSVehicleControl.h.

References checkVType(), and myMinDeceleration.

Referenced by MSLane::getMaximumBrakeDist().

◆ getQuota()

int MSVehicleControl::getQuota ( double  frac = -1) const

Returns the number of instances of the current vehicle that shall be emitted considering that "frac" of all vehicles shall be emitted overall if a negative fraction is given the demand scaling factor is used (–scale)

Returns
the number of vehicles to create (something between 0 and ceil(frac))

Definition at line 374 of file MSVehicleControl.cpp.

References myLoadedVehNo, and myScale.

Referenced by MSRouteHandler::closeVehicle(), MSInsertionControl::determineCandidates(), MSDevice::equippedByDefaultAssignmentOptions(), and getDepartedVehicleNo().

◆ getRunningVehicleNo()

int MSVehicleControl::getRunningVehicleNo ( ) const
inline

Returns the number of build and inserted, but not yet deleted vehicles.

Returns
The number simulated vehicles (including those in teleporter)

Definition at line 217 of file MSVehicleControl.h.

References myRunningVehNo.

Referenced by MSNet::closeSimulation(), GUINet::getParameterWindow(), GUIApplicationWindow::handleEvent_SimulationStep(), MSNet::postSimStepOutput(), GUINet::setSimDuration(), MSNet::simulationStep(), and MSNet::writeOutput().

◆ getTeleportCount()

int MSVehicleControl::getTeleportCount ( ) const

◆ getTeleportsJam()

int MSVehicleControl::getTeleportsJam ( ) const
inline

return the number of teleports due to jamming

Definition at line 254 of file MSVehicleControl.h.

References myTeleportsJam.

Referenced by MSNet::closeSimulation().

◆ getTeleportsWrongLane()

int MSVehicleControl::getTeleportsWrongLane ( ) const
inline

return the number of teleports due to vehicles stuck on the wrong lane

Definition at line 264 of file MSVehicleControl.h.

References getTeleportCount(), and myTeleportsWrongLane.

Referenced by MSNet::closeSimulation().

◆ getTeleportsYield()

int MSVehicleControl::getTeleportsYield ( ) const
inline

return the number of teleports due to vehicles stuck on a minor road

Definition at line 259 of file MSVehicleControl.h.

References myTeleportsYield.

Referenced by MSNet::closeSimulation().

◆ getTotalDepartureDelay()

double MSVehicleControl::getTotalDepartureDelay ( ) const
inline

Returns the total departure delay.

Returns
Sum of steps vehicles had to wait until being inserted

Definition at line 280 of file MSVehicleControl.h.

References myTotalDepartureDelay.

Referenced by MSNet::writeOutput().

◆ getTotalTravelTime()

double MSVehicleControl::getTotalTravelTime ( ) const
inline

Returns the total travel time.

Returns
Sum of travel times of arrived vehicles

Definition at line 288 of file MSVehicleControl.h.

References addVType(), addVTypeDistribution(), addWaiting(), DEFAULT_VTYPE_ID, getVType(), getWaitingVehicle(), hasVTypeDistribution(), insertVTypeIDs(), myTotalTravelTime, removeVType(), and removeWaiting().

Referenced by MSNet::writeOutput().

◆ getVehicle()

SUMOVehicle * MSVehicleControl::getVehicle ( const std::string &  id) const

Returns the vehicle with the given id.

If no vehicle with the given id is store din "myVehicleDict", 0 is returned.

Parameters
[in]idThe id of the vehicle to retrieve
Returns
The vehicle with the given id, 0 if no such vehicle exists

Definition at line 198 of file MSVehicleControl.cpp.

References myVehicleDict.

Referenced by MSStateHandler::closeVehicle(), MSRouteHandler::closeVehicle(), MSInsertionControl::determineCandidates(), TraCIServerAPI_Vehicle::getPosition(), TraCI_Vehicle::getVehicle(), MSVehicleTransfer::loadState(), MESegment::loadState(), MSLane::loadState(), TraCI_Vehicle::onInit(), TraCIServer::postProcessVTD(), TraCIServerAPI_GUI::processSet(), TraCIServerAPI_Vehicle::processSet(), MSCalibrator::removePending(), and GUINet::vehicleExists().

◆ getVType()

◆ getWaitingVehicle()

SUMOVehicle * MSVehicleControl::getWaitingVehicle ( const MSEdge *const  edge,
const std::set< std::string > &  lines,
const double  position,
const std::string  ridingID 
)

◆ hasVTypeDistribution()

bool MSVehicleControl::hasVTypeDistribution ( const std::string &  id) const

Asks for a vehicle type distribution.

If vehicle type distribution with the id exists, true is returned, false otherwise.

Parameters
[in]idThe id of the distribution
Returns
Whether the vehicle type distribution exists

Definition at line 276 of file MSVehicleControl.cpp.

References myVTypeDistDict.

Referenced by getTotalTravelTime().

◆ insertVTypeIDs()

void MSVehicleControl::insertVTypeIDs ( std::vector< std::string > &  into) const

Inserts ids of all known vehicle types and vehicle type distributions to the given vector.

Parameters
[in]intoThe vector to fill with ids

Definition at line 301 of file MSVehicleControl.cpp.

References myVTypeDict, and myVTypeDistDict.

Referenced by TraCI_VehicleType::getIDList(), and getTotalTravelTime().

◆ loadedVehBegin()

constVehIt MSVehicleControl::loadedVehBegin ( ) const
inline

◆ loadedVehEnd()

constVehIt MSVehicleControl::loadedVehEnd ( ) const
inline

◆ operator=()

MSVehicleControl& MSVehicleControl::operator= ( const MSVehicleControl s)
private

invalidated assignment operator

◆ registerCollision()

void MSVehicleControl::registerCollision ( )
inline

registers one collision-related teleport

Definition at line 397 of file MSVehicleControl.h.

References myCollisions.

Referenced by MSLane::executeMovements(), and MSLane::handleCollisionBetween().

◆ registerEmergencyStop()

void MSVehicleControl::registerEmergencyStop ( )
inline

register emergency stop

Definition at line 417 of file MSVehicleControl.h.

References myEmergencyStops, saveState(), and setState().

Referenced by MSVehicle::executeMove().

◆ registerOneWaitingForContainer()

void MSVehicleControl::registerOneWaitingForContainer ( )
inline

increases the count of vehicles waiting for a container to allow recogniztion of container related deadlocks

Definition at line 386 of file MSVehicleControl.h.

References myWaitingForContainer.

Referenced by MSRouteHandler::closeVehicle(), and MSVehicle::processNextStop().

◆ registerOneWaitingForPerson()

void MSVehicleControl::registerOneWaitingForPerson ( )
inline

increases the count of vehicles waiting for a person to allow recogniztion of person related deadlocks

Definition at line 374 of file MSVehicleControl.h.

References myWaitingForPerson.

Referenced by MSRouteHandler::closeVehicle(), and MSVehicle::processNextStop().

◆ registerTeleportJam()

void MSVehicleControl::registerTeleportJam ( )
inline

register one non-collision-related teleport

Definition at line 402 of file MSVehicleControl.h.

References myTeleportsJam.

Referenced by MSLane::executeMovements(), and MELoop::teleportVehicle().

◆ registerTeleportWrongLane()

void MSVehicleControl::registerTeleportWrongLane ( )
inline

register one non-collision-related teleport

Definition at line 412 of file MSVehicleControl.h.

References myTeleportsWrongLane.

Referenced by MSLane::executeMovements().

◆ registerTeleportYield()

void MSVehicleControl::registerTeleportYield ( )
inline

register one non-collision-related teleport

Definition at line 407 of file MSVehicleControl.h.

References myTeleportsYield.

Referenced by MSLane::executeMovements().

◆ removeVType()

void MSVehicleControl::removeVType ( const MSVehicleType vehType)

◆ removeWaiting()

void MSVehicleControl::removeWaiting ( const MSEdge *const  edge,
SUMOVehicle vehicle 
)

Removes a vehicle from the list of waiting vehicles to a given edge.

Definition at line 322 of file MSVehicleControl.cpp.

References myWaiting.

Referenced by getTotalTravelTime(), MSContainer::MSContainerStage_Driving::proceed(), MSPerson::MSPersonStage_Driving::proceed(), and MSVehicle::resumeFromStopping().

◆ saveState()

◆ scheduleVehicleRemoval()

void MSVehicleControl::scheduleVehicleRemoval ( SUMOVehicle veh)

Removes a vehicle after it has ended.

Writes output to tripinfos and vehroutes if wished; decrements the number of running vehicles and increments the number of ended vehicles. Then deletes the vehicle using "deleteVehicle".

This method should be called for each vehicle that was inserted into the network and quits its ride.

Parameters
[in]vehThe vehicle to remove

Definition at line 125 of file MSVehicleControl.cpp.

References OutputDevice::closeTag(), deleteVehicle(), SUMOVehicle::getDeparture(), OutputDevice::getDeviceByOption(), SUMOVehicle::getDevices(), MSNet::getInstance(), OptionsCont::getOptions(), MSNet::informVehicleStateListener(), myRunningVehNo, myTotalTravelTime, STEPS2TIME, and MSNet::VEHICLE_STATE_ARRIVED.

Referenced by MSVehicleTransfer::add(), MELoop::changeSegment(), MSVehicleTransfer::checkInsertions(), MSLane::detectCollisions(), MSLane::executeMovements(), TraCIServerAPI_Vehicle::processSet(), MESegment::receive(), and MSCalibrator::removePending().

◆ setState()

void MSVehicleControl::setState ( int  runningVehNo,
int  loadedVehNo,
int  endedVehNo,
double  totalDepartureDelay,
double  totalTravelTime 
)

Sets the current state variables as loaded from the stream.

Definition at line 152 of file MSVehicleControl.cpp.

References myEndedVehNo, myLoadedVehNo, myRunningVehNo, myTotalDepartureDelay, and myTotalTravelTime.

Referenced by MSStateHandler::myStartElement(), and registerEmergencyStop().

◆ unregisterOneWaitingForContainer()

void MSVehicleControl::unregisterOneWaitingForContainer ( )
inline

decreases the count of vehicles waiting for a container to allow recogniztion of container related deadlocks

Definition at line 392 of file MSVehicleControl.h.

References myWaitingForContainer.

Referenced by MSContainer::MSContainerStage_Driving::proceed(), MSVehicle::processNextStop(), and MSVehicle::resumeFromStopping().

◆ unregisterOneWaitingForPerson()

void MSVehicleControl::unregisterOneWaitingForPerson ( )
inline

decreases the count of vehicles waiting for a person to allow recogniztion of person related deadlocks

Definition at line 380 of file MSVehicleControl.h.

References myWaitingForPerson.

Referenced by MSPerson::MSPersonStage_Driving::proceed(), MSVehicle::processNextStop(), and MSVehicle::resumeFromStopping().

◆ vehicleDeparted()

void MSVehicleControl::vehicleDeparted ( const SUMOVehicle v)

Informs this control about a vehicle's departure.

If the mean waiting time shall be computed (f.e. for summary-output), the absolut waiting time is increased by the waiting time of the given vehicle.

Parameters
[in]vThe inserted vehicle

Definition at line 142 of file MSVehicleControl.cpp.

References SUMOVehicleParameter::depart, MSVehicleType::getCarFollowModel(), SUMOVehicle::getChosenSpeedFactor(), SUMOVehicle::getDeparture(), MSNet::getInstance(), MSCFModel::getMaxDecel(), SUMOVehicle::getParameter(), SUMOVehicle::getVehicleType(), MSNet::informVehicleStateListener(), MAX2(), MIN2(), myMaxSpeedFactor, myMinDeceleration, myRunningVehNo, myTotalDepartureDelay, STEPFLOOR, STEPS2TIME, and MSNet::VEHICLE_STATE_DEPARTED.

Referenced by loadedVehEnd(), and MSBaseVehicle::onDepart().

Field Documentation

◆ myCollisions

int MSVehicleControl::myCollisions
protected

The number of collisions.

Definition at line 488 of file MSVehicleControl.h.

Referenced by getCollisionCount(), getTeleportCount(), and registerCollision().

◆ myDefaultPedTypeMayBeDeleted

bool MSVehicleControl::myDefaultPedTypeMayBeDeleted
protected

Whether no pedestrian type was loaded.

Definition at line 543 of file MSVehicleControl.h.

Referenced by checkVType(), and getVType().

◆ myDefaultVTypeMayBeDeleted

bool MSVehicleControl::myDefaultVTypeMayBeDeleted
protected

Whether no vehicle type was loaded.

Definition at line 540 of file MSVehicleControl.h.

Referenced by checkVType(), and getVType().

◆ myDiscarded

int MSVehicleControl::myDiscarded
protected

The number of vehicles which were discarded while loading.

Definition at line 485 of file MSVehicleControl.h.

Referenced by deleteVehicle(), discountStateLoaded(), and getDepartedVehicleNo().

◆ myEmergencyStops

int MSVehicleControl::myEmergencyStops
protected

The number of emergency stops.

Definition at line 500 of file MSVehicleControl.h.

Referenced by getEmergencyStops(), and registerEmergencyStop().

◆ myEndedVehNo

int MSVehicleControl::myEndedVehNo
protected

The number of removed vehicles.

Definition at line 482 of file MSVehicleControl.h.

Referenced by deleteVehicle(), discountStateLoaded(), getActiveVehicleCount(), getDepartedVehicleNo(), getEndedVehicleNo(), saveState(), and setState().

◆ myLoadedVehNo

◆ myMaxRandomDepartOffset

SUMOTime MSVehicleControl::myMaxRandomDepartOffset
protected

The maximum random offset to be added to vehicles departure times (non-negative)

Definition at line 558 of file MSVehicleControl.h.

Referenced by computeRandomDepartOffset(), and MSVehicleControl().

◆ myMaxSpeedFactor

double MSVehicleControl::myMaxSpeedFactor
protected

The maximum speed factor for all vehicles in the network.

Definition at line 561 of file MSVehicleControl.h.

Referenced by getMaxSpeedFactor(), and vehicleDeparted().

◆ myMinDeceleration

double MSVehicleControl::myMinDeceleration
protected

The minimum deceleration capability for all vehicles in the network.

Definition at line 564 of file MSVehicleControl.h.

Referenced by getMinDeceleration(), and vehicleDeparted().

◆ myRunningVehNo

int MSVehicleControl::myRunningVehNo
protected

The number of vehicles within the network (build and inserted but not removed)

Definition at line 479 of file MSVehicleControl.h.

Referenced by discountStateLoaded(), getDepartedVehicleNo(), getRunningVehicleNo(), saveState(), scheduleVehicleRemoval(), setState(), and vehicleDeparted().

◆ myScale

double MSVehicleControl::myScale
protected

The scaling factor (especially for inc-dua)

Definition at line 555 of file MSVehicleControl.h.

Referenced by getQuota(), and MSVehicleControl().

◆ myTeleportsJam

int MSVehicleControl::myTeleportsJam
protected

The number of teleports due to jam.

Definition at line 491 of file MSVehicleControl.h.

Referenced by getTeleportCount(), getTeleportsJam(), and registerTeleportJam().

◆ myTeleportsWrongLane

int MSVehicleControl::myTeleportsWrongLane
protected

The number of teleports due to vehicles stuck on the wrong lane.

Definition at line 497 of file MSVehicleControl.h.

Referenced by getTeleportCount(), getTeleportsWrongLane(), and registerTeleportWrongLane().

◆ myTeleportsYield

int MSVehicleControl::myTeleportsYield
protected

The number of teleports due to vehicles stuck on a minor road.

Definition at line 494 of file MSVehicleControl.h.

Referenced by getTeleportCount(), getTeleportsYield(), and registerTeleportYield().

◆ myTotalDepartureDelay

double MSVehicleControl::myTotalDepartureDelay
protected

The aggregated time vehicles had to wait for departure (in seconds)

Definition at line 509 of file MSVehicleControl.h.

Referenced by getTotalDepartureDelay(), saveState(), setState(), and vehicleDeparted().

◆ myTotalTravelTime

double MSVehicleControl::myTotalTravelTime
protected

The aggregated time vehicles needed to aacomplish their route (in seconds)

Definition at line 512 of file MSVehicleControl.h.

Referenced by getTotalTravelTime(), saveState(), scheduleVehicleRemoval(), and setState().

◆ myVehicleDict

◆ myVTypeDict

VTypeDictType MSVehicleControl::myVTypeDict
protected

Dictionary of vehicle types.

Definition at line 532 of file MSVehicleControl.h.

Referenced by addVType(), checkVType(), getVType(), insertVTypeIDs(), MSVehicleControl(), removeVType(), saveState(), and ~MSVehicleControl().

◆ myVTypeDistDict

VTypeDistDictType MSVehicleControl::myVTypeDistDict
protected

A distribution of vehicle types (probability->vehicle type)

Definition at line 537 of file MSVehicleControl.h.

Referenced by addVTypeDistribution(), checkVType(), getVType(), hasVTypeDistribution(), insertVTypeIDs(), saveState(), and ~MSVehicleControl().

◆ myWaiting

std::map<const MSEdge* const, std::vector<SUMOVehicle*> > MSVehicleControl::myWaiting
protected

the lists of waiting vehicles to a given edge

Definition at line 546 of file MSVehicleControl.h.

Referenced by addWaiting(), getWaitingVehicle(), and removeWaiting().

◆ myWaitingForContainer

int MSVehicleControl::myWaitingForContainer
protected

the number of vehicles wainting for containers contained in myWaiting which can only continue by being triggered

Definition at line 552 of file MSVehicleControl.h.

Referenced by getActiveVehicleCount(), registerOneWaitingForContainer(), and unregisterOneWaitingForContainer().

◆ myWaitingForPerson

int MSVehicleControl::myWaitingForPerson
protected

the number of vehicles wainting for persons contained in myWaiting which can only continue by being triggered

Definition at line 549 of file MSVehicleControl.h.

Referenced by getActiveVehicleCount(), registerOneWaitingForPerson(), and unregisterOneWaitingForPerson().


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