Data structure for mean (aggregated) edge/lane values. More...

#include <MSMeanData_Amitran.h>

Inheritance diagram for MSMeanData_Amitran::MSLaneMeanDataValues:

Collaboration diagram for MSMeanData_Amitran::MSLaneMeanDataValues:

Public Member Functions
void	addTo (MSMeanData::MeanDataValues &val) const
	Add the values of this to the given one and store them there. More...

virtual double	getAttributeValue (SumoXMLAttr a, const SUMOTime period, const double numLanes, const double speedLimit) const
	return attribute value More...

const std::string &	getDescription () const

const MSLane *	getLane () const
	Returns the lane the reminder works on. More...

double	getLaneLength () const

SUMOTime	getResetTime () const

virtual double	getSamples () const
	Returns the number of collected sample seconds. More...

double	getTravelledDistance () const
	Returns the total travelled distance. More...

virtual bool	isParkingRerouter () const

	MSLaneMeanDataValues (MSLane const lane, const double length, const bool doAdd, const MSMeanData_Amitran parent)
	Constructor. More...

virtual bool	notifyLeave (SUMOTrafficObject &veh, double lastPos, MSMoveReminder::Notification reason, const MSLane *enteredLane=0)
	Called if the vehicle leaves the reminder's lane. More...

bool	notifyMove (SUMOTrafficObject &veh, double oldPos, double newPos, double newSpeed)
	Checks whether the reminder still has to be notified about the vehicle moves. More...

void	reset (bool afterWrite=false)
	Resets values so they may be used for the next interval. More...

void	setDescription (const std::string &description)

virtual void	update ()
	Called if a per timestep update is needed. Default does nothing. More...

virtual	~MSLaneMeanDataValues ()
	Destructor. More...

Interface methods, to be derived by subclasses
virtual bool	notifyIdle (SUMOTrafficObject &veh)
	Computes idling emission values and adds them to the emission sums. More...

virtual void	notifyParking ()
	called to update state for parking vehicles More...

virtual void	notifyStopEnded ()
	called to update state for stopped vehicles More...

void	updateDetector (SUMOTrafficObject &veh, double entryPos, double leavePos, SUMOTime entryTime, SUMOTime currentTime, SUMOTime leaveTime, bool cleanUp)

Protected Member Functions
void	removeFromVehicleUpdateValues (SUMOTrafficObject &veh)

Protected Attributes
std::string	myDescription
	a description of this moveReminder More...

MSLane *const	myLane
	Lane on which the reminder works. More...

const double	myLaneLength
	The length of the lane / edge the data collector is on. More...

const MSMeanData *const	myParent
	The meandata parent. More...

Collected values
The number of sampled vehicle movements (in s)
double	sampleSeconds

double	travelledDistance
	The sum of the distances the vehicles travelled. More...

SUMOTime	resetTime
	time at which collection was reset; More...

Private Attributes
std::map< SUMOTrafficObject *, std::pair< SUMOTime, double > >	myLastVehicleUpdateValues

Collected values
The number of vehicles that entered this lane within the sample interval
int	amount

std::map< const MSVehicleType *, int >	typedAmount
	The number of vehicles that entered this lane within the sample interval by type. More...

std::map< const MSVehicleType *, double >	typedSamples
	The number of sampled vehicle movements by type (in s) More...

std::map< const MSVehicleType *, double >	typedTravelDistance
	The sum of the distances the vehicles travelled by type. More...

Methods inherited from MSMoveReminder
bool	notifyEnter (SUMOTrafficObject &veh, MSMoveReminder::Notification reason, const MSLane *enteredLane=0)
	Computes current values and adds them to their sums. More...

bool	isEmpty () const
	Returns whether any data was collected. More...

void	write (OutputDevice &dev, long long int attributeMask, const SUMOTime period, const int numLanes, const double speedLimit, const double defaultTravelTime, const int numVehicles=-1) const
	Writes output values into the given stream. More...

void	notifyMoveInternal (const SUMOTrafficObject &veh, const double, const double timeOnLane, const double, const double meanSpeedVehicleOnLane, const double travelledDistanceFrontOnLane, const double travelledDistanceVehicleOnLane, const double)
	Internal notification about the vehicle moves. More...

