A device which collects info on the vehicle trip (mainly on departure and arrival) More...

#include <MSDevice_SSM.h>

Inheritance diagram for MSDevice_SSM:

Collaboration diagram for MSDevice_SSM:

Data Structures
class	Encounter
	An encounter is an episode involving two vehicles, which are closer to each other than some specified distance. More...

struct	EncounterApproachInfo
	Structure to collect some info on the encounter needed during ssm calculation by various functions. More...

struct	FoeInfo

struct	UpstreamScanStartInfo
	Auxiliary structure used to handle upstream scanning start points Upstream scan has to be started after downstream scan is completed, see #5644. More...

Public Types
enum	EncounterType { ENCOUNTER_TYPE_NOCONFLICT_AHEAD = 0 , ENCOUNTER_TYPE_FOLLOWING = 1 , ENCOUNTER_TYPE_FOLLOWING_FOLLOWER = 2 , ENCOUNTER_TYPE_FOLLOWING_LEADER = 3 , ENCOUNTER_TYPE_ON_ADJACENT_LANES = 4 , ENCOUNTER_TYPE_MERGING = 5 , ENCOUNTER_TYPE_MERGING_LEADER = 6 , ENCOUNTER_TYPE_MERGING_FOLLOWER = 7 , ENCOUNTER_TYPE_MERGING_ADJACENT = 8 , ENCOUNTER_TYPE_CROSSING = 9 , ENCOUNTER_TYPE_CROSSING_LEADER = 10 , ENCOUNTER_TYPE_CROSSING_FOLLOWER = 11 , ENCOUNTER_TYPE_EGO_ENTERED_CONFLICT_AREA = 12 , ENCOUNTER_TYPE_FOE_ENTERED_CONFLICT_AREA = 13 , ENCOUNTER_TYPE_EGO_LEFT_CONFLICT_AREA = 14 , ENCOUNTER_TYPE_FOE_LEFT_CONFLICT_AREA = 15 , ENCOUNTER_TYPE_BOTH_ENTERED_CONFLICT_AREA = 16 , ENCOUNTER_TYPE_BOTH_LEFT_CONFLICT_AREA = 17 , ENCOUNTER_TYPE_FOLLOWING_PASSED = 18 , ENCOUNTER_TYPE_MERGING_PASSED = 19 , ENCOUNTER_TYPE_ONCOMING = 20 , ENCOUNTER_TYPE_COLLISION = 111 }
	Different types of encounters corresponding to relative positions of the vehicles. The name describes the type from the ego perspective. More...

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 Member Functions
void	addTo (const StoringVisitor &cont) const
	Adds this object to the given container.

const std::string	deviceName () const
	return the name for this type of device

void	generateOutput (OutputDevice *tripinfoOut) const
	Finalizes output. Called on vehicle removal.

const std::string &	getDescription () const

SUMOVehicle &	getHolder () const
	Returns the vehicle that holds this device.

const std::string &	getID () const
	Returns the id.

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

SUMOVehicle::NumericalID	getNumericalID () const

std::string	getParameter (const std::string &key) const
	try to retrieve the given parameter from this device. Throw exception for unsupported key

virtual bool	isParkingRerouter () const

virtual void	loadState (const SUMOSAXAttributes &attrs)
	Loads the state of the device from the given description.

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

virtual void	saveState (OutputDevice &out) const
	Saves the state of the device.

void	setDescription (const std::string &description)

virtual void	setID (const std::string &newID)
	resets the id

void	setParameter (const std::string &key, const std::string &value)
	try to set the given parameter for this device. Throw exception for unsupported key

