Eclipse SUMO - Simulation of Urban MObility
Loading...
Searching...
No Matches
MSDevice_Battery.cpp
Go to the documentation of this file.
1/****************************************************************************/
2// Eclipse SUMO, Simulation of Urban MObility; see https://eclipse.dev/sumo
3// Copyright (C) 2013-2024 German Aerospace Center (DLR) and others.
4// This program and the accompanying materials are made available under the
5// terms of the Eclipse Public License 2.0 which is available at
6// https://www.eclipse.org/legal/epl-2.0/
7// This Source Code may also be made available under the following Secondary
8// Licenses when the conditions for such availability set forth in the Eclipse
9// Public License 2.0 are satisfied: GNU General Public License, version 2
10// or later which is available at
11// https://www.gnu.org/licenses/old-licenses/gpl-2.0-standalone.html
12// SPDX-License-Identifier: EPL-2.0 OR GPL-2.0-or-later
13/****************************************************************************/
20// The Battery parameters for the vehicle
21/****************************************************************************/
22#include <config.h>
23
24#include <algorithm>
32#include <microsim/MSNet.h>
33#include <microsim/MSLane.h>
34#include <microsim/MSEdge.h>
35#include <microsim/MSVehicle.h>
37#include "MSDevice_Emissions.h"
38#include "MSDevice_Battery.h"
39
40#define DEFAULT_MAX_CAPACITY 35000
41#define DEFAULT_CHARGE_RATIO 0.5
42
43
44// ===========================================================================
45// method definitions
46// ===========================================================================
47// ---------------------------------------------------------------------------
48// static initialisation methods
49// ---------------------------------------------------------------------------
50void
52 insertDefaultAssignmentOptions("battery", "Battery", oc);
53 // custom options
54 oc.doRegister("device.battery.track-fuel", new Option_Bool(false));
55 oc.addDescription("device.battery.track-fuel", "Battery", TL("Track fuel consumption for non-electric vehicles"));
56}
57
58
59void
60MSDevice_Battery::buildVehicleDevices(SUMOVehicle& v, std::vector<MSVehicleDevice*>& into, MSDevice_StationFinder* sf) {
61 // Check if vehicle should get a battery
62 if (sf != nullptr || equippedByDefaultAssignmentOptions(OptionsCont::getOptions(), "battery", v, false)) {
63 // obtain parameter values
64 const double maximumBatteryCapacity = readParameterValue(v, SUMO_ATTR_MAXIMUMBATTERYCAPACITY, "battery.capacity", DEFAULT_MAX_CAPACITY);
65 const double actualBatteryCapacity = readParameterValue(v, SUMO_ATTR_ACTUALBATTERYCAPACITY, "battery.chargeLevel", maximumBatteryCapacity * DEFAULT_CHARGE_RATIO);
66 const double stoppingThreshold = readParameterValue(v, SUMO_ATTR_STOPPINGTHRESHOLD, "battery.stoppingThreshold", 0.1);
67 const double maximumChargeRate = readParameterValue(v, SUMO_ATTR_MAXIMUMCHARGERATE, "battery.maximumChargeRate", 150000.);
68 const std::string chargeLevelTable = v.getStringParam("device.battery.chargeLevelTable");
69 const std::string chargeCurveTable = v.getStringParam("device.battery.chargeCurveTable");
70
71 // battery constructor
72 MSDevice_Battery* device = new MSDevice_Battery(v, "battery_" + v.getID(),
73 actualBatteryCapacity, maximumBatteryCapacity, stoppingThreshold, maximumChargeRate, chargeLevelTable, chargeCurveTable);
74
75 // Add device to vehicle
76 into.push_back(device);
77
78 if (sf != nullptr) {
79 sf->setBattery(device);
80 }
81 }
82}
83
84
85double
86MSDevice_Battery::readParameterValue(SUMOVehicle& v, const SumoXMLAttr& attr, const std::string& paramName, double defaultVal) {
87 const std::string& oldParam = toString(attr);
88 const SUMOVTypeParameter& typeParams = v.getVehicleType().getParameter();
89 if (v.getParameter().hasParameter(oldParam) || typeParams.hasParameter(oldParam)) {
90 WRITE_WARNINGF(TL("Battery device in vehicle '%' still uses old parameter '%'. Please update to 'device.%'."), v.getID(), oldParam, paramName);
91 if (v.getParameter().getParameter(oldParam, "-") == "-") {
92 return typeParams.getDouble(oldParam, defaultVal);
93 }
94 return StringUtils::toDouble(v.getParameter().getParameter(oldParam, "0"));
95 }
96 return v.getFloatParam("device." + paramName, false, defaultVal);
97}
98
99
100// ---------------------------------------------------------------------------
101// MSDevice_Battery-methods
102// ---------------------------------------------------------------------------
103MSDevice_Battery::MSDevice_Battery(SUMOVehicle& holder, const std::string& id, const double actualBatteryCapacity, const double maximumBatteryCapacity,
104 const double stoppingThreshold, const double maximumChargeRate, const std::string& chargeLevelTable, const std::string& chargeCurveTable) :
105 MSVehicleDevice(holder, id),
106 myActualBatteryCapacity(0), // [actualBatteryCapacity <= maximumBatteryCapacity]
107 myMaximumBatteryCapacity(0), // [maximumBatteryCapacity >= 0]
108 myStoppingThreshold(0), // [stoppingThreshold >= 0]
109 myMaximumChargeRate(0),
110 myChargeLimit(-1),
111 myLastAngle(std::numeric_limits<double>::infinity()),
112 myChargingStopped(false), // Initially vehicle don't charge stopped
113 myChargingInTransit(false), // Initially vehicle don't charge in transit
114 myChargingStartTime(0), // Initially charging start time (must be if the vehicle was launched at the charging station)
115 myConsum(0), // Initially the vehicle is stopped and therefore the consum is zero.
116 myTotalConsumption(0.0),
117 myTotalRegenerated(0.0),
118 myActChargingStation(nullptr), // Initially the vehicle isn't over a Charging Station
119 myPreviousNeighbouringChargingStation(nullptr), // Initially the vehicle wasn't over a Charging Station
120 myEnergyCharged(0), // Initially the energy charged is zero
121 myVehicleStopped(0),
122 myDepletedCount(0) {
123 // Initially the vehicle is stopped and the corresponding variable is 0
124
125 if (maximumBatteryCapacity < 0) {
126 WRITE_WARNINGF(TL("Battery builder: Vehicle '%' doesn't have a valid value for parameter % (%)."), getID(), toString(SUMO_ATTR_MAXIMUMBATTERYCAPACITY), toString(maximumBatteryCapacity));
127 } else {
128 myMaximumBatteryCapacity = maximumBatteryCapacity;
129 }
130
131 if (actualBatteryCapacity > maximumBatteryCapacity) {
132 WRITE_WARNINGF(TL("Battery builder: Vehicle '%' has a % (%) greater than its % (%). A max battery capacity value will be assigned."),
133 getID(), toString(SUMO_ATTR_ACTUALBATTERYCAPACITY), toString(actualBatteryCapacity), toString(SUMO_ATTR_MAXIMUMBATTERYCAPACITY), toString(maximumBatteryCapacity));
135 } else {
136 myActualBatteryCapacity = actualBatteryCapacity;
137 }
138
139 if (stoppingThreshold < 0) {
140 WRITE_WARNINGF(TL("Battery builder: Vehicle '%' doesn't have a valid value for parameter % (%)."), getID(), toString(SUMO_ATTR_STOPPINGTHRESHOLD), toString(stoppingThreshold));
141 } else {
142 myStoppingThreshold = stoppingThreshold;
143 }
144
145 myTrackFuel = PollutantsInterface::getFuel(holder.getVehicleType().getEmissionClass()) != "Electricity" && OptionsCont::getOptions().getBool("device.battery.track-fuel");
147 WRITE_WARNINGF(TL("The battery device is active for vehicle '%' but no emission class is set. "
148 "Please consider setting an explicit emission class or battery outputs might be inconsistent with emission outputs!"),
149 holder.getID());
150 }
151
152 if (maximumChargeRate < 0) {
153 WRITE_WARNINGF(TL("Battery builder: Vehicle '%' doesn't have a valid value for parameter % (%)."), getID(), toString(SUMO_ATTR_MAXIMUMCHARGERATE), toString(maximumChargeRate));
154 } else {
155 if (!chargeLevelTable.empty() && !chargeCurveTable.empty()) {
156 LinearApproxHelpers::setPoints(myChargeCurve, chargeLevelTable, chargeCurveTable);
157 if (!myTrackFuel) {
159 }
161 } else {
162 myMaximumChargeRate = maximumChargeRate;
163 if (!myTrackFuel) {
164 myMaximumChargeRate /= 3600.;
165 }
166 }
167 }
168}
169
170
173
174
175bool MSDevice_Battery::notifyMove(SUMOTrafficObject& tObject, double /* oldPos */, double /* newPos */, double /* newSpeed */) {
176 if (!tObject.isVehicle()) {
177 return false;
178 }
179 SUMOVehicle& veh = static_cast<SUMOVehicle&>(tObject);
180 // Start vehicleStoppedTimer if the vehicle is stopped. In other case reset timer
181 if (veh.getSpeed() < myStoppingThreshold) {
182 // Increase vehicle stopped timer
184 } else {
185 // Reset vehicle Stopped
187 }
188
189 // Update Energy from the battery
191 if (getMaximumBatteryCapacity() != 0) {
192 params->setDouble(SUMO_ATTR_ANGLE, myLastAngle == std::numeric_limits<double>::infinity() ? 0. : GeomHelper::angleDiff(myLastAngle, veh.getAngle()));
194 // no explicit emission class, we fall back to the energy model; a warning has been issued on creation
196 veh.getSlope(), params) * TS;
197 } else {
200 veh.getSpeed(), veh.getAcceleration(),
201 veh.getSlope(), params) * TS;
202 }
203 if (veh.isParking()) {
204 // recuperation from last braking step is ok but further consumption should cease
205 myConsum = MIN2(myConsum, 0.0);
206 }
207
208 // saturate between 0 and myMaximumBatteryCapacity [Wh]
211 if (myDepletedCount == 1) {
212 WRITE_WARNINGF(TL("Battery of vehicle '%' is depleted, time=%."), veh.getID(), time2string(SIMSTEP));
213 }
214 }
215
216 // Energy lost/gained from vehicle movement (via vehicle energy model) [Wh]
218
219 // Track total energy consumption and regeneration
220 if (myConsum > 0.0) {
222 } else {
224 }
225
226 myLastAngle = veh.getAngle();
227 }
228
229 // Check if vehicle has under their position one charge Station
230 const std::string chargingStationID = MSNet::getInstance()->getStoppingPlaceID(veh.getLane(), veh.getPositionOnLane(), SUMO_TAG_CHARGING_STATION);
231
232 // If vehicle is over a charging station
233 if (chargingStationID != "") {
234 // if the vehicle is almost stopped, or charge in transit is enabled, then charge vehicle
236 const MSParkingArea* pa = cs->getParkingArea();
237 if (((veh.getSpeed() < myStoppingThreshold) || cs->getChargeInTransit()) && (pa == nullptr || veh.isParking())) {
238 // Set Flags Stopped/intransit to
239 if (veh.getSpeed() < myStoppingThreshold) {
240 // vehicle ist almost stopped, then is charging stopped
241 myChargingStopped = true;
242
243 // therefore isn't charging in transit
244 myChargingInTransit = false;
245 } else {
246 // vehicle is moving, and the Charging station allow charge in transit
247 myChargingStopped = false;
248
249 // Therefore charge in transit
250 myChargingInTransit = true;
251 }
252
253 // get pointer to charging station
255
256 // Only update charging start time if vehicle allow charge in transit, or in other case
257 // if the vehicle not allow charge in transit but it's stopped.
259 // Update Charging start time
261 }
262
263 // time it takes the vehicle at the station < charging station time delay?
265 // Enable charging vehicle
267
268 // Calulate energy charged
270
271 // Update Battery charge
273 }
274 // add charge value for output to myActChargingStation
276 }
277 // else disable charging vehicle
278 else {
279 cs->setChargingVehicle(false);
280 }
281 // disable charging vehicle from previous (not current) ChargingStation (reason: if there is no gap between two different chargingStations = the vehicle switches from used charging station to other one in a single timestap)
284 }
286 }
287 // In other case, vehicle will be not charged
288 else {
289 // Disable flags
290 myChargingInTransit = false;
291 myChargingStopped = false;
292
293 // Disable charging vehicle
294 if (myActChargingStation != nullptr) {
296 }
297
298 // Set charging station pointer to NULL
299 myActChargingStation = nullptr;
300
301 // Set energy charged to 0
302 myEnergyCharged = 0.00;
303
304 // Reset timer
306 }
307
308 // Always return true.
309 return true;
310}
311
312
313void
317 std::vector<std::string> internals;
318 internals.push_back(toString(myActualBatteryCapacity));
319 internals.push_back(toString(myLastAngle));
320 internals.push_back(toString(myChargingStopped));
321 internals.push_back(toString(myChargingInTransit));
322 internals.push_back(toString(myChargingStartTime));
323 internals.push_back(toString(myTotalConsumption));
324 internals.push_back(toString(myTotalRegenerated));
325 internals.push_back(toString(myEnergyCharged));
326 internals.push_back(toString(myVehicleStopped));
327 internals.push_back(getChargingStationID());
328 std::string prevChargingID = (myPreviousNeighbouringChargingStation == nullptr) ? "NULL" : myPreviousNeighbouringChargingStation->getID();
329 internals.push_back(prevChargingID);
330 internals.push_back(toString(myMaximumChargeRate));
331 out.writeAttr(SUMO_ATTR_STATE, toString(internals));
332 out.closeTag();
333}
334
335
336void
338 std::istringstream bis(attrs.getString(SUMO_ATTR_STATE));
340 bis >> myLastAngle;
341 bis >> myChargingStopped;
342 bis >> myChargingInTransit;
343 bis >> myChargingStartTime;
344 bis >> myTotalConsumption;
345 bis >> myTotalRegenerated;
346 bis >> myEnergyCharged;
347 bis >> myVehicleStopped;
348 std::string chargingID;
349 bis >> chargingID;
350 if (chargingID != "NULL") {
352 }
353 std::string prevChargingID;
354 bis >> prevChargingID;
355 if (prevChargingID != "NULL") {
357 }
358 bis >> myMaximumChargeRate;
359}
360
361
362void
363MSDevice_Battery::setActualBatteryCapacity(const double actualBatteryCapacity) {
364 if (actualBatteryCapacity < 0) {
366 } else if (actualBatteryCapacity > myMaximumBatteryCapacity) {
368 } else {
369 myActualBatteryCapacity = actualBatteryCapacity;
370 }
371}
372
373
374void
375MSDevice_Battery::setMaximumBatteryCapacity(const double maximumBatteryCapacity) {
376 if (myMaximumBatteryCapacity < 0) {
377 WRITE_WARNINGF(TL("Trying to set into the battery device of vehicle '%' an invalid % (%)."), getID(), toString(SUMO_ATTR_MAXIMUMBATTERYCAPACITY), toString(maximumBatteryCapacity));
378 } else {
379 myMaximumBatteryCapacity = maximumBatteryCapacity;
380 }
381}
382
383
384void
385MSDevice_Battery::setStoppingThreshold(const double stoppingThreshold) {
386 if (stoppingThreshold < 0) {
387 WRITE_WARNINGF(TL("Trying to set into the battery device of vehicle '%' an invalid % (%)."), getID(), toString(SUMO_ATTR_STOPPINGTHRESHOLD), toString(stoppingThreshold));
388 } else {
389 myStoppingThreshold = stoppingThreshold;
390 }
391}
392
393
394void
396 if (chargeRate < 0) {
397 WRITE_WARNINGF(TL("Trying to set into the battery device of vehicle '%' an invalid % (%)."), getID(), toString(SUMO_ATTR_MAXIMUMCHARGERATE), toString(chargeRate));
398 } else {
399 myMaximumChargeRate = chargeRate;
400 }
401}
402
403
404void
406 myChargeLimit = limit;
407}
408
409
410void
414
415
416void
420
421
422void
426
427
428void
432
433
434double
438
439
440double
444
445
446double
448 return myConsum;
449}
450
451double
455
456
457double
461
462
463bool
467
468
469bool
473
474
479
480
482MSDevice_Battery::estimateChargingDuration(const double toCharge, const double csPower) const {
483 //if (!myChargeCurve.empty()) {
484 // // TODO: integrate charge curve
485 //}
486 return TIME2STEPS(toCharge / MIN2(csPower, myMaximumChargeRate));
487}
488
489
490std::string
492 if (myActChargingStation != nullptr) {
493 return myActChargingStation->getID();
494 } else {
495 return "NULL";
496 }
497}
498
499double
503
504
505int
509
510
511double
515
516
517double
522
523
524std::string
525MSDevice_Battery::getParameter(const std::string& key) const {
527 || key == toString(SUMO_ATTR_CHARGELEVEL)) {
529 } else if (key == toString(SUMO_ATTR_ENERGYCONSUMED)) {
530 return toString(getConsum());
531 } else if (key == toString(SUMO_ATTR_TOTALENERGYCONSUMED)) {
533 } else if (key == toString(SUMO_ATTR_TOTALENERGYREGENERATED)) {
535 } else if (key == toString(SUMO_ATTR_ENERGYCHARGED)) {
536 return toString(getEnergyCharged());
537 } else if (key == toString(SUMO_ATTR_MAXIMUMBATTERYCAPACITY) || key == "capacity") {
539 } else if (key == toString(SUMO_ATTR_MAXIMUMCHARGERATE)) {
541 } else if (key == toString(SUMO_ATTR_CHARGINGSTATIONID)) {
542 return getChargingStationID();
543 } else if (key == toString(SUMO_ATTR_VEHICLEMASS)) {
544 WRITE_WARNING(TL("Getting the vehicle mass via parameters is deprecated, please use getMass for the vehicle or its type."));
546 }
547 throw InvalidArgument("Parameter '" + key + "' is not supported for device of type '" + deviceName() + "'");
548}
549
550
551void
552MSDevice_Battery::setParameter(const std::string& key, const std::string& value) {
553 double doubleValue;
554 try {
555 doubleValue = StringUtils::toDouble(value);
556 } catch (NumberFormatException&) {
557 throw InvalidArgument("Setting parameter '" + key + "' requires a number for device of type '" + deviceName() + "'");
558 }
560 setActualBatteryCapacity(doubleValue);
561 } else if (key == toString(SUMO_ATTR_MAXIMUMBATTERYCAPACITY) || key == "capacity") {
562 setMaximumBatteryCapacity(doubleValue);
563 } else if (key == toString(SUMO_ATTR_MAXIMUMCHARGERATE)) {
564 setMaximumChargeRate(doubleValue);
565 } else if (key == toString(SUMO_ATTR_VEHICLEMASS)) {
566 WRITE_WARNING(TL("Setting the vehicle mass via parameters is deprecated, please use setMass for the vehicle or its type."));
568 } else {
569 throw InvalidArgument("Setting parameter '" + key + "' is not supported for device of type '" + deviceName() + "'");
570 }
571}
572
573
574void
576 // @note: only charing is performed but no energy is consumed
578 myConsum = 0;
579}
580
581
582void
584 if (tripinfoOut != nullptr) {
585 tripinfoOut->openTag("battery");
586 tripinfoOut->writeAttr("depleted", toString(myDepletedCount));
587 tripinfoOut->closeTag();
588 }
589}
590
591
592/****************************************************************************/
long long int SUMOTime
Definition GUI.h:36
#define DEFAULT_CHARGE_RATIO
#define DEFAULT_MAX_CAPACITY
#define WRITE_WARNINGF(...)
Definition MsgHandler.h:296
#define WRITE_WARNING(msg)
Definition MsgHandler.h:295
#define TL(string)
Definition MsgHandler.h:315
SUMOTime DELTA_T
Definition SUMOTime.cpp:38
std::string time2string(SUMOTime t, bool humanReadable)
convert SUMOTime to string (independently of global format setting)
Definition SUMOTime.cpp:69
#define SIMSTEP
Definition SUMOTime.h:61
#define TS
Definition SUMOTime.h:42
#define TIME2STEPS(x)
Definition SUMOTime.h:57
const long long int VTYPEPARS_EMISSIONCLASS_SET
@ SUMO_TAG_DEVICE
@ SUMO_TAG_CHARGING_STATION
A Charging Station.
SumoXMLAttr
Numbers representing SUMO-XML - attributes.
@ SUMO_ATTR_CHARGELEVEL
@ SUMO_ATTR_ENERGYCONSUMED
Energy consumed.
@ SUMO_ATTR_MAXIMUMBATTERYCAPACITY
Maxium battery capacity.
@ SUMO_ATTR_MASS
@ SUMO_ATTR_MAXIMUMCHARGERATE
Maximum Power.
@ SUMO_ATTR_STOPPINGTHRESHOLD
Stopping threshold.
@ SUMO_ATTR_CHARGINGSTATIONID
Charging Station ID.
@ SUMO_ATTR_ANGLE
@ SUMO_ATTR_ACTUALBATTERYCAPACITY
@ SUMO_ATTR_VEHICLEMASS
Vehicle mass.
@ SUMO_ATTR_ENERGYCHARGED
tgotal of Energy charged
@ SUMO_ATTR_ID
@ SUMO_ATTR_TOTALENERGYREGENERATED
Total energy regenerated.
@ SUMO_ATTR_TOTALENERGYCONSUMED
Total energy consumed.
@ SUMO_ATTR_STATE
The state of a link.
T MIN2(T a, T b)
Definition StdDefs.h:76
std::string toString(const T &t, std::streamsize accuracy=gPrecision)
Definition ToString.h:46
An upper class for objects with additional parameters.
double getDouble(SumoXMLAttr attr) const
void setDouble(SumoXMLAttr attr, double value)
Sets a parameter.
static double angleDiff(const double angle1, const double angle2)
Returns the difference of the second angle to the first angle in radiants.
double compute(const SUMOEmissionClass c, const PollutantsInterface::EmissionType e, const double v, const double a, const double slope, const EnergyParams *param) const
Computes the emitted pollutant amount using the given speed and acceleration.
static double getInterpolatedValue(const LinearApproxMap &map, double axisValue)
Get interpolated value.
static void scaleValues(LinearApproxMap &map, const double factor)
Scale values.
static bool setPoints(LinearApproxMap &map, const std::string &axisString, const std::string &heightString)
Set data points.
static double getMaximumValue(const LinearApproxMap &map)
Get the largest height value.
double getChargingPower(bool usingFuel) const
Get charging station's charging power.
bool getChargeInTransit() const
Get chargeInTransit.
void setChargingVehicle(bool value)
enable or disable charging vehicle
void addChargeValueForOutput(double WCharged, MSDevice_Battery *battery)
add charge value for output
SUMOTime getChargeDelay() const
Get Charge Delay.
double getEfficency() const
Get efficiency of the charging station.
const MSParkingArea * getParkingArea() const
Get the parking area the charging station is placed on.
Battery device for electric vehicles.
SUMOTime getChargingStartTime() const
Get charging start time.
void saveState(OutputDevice &out) const override
Saves the state of the device.
static void insertOptions(OptionsCont &oc)
Inserts MSDevice_Example-options.
void notifyParking()
called to update state for parking vehicles
int myVehicleStopped
Parameter, How many timestep the vehicle is stopped.
bool myChargingInTransit
Parameter, Flag: Vehicles it's charging in transit (by default is false)
LinearApproxHelpers::LinearApproxMap myChargeCurve
Charge curve data points storage.
double getActualBatteryCapacity() const
Get the actual vehicle's Battery Capacity in Wh.
int getVehicleStopped() const
Get number of timestep that vehicle is stopped.
void setChargeLimit(const double limit)
Set (temporary) charge limit.
MSDevice_Battery(SUMOVehicle &holder, const std::string &id, const double actualBatteryCapacity, const double maximumBatteryCapacity, const double stoppingThreshold, const double maximumChargeRate, const std::string &chargeLevelTable, const std::string &chargeCurveTable)
Constructor.
double myMaximumBatteryCapacity
Parameter, The total vehicles's Battery Capacity in Wh, [myMaximumBatteryCapacity >= 0].
void increaseVehicleStoppedTimer()
Increase myVehicleStopped.
double myActualBatteryCapacity
Parameter, The actual vehicles's Battery Capacity in Wh, [myActualBatteryCapacity <= myMaximumBattery...
bool notifyMove(SUMOTrafficObject &veh, double oldPos, double newPos, double newSpeed)
Checks for waiting steps when the vehicle moves.
double getMaximumChargeRate() const
Get current charge rate in W depending on the state of charge.
void setParameter(const std::string &key, const std::string &value) override
try to set the given parameter for this device. Throw exception for unsupported key
void increaseChargingStartTime()
Increase Charging Start time.
MSChargingStation * myPreviousNeighbouringChargingStation
Parameter, Pointer to charging station neighbouring with myActChargingStation in which vehicle was pl...
void loadState(const SUMOSAXAttributes &attrs) override
Loads the state of the device from the given description.
void setStoppingThreshold(const double stoppingThreshold)
Set vehicle's stopping threshold.
double getMaximumBatteryCapacity() const
Get the total vehicle's Battery Capacity in Wh.
SUMOTime estimateChargingDuration(const double toCharge, const double csPower) const
Estimate the charging duration given the current battery state.
bool myChargingStopped
Parameter, Flag: Vehicles it's charging stopped (by default is false)
double getConsum() const
Get consum.
void setActualBatteryCapacity(const double actualBatteryCapacity)
Set actual vehicle's Battery Capacity in kWh.
std::string getParameter(const std::string &key) const override
try to retrieve the given parameter from this device. Throw exception for unsupported key
bool myTrackFuel
whether to track fuel consumption instead of electricity
double myEnergyCharged
Parameter, Energy charged in each timestep.
double myLastAngle
Parameter, Vehicle's last angle.
void setMaximumChargeRate(const double chargeRate)
Set vehicle's stopping threshold.
double getStoppingThreshold() const
Get stopping threshold.
double myTotalRegenerated
Parameter, total vehicle energy regeneration.
double myMaximumChargeRate
Parameter, maximum charge rate in W.
SUMOTime myChargingStartTime
Parameter, Moment, which the vehicle has beging to charging.
bool isChargingInTransit() const
Get true if Vehicle it's charging, false if not.
void resetChargingStartTime()
Reset charging start time.
double myTotalConsumption
Parameter, total vehicle energy consumption.
const std::string deviceName() const
return the name for this type of device
void resetVehicleStoppedTimer()
Reset myVehicleStopped.
int myDepletedCount
Count how many times the vehicle experienced a depleted battery.
double myChargeLimit
(Temporary) limitation in W of the maximum charge rate = charging strategy result
double getTotalRegenerated() const
Get total regenerated.
double getTotalConsumption() const
Get total consumption.
MSChargingStation * myActChargingStation
Parameter, Pointer to current charging station in which vehicle is placed (by default is NULL)
void generateOutput(OutputDevice *tripinfoOut) const
Called on vehicle deletion to extend tripinfo.
~MSDevice_Battery()
Destructor.
double myConsum
Parameter, Vehicle consum during a time step (by default is 0.)
double getEnergyCharged() const
Get charged energy.
std::string getChargingStationID() const
Get current Charging Station ID.
void setMaximumBatteryCapacity(const double maximumBatteryCapacity)
Set total vehicle's Battery Capacity in kWh.
static void buildVehicleDevices(SUMOVehicle &v, std::vector< MSVehicleDevice * > &into, MSDevice_StationFinder *sf)
Build devices for the given vehicle, if needed.
static double readParameterValue(SUMOVehicle &v, const SumoXMLAttr &attr, const std::string &paramName, double defaultVal)
Read device parameters from input.
double myStoppingThreshold
Parameter, stopping vehicle threshold [myStoppingThreshold >= 0].
bool isChargingStopped() const
Get true if Vehicle is charging, false if not.
A device which triggers rerouting to nearby charging stations.
void setBattery(MSDevice_Battery *battery)
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.
Definition MSDevice.cpp:155
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.
Definition MSDevice.h:195
static MSNet * getInstance()
Returns the pointer to the unique instance of MSNet (singleton).
Definition MSNet.cpp:185
std::string getStoppingPlaceID(const MSLane *lane, const double pos, const SumoXMLTag category) const
Returns the stop of the given category close to the given position.
Definition MSNet.cpp:1401
MSStoppingPlace * getStoppingPlace(const std::string &id, const SumoXMLTag category) const
Returns the named stopping place of the given category.
Definition MSNet.cpp:1380
A lane area vehicles can halt at.
Abstract in-vehicle device.
SUMOVehicle & myHolder
The vehicle that stores the device.
SUMOEmissionClass getEmissionClass() const
Get this vehicle type's emission class.
const SUMOVTypeParameter & getParameter() const
const std::string & getID() const
Returns the id.
Definition Named.h:74
A storage for options typed value containers)
Definition OptionsCont.h:89
void addDescription(const std::string &name, const std::string &subtopic, const std::string &description)
Adds a description for an option.
void doRegister(const std::string &name, Option *o)
Adds an option under the given name.
bool getBool(const std::string &name) const
Returns the boolean-value of the named option (only for Option_Bool)
static OptionsCont & getOptions()
Retrieves the options.
Static storage of an output device and its base (abstract) implementation.
OutputDevice & writeAttr(const SumoXMLAttr attr, const T &val)
writes a named attribute
OutputDevice & openTag(const std::string &xmlElement)
Opens an XML tag.
bool closeTag(const std::string &comment="")
Closes the most recently opened tag and optionally adds a comment.
bool hasParameter(const std::string &key) const
Returns whether the parameter is set.
double getDouble(const std::string &key, const double defaultValue) const
Returns the value for a given key converted to a double.
virtual const std::string getParameter(const std::string &key, const std::string defaultValue="") const
Returns the value for a given key.
static const HelpersEnergy & getEnergyHelper()
get energy helper
static std::string getFuel(const SUMOEmissionClass c)
Returns the fuel type of the given emission class.
static double compute(const SUMOEmissionClass c, const EmissionType e, const double v, const double a, const double slope, const EnergyParams *param)
Returns the amount of the emitted pollutant given the vehicle type and state (in mg/s or ml/s for fue...
Encapsulated SAX-Attributes.
virtual std::string getString(int id, bool *isPresent=nullptr) const =0
Returns the string-value of the named (by its enum-value) attribute.
Representation of a vehicle, person, or container.
virtual bool isVehicle() const
Whether it is a vehicle.
virtual double getAcceleration() const =0
Returns the object's acceleration.
virtual const MSVehicleType & getVehicleType() const =0
Returns the object's "vehicle" type.
std::string getStringParam(const std::string &paramName, const bool required=false, const std::string &deflt="") const
Retrieve a string parameter for the traffic object.
virtual double getSlope() const =0
Returns the slope of the road at object's position in degrees.
virtual const MSLane * getLane() const =0
Returns the lane the object is currently at.
virtual double getSpeed() const =0
Returns the object's current speed.
virtual const SUMOVehicleParameter & getParameter() const =0
Returns the vehicle's parameter (including departure definition)
double getFloatParam(const std::string &paramName, const bool required=false, const double deflt=INVALID_DOUBLE) const
Retrieve a floating point parameter for the traffic object.
virtual double getPositionOnLane() const =0
Get the object's position along the lane.
Structure representing possible vehicle parameter.
bool wasSet(long long int what) const
Returns whether the given parameter was set.
Representation of a vehicle.
Definition SUMOVehicle.h:62
virtual bool isParking() const =0
Returns the information whether the vehicle is parked.
virtual EnergyParams * getEmissionParameters() const =0
Returns the vehicle's emission model parameter.
virtual double getAngle() const =0
Get the vehicle's angle.
static double toDouble(const std::string &sData)
converts a string into the double value described by it by calling the char-type converter
Definition json.hpp:4471