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

#include <MSVehicleControl.h>

Inheritance diagram for MSVehicleControl:

Public Types
typedef std::map< std::string, SUMOVehicle * > ::const_iterator	constVehIt
	Definition of the internal vehicles map iterator.
Public Member Functions
void	abortWaiting () throw ()
	removes any vehicles that are still waiting
void	addWaiting (const MSEdge const edge, SUMOVehicle vehicle) throw ()
SUMOVehicle *	getWaitingVehicle (const MSEdge *const edge, const std::set< std::string > &lines) throw ()
	MSVehicleControl () throw ()
	Constructor.
void	registerOneWaitingForPerson ()
	increases the count of vehicles waiting for a person to allow recogniztion of person related deadlocks
void	removeWaiting (const MSEdge const edge, SUMOVehicle vehicle) throw ()
void	unregisterOneWaitingForPerson ()
	decreases the count of vehicles waiting for a person to allow recogniztion of person related deadlocks
virtual	~MSVehicleControl () throw ()
	Destructor.
Vehicle creation
virtual SUMOVehicle *	buildVehicle (SUMOVehicleParameter defs, const MSRoute route, const MSVehicleType *type) throw (ProcessError)
	Builds a vehicle, increases the number of built vehicles.
Insertion, deletion and retrieval of vehicles
virtual bool	addVehicle (const std::string &id, SUMOVehicle *v) throw ()
	Tries to insert the vehicle into the internal vehicle container.
SUMOVehicle *	getVehicle (const std::string &id) const throw ()
	Returns the vehicle with the given id.
virtual void	deleteVehicle (SUMOVehicle *v) throw ()
	Deletes the vehicle.
void	scheduleVehicleRemoval (SUMOVehicle *veh) throw ()
	Removes a vehicle after it has ended.
constVehIt	loadedVehBegin () const throw ()
	Returns the begin of the internal vehicle map.
constVehIt	loadedVehEnd () const throw ()
	Returns the end of the internal vehicle map.
Setting vehicle statistics
void	vehicleDeparted (const SUMOVehicle &v) throw ()
	Informs this control about a vehicle's departure.
Retrieval of vehicle statistics (always accessable)
unsigned int	getLoadedVehicleNo () const throw ()
	Returns the number of build vehicles.
unsigned int	getEndedVehicleNo () const throw ()
	Returns the number of removed vehicles.
unsigned int	getRunningVehicleNo () const throw ()
	Returns the number of build and inserted, but not yet deleted vehicles.
unsigned int	getDepartedVehicleNo () const throw ()
	Returns the number of inserted vehicles.
bool	isInQuota (const SUMOReal frac) const throw ()
	Returns the information whether the currently vehicle number is still in the given range.
int	getActiveVehicleCount () const throw ()
	Returns the number of build vehicles that have not been removed or need to wait for a passenger.
Retrieval of vehicle statistics (availability depends on simulation settings)
void	printMeanWaitingTime (OutputDevice &od) const throw ()
	Prints the mean waiting time of vehicles. The mean time vehicles had to wait for being inserted (-1 if no vehicle was inserted, yet)
void	printMeanTravelTime (OutputDevice &od) const throw ()
	Returns the mean travel time of vehicles The mean travel time of ended vehicles (-1 if no vehicle has ended, yet)
Insertion and retrieval of vehicle types
bool	addVType (MSVehicleType *vehType) throw ()
	Adds a vehicle type.
bool	addVTypeDistribution (const std::string &id, RandomDistributor< MSVehicleType * > *vehTypeDistribution) throw ()
	Adds a vehicle type distribution.
bool	hasVTypeDistribution (const std::string &id) const throw ()
	Asks for a vehicle type distribution.
MSVehicleType *	getVType (const std::string &id=DEFAULT_VTYPE_ID) throw ()
	Returns the named vehicle type or a sample from the named distribution.
void	insertVTypeIDs (std::vector< std::string > &into) const throw ()
	Inserts ids of all known vehicle types and vehicle type distributions to the given vector.
State I/O (mesosim only)
virtual void	saveState (std::ostream &os) throw ()
	Loads the state of this control from the given stream.
virtual void	loadState (BinaryInputDevice &bis, const SUMOTime offset) throw ()
	Saves the current state into the given stream.
Protected Attributes
Vehicle statistics (always accessable)
unsigned int	myLoadedVehNo
	The number of build vehicles.