void	updateAndWriteOutput ()
	This is called once per time step in MSNet::writeOutput() and collects the surrounding vehicles, updates information on encounters and flushes the encounters qualified as conflicts (.

	~MSDevice_SSM ()
	Destructor.

Methods called on vehicle movement / state change, overwriting MSDevice
bool	notifyMove (SUMOTrafficObject &veh, double oldPos, double newPos, double newSpeed)
	Checks for waiting steps when the vehicle moves.

bool	notifyEnter (SUMOTrafficObject &veh, MSMoveReminder::Notification reason, const MSLane *enteredLane=0)
	Called whenever the holder enteres a lane.

bool	notifyLeave (SUMOTrafficObject &veh, double lastPos, MSMoveReminder::Notification reason, const MSLane *enteredLane=0)
	Called whenever the holder leaves a lane.

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

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

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

virtual bool	notifyLeaveBack (SUMOTrafficObject &veh, Notification reason, const MSLane *leftLane)
	Called if the vehicle's back leaves the reminder's lane.

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

Static Public Member Functions
static void	buildTransportableDevices (MSTransportable &p, std::vector< MSTransportableDevice * > &into)
	Build devices for the given person, if needed.

static void	buildVehicleDevices (SUMOVehicle &v, std::vector< MSVehicleDevice * > &into)
	Build devices for the given vehicle, if needed.

static bool	checkOptions (OptionsCont &oc)
	check device-specific options

static void	cleanup ()
	Clean up remaining devices instances.

static void	cleanupAll ()
	perform cleanup for all devices

static std::string	encounterToString (EncounterType type)

static void	findSurroundingVehicles (const MSVehicle &veh, double range, FoeInfoMap &foeCollector)
	Returns all vehicles, which are within the given range of the given vehicle.

static const std::set< const MSEdge * > &	getEdgeFilter ()
	return the edges where the SSM device should scan

static SumoRNG *	getEquipmentRNG ()

template<class T >
static std::string	getIDSecure (const T *obj, const std::string &fallBack="NULL")
	get an identifier for Named-like object which may be Null

static const std::set< MSDevice_SSM *, ComparatorNumericalIdLess > &	getInstances ()
	returns all currently existing SSM devices

static void	getUpstreamVehicles (const UpstreamScanStartInfo &scanStart, FoeInfoMap &foeCollector, std::set< const MSLane * > &seenLanes, const std::set< const MSJunction * > &routeJunctions)
	Collects all vehicles within range 'range' upstream of the position 'pos' on the edge 'edge' into foeCollector.

static void	getVehiclesOnJunction (const MSJunction , const MSLane egoJunctionLane, double egoDistToConflictLane, const MSLane const egoConflictLane, FoeInfoMap &foeCollector, std::set< const MSLane > &seenLanes)
	Collects all vehicles on the junction into foeCollector.

static void	insertOptions (OptionsCont &oc)
	Inserts MSDevice_SSM-options.

Protected Member Functions
void	removeFromVehicleUpdateValues (SUMOTrafficObject &veh)

Static Protected Member Functions
Helper methods for device assignment
static void	insertDefaultAssignmentOptions (const std::string &deviceName, const std::string &optionsTopic, OptionsCont &oc, const bool isPerson=false)
	Adds common command options that allow to assign devices to vehicles.

template<class DEVICEHOLDER >
static bool	equippedByDefaultAssignmentOptions (const OptionsCont &oc, const std::string &deviceName, DEVICEHOLDER &v, bool outputOptionSet, const bool isPerson=false)
	Determines whether a vehicle should get a certain device.

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

SUMOVehicle &	myHolder
	The vehicle that stores the device.

std::string	myID
	The name of the object.

MSLane *	myLane
	Lane on which the reminder works.

Private Types
typedef std::priority_queue< Encounter , std::vector< Encounter >, Encounter::compare >	EncounterQueue

typedef std::vector< Encounter * >	EncounterVector

typedef std::map< const MSVehicle , FoeInfo >	FoeInfoMap

enum	SSMParameterWarning { SSM_WARN_MEASURES = 1 , SSM_WARN_THRESHOLDS = 1 << 1 , SSM_WARN_TRAJECTORIES = 1 << 2 , SSM_WARN_RANGE = 1 << 3 , SSM_WARN_MDRAC_PRT = 1 << 3 , SSM_WARN_EXTRATIME = 1 << 4 , SSM_WARN_FILE = 1 << 5 , SSM_WARN_GEO = 1 << 6 , SSM_WARN_POS = 1 << 7 , SSM_WARN_LANEPOS = 1 << 8 , SSM_WARN_CONFLICTFILTER = 1 << 9 }

Private Member Functions
EncounterType	classifyEncounter (const FoeInfo *foeInfo, EncounterApproachInfo &eInfo) const
	Classifies the current type of the encounter provided some information on the opponents.

void	closeEncounter (Encounter *e)
	Finalizes the encounter and calculates SSM values.

void	computeGlobalMeasures ()
	Stores measures, that are not associated to a specific encounter as headways and brake rates.

void	computeSSMs (EncounterApproachInfo &e) const
	Compute current values of the logged SSMs (myMeasures) for the given encounter 'e' and update 'e' accordingly (add point to SSM time-series, update maximal/minimal value) This is called just after adding the current vehicle positions and velocity vectors to the encounter.

double	computeTTC (double gap, double followerSpeed, double leaderSpeed) const
	Computes the time to collision (in seconds) for two vehicles with a given initial gap under the assumption that both maintain their current speeds. Returns INVALID if no collision would occur under this assumption.

void	createEncounters (FoeInfoMap &foes)
	Makes new encounters for all given vehicles (these should be the ones entering the device's range in the current timestep)

void	determinePET (EncounterApproachInfo &eInfo) const
	Discriminates between different encounter types and correspondingly determines the PET for those cases and writes the result to eInfo.pet (after both vehicles have left the conflict area)

void	determineTTCandDRACandPPETandMDRAC (EncounterApproachInfo &eInfo) const
	Discriminates between different encounter types and correspondingly determines TTC and DRAC for those cases and writes the result to eInfo.ttc and eInfo.drac.

const MSLane *	findFoeConflictLane (const MSVehicle foe, const MSLane egoConflictLane, double &distToConflictLane) const
	Computes the conflict lane for the foe.

void	flushConflicts (bool all=false)
	Writes out all past conflicts that have begun earlier than the oldest active encounter.

void	flushGlobalMeasures ()
	Write out all non-encounter specific measures as headways and braking rates.

std::string	makeStringWithNAs (const Position &p)

std::string	makeStringWithNAs (const PositionVector &v)

	MSDevice_SSM (const MSDevice_SSM &)
	Invalidated copy constructor.

	MSDevice_SSM (SUMOVehicle &holder, const std::string &id, std::string outputFilename, std::map< std::string, double > thresholds, bool trajectories, double range, double extraTime, bool useGeoCoords, bool writePositions, bool writeLanesPositions, std::vector< int > conflictOrder)
	Constructor.

MSDevice_SSM &	operator= (const MSDevice_SSM &)
	Invalidated assignment operator.

void	processEncounters (FoeInfoMap &foes, bool forceClose=false)
	Finds encounters for which the foe vehicle has disappeared from range. remainingExtraTime is decreased until it reaches zero, which triggers closing the encounter. If an ended encounter is qualified as a conflict, it is transferred to myPastConflicts All vehicles for which an encounter instance already exists (vehicle is already tracked) are removed from 'foes' during processing.

bool	qualifiesAsConflict (Encounter *e)
	Tests if the SSM values exceed the threshold for qualification as conflict.

void	resetEncounters ()
	Closes all current Encounters and moves conflicts to myPastConflicts,.

void	storeEncountersExceedingMaxLength ()
	Closes encounters, whose duration exceeds the maximal encounter length. If it is classified as conflict, the encounter is saved. In any case, a new active encounter is created holding the trailing part (of length myOverlapTime) of the original.

void	update ()

bool	updateEncounter (Encounter e, FoeInfo foeInfo)
	Updates the encounter (adds a new trajectory point).

void	updatePassedEncounter (Encounter e, FoeInfo foeInfo, EncounterApproachInfo &eInfo)
	Updates an encounter, which was classified as ENCOUNTER_TYPE_NOCONFLICT_AHEAD this may be the case because the foe is out of the detection range but the encounter is still in extra time (in this case foeInfo==0), or because the foe does not head for a lane conflicting with the route of the ego vehicle. It is also used for an ongoing crossing conflict, where only the covered distances are traced until the situation is over. (A crossing conflict is ongoing, if one vehicle entered the conflict area) Writes the type of encounter which is determined for the current state into eInfo. And if appropriate some information concerning vehicles positions in relation to a crossed crossing point (for PET calculation).

void	writeOutConflict (Encounter *e)

Static Private Member Functions
static void	checkConflictEntryAndExit (EncounterApproachInfo &eInfo)
	Checks whether ego or foe have entered or left the conflict area in the last step and eventually writes the corresponding entry or exit times to eInfo.encounter. For ongoing crossing conflicts, it also manages the evolution of the conflict type.

static double	computeDRAC (const EncounterApproachInfo &eInfo)
	Computes the DRAC a crossing situation, determining the minimal constant deceleration needed for one of the vehicles to reach the conflict area after the other has left. for estimated leaving times, current deceleration is extrapolated, and acceleration is neglected. Returns 0.0 if no deceleration is required by the follower to avoid a crash, INVALID if collision is detected.

static double	computeDRAC (double gap, double followerSpeed, double leaderSpeed)
	Computes the DRAC (deceleration to avoid a collision) for a lead/follow situation as defined, e.g., in Guido et al. (2011, Safety performance measures: a comparison between microsimulation and observational data) for two vehicles with a given gap. Returns 0.0 if no deceleration is required by the follower to avoid a crash, INVALID if collision is detected.

static double	computeMDRAC (double gap, double followerSpeed, double leaderSpeed, double prt)
	Computes the MDRAC (deceleration to avoid a collision) for a lead/follow situation as defined considering a reaction time of follower, e.g., in Fazekas et al. (2017, A Novel Surrogate Indicator Based on Constant Initial Acceleration and Reaction Time Assumption) for two vehicles with a given gap. Returns 0.0 if no deceleration is required by the follower to avoid a crash, INVALID if collision is detected.

static void	determineConflictPoint (EncounterApproachInfo &eInfo)
	Calculates the (x,y)-coordinate for the eventually predicted conflict point and stores the result in eInfo.conflictPoint. In case of MERGING and CROSSING, this is the entry point to conflict area for follower In case of FOLLOWING it is the position of leader's back.

static void	estimateConflictTimes (EncounterApproachInfo &eInfo)
	Estimates the time until conflict for the vehicles based on the distance to the conflict entry points. For acceleration profiles, we assume that the acceleration is <= 0 (that is, braking is extrapolated, while for acceleration it is assumed that the vehicle will continue with its current speed)

static void	initEdgeFilter ()
	initialize edge filter (once)

static std::string	makeStringWithNAs (const std::vector< double > &v, const double NA)
	make a string of a double vector and treat a special value as invalid ("NA")

static std::string	makeStringWithNAs (const std::vector< double > &v, const std::vector< double > &NAs)

static void	toGeo (Position &x)
	convert SUMO-positions to geo coordinates (in place)

static void	toGeo (PositionVector &x)
	convert SUMO-positions to geo coordinates (in place)

static std::string	writeNA (double v, double NA=INVALID_DOUBLE)

parameter load helpers (introduced for readability of buildVehicleDevices())
static std::string	getOutputFilename (const SUMOVehicle &v, std::string deviceID)

static double	getDetectionRange (const SUMOVehicle &v)

static double	getMDRAC_PRT (const SUMOVehicle &v)

static double	getExtraTime (const SUMOVehicle &v)

static bool	useGeoCoords (const SUMOVehicle &v)

static bool	writePositions (const SUMOVehicle &v)

static bool	writeLanesPositions (const SUMOVehicle &v)

static bool	filterByConflictType (const SUMOVehicle &v, std::string deviceID, std::vector< int > &conflictTypes)

static bool	requestsTrajectories (const SUMOVehicle &v)

static bool	getMeasuresAndThresholds (const SUMOVehicle &v, std::string deviceID, std::map< std::string, double > &thresholds)

Private Attributes
std::map< long long int, std::pair< SUMOTime, double > >	myLastVehicleUpdateValues

OutputDevice *	myOutputFile
	Output device.

Device parameters
thresholds for the ssms, i.e., critical values above or below which a value indicates that a conflict has occurred. These are used in qualifiesAsConflict() and decide whether an encounter is saved.
std::map< std::string, double >	myThresholds

bool	mySaveTrajectories
	This determines whether the whole trajectories of the vehicles (position, speed, ssms) shall be saved in the ssm-output or only the most critical value shall be reported.

double	myRange
	Detection range. For vehicles closer than this distance from the ego vehicle, SSMs are traced.

double	myMDRACPRT
	perception reaction time for MDRAC

double	myExtraTime
	Extra time in seconds to be logged after a conflict is over.

bool	myUseGeoCoords
	Whether to use the original coordinate system for output.

bool	myWritePositions
	Wether to print the positions for all timesteps.

bool	myWriteLanesPositions
	Wether to print the lanes and positions for all timesteps and conflicts.

bool	myFilterConflictTypes
	Whether to exclude certain conflicts containing certain conflict types from the output.

std::vector< int >	myDroppedConflictTypes
	Which conflict types to exclude from the output.

bool	myComputeTTC
	Flags for switching on / off comutation of different SSMs, derived from myMeasures.

bool	myComputeDRAC

bool	myComputePET

bool	myComputeBR

bool	myComputeSGAP

bool	myComputeTGAP

bool	myComputePPET

bool	myComputeMDRAC

MSVehicle *	myHolderMS

Internal storage for encounters/conflicts
Currently observed encounters/conflicts
EncounterVector	myActiveEncounters

double	myOldestActiveEncounterBegin
	begin time of the oldest active encounter

EncounterQueue	myPastConflicts
	Past encounters that where qualified as conflicts and are not yet flushed to the output file.

Internal storage for global measures
std::vector< double >	myGlobalMeasuresTimeSpan

PositionVector	myGlobalMeasuresPositions
	All values for positions (coordinates)

std::vector< std::string >	myGlobalMeasuresLaneIDs
	All values for lanes.

std::vector< double >	myGlobalMeasuresLanesPositions
	All values for positions on the lanes.

std::vector< double >	myBRspan
	All values for brake rate.

std::vector< double >	mySGAPspan
	All values for space gap.

std::vector< double >	myTGAPspan
	All values for time gap.

std::pair< std::pair< double, Position >, double >	myMaxBR
	Extremal values for the global measures (as <<<time, Position>, value>, [leaderID]>-pairs)

std::pair< std::pair< std::pair< double, Position >, double >, std::string >	myMinSGAP

std::pair< std::pair< std::pair< double, Position >, double >, std::string >	myMinTGAP

Static Private Attributes
static const std::set< int >	EGO_ENCOUNTERTYPES

static const std::set< int >	FOE_ENCOUNTERTYPES

static std::set< std::string >	myCreatedOutputFiles
	remember which files were created already (don't duplicate xml root-elements)

static std::set< const MSEdge * >	myEdgeFilter
	spatial filter for SSM device output

static bool	myEdgeFilterActive

static bool	myEdgeFilterInitialized

static SumoRNG	myEquipmentRNG
	A random number generator used to choose from vtype/route distributions and computing the speed factors.

static std::map< std::string, std::set< std::string > >	myExplicitIDs
	vehicles which explicitly carry a device, sorted by device, first

static std::set< MSDevice_SSM , ComparatorNumericalIdLess >	myInstances = new std::set<MSDevice_SSM*, ComparatorNumericalIdLess>()
	All currently existing SSM devices.

static int	myIssuedParameterWarnFlags = 0
	bitset storing info whether warning has already been issued about unset parameter (warn only once!)

Detailed Description

A device which collects info on the vehicle trip (mainly on departure and arrival)

Each device collects departure time, lane and speed and the same for arrival.

See also: MSDevice

Definition at line 55 of file MSDevice_SSM.h.

Member Typedef Documentation

◆ EncounterQueue

typedef std::priority_queue<Encounter*, std::vector<Encounter*>, Encounter::compare> MSDevice_SSM::EncounterQueue

private

Definition at line 365 of file MSDevice_SSM.h.

◆ EncounterVector

typedef std::vector<Encounter*> MSDevice_SSM::EncounterVector

private

Definition at line 366 of file MSDevice_SSM.h.

◆ FoeInfoMap

typedef std::map<const MSVehicle*, FoeInfo*> MSDevice_SSM::FoeInfoMap

private

Definition at line 367 of file MSDevice_SSM.h.

Member Enumeration Documentation

◆ EncounterType

enum MSDevice_SSM::EncounterType

Different types of encounters corresponding to relative positions of the vehicles. The name describes the type from the ego perspective.

Definition at line 64 of file MSDevice_SSM.h.

◆ 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.

◆ SSMParameterWarning

enum MSDevice_SSM::SSMParameterWarning

private

Enumerator
SSM_WARN_MEASURES
SSM_WARN_THRESHOLDS
SSM_WARN_TRAJECTORIES
SSM_WARN_RANGE
SSM_WARN_MDRAC_PRT
SSM_WARN_EXTRATIME
SSM_WARN_FILE
SSM_WARN_GEO
SSM_WARN_POS
SSM_WARN_LANEPOS
SSM_WARN_CONFLICTFILTER

Definition at line 813 of file MSDevice_SSM.h.

Constructor & Destructor Documentation

◆ ~MSDevice_SSM()

MSDevice_SSM::~MSDevice_SSM ( )

Destructor.

Definition at line 3290 of file MSDevice_SSM.cpp.

References flushConflicts(), flushGlobalMeasures(), myInstances, and resetEncounters().

◆ MSDevice_SSM() [1/2]

MSDevice_SSM::MSDevice_SSM	(	SUMOVehicle &	holder,
		const std::string &	id,
		std::string	outputFilename,
		std::map< std::string, double >	thresholds,
		bool	trajectories,
		double	range,
		double	extraTime,
		bool	useGeoCoords,
		bool	writePositions,
		bool	writeLanesPositions,
		std::vector< int >	conflictOrder
	)

private

Constructor.

Parameters

[in]	holder	The vehicle that holds this device
[in]	id	The ID of the device
	measures	Vector of Surrogate Safety Measure IDs
	thresholds	Vector of corresponding thresholds
	trajectories	Flag indicating whether complete trajectories should be saved for an encounter (if false only extremal values are logged)
	range	Detection range. For vehicles closer than this distance from the ego vehicle, SSMs are traced
	extraTime	Extra time in seconds to be logged after a conflict is over
	useGeoCoords	Whether coordinates should be written out in the original coordinate reference system or as sumo's x,y values
	writePositions	Whether positions (coordinates) should be written for each timestep
	writeLanesPositions	Whether lanes and their positions should be written for each timestep and each conflict
	conflictOrder	Vector of order keywords ego/foe to be considered

Definition at line 3226 of file MSDevice_SSM.cpp.

References DEBUG_COND, OutputDevice::getDevice(), joinToString(), myActiveEncounters, myComputeBR, myComputeDRAC, myComputeMDRAC, myComputePET, myComputePPET, myComputeSGAP, myComputeTGAP, myComputeTTC, myCreatedOutputFiles, myDroppedConflictTypes, myExtraTime, myFilterConflictTypes, myHolderMS, myInstances, myOutputFile, myPastConflicts, myRange, mySaveTrajectories, myThresholds, myUseGeoCoords, and OutputDevice::writeXMLHeader().

◆ MSDevice_SSM() [2/2]

MSDevice_SSM::MSDevice_SSM ( const MSDevice_SSM & )

private

Invalidated copy constructor.

Member Function Documentation

◆ addTo()

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 118 of file Named.h.

References Named::StoringVisitor::add().

◆ buildTransportableDevices()

void MSDevice::buildTransportableDevices	(	MSTransportable &	p,
		std::vector< MSTransportableDevice * > &	into
	)

staticinherited

Build devices for the given person, if needed.

Parameters

[in]	p	The person for which a device may be built
	[filled]	into The vector to store the built device in

Definition at line 137 of file MSDevice.cpp.

References MSTransportableDevice_Routing::buildDevices(), MSTransportableDevice_BTreceiver::buildDevices(), MSTransportableDevice_BTsender::buildDevices(), MSTransportableDevice_FCD::buildDevices(), and MSTransportableDevice_FCDReplay::buildDevices().

Referenced by MSTransportable::MSTransportable().

Here is the caller graph for this function:

◆ buildVehicleDevices()

void MSDevice_SSM::buildVehicleDevices	(	SUMOVehicle &	v,
		std::vector< MSVehicleDevice * > &	into
	)

static

Build devices for the given vehicle, if needed.

The options are read and evaluated whether a example-device shall be built for the given vehicle.

The built device is stored in the given vector.

Parameters

[in]	v	The vehicle for which a device may be built
	[filled]	into The vector to store the built device in

Definition at line 304 of file MSDevice_SSM.cpp.

References MSDevice::equippedByDefaultAssignmentOptions(), filterByConflictType(), getDetectionRange(), getExtraTime(), Named::getID(), getMeasuresAndThresholds(), OptionsCont::getOptions(), getOutputFilename(), MSGlobals::gUseMesoSim, initEdgeFilter(), myEdgeFilterInitialized, requestsTrajectories(), useGeoCoords(), WRITE_WARNINGF, writeLanesPositions(), and writePositions().

Referenced by MSDevice::buildVehicleDevices().

Here is the caller graph for this function:

◆ checkConflictEntryAndExit()

void MSDevice_SSM::checkConflictEntryAndExit ( EncounterApproachInfo & eInfo )

staticprivate

Checks whether ego or foe have entered or left the conflict area in the last step and eventually writes the corresponding entry or exit times to eInfo.encounter. For ongoing crossing conflicts, it also manages the evolution of the conflict type.

Parameters

[in/out] eInfo Info structure for the current state of the encounter.

Note: The times are to be used for SSM computation in computeSSMs(), e.g. in determinePET()

Definition at line 1740 of file MSDevice_SSM.cpp.

Referenced by updateEncounter().

Here is the caller graph for this function:

◆ checkOptions()

bool MSDevice::checkOptions ( OptionsCont & oc )

staticinherited

check device-specific options

Parameters

[filled] oc The options container with the user-defined options

Definition at line 104 of file MSDevice.cpp.

References MSDevice_Routing::checkOptions().

Referenced by MSFrame::checkOptions().

Here is the caller graph for this function:

◆ classifyEncounter()

MSDevice_SSM::EncounterType MSDevice_SSM::classifyEncounter	(	const FoeInfo *	foeInfo,
		EncounterApproachInfo &	eInfo
	)		const

private

Classifies the current type of the encounter provided some information on the opponents.

Parameters

[in]	foeInfo	Info on distance to conflict point for the device holder.
	[in/out]	eInfo Info structure for the current state of the encounter (provides a pointer to the encounter).

Returns: Returns an encounter type and writes a value to the relevant distances (egoEncounterDist, foeEncounterDist members of eInfo), i.e. the distances to the entry points to the potential conflict.

Note: : The encounter distance has a different meaning for different types of encounters: 1) For rear-end conflicts (lead/follow situations) the follower's encounter distance is the distance to the actual back position of the leader. The leaders's distance is undefined. 2) For merging encounters the encounter distance is the distance until the begin of the common target edge/lane. 3) For crossing encounters the encounter distance is the distance until crossing point of the conflicting lanes.

