Helper methods for PHEMlight-based emission computation. More...

#include <HelpersPHEMlight5.h>

Inheritance diagram for HelpersPHEMlight5:

Collaboration diagram for HelpersPHEMlight5:

Public Member Functions
void	addAllClassesInto (std::vector< SUMOEmissionClass > &list) const
	Add all known emission classes of this model to the given container. More...

double	compute (const SUMOEmissionClass c, const PollutantsInterface::EmissionType e, const double v, const double a, const double slope, const EnergyParams *param) const
	Returns the amount of emitted pollutant given the vehicle type and state (in mg/s or in ml/s for fuel) More...

std::string	getAmitranVehicleClass (const SUMOEmissionClass c) const
	Returns the vehicle class described by this emission class as described in the Amitran interface (Passenger, ...) More...

SUMOEmissionClass	getClass (const SUMOEmissionClass base, const std::string &vClass, const std::string &fuel, const std::string &eClass, const double weight) const
	Returns the emission class described by the given parameters. More...

SUMOEmissionClass	getClassByName (const std::string &eClass, const SUMOVehicleClass vc)
	Checks whether the string describes a known vehicle class. More...

const std::string	getClassName (const SUMOEmissionClass c) const
	Returns the complete name of the emission class including the model. More...

virtual double	getCoastingDecel (const SUMOEmissionClass c, const double v, const double a, const double slope, const EnergyParams *param) const
	Returns the maximum deceleration value (as a negative number), which can still be considered as non-braking. More...

int	getEuroClass (const SUMOEmissionClass c) const
	Returns the Euro emission class described by this emission class as described in the Amitran interface (0, ..., 6) More...

std::string	getFuel (const SUMOEmissionClass c) const
	Returns the fuel type described by this emission class as described in the Amitran interface (Gasoline, Diesel, ...) More...

double	getModifiedAccel (const SUMOEmissionClass c, const double v, const double a, const double slope, const EnergyParams *param) const
	Returns the adapted acceleration value, useful for comparing with external PHEMlight references. More...

const std::string &	getName () const
	Returns the name of the model. More...

double	getWeight (const SUMOEmissionClass c) const
	Returns a reference weight in kg described by this emission class as described in the Amitran interface This implementation returns only meaningful values for Solo_LKW (truck without trailer) and LNF (light duty vehicles). More...

	HelpersPHEMlight5 ()
	Constructor. More...

bool	includesClass (const SUMOEmissionClass c) const

virtual bool	isSilent (const SUMOEmissionClass c)
	Returns whether the class denotes a silent vehicle for interfacing with the noise model. By default the first class in each model is the silent class. More...

virtual	~HelpersPHEMlight5 ()
	Destructor. More...

Protected Attributes
const int	myBaseIndex
	the starting index for classes of this model More...

StringBijection< SUMOEmissionClass >	myEmissionClassStrings
	Mapping between emission class names and integer representations. More...

const std::string	myName
	the name of the model More...

bool	myVolumetricFuel
	return fuel consumption in l instead of mg More...

Static Protected Attributes
static const double	ZERO_SPEED_ACCURACY = .5
	the lowest speed which allows reliable coasting calculations More...

Private Member Functions
double	calcPower (PHEMlightdllV5::CEP currCep, const double v, const double a, const double slope, const EnergyParams param) const
	Returns the total power needed. More...

double	calcWheelPower (PHEMlightdllV5::CEP currCep, const double v, const double a, const double slope, const EnergyParams param) const
	Returns the power without auxiliaries. More...

double	getEmission (PHEMlightdllV5::CEP *currCep, const std::string &e, const double p, const double v, const double drivingPower, const double ratedPower) const
	Returns the amount of emitted pollutant given the vehicle type and state (in mg/s or in ml/s for fuel) More...

Private Attributes
PHEMlightdllV5::CEPHandler	myCEPHandler

std::map< SUMOEmissionClass, PHEMlightdllV5::CEP * >	myCEPs

PHEMlightdllV5::Correction *	myCorrection = nullptr

PHEMlightdllV5::Helpers	myHelper

int	myIndex
	the index of the next class More...

Static Private Attributes
static const int	PHEMLIGHT5_BASE = 6 << 16

static const int	PHEMLIGHT_BASE = 3 << 16

Detailed Description

Helper methods for PHEMlight-based emission computation.

Definition at line 43 of file HelpersPHEMlight5.h.