Detailed Description

Data structure for mean (aggregated) edge/lane values.

Structure holding values that describe the flow and other physical properties aggregated over some seconds.

Definition at line 63 of file MSMeanData_Amitran.h.

Member Enumeration Documentation

◆ Notification

enum MSMoveReminder::Notification

inherited

Definition of a vehicle state.

Enumerator
NOTIFICATION_DEPARTED	The vehicle has departed (was inserted into the network)
NOTIFICATION_JUNCTION	The vehicle arrived at a junction.
NOTIFICATION_SEGMENT	The vehicle changes the segment (meso only)
NOTIFICATION_LANE_CHANGE	The vehicle changes lanes (micro only)
NOTIFICATION_LOAD_STATE	The vehicle has been loaded from a state file.
NOTIFICATION_TELEPORT	The vehicle is being teleported.
NOTIFICATION_TELEPORT_CONTINUATION	The vehicle continues being teleported past an edge.
NOTIFICATION_PARKING	The vehicle starts or ends parking.
NOTIFICATION_PARKING_REROUTE	The vehicle needs another parking area.
NOTIFICATION_ARRIVED	The vehicle arrived at its destination (is deleted)
NOTIFICATION_TELEPORT_ARRIVED	The vehicle was teleported out of the net.
NOTIFICATION_VAPORIZED_CALIBRATOR	The vehicle got removed by a calibrator.
NOTIFICATION_VAPORIZED_COLLISION	The vehicle got removed by a collision.
NOTIFICATION_VAPORIZED_TRACI	The vehicle got removed via TraCI.
NOTIFICATION_VAPORIZED_GUI	The vehicle got removed via the GUI.
NOTIFICATION_VAPORIZED_VAPORIZER	The vehicle got vaporized with a vaporizer.
NOTIFICATION_VAPORIZED_BREAKDOWN	The vehicle got removed via stationfinder device.

Definition at line 89 of file MSMoveReminder.h.

Constructor & Destructor Documentation

◆ MSLaneMeanDataValues()

MSMeanData_Amitran::MSLaneMeanDataValues::MSLaneMeanDataValues	(	MSLane *const	lane,
		const double	length,
		const bool	doAdd,
		const MSMeanData_Amitran *	parent
	)

Constructor.

Parameters

[in] length The length of the object for which the data gets collected

Definition at line 40 of file MSMeanData_Amitran.cpp.

◆ ~MSLaneMeanDataValues()

MSMeanData_Amitran::MSLaneMeanDataValues::~MSLaneMeanDataValues ( )

virtual

Destructor.

Definition at line 47 of file MSMeanData_Amitran.cpp.

Member Function Documentation

◆ addTo()

void MSMeanData_Amitran::MSLaneMeanDataValues::addTo ( MSMeanData::MeanDataValues & val ) const

virtual

Add the values of this to the given one and store them there.

Parameters

[in] val The meandata to add to

Implements MSMeanData::MeanDataValues.

Definition at line 62 of file MSMeanData_Amitran.cpp.

References amount, MSMeanData::MeanDataValues::sampleSeconds, MSMeanData::MeanDataValues::travelledDistance, typedAmount, typedSamples, and typedTravelDistance.

◆ getAttributeValue()

virtual double MSMeanData::MeanDataValues::getAttributeValue	(	SumoXMLAttr	a,
		const SUMOTime	period,
		const double	numLanes,
		const double	speedLimit
	)		const

inlinevirtualinherited

return attribute value

Reimplemented in MSMeanData_Net::MSLaneMeanDataValues.

Definition at line 169 of file MSMeanData.h.

References UNUSED_PARAMETER.

Referenced by MSMeanData_Net::getAttributeValue().

Here is the caller graph for this function:

◆ getDescription()

const std::string& MSMoveReminder::getDescription ( ) const

inlineinherited

Definition at line 261 of file MSMoveReminder.h.

References MSMoveReminder::myDescription.

◆ getLane()

const MSLane* MSMoveReminder::getLane ( ) const

inlineinherited

Returns the lane the reminder works on.

Returns: The lane the reminder is anchored on.

Definition at line 83 of file MSMoveReminder.h.

