SUMO - Simulation of Urban MObility
 All Data Structures Namespaces Files Functions Variables Typedefs Enumerations Enumerator Friends Macros Modules Pages
SUMOVehicle Class Referenceabstract

Representation of a vehicle. More...

#include <SUMOVehicle.h>

Inheritance diagram for SUMOVehicle:
MSBaseVehicle MSVehicle GUIVehicle

Public Member Functions

virtual void addContainer (MSContainer *container)=0
 Adds a container to this vehicle. More...
 
virtual void addPerson (MSPerson *person)=0
 Adds a person to this vehicle. More...
 
virtual bool addStop (const SUMOVehicleParameter::Stop &stopPar, std::string &errorMsg, SUMOTime untilOffset=0)=0
 Adds a stop. More...
 
virtual SUMOReal getAcceleration () const =0
 Returns the vehicle's acceleration. More...
 
virtual SUMOReal getAngle () const =0
 Get the vehicle's angle. More...
 
virtual SUMOReal getArrivalPos () const =0
 Returns this vehicle's desired arrivalPos for its current route (may change on reroute) More...
 
virtual SUMOReal getChosenSpeedFactor () const =0
 
virtual const
ConstMSEdgeVector::const_iterator & 
getCurrentRouteEdge () const =0
 Returns an iterator pointing to the current edge in this vehicles route. More...
 
virtual SUMOTime getDeparture () const =0
 Returns this vehicle's real departure time. More...
 
virtual MSDevicegetDevice (const std::type_info &type) const =0
 Returns a device of the given type if it exists or 0. More...
 
virtual const std::vector
< MSDevice * > & 
getDevices () const =0
 Returns this vehicle's devices. More...
 
virtual const MSEdgegetEdge () const =0
 Returns the edge the vehicle is currently at. More...
 
virtual const std::string & getID () const =0
 Get the vehicle's ID. More...
 
virtual SUMOReal getImpatience () const =0
 Returns this vehicles impatience. More...
 
virtual SUMOReal getMaxSpeed () const =0
 Returns the vehicle's maximum speed. More...
 
virtual unsigned int getNumberReroutes () const =0
 Returns the number of new routes this vehicle got. More...
 
virtual const
SUMOVehicleParameter
getParameter () const =0
 Returns the vehicle's parameter (including departure definition) More...
 
virtual Position getPosition (const SUMOReal offset=0) const =0
 Return current position (x/y, cartesian) More...
 
virtual SUMOReal getPositionOnLane () const =0
 Get the vehicle's position along the lane. More...
 
virtual const MSRoutegetRoute () const =0
 Returns the current route. More...
 
virtual SUMOReal getSlope () const =0
 Returns the slope of the road at vehicle's position. More...
 
virtual SUMOReal getSpeed () const =0
 Returns the vehicle's current speed. More...
 
virtual SUMOVehicleClass getVClass () const =0
 Returns the vehicle's access class. More...
 
virtual const MSVehicleTypegetVehicleType () const =0
 Returns the vehicle's type. More...
 
virtual SUMOTime getWaitingTime () const =0
 
virtual bool hasArrived () const =0
 Returns whether this vehicle has arrived. More...
 
virtual bool hasDeparted () const =0
 Returns whether this vehicle has departed. More...
 
virtual bool isOnRoad () const =0
 Returns the information whether the vehicle is on a road (is simulated) More...
 
virtual bool isStopped () const =0
 Returns whether the vehicle is at a stop. More...
 
virtual bool isStoppedTriggered () const =0
 Returns whether the vehicle is at a stop and waiting for a person or container to continue. More...
 
virtual void onDepart ()=0
 Called when the vehicle is inserted into the network. More...
 
virtual bool replaceRoute (const MSRoute *route, bool onInit=false, int offset=0)=0
 Replaces the current route by the given one. More...
 
virtual bool replaceRouteEdges (ConstMSEdgeVector &edges, bool onInit=false)=0
 Replaces the current route by the given edges. More...
 
virtual void reroute (SUMOTime t, SUMOAbstractRouter< MSEdge, SUMOVehicle > &router, const bool onInit=false, const bool withTaz=false)=0
 Performs a rerouting using the given router. More...
 
virtual void setChosenSpeedFactor (const SUMOReal factor)=0
 
virtual const MSEdgesuccEdge (unsigned int nSuccs) const =0
 Returns the nSuccs'th successor of edge the vehicle is currently at. More...
 
virtual ~SUMOVehicle ()
 Destructor. More...
 
state io
virtual void saveState (OutputDevice &out)=0
 Saves the states of a vehicle. More...
 
virtual void loadState (const SUMOSAXAttributes &attrs, const SUMOTime offset)=0
 Loads the state of this vehicle from the given description. More...
 

Detailed Description

Representation of a vehicle.

Definition at line 65 of file SUMOVehicle.h.