unsigned int	myRunningVehNo
	The number of vehicles within the network (build and inserted but not removed)
unsigned int	myEndedVehNo
	The number of removed vehicles.
Vehicle statistics
SUMOReal	myTotalDepartureDelay
	The aggregated time vehicles had to wait for departure (in seconds)
SUMOReal	myTotalTravelTime
	The aggregated time vehicles needed to aacomplish their route (in seconds)
Private Member Functions
bool	checkVType (const std::string &id) throw ()
	Checks whether the vehicle type (distribution) may be added.
Vehicle container
typedef std::map< std::string, SUMOVehicle * >	VehicleDictType
	Vehicle dictionary type.
VehicleDictType	myVehicleDict
	Dictionary of vehicles.
Vehicle type container
typedef std::map< std::string, MSVehicleType * >	VTypeDictType
	Vehicle type dictionary type.
typedef std::map< std::string, RandomDistributor < MSVehicleType * > * >	VTypeDistDictType
	Vehicle type distribution dictionary type.
VTypeDictType	myVTypeDict
	Dictionary of vehicle types.
VTypeDistDictType	myVTypeDistDict
	A distribution of vehicle types (probability->vehicle type)
bool	myDefaultVTypeMayBeDeleted
	Whether no vehicle type was loaded.
std::map< const MSEdge const, std::vector< SUMOVehicle > >	myWaiting
	the lists of waiting vehicles
unsigned int	myWaitingForPerson
	the number of vehicles contained in myWaiting which can only continue by being triggered
	MSVehicleControl (const MSVehicleControl &s)
	invalidated copy constructor
MSVehicleControl &	operator= (const MSVehicleControl &s)
	invalidated assignment operator

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 70 of file MSVehicleControl.h.

Member Typedef Documentation

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

Definition of the internal vehicles map iterator.

Definition at line 73 of file MSVehicleControl.h.

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

Vehicle dictionary type.

Definition at line 399 of file MSVehicleControl.h.

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

Vehicle type dictionary type.

Definition at line 409 of file MSVehicleControl.h.

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

Vehicle type distribution dictionary type.

Definition at line 414 of file MSVehicleControl.h.

Constructor & Destructor Documentation

MSVehicleControl::MSVehicleControl ( ) throw ()

Constructor.

Definition at line 49 of file MSVehicleControl.cpp.

References MSVehicleType::build(), DEFAULT_VTYPE_ID, and myVTypeDict.

MSVehicleControl::~MSVehicleControl ( ) throw () [virtual]

Destructor.

Definition at line 62 of file MSVehicleControl.cpp.

References myVehicleDict, myVTypeDict, and myVTypeDistDict.

MSVehicleControl::MSVehicleControl ( const MSVehicleControl & s ) [private]

invalidated copy constructor

Member Function Documentation

void MSVehicleControl::abortWaiting ( ) throw ()

removes any vehicles that are still waiting

Definition at line 296 of file MSVehicleControl.cpp.

References myVehicleDict, and WRITE_WARNING.

Referenced by MSNet::simulationState().

bool MSVehicleControl::addVehicle	(	const std::string &	id,
		SUMOVehicle *	v
	)		throw () `[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]	id	The id of the vehicle
[in]	v	The vehicle

Returns:: Whether the vehicle could be inserted (no other vehicle with the same id was inserted before)

Reimplemented in GUIVehicleControl.

Definition at line 147 of file MSVehicleControl.cpp.

Referenced by GUIVehicleControl::addVehicle(), MSInsertionControl::checkFlows(), MSRouteHandler::closeVehicle(), and TraCIServerAPI_Vehicle::processSet().

bool MSVehicleControl::addVType ( MSVehicleType * vehType ) throw ()

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] vehType The vehicle type to add

Returns:: Whether the vehicle type could be added

Definition at line 207 of file MSVehicleControl.cpp.

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

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]	id	The id of the distribution to add
[in]	vehTypeDistribution	The vehicle type distribution to add

Returns:: Whether the vehicle type could be added

Definition at line 217 of file MSVehicleControl.cpp.

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

Definition at line 262 of file MSVehicleControl.cpp.

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

SUMOVehicle * MSVehicleControl::buildVehicle	(	SUMOVehicleParameter *	defs,
		const MSRoute *	route,
		const MSVehicleType *	type
	)		throw (ProcessError) `[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]	id	The id of the vehicle to build
