LCOV - code coverage report
Current view: top level - src/router - ROVehicle.cpp (source / functions) Coverage Total Hit
Test: lcov.info Lines: 87.8 % 188 165
Test Date: 2026-03-02 16:00:03 Functions: 100.0 % 8 8

            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              : /****************************************************************************/
        

Generated by: LCOV version 2.0-1