Constructor & Destructor Documentation

◆ HelpersPHEMlight5()

HelpersPHEMlight5::HelpersPHEMlight5 ( )

Constructor.

Definition at line 38 of file HelpersPHEMlight5.cpp.

◆ ~HelpersPHEMlight5()

HelpersPHEMlight5::~HelpersPHEMlight5 ( )

virtual

Destructor.

Definition at line 44 of file HelpersPHEMlight5.cpp.

References myCEPs.

Member Function Documentation

◆ addAllClassesInto()

void PollutantsInterface::Helper::addAllClassesInto ( std::vector< SUMOEmissionClass > & list ) const

inherited

Add all known emission classes of this model to the given container.

Parameters

[in] list the vector to add to

Definition at line 214 of file PollutantsInterface.cpp.

Referenced by PollutantsInterface::getAllClasses(), and PollutantsInterface::getAllClassesStr().

Here is the caller graph for this function:

◆ calcPower()

double HelpersPHEMlight5::calcPower	(	PHEMlightdllV5::CEP *	currCep,
		const double	v,
		const double	a,
		const double	slope,
		const EnergyParams *	param
	)		const

private

Returns the total power needed.

Parameters

[in]	currCep	the emission class
[in]	v	the speed value
[in]	a	the acceleration value
[in]	slope	The road's slope at vehicle's position [deg]

Returns: the total power needed

Definition at line 136 of file HelpersPHEMlight5.cpp.

References PHEMlightdllV5::Constants::_DRIVE_TRAIN_EFFICIENCY, calcWheelPower(), PHEMlightdllV5::CEP::getAuxPower(), PHEMlightdllV5::CEP::getCalcType(), EnergyParams::getDoubleOptional(), and SUMO_ATTR_CONSTANTPOWERINTAKE.

Referenced by compute(), and getModifiedAccel().

Here is the caller graph for this function:

◆ calcWheelPower()

double HelpersPHEMlight5::calcWheelPower	(	PHEMlightdllV5::CEP *	currCep,
		const double	v,
		const double	a,
		const double	slope,
		const EnergyParams *	param
	)		const

private

Returns the power without auxiliaries.

Parameters

[in]	currCep	the emission class
[in]	v	the speed value
[in]	a	the acceleration value
[in]	slope	The road's slope at vehicle's position [deg]

Returns: the power without auxiliaries

Definition at line 147 of file HelpersPHEMlight5.cpp.

Referenced by calcPower(), and compute().

Here is the caller graph for this function:

◆ compute()

double HelpersPHEMlight5::compute	(	const SUMOEmissionClass	c,
		const PollutantsInterface::EmissionType	e,
		const double	v,
		const double	a,
		const double	slope,
		const EnergyParams *	param
	)		const

virtual

Returns the amount of emitted pollutant given the vehicle type and state (in mg/s or in ml/s for fuel)

Parameters

[in]	c	The vehicle emission class
[in]	v	The vehicle's current velocity
[in]	a	The vehicle's current acceleration
[in]	slope	The road's slope at vehicle's position [deg]

Returns: The amount of the pollutant emitted by the given emission class when moving with the given velocity and acceleration [mg/s or ml/s]

Reimplemented from HelpersPHEMlight.

Definition at line 209 of file HelpersPHEMlight5.cpp.

◆ getAmitranVehicleClass()

std::string HelpersPHEMlight::getAmitranVehicleClass ( const SUMOEmissionClass c ) const

virtualinherited

Returns the vehicle class described by this emission class as described in the Amitran interface (Passenger, ...)

Parameters

[in] c the emission class

Returns: the name of the vehicle class

Reimplemented from PollutantsInterface::Helper.

Definition at line 169 of file HelpersPHEMlight.cpp.

References StringBijection< T >::getString(), and PollutantsInterface::Helper::myEmissionClassStrings.

◆ getClass()

SUMOEmissionClass HelpersPHEMlight::getClass	(	const SUMOEmissionClass	base,
		const std::string &	vClass,
		const std::string &	fuel,
		const std::string &	eClass,
		const double	weight
	)		const

virtualinherited

Returns the emission class described by the given parameters.

Parameters

[in]	base	the base class giving the default
[in]	vClass	the vehicle class as described in the Amitran interface (Passenger, ...)
[in]	fuel	the fuel type as described in the Amitran interface (Gasoline, Diesel, ...)
[in]	eClass	the emission class as described in the Amitran interface (Euro0, ...)
[in]	weight	the vehicle weight in kg as described in the Amitran interface