Definition at line 2044 of file MSDevice_SSM.cpp.

Referenced by updateEncounter().

Here is the caller graph for this function:

◆ cleanup()

void MSDevice_SSM::cleanup ( )

static

Clean up remaining devices instances.

Definition at line 211 of file MSDevice_SSM.cpp.

References OutputDevice::closeTag(), fn, OutputDevice::getDevice(), myCreatedOutputFiles, myEdgeFilter, myEdgeFilterActive, myEdgeFilterInitialized, and myInstances.

Referenced by MSNet::clearAll().

Here is the caller graph for this function:

◆ cleanupAll()

void MSDevice::cleanupAll ( )

staticinherited

perform cleanup for all devices

Definition at line 147 of file MSDevice.cpp.

References MSDevice_FCD::cleanup(), MSDevice_Taxi::cleanup(), MSDevice_Tripinfo::cleanup(), and MSRoutingEngine::cleanup().

Referenced by MSNet::clearAll().

Here is the caller graph for this function:

◆ closeEncounter()

void MSDevice_SSM::closeEncounter ( Encounter * e )

private

Finalizes the encounter and calculates SSM values.

Definition at line 795 of file MSDevice_SSM.cpp.

References DEBUG_COND, MSDevice_SSM::Encounter::ego, MSDevice_SSM::Encounter::egoID, MSDevice_SSM::Encounter::end, MSDevice_SSM::Encounter::foe, MSDevice_SSM::Encounter::foeID, Named::getID(), myHolderMS, myPastConflicts, qualifiesAsConflict(), SIMTIME, MSDevice_SSM::Encounter::size(), and MSDevice_SSM::Encounter::timeSpan.

Referenced by processEncounters().

Here is the caller graph for this function:

◆ computeDRAC() [1/2]

double MSDevice_SSM::computeDRAC ( const EncounterApproachInfo & eInfo )

staticprivate

Computes the DRAC a crossing situation, determining the minimal constant deceleration needed for one of the vehicles to reach the conflict area after the other has left. for estimated leaving times, current deceleration is extrapolated, and acceleration is neglected. Returns 0.0 if no deceleration is required by the follower to avoid a crash, INVALID if collision is detected.

Parameters

[in] eInfo infos on the encounter. Used variables: dEntry1,dEntry2 The distances to the conflict area entry dExit1,dExit2 The distances to the conflict area exit v1,v2 The current speeds tEntry1,tEntry2 The estimated conflict entry times (including extrapolation of current acceleration) tExit1,tExit2 The estimated conflict exit times (including extrapolation of current acceleration)

Definition at line 1622 of file MSDevice_SSM.cpp.

◆ computeDRAC() [2/2]

double MSDevice_SSM::computeDRAC	(	double	gap,
		double	followerSpeed,
		double	leaderSpeed
	)

staticprivate

Computes the DRAC (deceleration to avoid a collision) for a lead/follow situation as defined, e.g., in Guido et al. (2011, Safety performance measures: a comparison between microsimulation and observational data) for two vehicles with a given gap. Returns 0.0 if no deceleration is required by the follower to avoid a crash, INVALID if collision is detected.

Definition at line 1582 of file MSDevice_SSM.cpp.

References INVALID_DOUBLE.

Referenced by computeDRAC(), and determineTTCandDRACandPPETandMDRAC().

Here is the caller graph for this function:

◆ computeGlobalMeasures()

void MSDevice_SSM::computeGlobalMeasures ( )

private

Stores measures, that are not associated to a specific encounter as headways and brake rates.

Todo:: Manage as episodes (BR -> braking episode, SGAP/TGAP -> car-following episode) with invariant leader, and filtering applying the corresponding thresholds.

Definition at line 576 of file MSDevice_SSM.cpp.

References MSVehicle::getAcceleration(), Named::getID(), MSVehicle::getLane(), MSVehicle::getLeader(), MSVehicleType::getMinGap(), MSVehicle::getPosition(), MSVehicle::getPositionOnLane(), MSVehicle::getSpeed(), SUMOTrafficObject::getVehicleType(), INVALID_DOUBLE, MAX2(), myBRspan, myComputeBR, myComputeSGAP, myComputeTGAP, myGlobalMeasuresLaneIDs, myGlobalMeasuresLanesPositions, myGlobalMeasuresPositions, myGlobalMeasuresTimeSpan, MSVehicleDevice::myHolder, myHolderMS, myMaxBR, myMinSGAP, myMinTGAP, mySGAPspan, myTGAPspan, myThresholds, myWriteLanesPositions, myWritePositions, and SIMTIME.

Referenced by update().

Here is the caller graph for this function:

◆ computeMDRAC()

double MSDevice_SSM::computeMDRAC	(	double	gap,
		double	followerSpeed,
		double	leaderSpeed,
		double	prt
	)

staticprivate

Computes the MDRAC (deceleration to avoid a collision) for a lead/follow situation as defined considering a reaction time of follower, e.g., in Fazekas et al. (2017, A Novel Surrogate Indicator Based on Constant Initial Acceleration and Reaction Time Assumption) for two vehicles with a given gap. Returns 0.0 if no deceleration is required by the follower to avoid a crash, INVALID if collision is detected.

Definition at line 1600 of file MSDevice_SSM.cpp.

References INVALID_DOUBLE.

Referenced by determineTTCandDRACandPPETandMDRAC().

Here is the caller graph for this function:

◆ computeSSMs()

void MSDevice_SSM::computeSSMs ( EncounterApproachInfo & e ) const

private

Compute current values of the logged SSMs (myMeasures) for the given encounter 'e' and update 'e' accordingly (add point to SSM time-series, update maximal/minimal value) This is called just after adding the current vehicle positions and velocity vectors to the encounter.

Definition at line 1160 of file MSDevice_SSM.cpp.

Referenced by updateEncounter().

Here is the caller graph for this function:

◆ computeTTC()

double MSDevice_SSM::computeTTC	(	double	gap,
		double	followerSpeed,
		double	leaderSpeed
	)		const

private

Computes the time to collision (in seconds) for two vehicles with a given initial gap under the assumption that both maintain their current speeds. Returns INVALID if no collision would occur under this assumption.

Definition at line 1560 of file MSDevice_SSM.cpp.

References DEBUG_COND, INVALID_DOUBLE, and myHolderMS.

Referenced by determineTTCandDRACandPPETandMDRAC().

Here is the caller graph for this function:

◆ createEncounters()

void MSDevice_SSM::createEncounters ( FoeInfoMap & foes )

private

