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

A detector of vehicles passing an area between entry/exit points. More...

#include <MSE3Collector.h>

Inheritance diagram for MSE3Collector:
MSDetectorFileOutput Named GUIE3Collector

Data Structures

struct  E3Values
 Internal storage for values from a vehicle. More...
class  MSE3EntryReminder
 A place on the road net (at a certain lane and position on it) where the E3 area begins. More...
class  MSE3LeaveReminder
 A place on the road net (at a certain lane and position on it) where the E3 area ends. More...

Public Member Functions

void addTo (const StoringVisitor &cont) const
 Adds this object to the given container.
void detectorUpdate (const SUMOTime step)
 Computes the detector values in each time step.
void enter (SUMOVehicle &veh, SUMOReal entryTimestep)
 Called if a vehicle touches an entry-cross-section.
const std::string & getID () const
 Returns the id.
void leave (SUMOVehicle &veh, SUMOReal leaveTimestep)
 Called if a vehicle passes a leave-cross-section.
 MSE3Collector (const std::string &id, const CrossSectionVector &entries, const CrossSectionVector &exits, SUMOReal haltingSpeedThreshold, SUMOTime haltingTimeThreshold)
 Constructor.
void reset ()
 Resets all generated values to allow computation of next interval.
void setID (const std::string &newID)
 resets the id
virtual ~MSE3Collector ()
 Destructor.
Methods returning current values
SUMOReal getCurrentMeanSpeed () const
 Returns the mean speed within the area.
SUMOReal getCurrentHaltingNumber () const
 Returns the number of current haltings within the area.
SUMOReal getVehiclesWithin () const
 Returns the number of vehicles within the area.
std::vector< std::string > getCurrentVehicleIDs () const
 Returns the number of vehicles within the area.
Methods inherited from MSDetectorFileOutput.
void writeXMLOutput (OutputDevice &dev, SUMOTime startTime, SUMOTime stopTime)
 Writes collected values into the given stream.
void writeXMLDetectorProlog (OutputDevice &dev) const
 Opens the XML-output using "e3Detector" as root element.
Virtual methods to implement by derived classes
virtual GUIDetectorWrapperbuildDetectorGUIRepresentation ()
 Builds the graphical representation.

Protected Attributes

std::map< SUMOVehicle *, E3ValuesmyEnteredContainer
 Container for vehicles that have entered the area.
CrossSectionVector myEntries
 The detector's entries.
std::vector< MSE3EntryReminder * > myEntryReminders
 The detector's built entry reminder.
CrossSectionVector myExits
 The detector's exits.
SUMOReal myHaltingSpeedThreshold
 Speed-threshold to determine if a vehicle is halting.
SUMOTime myHaltingTimeThreshold
std::string myID
 The name of the object.
SUMOTime myLastResetTime
 Information when the last reset has been done.
std::vector< MSE3LeaveReminder * > myLeaveReminders
 The detector's built exit reminder.
std::map< SUMOVehicle *, E3ValuesmyLeftContainer
 Container for vehicles that have left the area.
Storages for current values
SUMOReal myCurrentMeanSpeed
 The current mean speed of known vehicles (inside)
SUMOReal myCurrentHaltingsNumber
 The current number of haltings (inside)
SUMOReal myCurrentTouchedVehicles
 The current number of vehicles inside;.

Private Member Functions

 MSE3Collector (const MSE3Collector &)
 Invalidated copy constructor.
MSE3Collectoroperator= (const MSE3Collector &)
 Invalidated assignment operator.

Detailed Description

A detector of vehicles passing an area between entry/exit points.

E3 detectors are defined by a set of in-cross-sections and out-cross-sections. Vehicles, that pass an in- and out-cross-section are detected when they pass the out-cross-section. Vehicles passing the out-cross-section without having passed the in-cross-section are not detected.

Definition at line 64 of file MSE3Collector.h.

Constructor & Destructor Documentation

MSE3Collector::MSE3Collector ( const std::string &  id,
const CrossSectionVector entries,
const CrossSectionVector exits,
SUMOReal  haltingSpeedThreshold,
SUMOTime  haltingTimeThreshold 
)

Constructor.

Sets reminder objects on entry- and leave-lanes

