Line data Source code
1 : /****************************************************************************/
2 : // Eclipse SUMO, Simulation of Urban MObility; see https://eclipse.dev/sumo
3 : // Copyright (C) 2002-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 ROVehicle.cpp
15 : /// @author Daniel Krajzewicz
16 : /// @author Axel Wegener
17 : /// @author Michael Behrisch
18 : /// @author Jakob Erdmann
19 : /// @date Sept 2002
20 : ///
21 : // A vehicle as used by router
22 : /****************************************************************************/
23 : #include <config.h>
24 :
25 : #include <string>
26 : #include <iostream>
27 : #include <utils/common/StringUtils.h>
28 : #include <utils/common/ToString.h>
29 : #include <utils/common/MsgHandler.h>
30 : #include <utils/geom/GeoConvHelper.h>
31 : #include <utils/vehicle/SUMOVTypeParameter.h>
32 : #include <utils/options/OptionsCont.h>
33 : #include <utils/iodevices/OutputDevice.h>
34 : #include "RORouteDef.h"
35 : #include "RORoute.h"
36 : #include "ROHelper.h"
37 : #include "RONet.h"
38 : #include "ROLane.h"
39 : #include "ROVehicle.h"
40 :
41 : #define INVALID_STOP_POS -1
42 :
43 : // ===========================================================================
44 : // static members
45 : // ===========================================================================
46 : std::map<ConstROEdgeVector, std::string> ROVehicle::mySavedRoutes;
47 :
48 : // ===========================================================================
49 : // method definitions
50 : // ===========================================================================
51 297937 : ROVehicle::ROVehicle(const SUMOVehicleParameter& pars,
52 : RORouteDef* route, const SUMOVTypeParameter* type,
53 297937 : const RONet* net, MsgHandler* errorHandler):
54 : RORoutable(pars, type),
55 297937 : myRoute(route),
56 297937 : myJumpTime(-1) {
57 : getParameter().stops.clear();
58 594949 : if (route != nullptr && route->getFirstRoute() != nullptr) {
59 594348 : for (StopParVector::const_iterator s = route->getFirstRoute()->getStops().begin(); s != route->getFirstRoute()->getStops().end(); ++s) {
60 324 : addStop(*s, net, errorHandler);
61 : }
62 : }
63 298457 : for (StopParVector::const_iterator s = pars.stops.begin(); s != pars.stops.end(); ++s) {
64 520 : addStop(*s, net, errorHandler);
65 : }
66 297937 : }
67 :
68 :
69 : void
70 844 : ROVehicle::addStop(const SUMOVehicleParameter::Stop& stopPar, const RONet* net, MsgHandler* errorHandler) {
71 844 : const ROEdge* stopEdge = net->getEdge(stopPar.edge);
72 : assert(stopEdge != 0); // was checked when parsing the stop
73 844 : if (stopEdge->prohibits(this)) {
74 0 : if (errorHandler != nullptr) {
75 0 : errorHandler->inform("Stop edge '" + stopEdge->getID() + "' does not allow vehicle '" + getID() + "'.");
76 : }
77 : return;
78 : }
79 : // where to insert the stop
80 : StopParVector::iterator iter = getParameter().stops.begin();
81 844 : if (stopPar.index == STOP_INDEX_END || stopPar.index >= static_cast<int>(getParameter().stops.size())) {
82 : if (getParameter().stops.size() > 0) {
83 : iter = getParameter().stops.end();
84 : }
85 : } else {
86 0 : if (stopPar.index == STOP_INDEX_FIT) {
87 : iter = getParameter().stops.end();
88 : } else {
89 : iter += stopPar.index;
90 : }
91 : }
92 844 : getParameter().stops.insert(iter, stopPar);
93 844 : if (stopPar.jump >= 0) {
94 24 : if (stopEdge->isInternal()) {
95 0 : if (errorHandler != nullptr) {
96 0 : errorHandler->inform("Jumps are not supported from internal stop edge '" + stopEdge->getID() + "'.");
97 : }
98 : } else {
99 24 : if (myJumpTime < 0) {
100 20 : myJumpTime = 0;
101 : }
102 24 : myJumpTime += stopPar.jump;
103 : }
104 : }
105 : }
106 :
107 :
108 595781 : ROVehicle::~ROVehicle() {}
109 :
110 :
111 : const ROEdge*
112 511 : ROVehicle:: getDepartEdge() const {
113 511 : return myRoute->getFirstRoute()->getFirst();
114 : }
115 :
116 :
117 : void
118 296784 : ROVehicle::computeRoute(const RORouterProvider& provider,
119 : const bool removeLoops, MsgHandler* errorHandler) {
120 : SUMOAbstractRouter<ROEdge, ROVehicle>& router = provider.getVehicleRouter(getVClass());
121 593568 : std::string noRouteMsg = "The vehicle '" + getID() + "' has no valid route.";
122 : RORouteDef* const routeDef = getRouteDefinition();
123 : // check if the route definition is valid
124 296784 : if (routeDef == nullptr) {
125 0 : errorHandler->inform(noRouteMsg);
126 0 : myRoutingSuccess = false;
127 0 : return;
128 : }
129 296784 : routeDef->validateAlternatives(this, errorHandler);
130 296781 : if (routeDef->getFirstRoute() == nullptr) {
131 : // everything is invalid and no new routes will be computed
132 3 : myRoutingSuccess = false;
133 3 : return;
134 : }
135 296781 : RORoute* current = routeDef->buildCurrentRoute(router, getDepartureTime(), *this);
136 296781 : if (current == nullptr || current->size() == 0) {
137 19119 : delete current;
138 1925 : if (current == nullptr || !routeDef->discardSilent()) {
139 51582 : errorHandler->inform(noRouteMsg);
140 : }
141 19119 : myRoutingSuccess = false;
142 19119 : return;
143 : }
144 : // check whether we have to evaluate the route for not containing loops
145 277662 : if (removeLoops) {
146 5220 : const ROEdge* requiredStart = (getParameter().departPosProcedure == DepartPosDefinition::GIVEN
147 5220 : || getParameter().departLaneProcedure == DepartLaneDefinition::GIVEN ? current->getEdgeVector().front() : 0);
148 5220 : const ROEdge* requiredEnd = (getParameter().arrivalPosProcedure == ArrivalPosDefinition::GIVEN
149 5220 : || getParameter().arrivalLaneProcedure == ArrivalLaneDefinition::GIVEN ? current->getEdgeVector().back() : 0);
150 : ConstROEdgeVector mandatory;
151 5248 : for (auto m : getMandatoryEdges(requiredStart, requiredEnd)) {
152 28 : mandatory.push_back(m.edge);
153 5220 : }
154 5220 : current->recheckForLoops(mandatory);
155 : // check whether the route is still valid
156 5220 : if (current->size() == 0) {
157 0 : delete current;
158 0 : errorHandler->inform(noRouteMsg + " (after removing loops)");
159 0 : myRoutingSuccess = false;
160 : return;
161 : }
162 5220 : }
163 277662 : if (RONet::getInstance()->getMaxTraveltime() > 0) {
164 12 : double costs = router.recomputeCosts(current->getEdgeVector(), this, getDepartureTime());
165 12 : if (costs > RONet::getInstance()->getMaxTraveltime()) {
166 40 : errorHandler->inform(noRouteMsg + " (traveltime " + time2string(TIME2STEPS(costs)) + " exceeds max-traveltime)");
167 8 : delete current;
168 8 : myRoutingSuccess = false;
169 8 : return;
170 : }
171 : }
172 : // add built route
173 277654 : routeDef->addAlternative(router, this, current, getDepartureTime(), errorHandler);
174 277638 : myRoutingSuccess = true;
175 : }
176 :
177 :
178 : std::vector<ROVehicle::Mandatory>
179 294579 : ROVehicle::getMandatoryEdges(const ROEdge* requiredStart, const ROEdge* requiredEnd) const {
180 294579 : const RONet* net = RONet::getInstance();
181 : std::vector<Mandatory> mandatory;
182 294579 : if (requiredStart) {
183 : double departPos = 0;
184 289367 : if (getParameter().departPosProcedure == DepartPosDefinition::GIVEN) {
185 705 : departPos = SUMOVehicleParameter::interpretEdgePos(getParameter().departPos, requiredStart->getLength(), SUMO_ATTR_DEPARTPOS, "vehicle '" + getID() + "'");
186 : }
187 289367 : mandatory.push_back(Mandatory(requiredStart, departPos));
188 : }
189 294579 : if (getParameter().via.size() != 0) {
190 : // via takes precedence over stop edges
191 48297 : for (const std::string& via : getParameter().via) {
192 33624 : mandatory.push_back(Mandatory(net->getEdge(via), INVALID_STOP_POS));
193 : }
194 : } else {
195 280606 : for (const auto& stop : getParameter().stops) {
196 700 : const ROEdge* e = net->getEdge(stop.edge);
197 700 : if (e->isInternal()) {
198 : // the edges before and after the internal edge are mandatory
199 8 : const ROEdge* before = e->getNormalBefore();
200 8 : const ROEdge* after = e->getNormalAfter();
201 8 : mandatory.push_back(Mandatory(before, INVALID_STOP_POS));
202 8 : mandatory.push_back(Mandatory(after, INVALID_STOP_POS, stop.jump));
203 : } else {
204 1384 : double endPos = SUMOVehicleParameter::interpretEdgePos(stop.endPos, e->getLength(), SUMO_ATTR_ENDPOS, "stop of vehicle '" + getID() + "' on edge '" + e->getID() + "'");
205 692 : mandatory.push_back(Mandatory(e, endPos, stop.jump));
206 : }
207 : }
208 : }
209 294579 : if (requiredEnd) {
210 : double arrivalPos = INVALID_STOP_POS;
211 289367 : if (getParameter().arrivalPosProcedure == ArrivalPosDefinition::GIVEN) {
212 414 : arrivalPos = SUMOVehicleParameter::interpretEdgePos(getParameter().arrivalPos, requiredEnd->getLength(), SUMO_ATTR_ARRIVALPOS, "vehicle '" + getID() + "'");
213 : }
214 289367 : mandatory.push_back(Mandatory(requiredEnd, arrivalPos));
215 : }
216 294579 : return mandatory;
217 0 : }
218 :
219 :
220 : void
221 390783 : ROVehicle::saveAsXML(OutputDevice& os, OutputDevice* const typeos, bool asAlternatives, OptionsCont& options, int cloneIndex) const {
222 390783 : if (typeos != nullptr && getType() != nullptr && !getType()->saved) {
223 378 : getType()->write(*typeos);
224 378 : getType()->saved = true;
225 : }
226 390783 : if (getType() != nullptr && !getType()->saved) {
227 4092 : getType()->write(os);
228 4092 : getType()->saved = asAlternatives;
229 : }
230 :
231 777300 : const bool writeTrip = options.exists("write-trips") && options.getBool("write-trips");
232 390783 : const bool writeGeoTrip = writeTrip && options.getBool("write-trips.geo");
233 390783 : const bool writeJunctions = writeTrip && options.getBool("write-trips.junctions");
234 390783 : const bool writeNamedRoute = !asAlternatives && options.getBool("named-routes");
235 777300 : const bool writeCosts = options.exists("write-costs") && options.getBool("write-costs");
236 781566 : const bool writeExit = options.exists("exit-times") && options.getBool("exit-times");
237 777300 : const bool writeLength = options.exists("route-length") && options.getBool("route-length");
238 777300 : const bool writeFlow = options.exists("keep-flows") && options.getBool("keep-flows") && isPartOfFlow();
239 :
240 : std::string routeID;
241 390783 : if (writeNamedRoute) {
242 21 : ConstROEdgeVector edges = myRoute->getUsedRoute()->getNormalEdges();
243 : auto it = mySavedRoutes.find(edges);
244 21 : if (it == mySavedRoutes.end()) {
245 14 : routeID = "r" + toString(mySavedRoutes.size());
246 7 : myRoute->getUsedRoute()->writeXMLDefinition(os, this, writeCosts, false, writeExit,
247 : writeLength, routeID);
248 7 : mySavedRoutes[edges] = routeID;
249 : } else {
250 14 : routeID = it->second;
251 : }
252 21 : }
253 390783 : const SumoXMLTag tag = writeFlow ? SUMO_TAG_FLOW : (writeTrip ? SUMO_TAG_TRIP : SUMO_TAG_VEHICLE);
254 : // write the vehicle (new style, with included routes)
255 390783 : if (cloneIndex == 0) {
256 781326 : getParameter().write(os, options, tag);
257 : } else {
258 120 : SUMOVehicleParameter p = getParameter();
259 : // @note id collisions may occur if scale-suffic occurs in other vehicle ids
260 240 : p.id += options.getString("scale-suffix") + toString(cloneIndex);
261 120 : p.write(os, options, tag);
262 120 : }
263 : // save the route
264 390783 : if (writeTrip) {
265 158656 : const ConstROEdgeVector edges = myRoute->getFirstRoute()->getEdgeVector();
266 : const ROEdge* from = nullptr;
267 : const ROEdge* to = nullptr;
268 79328 : if (edges.size() > 0) {
269 79328 : if (edges.front()->isTazConnector()) {
270 7284 : if (edges.size() > 1) {
271 7284 : from = edges[1];
272 7284 : if (from->isTazConnector() && writeJunctions && edges.front()->getSuccessors().size() > 0) {
273 : // routing was skipped
274 8 : from = edges.front()->getSuccessors(getVClass()).front();
275 : }
276 : }
277 : } else {
278 : from = edges[0];
279 : }
280 79328 : if (edges.back()->isTazConnector()) {
281 7284 : if (edges.size() > 1) {
282 7284 : to = edges[edges.size() - 2];
283 7284 : if (to->isTazConnector() && writeJunctions && edges.back()->getPredecessors().size() > 0) {
284 : // routing was skipped
285 4 : to = edges.back()->getPredecessors().front();
286 : }
287 : }
288 : } else {
289 72044 : to = edges[edges.size() - 1];
290 : }
291 : }
292 79328 : if (from != nullptr) {
293 79328 : if (writeGeoTrip) {
294 16 : Position fromPos = from->getLanes()[0]->getShape().positionAtOffset2D(0);
295 16 : if (GeoConvHelper::getFinal().usingGeoProjection()) {
296 0 : os.setPrecision(gPrecisionGeo);
297 0 : GeoConvHelper::getFinal().cartesian2geo(fromPos);
298 0 : os.writeAttr(SUMO_ATTR_FROMLONLAT, fromPos);
299 0 : os.setPrecision(gPrecision);
300 : } else {
301 16 : os.writeAttr(SUMO_ATTR_FROMXY, fromPos);
302 : }
303 79312 : } else if (writeJunctions) {
304 7244 : os.writeAttr(SUMO_ATTR_FROM_JUNCTION, from->getFromJunction()->getID());
305 : } else {
306 72068 : os.writeAttr(SUMO_ATTR_FROM, from->getID());
307 : }
308 : }
309 79328 : if (to != nullptr) {
310 79328 : if (writeGeoTrip) {
311 16 : Position toPos = to->getLanes()[0]->getShape().positionAtOffset2D(to->getLanes()[0]->getShape().length2D());
312 16 : if (GeoConvHelper::getFinal().usingGeoProjection()) {
313 0 : os.setPrecision(gPrecisionGeo);
314 0 : GeoConvHelper::getFinal().cartesian2geo(toPos);
315 0 : os.writeAttr(SUMO_ATTR_TOLONLAT, toPos);
316 0 : os.setPrecision(gPrecision);
317 : } else {
318 16 : os.writeAttr(SUMO_ATTR_TOXY, toPos);
319 : }
320 79312 : } else if (writeJunctions) {
321 7244 : os.writeAttr(SUMO_ATTR_TO_JUNCTION, to->getToJunction()->getID());
322 : } else {
323 72068 : os.writeAttr(SUMO_ATTR_TO, to->getID());
324 : }
325 : }
326 79328 : if (getParameter().via.size() > 0) {
327 : std::vector<std::string> viaOut;
328 : SumoXMLAttr viaAttr = (writeGeoTrip
329 7236 : ? (GeoConvHelper::getFinal().usingGeoProjection() ? SUMO_ATTR_VIALONLAT : SUMO_ATTR_VIAXY)
330 7228 : : (writeJunctions ? SUMO_ATTR_VIAJUNCTIONS : SUMO_ATTR_VIA));
331 21672 : for (const std::string& viaID : getParameter().via) {
332 14436 : const ROEdge* viaEdge = RONet::getInstance()->getEdge(viaID);
333 14436 : if (viaEdge->isTazConnector()) {
334 20 : if (viaEdge->getPredecessors().size() == 0) {
335 0 : continue;
336 : }
337 : // XXX used edge that was used in route
338 20 : viaEdge = viaEdge->getPredecessors().front();
339 : }
340 : assert(viaEdge != nullptr);
341 14436 : if (writeGeoTrip) {
342 8 : Position viaPos = viaEdge->getLanes()[0]->getShape().positionAtOffset2D(viaEdge->getLanes()[0]->getShape().length2D() / 2);
343 8 : if (GeoConvHelper::getFinal().usingGeoProjection()) {
344 0 : GeoConvHelper::getFinal().cartesian2geo(viaPos);
345 0 : viaOut.push_back(toString(viaPos, gPrecisionGeo));
346 : } else {
347 16 : viaOut.push_back(toString(viaPos, gPrecision));
348 : }
349 14428 : } else if (writeJunctions) {
350 8 : viaOut.push_back(viaEdge->getToJunction()->getID());
351 : } else {
352 14420 : viaOut.push_back(viaEdge->getID());
353 : }
354 : }
355 7236 : os.writeAttr(viaAttr, viaOut);
356 7236 : }
357 390783 : } else if (writeNamedRoute) {
358 21 : os.writeAttr(SUMO_ATTR_ROUTE, routeID);
359 : } else {
360 311434 : myRoute->writeXMLDefinition(os, this, asAlternatives, writeExit, writeCosts, writeLength);
361 : }
362 392155 : for (StopParVector::const_iterator stop = getParameter().stops.begin(); stop != getParameter().stops.end(); ++stop) {
363 1372 : stop->write(os);
364 : }
365 390783 : getParameter().writeParams(os);
366 781566 : os.closeTag();
367 390783 : }
368 :
369 :
370 : /****************************************************************************/
|