Makes new encounters for all given vehicles (these should be the ones entering the device's range in the current timestep)

Definition at line 637 of file MSDevice_SSM.cpp.

References MSDevice_SSM::Encounter::begin, DEBUG_COND, Named::getID(), INVALID_DOUBLE, myActiveEncounters, myExtraTime, myHolderMS, myOldestActiveEncounterBegin, SIMTIME, and updateEncounter().

Referenced by update().

Here is the caller graph for this function:

◆ determineConflictPoint()

void MSDevice_SSM::determineConflictPoint ( EncounterApproachInfo & eInfo )

staticprivate

Calculates the (x,y)-coordinate for the eventually predicted conflict point and stores the result in eInfo.conflictPoint. In case of MERGING and CROSSING, this is the entry point to conflict area for follower In case of FOLLOWING it is the position of leader's back.

Parameters

[in/out] eInfo Info structure for the current state of the encounter.

Definition at line 944 of file MSDevice_SSM.cpp.

Referenced by updateEncounter().

Here is the caller graph for this function:

◆ determinePET()

void MSDevice_SSM::determinePET ( EncounterApproachInfo & eInfo ) const

private

Discriminates between different encounter types and correspondingly determines the PET for those cases and writes the result to eInfo.pet (after both vehicles have left the conflict area)

Definition at line 1215 of file MSDevice_SSM.cpp.

Referenced by computeSSMs().

Here is the caller graph for this function:

◆ determineTTCandDRACandPPETandMDRAC()

void MSDevice_SSM::determineTTCandDRACandPPETandMDRAC ( EncounterApproachInfo & eInfo ) const

private

Discriminates between different encounter types and correspondingly determines TTC and DRAC for those cases and writes the result to eInfo.ttc and eInfo.drac.

Definition at line 1314 of file MSDevice_SSM.cpp.

Referenced by computeSSMs().

Here is the caller graph for this function:

◆ deviceName()

const std::string MSDevice_SSM::deviceName ( ) const

inlinevirtual

return the name for this type of device

Implements MSDevice.

Definition at line 495 of file MSDevice_SSM.h.

Referenced by getParameter(), and setParameter().

Here is the caller graph for this function:

◆ encounterToString()

static std::string MSDevice_SSM::encounterToString ( EncounterType type )

inlinestatic

Definition at line 119 of file MSDevice_SSM.h.

References ENCOUNTER_TYPE_BOTH_ENTERED_CONFLICT_AREA, ENCOUNTER_TYPE_BOTH_LEFT_CONFLICT_AREA, ENCOUNTER_TYPE_COLLISION, ENCOUNTER_TYPE_CROSSING, ENCOUNTER_TYPE_CROSSING_FOLLOWER, ENCOUNTER_TYPE_CROSSING_LEADER, ENCOUNTER_TYPE_EGO_ENTERED_CONFLICT_AREA, ENCOUNTER_TYPE_EGO_LEFT_CONFLICT_AREA, ENCOUNTER_TYPE_FOE_ENTERED_CONFLICT_AREA, ENCOUNTER_TYPE_FOE_LEFT_CONFLICT_AREA, ENCOUNTER_TYPE_FOLLOWING, ENCOUNTER_TYPE_FOLLOWING_FOLLOWER, ENCOUNTER_TYPE_FOLLOWING_LEADER, ENCOUNTER_TYPE_FOLLOWING_PASSED, ENCOUNTER_TYPE_MERGING, ENCOUNTER_TYPE_MERGING_ADJACENT, ENCOUNTER_TYPE_MERGING_FOLLOWER, ENCOUNTER_TYPE_MERGING_LEADER, ENCOUNTER_TYPE_MERGING_PASSED, ENCOUNTER_TYPE_NOCONFLICT_AHEAD, ENCOUNTER_TYPE_ON_ADJACENT_LANES, and ENCOUNTER_TYPE_ONCOMING.

Referenced by determinePET(), estimateConflictTimes(), and filterByConflictType().

Here is the caller graph for this function:

◆ equippedByDefaultAssignmentOptions()

template<class DEVICEHOLDER >

bool MSDevice::equippedByDefaultAssignmentOptions	(	const OptionsCont &	oc,
		const std::string &	deviceName,
		DEVICEHOLDER &	v,
		bool	outputOptionSet,
		const bool	isPerson = `false`
	)

staticprotectedinherited

Determines whether a vehicle should get a certain device.

Parameters

[in]	oc	The options container to get the information about assignment from
[in]	deviceName	The name of the device type
[in]	v	The vehicle to determine whether it shall be equipped or not

Definition at line 195 of file MSDevice.h.

References MSDevice::deviceName(), OptionsCont::exists(), OptionsCont::getBool(), OptionsCont::getFloat(), MSNet::getInstance(), OptionsCont::getOptions(), MSVehicleControl::getQuota(), OptionsCont::getStringVector(), MSNet::getVehicleControl(), OptionsCont::isSet(), MSDevice::myEquipmentRNG, MSDevice::myExplicitIDs, RandHelper::rand(), StringUtils::toBool(), and StringUtils::toDouble().

Here is the caller graph for this function:

◆ estimateConflictTimes()

void MSDevice_SSM::estimateConflictTimes ( EncounterApproachInfo & eInfo )

staticprivate

Estimates the time until conflict for the vehicles based on the distance to the conflict entry points. For acceleration profiles, we assume that the acceleration is <= 0 (that is, braking is extrapolated, while for acceleration it is assumed that the vehicle will continue with its current speed)

Parameters

[in/out] eInfo Info structure for the current state of the encounter.

Note: The '[in]'-part for eInfo are its members e->ego, e->foe (to access the vehicle parameters), egoConflictEntryDist, foeConflictEntryDist, i.e., distances to the conflict entry points. The '[out]'-part for eInfo are its members type (type information may be refined) egoConflictEntryTime, foeConflictEntryTime (estimated times until the conflict entry point is reached) and egoConflictExitTime, foeConflictExitTime (estimated time until the conflict exit point is reached). Further the type of the encounter as determined by classifyEncounter(), is refined for the cases CROSSING and MERGING here.

Definition at line 1002 of file MSDevice_SSM.cpp.

Referenced by updateEncounter().

Here is the caller graph for this function:

◆ filterByConflictType()

bool MSDevice_SSM::filterByConflictType	(	const SUMOVehicle &	v,
		std::string	deviceID,
		std::vector< int > &	conflictTypes
	)

staticprivate

Definition at line 3986 of file MSDevice_SSM.cpp.

References EGO_ENCOUNTERTYPES, encounterToString(), FOE_ENCOUNTERTYPES, Named::getID(), OptionsCont::getOptions(), MSVehicleType::getParameter(), SUMOTrafficObject::getParameter(), Parameterised::getParameter(), OptionsCont::getString(), StringTokenizer::getVector(), SUMOTrafficObject::getVehicleType(), Parameterised::hasParameter(), OptionsCont::isDefault(), myIssuedParameterWarnFlags, SSM_WARN_CONFLICTFILTER, TL, WRITE_ERRORF, WRITE_MESSAGEF, and WRITE_WARNINGF.

Referenced by buildVehicleDevices().

Here is the caller graph for this function:

◆ findFoeConflictLane()

const MSLane * MSDevice_SSM::findFoeConflictLane	(	const MSVehicle *	foe,
		const MSLane *	egoConflictLane,
		double &	distToConflictLane
	)		const

private

Computes the conflict lane for the foe.

Parameters

	foe	Foe vehicle
	egoConflictLane	Lane, on which the ego would enter the possible conflict
	routeToConflict,Series	of edges, that were traced back from egoConflictLane during findSurrounding Vehicles, when collecting the foe vehicle
[out]	distToConflictLane,distance	to conflictlane entry link (may be negative if foe is already on the conflict lane)

Returns: Lane, on which the foe would enter the possible conflict, if foe is not on conflict course, Null-pointer is returned.

Definition at line 2803 of file MSDevice_SSM.cpp.

References DEBUG_COND, MSRoute::end(), MSVehicle::getBestLanesContinuation(), MSBaseVehicle::getCurrentRouteEdge(), SUMOVehicle::getCurrentRouteEdge(), MSBaseVehicle::getEdge(), MSLane::getEdge(), SUMOTrafficObject::getEdge(), Named::getID(), MSLink::getInternalLengthsAfter(), MSVehicle::getLane(), MSVehicle::getLaneChangeModel(), MSLane::getLength(), MSLane::getLinkCont(), MSLane::getLinkTo(), MSEdge::getOppositeEdge(), MSVehicle::getPositionOnLane(), MSBaseVehicle::getRoute(), SUMOVehicle::getRoute(), MSEdge::getToJunction(), MSLink::getViaLane(), MSLane::isInternal(), MSAbstractLaneChangeModel::isOpposite(), MSVehicleDevice::myHolder, myHolderMS, myRange, SIMTIME, and toString().

Referenced by classifyEncounter().

Here is the caller graph for this function:

◆ findSurroundingVehicles()

void MSDevice_SSM::findSurroundingVehicles	(	const MSVehicle &	veh,
		double	range,
		FoeInfoMap &	foeCollector
	)

static

Returns all vehicles, which are within the given range of the given vehicle.

Note: all vehicles behind and in front are collected, including vehicles on confluent edges. For instance, if the range is 20 m. and a junction lies 10 m. ahead, an upstream scan of 20 m. is performed for all incoming edges.

Parameters

veh	The ego vehicle, that forms the origin for the scan
range	The range to be scanned.
[in/out]	foeCollector container for all collected vehicles

Returns: All vehicles within range from veh

Definition at line 3348 of file MSDevice_SSM.cpp.

References gDebugFlag3, MSVehicle::getBestLanesContinuation(), MSLane::getEdge(), MSEdge::getFromJunction(), Named::getID(), MSJunction::getIncoming(), MSLink::getInternalLengthsAfter(), MSVehicle::getLane(), MSVehicle::getLaneChangeModel(), MSBaseVehicle::getLength(), MSEdge::getLength(), MSLane::getLength(), MSLane::getLinkCont(), MSLane::getLinkTo(), MSJunction::getOutgoing(), MSLane::getParallelOpposite(), MSVehicle::getPositionOnLane(), MSEdge::getToJunction(), getUpstreamVehicles(), getVehiclesOnJunction(), MSLink::getViaLane(), MSEdge::isInternal(), MSLane::isInternal(), MSVehicle::isOnRoad(), MSAbstractLaneChangeModel::isOpposite(), SIMTIME, and toString().

Referenced by update().

Here is the caller graph for this function:

◆ flushConflicts()

void MSDevice_SSM::flushConflicts ( bool all = false )

private

Writes out all past conflicts that have begun earlier than the oldest active encounter.

Parameters

[in] all Whether all conflicts should be flushed or only those for which no active encounters with earlier begin can exist

Definition at line 2945 of file MSDevice_SSM.cpp.

References MSDevice_SSM::Encounter::begin, DEBUG_COND, Named::getID(), INVALID_DOUBLE, myDroppedConflictTypes, myFilterConflictTypes, myHolderMS, myOldestActiveEncounterBegin, myPastConflicts, SIMTIME, MSDevice_SSM::Encounter::typeSpan, and writeOutConflict().

Referenced by updateAndWriteOutput(), and ~MSDevice_SSM().

Here is the caller graph for this function:

◆ flushGlobalMeasures()

void MSDevice_SSM::flushGlobalMeasures ( )

private

Write out all non-encounter specific measures as headways and braking rates.

Todo:: Adapt accordingly if episode structure is implemented,

See also: computeGlobalMeasures()

Definition at line 2979 of file MSDevice_SSM.cpp.

References OutputDevice::closeTag(), DEBUG_COND, Named::getID(), INVALID_DOUBLE, makeStringWithNAs(), myBRspan, myComputeBR, myComputeSGAP, myComputeTGAP, myGlobalMeasuresLaneIDs, myGlobalMeasuresLanesPositions, myGlobalMeasuresPositions, myGlobalMeasuresTimeSpan, myHolderMS, myMaxBR, myMinSGAP, myMinTGAP, myOutputFile, mySGAPspan, myTGAPspan, myUseGeoCoords, myWriteLanesPositions, myWritePositions, OutputDevice::openTag(), SIMTIME, toGeo(), and OutputDevice::writeAttr().

Referenced by ~MSDevice_SSM().

Here is the caller graph for this function:

◆ generateOutput()

void MSDevice_SSM::generateOutput ( OutputDevice * tripinfoOut ) const

virtual

Finalizes output. Called on vehicle removal.

Parameters

[in] os The stream to write the information into

Exceptions

IOError not yet implemented

See also: MSDevice::generateOutput

Reimplemented from MSDevice.

Definition at line 3861 of file MSDevice_SSM.cpp.

◆ getDescription()

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

inlineinherited

Definition at line 280 of file MSMoveReminder.h.

References MSMoveReminder::myDescription.

Referenced by MSDriveWay::notifyEnter(), MSDriveWay::notifyLeave(), and MSDriveWay::notifyLeaveBack().

Here is the caller graph for this function:

◆ getDetectionRange()

double MSDevice_SSM::getDetectionRange ( const SUMOVehicle & v )

staticprivate

Definition at line 4032 of file MSDevice_SSM.cpp.

References OptionsCont::getFloat(), Named::getID(), OptionsCont::getOptions(), MSVehicleType::getParameter(), SUMOTrafficObject::getParameter(), Parameterised::getParameter(), SUMOTrafficObject::getVehicleType(), Parameterised::hasParameter(), INVALID_DOUBLE, OptionsCont::isDefault(), myIssuedParameterWarnFlags, SSM_WARN_RANGE, TL, StringUtils::toDouble(), toString(), WRITE_MESSAGEF, and WRITE_WARNINGF.

Referenced by buildVehicleDevices().

Here is the caller graph for this function:

◆ getEdgeFilter()

static const std::set< const MSEdge * > & MSDevice_SSM::getEdgeFilter ( )

inlinestatic

return the edges where the SSM device should scan

Definition at line 394 of file MSDevice_SSM.h.

References myEdgeFilter.

◆ getEquipmentRNG()

static SumoRNG * MSDevice::getEquipmentRNG ( )

inlinestaticinherited

Definition at line 89 of file MSDevice.h.

References MSDevice::myEquipmentRNG.

Referenced by NLBuilder::initRandomness(), MSStateHandler::myStartElement(), and MSStateHandler::saveRNGs().

Here is the caller graph for this function:

◆ getExtraTime()

double MSDevice_SSM::getExtraTime ( const SUMOVehicle & v )

staticprivate

Definition at line 4088 of file MSDevice_SSM.cpp.

References DEFAULT_EXTRA_TIME, OptionsCont::getFloat(), Named::getID(), OptionsCont::getOptions(), MSVehicleType::getParameter(), SUMOTrafficObject::getParameter(), Parameterised::getParameter(), SUMOTrafficObject::getVehicleType(), Parameterised::hasParameter(), INVALID_DOUBLE, OptionsCont::isDefault(), myIssuedParameterWarnFlags, SSM_WARN_EXTRATIME, TL, StringUtils::toDouble(), toString(), WRITE_MESSAGEF, and WRITE_WARNINGF.

Referenced by buildVehicleDevices().

Here is the caller graph for this function:

◆ getHolder()

SUMOVehicle & MSVehicleDevice::getHolder ( ) const

inlineinherited

Returns the vehicle that holds this device.

Returns: The vehicle that holds this device

Definition at line 72 of file MSVehicleDevice.h.

References MSVehicleDevice::myHolder.

Referenced by MSChargingStation::addChargeValueForOutput(), MSOverheadWire::addChargeValueForOutput(), MSDispatch::computeDetourTime(), MSDispatch_GreedyClosest::computeDispatch(), MSDispatch::computePickupTime(), MSDispatch_Greedy::dispatch(), MSDispatch_GreedyShared::dispatch(), MSDispatch_RouteExtension::dispatch(), MSIdling_Stop::idle(), MSIdling_RandomCircling::idle(), MSIdling_TaxiStand::idle(), and MSDispatch::remainingCapacity().

Here is the caller graph for this function:

◆ getID()

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

inlineinherited

Returns the id.

Returns: The stored id

Definition at line 74 of file Named.h.

References Named::myID.

◆ getIDSecure()

template<class T >

static std::string Named::getIDSecure	(	const T *	obj,
		const std::string &	fallBack = `"NULL"`
	)

inlinestaticinherited

get an identifier for Named-like object which may be Null

Definition at line 67 of file Named.h.

Referenced by MSLCM_LC2013::_wantsChange(), MSLCM_SL2015::_wantsChangeSublane(), MSDriveWay::addSidings(), MSLaneChanger::avoidDeadlock(), MSDriveWay::canUseSiding(), MSLaneChanger::changeOpposite(), MSLaneChanger::checkChangeOpposite(), MSDriveWay::checkFlanks(), MSVehicle::checkReversal(), MSVehicle::checkRewindLinkLanes(), AFRouter< E, N, V >::compute(), AStarRouter< E, V >::compute(), DijkstraRouter< E, V >::compute(), AFBuild< E, N, V >::computeArcFlagsAux(), AFCentralizedSPTree< E, N, V >::computeCentralizedSPTree(), NBOwnTLDef::computeLogicAndConts(), Node2EdgeRouter< E, N, V >::computeNode2Edge(), Node2EdgeRouter< E, N, V >::computeNode2Edges(), MSDriveWay::conflictLaneOccupied(), NBPTLineCont::constructRoute(), MSLaneChanger::continueChange(), MSLane::detectCollisions(), MSVehicle::enterLaneAtLaneChange(), MSVehicle::executeMove(), NBRailwayTopologyAnalyzer::extendDirectionPriority(), NBPTLineCont::findWay(), MSDriveWay::foeDriveWayOccupied(), MSCFModel_CACC::followSpeed(), MSCFModel_W99::followSpeed(), MSStopOut::generateOutputForUnfinished(), MSVehicle::getBackPositionOnLane(), NBOwnTLDef::getBestCombination(), NBOwnTLDef::getBestPair(), MSVehicle::getCenterOnEdge(), MSLaneChanger::getColumnleader(), NBEdge::Connection::getDescription(), MSLane::getFollowersOnConsecutive(), GUIVehicle::getLaneID(), LIBSUMO_NAMESPACE::Person::getLaneID(), MSVehicle::getLatOffset(), MSLane::getLeaderOnConsecutive(), MSLaneChanger::getOncomingOppositeVehicle(), MSLaneChanger::getRealLeader(), GUIVehicle::getShadowLaneID(), GUIVehicle::getTargetLaneID(), getVehiclesOnJunction(), NBEdgeCont::guessRoundabouts(), MSDriveWay::hasLinkConflict(), MSCFModel_IDM::insertionFollowSpeed(), MSLane::isInsertionSuccess(), MESegment::isOpen(), joinNamedToString(), joinNamedToString(), joinNamedToStringSorting(), MSPModel_Striping::PState::moveToNextLane(), LIBSUMO_NAMESPACE::Person::moveToXY(), LIBSUMO_NAMESPACE::Vehicle::moveToXY(), MSPModel_Striping::PState::moveToXY(), libsumo::Helper::moveToXYMap(), libsumo::Helper::moveToXYMap_matchingRoutePosition(), MSDevice_Bluelight::notifyEnter(), MSDevice_Bluelight::notifyLeave(), MSDriveWay::notifyLeave(), MSDriveWay::notifyLeaveBack(), MSVehicle::Influencer::postProcessRemoteControl(), MSVehicle::processNextStop(), MSBaseVehicle::replaceRoute(), MSStoppingPlaceRerouter::reroute(), MSBaseVehicle::reroute(), MSLaneChanger::resolveDeadlock(), MSLCM_LC2013::slowDownForBlocked(), MSLCM_SL2015::slowDownForBlocked(), MSLaneChangerSublane::startChangeSublane(), MSLeaderInfo::toString(), MSLeaderDistanceInfo::toString(), MSCriticalFollowerDistanceInfo::toString(), toString(), toString(), toString(), MSTriggeredRerouter::triggerRouting(), MSVehicle::updateBestLanes(), MSLCHelper::updateBlockerLength(), MSAbstractLaneChangeModel::updateShadowLane(), MSPModel_Striping::PState::walk(), and MSLaneChanger::yieldToDeadlockOncoming().

◆ getInstances()

const std::set< MSDevice_SSM *, ComparatorNumericalIdLess > & MSDevice_SSM::getInstances ( )

static

returns all currently existing SSM devices

Definition at line 206 of file MSDevice_SSM.cpp.

References myInstances.

Referenced by MSNet::writeOutput().

Here is the caller graph for this function:

◆ 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:

◆ getMDRAC_PRT()

double MSDevice_SSM::getMDRAC_PRT ( const SUMOVehicle & v )

staticprivate

Definition at line 4059 of file MSDevice_SSM.cpp.

References OptionsCont::getFloat(), Named::getID(), OptionsCont::getOptions(), MSVehicleType::getParameter(), SUMOTrafficObject::getParameter(), Parameterised::getParameter(), SUMOTrafficObject::getVehicleType(), Parameterised::hasParameter(), OptionsCont::isDefault(), myIssuedParameterWarnFlags, SSM_WARN_MDRAC_PRT, TL, StringUtils::toDouble(), toString(), WRITE_MESSAGEF, and WRITE_WARNINGF.

◆ getMeasuresAndThresholds()

bool MSDevice_SSM::getMeasuresAndThresholds	(	const SUMOVehicle &	v,
		std::string	deviceID,
		std::map< std::string, double > &	thresholds
	)

staticprivate

Definition at line 4146 of file MSDevice_SSM.cpp.

References AVAILABLE_SSMS, DEFAULT_THRESHOLD_BR, DEFAULT_THRESHOLD_DRAC, DEFAULT_THRESHOLD_MDRAC, DEFAULT_THRESHOLD_PET, DEFAULT_THRESHOLD_PPET, DEFAULT_THRESHOLD_SGAP, DEFAULT_THRESHOLD_TGAP, DEFAULT_THRESHOLD_TTC, Named::getID(), OptionsCont::getOptions(), MSVehicleType::getParameter(), SUMOTrafficObject::getParameter(), Parameterised::getParameter(), OptionsCont::getString(), StringTokenizer::getVector(), SUMOTrafficObject::getVehicleType(), StringTokenizer::hasNext(), Parameterised::hasParameter(), OptionsCont::isDefault(), myIssuedParameterWarnFlags, StringTokenizer::next(), SSM_WARN_MEASURES, SSM_WARN_THRESHOLDS, TL, StringUtils::toDouble(), WRITE_ERROR, WRITE_ERRORF, WRITE_MESSAGEF, and WRITE_WARNINGF.

Referenced by buildVehicleDevices().

Here is the caller graph for this function:

◆ getNumericalID()

SUMOVehicle::NumericalID MSVehicleDevice::getNumericalID ( ) const

inlineinherited

Definition at line 76 of file MSVehicleDevice.h.

References SUMOTrafficObject::getNumericalID(), and MSVehicleDevice::myHolder.

◆ getOutputFilename()

std::string MSDevice_SSM::getOutputFilename	(	const SUMOVehicle &	v,
		std::string	deviceID
	)

staticprivate

Definition at line 3871 of file MSDevice_SSM.cpp.

References FileHelpers::checkForRelativity(), Named::getID(), OptionsCont::getOptions(), MSVehicleType::getParameter(), SUMOTrafficObject::getParameter(), Parameterised::getParameter(), OptionsCont::getString(), SUMOTrafficObject::getVehicleType(), Parameterised::hasParameter(), OptionsCont::isDefault(), myIssuedParameterWarnFlags, SSM_WARN_FILE, TL, toString(), StringUtils::urlDecode(), WRITE_MESSAGEF, WRITE_WARNING, and WRITE_WARNINGF.

Referenced by buildVehicleDevices().

Here is the caller graph for this function:

◆ getParameter()

std::string MSDevice_SSM::getParameter ( const std::string & key ) const

virtual

try to retrieve the given parameter from this device. Throw exception for unsupported key

Reimplemented from MSDevice.

Definition at line 4253 of file MSDevice_SSM.cpp.

References deviceName(), INVALID_DOUBLE, MAX2(), MIN2(), myActiveEncounters, myComputeDRAC, myComputeMDRAC, myComputePET, myComputePPET, myComputeTTC, and toString().

◆ getUpstreamVehicles()

void MSDevice_SSM::getUpstreamVehicles	(	const UpstreamScanStartInfo &	scanStart,
		FoeInfoMap &	foeCollector,
		std::set< const MSLane * > &	seenLanes,
		const std::set< const MSJunction * > &	routeJunctions
	)

static

Collects all vehicles within range 'range' upstream of the position 'pos' on the edge 'edge' into foeCollector.

Definition at line 3637 of file MSDevice_SSM.cpp.

References MSDevice_SSM::UpstreamScanStartInfo::edge, MSDevice_SSM::FoeInfo::egoConflictLane, MSDevice_SSM::UpstreamScanStartInfo::egoConflictLane, MSDevice_SSM::FoeInfo::egoDistToConflictLane, MSDevice_SSM::UpstreamScanStartInfo::egoDistToConflictLane, gDebugFlag3, MSEdge::getFromJunction(), Named::getID(), MSJunction::getIncoming(), MSJunction::getInternalLanes(), MSEdge::getLanes(), getUpstreamVehicles(), getVehiclesOnJunction(), MSEdge::isInternal(), MSDevice_SSM::UpstreamScanStartInfo::pos, MSDevice_SSM::UpstreamScanStartInfo::range, SIMTIME, and SVC_IGNORING.

Referenced by findSurroundingVehicles(), and getUpstreamVehicles().

Here is the caller graph for this function:

◆ getVehiclesOnJunction()

void MSDevice_SSM::getVehiclesOnJunction	(	const MSJunction *	junction,
		const MSLane *	egoJunctionLane,
		double	egoDistToConflictLane,
		const MSLane *const	egoConflictLane,
		FoeInfoMap &	foeCollector,
		std::set< const MSLane * > &	seenLanes
	)

static

Collects all vehicles on the junction into foeCollector.

Definition at line 3763 of file MSDevice_SSM.cpp.

References MSDevice_SSM::FoeInfo::egoConflictLane, MSDevice_SSM::FoeInfo::egoDistToConflictLane, gDebugFlag3, MSLane::getEdge(), MSLane::getEntryLink(), MSJunction::getFoeInternalLanes(), MSLink::getFoeLanes(), Named::getID(), Named::getIDSecure(), MSEdge::isCrossing(), and SIMTIME.

Referenced by findSurroundingVehicles(), and getUpstreamVehicles().

Here is the caller graph for this function:

◆ initEdgeFilter()

void MSDevice_SSM::initEdgeFilter ( )

staticprivate

initialize edge filter (once)

Definition at line 263 of file MSDevice_SSM.cpp.

References MSEdge::dictionary(), NamedObjectCont< T >::get(), MSNet::getInstance(), MSJunction::getInternalLanes(), MSNet::getJunctionControl(), OptionsCont::getOptions(), OptionsCont::getString(), myEdgeFilter, myEdgeFilterActive, myEdgeFilterInitialized, StringUtils::startsWith(), TLF, and WRITE_WARNING.

Referenced by buildVehicleDevices().

Here is the caller graph for this function:

◆ insertDefaultAssignmentOptions()

void MSDevice::insertDefaultAssignmentOptions	(	const std::string &	deviceName,
		const std::string &	optionsTopic,
		OptionsCont &	oc,
		const bool	isPerson = `false`
	)

staticprotectedinherited

Adds common command options that allow to assign devices to vehicles.

Parameters

[in]	deviceName	The name of the device type
[in]	optionsTopic	The options topic into which the options shall be added
	[filled]	oc The options container to add the options to

Definition at line 155 of file MSDevice.cpp.

References OptionsCont::addDescription(), OptionsCont::addSynonyme(), MSDevice::deviceName(), and OptionsCont::doRegister().

Here is the caller graph for this function:

◆ insertOptions()

void MSDevice_SSM::insertOptions ( OptionsCont & oc )

static

Inserts MSDevice_SSM-options.

Parameters

[filled] oc The options container to add the options to

Definition at line 232 of file MSDevice_SSM.cpp.

References OptionsCont::addDescription(), OptionsCont::addOptionSubTopic(), DEFAULT_EXTRA_TIME, OptionsCont::doRegister(), MSDevice::insertDefaultAssignmentOptions(), and TL.

Referenced by MSDevice::insertOptions().

Here is the caller graph for this function:

◆ isParkingRerouter()

virtual bool MSMoveReminder::isParkingRerouter ( ) const

inlinevirtualinherited

Reimplemented in MSTriggeredRerouter.

Definition at line 285 of file MSMoveReminder.h.

◆ loadState()

void MSDevice::loadState ( const SUMOSAXAttributes & attrs )

virtualinherited

Loads the state of the device from the given description.

The default implementation does nothing.

Parameters

[in] attrs XML attributes describing the current state

Reimplemented in MSDevice_Routing, MSDevice_Transportable, MSDevice_Tripinfo, MSDevice_Vehroutes, MSTransportableDevice_Routing, MSDevice_Battery, and MSDevice_StationFinder.

Definition at line 177 of file MSDevice.cpp.

◆ makeStringWithNAs() [1/4]

std::string MSDevice_SSM::makeStringWithNAs ( const Position & p )

private

Definition at line 3212 of file MSDevice_SSM.cpp.

References gPrecision, gPrecisionGeo, Position::INVALID, myUseGeoCoords, and toString().

◆ makeStringWithNAs() [2/4]

std::string MSDevice_SSM::makeStringWithNAs ( const PositionVector & v )

private

Definition at line 3202 of file MSDevice_SSM.cpp.

References gPrecision, gPrecisionGeo, Position::INVALID, myUseGeoCoords, and toString().

◆ makeStringWithNAs() [3/4]

std::string MSDevice_SSM::makeStringWithNAs	(	const std::vector< double > &	v,
		const double	NA
	)

staticprivate

make a string of a double vector and treat a special value as invalid ("NA")

Parameters

v	vector to be converted to string
NA	value to be treated as NA
sep	separator for values in string

Returns: String concatenation of the vector entries

Definition at line 3184 of file MSDevice_SSM.cpp.

References toString().

Referenced by flushGlobalMeasures(), and writeOutConflict().

Here is the caller graph for this function:

◆ makeStringWithNAs() [4/4]

std::string MSDevice_SSM::makeStringWithNAs	(	const std::vector< double > &	v,
		const std::vector< double > &	NAs
	)

staticprivate

Definition at line 3193 of file MSDevice_SSM.cpp.

References toString().

◆ notifyEnter()

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

virtual

Called whenever the holder enteres a lane.

Parameters

[in]	veh	The entering vehicle.
[in]	reason	Reason for leaving the lane
[in]	enteredLane	The lane entered.

Returns: Always true to keep the device as it cannot be thrown away

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

Reimplemented from MSMoveReminder.

Definition at line 3301 of file MSDevice_SSM.cpp.

References DEBUG_COND, MSLane::getEdge(), Named::getID(), SUMOTrafficObject::getLane(), SUMOTrafficObject::isVehicle(), SIMTIME, and UNUSED_PARAMETER.

◆ 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 MSDevice_Emissions, MSDevice_Tripinfo, MSMeanData_Emissions::MSLaneMeanDataValues, and MSDevice_StationFinder.

Definition at line 183 of file MSMoveReminder.h.

References UNUSED_PARAMETER.

◆ notifyLeave()

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

virtual

Called whenever the holder leaves a lane.

Parameters

[in]	veh	The leaving vehicle.
[in]	lastPos	Position on the lane when leaving.
[in]	reason	Reason for leaving the lane
[in]	enteredLane	The lane entered.

Returns: True if it did not leave the net.

Reimplemented from MSMoveReminder.

Definition at line 3316 of file MSDevice_SSM.cpp.

References DEBUG_COND, MSLane::getEdge(), Named::getID(), SUMOTrafficObject::getLane(), SUMOTrafficObject::isVehicle(), SIMTIME, and UNUSED_PARAMETER.

◆ notifyLeaveBack()

virtual bool MSMoveReminder::notifyLeaveBack	(	SUMOTrafficObject &	veh,
		Notification	reason,
		const MSLane *	leftLane
	)

inlinevirtualinherited

Called if the vehicle's back leaves the reminder's lane.

Informs if vehicle back leaves reminder lane (due to lane change, removal from the network, or leaving to the next lane). The default is to do nothing.

Parameters

[in]	veh	The leaving vehicle.
[in]	reason	how the vehicle leaves the lane
[in]	leftLane	The lane that the vehicle's back left

See also: Notification

Returns: True if the reminder wants to receive further info.

Reimplemented in MSDriveWay.

Definition at line 228 of file MSMoveReminder.h.

References UNUSED_PARAMETER.

◆ notifyMove()

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

virtual

Checks for waiting steps when the vehicle moves.

Parameters

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

Returns: Always true to keep the device as it cannot be thrown away

Reimplemented from MSMoveReminder.

Definition at line 3332 of file MSDevice_SSM.cpp.

References DEBUG_COND, Named::getID(), SIMTIME, and UNUSED_PARAMETER.

◆ notifyMoveInternal()

virtual void MSMoveReminder::notifyMoveInternal	(	const SUMOTrafficObject &	veh,
		const double	frontOnLane,
		const double	timeOnLane,
		const double	meanSpeedFrontOnLane,
		const double	meanSpeedVehicleOnLane,
		const double	travelledDistanceFrontOnLane,
		const double	travelledDistanceVehicleOnLane,
		const double	meanLengthOnLane
	)

inlinevirtualinherited

Internal notification about the vehicle moves.

Note: meso uses this though it never calls notifyMove()

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]	frontOnLane	time the front of the vehicle spent on the lane.
[in]	timeOnLane	time some part of the vehicle spent on the lane.
[in]	meanSpeedFrontOnLane	Average speed for the time that the front is on the lane.
[in]	meanSpeedVehicleOnLane	Average speed for the time that the vehicle is on the lane (with front or back).
[in]	travelledDistanceFrontOnLane	distance travelled while overlapping with the lane.
[in]	travelledDistanceVehicleOnLane	distance travelled while front was on the lane.
[in]	meanLengthOnLane	the average length of the vehicle's part on the lane during the last step (==complete length in meso case)