References MSMoveReminder::myLane.

Referenced by LIBSUMO_NAMESPACE::InductionLoop::getTree(), GUIInductLoop::MyWrapper::MyWrapper(), GUIInstantInductLoop::MyWrapper::MyWrapper(), MSDevice_Tripinfo::notifyEnter(), MSDevice_Tripinfo::notifyLeave(), LIBSUMO_NAMESPACE::InductionLoop::storeShape(), and MSMeanData::writeEdge().

Here is the caller graph for this function:

◆ getLaneLength()

double MSMeanData::MeanDataValues::getLaneLength ( ) const

inlineinherited

Definition at line 164 of file MSMeanData.h.

References MSMeanData::MeanDataValues::myLaneLength.

◆ getResetTime()

SUMOTime MSMeanData::MeanDataValues::getResetTime ( ) const

inlineinherited

Definition at line 160 of file MSMeanData.h.

References MSMeanData::MeanDataValues::resetTime.

◆ getSamples()

double MSMeanData::MeanDataValues::getSamples ( ) const

virtualinherited

Returns the number of collected sample seconds.

Returns: the number of collected sample seconds

Reimplemented in MSMeanData::MeanDataValueTracker.

Definition at line 280 of file MSMeanData.cpp.

Referenced by MSCalibrator::currentSpeed(), MSMeanData::writePrefix(), MEInductLoop::writeXMLOutput(), and MSCalibrator::writeXMLOutput().

Here is the caller graph for this function:

◆ getTravelledDistance()

double MSMeanData::MeanDataValues::getTravelledDistance ( ) const

inlineinherited

Returns the total travelled distance.

Returns: the total travelled distance

Definition at line 156 of file MSMeanData.h.

References MSMeanData::MeanDataValues::travelledDistance.

Referenced by MSCalibrator::currentSpeed(), LIBSUMO_NAMESPACE::InductionLoop::getIntervalMeanSpeed(), and MSCalibrator::writeXMLOutput().

Here is the caller graph for this function:

◆ isEmpty()

bool MSMeanData_Amitran::MSLaneMeanDataValues::isEmpty ( ) const

virtual

Returns whether any data was collected.

Returns: whether no data was collected

Reimplemented from MSMeanData::MeanDataValues.

Definition at line 104 of file MSMeanData_Amitran.cpp.

◆ isParkingRerouter()

virtual bool MSMoveReminder::isParkingRerouter ( ) const

inlinevirtualinherited

Reimplemented in MSTriggeredRerouter.

Definition at line 266 of file MSMoveReminder.h.

◆ notifyEnter()

bool MSMeanData_Amitran::MSLaneMeanDataValues::notifyEnter	(	SUMOTrafficObject &	veh,
		MSMoveReminder::Notification	reason,
		const MSLane *	enteredLane = `0`
	)

virtual

Computes current values and adds them to their sums.

The fraction of time the vehicle is on the lane is computed and used as a weight for the vehicle's current values. The "emitted" field is incremented, additionally.

Parameters

[in]	veh	The vehicle that enters the lane
[in]	veh	The entering vehicle.
[in]	reason	how the vehicle enters the lane

Returns: Always true

See also: MSMoveReminder::notifyEnter; MSMoveReminder::Notification

Reimplemented from MSMeanData::MeanDataValues.

Definition at line 89 of file MSMeanData_Amitran.cpp.

References SUMOTrafficObject::getVehicleType(), MSMoveReminder::NOTIFICATION_DEPARTED, and MSMoveReminder::NOTIFICATION_JUNCTION.

◆ notifyIdle()

virtual bool MSMoveReminder::notifyIdle ( SUMOTrafficObject & veh )

inlinevirtualinherited

Computes idling emission values and adds them to the emission sums.

Idling implied by zero velocity, acceleration and slope

Parameters

[in] veh The vehicle

See also: MSMoveReminder::notifyMove; PollutantsInterface

Reimplemented in MSMeanData_Emissions::MSLaneMeanDataValues, MSDevice_Tripinfo, MSDevice_StationFinder, and MSDevice_Emissions.

Definition at line 183 of file MSMoveReminder.h.