Parameters
[in]idThe detector's unique id.
[in]entriesEntry-cross-sections.
[in]exitsLeavey-cross-sections.
[in]haltingSpeedThresholdA vehicle must not drive a greater speed than haltingSpeedThreshold to be a "halting" vehicle.
[in]haltingTimeThresholdA vehicle must not drive a greater speed for more than haltingTimeThreshold to be a "halting" vehicle.

Definition at line 129 of file MSE3Collector.cpp.

References myEntryReminders, myLeaveReminders, and reset().

MSE3Collector::~MSE3Collector ( )
virtual

Destructor.

Definition at line 149 of file MSE3Collector.cpp.

References myEntryReminders, and myLeaveReminders.

MSE3Collector::MSE3Collector ( const MSE3Collector )
private

Invalidated copy constructor.

Member Function Documentation

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

Adds this object to the given container.

Parameters
in,filled]cont The container to add this item to

Definition at line 114 of file Named.h.

References Named::StoringVisitor::add().

virtual GUIDetectorWrapper* MSDetectorFileOutput::buildDetectorGUIRepresentation ( )
inlinevirtualinherited

Builds the graphical representation.

Meant to be overridden by graphical versions of the detectors

Returns
A wrapper for the detector which performs the user I/O within the GUI

Reimplemented in GUI_E2_ZS_Collector, GUIInductLoop, GUIE3Collector, GUI_E2_ZS_CollectorOverLanes, and GUIInstantInductLoop.

Definition at line 123 of file MSDetectorFileOutput.h.

void MSE3Collector::detectorUpdate ( const SUMOTime  step)
virtual

Computes the detector values in each time step.

This method should be called at the end of a simulation step, when all vehicles have moved. The current values are computed and summed up with the previous.

Parameters
[in]currentTimeThe current simulation time (unused)

Reimplemented from MSDetectorFileOutput.

Definition at line 295 of file MSE3Collector.cpp.

References MSE3Collector::E3Values::entryTime, SUMOVehicle::getSpeed(), MSE3Collector::E3Values::hadUpdate, MSE3Collector::E3Values::haltingBegin, MSE3Collector::E3Values::haltings, MSE3Collector::E3Values::intervalHaltings, MSE3Collector::E3Values::intervalSpeedSum, myCurrentHaltingsNumber, myCurrentMeanSpeed, myCurrentTouchedVehicles, myEnteredContainer, myHaltingSpeedThreshold, myHaltingTimeThreshold, MSE3Collector::E3Values::speedSum, SUMOReal, and TS.

void MSE3Collector::enter ( SUMOVehicle veh,
SUMOReal  entryTimestep 
)
SUMOReal MSE3Collector::getCurrentHaltingNumber ( ) const

Returns the number of current haltings within the area.

If no vehicle is within the area, 0 is returned.

Returns
The mean number of haltings within the area

Definition at line 348 of file MSE3Collector.cpp.

References myCurrentHaltingsNumber.

Referenced by GUIE3Collector::MyWrapper::getParameterWindow(), and TraCIServerAPI_MeMeDetector::processGet().

SUMOReal MSE3Collector::getCurrentMeanSpeed ( ) const

Returns the mean speed within the area.

If no vehicle is within the area, -1 is returned.

Returns
The mean speed [m/s] of all vehicles within the area, -1 if there is none

Definition at line 335 of file MSE3Collector.cpp.

References myEnteredContainer, and SUMOReal.

Referenced by GUIE3Collector::MyWrapper::getParameterWindow(), and TraCIServerAPI_MeMeDetector::processGet().

std::vector< std::string > MSE3Collector::getCurrentVehicleIDs ( ) const

Returns the number of vehicles within the area.

Returns
The number of vehicles that have passed the entry, but not yet an exit point

Definition at line 360 of file MSE3Collector.cpp.

References myEnteredContainer.

Referenced by TraCIServerAPI_MeMeDetector::processGet().

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

Returns the id.

Returns
The stored id

Reimplemented in MS_E2_ZS_CollectorOverLanes.

Definition at line 60 of file Named.h.

References Named::myID.