[in]	route	The route of this vehicle
[in]	departTime	The departure time of this vehicle
[in]	type	The type of this vehicle
[in]	repNo	The number of repetitions
[in]	repOffset	The repetition offset

Returns:: The built vehicle (MSVehicle instance)

Reimplemented in GUIVehicleControl.

Definition at line 82 of file MSVehicleControl.cpp.

References MSNet::getInstance(), MSNet::informVehicleStateListener(), and MSNet::VEHICLE_STATE_BUILT.

Referenced by MSInsertionControl::checkFlows(), MSRouteHandler::closeVehicle(), and TraCIServerAPI_Vehicle::processSet().

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

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

Removed the vehicle from the internal dictionary

Parameters:

[in] id The id of the vehicle type (distribution) to add

Returns:: Whether the type (distribution) may be added

Definition at line 189 of file MSVehicleControl.cpp.

References DEFAULT_VTYPE_ID.

void MSVehicleControl::deleteVehicle ( SUMOVehicle * v ) throw () [virtual]

Deletes the vehicle.

Parameters:

[in] v The vehicle to delete

Todo:: Isn't this quite insecure?

Reimplemented in GUIVehicleControl.

Definition at line 169 of file MSVehicleControl.cpp.

Referenced by MSRouteHandler::closeVehicle(), and GUIVehicleControl::deleteVehicle().

int MSVehicleControl::getActiveVehicleCount ( ) const throw () [inline]

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

Returns:: Number of active vehicles

Definition at line 238 of file MSVehicleControl.h.

References myEndedVehNo, myLoadedVehNo, and myWaitingForPerson.

Referenced by MSNet::simulationState().

unsigned int MSVehicleControl::getDepartedVehicleNo ( ) const throw () [inline]

Returns the number of inserted vehicles.

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

Definition at line 218 of file MSVehicleControl.h.

References myEndedVehNo, and myRunningVehNo.

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

unsigned int MSVehicleControl::getEndedVehicleNo ( ) const throw () [inline]

Returns the number of removed vehicles.

Returns:: The number of vehicles that have left the simulation

Definition at line 202 of file MSVehicleControl.h.

References myEndedVehNo.

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

unsigned int MSVehicleControl::getLoadedVehicleNo ( ) const throw () [inline]

Returns the number of build vehicles.

Returns:: The number of loaded (build) vehicles

Definition at line 194 of file MSVehicleControl.h.

References myLoadedVehNo.

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

