Line data Source code
1 : /****************************************************************************/
2 : // Eclipse SUMO, Simulation of Urban MObility; see https://eclipse.dev/sumo
3 : // Copyright (C) 2012-2026 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 : /****************************************************************************/
14 : /// @file Vehicle.h
15 : /// @author Michael Behrisch
16 : /// @author Jakob Erdmann
17 : /// @date 15.03.2017
18 : ///
19 : // C++ Vehicle API
20 : /****************************************************************************/
21 : #pragma once
22 : #include <limits>
23 : #include <vector>
24 : #include <libsumo/TraCIDefs.h>
25 : #include <libsumo/VehicleType.h>
26 : #include <libsumo/TraCIConstants.h>
27 :
28 :
29 : // ===========================================================================
30 : // class declarations
31 : // ===========================================================================
32 : #ifndef LIBTRACI
33 : class PositionVector;
34 : class SUMOVehicle;
35 : #endif
36 :
37 :
38 : // ===========================================================================
39 : // class definitions
40 : // ===========================================================================
41 : /**
42 : * @class Vehicle
43 : * @brief C++ TraCI client API implementation
44 : */
45 : namespace LIBSUMO_NAMESPACE {
46 : class Vehicle {
47 : public:
48 : /// @name Value retrieval
49 : /// @{
50 : static double getSpeed(const std::string& vehID);
51 : static double getLateralSpeed(const std::string& vehID);
52 : static double getAcceleration(const std::string& vehID);
53 : static double getSpeedWithoutTraCI(const std::string& vehID);
54 : static libsumo::TraCIPosition getPosition(const std::string& vehID, const bool includeZ = false);
55 : static libsumo::TraCIPosition getPosition3D(const std::string& vehID);
56 : static double getAngle(const std::string& vehID);
57 : static double getSlope(const std::string& vehID);
58 : static std::string getRoadID(const std::string& vehID);
59 : static std::string getLaneID(const std::string& vehID);
60 : static std::string getShadowLaneID(const std::string& vehID);
61 : static int getLaneIndex(const std::string& vehID);
62 : static std::string getSegmentID(const std::string& vehID);
63 : static int getSegmentIndex(const std::string& vehID);
64 : static std::string getTypeID(const std::string& vehID);
65 : static std::string getRouteID(const std::string& vehID);
66 : static double getDeparture(const std::string& vehID);
67 : static double getDepartDelay(const std::string& vehID);
68 : static int getRouteIndex(const std::string& vehID);
69 : static double getLanePosition(const std::string& vehID);
70 : static double getLateralLanePosition(const std::string& vehID);
71 : static double getCO2Emission(const std::string& vehID);
72 : static double getCOEmission(const std::string& vehID);
73 : static double getHCEmission(const std::string& vehID);
74 : static double getPMxEmission(const std::string& vehID);
75 : static double getNOxEmission(const std::string& vehID);
76 : static double getFuelConsumption(const std::string& vehID);
77 : static double getNoiseEmission(const std::string& vehID);
78 : static double getElectricityConsumption(const std::string& vehID);
79 : static int getPersonNumber(const std::string& vehID);
80 : static std::vector<std::string> getPersonIDList(const std::string& vehID);
81 : static std::pair<std::string, double> getLeader(const std::string& vehID, double dist = 100.);
82 : static std::pair<std::string, double> getFollower(const std::string& vehID, double dist = 0.);
83 : static std::vector<libsumo::TraCIJunctionFoe> getJunctionFoes(const std::string& vehID, double dist = 0.);
84 : static double getWaitingTime(const std::string& vehID);
85 : static double getAccumulatedWaitingTime(const std::string& vehID);
86 : static double getAdaptedTraveltime(const std::string& vehID, double time, const std::string& edgeID);
87 : static double getEffort(const std::string& vehID, double time, const std::string& edgeID);
88 : static bool isRouteValid(const std::string& vehID);
89 : static std::vector<std::string> getRoute(const std::string& vehID);
90 : static int getSignals(const std::string& vehID);
91 : static std::vector<libsumo::TraCIBestLanesData> getBestLanes(const std::string& vehID);
92 : static std::vector<libsumo::TraCINextTLSData> getNextTLS(const std::string& vehID);
93 : static std::vector<libsumo::TraCINextStopData> getNextStops(const std::string& vehID);
94 : static std::vector<libsumo::TraCIConnection> getNextLinks(const std::string& vehID);
95 : static std::vector<libsumo::TraCINextStopData> getStops(const std::string& vehID, int limit = 0);
96 : static int getStopState(const std::string& vehID);
97 : static std::string getStopParameter(const std::string& vehID, int nextStopIndex, const std::string& param, bool customParam = false);
98 :
99 : static double getDistance(const std::string& vehID);
100 : static double getDrivingDistance(const std::string& vehID, const std::string& edgeID, double pos, int laneIndex = 0);
101 : static double getDrivingDistance2D(const std::string& vehID, double x, double y);
102 : static double getReferenceDistance(const std::string& vehID);
103 : static double getAllowedSpeed(const std::string& vehID);
104 : static int getSpeedMode(const std::string& vehID);
105 : static int getLaneChangeMode(const std::string& vehID);
106 : static int getRoutingMode(const std::string& vehID);
107 : static std::string getLine(const std::string& vehID);
108 : static std::vector<std::string> getVia(const std::string& vehID);
109 : static std::pair<int, int> getLaneChangeState(const std::string& vehID, int direction);
110 : static double getLastActionTime(const std::string& vehID);
111 : static std::vector<std::pair<std::string, double> > getNeighbors(const std::string& vehID, const int mode);
112 : static double getFollowSpeed(const std::string& vehID, double speed, double gap, double leaderSpeed, double leaderMaxDecel, const std::string& leaderID = "");
113 : static double getSecureGap(const std::string& vehID, double speed, double leaderSpeed, double leaderMaxDecel, const std::string& leaderID = "");
114 : static double getStopSpeed(const std::string& vehID, double speed, double gap);
115 : static double getStopDelay(const std::string& vehID);
116 : static double getStopArrivalDelay(const std::string& vehID);
117 : static double getTimeLoss(const std::string& vehID);
118 : static std::vector<std::string> getTaxiFleet(int taxiState = 0);
119 :
120 : static std::vector<std::string> getLoadedIDList();
121 : static std::vector<std::string> getTeleportingIDList();
122 : /// @}
123 :
124 : LIBSUMO_ID_PARAMETER_API
125 : LIBSUMO_VEHICLE_TYPE_GETTER
126 :
127 : /// @name State Changing
128 : /// @{
129 :
130 : static void setStop(const std::string& vehID,
131 : const std::string& edgeID,
132 : double pos = 1.,
133 : int laneIndex = 0,
134 : double duration = libsumo::INVALID_DOUBLE_VALUE,
135 : int flags = libsumo::STOP_DEFAULT,
136 : double startPos = libsumo::INVALID_DOUBLE_VALUE,
137 : double until = libsumo::INVALID_DOUBLE_VALUE);
138 :
139 : static void replaceStop(const std::string& vehID,
140 : int nextStopIndex,
141 : const std::string& edgeID,
142 : double pos = 1.,
143 : int laneIndex = 0,
144 : double duration = libsumo::INVALID_DOUBLE_VALUE,
145 : int flags = libsumo::STOP_DEFAULT,
146 : double startPos = libsumo::INVALID_DOUBLE_VALUE,
147 : double until = libsumo::INVALID_DOUBLE_VALUE,
148 : int teleport = 0);
149 :
150 : static void insertStop(const std::string& vehID,
151 : int nextStopIndex,
152 : const std::string& edgeID,
153 : double pos = 1.,
154 : int laneIndex = 0,
155 : double duration = libsumo::INVALID_DOUBLE_VALUE,
156 : int flags = libsumo::STOP_DEFAULT,
157 : double startPos = libsumo::INVALID_DOUBLE_VALUE,
158 : double until = libsumo::INVALID_DOUBLE_VALUE,
159 : int teleport = 0);
160 :
161 : static void setStopParameter(const std::string& vehID, int nextStopIndex,
162 : const std::string& param, const std::string& value,
163 : bool customParam = false);
164 :
165 : static void rerouteParkingArea(const std::string& vehID,
166 : const std::string& parkingAreaID);
167 :
168 : static void resume(const std::string& vehID);
169 :
170 : static void add(const std::string& vehID,
171 : const std::string& routeID,
172 : const std::string& typeID = "DEFAULT_VEHTYPE",
173 : const std::string& depart = "now",
174 : const std::string& departLane = "first",
175 : const std::string& departPos = "base",
176 : const std::string& departSpeed = "0",
177 : const std::string& arrivalLane = "current",
178 : const std::string& arrivalPos = "max",
179 : const std::string& arrivalSpeed = "current",
180 : const std::string& fromTaz = "",
181 : const std::string& toTaz = "",
182 : const std::string& line = "",
183 : int personCapacity = 4,
184 : int personNumber = 0);
185 :
186 : static void changeTarget(const std::string& vehID, const std::string& edgeID);
187 : static void changeLane(const std::string& vehID, int laneIndex, double duration);
188 : static void changeLaneRelative(const std::string& vehID, int indexOffset, double duration);
189 : static void changeSublane(const std::string& vehID, double latDist);
190 :
191 : static void slowDown(const std::string& vehID, double speed, double duration);
192 : static void openGap(const std::string& vehID, double newTimeHeadway, double newSpaceHeadway, double duration, double changeRate, double maxDecel = -1, const std::string& referenceVehID = "");
193 : static void deactivateGapControl(const std::string& vehID);
194 : static void requestToC(const std::string& vehID, double leadTime);
195 : static void setSpeed(const std::string& vehID, double speed);
196 : static void setAcceleration(const std::string& vehID, double acceleration, double duration);
197 : static void setPreviousSpeed(const std::string& vehID, double prevSpeed, double prevAcceleration = libsumo::INVALID_DOUBLE_VALUE);
198 : static void setSpeedMode(const std::string& vehID, int speedMode);
199 : static void setLaneChangeMode(const std::string& vehID, int laneChangeMode);
200 : static void setRoutingMode(const std::string& vehID, int routingMode);
201 : static void setType(const std::string& vehID, const std::string& typeID);
202 : static void setRouteID(const std::string& vehID, const std::string& routeID);
203 : static void setRoute(const std::string& vehID, const std::string& edgeID);
204 : static void setRoute(const std::string& vehID, const std::vector<std::string>& edgeIDs);
205 : static void setLateralLanePosition(const std::string& vehID, double posLat);
206 : static void updateBestLanes(const std::string& vehID);
207 : static void setAdaptedTraveltime(const std::string& vehID, const std::string& edgeID,
208 : double time = libsumo::INVALID_DOUBLE_VALUE, double begSeconds = 0, double endSeconds = std::numeric_limits<double>::max());
209 : static void setEffort(const std::string& vehID, const std::string& edgeID,
210 : double effort = libsumo::INVALID_DOUBLE_VALUE, double begSeconds = 0, double endSeconds = std::numeric_limits<double>::max());
211 : static void rerouteTraveltime(const std::string& vehID, const bool currentTravelTimes = true);
212 : static void rerouteEffort(const std::string& vehID);
213 : static void setSignals(const std::string& vehID, int signals);
214 : static void moveTo(const std::string& vehID, const std::string& laneID, double pos, int reason = libsumo::MOVE_AUTOMATIC);
215 : static void moveToXY(const std::string& vehID, const std::string& edgeID, const int laneIndex, const double x, const double y, double angle = libsumo::INVALID_DOUBLE_VALUE, const int keepRoute = 1, double matchThreshold = 100);
216 : static void remove(const std::string& vehID, char reason = libsumo::REMOVE_VAPORIZED);
217 : static void setLine(const std::string& vehID, const std::string& line);
218 : static void setVia(const std::string& vehID, const std::vector<std::string>& edgeList);
219 : static void highlight(const std::string& vehID, const libsumo::TraCIColor& col = libsumo::TraCIColor(255, 0, 0, 255), double size = -1, const int alphaMax = -1, const double duration = -1, const int type = 0);
220 : static void dispatchTaxi(const std::string& vehID, const std::vector<std::string>& reservations);
221 : /// @}
222 :
223 : LIBSUMO_VEHICLE_TYPE_SETTER
224 :
225 3 : LIBSUMO_SUBSCRIPTION_API
226 :
227 : static void subscribeLeader(const std::string& vehID, double dist = 0., double begin = libsumo::INVALID_DOUBLE_VALUE, double end = libsumo::INVALID_DOUBLE_VALUE);
228 :
229 : static void addSubscriptionFilterLanes(const std::vector<int>& lanes, bool noOpposite = false, double downstreamDist = libsumo::INVALID_DOUBLE_VALUE, double upstreamDist = libsumo::INVALID_DOUBLE_VALUE);
230 :
231 : static void addSubscriptionFilterNoOpposite();
232 :
233 : static void addSubscriptionFilterDownstreamDistance(double dist);
234 :
235 : static void addSubscriptionFilterUpstreamDistance(double dist);
236 :
237 : static void addSubscriptionFilterCFManeuver(double downstreamDist = libsumo::INVALID_DOUBLE_VALUE, double upstreamDist = libsumo::INVALID_DOUBLE_VALUE);
238 :
239 : static void addSubscriptionFilterLCManeuver(int direction = libsumo::INVALID_INT_VALUE, bool noOpposite = false, double downstreamDist = libsumo::INVALID_DOUBLE_VALUE, double upstreamDist = libsumo::INVALID_DOUBLE_VALUE);
240 :
241 : static void addSubscriptionFilterLeadFollow(const std::vector<int>& lanes);
242 :
243 : static void addSubscriptionFilterTurn(double downstreamDist = libsumo::INVALID_DOUBLE_VALUE, double foeDistToJunction = libsumo::INVALID_DOUBLE_VALUE);
244 :
245 : static void addSubscriptionFilterVClass(const std::vector<std::string>& vClasses);
246 :
247 : static void addSubscriptionFilterVType(const std::vector<std::string>& vTypes);
248 :
249 : static void addSubscriptionFilterFieldOfVision(double openingAngle);
250 :
251 : static void addSubscriptionFilterLateralDistance(double lateralDist, double downstreamDist = libsumo::INVALID_DOUBLE_VALUE, double upstreamDist = libsumo::INVALID_DOUBLE_VALUE);
252 :
253 : #ifndef LIBTRACI
254 : #ifndef SWIG
255 : /** @brief Saves the shape of the requested object in the given container
256 : * @param id The id of the poi to retrieve
257 : * @param shape The container to fill
258 : */
259 : static void storeShape(const std::string& id, PositionVector& shape);
260 :
261 : static std::shared_ptr<VariableWrapper> makeWrapper();
262 :
263 : static bool handleVariable(const std::string& objID, const int variable, VariableWrapper* wrapper, tcpip::Storage* paramData);
264 :
265 :
266 : private:
267 : static bool isVisible(const SUMOVehicle* veh);
268 :
269 : static bool isOnInit(const std::string& vehID);
270 :
271 : private:
272 : static SubscriptionResults mySubscriptionResults;
273 : static ContextSubscriptionResults myContextSubscriptionResults;
274 : #endif
275 : #endif
276 :
277 : /// @brief invalidated standard constructor
278 : Vehicle() = delete;
279 : };
280 :
281 :
282 : }
|