Reimplemented in MSDevice_ElecHybrid, MSDevice_Emissions, MSDevice_Taxi, MSDevice_Transportable, MSDevice_Tripinfo, MSMeanData::MeanDataValueTracker, MSDevice_StationFinder, MSMeanData_Net::MSLaneMeanDataValues, MSMeanData_Harmonoise::MSLaneMeanDataValues, MSMeanData_Amitran::MSLaneMeanDataValues, and MSMeanData_Emissions::MSLaneMeanDataValues.

Definition at line 258 of file MSMoveReminder.h.

References UNUSED_PARAMETER.

Referenced by MSMoveReminder::updateDetector().

Here is the caller graph for this function:

◆ 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_Routing, and MSDevice_Vehroutes.

Definition at line 192 of file MSMoveReminder.h.

◆ operator=()

MSDevice_SSM & MSDevice_SSM::operator= ( const MSDevice_SSM & )

private

Invalidated assignment operator.

◆ processEncounters()

void MSDevice_SSM::processEncounters	(	FoeInfoMap &	foes,
		bool	forceClose = `false`
	)

private

Finds encounters for which the foe vehicle has disappeared from range. remainingExtraTime is decreased until it reaches zero, which triggers closing the encounter. If an ended encounter is qualified as a conflict, it is transferred to myPastConflicts All vehicles for which an encounter instance already exists (vehicle is already tracked) are removed from 'foes' during processing.