Referenced by Named::StoringVisitor::add(), MSDetectorControl::add(), RORouteDef::addAlternative(), MSNet::addBusStop(), NBLoadedSUMOTLDef::addConnection(), NLHandler::addConnection(), RONet::addEdge(), ROJTREdge::addFollowerProbability(), RONet::addNode(), NIImporter_SUMO::addPhase(), RONet::addRouteDef(), NBDistrict::addSink(), NBDistrict::addSource(), NBTrafficLightLogic::addStep(), MSRouteHandler::addStop(), NIXMLTrafficLightsHandler::addTlConnection(), NIVissimDisturbance::addToNode(), MSVehicle::addTraciStop(), MSPerson::MSPersonStage_Driving::beginEventOutput(), MSPerson::MSPersonStage_Waiting::beginEventOutput(), NIVisumTL::build(), RODFNet::buildApproachList(), MS_E2_ZS_CollectorOverLanes::buildCollector(), NIImporter_VISUM::buildDistrictNode(), NIVissimConnection::buildEdgeConnections(), RODFNet::buildEdgeFlowMap(), NBEdge::buildInnerEdges(), NGEdge::buildNBEdge(), NIVissimEdge::buildNBEdge(), NBRampsComputer::buildOffRamp(), NBRampsComputer::buildOnRamp(), MSVehicleTransfer::checkInsertions(), ODDistrictHandler::closeDistrict(), NLHandler::closeEdge(), RORouteHandler::closeRouteDistribution(), RORouteHandler::closeVehicle(), NBTrafficLightDefinition::collectAllLinks(), NBTrafficLightDefinition::collectEdges(), ROJTRRouter::compute(), NBTrafficLightDefinition::compute(), NBNode::computeInternalLaneShape(), NBEdge::computeLaneShapes(), NBNode::computeLogic(), NBNode::computeNodeShape(), NBTrafficLightLogicCont::computeSingleLogic(), NBTurningDirectionsComputer::computeTurnDirectionsForNode(), NGNet::connect(), NBEdge::connections_sorter(), NLDetectorBuilder::convUncontE2PosLength(), MSLane::detectCollisions(), NIVissimDistrictConnection::dict_BuildDistricts(), MSPerson::MSPersonStage_Driving::endEventOutput(), MSPerson::MSPersonStage_Waiting::endEventOutput(), enter(), MSCalibrator::execute(), Command_SaveTLSSwitches::execute(), MSVTypeProbe::execute(), MSVehicle::executeMove(), MSLane::executeMovements(), NBNodeCont::extract(), NBTrafficLightLogicCont::extract(), NBEdgeCont::extract(), RODFDetectorCon::getAggFlowFor(), RODFDetectorCon::getAnyDetectorForEdge(), MSNet::getBusStopID(), MS_E2_ZS_CollectorOverLanes::getLanePredeccessorLanes(), AGStreet::getName(), NIImporter_VISUM::getNamedEdgeContinuating(), NLTriggerBuilder::getPosition(), NLDetectorBuilder::getPositionChecking(), NBNode::getPossiblySplittedIncoming(), NBNode::getPossiblySplittedOutgoing(), NIImporter_VISUM::getReversedContinuating(), NBEdgeCont::ignoreFilterMatch(), MSActuatedTrafficLightLogic::init(), MSAgentbasedTrafficLightLogic::init(), NIImporter_SUMO::initTrafficLightLogic(), NIXMLTrafficLightsHandler::initTrafficLightLogic(), NBDistrictCont::insert(), NBTrafficLightLogicCont::insert(), NBNodeCont::insert(), NBEdgeCont::insert(), NBEdgeCont::joinSameNodeConnectingEdges(), leave(), NIImporter_OpenDrive::loadNetwork(), NBRampsComputer::moveRampRight(), MSPerson::MSPersonStage_Waiting::MSPersonStage_Waiting(), MSVehicle::MSVehicle(), NBOwnTLDef::myCompute(), NBLoadedTLDef::myCompute(), NIXMLTrafficLightsHandler::myEndElement(), NIXMLEdgesHandler::myEndElement(), NIImporter_SUMO::myEndElement(), NIXMLConnectionsHandler::myStartElement(), MSLaneSpeedTrigger::myStartElement(), MSTriggeredRerouter::myStartElement(), NBConnection::NBConnection(), NBRequest::NBRequest(), MSDevice_Tripinfo::notifyEnter(), MSDevice_Tripinfo::notifyLeave(), MSDevice_Person::notifyLeave(), RORouteHandler::openRoute(), Named::ComparatorIdLess::operator()(), NBTurningDirectionsComputer::combination_by_angle_sorter::operator()(), RODFNet::idComp::operator()(), NBOwnTLDef::edge_by_incoming_priority_sorter::operator()(), NBNetBuilder::by_id_sorter::operator()(), NBContHelper::same_connection_edge_sorter::operator()(), NBNode::nodes_by_id_sorter::operator()(), MSEdge::by_id_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(), NBLoadedTLDef::SignalGroup::patchTYellow(), AGStreet::print(), TraCIServerAPI_InductionLoop::processGet(), TraCIServerAPI_TLS::processGet(), TraCIServerAPI_Lane::processGet(), TraCIServerAPI_Vehicle::processGet(), TraCIServerAPI_Vehicle::processSet(), NWWriter_SUMO::prohibitionConnection(), NBEdgeCont::recheckPostProcessConnections(), NBLoadedTLDef::SignalGroup::remapIncoming(), NBLoadedTLDef::SignalGroup::remapOutgoing(), NBLoadedSUMOTLDef::removeConnection(), NBNode::removeSelfLoops(), NBEdgeCont::removeUnwishedEdges(), NBNodeCont::removeUnwishedNodes(), NBNodeCont::rename(), NBEdgeCont::rename(), NBConnection::replaceFrom(), MSBaseVehicle::replaceRouteEdges(), NBConnection::replaceTo(), NIImporter_DlrNavteq::TrafficlightsHandler::report(), NIXMLTrafficLightsHandler::retrieveLaneIndex(), PCPolyContainer::save(), RONet::saveAndRemoveRoutesUntil(), NBNodeCont::setAsTLControlled(), NBEdge::setControllingTLInformation(), NIXMLEdgesHandler::setNodes(), NBOwnTLDef::setTLControllingInformation(), NBLoadedSUMOTLDef::setTLControllingInformation(), NBLoadedTLDef::setTLControllingInformation(), NBEdgeCont::splitAt(), NIXMLConnectionsHandler::validateLaneInfo(), TraCIServerAPI_Vehicle::vtdMap_matchingEdgeLane(), TraCIServerAPI_Vehicle::vtdMap_matchingRoutePosition(), MSEmissionExport::write(), MSFCDExport::write(), MSInstantInductLoop::write(), NBSign::writeAsPOI(), NWWriter_SUMO::writeConnection(), NWWriter_SUMO::writeDistrict(), MSFullExport::writeEdge(), MSXMLRawOut::writeEdge(), NWWriter_SUMO::writeEdge(), MSMeanData::writeEdge(), NWWriter_XML::writeEdgesAndConnections(), NWWriter_SUMO::writeInternalConnections(), NWWriter_SUMO::writeJunction(), MSQueueExport::writeLane(), MSFullExport::writeLane(), NWWriter_DlrNavteq::writeLinksUnsplitted(), NWWriter_OpenDrive::writeNetwork(), NWWriter_XML::writeNodes(), NWWriter_DlrNavteq::writeNodesUnsplitted(), MSInductLoop::writeTypedXMLOutput(), MSFullExport::writeVehicles(), MSRouteProbe::writeXMLOutput(), and MSE2Collector::writeXMLOutput().

