Line data Source code
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 : /****************************************************************************/
14 : /// @file ROFrame.cpp
15 : /// @author Daniel Krajzewicz
16 : /// @author Jakob Erdmann
17 : /// @author Michael Behrisch
18 : /// @date Sept 2002
19 : ///
20 : // Sets and checks options for routing
21 : /****************************************************************************/
22 : #include <config.h>
23 :
24 : #include <iostream>
25 : #include <ctime>
26 : #include <stdlib.h>
27 : #include <utils/options/OptionsCont.h>
28 : #include <utils/options/Option.h>
29 : #include <utils/common/MsgHandler.h>
30 : #include <utils/common/UtilExceptions.h>
31 : #include <utils/common/RandHelper.h>
32 : #include <utils/common/ToString.h>
33 : #include <utils/common/SUMOTime.h>
34 : #include <utils/common/SystemFrame.h>
35 : #include "ROFrame.h"
36 :
37 :
38 : // ===========================================================================
39 : // method definitions
40 : // ===========================================================================
41 : void
42 9843 : ROFrame::fillOptions(OptionsCont& oc, const bool isDUA, const bool isMA) {
43 : // register options
44 : // register I/O options
45 9843 : oc.doRegister("output-file", 'o', new Option_FileName());
46 19686 : oc.addSynonyme("output-file", "output");
47 19686 : oc.addDescription("output-file", "Output", TL("Write generated routes to FILE"));
48 :
49 9843 : oc.doRegister("vtype-output", new Option_FileName());
50 9843 : if (!isMA) {
51 19486 : oc.addSynonyme("vtype-output", "vtype");
52 : }
53 19686 : oc.addDescription("vtype-output", "Output", TL("Write used vehicle types into separate FILE"));
54 :
55 9843 : oc.doRegister("keep-vtype-distributions", new Option_Bool(false));
56 19686 : oc.addDescription("keep-vtype-distributions", "Output", TL("Keep vTypeDistribution ids when writing vehicles and their types"));
57 :
58 9843 : oc.doRegister("emissions.volumetric-fuel", new Option_Bool(false));
59 19686 : oc.addDescription("emissions.volumetric-fuel", "Output", TL("Return fuel consumption values in (legacy) unit l instead of mg"));
60 :
61 9843 : oc.doRegister("net-file", 'n', new Option_FileName());
62 19686 : oc.addSynonyme("net-file", "net");
63 19686 : oc.addDescription("net-file", "Input", TL("Use FILE as SUMO-network to route on"));
64 :
65 9843 : oc.doRegister("named-routes", new Option_Bool(false));
66 19686 : oc.addDescription("named-routes", "Output", TL("Write vehicles that reference routes by their id"));
67 :
68 9843 : oc.doRegister("additional-files", 'a', new Option_FileName());
69 19686 : oc.addSynonyme("additional-files", "d", true);
70 19686 : oc.addSynonyme("additional-files", "additional");
71 19686 : oc.addSynonyme("additional-files", "taz-files");
72 19686 : oc.addSynonyme("additional-files", "districts", true);
73 19686 : oc.addDescription("additional-files", "Input", TL("Read additional network data (districts, bus stops) from FILE(s)"));
74 :
75 9843 : oc.doRegister("route-files", 'r', new Option_FileName());
76 19686 : oc.addSynonyme("route-files", "flow-files", true);
77 19686 : oc.addSynonyme("route-files", "flows", true);
78 19686 : oc.addSynonyme("route-files", "f", true);
79 19686 : oc.addSynonyme("route-files", "alternative-files", true);
80 19686 : oc.addSynonyme("route-files", "alternatives-files", true);
81 19686 : oc.addSynonyme("route-files", "trip-files", true);
82 19686 : oc.addSynonyme("route-files", "trips", true);
83 9843 : if (isDUA) {
84 : // to make the transition from --trip-files easier, but has a conflict with jtrrouter
85 18740 : oc.addSynonyme("route-files", "t", true);
86 : }
87 19686 : oc.addDescription("route-files", "Input", TL("Read sumo routes, alternatives, flows, and trips from FILE(s)"));
88 :
89 39372 : oc.doRegister("phemlight-path", new Option_FileName(StringVector({ "./PHEMlight/" })));
90 19686 : oc.addDescription("phemlight-path", "Input", TL("Determines where to load PHEMlight definitions from"));
91 :
92 9843 : oc.doRegister("phemlight-year", new Option_Integer(0));
93 19686 : oc.addDescription("phemlight-year", "Input", TL("Enable fleet age modelling with the given reference year in PHEMlight5"));
94 :
95 9843 : oc.doRegister("phemlight-temperature", new Option_Float(INVALID_DOUBLE));
96 19686 : oc.addDescription("phemlight-temperature", "Input", TL("Set ambient temperature to correct NOx emissions in PHEMlight5"));
97 :
98 9843 : if (isDUA || isMA) {
99 9470 : oc.doRegister("weight-files", 'w', new Option_FileName());
100 18940 : oc.addSynonyme("weight-files", "weights");
101 18940 : oc.addDescription("weight-files", "Input", TL("Read network weights from FILE(s)"));
102 :
103 9470 : oc.doRegister("lane-weight-files", new Option_FileName());
104 18940 : oc.addDescription("lane-weight-files", "Input", TL("Read lane-based network weights from FILE(s)"));
105 :
106 18940 : oc.doRegister("weight-attribute", 'x', new Option_String("traveltime"));
107 18940 : oc.addSynonyme("weight-attribute", "measure", true);
108 18940 : oc.addDescription("weight-attribute", "Input", TL("Name of the xml attribute which gives the edge weight"));
109 : }
110 :
111 : // need to do this here to be able to check for network and route input options
112 9843 : SystemFrame::addReportOptions(oc);
113 :
114 : // register the time settings
115 19686 : oc.doRegister("begin", 'b', new Option_String("0", "TIME"));
116 19686 : oc.addDescription("begin", "Time", TL("Defines the begin time; Previous trips will be discarded"));
117 :
118 19686 : oc.doRegister("end", 'e', new Option_String("-1", "TIME"));
119 19686 : oc.addDescription("end", "Time", TL("Defines the end time; Later trips will be discarded; Defaults to the maximum time that SUMO can represent"));
120 :
121 : // register the processing options
122 9843 : oc.doRegister("ignore-errors", new Option_Bool(false));
123 19686 : oc.addSynonyme("ignore-errors", "continue-on-unbuild", true);
124 19686 : oc.addSynonyme("ignore-errors", "dismiss-loading-errors", true);
125 19686 : oc.addDescription("ignore-errors", "Report", TL("Continue if a route could not be build"));
126 :
127 9843 : oc.doRegister("max-alternatives", new Option_Integer(5));
128 19686 : oc.addDescription("max-alternatives", "Processing", TL("Prune the number of alternatives to INT"));
129 :
130 9843 : oc.doRegister("with-taz", new Option_Bool(false));
131 19686 : oc.addDescription("with-taz", "Processing", TL("Use origin and destination zones (districts) for in- and output"));
132 :
133 9843 : oc.doRegister("junction-taz", new Option_Bool(false));
134 19686 : oc.addDescription("junction-taz", "Input", TL("Initialize a TAZ for every junction to use attributes toJunction and fromJunction"));
135 :
136 9843 : if (!isMA) {
137 9743 : oc.doRegister("unsorted-input", new Option_Bool(false));
138 19486 : oc.addSynonyme("unsorted-input", "unsorted");
139 19486 : oc.addDescription("unsorted-input", "Processing", TL("Assume input is unsorted"));
140 :
141 19486 : oc.doRegister("route-steps", 's', new Option_String("200", "TIME"));
142 19486 : oc.addDescription("route-steps", "Processing", TL("Load routes for the next number of seconds ahead"));
143 :
144 9743 : oc.doRegister("no-internal-links", new Option_Bool(false));
145 19486 : oc.addDescription("no-internal-links", "Processing", TL("Disable (junction) internal links"));
146 :
147 9743 : oc.doRegister("randomize-flows", new Option_Bool(false));
148 19486 : oc.addDescription("randomize-flows", "Processing", TL("generate random departure times for flow input"));
149 :
150 9743 : oc.doRegister("remove-loops", new Option_Bool(false));
151 19486 : oc.addDescription("remove-loops", "Processing", TL("Remove loops within the route; Remove turnarounds at start and end of the route"));
152 :
153 9743 : oc.doRegister("repair", new Option_Bool(false));
154 19486 : oc.addDescription("repair", "Processing", TL("Tries to correct a false route"));
155 :
156 9743 : oc.doRegister("repair.from", new Option_Bool(false));
157 19486 : oc.addDescription("repair.from", "Processing", TL("Tries to correct an invalid starting edge by using the first usable edge instead"));
158 :
159 9743 : oc.doRegister("repair.to", new Option_Bool(false));
160 19486 : oc.addDescription("repair.to", "Processing", TL("Tries to correct an invalid destination edge by using the last usable edge instead"));
161 :
162 9743 : oc.doRegister("mapmatch.distance", new Option_Float(100));
163 19486 : oc.addDescription("mapmatch.distance", "Processing", TL("Maximum distance when mapping input coordinates (fromXY etc.) to the road network"));
164 :
165 9743 : oc.doRegister("mapmatch.junctions", new Option_Bool(false));
166 19486 : oc.addDescription("mapmatch.junctions", "Processing", TL("Match positions to junctions instead of edges"));
167 :
168 9743 : oc.doRegister("mapmatch.taz", new Option_Bool(false));
169 19486 : oc.addDescription("mapmatch.taz", "Processing", TL("Match positions to taz instead of edges"));
170 :
171 9743 : oc.doRegister("bulk-routing", new Option_Bool(false));
172 19486 : oc.addDescription("bulk-routing", "Processing", TL("Aggregate routing queries with the same origin"));
173 : }
174 :
175 9843 : oc.doRegister("routing-threads", new Option_Integer(0));
176 19686 : oc.addDescription("routing-threads", "Processing", TL("The number of parallel execution threads used for routing"));
177 :
178 9843 : if (isDUA || isMA) {
179 18940 : oc.doRegister("routing-algorithm", new Option_String("dijkstra"));
180 18940 : oc.addDescription("routing-algorithm", "Processing", TL("Select among routing algorithms ['dijkstra', 'astar', 'CH', 'CHWrapper']"));
181 : }
182 :
183 9843 : oc.doRegister("restriction-params", new Option_StringVector());
184 19686 : oc.addDescription("restriction-params", "Processing", TL("Comma separated list of param keys to compare for additional restrictions"));
185 :
186 9843 : if (isDUA || isMA) {
187 9470 : oc.doRegister("weights.interpolate", new Option_Bool(false));
188 18940 : oc.addSynonyme("weights.interpolate", "interpolate", true);
189 18940 : oc.addDescription("weights.interpolate", "Processing", TL("Interpolate edge weights at interval boundaries"));
190 :
191 9470 : oc.doRegister("weights.expand", new Option_Bool(false));
192 18940 : oc.addSynonyme("weights.expand", "expand-weights", true);
193 18940 : oc.addDescription("weights.expand", "Processing", TL("Expand the end of the last loaded weight interval to infinity"));
194 : }
195 :
196 9843 : oc.doRegister("weights.minor-penalty", new Option_Float(1.5));
197 19686 : oc.addDescription("weights.minor-penalty", "Processing", TL("Apply the given time penalty when computing routing costs for minor-link internal lanes"));
198 :
199 9843 : oc.doRegister("weights.tls-penalty", new Option_Float(0));
200 19686 : oc.addDescription("weights.tls-penalty", "Processing", TL("Apply the given time penalty when computing routing costs across a traffic light"));
201 :
202 9843 : oc.doRegister("weights.turnaround-penalty", new Option_Float(5.0));
203 19686 : oc.addDescription("weights.turnaround-penalty", "Processing", TL("Apply the given time penalty when computing routing costs for turnaround internal lanes"));
204 :
205 9843 : if (!isMA) {
206 : // register defaults options
207 9743 : oc.doRegister("departlane", new Option_String());
208 19486 : oc.addDescription("departlane", "Defaults", TL("Assigns a default depart lane"));
209 :
210 9743 : oc.doRegister("departpos", new Option_String());
211 19486 : oc.addDescription("departpos", "Defaults", TL("Assigns a default depart position"));
212 :
213 9743 : oc.doRegister("departspeed", new Option_String());
214 19486 : oc.addDescription("departspeed", "Defaults", TL("Assigns a default depart speed"));
215 :
216 9743 : oc.doRegister("arrivallane", new Option_String());
217 19486 : oc.addDescription("arrivallane", "Defaults", TL("Assigns a default arrival lane"));
218 :
219 9743 : oc.doRegister("arrivalpos", new Option_String());
220 19486 : oc.addDescription("arrivalpos", "Defaults", TL("Assigns a default arrival position"));
221 :
222 9743 : oc.doRegister("arrivalspeed", new Option_String());
223 19486 : oc.addDescription("arrivalspeed", "Defaults", TL("Assigns a default arrival speed"));
224 :
225 : }
226 9843 : oc.doRegister("defaults-override", new Option_Bool(false));
227 19686 : oc.addDescription("defaults-override", "Defaults", TL("Defaults will override given values"));
228 :
229 : // register report options
230 9843 : oc.doRegister("stats-period", new Option_Integer(-1));
231 19686 : oc.addDescription("stats-period", "Report", TL("Defines how often statistics shall be printed"));
232 :
233 9843 : oc.doRegister("no-step-log", new Option_Bool(false));
234 19686 : oc.addDescription("no-step-log", "Report", TL("Disable console output of route parsing step"));
235 29529 : }
236 :
237 :
238 : bool
239 9492 : ROFrame::checkOptions(OptionsCont& oc) {
240 : // check whether the output is valid and can be build
241 18984 : if (!oc.isSet("output-file")) {
242 10 : WRITE_ERROR(TL("No output specified."));
243 10 : return false;
244 : }
245 : //
246 18964 : if (oc.getInt("max-alternatives") < 1) {
247 0 : WRITE_ERROR(TL("A positive number of alternatives must be enabled."));
248 0 : return false;
249 : }
250 : #ifndef HAVE_FOX
251 : if (oc.getInt("routing-threads") > 1) {
252 : WRITE_ERROR(TL("Parallel routing is only possible when compiled with Fox."));
253 : return false;
254 : }
255 : #endif
256 : return true;
257 : }
258 :
259 :
260 : /****************************************************************************/
|