Parameters

[in]	foes	Foe vehicles that have been found by findSurroundingVehicles()
[in]	forceClose	whether encounters for which the foe is not in range shall be closed immediately, disregarding the remaining extra time (is requested by resetEncounters()).

Definition at line 678 of file MSDevice_SSM.cpp.

References MSDevice_SSM::Encounter::begin, closeEncounter(), MSDevice_SSM::Encounter::closingRequested, MSDevice_SSM::Encounter::currentType, DEBUG_COND, ENCOUNTER_TYPE_BOTH_LEFT_CONFLICT_AREA, MSDevice_SSM::Encounter::foe, MSDevice_SSM::Encounter::foeID, Named::getID(), MSNet::getInstance(), MSDevice_SSM::Encounter::getRemainingExtraTime(), MSVehicleControl::getVehicle(), MSNet::getVehicleControl(), INVALID_DOUBLE, MIN2(), myActiveEncounters, myHolderMS, myOldestActiveEncounterBegin, SIMTIME, and updateEncounter().

Referenced by resetEncounters(), and update().

Here is the caller graph for this function:

◆ qualifiesAsConflict()

bool MSDevice_SSM::qualifiesAsConflict ( Encounter * e )

private

Tests if the SSM values exceed the threshold for qualification as conflict.

Definition at line 766 of file MSDevice_SSM.cpp.

References DEBUG_COND, MSDevice_SSM::Encounter::egoID, MSDevice_SSM::Encounter::foeID, INVALID_DOUBLE, MSDevice_SSM::Encounter::maxDRAC, MSDevice_SSM::Encounter::maxMDRAC, MSDevice_SSM::Encounter::minPPET, MSDevice_SSM::Encounter::minTTC, myComputeDRAC, myComputeMDRAC, myComputePET, myComputePPET, myComputeTTC, myHolderMS, myThresholds, MSDevice_SSM::Encounter::PET, SIMTIME, and MSDevice_SSM::Encounter::ConflictPointInfo::value.

Referenced by closeEncounter().

Here is the caller graph for this function:

◆ removeFromVehicleUpdateValues()

void MSMoveReminder::removeFromVehicleUpdateValues ( SUMOTrafficObject & veh )

protectedinherited

Definition at line 89 of file MSMoveReminder.cpp.

References SUMOTrafficObject::getNumericalID(), and MSMoveReminder::myLastVehicleUpdateValues.

Referenced by MSMoveReminder::updateDetector().

Here is the caller graph for this function:

◆ requestsTrajectories()

bool MSDevice_SSM::requestsTrajectories ( const SUMOVehicle & v )

staticprivate

Definition at line 4119 of file MSDevice_SSM.cpp.

References OptionsCont::getBool(), Named::getID(), OptionsCont::getOptions(), MSVehicleType::getParameter(), SUMOTrafficObject::getParameter(), Parameterised::getParameter(), SUMOTrafficObject::getVehicleType(), Parameterised::hasParameter(), OptionsCont::isDefault(), myIssuedParameterWarnFlags, SSM_WARN_TRAJECTORIES, TL, StringUtils::toBool(), toString(), WRITE_MESSAGEF, and WRITE_WARNINGF.

Referenced by buildVehicleDevices().

Here is the caller graph for this function:

◆ resetEncounters()

void MSDevice_SSM::resetEncounters ( )

private

Closes all current Encounters and moves conflicts to myPastConflicts,.

See also: processEncounters

Definition at line 669 of file MSDevice_SSM.cpp.

References processEncounters().

Referenced by updateAndWriteOutput(), and ~MSDevice_SSM().

Here is the caller graph for this function:

◆ saveState()

void MSDevice::saveState ( OutputDevice & out ) const

virtualinherited

Saves the state of the device.

The default implementation writes a warning and does nothing.

Parameters

[in] out The OutputDevice to write the information into

Reimplemented in MSDevice_FCD, MSTransportableDevice_FCD, MSDevice_Routing, MSDevice_Transportable, MSDevice_Tripinfo, MSDevice_Vehroutes, MSTransportableDevice_Routing, MSDevice_Battery, and MSDevice_StationFinder.

Definition at line 171 of file MSDevice.cpp.

References Named::getID(), TL, and WRITE_WARNINGF.

◆ setDescription()

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

inlineinherited

Definition at line 276 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:

◆ setID()

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

inlinevirtualinherited

resets the id

Parameters

[in] newID The new id of this object

Reimplemented in MSBaseVehicle, MSTransportable, and NBLoadedSUMOTLDef.

Definition at line 82 of file Named.h.

References Named::myID.

Referenced by Distribution_Parameterized::parse(), NBLoadedSUMOTLDef::reconstructLogic(), NBEdgeCont::rename(), NBNodeCont::rename(), GNEJunction::setAttribute(), NBLoadedSUMOTLDef::setID(), and IntermodalNetwork< E, L, N, V >::splitEdge().

Here is the caller graph for this function:

◆ setParameter()

void MSDevice_SSM::setParameter	(	const std::string &	key,
		const std::string &	value
	)

virtual

try to set the given parameter for this device. Throw exception for unsupported key

Reimplemented from MSDevice.

Definition at line 4309 of file MSDevice_SSM.cpp.

References deviceName(), StringUtils::toDouble(), and UNUSED_PARAMETER.

◆ storeEncountersExceedingMaxLength()

void MSDevice_SSM::storeEncountersExceedingMaxLength ( )

private

Closes encounters, whose duration exceeds the maximal encounter length. If it is classified as conflict, the encounter is saved. In any case, a new active encounter is created holding the trailing part (of length myOverlapTime) of the original.

◆ toGeo() [1/2]

void MSDevice_SSM::toGeo ( Position & x )

staticprivate

convert SUMO-positions to geo coordinates (in place)

Definition at line 3040 of file MSDevice_SSM.cpp.

References GeoConvHelper::cartesian2geo(), and GeoConvHelper::getFinal().

Referenced by flushGlobalMeasures(), toGeo(), and writeOutConflict().

Here is the caller graph for this function:

◆ toGeo() [2/2]

void MSDevice_SSM::toGeo ( PositionVector & x )

staticprivate

convert SUMO-positions to geo coordinates (in place)

Definition at line 3045 of file MSDevice_SSM.cpp.

References Position::INVALID, and toGeo().

◆ update()

void MSDevice_SSM::update ( )

private

Definition at line 528 of file MSDevice_SSM.cpp.

References computeGlobalMeasures(), createEncounters(), DEBUG_COND, findSurroundingVehicles(), Named::getID(), myActiveEncounters, myEdgeFilter, myEdgeFilterActive, myHolderMS, myPastConflicts, myRange, processEncounters(), and SIMTIME.

Referenced by updateAndWriteOutput().

Here is the caller graph for this function:

◆ updateAndWriteOutput()

void MSDevice_SSM::updateAndWriteOutput ( )

This is called once per time step in MSNet::writeOutput() and collects the surrounding vehicles, updates information on encounters and flushes the encounters qualified as conflicts (.

See also: thresholds) to the output file.

Definition at line 509 of file MSDevice_SSM.cpp.

References DEBUG_COND, flushConflicts(), Named::getID(), SUMOVehicle::isOnRoad(), MSVehicleDevice::myHolder, myHolderMS, resetEncounters(), SIMTIME, and update().