References UNUSED_PARAMETER.

◆ notifyLeave()

bool MSMeanData::MeanDataValues::notifyLeave	(	SUMOTrafficObject &	veh,
		double	lastPos,
		MSMoveReminder::Notification	reason,
		const MSLane *	enteredLane = `0`
	)

virtualinherited

Called if the vehicle leaves the reminder's lane.

Parameters

	veh	The leaving vehicle.
[in]	lastPos	Position on the lane when leaving.
[in]	reason	how the vehicle leaves the lane

See also: MSMoveReminder; MSMoveReminder::notifyLeave

Reimplemented from MSMoveReminder.

Reimplemented in MSMeanData_Net::MSLaneMeanDataValues, and MSMeanData::MeanDataValueTracker.

Definition at line 260 of file MSMeanData.cpp.

References MSGlobals::gUseMesoSim, and MSMoveReminder::NOTIFICATION_JUNCTION.

◆ notifyMove()

bool MSMeanData::MeanDataValues::notifyMove	(	SUMOTrafficObject &	veh,
		double	oldPos,
		double	newPos,
		double	newSpeed
	)

virtualinherited

Checks whether the reminder still has to be notified about the vehicle moves.

Indicator if the reminders is still active for the passed vehicle/parameters. If false, the vehicle will erase this reminder from its reminder-container.

Parameters

[in]	veh	Vehicle that asks this reminder.
[in]	oldPos	Position before move.
[in]	newPos	Position after move with newSpeed.
[in]	newSpeed	Moving speed.

Returns: True if vehicle hasn't passed the reminder completely.

Reimplemented from MSMoveReminder.

Definition at line 87 of file MSMeanData.cpp.

References Named::getID(), MSVehicleType::getLength(), SUMOTrafficObject::getPreviousSpeed(), SUMOTrafficObject::getVehicleType(), MSGlobals::gNumSimThreads, MSGlobals::gSemiImplicitEulerUpdate, SUMOTrafficObject::hasArrived(), MAX2(), MIN2(), MIN4(), MSCFModel::passingTime(), MSCFModel::speedAfterTime(), TL, TS, WRITE_ERROR, and WRITE_ERRORF.

◆ notifyMoveInternal()

void MSMeanData_Amitran::MSLaneMeanDataValues::notifyMoveInternal	(	const SUMOTrafficObject &	veh,
		const double	,
		const double	timeOnLane,
		const double	,
		const double	meanSpeedVehicleOnLane,
		const double	travelledDistanceFrontOnLane,
		const double	travelledDistanceVehicleOnLane,
		const double
	)

protectedvirtual

Internal notification about the vehicle moves.

See also: MSMoveReminder::notifyMoveInternal()

Reimplemented from MSMoveReminder.

Definition at line 80 of file MSMeanData_Amitran.cpp.

References SUMOTrafficObject::getVehicleType().

◆ notifyParking()

virtual void MSMoveReminder::notifyParking ( )

inlinevirtualinherited

called to update state for parking vehicles

Reimplemented in MSDevice_Battery.

Definition at line 189 of file MSMoveReminder.h.

◆ notifyStopEnded()

virtual void MSMoveReminder::notifyStopEnded ( )

inlinevirtualinherited

called to update state for stopped vehicles

Reimplemented in MSDevice_Vehroutes, and MSDevice_Routing.

Definition at line 192 of file MSMoveReminder.h.

◆ removeFromVehicleUpdateValues()

void MSMoveReminder::removeFromVehicleUpdateValues ( SUMOTrafficObject & veh )

protectedinherited

Definition at line 89 of file MSMoveReminder.cpp.

References MSMoveReminder::myLastVehicleUpdateValues.

Referenced by MSMoveReminder::updateDetector().

Here is the caller graph for this function:

◆ reset()

void MSMeanData_Amitran::MSLaneMeanDataValues::reset ( bool afterWrite = false )

virtual

Resets values so they may be used for the next interval.

Implements MSMeanData::MeanDataValues.

Definition at line 52 of file MSMeanData_Amitran.cpp.

References SIMSTEP.

◆ setDescription()

void MSMoveReminder::setDescription ( const std::string & description )

inlineinherited