Returns: the class described by the parameters

Reimplemented from PollutantsInterface::Helper.

Definition at line 106 of file HelpersPHEMlight.cpp.

References StringBijection< T >::get(), StringBijection< T >::hasString(), and PollutantsInterface::Helper::myEmissionClassStrings.

◆ getClassByName()

SUMOEmissionClass HelpersPHEMlight5::getClassByName	(	const std::string &	eClass,
		const SUMOVehicleClass	vc
	)

virtual

Checks whether the string describes a known vehicle class.

Parameters

[in] eClass The string describing the vehicle emission class

Returns: whether it describes a valid emission class

Reimplemented from HelpersPHEMlight.

Definition at line 52 of file HelpersPHEMlight5.cpp.

References StringBijection< T >::addAlias(), StringBijection< T >::get(), OptionsCont::getBool(), PHEMlightdllV5::CEPHandler::GetCEP(), PHEMlightdllV5::CEPHandler::getCEPS(), PHEMlightdllV5::Helpers::getErrMsg(), OptionsCont::getFloat(), PHEMlightdllV5::Helpers::getgClass(), PHEMlightdllV5::CEP::getHeavyVehicle(), OptionsCont::getInt(), OptionsCont::getOptions(), OptionsCont::getString(), StringBijection< T >::hasString(), PollutantsInterface::HEAVY_BIT, StringBijection< T >::insert(), OptionsCont::isDefault(), myCEPHandler, myCEPs, myCorrection, PollutantsInterface::Helper::myEmissionClassStrings, myHelper, myIndex, PollutantsInterface::Helper::myVolumetricFuel, PHEMlightdllV5::Correction::ReadDet(), PHEMlightdllV5::Correction::ReadTNOx(), PHEMlightdllV5::Correction::setAmbTemp(), PHEMlightdllV5::Helpers::setclass(), PHEMlightdllV5::Helpers::setCommentPrefix(), PHEMlightdllV5::Helpers::setPHEMDataV(), PHEMlightdllV5::Correction::setUseDet(), PHEMlightdllV5::Correction::setUseTNOx(), PHEMlightdllV5::Correction::setYear(), and StringUtils::to_lower_case().

◆ getClassName()

const std::string PollutantsInterface::Helper::getClassName ( const SUMOEmissionClass c ) const

inherited

Returns the complete name of the emission class including the model.

Parameters

[in] c the emission class

Returns: the name of the class (the complete emission class attribute)

Definition at line 124 of file PollutantsInterface.cpp.

Referenced by PollutantsInterface::getName().

Here is the caller graph for this function:

◆ getCoastingDecel()

double HelpersPHEMlight5::getCoastingDecel	(	const SUMOEmissionClass	c,
		const double	v,
		const double	a,
		const double	slope,
		const EnergyParams *	param
	)		const

virtual

Returns the maximum deceleration value (as a negative number), which can still be considered as non-braking.

Parameters

[in]	c	the emission class
[in]	v	the speed value
[in]	a	the acceleration value
[in]	slope	The road's slope at vehicle's position [deg]
[in]	param	parameter of the emission model affecting the computation

Returns: the coasting deceleration

Reimplemented from HelpersPHEMlight.

Definition at line 186 of file HelpersPHEMlight5.cpp.

Referenced by compute().

Here is the caller graph for this function:

◆ getEmission()

double HelpersPHEMlight5::getEmission	(	PHEMlightdllV5::CEP *	currCep,
		const std::string &	e,
		const double	p,
		const double	v,
		const double	drivingPower,
		const double	ratedPower
	)		const

private

Returns the amount of emitted pollutant given the vehicle type and state (in mg/s or in ml/s for fuel)

Parameters

[in]	currCep	The vehicle emission class
[in]	e	The emission type
[in]	p	The vehicle's current power
[in]	v	The vehicle's current velocity

Returns: The amount of the pollutant emitted by the given emission class when moving with the given velocity and acceleration [mg/s or ml/s]

Definition at line 130 of file HelpersPHEMlight5.cpp.

References PHEMlightdllV5::CEP::GetEmission(), and myHelper.

Referenced by compute().

Here is the caller graph for this function:

◆ getEuroClass()

int HelpersPHEMlight::getEuroClass ( const SUMOEmissionClass c ) const

virtualinherited