◆ 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 SUMOTrafficObject::getNumericalID(), MSMoveReminder::myLastVehicleUpdateValues, MSMoveReminder::notifyMoveInternal(), MSMoveReminder::removeFromVehicleUpdateValues(), and STEPS2TIME.

Referenced by MEVehicle::updateDetectorForWriting().

Here is the caller graph for this function:

◆ updateEncounter()

bool MSDevice_SSM::updateEncounter	(	Encounter *	e,
		FoeInfo *	foeInfo
	)

private

Updates the encounter (adds a new trajectory point).

Returns: Returns false for new encounters, which should not be kept (if one vehicle has already left the conflict zone at encounter creation). True, otherwise.

Definition at line 842 of file MSDevice_SSM.cpp.

Referenced by createEncounters(), and processEncounters().

Here is the caller graph for this function:

◆ updatePassedEncounter()

void MSDevice_SSM::updatePassedEncounter	(	Encounter *	e,
		FoeInfo *	foeInfo,
		EncounterApproachInfo &	eInfo
	)

private

Updates an encounter, which was classified as ENCOUNTER_TYPE_NOCONFLICT_AHEAD this may be the case because the foe is out of the detection range but the encounter is still in extra time (in this case foeInfo==0), or because the foe does not head for a lane conflicting with the route of the ego vehicle. It is also used for an ongoing crossing conflict, where only the covered distances are traced until the situation is over. (A crossing conflict is ongoing, if one vehicle entered the conflict area) Writes the type of encounter which is determined for the current state into eInfo. And if appropriate some information concerning vehicles positions in relation to a crossed crossing point (for PET calculation).

Definition at line 1882 of file MSDevice_SSM.cpp.

Referenced by updateEncounter().

Here is the caller graph for this function:

◆ useGeoCoords()

bool MSDevice_SSM::useGeoCoords ( const SUMOVehicle & v )

staticprivate

Definition at line 3905 of file MSDevice_SSM.cpp.

References OptionsCont::getBool(), Named::getID(), OptionsCont::getOptions(), MSVehicleType::getParameter(), SUMOTrafficObject::getParameter(), Parameterised::getParameter(), SUMOTrafficObject::getVehicleType(), Parameterised::hasParameter(), OptionsCont::isDefault(), myIssuedParameterWarnFlags, SSM_WARN_GEO, TL, StringUtils::toBool(), toString(), WRITE_MESSAGEF, and WRITE_WARNINGF.

Referenced by buildVehicleDevices().

Here is the caller graph for this function:

◆ writeLanesPositions()

bool MSDevice_SSM::writeLanesPositions ( const SUMOVehicle & v )

staticprivate

Definition at line 3959 of file MSDevice_SSM.cpp.

References OptionsCont::getBool(), Named::getID(), OptionsCont::getOptions(), MSVehicleType::getParameter(), SUMOTrafficObject::getParameter(), Parameterised::getParameter(), SUMOTrafficObject::getVehicleType(), Parameterised::hasParameter(), OptionsCont::isDefault(), myIssuedParameterWarnFlags, SSM_WARN_LANEPOS, TL, StringUtils::toBool(), toString(), WRITE_MESSAGEF, and WRITE_WARNINGF.

Referenced by buildVehicleDevices().

Here is the caller graph for this function:

◆ writeNA()

std::string MSDevice_SSM::writeNA	(	double	v,
		double	NA = `INVALID_DOUBLE`
	)

staticprivate

Definition at line 3219 of file MSDevice_SSM.cpp.

References toString().

Referenced by estimateConflictTimes().

Here is the caller graph for this function:

◆ writeOutConflict()

void MSDevice_SSM::writeOutConflict ( Encounter * e )

private

Definition at line 3054 of file MSDevice_SSM.cpp.

Referenced by flushConflicts().

Here is the caller graph for this function:

◆ writePositions()

bool MSDevice_SSM::writePositions ( const SUMOVehicle & v )

staticprivate

Definition at line 3932 of file MSDevice_SSM.cpp.

References OptionsCont::getBool(), Named::getID(), OptionsCont::getOptions(), MSVehicleType::getParameter(), SUMOTrafficObject::getParameter(), Parameterised::getParameter(), SUMOTrafficObject::getVehicleType(), Parameterised::hasParameter(), OptionsCont::isDefault(), myIssuedParameterWarnFlags, SSM_WARN_POS, TL, StringUtils::toBool(), toString(), WRITE_MESSAGEF, and WRITE_WARNINGF.

Referenced by buildVehicleDevices().

Here is the caller graph for this function:

Field Documentation

◆ EGO_ENCOUNTERTYPES

const std::set< int > MSDevice_SSM::EGO_ENCOUNTERTYPES

staticprivate

Definition at line 828 of file MSDevice_SSM.h.

Referenced by filterByConflictType().

◆ FOE_ENCOUNTERTYPES

const std::set< int > MSDevice_SSM::FOE_ENCOUNTERTYPES

staticprivate

Definition at line 827 of file MSDevice_SSM.h.

Referenced by filterByConflictType().

◆ myActiveEncounters

EncounterVector MSDevice_SSM::myActiveEncounters

private

Definition at line 767 of file MSDevice_SSM.h.

Referenced by createEncounters(), getParameter(), MSDevice_SSM(), processEncounters(), and update().

◆ myBRspan

std::vector<double> MSDevice_SSM::myBRspan

private

All values for brake rate.

Definition at line 786 of file MSDevice_SSM.h.

Referenced by computeGlobalMeasures(), and flushGlobalMeasures().

◆ myComputeBR

bool MSDevice_SSM::myComputeBR

private

Definition at line 759 of file MSDevice_SSM.h.

Referenced by computeGlobalMeasures(), flushGlobalMeasures(), and MSDevice_SSM().

◆ myComputeDRAC

bool MSDevice_SSM::myComputeDRAC

private

Definition at line 759 of file MSDevice_SSM.h.

Referenced by computeSSMs(), determineTTCandDRACandPPETandMDRAC(), getParameter(), MSDevice_SSM(), qualifiesAsConflict(), and writeOutConflict().

◆ myComputeMDRAC

bool MSDevice_SSM::myComputeMDRAC

private

Definition at line 759 of file MSDevice_SSM.h.

Referenced by computeSSMs(), determineTTCandDRACandPPETandMDRAC(), getParameter(), MSDevice_SSM(), qualifiesAsConflict(), and writeOutConflict().

◆ myComputePET

bool MSDevice_SSM::myComputePET

private

Definition at line 759 of file MSDevice_SSM.h.

Referenced by getParameter(), MSDevice_SSM(), qualifiesAsConflict(), and writeOutConflict().

◆ myComputePPET

bool MSDevice_SSM::myComputePPET

private

Definition at line 759 of file MSDevice_SSM.h.

Referenced by computeSSMs(), determineTTCandDRACandPPETandMDRAC(), getParameter(), MSDevice_SSM(), qualifiesAsConflict(), and writeOutConflict().

◆ myComputeSGAP

bool MSDevice_SSM::myComputeSGAP

private

Definition at line 759 of file MSDevice_SSM.h.

Referenced by computeGlobalMeasures(), flushGlobalMeasures(), and MSDevice_SSM().

◆ myComputeTGAP

bool MSDevice_SSM::myComputeTGAP

private

Definition at line 759 of file MSDevice_SSM.h.

Referenced by computeGlobalMeasures(), flushGlobalMeasures(), and MSDevice_SSM().

◆ myComputeTTC

bool MSDevice_SSM::myComputeTTC

private

Flags for switching on / off comutation of different SSMs, derived from myMeasures.

Definition at line 759 of file MSDevice_SSM.h.

Referenced by computeSSMs(), determineTTCandDRACandPPETandMDRAC(), getParameter(), MSDevice_SSM(), qualifiesAsConflict(), and writeOutConflict().

◆ myCreatedOutputFiles

std::set< std::string > MSDevice_SSM::myCreatedOutputFiles

staticprivate