Definition at line 257 of file MSMoveReminder.h.

References MSMoveReminder::myDescription.

Referenced by MSMeanData::init(), MEInductLoop::MEInductLoop(), METriggeredCalibrator::METriggeredCalibrator(), and MSCalibrator::MSCalibrator().

Here is the caller graph for this function:

◆ update()

void MSMeanData::MeanDataValues::update ( )

virtualinherited

Called if a per timestep update is needed. Default does nothing.

Reimplemented in MSMeanData_Harmonoise::MSLaneMeanDataValues.

Definition at line 275 of file MSMeanData.cpp.

◆ updateDetector()

void MSMoveReminder::updateDetector	(	SUMOTrafficObject &	veh,
		double	entryPos,
		double	leavePos,
		SUMOTime	entryTime,
		SUMOTime	currentTime,
		SUMOTime	leaveTime,
		bool	cleanUp
	)

inherited

Definition at line 47 of file MSMoveReminder.cpp.

References MSMoveReminder::myLastVehicleUpdateValues, MSMoveReminder::notifyMoveInternal(), MSMoveReminder::removeFromVehicleUpdateValues(), and STEPS2TIME.

Referenced by MEVehicle::updateDetectorForWriting().

Here is the caller graph for this function:

◆ write()

void MSMeanData_Amitran::MSLaneMeanDataValues::write	(	OutputDevice &	dev,
		long long int	attributeMask,
		const SUMOTime	period,
		const int	numLanes,
		const double	speedLimit,
		const double	defaultTravelTime,
		const int	numVehicles = `-1`
	)		const

virtual

Writes output values into the given stream.

Parameters

[in]	dev	The output device to write the data into
[in]	period	Length of the period the data were gathered
[in]	numLanes	The total number of lanes for which the data was collected

Exceptions

IOError If an error on writing occurs (!!! not yet implemented)

Implements MSMeanData::MeanDataValues.

Definition at line 110 of file MSMeanData_Amitran.cpp.

References OutputDevice::closeTag(), OutputDevice::openTag(), SUMO_ATTR_AMOUNT, SUMO_ATTR_AVERAGESPEED, SUMO_ATTR_ID, OutputDevice::writeAttr(), and OutputDevice::writeOptionalAttr().

Field Documentation

◆ amount

int MSMeanData_Amitran::MSLaneMeanDataValues::amount

private

Definition at line 126 of file MSMeanData_Amitran.h.

Referenced by addTo().

◆ myDescription

std::string MSMoveReminder::myDescription

protectedinherited

a description of this moveReminder

Definition at line 278 of file MSMoveReminder.h.

Referenced by MSMoveReminder::getDescription(), and MSMoveReminder::setDescription().

◆ myLane

MSLane* const MSMoveReminder::myLane

protectedinherited

Lane on which the reminder works.

Definition at line 276 of file MSMoveReminder.h.

Referenced by MSE2Collector::detectorUpdate(), MSInductLoop::detectorUpdate(), MSE2Collector::getEstimatedCurrentVehicleNumber(), MSE2Collector::getEstimateQueueLength(), MSMoveReminder::getLane(), MSMoveReminder::MSMoveReminder(), MSE2Collector::notifyEnter(), MSInductLoop::notifyEnter(), MSE2Collector::notifyLeave(), and MSE2Collector::notifyMove().

◆ myLaneLength

const double MSMeanData::MeanDataValues::myLaneLength

protectedinherited

The length of the lane / edge the data collector is on.

Definition at line 182 of file MSMeanData.h.

Referenced by MSMeanData::MeanDataValues::getLaneLength().

◆ myLastVehicleUpdateValues

std::map<SUMOTrafficObject*, std::pair<SUMOTime, double> > MSMoveReminder::myLastVehicleUpdateValues

privateinherited

Definition at line 286 of file MSMoveReminder.h.

Referenced by MSMoveReminder::removeFromVehicleUpdateValues(), and MSMoveReminder::updateDetector().

◆ myParent

const MSMeanData* const MSMeanData::MeanDataValues::myParent

protectedinherited

The meandata parent.

Definition at line 179 of file MSMeanData.h.

◆ resetTime

SUMOTime MSMeanData::MeanDataValues::resetTime