Returns the Euro emission class described by this emission class as described in the Amitran interface (0, ..., 6)

Parameters

[in] c the emission class

Returns: the Euro class

Reimplemented from PollutantsInterface::Helper.

Definition at line 205 of file HelpersPHEMlight.cpp.

References StringBijection< T >::getString(), and PollutantsInterface::Helper::myEmissionClassStrings.

◆ getFuel()

std::string HelpersPHEMlight5::getFuel ( const SUMOEmissionClass c ) const

virtual

Returns the fuel type described by this emission class as described in the Amitran interface (Gasoline, Diesel, ...)

Parameters

[in] c the emission class

Returns: the fuel type

Reimplemented from HelpersPHEMlight.

Definition at line 113 of file HelpersPHEMlight5.cpp.

References StringBijection< T >::getString(), and PollutantsInterface::Helper::myEmissionClassStrings.

◆ getModifiedAccel()

double HelpersPHEMlight5::getModifiedAccel	(	const SUMOEmissionClass	c,
		const double	v,
		const double	a,
		const double	slope,
		const EnergyParams *	param
	)		const

virtual

Returns the adapted acceleration value, useful for comparing with external PHEMlight references.

Parameters

[in]	c	the emission class
[in]	v	the speed value
[in]	a	the acceleration value
[in]	slope	The road's slope at vehicle's position [deg]

Returns: the modified acceleration

Reimplemented from HelpersPHEMlight.

Definition at line 165 of file HelpersPHEMlight5.cpp.

References calcPower(), EnergyParams::getDoubleOptional(), PHEMlightdllV5::CEP::GetPMaxNorm(), PHEMlightdllV5::CEP::getRatedPower(), PHEMlightdllV5::CEP::GetRotationalCoeffecient(), PHEMlightdllV5::CEP::getVehicleLoading(), PHEMlightdllV5::CEP::getVehicleMass(), PHEMlightdllV5::CEP::getVehicleMassRot(), MIN2(), myCEPs, SUMO_ATTR_LOADING, SUMO_ATTR_MASS, SUMO_ATTR_MAXIMUMPOWER, and SUMO_ATTR_ROTATINGMASS.

Referenced by compute().

Here is the caller graph for this function:

◆ getName()

const std::string & PollutantsInterface::Helper::getName ( ) const

inherited

Returns the name of the model.

Returns: the name of the model (string before the '/' in the emission class attribute)

Definition at line 107 of file PollutantsInterface.cpp.

◆ getWeight()

double HelpersPHEMlight::getWeight ( const SUMOEmissionClass c ) const

virtualinherited

Returns a reference weight in kg described by this emission class as described in the Amitran interface This implementation returns only meaningful values for Solo_LKW (truck without trailer) and LNF (light duty vehicles).

Parameters

[in] c the emission class

Returns: a reference weight

Reimplemented from PollutantsInterface::Helper.

Definition at line 225 of file HelpersPHEMlight.cpp.

References StringBijection< T >::getString(), and PollutantsInterface::Helper::myEmissionClassStrings.

◆ includesClass()

bool PollutantsInterface::Helper::includesClass ( const SUMOEmissionClass c ) const

inherited

Definition at line 220 of file PollutantsInterface.cpp.

◆ isSilent()

bool PollutantsInterface::Helper::isSilent ( const SUMOEmissionClass c )

virtualinherited

Returns whether the class denotes a silent vehicle for interfacing with the noise model. By default the first class in each model is the silent class.

Parameters

[in] c the emission class

Returns: whether the class denotes a silent vehicle

Definition at line 130 of file PollutantsInterface.cpp.

References PollutantsInterface::HEAVY_BIT.

Referenced by PollutantsInterface::isSilent().

Here is the caller graph for this function:

Field Documentation

◆ myBaseIndex

const int PollutantsInterface::Helper::myBaseIndex

protectedinherited

the starting index for classes of this model

Definition at line 228 of file PollutantsInterface.h.

◆ myCEPHandler

PHEMlightdllV5::CEPHandler HelpersPHEMlight5::myCEPHandler

private

Definition at line 126 of file HelpersPHEMlight5.h.

Referenced by getClassByName().

◆ myCEPs

std::map<SUMOEmissionClass, PHEMlightdllV5::CEP*> HelpersPHEMlight5::myCEPs

private

Definition at line 129 of file HelpersPHEMlight5.h.