remember which files were created already (don't duplicate xml root-elements)

Definition at line 808 of file MSDevice_SSM.h.

Referenced by cleanup(), and MSDevice_SSM().

◆ myDescription

std::string MSMoveReminder::myDescription

protectedinherited

a description of this moveReminder

Definition at line 297 of file MSMoveReminder.h.

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

◆ myDroppedConflictTypes

std::vector<int> MSDevice_SSM::myDroppedConflictTypes

private

Which conflict types to exclude from the output.

Definition at line 756 of file MSDevice_SSM.h.

Referenced by flushConflicts(), and MSDevice_SSM().

◆ myEdgeFilter

std::set< const MSEdge * > MSDevice_SSM::myEdgeFilter

staticprivate

spatial filter for SSM device output

Definition at line 800 of file MSDevice_SSM.h.

Referenced by cleanup(), getEdgeFilter(), initEdgeFilter(), and update().

◆ myEdgeFilterActive

bool MSDevice_SSM::myEdgeFilterActive

staticprivate

Definition at line 802 of file MSDevice_SSM.h.

Referenced by cleanup(), initEdgeFilter(), and update().

◆ myEdgeFilterInitialized

bool MSDevice_SSM::myEdgeFilterInitialized

staticprivate

Definition at line 801 of file MSDevice_SSM.h.

Referenced by buildVehicleDevices(), cleanup(), and initEdgeFilter().

◆ myEquipmentRNG

SumoRNG MSDevice::myEquipmentRNG

staticprivateinherited

A random number generator used to choose from vtype/route distributions and computing the speed factors.

Definition at line 181 of file MSDevice.h.

Referenced by MSDevice::equippedByDefaultAssignmentOptions(), and MSDevice::getEquipmentRNG().

◆ myExplicitIDs

std::map< std::string, std::set< std::string > > MSDevice::myExplicitIDs

staticprivateinherited

vehicles which explicitly carry a device, sorted by device, first

Definition at line 178 of file MSDevice.h.

Referenced by MSDevice::equippedByDefaultAssignmentOptions().

◆ myExtraTime

double MSDevice_SSM::myExtraTime

private

Extra time in seconds to be logged after a conflict is over.

Definition at line 746 of file MSDevice_SSM.h.

Referenced by createEncounters(), MSDevice_SSM(), updateEncounter(), and updatePassedEncounter().

◆ myFilterConflictTypes

bool MSDevice_SSM::myFilterConflictTypes

private

Whether to exclude certain conflicts containing certain conflict types from the output.

Definition at line 754 of file MSDevice_SSM.h.

Referenced by flushConflicts(), and MSDevice_SSM().

◆ myGlobalMeasuresLaneIDs

std::vector<std::string> MSDevice_SSM::myGlobalMeasuresLaneIDs

private

All values for lanes.

Definition at line 782 of file MSDevice_SSM.h.

Referenced by computeGlobalMeasures(), and flushGlobalMeasures().

◆ myGlobalMeasuresLanesPositions

std::vector<double> MSDevice_SSM::myGlobalMeasuresLanesPositions

private

All values for positions on the lanes.

Definition at line 784 of file MSDevice_SSM.h.

Referenced by computeGlobalMeasures(), and flushGlobalMeasures().

◆ myGlobalMeasuresPositions

PositionVector MSDevice_SSM::myGlobalMeasuresPositions

private

All values for positions (coordinates)

Definition at line 780 of file MSDevice_SSM.h.

Referenced by computeGlobalMeasures(), and flushGlobalMeasures().

◆ myGlobalMeasuresTimeSpan

std::vector<double> MSDevice_SSM::myGlobalMeasuresTimeSpan

private

Definition at line 778 of file MSDevice_SSM.h.

Referenced by computeGlobalMeasures(), and flushGlobalMeasures().

◆ myHolder

SUMOVehicle& MSVehicleDevice::myHolder

protectedinherited

The vehicle that stores the device.

Definition at line 90 of file MSVehicleDevice.h.

◆ myHolderMS

MSVehicle* MSDevice_SSM::myHolderMS

private

Definition at line 760 of file MSDevice_SSM.h.

Referenced by closeEncounter(), computeGlobalMeasures(), computeSSMs(), computeTTC(), createEncounters(), determinePET(), determineTTCandDRACandPPETandMDRAC(), findFoeConflictLane(), flushConflicts(), flushGlobalMeasures(), MSDevice_SSM(), processEncounters(), qualifiesAsConflict(), update(), updateAndWriteOutput(), updatePassedEncounter(), and writeOutConflict().

◆ myID

std::string Named::myID

protectedinherited

The name of the object.

Definition at line 125 of file Named.h.

Referenced by MSDriveWay::addBidiFoes(), MSE2Collector::addDetectorToLanes(), MSDriveWay::addFoes(), MSDriveWay::addParallelFoes(), MSDriveWay::addReversalFoes(), MSDriveWay::addSwitchFoes(), RODFDetector::buildDestinationDistribution(), MSDriveWay::buildDriveWay(), NGEdge::buildNBEdge(), NGNode::buildNBNode(), MSSOTLTrafficLightLogic::checkPhases(), NBNode::computeNodeShape(), NEMALogic::constructTimingAndPhaseDefs(), MSE2Collector::detectorUpdate(), GNEPOI::getAttribute(), GNEPoly::getAttribute(), MSLane::getCanonicalPredecessorLane(), MSLane::getCanonicalSuccessorLane(), Named::getID(), NBEdge::getLaneID(), NEMALogic::getPhaseObj(), ROEdge::getStoredEffort(), GNEPOI::getSumoBaseObject(), MSLane::getSurroundingVehicles(), ROEdge::getTravelTime(), NBEdge::init(), MSSOTLTrafficLightLogic::init(), MSDelayBasedTrafficLightLogic::init(), NEMALogic::init(), MSLane::isInsertionSuccess(), NBNode::NBNode(), NBNode::NBNode(), MSE2Collector::notifyEnter(), MSE2Collector::notifyLeave(), MSE2Collector::notifyMove(), MSMeanData::openInterval(), NEMALogic::parseControllerType(), RORouteDef::preComputeCurrentRoute(), NBEdge::reinitNodes(), GNEPOI::setAttribute(), GNEPoly::setAttribute(), NBEdge::setGeometry(), Named::setID(), MSSOTLTrafficLightLogic::setToATargetPhase(), Distribution_Parameterized::toStr(), MSChargingStation::writeAggregatedChargingStationOutput(), MSDriveWay::writeBlocks(), MSDriveWay::writeBlockVehicles(), MSChargingStation::writeChargingStationOutput(), RODFDetector::writeEmitterDefinition(), MSOverheadWire::writeOverheadWireSegmentOutput(), RODFDetector::writeSingleSpeedTrigger(), MSTractionSubstation::writeTractionSubstationOutput(), MEInductLoop::writeXMLOutput(), and MSE3Collector::writeXMLOutput().

◆ myInstances

std::set< MSDevice_SSM *, ComparatorNumericalIdLess > * MSDevice_SSM::myInstances = new std::set<MSDevice_SSM*, ComparatorNumericalIdLess>()

staticprivate

All currently existing SSM devices.

Definition at line 59 of file MSDevice_SSM.h.

Referenced by cleanup(), getInstances(), MSDevice_SSM(), and ~MSDevice_SSM().

◆ myIssuedParameterWarnFlags

int MSDevice_SSM::myIssuedParameterWarnFlags = 0

staticprivate

bitset storing info whether warning has already been issued about unset parameter (warn only once!)

Definition at line 812 of file MSDevice_SSM.h.

Referenced by filterByConflictType(), getDetectionRange(), getExtraTime(), getMDRAC_PRT(), getMeasuresAndThresholds(), getOutputFilename(), requestsTrajectories(), useGeoCoords(), writeLanesPositions(), and writePositions().

◆ myLane

MSLane* MSMoveReminder::myLane

protectedinherited

Lane on which the reminder works.

Definition at line 295 of file MSMoveReminder.h.

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

◆ myLastVehicleUpdateValues

std::map<long long int, std::pair<SUMOTime, double> > MSMoveReminder::myLastVehicleUpdateValues

privateinherited

Definition at line 305 of file MSMoveReminder.h.

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

◆ myMaxBR

std::pair<std::pair<double, Position>, double> MSDevice_SSM::myMaxBR

private

Extremal values for the global measures (as <<<time, Position>, value>, [leaderID]>-pairs)

Definition at line 793 of file MSDevice_SSM.h.

Referenced by computeGlobalMeasures(), and flushGlobalMeasures().

◆ myMDRACPRT

double MSDevice_SSM::myMDRACPRT

private

perception reaction time for MDRAC

Definition at line 744 of file MSDevice_SSM.h.

Referenced by determineTTCandDRACandPPETandMDRAC().

◆ myMinSGAP

std::pair<std::pair<std::pair<double, Position>, double>, std::string> MSDevice_SSM::myMinSGAP

private

Definition at line 794 of file MSDevice_SSM.h.

Referenced by computeGlobalMeasures(), and flushGlobalMeasures().

◆ myMinTGAP

std::pair<std::pair<std::pair<double, Position>, double>, std::string> MSDevice_SSM::myMinTGAP

private

Definition at line 795 of file MSDevice_SSM.h.

Referenced by computeGlobalMeasures(), and flushGlobalMeasures().

◆ myOldestActiveEncounterBegin

double MSDevice_SSM::myOldestActiveEncounterBegin

private

begin time of the oldest active encounter

Definition at line 769 of file MSDevice_SSM.h.

Referenced by createEncounters(), flushConflicts(), and processEncounters().

◆ myOutputFile

OutputDevice* MSDevice_SSM::myOutputFile

private

Output device.

Definition at line 805 of file MSDevice_SSM.h.

Referenced by flushGlobalMeasures(), MSDevice_SSM(), and writeOutConflict().

◆ myPastConflicts

EncounterQueue MSDevice_SSM::myPastConflicts

private

Past encounters that where qualified as conflicts and are not yet flushed to the output file.

Definition at line 771 of file MSDevice_SSM.h.

Referenced by closeEncounter(), flushConflicts(), MSDevice_SSM(), and update().

◆ myRange

double MSDevice_SSM::myRange

private

Detection range. For vehicles closer than this distance from the ego vehicle, SSMs are traced.

Definition at line 742 of file MSDevice_SSM.h.

Referenced by findFoeConflictLane(), MSDevice_SSM(), and update().

◆ mySaveTrajectories

bool MSDevice_SSM::mySaveTrajectories

private

This determines whether the whole trajectories of the vehicles (position, speed, ssms) shall be saved in the ssm-output or only the most critical value shall be reported.

Definition at line 740 of file MSDevice_SSM.h.

Referenced by MSDevice_SSM(), and writeOutConflict().

◆ mySGAPspan

std::vector<double> MSDevice_SSM::mySGAPspan

private

All values for space gap.

Definition at line 788 of file MSDevice_SSM.h.

Referenced by computeGlobalMeasures(), and flushGlobalMeasures().

◆ myTGAPspan

std::vector<double> MSDevice_SSM::myTGAPspan

private

All values for time gap.

Definition at line 790 of file MSDevice_SSM.h.

Referenced by computeGlobalMeasures(), and flushGlobalMeasures().

◆ myThresholds

std::map<std::string, double> MSDevice_SSM::myThresholds

private

Definition at line 737 of file MSDevice_SSM.h.

Referenced by computeGlobalMeasures(), MSDevice_SSM(), and qualifiesAsConflict().

◆ myUseGeoCoords

bool MSDevice_SSM::myUseGeoCoords

private

Whether to use the original coordinate system for output.

Definition at line 748 of file MSDevice_SSM.h.

Referenced by flushGlobalMeasures(), makeStringWithNAs(), makeStringWithNAs(), MSDevice_SSM(), and writeOutConflict().

◆ myWriteLanesPositions

bool MSDevice_SSM::myWriteLanesPositions

private

Wether to print the lanes and positions for all timesteps and conflicts.

Definition at line 752 of file MSDevice_SSM.h.

Referenced by computeGlobalMeasures(), flushGlobalMeasures(), and writeOutConflict().

◆ myWritePositions

bool MSDevice_SSM::myWritePositions

private

Wether to print the positions for all timesteps.

Definition at line 750 of file MSDevice_SSM.h.

Referenced by computeGlobalMeasures(), and flushGlobalMeasures().

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

Enumerator
ENCOUNTER_TYPE_NOCONFLICT_AHEAD	ENCOUNTER_TYPE_NOCONFLICT_AHEAD.
ENCOUNTER_TYPE_FOLLOWING	ENCOUNTER_TYPE_FOLLOWING.
ENCOUNTER_TYPE_FOLLOWING_FOLLOWER	ENCOUNTER_TYPE_FOLLOWING_FOLLOWER.
ENCOUNTER_TYPE_FOLLOWING_LEADER	ENCOUNTER_TYPE_FOLLOWING_LEADER.
ENCOUNTER_TYPE_ON_ADJACENT_LANES	ENCOUNTER_TYPE_ON_ADJACENT_LANES.
ENCOUNTER_TYPE_MERGING	ENCOUNTER_TYPE_MERGING.
ENCOUNTER_TYPE_MERGING_LEADER	ENCOUNTER_TYPE_MERGING_LEADER.
ENCOUNTER_TYPE_MERGING_FOLLOWER	ENCOUNTER_TYPE_MERGING_FOLLOWER.
ENCOUNTER_TYPE_MERGING_ADJACENT	ENCOUNTER_TYPE_MERGING_ADJACENT.
ENCOUNTER_TYPE_CROSSING	ENCOUNTER_TYPE_CROSSING.
ENCOUNTER_TYPE_CROSSING_LEADER	ENCOUNTER_TYPE_CROSSING_LEADER.
ENCOUNTER_TYPE_CROSSING_FOLLOWER	ENCOUNTER_TYPE_CROSSING_FOLLOWER.
ENCOUNTER_TYPE_EGO_ENTERED_CONFLICT_AREA	ENCOUNTER_TYPE_EGO_ENTERED_CONFLICT_AREA.
ENCOUNTER_TYPE_FOE_ENTERED_CONFLICT_AREA	ENCOUNTER_TYPE_FOE_ENTERED_CONFLICT_AREA.
ENCOUNTER_TYPE_EGO_LEFT_CONFLICT_AREA	ENCOUNTER_TYPE_EGO_LEFT_CONFLICT_AREA.
ENCOUNTER_TYPE_FOE_LEFT_CONFLICT_AREA	ENCOUNTER_TYPE_FOE_LEFT_CONFLICT_AREA.
ENCOUNTER_TYPE_BOTH_ENTERED_CONFLICT_AREA	ENCOUNTER_TYPE_BOTH_ENTERED_CONFLICT_AREA.
ENCOUNTER_TYPE_BOTH_LEFT_CONFLICT_AREA	ENCOUNTER_TYPE_BOTH_LEFT_CONFLICT_AREA.
ENCOUNTER_TYPE_FOLLOWING_PASSED	ENCOUNTER_TYPE_FOLLOWING_PASSED.
ENCOUNTER_TYPE_MERGING_PASSED	ENCOUNTER_TYPE_FOLLOWING_PASSED.
ENCOUNTER_TYPE_ONCOMING
ENCOUNTER_TYPE_COLLISION	ENCOUNTER_TYPE_COLLISION.

Data Structures

Public Types

Public Member Functions

Static Public Member Functions

Protected Member Functions

Static Protected Member Functions

Protected Attributes

Private Types

Private Member Functions

Static Private Member Functions

Private Attributes

Static Private Attributes

Detailed Description

Member Typedef Documentation

◆ EncounterQueue

◆ EncounterVector

◆ FoeInfoMap

Member Enumeration Documentation

◆ EncounterType

◆ Notification

◆ SSMParameterWarning

Constructor & Destructor Documentation

◆ ~MSDevice_SSM()

◆ MSDevice_SSM() [1/2]

◆ MSDevice_SSM() [2/2]

Member Function Documentation

◆ addTo()

◆ buildTransportableDevices()

◆ buildVehicleDevices()

◆ checkConflictEntryAndExit()

◆ checkOptions()

◆ classifyEncounter()

◆ cleanup()

◆ cleanupAll()

◆ closeEncounter()

◆ computeDRAC() [1/2]

◆ computeDRAC() [2/2]

◆ computeGlobalMeasures()

◆ computeMDRAC()

◆ computeSSMs()

◆ computeTTC()

◆ createEncounters()

◆ determineConflictPoint()

◆ determinePET()

◆ determineTTCandDRACandPPETandMDRAC()

◆ deviceName()

◆ encounterToString()

◆ equippedByDefaultAssignmentOptions()

◆ estimateConflictTimes()

◆ filterByConflictType()

◆ findFoeConflictLane()

◆ findSurroundingVehicles()

◆ flushConflicts()

◆ flushGlobalMeasures()

◆ generateOutput()

◆ getDescription()

◆ getDetectionRange()

◆ getEdgeFilter()

◆ getEquipmentRNG()

◆ getExtraTime()

◆ getHolder()

◆ getID()

◆ getIDSecure()

◆ getInstances()

◆ getLane()

◆ getMDRAC_PRT()

◆ getMeasuresAndThresholds()

◆ getNumericalID()

◆ getOutputFilename()

◆ getParameter()

◆ getUpstreamVehicles()

◆ getVehiclesOnJunction()

◆ initEdgeFilter()

◆ insertDefaultAssignmentOptions()

◆ insertOptions()

◆ isParkingRerouter()

◆ loadState()

◆ makeStringWithNAs() [1/4]

◆ makeStringWithNAs() [2/4]

◆ makeStringWithNAs() [3/4]