Constructor & Destructor Documentation

virtual SUMOVehicle::~SUMOVehicle ( )
inlinevirtual

Destructor.

Definition at line 68 of file SUMOVehicle.h.

Member Function Documentation

virtual void SUMOVehicle::addContainer ( MSContainer container)
pure virtual

Adds a container to this vehicle.

May do nothing since containers are not supported by default

Parameters
[in]containerThe container to add

Implemented in MSVehicle, and MSBaseVehicle.

virtual void SUMOVehicle::addPerson ( MSPerson person)
pure virtual

Adds a person to this vehicle.

May do nothing since persons are not supported by default

Parameters
[in]personThe person to add

Implemented in MSVehicle, and MSBaseVehicle.

virtual bool SUMOVehicle::addStop ( const SUMOVehicleParameter::Stop stopPar,
std::string &  errorMsg,
SUMOTime  untilOffset = 0 
)
pure virtual

Adds a stop.

The stop is put into the sorted list.

Parameters
[in]stopThe stop to add
Returns
Whether the stop could be added

Implemented in MSVehicle.

Referenced by MSBaseVehicle::addStops().

virtual SUMOReal SUMOVehicle::getAngle ( ) const
pure virtual

Get the vehicle's angle.

Returns
The angle of the vehicle (in degree)

Implemented in MSVehicle.

Referenced by MSEmissionExport::write(), MSFCDExport::write(), and MSFullExport::writeVehicles().

virtual SUMOReal SUMOVehicle::getArrivalPos ( ) const
pure virtual

Returns this vehicle's desired arrivalPos for its current route (may change on reroute)

Returns
This vehicle's real arrivalPos

Implemented in MSBaseVehicle.

Referenced by MSDevice_Tripinfo::notifyLeave().

virtual SUMOReal SUMOVehicle::getChosenSpeedFactor ( ) const
pure virtual
virtual const ConstMSEdgeVector::const_iterator& SUMOVehicle::getCurrentRouteEdge ( ) const
pure virtual

Returns an iterator pointing to the current edge in this vehicles route.

Returns
The current route pointer

Implemented in MSBaseVehicle.

Referenced by MSDevice_Tripinfo::generateOutput().

virtual SUMOTime SUMOVehicle::getDeparture ( ) const
pure virtual

Returns this vehicle's real departure time.

Returns
This vehicle's real departure time

Implemented in MSBaseVehicle.

Referenced by MSDevice_Tripinfo::generateOutput(), MSDevice_Vehroutes::generateOutput(), MSVehicleControl::scheduleVehicleRemoval(), MSVehicleControl::vehicleDeparted(), and MSAmitranTrajectories::writeVehicle().

virtual MSDevice* SUMOVehicle::getDevice ( const std::type_info &  type) const
pure virtual

Returns a device of the given type if it exists or 0.

Implemented in MSBaseVehicle.

Referenced by MSInsertionControl::checkCandidates(), and MSDevice_Example::notifyMove().

virtual const std::vector<MSDevice*>& SUMOVehicle::getDevices ( ) const
pure virtual

Returns this vehicle's devices.

Returns
This vehicle's devices

Implemented in MSBaseVehicle.

Referenced by MSDevice_Tripinfo::generateOutput(), and MSVehicleControl::scheduleVehicleRemoval().

virtual const std::string& SUMOVehicle::getID ( ) const
pure virtual
virtual SUMOReal SUMOVehicle::getImpatience ( ) const
pure virtual

Returns this vehicles impatience.

Implemented in MSBaseVehicle.

virtual SUMOReal SUMOVehicle::getMaxSpeed ( ) const
pure virtual

Returns the vehicle's maximum speed.

Returns
The vehicle's maximum speed

Implemented in MSBaseVehicle.

Referenced by MSEdge::getMinimumTravelTime(), and MSDevice_Tripinfo::notifyMove().

virtual unsigned int SUMOVehicle::getNumberReroutes ( ) const
pure virtual

Returns the number of new routes this vehicle got.

Returns
the number of new routes this vehicle got

Implemented in MSBaseVehicle.

Referenced by MSDevice_Tripinfo::generateOutput(), and MSDevice_Vehroutes::writeXMLRoute().

virtual Position SUMOVehicle::getPosition ( const SUMOReal  offset = 0) const
pure virtual

Return current position (x/y, cartesian)

If the vehicle is not in the net, Position::INVALID.

Parameters
[in]offsetoptional offset in longitudinal direction
Returns
The current position (in cartesian coordinates)
See also
myLane

Implemented in MSVehicle.

Referenced by MSVTypeProbe::execute(), MSDevice_BTsender::notifyEnter(), MSDevice_BTreceiver::notifyEnter(), MSDevice_BTsender::notifyLeave(), MSDevice_BTreceiver::notifyLeave(), MSDevice_BTsender::notifyMove(), MSDevice_BTreceiver::notifyMove(), MSFCDExport::write(), MSEmissionExport::write(), and MSFullExport::writeVehicles().

