Eclipse SUMO - Simulation of Urban MObility
duarouter_main.cpp
Go to the documentation of this file.
1 /****************************************************************************/
2 // Eclipse SUMO, Simulation of Urban MObility; see https://eclipse.dev/sumo
3 // Copyright (C) 2001-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 // Main for DUAROUTER
21 /****************************************************************************/
22 #include <config.h>
23 
24 #ifdef HAVE_VERSION_H
25 #include <version.h>
26 #endif
27 
28 #include <iostream>
29 #include <string>
30 #include <limits.h>
31 #include <ctime>
32 #include <memory>
33 #include <xercesc/sax/SAXException.hpp>
34 #include <xercesc/sax/SAXParseException.hpp>
40 #include <utils/common/ToString.h>
41 #ifdef HAVE_FOX
43 #endif
45 #include <utils/options/Option.h>
50 #include <utils/router/CHRouter.h>
53 #include <utils/xml/XMLSubSys.h>
54 #include <router/ROFrame.h>
55 #include <router/ROLoader.h>
56 #include <router/RONet.h>
57 #include <router/ROEdge.h>
58 #include "RODUAEdgeBuilder.h"
59 #include "RODUAFrame.h"
60 
61 
62 // ===========================================================================
63 // functions
64 // ===========================================================================
65 /* -------------------------------------------------------------------------
66  * data processing methods
67  * ----------------------------------------------------------------------- */
73 void
74 initNet(RONet& net, ROLoader& loader, OptionsCont& oc) {
75  // load the net
76  RODUAEdgeBuilder builder;
77  ROEdge::setGlobalOptions(oc.getBool("weights.interpolate"));
78  loader.loadNet(net, builder);
79  // load the weights when wished/available
80  if (oc.isSet("weight-files")) {
81  loader.loadWeights(net, "weight-files", oc.getString("weight-attribute"), false, oc.getBool("weights.expand"));
82  }
83  if (oc.isSet("lane-weight-files")) {
84  loader.loadWeights(net, "lane-weight-files", oc.getString("weight-attribute"), true, oc.getBool("weights.expand"));
85  }
86 }
87 
88 
92 void
93 computeRoutes(RONet& net, ROLoader& loader, OptionsCont& oc) {
94  // initialise the loader
95  loader.openRoutes(net);
96  // build the router
99  const std::string measure = oc.getString("weight-attribute");
100  const std::string routingAlgorithm = oc.getString("routing-algorithm");
101  const double priorityFactor = oc.getFloat("weights.priority-factor");
102  const SUMOTime begin = string2time(oc.getString("begin"));
103  const SUMOTime end = oc.isDefault("end") ? SUMOTime_MAX : string2time(oc.getString("end"));
105 
106  if (oc.isSet("restriction-params") &&
107  (routingAlgorithm == "CH" || routingAlgorithm == "CHWrapper")) {
108  throw ProcessError(TLF("Routing algorithm '%' does not support restriction-params", routingAlgorithm));
109  }
110 
111  if (measure == "traveltime" && priorityFactor == 0) {
112  if (routingAlgorithm == "dijkstra") {
113  router = new DijkstraRouter<ROEdge, ROVehicle>(ROEdge::getAllEdges(), oc.getBool("ignore-errors"), ttFunction, nullptr, false, nullptr, net.hasPermissions(), oc.isSet("restriction-params"));
114  } else if (routingAlgorithm == "astar") {
115  typedef AStarRouter<ROEdge, ROVehicle> AStar;
116  std::shared_ptr<const AStar::LookupTable> lookup;
117  if (oc.isSet("astar.all-distances")) {
118  lookup = std::make_shared<const AStar::FLT>(oc.getString("astar.all-distances"), (int)ROEdge::getAllEdges().size());
119  } else if (oc.isSet("astar.landmark-distances")) {
120  /* CHRouterWrapper<ROEdge, ROVehicle> chrouter(
121  ROEdge::getAllEdges(), true, &ROEdge::getTravelTimeStatic,
122  begin, end, SUMOTime_MAX, 1); */
124  std::vector<ReversedEdge<ROEdge, ROVehicle>*> reversed;
125  for (ROEdge* edge : ROEdge::getAllEdges()) {
126  reversed.push_back(edge->getReversedRoutingEdge());
127  }
128  for (ReversedEdge<ROEdge, ROVehicle>* redge : reversed) {
129  redge->init();
130  }
132  ROVehicle defaultVehicle(SUMOVehicleParameter(), nullptr, net.getVehicleTypeSecure(DEFAULT_VTYPE_ID), &net);
133  lookup = std::make_shared<const AStar::LMLT>(oc.getString("astar.landmark-distances"), ROEdge::getAllEdges(), &forward, &backward, &defaultVehicle,
134  oc.isSet("astar.save-landmark-distances") ? oc.getString("astar.save-landmark-distances") : "", oc.getInt("routing-threads"));
135  }
136  router = new AStar(ROEdge::getAllEdges(), oc.getBool("ignore-errors"), ttFunction, lookup, net.hasPermissions(), oc.isSet("restriction-params"));
137  } else if (routingAlgorithm == "CH" && !net.hasPermissions()) {
138  const SUMOTime weightPeriod = (oc.isSet("weight-files") ?
139  string2time(oc.getString("weight-period")) :
140  SUMOTime_MAX);
141  router = new CHRouter<ROEdge, ROVehicle>(
142  ROEdge::getAllEdges(), oc.getBool("ignore-errors"), ttFunction, SVC_IGNORING, weightPeriod, net.hasPermissions(), oc.isSet("restriction-params"));
143  } else if (routingAlgorithm == "CHWrapper" || routingAlgorithm == "CH") {
144  // use CHWrapper instead of CH if the net has permissions
145  const SUMOTime weightPeriod = (oc.isSet("weight-files") ?
146  string2time(oc.getString("weight-period")) :
147  SUMOTime_MAX);
149  ROEdge::getAllEdges(), oc.getBool("ignore-errors"), ttFunction,
150  begin, end, weightPeriod, net.hasPermissions(), oc.getInt("routing-threads"));
151  } else {
152  throw ProcessError(TLF("Unknown routing Algorithm '%'!", routingAlgorithm));
153  }
154  } else {
155  if (measure == "traveltime") {
156  if (ROEdge::initPriorityFactor(priorityFactor)) {
158  }
159  } else if (measure == "CO") {
160  op = &ROEdge::getEmissionEffort<PollutantsInterface::CO>;
161  } else if (measure == "CO2") {
162  op = &ROEdge::getEmissionEffort<PollutantsInterface::CO2>;
163  } else if (measure == "PMx") {
164  op = &ROEdge::getEmissionEffort<PollutantsInterface::PM_X>;
165  } else if (measure == "HC") {
166  op = &ROEdge::getEmissionEffort<PollutantsInterface::HC>;
167  } else if (measure == "NOx") {
168  op = &ROEdge::getEmissionEffort<PollutantsInterface::NO_X>;
169  } else if (measure == "fuel") {
170  op = &ROEdge::getEmissionEffort<PollutantsInterface::FUEL>;
171  } else if (measure == "electricity") {
172  op = &ROEdge::getEmissionEffort<PollutantsInterface::ELEC>;
173  } else if (measure == "noise") {
175  } else {
177  }
178  if (measure != "traveltime" && !net.hasLoadedEffort()) {
179  WRITE_WARNINGF(TL("No weight data was loaded for attribute '%'."), measure);
180  }
182  ROEdge::getAllEdges(), oc.getBool("ignore-errors"), op, ttFunction, false, nullptr, net.hasPermissions(), oc.isSet("restriction-params"));
183  }
184  const int carWalk = SUMOVehicleParserHelper::parseCarWalkTransfer(oc);
185  double taxiWait = STEPS2TIME(string2time(OptionsCont::getOptions().getString("persontrip.taxi.waiting-time")));
186 
187  RailwayRouter<ROEdge, ROVehicle>* railRouter = nullptr;
188  if (net.hasBidiEdges()) {
189  railRouter = new RailwayRouter<ROEdge, ROVehicle>(ROEdge::getAllEdges(), true, op, ttFunction, false, net.hasPermissions(),
190  oc.isSet("restriction-params"),
191  oc.getFloat("railway.max-train-length"));
192  }
194  new ROIntermodalRouter(RONet::adaptIntermodalRouter, carWalk, taxiWait, routingAlgorithm),
195  railRouter);
196  // process route definitions
197  try {
198  net.openOutput(oc);
199  loader.processRoutes(begin, end, string2time(oc.getString("route-steps")), net, provider);
200  net.writeIntermodal(oc, provider.getIntermodalRouter());
201  // end the processing
202  net.cleanup();
203  } catch (ProcessError&) {
204  net.cleanup();
205  throw;
206  }
207 }
208 
209 
210 /* -------------------------------------------------------------------------
211  * main
212  * ----------------------------------------------------------------------- */
213 int
214 main(int argc, char** argv) {
216  oc.setApplicationDescription(TL("Shortest path router and DUE computer for the microscopic, multi-modal traffic simulation SUMO."));
217  oc.setApplicationName("duarouter", "Eclipse SUMO duarouter Version " VERSION_STRING);
218  int ret = 0;
219  RONet* net = nullptr;
220  try {
221  XMLSubSys::init();
223  OptionsIO::setArgs(argc, argv);
225  if (oc.processMetaOptions(argc < 2)) {
227  return 0;
228  }
230  XMLSubSys::setValidation(oc.getString("xml-validation"), oc.getString("xml-validation.net"), oc.getString("xml-validation.routes"));
231 #ifdef HAVE_FOX
232  if (oc.getInt("routing-threads") > 1) {
233  // make the output aware of threading
235  }
236 #endif
238  if (!RODUAFrame::checkOptions()) {
239  throw ProcessError();
240  }
242  // load data
243  ROLoader loader(oc, false, !oc.getBool("no-step-log"));
244  net = new RONet();
245  initNet(*net, loader, oc);
246  // build routes
247  try {
248  computeRoutes(*net, loader, oc);
249  } catch (XERCES_CPP_NAMESPACE::SAXParseException& e) {
250  WRITE_ERROR(toString(e.getLineNumber()));
251  ret = 1;
252  } catch (XERCES_CPP_NAMESPACE::SAXException& e) {
253  WRITE_ERROR(StringUtils::transcode(e.getMessage()));
254  ret = 1;
255  }
256  if (MsgHandler::getErrorInstance()->wasInformed() || ret != 0) {
257  throw ProcessError();
258  }
259  } catch (const ProcessError& e) {
260  if (std::string(e.what()) != std::string("Process Error") && std::string(e.what()) != std::string("")) {
261  WRITE_ERROR(e.what());
262  }
263  MsgHandler::getErrorInstance()->inform("Quitting (on error).", false);
264  ret = 1;
265 #ifndef _DEBUG
266  } catch (const std::exception& e) {
267  if (std::string(e.what()) != std::string("")) {
268  WRITE_ERROR(e.what());
269  }
270  MsgHandler::getErrorInstance()->inform("Quitting (on error).", false);
271  ret = 1;
272  } catch (...) {
273  MsgHandler::getErrorInstance()->inform("Quitting (on unknown error).", false);
274  ret = 1;
275 #endif
276  }
277  delete net;
279  if (ret == 0) {
280  std::cout << "Success." << std::endl;
281  }
282  return ret;
283 }
284 
285 
286 /****************************************************************************/
long long int SUMOTime
Definition: GUI.h:35
#define WRITE_WARNINGF(...)
Definition: MsgHandler.h:296
#define WRITE_ERROR(msg)
Definition: MsgHandler.h:304
#define TL(string)
Definition: MsgHandler.h:315
#define TLF(string,...)
Definition: MsgHandler.h:317
IntermodalRouter< ROEdge, ROLane, RONode, ROVehicle > ROIntermodalRouter
Definition: RORoutable.h:41
SUMOTime string2time(const std::string &r)
convert string to SUMOTime
Definition: SUMOTime.cpp:46
#define STEPS2TIME(x)
Definition: SUMOTime.h:55
#define SUMOTime_MAX
Definition: SUMOTime.h:34
const std::string DEFAULT_VTYPE_ID
@ SVC_IGNORING
vehicles ignoring classes
double gWeightsRandomFactor
Definition: StdDefs.cpp:32
std::string toString(const T &t, std::streamsize accuracy=gPrecision)
Definition: ToString.h:46
Computes the shortest path through a network using the A* algorithm.
Definition: AStarRouter.h:76
Computes the shortest path through a contracted network.
Definition: CHRouter.h:59
Computes the shortest path through a contracted network.
Computes the shortest path through a network using the Dijkstra algorithm.
static MsgHandler * getErrorInstance()
Returns the instance to add errors to.
Definition: MsgHandler.cpp:92
virtual void inform(std::string msg, bool addType=true)
adds a new error to the list
Definition: MsgHandler.cpp:154
static void initOutputOptions()
init output options
Definition: MsgHandler.cpp:316
static void setFactory(Factory func)
Sets the factory function to use for new MsgHandlers.
Definition: MsgHandler.h:64
static MsgHandler * create(MsgType type)
A storage for options typed value containers)
Definition: OptionsCont.h:89
bool isSet(const std::string &name, bool failOnNonExistant=true) const
Returns the information whether the named option is set.
double getFloat(const std::string &name) const
Returns the double-value of the named option (only for Option_Float)
int getInt(const std::string &name) const
Returns the int-value of the named option (only for Option_Integer)
void setApplicationName(const std::string &appName, const std::string &fullName)
Sets the application name.
std::string getString(const std::string &name) const
Returns the string-value of the named option (only for Option_String)
bool isDefault(const std::string &name) const
Returns the information whether the named option has still the default value.
void setApplicationDescription(const std::string &appDesc)
Sets the application description.
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.
Definition: OptionsCont.cpp:60
bool processMetaOptions(bool missingOptions)
Checks for help and configuration output, returns whether we should exit.
static void setArgs(int argc, char **argv)
Stores the command line arguments for later parsing.
Definition: OptionsIO.cpp:58
static void getOptions(const bool commandLineOnly=false)
Parses the command line arguments and loads the configuration.
Definition: OptionsIO.cpp:74
Interface for building instances of duarouter-edges.
static void fillOptions()
Inserts options used by duarouter into the OptionsCont-singleton.
Definition: RODUAFrame.cpp:43
static bool checkOptions()
Checks set options from the OptionsCont-singleton for being valid for usage within duarouter.
Definition: RODUAFrame.cpp:184
A basic edge for routing applications.
Definition: ROEdge.h:70
static double getStoredEffort(const ROEdge *const edge, const ROVehicle *const, double time)
Definition: ROEdge.h:481
static bool initPriorityFactor(double priorityFactor)
initialize priority factor range
Definition: ROEdge.cpp:444
static double getTravelTimeStaticPriorityFactor(const ROEdge *const edge, const ROVehicle *const veh, double time)
Return traveltime weighted by edge priority (scaled penalty for low-priority edges)
Definition: ROEdge.h:441
static double getNoiseEffort(const ROEdge *const edge, const ROVehicle *const veh, double time)
Definition: ROEdge.cpp:215
static double getTravelTimeStaticRandomized(const ROEdge *const edge, const ROVehicle *const veh, double time)
Definition: ROEdge.h:431
static void setGlobalOptions(const bool interpolate)
Definition: ROEdge.h:496
static double getTravelTimeStatic(const ROEdge *const edge, const ROVehicle *const veh, double time)
Returns the travel time for the given edge.
Definition: ROEdge.h:427
static const ROEdgeVector & getAllEdges()
Returns all ROEdges.
Definition: ROEdge.cpp:352
The data loader.
Definition: ROLoader.h:53
bool loadWeights(RONet &net, const std::string &optionName, const std::string &measure, const bool useLanes, const bool boundariesOverride)
Loads the net weights.
Definition: ROLoader.cpp:254
void processRoutes(const SUMOTime start, const SUMOTime end, const SUMOTime increment, RONet &net, const RORouterProvider &provider)
Loads routes from all previously build route loaders.
Definition: ROLoader.cpp:193
virtual void loadNet(RONet &toFill, ROAbstractEdgeBuilder &eb)
Loads the network.
Definition: ROLoader.cpp:108
void openRoutes(RONet &net)
Builds and opens all route loaders.
Definition: ROLoader.cpp:163
The router's network representation.
Definition: RONet.h:62
SUMOVTypeParameter * getVehicleTypeSecure(const std::string &id)
Retrieves the named vehicle type.
Definition: RONet.cpp:364
bool hasBidiEdges() const
return whether the network contains bidirectional rail edges
Definition: RONet.h:433
void cleanup()
closes the file output for computed routes and deletes associated threads if necessary
Definition: RONet.cpp:340
void openOutput(const OptionsCont &options)
Opens the output for computed routes.
Definition: RONet.cpp:292
void writeIntermodal(const OptionsCont &options, ROIntermodalRouter &router) const
Writes the intermodal network and weights if requested.
Definition: RONet.cpp:321
static void adaptIntermodalRouter(ROIntermodalRouter &router)
Definition: RONet.cpp:818
bool hasPermissions() const
Definition: RONet.cpp:863
bool hasLoadedEffort() const
whether efforts were loaded from file
Definition: RONet.cpp:874
A vehicle as used by router.
Definition: ROVehicle.h:50
static void initRandGlobal(SumoRNG *which=nullptr)
Reads the given random number options and initialises the random number generator in accordance.
Definition: RandHelper.cpp:87
IntermodalRouter< E, L, N, V > & getIntermodalRouter() const
Structure representing possible vehicle parameter.
static int parseCarWalkTransfer(const OptionsCont &oc, const bool hasTaxi=false)
static std::string transcode(const XMLCh *const data)
converts a 0-terminated XMLCh* array (usually UTF-16, stemming from Xerces) into std::string in UTF-8
Definition: StringUtils.h:152
static void close()
Closes all of an applications subsystems.
static bool checkOptions(OptionsCont &oc)
checks shared options and sets StdDefs
static void setValidation(const std::string &validationScheme, const std::string &netValidationScheme, const std::string &routeValidationScheme)
Enables or disables validation.
Definition: XMLSubSys.cpp:83
static void init()
Initialises the xml-subsystem.
Definition: XMLSubSys.cpp:56
int main(int argc, char **argv)
void initNet(RONet &net, ROLoader &loader, OptionsCont &oc)
void computeRoutes(RONet &net, ROLoader &loader, OptionsCont &oc)