Referenced by compute(), getClassByName(), getCoastingDecel(), getModifiedAccel(), and ~HelpersPHEMlight5().

◆ myCorrection

PHEMlightdllV5::Correction* HelpersPHEMlight5::myCorrection = nullptr

private

Definition at line 127 of file HelpersPHEMlight5.h.

Referenced by getClassByName().

◆ myEmissionClassStrings

StringBijection<SUMOEmissionClass> PollutantsInterface::Helper::myEmissionClassStrings

protectedinherited

Mapping between emission class names and integer representations.

Definition at line 234 of file PollutantsInterface.h.

Referenced by HelpersHBEFA3::getAmitranVehicleClass(), HelpersHBEFA4::getAmitranVehicleClass(), HelpersPHEMlight::getAmitranVehicleClass(), HelpersHBEFA3::getClass(), HelpersHBEFA4::getClass(), HelpersPHEMlight::getClass(), HelpersPHEMlight::getClassByName(), getClassByName(), HelpersHBEFA3::getEuroClass(), HelpersHBEFA4::getEuroClass(), HelpersPHEMlight::getEuroClass(), HelpersHBEFA3::getFuel(), HelpersHBEFA4::getFuel(), HelpersPHEMlight::getFuel(), getFuel(), HelpersPHEMlight::getWeight(), PollutantsInterface::Helper::Helper(), HelpersHBEFA::HelpersHBEFA(), HelpersHBEFA3::HelpersHBEFA3(), and HelpersHBEFA4::HelpersHBEFA4().

◆ myHelper

PHEMlightdllV5::Helpers HelpersPHEMlight5::myHelper

mutableprivate

Definition at line 128 of file HelpersPHEMlight5.h.

Referenced by compute(), getClassByName(), and getEmission().

◆ myIndex

int HelpersPHEMlight5::myIndex

private

the index of the next class

Definition at line 125 of file HelpersPHEMlight5.h.

Referenced by getClassByName().

◆ myName

const std::string PollutantsInterface::Helper::myName

protectedinherited

the name of the model

Definition at line 225 of file PollutantsInterface.h.

◆ myVolumetricFuel

bool PollutantsInterface::Helper::myVolumetricFuel

protectedinherited

return fuel consumption in l instead of mg

Definition at line 231 of file PollutantsInterface.h.

Referenced by HelpersHBEFA::compute(), HelpersHBEFA3::compute(), HelpersHBEFA4::compute(), HelpersPHEMlight::compute(), compute(), HelpersPHEMlight::getClassByName(), and getClassByName().

◆ PHEMLIGHT5_BASE

const int HelpersPHEMlight5::PHEMLIGHT5_BASE = 6 << 16

staticprivate

Definition at line 45 of file HelpersPHEMlight5.h.

◆ PHEMLIGHT_BASE

const int HelpersPHEMlight::PHEMLIGHT_BASE = 3 << 16

staticprivateinherited

Definition at line 48 of file HelpersPHEMlight.h.

◆ ZERO_SPEED_ACCURACY

const double PollutantsInterface::Helper::ZERO_SPEED_ACCURACY = .5

staticprotectedinherited

the lowest speed which allows reliable coasting calculations

Definition at line 222 of file PollutantsInterface.h.

Referenced by HelpersHBEFA::compute(), HelpersHBEFA3::compute(), and HelpersHBEFA4::compute().

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

Public Member Functions

Protected Attributes

Static Protected Attributes

Private Member Functions

Private Attributes

Static Private Attributes

Detailed Description

Constructor & Destructor Documentation

◆ HelpersPHEMlight5()

◆ ~HelpersPHEMlight5()

Member Function Documentation

◆ addAllClassesInto()

◆ calcPower()

◆ calcWheelPower()

◆ compute()

◆ getAmitranVehicleClass()

◆ getClass()

◆ getClassByName()

◆ getClassName()

◆ getCoastingDecel()

◆ getEmission()

◆ getEuroClass()

◆ getFuel()

◆ getModifiedAccel()

◆ getName()

◆ getWeight()

◆ includesClass()

◆ isSilent()

Field Documentation

◆ myBaseIndex

◆ myCEPHandler

◆ myCEPs

◆ myCorrection

◆ myEmissionClassStrings

◆ myHelper

◆ myIndex

◆ myName

◆ myVolumetricFuel

◆ PHEMLIGHT5_BASE

◆ PHEMLIGHT_BASE

◆ ZERO_SPEED_ACCURACY