SUMOReal MSE3Collector::getVehiclesWithin ( ) const

Returns the number of vehicles within the area.

Returns
The number of vehicles that passed the entry collector

Definition at line 354 of file MSE3Collector.cpp.

References myEnteredContainer, and SUMOReal.

Referenced by GUIE3Collector::MyWrapper::getParameterWindow(), and TraCIServerAPI_MeMeDetector::processGet().

void MSE3Collector::leave ( SUMOVehicle veh,
SUMOReal  leaveTimestep 
)
MSE3Collector& MSE3Collector::operator= ( const MSE3Collector )
private

Invalidated assignment operator.

void MSE3Collector::reset ( )
virtual

Resets all generated values to allow computation of next interval.

Reimplemented from MSDetectorFileOutput.

Definition at line 160 of file MSE3Collector.cpp.

References myLeftContainer.

Referenced by MSE3Collector().

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

resets the id

Parameters
[in]newIDThe new id of this object

Definition at line 68 of file Named.h.

References Named::myID.

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

void MSE3Collector::writeXMLDetectorProlog ( OutputDevice dev) const
virtual

Opens the XML-output using "e3Detector" as root element.

The lists of entries/exists are written, too.

Parameters
[in]devThe output device to write the root into
See Also
MSDetectorFileOutput::writeXMLDetectorProlog
Exceptions
IOErrorIf an error on writing occurs (!!! not yet implemented)

