Eclipse SUMO - Simulation of Urban MObility
MSChargingStation.cpp
Go to the documentation of this file.
1/****************************************************************************/
2// Eclipse SUMO, Simulation of Urban MObility; see https://eclipse.org/sumo
3// Copyright (C) 2001-2022 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// Chargin Station for Electric vehicles
21/****************************************************************************/
22#include <config.h>
23
24#include <cassert>
30#include <microsim/MSNet.h>
31#include "MSChargingStation.h"
32
33
34// ===========================================================================
35// member method definitions
36// ===========================================================================
37
38MSChargingStation::MSChargingStation(const std::string& chargingStationID, MSLane& lane, double startPos, double endPos,
39 const std::string& name,
40 double chargingPower, double efficency, bool chargeInTransit, SUMOTime chargeDelay) :
41 MSStoppingPlace(chargingStationID, SUMO_TAG_CHARGING_STATION, std::vector<std::string>(), lane, startPos, endPos, name),
42 myChargingPower(0),
43 myEfficiency(0),
44 myChargeInTransit(chargeInTransit),
45 myChargeDelay(0),
46 myChargingVehicle(false),
47 myTotalCharge(0) {
48 if (chargingPower < 0)
49 WRITE_WARNING("Parameter " + toString(SUMO_ATTR_CHARGINGPOWER) + " for " + toString(SUMO_TAG_CHARGING_STATION) + " with ID = " + getID() + " is invalid (" + toString(chargingPower) + ").")
50 else {
51 myChargingPower = chargingPower;
52 }
53
54 if (efficency < 0 || efficency > 1) {
55 WRITE_WARNING("Parameter " + toString(SUMO_ATTR_EFFICIENCY) + " for " + toString(SUMO_TAG_CHARGING_STATION) + " with ID = " + getID() + " is invalid (" + toString(getEfficency()) + ").")
56 } else {
57 myEfficiency = efficency;
58 }
59
60 if (chargeDelay < 0) {
61 WRITE_WARNING("Parameter " + toString(SUMO_ATTR_CHARGEDELAY) + " for " + toString(SUMO_TAG_CHARGING_STATION) + " with ID = " + getID() + " is invalid (" + toString(getEfficency()) + ").")
62 } else {
63 myChargeDelay = chargeDelay;
64 }
65
67 WRITE_WARNING(toString(SUMO_TAG_CHARGING_STATION) + " with ID = " + getID() + " doesn't have a valid range (" + toString(getBeginLanePosition()) + " < " + toString(getEndLanePosition()) + ").");
68 }
69}
70
71
73}
74
75
76double
78 if (usingFuel) {
79 return myChargingPower;
80 } else {
81 // Convert from [Ws] to [Wh] (3600s / 1h):
82 return myChargingPower / 3600;
83 }
84}
85
86
87double
89 return myEfficiency;
90}
91
92
93bool
95 return myChargeInTransit;
96}
97
98
101 return myChargeDelay;
102}
103
104
105void
107 myChargingVehicle = value;
108}
109
110
111bool
112MSChargingStation::vehicleIsInside(const double position) const {
113 if ((position >= getBeginLanePosition()) && (position <= getEndLanePosition())) {
114 return true;
115 } else {
116 return false;
117 }
118}
119
120
121bool
123 return myChargingVehicle;
124}
125
126
127void
129 std::string status = "";
130 if (battery->getChargingStartTime() > myChargeDelay) {
131 if (battery->getHolder().getSpeed() < battery->getStoppingTreshold()) {
132 status = "chargingStopped";
133 } else if (myChargeInTransit == true) {
134 status = "chargingInTransit";
135 } else {
136 status = "noCharging";
137 }
138 } else {
139 if (myChargeInTransit == true) {
140 status = "waitingChargeInTransit";
141 } else if (battery->getHolder().getSpeed() < battery->getStoppingTreshold()) {
142 status = "waitingChargeStopped";
143 } else {
144 status = "noWaitingCharge";
145 }
146 }
147 // update total charge
148 myTotalCharge += WCharged;
149 // create charge row and insert it in myChargeValues
150 const std::string vehID = battery->getHolder().getID();
151 if (myChargeValues.count(vehID) == 0) {
152 myChargedVehicles.push_back(vehID);
153 }
154 Charge C(MSNet::getInstance()->getCurrentTimeStep(), vehID, battery->getHolder().getVehicleType().getID(),
155 status, WCharged, battery->getActualBatteryCapacity(), battery->getMaximumBatteryCapacity(),
157 myChargeValues[vehID].push_back(C);
158}
159
160
161void
163 int chargingSteps = 0;
164 for (const auto& item : myChargeValues) {
165 chargingSteps += (int)item.second.size();
166 }
168 output.writeAttr(SUMO_ATTR_ID, myID);
170 output.writeAttr(SUMO_ATTR_CHARGINGSTEPS, chargingSteps);
171 // start writting
172 if (myChargeValues.size() > 0) {
173 for (const std::string& vehID : myChargedVehicles) {
174 int iStart = 0;
175 const auto& chargeSteps = myChargeValues[vehID];
176 while (iStart < (int)chargeSteps.size()) {
177 int iEnd = iStart + 1;
178 double charged = chargeSteps[iStart].WCharged;
179 while (iEnd < (int)chargeSteps.size() && chargeSteps[iEnd].timeStep == chargeSteps[iEnd - 1].timeStep + DELTA_T) {
180 charged += chargeSteps[iEnd].WCharged;
181 iEnd++;
182 }
183 writeVehicle(output, chargeSteps, iStart, iEnd, charged);
184 iStart = iEnd;
185 }
186 }
187 }
188 // close charging station tag
189 output.closeTag();
190}
191
192void
193MSChargingStation::writeVehicle(OutputDevice& out, const std::vector<Charge>& chargeSteps, int iStart, int iEnd, double charged) {
194 const Charge& first = chargeSteps[iStart];
196 out.writeAttr(SUMO_ATTR_ID, first.vehicleID);
200 out.writeAttr(SUMO_ATTR_CHARGINGEND, time2string(chargeSteps[iEnd - 1].timeStep));
201 for (int i = iStart; i < iEnd; i++) {
202 const Charge& c = chargeSteps[i];
205 // charge values
209 // charging values of charging station in this timestep
212 // battery status of vehicle
215 // close tag timestep
216 out.closeTag();
217 }
218 out.closeTag();
219}
220
221
222/****************************************************************************/
long long int SUMOTime
Definition: GUI.h:36
#define WRITE_WARNING(msg)
Definition: MsgHandler.h:265
SUMOTime DELTA_T
Definition: SUMOTime.cpp:37
std::string time2string(SUMOTime t)
convert SUMOTime to string
Definition: SUMOTime.cpp:68
@ SUMO_TAG_CHARGING_STATION
A Charging Station.
@ SUMO_TAG_STEP
trigger: a step description
@ SUMO_TAG_VEHICLE
description of a vehicle
@ SUMO_ATTR_PARTIALCHARGE
energy provied by charging station at certain timestep
@ SUMO_ATTR_TOTALENERGYCHARGED
@ SUMO_ATTR_MAXIMUMBATTERYCAPACITY
Maxium battery capacity.
@ SUMO_ATTR_TOTALENERGYCHARGED_VEHICLE
total energy charged into a single vehicle
@ SUMO_ATTR_ACTUALBATTERYCAPACITY
@ SUMO_ATTR_ENERGYCHARGED
tgotal of Energy charged
@ SUMO_ATTR_CHARGINGPOWER
@ SUMO_ATTR_TYPE
@ SUMO_ATTR_CHARGINGSTEPS
number of steps that a vehicle is charging
@ SUMO_ATTR_CHARGINGEND
timesteps in which charging ends
@ SUMO_ATTR_EFFICIENCY
Eficiency of the charge in Charging Stations.
@ SUMO_ATTR_CHARGINGBEGIN
timestep in which charging begins
@ SUMO_ATTR_ID
@ SUMO_ATTR_CHARGEDELAY
Delay in the charge of charging stations.
@ SUMO_ATTR_TIME
trigger: the time of the step
@ SUMO_ATTR_CHARGING_STATUS
std::string toString(const T &t, std::streamsize accuracy=gPrecision)
Definition: ToString.h:46
double myChargingPower
Charging station's charging power.
void writeChargingStationOutput(OutputDevice &output)
write charging station values
double myTotalCharge
total energy charged by this charging station
static void writeVehicle(OutputDevice &out, const std::vector< Charge > &chargeSteps, int iStart, int iEnd, double charged)
double getChargingPower(bool usingFuel) const
Get charging station's charging power in the.
bool getChargeInTransit() const
Get chargeInTransit.
void setChargingVehicle(bool value)
enable or disable charging vehicle
std::vector< std::string > myChargedVehicles
order vehicles by time of first charge
double myEfficiency
Efficiency of the charging station.
MSChargingStation(const std::string &chargingStationID, MSLane &lane, double startPos, double endPos, const std::string &name, double chargingPower, double efficency, bool chargeInTransit, SUMOTime chargeDelay)
constructor
bool myChargeInTransit
Allow charge in transit.
bool vehicleIsInside(const double position) const
Check if a vehicle is inside in the Charge Station.
std::map< std::string, std::vector< Charge > > myChargeValues
map with the charges of this charging station (key = vehicleID)
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.
SUMOTime myChargeDelay
Charge Delay.
~MSChargingStation()
destructor
bool myChargingVehicle
Check if in the current TimeStep chargingStation is charging a vehicle.
bool isCharging() const
Return true if in the current time step charging station is charging a vehicle.
Battery device for electric vehicles.
SUMOTime getChargingStartTime() const
Get charging start time.
double getActualBatteryCapacity() const
Get the actual vehicle's Battery Capacity in Wh.
double getMaximumBatteryCapacity() const
Get the total vehicle's Battery Capacity in Wh.
double getStoppingTreshold() const
Get stopping treshold.
Representation of a lane in the micro simulation.
Definition: MSLane.h:84
static MSNet * getInstance()
Returns the pointer to the unique instance of MSNet (singleton).
Definition: MSNet.cpp:183
A lane area vehicles can halt at.
double getBeginLanePosition() const
Returns the begin position of this stop.
double getEndLanePosition() const
Returns the end position of this stop.
SUMOVehicle & getHolder() const
Returns the vehicle that holds this device.
const std::string & getID() const
Returns the name of the vehicle type.
Definition: MSVehicleType.h:91
std::string myID
The name of the object.
Definition: Named.h:125
const std::string & getID() const
Returns the id.
Definition: Named.h:74
Static storage of an output device and its base (abstract) implementation.
Definition: OutputDevice.h:61
OutputDevice & writeAttr(const SumoXMLAttr attr, const T &val)
writes a named attribute
Definition: OutputDevice.h:251
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.
virtual const MSVehicleType & getVehicleType() const =0
Returns the object's "vehicle" type.
virtual double getSpeed() const =0
Returns the object's current speed.
Definition: json.hpp:4471
struct to save information for the chargingStation output