Eclipse SUMO - Simulation of Urban MObility
Loading...
Searching...
No Matches
NBFrame.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-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/****************************************************************************/
20// Sets and checks options for netbuild
21/****************************************************************************/
22#include <config.h>
23
24#include <string>
25#include <fstream>
26#include <utils/options/OptionsCont.h>
27#include <utils/common/MsgHandler.h>
28#include <utils/common/UtilExceptions.h>
29#include <utils/common/StringTokenizer.h>
30#include <utils/common/ToString.h>
31#include <utils/geom/GeoConvHelper.h>
32#include <utils/iodevices/OutputDevice.h>
33#include <utils/xml/SUMOXMLDefinitions.h>
34
35#include "NBFrame.h"
36#include "NBNodeCont.h"
37#include "NBEdgeCont.h"
38#include "NBTrafficLightLogicCont.h"
39#include "NBDistrictCont.h"
40#include "NBRequest.h"
41#include "NBTypeCont.h"
42
43// ===========================================================================
44// method definitions
45// ===========================================================================
46
47void
48NBFrame::fillOptions(OptionsCont& oc, bool forNetgen) {
49 // register building defaults
50 oc.doRegister("default.lanenumber", 'L', new Option_Integer(1));
51 oc.addSynonyme("default.lanenumber", "lanenumber", true);
52 oc.addDescription("default.lanenumber", "Building Defaults", TL("The default number of lanes in an edge"));
53
54 oc.doRegister("default.lanewidth", new Option_Float(NBEdge::UNSPECIFIED_WIDTH));
55 oc.addSynonyme("default.lanewidth", "lanewidth", true);
56 oc.addDescription("default.lanewidth", "Building Defaults", TL("The default width of lanes"));
57
58 oc.doRegister("default.spreadtype", new Option_String("right"));
59 oc.addDescription("default.spreadtype", "Building Defaults", TL("The default method for computing lane shapes from edge shapes"));
60
61 oc.doRegister("default.speed", 'S', new Option_Float((double) 13.89));
62 oc.addSynonyme("default.speed", "speed", true);
63 oc.addDescription("default.speed", "Building Defaults", TL("The default speed on an edge (in m/s)"));
64
65 oc.doRegister("default.friction", new Option_Float(NBEdge::UNSPECIFIED_FRICTION));
66 oc.addSynonyme("default.friction", "friction", true);
67 oc.addDescription("default.friction", "Building Defaults", TL("The default friction on an edge"));
68
69 oc.doRegister("default.priority", 'P', new Option_Integer(-1));
70 oc.addSynonyme("default.priority", "priority", true);
71 oc.addDescription("default.priority", "Building Defaults", TL("The default priority of an edge"));
72
73 oc.doRegister("default.type", new Option_String());
74 oc.addDescription("default.type", "Building Defaults", TL("The default edge type"));
75
76 oc.doRegister("default.sidewalk-width", new Option_Float((double) 2.0));
77 oc.addDescription("default.sidewalk-width", "Building Defaults", TL("The default width of added sidewalks"));
78
79 oc.doRegister("default.bikelane-width", new Option_Float((double) 1.0));
80 oc.addDescription("default.bikelane-width", "Building Defaults", TL("The default width of added bike lanes"));
81
82 oc.doRegister("default.crossing-width", new Option_Float((double) 4.0));
83 oc.addDescription("default.crossing-width", "Building Defaults", TL("The default width of a pedestrian crossing"));
84
85 oc.doRegister("default.crossing-speed", new Option_Float(2.78));
86 oc.addDescription("default.crossing-speed", "Building Defaults", TL("The default speed 'limit' on a pedestrian crossing (in m/s)"));
87
88 oc.doRegister("default.walkingarea-speed", new Option_Float(2.78));
89 oc.addDescription("default.walkingarea-speed", "Building Defaults", TL("The default speed 'limit' on a pedestrian walkingarea (in m/s)"));
90
91 oc.doRegister("default.allow", new Option_String());
92 oc.addDescription("default.allow", "Building Defaults", TL("The default for allowed vehicle classes"));
93
94 oc.doRegister("default.disallow", new Option_String());
95 oc.addDescription("default.disallow", "Building Defaults", TL("The default for disallowed vehicle classes"));
96
97 oc.doRegister("default.junctions.keep-clear", new Option_Bool(true));
98 oc.addDescription("default.junctions.keep-clear", "Building Defaults", TL("Whether junctions should be kept clear by default"));
99
100 oc.doRegister("default.junctions.radius", new Option_Float(4));
101 oc.addDescription("default.junctions.radius", "Building Defaults", TL("The default turning radius of intersections"));
102
103 oc.doRegister("default.junctions.type", 'j', new Option_String());
104 oc.addSynonyme("default.junctions.type", "default-junction-type"); // default netgenerate option name
105 oc.addDescription("default.junctions.type", "Building Defaults", TL("[traffic_light|priority|right_before_left|left_before_right|traffic_light_right_on_red|priority_stop|allway_stop|...] Determines default junction type (see wiki/Networks/PlainXML#Node_types)"));
106
107 oc.doRegister("default.connection-length", new Option_Float((double) NBEdge::UNSPECIFIED_LOADED_LENGTH));
108 oc.addDescription("default.connection-length", "Building Defaults", TL("The default length when overriding connection lengths"));
109
110 oc.doRegister("default.connection.cont-pos", new Option_Float((double)NBEdge::UNSPECIFIED_CONTPOS));
111 oc.addDescription("default.connection.cont-pos", "Building Defaults", TL("Whether/where connections should have an internal junction"));
112
113 oc.doRegister("default.right-of-way", new Option_String("default"));
114 oc.addDescription("default.right-of-way", "Building Defaults", TL("The default algorithm for computing right of way rules ('default', 'edgePriority')"));
115
116 oc.doRegister("junctions.right-before-left.speed-threshold", new Option_Float(49 / 3.6));
117 oc.addDescription("junctions.right-before-left.speed-threshold", "Junctions", TL("Allow building right-before-left junctions when the incoming edge speeds are below FLOAT (m/s)"));
118
119 oc.doRegister("junctions.left-before-right", new Option_Bool(false));
120 oc.addDescription("junctions.left-before-right", "Junctions", TL("Build left-before-right junctions instead of right-before-left junctions"));
121
122 // register the data processing options
123 oc.doRegister("no-internal-links", new Option_Bool(false)); // !!! not described
124 oc.addDescription("no-internal-links", "Junctions", TL("Omits internal links"));
125
126 oc.doRegister("numerical-ids", new Option_Bool(false));
127 oc.addDescription("numerical-ids", "Processing", TL("Remaps alphanumerical IDs of nodes and edges to ensure that all IDs are integers"));
128
129 oc.doRegister("numerical-ids.node-start", new Option_Integer(std::numeric_limits<int>::max()));
130 oc.addDescription("numerical-ids.node-start", "Processing", TL("Remaps IDs of nodes to integers starting at INT"));
131
132 oc.doRegister("numerical-ids.edge-start", new Option_Integer(std::numeric_limits<int>::max()));
133 oc.addDescription("numerical-ids.edge-start", "Processing", TL("Remaps IDs of edges to integers starting at INT"));
134
136 oc.doRegister("reserved-ids", new Option_FileName());
137 oc.addDescription("reserved-ids", "Processing", TL("Ensures that generated ids do not included any of the typed IDs from FILE (sumo-gui selection file format)"));
138
139 oc.doRegister("kept-ids", new Option_FileName());
140 oc.addDescription("kept-ids", "Processing", TL("Ensures that objects with typed IDs from FILE (sumo-gui selection file format) are not renamed"));
141
142 if (!forNetgen) {
143 oc.doRegister("dismiss-vclasses", new Option_Bool(false));
144 oc.addDescription("dismiss-vclasses", "Processing", TL("Removes vehicle class restrictions from imported edges"));
145 }
146
147 oc.doRegister("no-turnarounds", new Option_Bool(false));
148 oc.addDescription("no-turnarounds", "Junctions", TL("Disables building turnarounds"));
149
150 oc.doRegister("no-turnarounds.tls", new Option_Bool(false));
151 oc.addSynonyme("no-turnarounds.tls", "no-tls-turnarounds", true);
152 oc.addDescription("no-turnarounds.tls", "Junctions", TL("Disables building turnarounds at tls-controlled junctions"));
153
154 oc.doRegister("no-turnarounds.geometry", new Option_Bool(true));
155 oc.addDescription("no-turnarounds.geometry", "Junctions", TL("Disables building turnarounds at geometry-like junctions"));
156
157 oc.doRegister("no-turnarounds.except-deadend", new Option_Bool(false));
158 oc.addDescription("no-turnarounds.except-deadend", "Junctions", TL("Disables building turnarounds except at dead end junctions"));
159
160 oc.doRegister("no-turnarounds.except-turnlane", new Option_Bool(false));
161 oc.addDescription("no-turnarounds.except-turnlane", "Junctions", TL("Disables building turnarounds except at junctions with a dedicated turning lane"));
162
163 oc.doRegister("no-turnarounds.fringe", new Option_Bool(false));
164 oc.addDescription("no-turnarounds.fringe", "Junctions", TL("Disables building turnarounds at fringe junctions"));
165
166 oc.doRegister("no-left-connections", new Option_Bool(false));
167 oc.addDescription("no-left-connections", "Junctions", TL("Disables building connections to left"));
168
169 oc.doRegister("geometry.split", new Option_Bool(false)); // !!!not described
170 oc.addSynonyme("geometry.split", "split-geometry", true);
171 oc.addDescription("geometry.split", "Processing", TL("Splits edges across geometry nodes"));
172
173 oc.doRegister("geometry.remove", 'R', new Option_Bool(false));
174 oc.addSynonyme("geometry.remove", "remove-geometry", true);
175 oc.addDescription("geometry.remove", "Processing", TL("Replace nodes which only define edge geometry by geometry points (joins edges)"));
176
177 oc.doRegister("geometry.remove.keep-edges.explicit", new Option_StringVector());
178 oc.addDescription("geometry.remove.keep-edges.explicit", "Processing", TL("Ensure that the given list of edges is not modified"));
179
180 oc.doRegister("geometry.remove.keep-edges.input-file", new Option_FileName());
181 oc.addDescription("geometry.remove.keep-edges.input-file", "Processing",
182 "Ensure that the edges in FILE are not modified (Each id on a single line. Selection files from sumo-gui are also supported)");
183
184 if (!forNetgen) {
185 oc.doRegister("geometry.remove.keep-ptstops", new Option_Bool(false));
186 oc.addDescription("geometry.remove.keep-ptstops", "Processing", TL("Ensure that edges with public transport stops are not modified"));
187 }
188
189 oc.doRegister("geometry.remove.min-length", new Option_Float(0));
190 oc.addDescription("geometry.remove.min-length", "Processing",
191 "Allow merging edges with differing attributes when their length is below min-length");
192
193 oc.doRegister("geometry.remove.width-tolerance", new Option_Float(0));
194 oc.addDescription("geometry.remove.width-tolerance", "Processing",
195 "Allow merging edges with differing lane widths if the difference is below FLOAT");
196
197 oc.doRegister("geometry.remove.max-junction-size", new Option_Float(-1));
198 oc.addDescription("geometry.remove.max-junction-size", "Processing",
199 "Prevent removal of junctions with a size above FLOAT as defined by custom edge endpoints");
200
201 oc.doRegister("geometry.max-segment-length", new Option_Float(0));
202 oc.addDescription("geometry.max-segment-length", "Processing", TL("splits geometry to restrict segment length"));
203
204 if (!forNetgen) {
205 oc.doRegister("geometry.min-dist", new Option_Float(-1));
206 oc.addDescription("geometry.min-dist", "Processing", TL("reduces too similar geometry points"));
207
208 oc.doRegister("geometry.max-angle", new Option_Float(99));
209 oc.addDescription("geometry.max-angle", "Processing", TL("Warn about edge geometries with an angle above DEGREES in successive segments"));
210
211 oc.doRegister("geometry.max-angle.fix", new Option_Bool(false));
212 oc.addDescription("geometry.max-angle.fix", "Processing", TL("Straighten edge geometries with an angle above max-angle successive segments"));
213
214 oc.doRegister("geometry.min-radius", new Option_Float(9));
215 oc.addDescription("geometry.min-radius", "Processing", TL("Warn about edge geometries with a turning radius less than METERS at the start or end"));
216
217 oc.doRegister("geometry.min-radius.fix", new Option_Bool(false));
218 oc.addDescription("geometry.min-radius.fix", "Processing", TL("Straighten edge geometries to avoid turning radii less than geometry.min-radius"));
219
220 oc.doRegister("geometry.min-radius.fix.railways", new Option_Bool(true));
221 oc.addDescription("geometry.min-radius.fix.railways", "Processing", TL("Straighten edge geometries to avoid turning radii less than geometry.min-radius (only railways)"));
222
223 oc.doRegister("geometry.junction-mismatch-threshold", new Option_Float(20));
224 oc.addDescription("geometry.junction-mismatch-threshold", "Processing", TL("Warn if the junction shape is too far away from the original node position"));
225
226 oc.doRegister("geometry.check-overlap", new Option_Float(0));
227 oc.addDescription("geometry.check-overlap", "Processing", TL("Warn if edges overlap by more than the given threshold value"));
228
229 oc.doRegister("geometry.check-overlap.vertical-threshold", new Option_Float(4));
230 oc.addDescription("geometry.check-overlap.vertical-threshold", "Processing", TL("Ignore overlapping edges if they are separated vertically by the given threshold."));
231
232 oc.doRegister("geometry.avoid-overlap", new Option_Bool(true));
233 oc.addDescription("geometry.avoid-overlap", "Processing", TL("Modify edge geometries to avoid overlap at junctions"));
234
235 oc.doRegister("join-lanes", new Option_Bool(false));
236 oc.addDescription("join-lanes", "Processing", TL("join adjacent lanes that have the same permissions and which do not admit lane-changing (sidewalks and disallowed lanes)"));
237
238 oc.doRegister("ptline.match-dist", new Option_Float(100));
239 oc.addDescription("ptline.match-dist", "Processing", TL("Matches stops outside the road network to the referencing pt line when below the given distance"));
240 // railway processing options
241
242 oc.doRegister("railway.topology.repair", new Option_Bool(false));
243 oc.addDescription("railway.topology.repair", "Railway", TL("Repair topology of the railway network"));
244
245 oc.doRegister("railway.topology.repair.minimal", new Option_Bool(false));
246 oc.addDescription("railway.topology.repair.minimal", "Railway", TL("Repair topology of the railway network just enough to let loaded public transport lines to work"));
247
248 oc.doRegister("railway.topology.repair.connect-straight", new Option_Bool(false));
249 oc.addDescription("railway.topology.repair.connect-straight", "Railway", TL("Allow bidirectional rail use wherever rails with opposite directions meet at a straight angle"));
250
251 oc.doRegister("railway.topology.repair.stop-turn", new Option_Bool(false));
252 oc.addDescription("railway.topology.repair.stop-turn", "Railway", TL("Add turn-around connections at all loaded stops."));
253
254 oc.doRegister("railway.topology.repair.bidi-penalty", new Option_Float(1.2));
255 oc.addDescription("railway.topology.repair.bidi-penalty", "Railway", TL("Penalty factor for adding new bidi edges to connect public transport stops"));
256
257 oc.doRegister("railway.topology.all-bidi", new Option_Bool(false));
258 oc.addDescription("railway.topology.all-bidi", "Railway", TL("Make all rails usable in both direction"));
259
260 oc.doRegister("railway.topology.all-bidi.input-file", new Option_FileName());
261 oc.addDescription("railway.topology.all-bidi.input-file", "Railway", TL("Make all rails edge ids from FILE usable in both direction"));
262
263 oc.doRegister("railway.topology.direction-priority", new Option_Bool(false));
264 oc.addDescription("railway.topology.direction-priority", "Railway", TL("Set edge priority values based on estimated main direction"));
265
266 oc.doRegister("railway.topology.ptline-priority", new Option_StringVector());
267 oc.addDescription("railway.topology.ptline-priority", "Railway", TL("Set edge priority values based on public transport lines for the given list of vClasses"));
268
269 oc.doRegister("railway.topology.extend-priority", new Option_Bool(false));
270 oc.addDescription("railway.topology.extend-priority", "Railway", TL("Extend loaded edge priority values based on estimated main direction"));
271
272 oc.doRegister("railway.geometry.straighten", new Option_Bool(false));
273 oc.addDescription("railway.geometry.straighten", "Railway", TL("Move junctions to straighten a sequence of rail edges"));
274
275 oc.doRegister("railway.signal.guess.by-stops", new Option_Bool(false));
276 oc.addDescription("railway.signal.guess.by-stops", "Railway", TL("Guess signals that guard public transport stops"));
277
278 oc.doRegister("railway.signal.permit-unsignalized", new Option_StringVector({"tram", "cable_car"}));
279 oc.addDescription("railway.signal.permit-unsignalized", "Railway", TL("List rail classes that may run without rail signals"));
280
281 oc.doRegister("railway.access-distance", new Option_Float(150.f));
282 oc.addDescription("railway.access-distance", "Railway", TL("The search radius for finding suitable road accesses for rail stops"));
283 oc.addSynonyme("railway.access-distance", "osm.stop-output.footway-access-distance", true);
284
285 oc.doRegister("railway.max-accesses", new Option_Integer(5));
286 oc.addDescription("railway.max-accesses", "Railway", TL("The maximum road accesses registered per rail stops"));
287 oc.addSynonyme("railway.max-accesses", "osm.stop-output.footway-max-accesses", true);
288
289 oc.doRegister("railway.access-factor", new Option_Float(1.5));
290 oc.addDescription("railway.access-factor", "Railway", TL("The walking length of the access is computed as air-line distance multiplied by FLOAT"));
291 oc.addSynonyme("railway.access-factor", "osm.stop-output.footway-access-factor", true);
292
293 oc.doRegister("ptstop-output.no-bidi", new Option_Bool(false));
294 oc.addDescription("ptstop-output.no-bidi", "Processing", TL("Skips automatic generation of stops on the bidi-edge of a loaded stop"));
295 }
296
297 oc.doRegister("geometry.max-grade", new Option_Float(10));
298 oc.addDescription("geometry.max-grade", "Processing", TL("Warn about edge geometries with a grade in % above FLOAT."));
299
300 oc.doRegister("geometry.max-grade.fix", new Option_Bool(true));
301 oc.addDescription("geometry.max-grade.fix", "Processing", TL("Smooth edge geometries with a grade above the warning threshold."));
302
303 oc.doRegister("offset.disable-normalization", new Option_Bool(false));
304 oc.addSynonyme("offset.disable-normalization", "disable-normalize-node-positions", true);
305 oc.addDescription("offset.disable-normalization", "Processing", TL("Turn off normalizing node positions"));
306
307 oc.doRegister("offset.x", new Option_Float(0));
308 oc.addSynonyme("offset.x", "x-offset-to-apply", true);
309 oc.addDescription("offset.x", "Processing", TL("Adds FLOAT to net x-positions"));
310
311 oc.doRegister("offset.y", new Option_Float(0));
312 oc.addSynonyme("offset.y", "y-offset-to-apply", true);
313 oc.addDescription("offset.y", "Processing", TL("Adds FLOAT to net y-positions"));
314
315 oc.doRegister("offset.z", new Option_Float(0));
316 oc.addDescription("offset.z", "Processing", TL("Adds FLOAT to net z-positions"));
317
318 oc.doRegister("flip-y-axis", new Option_Bool(false));
319 oc.addSynonyme("flip-y-axis", "flip-y");
320 oc.addDescription("flip-y-axis", "Processing", TL("Flips the y-coordinate along zero"));
321
322 oc.doRegister("roundabouts.guess", new Option_Bool(true));
323 oc.addSynonyme("roundabouts.guess", "guess-roundabouts", true);
324 oc.addDescription("roundabouts.guess", "Processing", TL("Enable roundabout-guessing"));
325
326 // The Putrajaya Roundabout (Malaysia) holds the Guinness record for the world’s largest roundabout with 3.4km.
327 oc.doRegister("roundabouts.guess.max-length", new Option_Float(3500));
328 oc.addDescription("roundabouts.guess.max-length", "Processing", TL("Structures with a circumference above FLOAT threshold are not classified as roundabout"));
329
330 oc.doRegister("roundabouts.visibility-distance", new Option_Float(9));
331 oc.addDescription("roundabouts.visibility-distance", "Processing", TL("Default visibility when approaching a roundabout"));
332
333 oc.doRegister("opposites.guess", new Option_Bool(false));
334 oc.addDescription("opposites.guess", "Processing", TL("Enable guessing of opposite direction lanes usable for overtaking"));
335
336 oc.doRegister("opposites.guess.fix-lengths", new Option_Bool(true));
337 oc.addDescription("opposites.guess.fix-lengths", "Processing", TL("Ensure that opposite edges have the same length"));
338
339 oc.doRegister("fringe.guess", new Option_Bool(false));
340 oc.addDescription("fringe.guess", "Processing", TL("Enable guessing of network fringe nodes"));
341
342 oc.doRegister("fringe.guess.speed-threshold", new Option_Float(50 / 3.6));
343 oc.addDescription("fringe.guess.speed-threshold", "Processing", TL("Guess disconnected edges above the given speed as outer fringe"));
344
345 oc.doRegister("lefthand", new Option_Bool(false));
346 oc.addDescription("lefthand", "Processing", TL("Assumes left-hand traffic on the network"));
347
348 oc.doRegister("edges.join", new Option_Bool(false));
349 oc.addDescription("edges.join", "Processing",
350 TL("Merges edges which connect the same nodes and are close to each other (recommended for VISSIM import)"));
351
352 oc.doRegister("junctions.join", new Option_Bool(false));
353 oc.addDescription("junctions.join", "Junctions",
354 TL("Joins junctions that are close to each other (recommended for OSM import)"));
355
356 oc.doRegister("junctions.join-dist", new Option_Float(10));
357 oc.addDescription("junctions.join-dist", "Junctions",
358 TL("Determines the maximal distance for joining junctions (defaults to 10)"));
359
360 oc.doRegister("junctions.join.parallel-threshold", new Option_Float(30));
361 oc.addDescription("junctions.join.parallel-threshold", "Junctions",
362 TL("The angular threshold in degrees for rejection of parallel edges when joining junctions"));
363
364 if (!forNetgen) {
365 oc.doRegister("junctions.join-exclude", new Option_StringVector());
366 oc.addDescription("junctions.join-exclude", "Junctions", TL("Interprets STR[] as list of junctions to exclude from joining"));
367 }
368
369 oc.doRegister("junctions.join-same", new Option_Float(-1));
370 oc.addDescription("junctions.join-same", "Junctions",
371 TL("Joins junctions that have similar coordinates even if not connected"));
372
373 oc.doRegister("junctions.join-reset", new Option_Bool(false));
374 oc.addDescription("junctions.join-reset", "Junctions", TL("Reset connections for joined junctions"));
375
376 if (!forNetgen) {
377 oc.doRegister("junctions.attach-removed", new Option_Float(-1));
378 oc.addDescription("junctions.attach-removed", "Junctions",
379 TL("Attach junction to the closest edge within FLOAT distance that has it's id in param removedNodeIDs (for joining networks)"));
380 }
381
382 oc.doRegister("max-join-ids", new Option_Integer(4));
383 oc.addDescription("max-join-ids", "Junctions", TL("Abbreviate junction or TLS id if it joins more than INT junctions"));
384
385 if (!forNetgen) {
386 oc.doRegister("speed.offset", new Option_Float(0));
387 oc.addDescription("speed.offset", "Processing", TL("Modifies all edge speeds by adding FLOAT"));
388
389 oc.doRegister("speed.factor", new Option_Float(1));
390 oc.addDescription("speed.factor", "Processing", TL("Modifies all edge speeds by multiplying by FLOAT"));
391
392 oc.doRegister("speed.minimum", new Option_Float(0));
393 oc.addDescription("speed.minimum", "Processing", TL("Modifies all edge speeds to at least FLOAT"));
394
395 oc.doRegister("edges.join-tram-dist", new Option_Float(-1));
396 oc.addDescription("edges.join-tram-dist", "Processing",
397 TL("Joins tram edges into road lanes with similar geometry (within FLOAT distance)"));
398 }
399
400 oc.doRegister("junctions.corner-detail", new Option_Integer(5));
401 oc.addDescription("junctions.corner-detail", "Junctions", TL("Generate INT intermediate points to smooth out intersection corners"));
402
403 oc.doRegister("junctions.internal-link-detail", new Option_Integer(5));
404 oc.addDescription("junctions.internal-link-detail", "Junctions", TL("Generate INT intermediate points to smooth out lanes within the intersection"));
405
406 oc.doRegister("junctions.scurve-stretch", new Option_Float(0));
407 oc.addDescription("junctions.scurve-stretch", "Junctions", TL("Generate longer intersections to allow for smooth s-curves when the number of lanes changes"));
408
409 oc.doRegister("junctions.join-turns", new Option_Bool(false));
410 oc.addDescription("junctions.join-turns", "Junctions",
411 TL("Builds common edges for turning connections with common from- and to-edge. This causes discrepancies between geometrical length and assigned length due to averaging but enables lane-changing while turning"));
412
413 oc.doRegister("junctions.limit-turn-speed", new Option_Float(5.5));
414 oc.addDescription("junctions.limit-turn-speed", "Junctions",
415 TL("Limits speed on junctions to an average lateral acceleration of at most FLOAT (m/s^2)"));
416
417 oc.doRegister("junctions.limit-turn-speed.min-angle", new Option_Float(15));
418 oc.addDescription("junctions.limit-turn-speed.min-angle", "Junctions",
419 TL("Do not limit turn speed for angular changes below FLOAT (degrees). The value is subtracted from the geometric angle before computing the turning radius."));
420
421 oc.doRegister("junctions.limit-turn-speed.min-angle.railway", new Option_Float(35));
422 oc.addDescription("junctions.limit-turn-speed.min-angle.railway", "Junctions",
423 TL("Do not limit turn speed for angular changes below FLOAT (degrees) on railway edges. The value is subtracted from the geometric angle before computing the turning radius."));
424
425 oc.doRegister("junctions.limit-turn-speed.warn.straight", new Option_Float(5));
426 oc.addDescription("junctions.limit-turn-speed.warn.straight", "Junctions",
427 TL("Warn about turn speed limits that reduce the speed of straight connections by more than FLOAT"));
428
429 oc.doRegister("junctions.limit-turn-speed.warn.turn", new Option_Float(22));
430 oc.addDescription("junctions.limit-turn-speed.warn.turn", "Junctions",
431 TL("Warn about turn speed limits that reduce the speed of turning connections (no u-turns) by more than FLOAT"));
432
433 oc.doRegister("junctions.small-radius", new Option_Float(1.5));
434 oc.addDescription("junctions.small-radius", "Junctions",
435 TL("Default radius for junctions that do not require wide vehicle turns"));
436
437 oc.doRegister("junctions.higher-speed", new Option_Bool(false));
438 oc.addDescription("junctions.higher-speed", "Junctions",
439 TL("Use maximum value of incoming and outgoing edge speed on junction instead of average"));
440
441 oc.doRegister("junctions.minimal-shape", new Option_Bool(false));
442 oc.addDescription("junctions.minimal-shape", "Junctions",
443 TL("Build junctions with minimal shapes (ignoring edge overlap)"));
444
445 oc.doRegister("junctions.endpoint-shape", new Option_Bool(false));
446 oc.addDescription("junctions.endpoint-shape", "Junctions",
447 TL("Build junction shapes based on edge endpoints (ignoring edge overlap)"));
448
449 oc.doRegister("internal-junctions.vehicle-width", new Option_Float(1.8));
450 oc.addDescription("internal-junctions.vehicle-width", "Junctions",
451 TL("Assumed vehicle width for computing internal junction positions"));
452
453 oc.doRegister("rectangular-lane-cut", new Option_Bool(false));
454 oc.addDescription("rectangular-lane-cut", "Junctions", TL("Forces rectangular cuts between lanes and intersections"));
455
456 oc.doRegister("check-lane-foes.roundabout", new Option_Bool(true));
457 oc.addDescription("check-lane-foes.roundabout", "Junctions",
458 TL("Allow driving onto a multi-lane road if there are foes on other lanes (at roundabouts)"));
459
460 oc.doRegister("check-lane-foes.all", new Option_Bool(false));
461 oc.addDescription("check-lane-foes.all", "Junctions",
462 TL("Allow driving onto a multi-lane road if there are foes on other lanes (everywhere)"));
463
464 oc.doRegister("sidewalks.guess", new Option_Bool(false));
465 oc.addDescription("sidewalks.guess", "Pedestrian",
466 TL("Guess pedestrian sidewalks based on edge speed"));
467
468 oc.doRegister("sidewalks.guess.max-speed", new Option_Float((double) 13.89));
469 oc.addDescription("sidewalks.guess.max-speed", "Pedestrian",
470 TL("Add sidewalks for edges with a speed equal or below the given limit"));
471
472 oc.doRegister("sidewalks.guess.min-speed", new Option_Float((double) 5.8));
473 oc.addDescription("sidewalks.guess.min-speed", "Pedestrian",
474 TL("Add sidewalks for edges with a speed above the given limit"));
475
476 oc.doRegister("sidewalks.guess.from-permissions", new Option_Bool(false));
477 oc.addDescription("sidewalks.guess.from-permissions", "Pedestrian",
478 TL("Add sidewalks for edges that allow pedestrians on any of their lanes regardless of speed"));
479
480 oc.doRegister("sidewalks.guess.exclude", new Option_StringVector());
481 oc.addDescription("sidewalks.guess.exclude", "Pedestrian",
482 TL("Do not guess sidewalks for the given list of edges"));
483
484 oc.doRegister("bikelanes.guess", new Option_Bool(false));
485 oc.addDescription("bikelanes.guess", "Bicycle",
486 TL("Guess bike lanes based on edge speed"));
487
488 oc.doRegister("bikelanes.guess.max-speed", new Option_Float((double) 22.22));
489 oc.addDescription("bikelanes.guess.max-speed", "Bicycle",
490 TL("Add bike lanes for edges with a speed equal or below the given limit"));
491
492 oc.doRegister("bikelanes.guess.min-speed", new Option_Float((double) 5.8));
493 oc.addDescription("bikelanes.guess.min-speed", "Bicycle",
494 TL("Add bike lanes for edges with a speed above the given limit"));
495
496 oc.doRegister("bikelanes.guess.from-permissions", new Option_Bool(false));
497 oc.addDescription("bikelanes.guess.from-permissions", "Bicycle",
498 TL("Add bike lanes for edges that allow bicycles on any of their lanes regardless of speed"));
499
500 oc.doRegister("bikelanes.guess.exclude", new Option_StringVector());
501 oc.addDescription("bikelanes.guess.exclude", "Bicycle",
502 TL("Do not guess bikelanes for the given list of edges"));
503
504 oc.doRegister("crossings.guess", new Option_Bool(false));
505 oc.addDescription("crossings.guess", "Pedestrian",
506 TL("Guess pedestrian crossings based on the presence of sidewalks"));
507
508 oc.doRegister("crossings.guess.speed-threshold", new Option_Float(13.89));
509 oc.addDescription("crossings.guess.speed-threshold", "Pedestrian",
510 TL("At uncontrolled nodes, do not build crossings across edges with a speed above the threshold"));
511
512 oc.doRegister("crossings.guess.roundabout-priority", new Option_Bool(true));
513 oc.addDescription("crossings.guess.roundabout-priority", "Pedestrian",
514 TL("Give priority to guessed crossings at roundabouts"));
515
516 oc.doRegister("walkingareas", new Option_Bool(false));
517 oc.addDescription("walkingareas", "Pedestrian", TL("Always build walking areas even if there are no crossings"));
518
519 oc.doRegister("walkingareas.join-dist", new Option_Float(15));
520 oc.addDescription("walkingareas.join-dist", "Pedestrian", TL("Do not create a walkingarea between sidewalks that are connected by a pedestrian junction within FLOAT"));
521
522 // tls setting options
523 // explicit tls
524 oc.doRegister("tls.set", new Option_StringVector());
525 oc.addSynonyme("tls.set", "explicite-tls", true);
526 oc.addDescription("tls.set", "TLS Building", TL("Interprets STR[] as list of junctions to be controlled by TLS"));
527
528 oc.doRegister("tls.unset", new Option_StringVector());
529 oc.addSynonyme("tls.unset", "explicite-no-tls", true);
530 oc.addDescription("tls.unset", "TLS Building", TL("Interprets STR[] as list of junctions to be not controlled by TLS"));
531
532 // tls-guessing
533 oc.doRegister("tls.guess", new Option_Bool(false));
534 oc.addSynonyme("tls.guess", "guess-tls", true);
535 oc.addDescription("tls.guess", "TLS Building", TL("Turns on TLS guessing"));
536
537 oc.doRegister("tls.guess.threshold", new Option_Float(250 / 3.6));
538 oc.addDescription("tls.guess.threshold", "TLS Building", TL("Sets minimum value for the sum of all incoming lane speeds when guessing TLS"));
539
540 if (!forNetgen) {
541 oc.doRegister("tls.taz-nodes", new Option_Bool(false));
542 oc.addSynonyme("tls.taz-nodes", "tls-guess.district-nodes", true);
543 oc.addDescription("tls.taz-nodes", "TLS Building", TL("Sets district nodes as tls-controlled")); // !!! describe
544 }
545
546 oc.doRegister("tls.guess.joining", new Option_Bool(false));
547 oc.addSynonyme("tls.guess.joining", "tls-guess.joining", true);
548 oc.addDescription("tls.guess.joining", "TLS Building", TL("Includes node clusters into guess")); // !!! describe
549
550 oc.doRegister("tls.join", new Option_Bool(false));
551 oc.addSynonyme("tls.join", "try-join-tls", true);
552 oc.addDescription("tls.join", "TLS Building", TL("Tries to cluster tls-controlled nodes")); // !!! describe
553
554 oc.doRegister("tls.join-dist", new Option_Float(20));
555 oc.addDescription("tls.join-dist", "TLS Building",
556 TL("Determines the maximal distance for joining traffic lights (defaults to 20)"));
557
558 oc.doRegister("tls.join-exclude", new Option_StringVector());
559 oc.addDescription("tls.join-exclude", "TLS Building", TL("Interprets STR[] as list of tls ids to exclude from joining"));
560
561 oc.doRegister("tls.uncontrolled-within", new Option_Bool(false));
562 oc.addDescription("tls.uncontrolled-within", "TLS Building",
563 TL("Do not control edges that lie fully within a joined traffic light. This may cause collisions but allows old traffic light plans to be used"));
564
565 oc.doRegister("tls.ignore-internal-junction-jam", new Option_Bool(false));
566 oc.addDescription("tls.ignore-internal-junction-jam", "TLS Building",
567 TL("Do not build mutually conflicting response matrix, potentially ignoring vehicles that are stuck at an internal junction when their phase has ended"));
568
569 if (!forNetgen) {
570 oc.doRegister("tls.guess-signals", new Option_Bool(false));
571 oc.addDescription("tls.guess-signals", "TLS Building", TL("Interprets tls nodes surrounding an intersection as signal positions for a larger TLS. This is typical pattern for OSM-derived networks"));
572
573 oc.doRegister("tls.guess-signals.dist", new Option_Float(25));
574 oc.addDescription("tls.guess-signals.dist", "TLS Building", TL("Distance for interpreting nodes as signal locations"));
575
576 oc.doRegister("tls.guess-signals.slack", new Option_Integer(0));
577 oc.addDescription("tls.guess-signals.slack", "TLS Building", TL("Number of uncontrolled entry edges to accept and still consider the central node as a traffic light"));
578 }
579
580
581 // computational
582 oc.doRegister("tls.cycle.time", new Option_Integer(90));
583 oc.addDescription("tls.cycle.time", "TLS Building", TL("Use INT as cycle duration"));
584
585 oc.doRegister("tls.green.time", new Option_Integer(31));
586 oc.addSynonyme("tls.green.time", "traffic-light-green", true);
587 oc.addDescription("tls.green.time", "TLS Building", TL("Use INT as green phase duration"));
588
589 oc.doRegister("tls.yellow.min-decel", 'D', new Option_Float(3.0));
590 oc.addSynonyme("tls.yellow.min-decel", "min-decel", true);
591 oc.addDescription("tls.yellow.min-decel", "TLS Building", TL("Defines smallest vehicle deceleration"));
592
593 oc.doRegister("tls.yellow.patch-small", new Option_Bool(false));
594 oc.addSynonyme("tls.yellow.patch-small", "patch-small-tyellow", true);
595 oc.addDescription("tls.yellow.patch-small", "TLS Building", TL("Given yellow times are patched even if being too short"));
596
597 oc.doRegister("tls.yellow.time", new Option_Integer(-1));
598 oc.addSynonyme("tls.yellow.time", "traffic-light-yellow", true);
599 oc.addDescription("tls.yellow.time", "TLS Building", TL("Set INT as fixed time for yellow phase durations"));
600
601 oc.doRegister("tls.red.time", new Option_Integer(5));
602 oc.addDescription("tls.red.time", "TLS Building", TL("Set INT as fixed time for red phase duration at traffic lights that do not have a conflicting flow"));
603
604 oc.doRegister("tls.allred.time", new Option_Integer(0));
605 oc.addDescription("tls.allred.time", "TLS Building", TL("Set INT as fixed time for intermediate red phase after every switch"));
606
607 oc.doRegister("tls.minor-left.max-speed", new Option_Float(19.44)); // 70km/h
608 oc.addDescription("tls.minor-left.max-speed", "TLS Building", TL("Use FLOAT as threshold for allowing left-turning vehicles to move in the same phase as oncoming straight-going vehicles"));
609
610 oc.doRegister("tls.left-green.time", new Option_Integer(6));
611 oc.addDescription("tls.left-green.time", "TLS Building", TL("Use INT as green phase duration for left turns (s). Setting this value to 0 disables additional left-turning phases"));
612
613 oc.doRegister("tls.nema.vehExt", new Option_Integer(2));
614 oc.addDescription("tls.nema.vehExt", "TLS Building", TL("Set INT as fixed time for intermediate vehext phase after every switch"));
615
616 oc.doRegister("tls.nema.yellow", new Option_Integer(3));
617 oc.addDescription("tls.nema.yellow", "TLS Building", TL("Set INT as fixed time for intermediate NEMA yellow phase after every switch"));
618
619 oc.doRegister("tls.nema.red", new Option_Integer(2));
620 oc.addDescription("tls.nema.red", "TLS Building", TL("Set INT as fixed time for intermediate NEMA red phase after every switch"));
621
622 oc.doRegister("tls.crossing-min.time", new Option_Integer(4));
623 oc.addDescription("tls.crossing-min.time", "TLS Building", TL("Use INT as minimum green duration for pedestrian crossings (s)."));
624
625 oc.doRegister("tls.crossing-clearance.time", new Option_Integer(5));
626 oc.addDescription("tls.crossing-clearance.time", "TLS Building", TL("Use INT as clearance time for pedestrian crossings (s)."));
627
628 oc.doRegister("tls.scramble.time", new Option_Integer(5));
629 oc.addDescription("tls.scramble.time", "TLS Building", TL("Use INT as green phase duration for pedestrian scramble phase (s)."));
630
631 // tls-shifts
632 oc.doRegister("tls.half-offset", new Option_StringVector());
633 oc.addSynonyme("tls.half-offset", "tl-logics.half-offset", true);
634 oc.addDescription("tls.half-offset", "TLS Building", TL("TLSs in STR[] will be shifted by half-phase"));
635
636 oc.doRegister("tls.quarter-offset", new Option_StringVector());
637 oc.addSynonyme("tls.quarter-offset", "tl-logics.quarter-offset", true);
638 oc.addDescription("tls.quarter-offset", "TLS Building", TL("TLSs in STR[] will be shifted by quarter-phase"));
639
640 // tls type
641 oc.doRegister("tls.default-type", new Option_String("static"));
642 oc.addDescription("tls.default-type", "TLS Building", TL("TLSs with unspecified type will use STR as their algorithm"));
643
644 oc.doRegister("tls.layout", new Option_String("opposites"));
645 oc.addDescription("tls.layout", "TLS Building", TL("Set phase layout four grouping opposite directions or grouping all movements for one incoming edge ['opposites', 'incoming']"));
646
647 oc.doRegister("tls.no-mixed", new Option_Bool(false));
648 oc.addDescription("tls.no-mixed", "TLS Building", TL("Avoid phases with green and red signals for different connections from the same lane"));
649
650 oc.doRegister("tls.min-dur", new Option_Integer(5));
651 oc.addDescription("tls.min-dur", "TLS Building", TL("Default minimum phase duration for traffic lights with variable phase length"));
652
653 oc.doRegister("tls.max-dur", new Option_Integer(50));
654 oc.addDescription("tls.max-dur", "TLS Building", TL("Default maximum phase duration for traffic lights with variable phase length"));
655
656 oc.doRegister("tls.group-signals", new Option_Bool(false));
657 oc.addDescription("tls.group-signals", "TLS Building", TL("Assign the same tls link index to connections that share the same states"));
658
659 oc.doRegister("tls.ungroup-signals", new Option_Bool(false));
660 oc.addDescription("tls.ungroup-signals", "TLS Building", TL("Assign a distinct tls link index to every connection"));
661
662 oc.doRegister("tls.rebuild", new Option_Bool(false));
663 oc.addDescription("tls.rebuild", "TLS Building", TL("rebuild all traffic light plans in the network"));
664
665 // edge pruning
666 oc.doRegister("keep-edges.min-speed", new Option_Float(-1));
667 oc.addSynonyme("keep-edges.min-speed", "edges-min-speed", true);
668 oc.addDescription("keep-edges.min-speed", "Edge Removal", TL("Only keep edges with speed in meters/second > FLOAT"));
669
670 oc.doRegister("remove-edges.explicit", new Option_StringVector());
671 oc.addSynonyme("remove-edges.explicit", "remove-edges");
672 oc.addDescription("remove-edges.explicit", "Edge Removal", TL("Remove edges in STR[]"));
673
674 oc.doRegister("keep-edges.explicit", new Option_StringVector());
675 oc.addSynonyme("keep-edges.explicit", "keep-edges");
676 oc.addDescription("keep-edges.explicit", "Edge Removal", TL("Only keep edges in STR[] or those which are kept due to other keep-edges or remove-edges options"));
677
678 oc.doRegister("keep-edges.input-file", new Option_FileName());
679 oc.addDescription("keep-edges.input-file", "Edge Removal", TL("Only keep edges in FILE (Each id on a single line. Selection files from sumo-gui are also supported) or those which are kept due to other keep-edges or remove-edges options"));
680
681 oc.doRegister("remove-edges.input-file", new Option_FileName());
682 oc.addDescription("remove-edges.input-file", "Edge Removal", TL("Remove edges in FILE. (Each id on a single line. Selection files from sumo-gui are also supported)"));
683
684 if (!forNetgen) {
685 oc.doRegister("keep-edges.postload", new Option_Bool(false));
686 oc.addDescription("keep-edges.postload", "Edge Removal", TL("Remove edges after loading, patching and joining"));
687 }
688
689 oc.doRegister("keep-edges.in-boundary", new Option_StringVector());
690 oc.addDescription("keep-edges.in-boundary", "Edge Removal", TL("Only keep edges which are located within the given boundary (given either as CARTESIAN corner coordinates <xmin,ymin,xmax,ymax> or as polygon <x0,y0,x1,y1,...>)"));
691
692 oc.doRegister("keep-edges.in-geo-boundary", new Option_StringVector());
693 oc.addDescription("keep-edges.in-geo-boundary", "Edge Removal", TL("Only keep edges which are located within the given boundary (given either as GEODETIC corner coordinates <lon-min,lat-min,lon-max,lat-max> or as polygon <lon0,lat0,lon1,lat1,...>)"));
694
695 if (!forNetgen) {
696 oc.doRegister("keep-edges.by-vclass", new Option_StringVector());
697 oc.addDescription("keep-edges.by-vclass", "Edge Removal", TL("Only keep edges which allow one of the vclasses in STR[]"));
698
699 oc.doRegister("remove-edges.by-vclass", new Option_StringVector());
700 oc.addDescription("remove-edges.by-vclass", "Edge Removal", TL("Remove edges which allow only vclasses from STR[]"));
701
702 oc.doRegister("keep-edges.by-type", new Option_StringVector());
703 oc.addDescription("keep-edges.by-type", "Edge Removal", TL("Only keep edges where type is in STR[]"));
704
705 oc.doRegister("keep-edges.components", new Option_Integer(0));
706 oc.addDescription("keep-edges.components", "Edge Removal", TL("Only keep the INT largest weakly connected components"));
707
708 oc.doRegister("remove-edges.by-type", new Option_StringVector());
709 oc.addDescription("remove-edges.by-type", "Edge Removal", TL("Remove edges where type is in STR[]"));
710
711 oc.doRegister("remove-edges.isolated", new Option_Bool(false));
712 oc.addSynonyme("remove-edges.isolated", "remove-isolated", true);
713 oc.addDescription("remove-edges.isolated", "Edge Removal", TL("Removes isolated edges"));
714 }
715
716 oc.doRegister("keep-lanes.min-width", new Option_Float(0.01));
717 oc.addDescription("keep-lanes.min-width", "Edge Removal", TL("Only keep lanes with width in meters > FLOAT"));
718
719
720 // unregulated nodes options
721 oc.doRegister("keep-nodes-unregulated", new Option_Bool(false));
722 oc.addSynonyme("keep-nodes-unregulated", "keep-unregulated");
723 oc.addDescription("keep-nodes-unregulated", "Unregulated Nodes", TL("All nodes will be unregulated"));
724
725 oc.doRegister("keep-nodes-unregulated.explicit", new Option_StringVector());
726 oc.addSynonyme("keep-nodes-unregulated.explicit", "keep-unregulated.explicit");
727 oc.addSynonyme("keep-nodes-unregulated.explicit", "keep-unregulated.nodes", true);
728 oc.addDescription("keep-nodes-unregulated.explicit", "Unregulated Nodes", TL("Do not regulate nodes in STR[]"));
729
730 oc.doRegister("keep-nodes-unregulated.district-nodes", new Option_Bool(false));
731 oc.addSynonyme("keep-nodes-unregulated.district-nodes", "keep-unregulated.district-nodes");
732 oc.addDescription("keep-nodes-unregulated.district-nodes", "Unregulated Nodes", TL("Do not regulate district nodes"));
733
734 // ramp guessing options
735 if (!forNetgen) {
736 oc.doRegister("ramps.guess", new Option_Bool(false));
737 oc.addSynonyme("ramps.guess", "guess-ramps", true);
738 oc.addDescription("ramps.guess", "Ramp Guessing", TL("Enable ramp-guessing"));
739
740 oc.doRegister("ramps.guess-acceleration-lanes", new Option_Bool(true));
741 oc.addDescription("ramps.guess-acceleration-lanes", "Ramp Guessing", TL("Guess on-ramps and mark acceleration lanes if they exist but do not add new lanes"));
742
743 oc.doRegister("ramps.max-ramp-speed", new Option_Float(-1));
744 oc.addSynonyme("ramps.max-ramp-speed", "ramp-guess.max-ramp-speed", true);
745 oc.addDescription("ramps.max-ramp-speed", "Ramp Guessing", TL("Treat edges with speed > FLOAT as no ramps"));
746
747 oc.doRegister("ramps.min-highway-speed", new Option_Float((double)(79 / 3.6)));
748 oc.addSynonyme("ramps.min-highway-speed", "ramp-guess.min-highway-speed", true);
749 oc.addDescription("ramps.min-highway-speed", "Ramp Guessing", TL("Treat edges with speed < FLOAT as no highways"));
750
751 oc.doRegister("ramps.ramp-length", new Option_Float(100));
752 oc.addSynonyme("ramps.ramp-length", "ramp-guess.ramp-length", true);
753 oc.addDescription("ramps.ramp-length", "Ramp Guessing", TL("Use FLOAT as ramp-length"));
754
755 //The Weaving Length Limit for Short Free Onramps, Chiu Liu, Zhongren WangPhD even suggest 70m
756 oc.doRegister("ramps.min-weave-length", new Option_Float(50));
757 oc.addDescription("ramps.min-weave-length", "Ramp Guessing", TL("Use FLOAT as minimum ramp-length"));
758
759 oc.doRegister("ramps.set", new Option_StringVector());
760 oc.addSynonyme("ramps.set", "ramp-guess.explicite", true);
761 oc.addDescription("ramps.set", "Ramp Guessing", TL("Tries to handle the given edges as ramps"));
762
763 oc.doRegister("ramps.unset", new Option_StringVector());
764 oc.addDescription("ramps.unset", "Ramp Guessing", TL("Do not consider the given edges as ramps"));
765
766 oc.doRegister("ramps.no-split", new Option_Bool(false));
767 oc.addSynonyme("ramps.no-split", "ramp-guess.no-split", true);
768 oc.addDescription("ramps.no-split", "Ramp Guessing", TL("Avoids edge splitting"));
769 }
770}
771
772
773bool
774NBFrame::checkOptions(OptionsCont& oc) {
775 bool ok = true;
776 //
777 if (!SUMOXMLDefinitions::TrafficLightTypes.hasString(oc.getString("tls.default-type"))) {
778 WRITE_ERRORF(TL("unsupported value '%' for option '--tls.default-type'"), oc.getString("tls.default-type"));
779 ok = false;
780 }
781 if (oc.isSet("keep-edges.in-boundary") && oc.isSet("keep-edges.in-geo-boundary")) {
782 WRITE_ERROR(TL("only one of the options 'keep-edges.in-boundary' or 'keep-edges.in-geo-boundary' may be given"));
783 ok = false;
784 }
785 if (oc.getBool("no-internal-links") && oc.getBool("crossings.guess")) {
786 WRITE_ERROR(TL("only one of the options 'no-internal-links' or 'crossings.guess' may be given"));
787 ok = false;
788 }
789 if (oc.getBool("no-internal-links") && oc.getBool("walkingareas")) {
790 WRITE_ERROR(TL("only one of the options 'no-internal-links' or 'walkareas' may be given"));
791 ok = false;
792 }
793 if (!oc.isDefault("tls.green.time") && !oc.isDefault("tls.cycle.time")) {
794 WRITE_ERROR(TL("only one of the options 'tls.green.time' or 'tls.cycle.time' may be given"));
795 ok = false;
796 }
797 if (oc.getInt("tls.green.time") <= 0) {
798 WRITE_ERROR(TL("'tls.green.time' must be positive"));
799 ok = false;
800 }
801 if (oc.getInt("default.lanenumber") < 1) {
802 WRITE_ERROR(TL("default.lanenumber must be at least 1"));
803 ok = false;
804 }
805 if (!oc.isDefault("default.lanewidth") && oc.getFloat("default.lanewidth") < POSITION_EPS) {
806 WRITE_ERROR("default.lanewidth must be at least " + toString(POSITION_EPS));
807 ok = false;
808 }
809 if (!oc.isDefault("default.disallow") && !oc.isDefault("default.allow")) {
810 WRITE_ERROR(TL("only one of the options 'default.disallow' or 'default.allow' may be given"));
811 ok = false;
812 }
813 if (oc.getInt("junctions.internal-link-detail") < 2) {
814 WRITE_ERROR(TL("junctions.internal-link-detail must >= 2"));
815 ok = false;
816 }
817 if (oc.getFloat("junctions.scurve-stretch") > 0) {
818 if (oc.getBool("no-internal-links")) {
819 WRITE_WARNING(TL("Option 'junctions.scurve-stretch' requires internal lanes to work. Option '--no-internal-links' will be disabled."));
820 }
821 // make sure the option is set so heuristics cannot ignore it
822 oc.set("no-internal-links", "false");
823 }
824 if (oc.getFloat("junctions.small-radius") > oc.getFloat("default.junctions.radius") && oc.getFloat("default.junctions.radius") >= 0) {
825 if (!oc.isDefault("junctions.small-radius")) {
826 WRITE_WARNING(TL("option 'default.junctions.radius' is smaller than option 'junctions.small-radius'"));
827 } else {
828 oc.setDefault("junctions.small-radius", oc.getValueString("default.junctions.radius"));
829 }
830 }
831 if (oc.getString("tls.layout") != "opposites"
832 && oc.getString("tls.layout") != "incoming"
833 && oc.getString("tls.layout") != "alternateOneWay") {
834 WRITE_ERROR(TL("tls.layout must be 'opposites', 'incoming' or 'alternateOneWay'"));
835 ok = false;
836 }
837 if (!oc.isDefault("default.right-of-way") &&
838 !SUMOXMLDefinitions::RightOfWayValues.hasString(oc.getString("default.right-of-way"))) {
839 WRITE_ERRORF(TL("default.right-of-way must be one of '%'"), toString(SUMOXMLDefinitions::RightOfWayValues.getStrings()));
840 ok = false;
841 }
842 if (oc.getFloat("roundabouts.visibility-distance") < 0 && oc.getFloat("roundabouts.visibility-distance") != NBEdge::UNSPECIFIED_VISIBILITY_DISTANCE) {
843 WRITE_ERROR(TL("roundabouts.visibility-distance must be positive or -1"));
844 ok = false;
845 }
846 if (oc.isDefault("railway.topology.repair") && oc.getBool("railway.topology.repair.connect-straight")) {
847 oc.setDefault("railway.topology.repair", "true");
848 }
849 if (oc.isDefault("railway.topology.repair") && oc.getBool("railway.topology.repair.minimal")) {
850 oc.setDefault("railway.topology.repair", "true");
851 }
852 if (oc.isDefault("railway.topology.all-bidi") && !oc.isDefault("railway.topology.all-bidi.input-file")) {
853 oc.setDefault("railway.topology.all-bidi", "true");
854 }
855 if (oc.isDefault("railway.topology.repair.stop-turn") && !oc.isDefault("railway.topology.repair")) {
856 oc.setDefault("railway.topology.repair.stop-turn", "true");
857 }
858 if (!SUMOXMLDefinitions::LaneSpreadFunctions.hasString(oc.getString("default.spreadtype"))) {
859 WRITE_ERRORF(TL("Unknown value for default.spreadtype '%'."), oc.getString("default.spreadtype"));
860 ok = false;
861 }
862 // check whether the junction type to use is properly set
863 if (oc.isSet("default.junctions.type")) {
864 std::string type = oc.getString("default.junctions.type");
865 if (type != toString(SumoXMLNodeType::TRAFFIC_LIGHT) &&
866 type != toString(SumoXMLNodeType::TRAFFIC_LIGHT_NOJUNCTION) &&
867 type != toString(SumoXMLNodeType::TRAFFIC_LIGHT_RIGHT_ON_RED) &&
868 type != toString(SumoXMLNodeType::PRIORITY) &&
869 type != toString(SumoXMLNodeType::PRIORITY_STOP) &&
870 type != toString(SumoXMLNodeType::ALLWAY_STOP) &&
871 type != toString(SumoXMLNodeType::ZIPPER) &&
872 type != toString(SumoXMLNodeType::NOJUNCTION) &&
873 type != toString(SumoXMLNodeType::RAIL_SIGNAL) &&
874 type != toString(SumoXMLNodeType::RAIL_CROSSING) &&
875 type != toString(SumoXMLNodeType::LEFT_BEFORE_RIGHT) &&
876 type != toString(SumoXMLNodeType::RIGHT_BEFORE_LEFT) &&
877 type != toString(SumoXMLNodeType::NOJUNCTION) &&
878 type != toString(SumoXMLNodeType::UNKNOWN)) {
879 WRITE_ERROR("Only the following junction types are known: " +
880 toString(SumoXMLNodeType::TRAFFIC_LIGHT) + ", " +
881 toString(SumoXMLNodeType::TRAFFIC_LIGHT_NOJUNCTION) + ", " +
882 toString(SumoXMLNodeType::TRAFFIC_LIGHT_RIGHT_ON_RED) + ", " +
883 toString(SumoXMLNodeType::PRIORITY) + ", " +
884 toString(SumoXMLNodeType::PRIORITY_STOP) + ", " +
885 toString(SumoXMLNodeType::ALLWAY_STOP) + ", " +
886 toString(SumoXMLNodeType::ZIPPER) + ", " +
887 toString(SumoXMLNodeType::NOJUNCTION) + ", " +
888 toString(SumoXMLNodeType::RAIL_SIGNAL) + ", " +
889 toString(SumoXMLNodeType::RAIL_CROSSING) + ", " +
890 toString(SumoXMLNodeType::LEFT_BEFORE_RIGHT) + ", " +
891 toString(SumoXMLNodeType::RIGHT_BEFORE_LEFT) + ", " +
892 toString(SumoXMLNodeType::UNKNOWN));
893 ok = false;
894 }
895 }
896 return ok;
897}
898
899/****************************************************************************/
WRITE_ERRORF
#define WRITE_ERRORF(...)
Definition MsgHandler.h:296
WRITE_ERROR
#define WRITE_ERROR(msg)
Definition MsgHandler.h:295
WRITE_WARNING
#define WRITE_WARNING(msg)
Definition MsgHandler.h:286
TL
#define TL(string)
Definition MsgHandler.h:304
toString
std::string toString(const T &t, std::streamsize accuracy=gPrecision)
Definition ToString.h:49
NBEdge::UNSPECIFIED_FRICTION
static const double UNSPECIFIED_FRICTION
unspecified lane friction
Definition NBEdge.h:355
NBEdge::UNSPECIFIED_LOADED_LENGTH
static const double UNSPECIFIED_LOADED_LENGTH
no length override given
Definition NBEdge.h:364
NBEdge::UNSPECIFIED_CONTPOS
static const double UNSPECIFIED_CONTPOS
unspecified internal junction position
Definition NBEdge.h:358
NBEdge::UNSPECIFIED_VISIBILITY_DISTANCE
static const double UNSPECIFIED_VISIBILITY_DISTANCE
unspecified foe visibility for connections
Definition NBEdge.h:361
NBEdge::UNSPECIFIED_WIDTH
static const double UNSPECIFIED_WIDTH
unspecified lane width
Definition NBEdge.h:346
NBFrame::fillOptions
static void fillOptions(OptionsCont &oc, bool forNetgen)
Inserts options used by the network converter.
Definition NBFrame.cpp:48
NBFrame::checkOptions
static bool checkOptions(OptionsCont &oc)
Checks set options from the OptionsCont-singleton for being valid.
Definition NBFrame.cpp:774
Option_Bool
Definition Option.h:558
Option_FileName
Definition Option.h:713
Option_Float
Definition Option.h:505
Option_Integer
Definition Option.h:405
Option_String
Definition Option.h:458
Option_StringVector
Definition Option.h:666
OptionsCont
A storage for options typed value containers)
Definition OptionsCont.h:89
OptionsCont::addDescription
void addDescription(const std::string &name, const std::string &subtopic, const std::string &description)
Adds a description for an option.
Definition OptionsCont.cpp:514
OptionsCont::isSet
bool isSet(const std::string &name, bool failOnNonExistant=true) const
Returns the information whether the named option is set.
Definition OptionsCont.cpp:149
OptionsCont::getFloat
double getFloat(const std::string &name) const
Returns the double-value of the named option (only for Option_Float)
Definition OptionsCont.cpp:215
OptionsCont::getInt
int getInt(const std::string &name) const
Returns the int-value of the named option (only for Option_Integer)
Definition OptionsCont.cpp:222
OptionsCont::getString
std::string getString(const std::string &name) const
Returns the string-value of the named option (only for Option_String)
Definition OptionsCont.cpp:208
OptionsCont::addSynonyme
void addSynonyme(const std::string &name1, const std::string &name2, bool isDeprecated=false)
Adds a synonyme for an options name (any order)
Definition OptionsCont.cpp:109
OptionsCont::isDefault
bool isDefault(const std::string &name) const
Returns the information whether the named option has still the default value.
Definition OptionsCont.cpp:163
OptionsCont::setDefault
bool setDefault(const std::string &name, const std::string &value)
Sets the given value for the named option as new default value.
Definition OptionsCont.cpp:269
OptionsCont::doRegister
void doRegister(const std::string &name, Option *o)
Adds an option under the given name.
Definition OptionsCont.cpp:77
OptionsCont::set
bool set(const std::string &name, const std::string &value, const bool append=false)
Sets the given value for the named option.
Definition OptionsCont.cpp:249
OptionsCont::getBool
bool getBool(const std::string &name) const
Returns the boolean-value of the named option (only for Option_Bool)
Definition OptionsCont.cpp:229
OptionsCont::getValueString
std::string getValueString(const std::string &name) const
Returns the string-value of the named option (all options)
Definition OptionsCont.cpp:201
SUMOXMLDefinitions::LaneSpreadFunctions
static StringBijection< LaneSpreadFunction > LaneSpreadFunctions
lane spread functions
Definition SUMOXMLDefinitions.h:2510
SUMOXMLDefinitions::TrafficLightTypes
static StringBijection< TrafficLightType > TrafficLightTypes
traffic light types
Definition SUMOXMLDefinitions.h:2537
SUMOXMLDefinitions::RightOfWayValues
static StringBijection< RightOfWay > RightOfWayValues
righ of way algorithms
Definition SUMOXMLDefinitions.h:2519
StringBijection::hasString
bool hasString(const std::string &str) const
check if the given string exist
Definition StringBijection.h:114