unsigned int MSVehicleControl::getRunningVehicleNo ( ) const throw () [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 210 of file MSVehicleControl.h.

References myRunningVehNo.

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

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

Returns the vehicle with the given id.

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

Parameters:

[in] id The id of the vehicle to retrieve

Returns:: The vehicle with the given id, 0 if no such vehicle exists

Definition at line 159 of file MSVehicleControl.cpp.

Referenced by MSInsertionControl::checkFlows(), MSRouteHandler::closeVehicle(), TraCIServerAPI_Vehicle::processGet(), TraCIServerAPI_Vehicle::processSet(), TraCIServerAPI_GUI::processSet(), and GUINet::vehicleExists().

MSVehicleType * MSVehicleControl::getVType ( const std::string & id = DEFAULT_VTYPE_ID ) throw ()

Returns the named vehicle type or a sample from the named distribution.

Parameters:

[in] id The id of the vehicle type to return. If left out, the default type is returned.

Returns:: The named vehicle type, or 0 if no such type exists

Definition at line 233 of file MSVehicleControl.cpp.

References DEFAULT_VTYPE_ID, and MSVehicleType::get().

Referenced by MSInsertionControl::checkFlows(), MSRouteHandler::closeVehicle(), MSRouteHandler::openVehicleTypeDistribution(), TraCIServerAPI_VehicleType::processGet(), TraCIServerAPI_VehicleType::processSet(), and TraCIServerAPI_Vehicle::processSet().

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

Definition at line 282 of file MSVehicleControl.cpp.

References SUMOVehicle::getParameter(), and SUMOVehicleParameter::line.

Referenced by MSPerson::MSPersonStage_Driving::proceed().

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

Asks for a vehicle type distribution.

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

Parameters:

[in] id The id of the distribution

Returns:: Whether the vehicle type distribution exists

Definition at line 227 of file MSVehicleControl.cpp.

Referenced by MSInsertionControl::add().

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

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

Parameters:

[in] into The vector to fill with ids

Definition at line 250 of file MSVehicleControl.cpp.

Referenced by TraCIServerAPI_VehicleType::processGet().

bool MSVehicleControl::isInQuota ( const SUMOReal frac ) const throw () [inline]

Returns the information whether the currently vehicle number is still in the given range.

Returns:: True iff the vehicle number is acceptable

Definition at line 226 of file MSVehicleControl.h.

References MSGlobals::gFractions, and myLoadedVehNo.

Referenced by MSDevice_Routing::buildVehicleDevices(), MSDevice_HBEFA::buildVehicleDevices(), and MSRouteHandler::closeVehicle().

MSVehicleControl::constVehIt MSVehicleControl::loadedVehBegin ( ) const throw ()

Returns the begin of the internal vehicle map.

Returns:: The begin of the internal vehicle map

Definition at line 177 of file MSVehicleControl.cpp.

References myVehicleDict.

Referenced by MSVTypeProbe::execute(), and TraCIServerAPI_Vehicle::processGet().

MSVehicleControl::constVehIt MSVehicleControl::loadedVehEnd ( ) const throw ()

Returns the end of the internal vehicle map.

Returns:: The end of the internal vehicle map

Definition at line 183 of file MSVehicleControl.cpp.

References myVehicleDict.

Referenced by MSVTypeProbe::execute(), and TraCIServerAPI_Vehicle::processGet().

void MSVehicleControl::loadState	(	BinaryInputDevice &	bis,
		const SUMOTime	offset
	)		throw () `[virtual]`

Saves the current state into the given stream.

Todo:: Does not work for microsim

Definition at line 142 of file MSVehicleControl.cpp.

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

invalidated assignment operator

void MSVehicleControl::printMeanTravelTime ( OutputDevice & od ) const throw ()

Returns the mean travel time of vehicles The mean travel time of ended vehicles (-1 if no vehicle has ended, yet)

Todo:: Enable this for guisim?

Definition at line 119 of file MSVehicleControl.cpp.

References SUMOReal.

Referenced by MSNet::writeOutput().

void MSVehicleControl::printMeanWaitingTime ( OutputDevice & od ) const throw ()

Prints the mean waiting time of vehicles. The mean time vehicles had to wait for being inserted (-1 if no vehicle was inserted, yet)

Todo:: Enable this for guisim?

Definition at line 109 of file MSVehicleControl.cpp.

References SUMOReal.

Referenced by MSNet::writeOutput().

void MSVehicleControl::registerOneWaitingForPerson ( ) [inline]

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

Definition at line 329 of file MSVehicleControl.h.

References myWaitingForPerson.

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

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

Definition at line 271 of file MSVehicleControl.cpp.

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

void MSVehicleControl::saveState ( std::ostream & os ) throw () [virtual]

Loads the state of this control from the given stream.

Todo:: Does not work for microsim

Definition at line 137 of file MSVehicleControl.cpp.

void MSVehicleControl::scheduleVehicleRemoval ( SUMOVehicle * veh ) throw ()

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] veh The vehicle to remove

Definition at line 93 of file MSVehicleControl.cpp.

References OutputDevice::closeTag(), OutputDevice::getDeviceByOption(), MSNet::getInstance(), OptionsCont::getOptions(), MSNet::informVehicleStateListener(), STEPS2TIME, and MSNet::VEHICLE_STATE_ARRIVED.

Referenced by MSVehicleTransfer::addVeh(), MSVehicleTransfer::checkInsertions(), TraCIServerAPI_Vehicle::processSet(), and MSLane::setCritical().

void MSVehicleControl::unregisterOneWaitingForPerson ( ) [inline]

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

Definition at line 335 of file MSVehicleControl.h.

References myWaitingForPerson.

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

void MSVehicleControl::vehicleDeparted ( const SUMOVehicle & v ) throw ()

Informs this control about a vehicle's departure.

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

Parameters:

[in] v The inserted vehicle

Definition at line 129 of file MSVehicleControl.cpp.

References MSNet::getInstance(), MSNet::informVehicleStateListener(), STEPFLOOR, STEPS2TIME, and MSNet::VEHICLE_STATE_DEPARTED.

Referenced by MSBaseVehicle::onDepart().