protectedinherited

time at which collection was reset;

Definition at line 194 of file MSMeanData.h.

Referenced by MSMeanData::MeanDataValues::getResetTime().

◆ sampleSeconds

double MSMeanData::MeanDataValues::sampleSeconds

protectedinherited

Definition at line 187 of file MSMeanData.h.

Referenced by addTo(), MSMeanData_Emissions::MSLaneMeanDataValues::addTo(), MSMeanData_Harmonoise::MSLaneMeanDataValues::addTo(), and MSMeanData_Net::MSLaneMeanDataValues::addTo().

◆ travelledDistance

double MSMeanData::MeanDataValues::travelledDistance

protectedinherited

The sum of the distances the vehicles travelled.

Definition at line 190 of file MSMeanData.h.

Referenced by addTo(), MSMeanData_Emissions::MSLaneMeanDataValues::addTo(), MSMeanData_Harmonoise::MSLaneMeanDataValues::addTo(), MSMeanData_Net::MSLaneMeanDataValues::addTo(), and MSMeanData::MeanDataValues::getTravelledDistance().

◆ typedAmount

std::map<const MSVehicleType*, int> MSMeanData_Amitran::MSLaneMeanDataValues::typedAmount

private

The number of vehicles that entered this lane within the sample interval by type.

Definition at line 129 of file MSMeanData_Amitran.h.

Referenced by addTo().

◆ typedSamples

std::map<const MSVehicleType*, double> MSMeanData_Amitran::MSLaneMeanDataValues::typedSamples

private

The number of sampled vehicle movements by type (in s)

Definition at line 132 of file MSMeanData_Amitran.h.

Referenced by addTo().

◆ typedTravelDistance

std::map<const MSVehicleType*, double> MSMeanData_Amitran::MSLaneMeanDataValues::typedTravelDistance

private

The sum of the distances the vehicles travelled by type.

Definition at line 135 of file MSMeanData_Amitran.h.

Referenced by addTo().

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

Public Types
enum	Notification { NOTIFICATION_DEPARTED , NOTIFICATION_JUNCTION , NOTIFICATION_SEGMENT , NOTIFICATION_LANE_CHANGE , NOTIFICATION_LOAD_STATE , NOTIFICATION_TELEPORT , NOTIFICATION_TELEPORT_CONTINUATION , NOTIFICATION_PARKING , NOTIFICATION_PARKING_REROUTE , NOTIFICATION_ARRIVED , NOTIFICATION_TELEPORT_ARRIVED , NOTIFICATION_VAPORIZED_CALIBRATOR , NOTIFICATION_VAPORIZED_COLLISION , NOTIFICATION_VAPORIZED_TRACI , NOTIFICATION_VAPORIZED_GUI , NOTIFICATION_VAPORIZED_VAPORIZER , NOTIFICATION_VAPORIZED_BREAKDOWN }
	Definition of a vehicle state. More...

Public Types

Public Member Functions

Protected Member Functions

Protected Attributes

Private Attributes

Methods inherited from MSMoveReminder

Detailed Description

Member Enumeration Documentation

◆ Notification

Constructor & Destructor Documentation

◆ MSLaneMeanDataValues()

◆ ~MSLaneMeanDataValues()

Member Function Documentation

◆ addTo()

◆ getAttributeValue()

◆ getDescription()

◆ getLane()

◆ getLaneLength()

◆ getResetTime()

◆ getSamples()

◆ getTravelledDistance()

◆ isEmpty()

◆ isParkingRerouter()

◆ notifyEnter()

◆ notifyIdle()

◆ notifyLeave()

◆ notifyMove()

◆ notifyMoveInternal()

◆ notifyParking()

◆ notifyStopEnded()

◆ removeFromVehicleUpdateValues()

◆ reset()

◆ setDescription()

◆ update()

◆ updateDetector()

◆ write()

Field Documentation

◆ amount

◆ myDescription

◆ myLane

◆ myLaneLength

◆ myLastVehicleUpdateValues

◆ myParent

◆ resetTime

◆ sampleSeconds

◆ travelledDistance

◆ typedAmount

◆ typedSamples

◆ typedTravelDistance