Implements MSDetectorFileOutput.

Definition at line 289 of file MSE3Collector.cpp.

References OutputDevice::writeXMLHeader().

void MSE3Collector::writeXMLOutput ( OutputDevice dev,
SUMOTime  startTime,
SUMOTime  stopTime 
)
virtual

Writes collected values into the given stream.

Parameters
[in]devThe output device to write the data into
[in]startTimeFirst time step the data were gathered
[in]stopTimeLast time step the data were gathered
See Also
MSDetectorFileOutput::writeXMLOutput
Exceptions
IOErrorIf an error on writing occurs (!!! not yet implemented)

Implements MSDetectorFileOutput.

Definition at line 222 of file MSE3Collector.cpp.

References MIN2(), myEnteredContainer, Named::myID, myLastResetTime, myLeftContainer, SUMOReal, and time2string().

Field Documentation

SUMOReal MSE3Collector::myCurrentHaltingsNumber
protected

The current number of haltings (inside)

Definition at line 376 of file MSE3Collector.h.

Referenced by detectorUpdate(), and getCurrentHaltingNumber().

SUMOReal MSE3Collector::myCurrentMeanSpeed
protected

The current mean speed of known vehicles (inside)

Definition at line 373 of file MSE3Collector.h.

Referenced by detectorUpdate().

SUMOReal MSE3Collector::myCurrentTouchedVehicles
protected

The current number of vehicles inside;.

Please note, that vehicles that enter the area are given as a fraction

See Also
execute

Definition at line 383 of file MSE3Collector.h.

Referenced by detectorUpdate().

std::map<SUMOVehicle*, E3Values> MSE3Collector::myEnteredContainer
protected

Container for vehicles that have entered the area.

Definition at line 363 of file MSE3Collector.h.

Referenced by detectorUpdate(), enter(), getCurrentMeanSpeed(), getCurrentVehicleIDs(), getVehiclesWithin(), leave(), and writeXMLOutput().

CrossSectionVector MSE3Collector::myEntries
protected

The detector's entries.

Definition at line 317 of file MSE3Collector.h.

Referenced by GUIE3Collector::getEntries().

std::vector<MSE3EntryReminder*> MSE3Collector::myEntryReminders
protected

The detector's built entry reminder.

Definition at line 323 of file MSE3Collector.h.

Referenced by MSE3Collector(), and ~MSE3Collector().

CrossSectionVector MSE3Collector::myExits
protected

The detector's exits.

Definition at line 320 of file MSE3Collector.h.

Referenced by GUIE3Collector::getExits().

SUMOReal MSE3Collector::myHaltingSpeedThreshold
protected

Speed-threshold to determine if a vehicle is halting.

Definition at line 333 of file MSE3Collector.h.

Referenced by detectorUpdate(), enter(), and leave().

SUMOTime MSE3Collector::myHaltingTimeThreshold
protected

Definition at line 330 of file MSE3Collector.h.

Referenced by detectorUpdate(), enter(), and leave().

SUMOTime MSE3Collector::myLastResetTime
protected

Information when the last reset has been done.

Definition at line 388 of file MSE3Collector.h.

Referenced by writeXMLOutput().

std::vector<MSE3LeaveReminder*> MSE3Collector::myLeaveReminders
protected

The detector's built exit reminder.

Definition at line 326 of file MSE3Collector.h.

Referenced by MSE3Collector(), and ~MSE3Collector().

std::map<SUMOVehicle*, E3Values> MSE3Collector::myLeftContainer
protected

Container for vehicles that have left the area.

Definition at line 366 of file MSE3Collector.h.

Referenced by leave(), reset(), and writeXMLOutput().


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