virtual SUMOReal SUMOVehicle::getSlope ( ) const
pure virtual
virtual SUMOVehicleClass SUMOVehicle::getVClass ( ) const
pure virtual

Returns the vehicle's access class.

Returns
The vehicle's access class

Implemented in MSBaseVehicle.

Referenced by MSDevice_Routing::reroute().

virtual SUMOTime SUMOVehicle::getWaitingTime ( ) const
pure virtual

Implemented in MSVehicle.

Referenced by MSBaseVehicle::getImpatience().

virtual bool SUMOVehicle::hasArrived ( ) const
pure virtual

Returns whether this vehicle has arrived.

Implemented in MSBaseVehicle, and MSVehicle.

Referenced by MSDevice_Vehroutes::generateOutput(), and MSMeanData::MeanDataValues::notifyMove().

virtual bool SUMOVehicle::hasDeparted ( ) const
pure virtual

Returns whether this vehicle has departed.

Implemented in MSBaseVehicle.

Referenced by MSDevice_Vehroutes::addRoute(), and MSDevice_Tripinfo::generateOutputForUnfinished().

virtual bool SUMOVehicle::isOnRoad ( ) const
pure virtual

Returns the information whether the vehicle is on a road (is simulated)

Returns
Whether the vehicle is simulated

Implemented in MSVehicle, and MSBaseVehicle.

Referenced by MSVTypeProbe::execute(), GUIVehicleControl::insertVehicleIDs(), MSE2Collector::notifyEnter(), MSFCDExport::write(), MSEmissionExport::write(), MSAmitranTrajectories::writeVehicle(), and MSFullExport::writeVehicles().

virtual bool SUMOVehicle::isStopped ( ) const
pure virtual

Returns whether the vehicle is at a stop.

Returns
Whether the has stopped

Implemented in MSVehicle.

Referenced by MSDevice_Container::notifyMove(), and MSDevice_Person::notifyMove().

virtual bool SUMOVehicle::isStoppedTriggered ( ) const
pure virtual

Returns whether the vehicle is at a stop and waiting for a person or container to continue.

Implemented in MSVehicle.

virtual void SUMOVehicle::loadState ( const SUMOSAXAttributes attrs,
const SUMOTime  offset 
)
pure virtual

Loads the state of this vehicle from the given description.

Implemented in MSVehicle.

Referenced by MSStateHandler::myStartElement().

virtual void SUMOVehicle::onDepart ( )
pure virtual

Called when the vehicle is inserted into the network.

Sets optional information about departure time, informs the vehicle control about a further running vehicle.

Implemented in MSBaseVehicle.

Referenced by MSInsertionControl::tryInsert().

virtual bool SUMOVehicle::replaceRoute ( const MSRoute route,
bool  onInit = false,
int  offset = 0 
)
pure virtual

Replaces the current route by the given one.

Implemented in MSVehicle.

Referenced by MSTriggeredRerouter::notifyEnter(), MSDevice_Routing::preInsertionReroute(), and MSBaseVehicle::replaceRouteEdges().

virtual bool SUMOVehicle::replaceRouteEdges ( ConstMSEdgeVector edges,
bool  onInit = false 
)
pure virtual

Replaces the current route by the given edges.

Implemented in MSBaseVehicle.

virtual void SUMOVehicle::reroute ( SUMOTime  t,
SUMOAbstractRouter< MSEdge, SUMOVehicle > &  router,
const bool  onInit = false,
const bool  withTaz = false 
)
pure virtual

Performs a rerouting using the given router.

Tries to find a new route between the current edge and the destination edge, first. Tries to replace the current route by the new one using replaceRoute.

Parameters
[in]tThe time for which the route is computed
[in]routerThe router to use
See also
replaceRoute

Implemented in MSBaseVehicle.

Referenced by MSDevice_Routing::reroute().

virtual void SUMOVehicle::saveState ( OutputDevice out)
pure virtual

Saves the states of a vehicle.

Implemented in MSVehicle, and MSBaseVehicle.

virtual void SUMOVehicle::setChosenSpeedFactor ( const SUMOReal  factor)
pure virtual

Implemented in MSBaseVehicle.

Referenced by MSEdge::insertVehicle().

virtual const MSEdge* SUMOVehicle::succEdge ( unsigned int  nSuccs) const
pure virtual

Returns the nSuccs'th successor of edge the vehicle is currently at.

If the rest of the route (counted from the current edge) than nSuccs, 0 is returned.

Parameters
[in]nSuccsThe number of edge to look forward
Returns
The nSuccs'th following edge in the vehicle's route

Implemented in MSBaseVehicle.

Referenced by MSLane::succLinkSec().


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