 |
Eclipse SUMO - Simulation of Urban MObility
|
Go to the documentation of this file.
53 oc.
addSynonyme(
"default.lanenumber",
"lanenumber",
true);
54 oc.
addDescription(
"default.lanenumber",
"Building Defaults",
"The default number of lanes in an edge");
57 oc.
addSynonyme(
"default.lanewidth",
"lanewidth",
true);
58 oc.
addDescription(
"default.lanewidth",
"Building Defaults",
"The default width of lanes");
62 oc.
addDescription(
"default.speed",
"Building Defaults",
"The default speed on an edge (in m/s)");
65 oc.
addSynonyme(
"default.priority",
"priority",
true);
66 oc.
addDescription(
"default.priority",
"Building Defaults",
"The default priority of an edge");
69 oc.
addDescription(
"default.sidewalk-width",
"Building Defaults",
"The default width of added sidewalks");
72 oc.
addDescription(
"default.bikelane-width",
"Building Defaults",
"The default width of added bike lanes");
75 oc.
addDescription(
"default.crossing-width",
"Building Defaults",
"The default width of a pedestrian crossing");
78 oc.
addDescription(
"default.disallow",
"Building Defaults",
"The default for disallowed vehicle classes");
81 oc.
addDescription(
"default.junctions.keep-clear",
"Building Defaults",
"Whether junctions should be kept clear by default");
84 oc.
addDescription(
"default.junctions.radius",
"Building Defaults",
"The default turning radius of intersections");
87 oc.
addDescription(
"default.right-of-way",
"Building Defaults",
"The default algorithm for computing right of way rules ('default', 'edgePriority')");
90 oc.
addDescription(
"junctions.right-before-left.speed-threshold",
"Junctions",
"Allow building right-before-left junctions when the incoming edge speeds are below FLOAT (m/s)");
94 oc.
addDescription(
"no-internal-links",
"Junctions",
"Omits internal links");
97 oc.
addDescription(
"numerical-ids",
"Processing",
"Remaps alphanumerical IDs of nodes and edges to ensure that all IDs are integers");
101 oc.
addDescription(
"reserved-ids",
"Processing",
"Ensures that generated ids do not included any of the typed IDs from FILE (SUMO-GUI selection file format)");
105 oc.
addDescription(
"dismiss-vclasses",
"Processing",
"Removes vehicle class restrictions from imported edges");
109 oc.
addDescription(
"no-turnarounds",
"Junctions",
"Disables building turnarounds");
112 oc.
addSynonyme(
"no-turnarounds.tls",
"no-tls-turnarounds",
true);
113 oc.
addDescription(
"no-turnarounds.tls",
"Junctions",
"Disables building turnarounds at tls-controlled junctions");
116 oc.
addDescription(
"no-turnarounds.geometry",
"Junctions",
"Disables building turnarounds at geometry-like junctions");
119 oc.
addDescription(
"no-turnarounds.except-deadend",
"Junctions",
"Disables building turnarounds except at dead end junctions");
122 oc.
addDescription(
"no-left-connections",
"Junctions",
"Disables building connections to left");
126 oc.
addSynonyme(
"geometry.split",
"split-geometry",
true);
127 oc.
addDescription(
"geometry.split",
"Processing",
"Splits edges across geometry nodes");
130 oc.
addSynonyme(
"geometry.remove",
"remove-geometry",
true);
131 oc.
addDescription(
"geometry.remove",
"Processing",
"Replace nodes which only define edge geometry by geometry points (joins edges)");
134 oc.
addDescription(
"geometry.remove.keep-edges.explicit",
"Processing",
"Ensure that the given list of edges is not modified");
137 oc.
addDescription(
"geometry.remove.keep-edges.input-file",
"Processing",
138 "Ensure that the edges in FILE are not modified (Each id on a single line. Selection files from SUMO-GUI are also supported)");
142 "Allow merging edges with differing attributes when their length is below min-length");
145 oc.
addDescription(
"geometry.remove.width-tolerance",
"Processing",
146 "Allow merging edges with differing lane widths if the difference is below FLOAT");
149 oc.
addDescription(
"geometry.max-segment-length",
"Processing",
"splits geometry to restrict segment length");
152 oc.
addDescription(
"geometry.min-dist",
"Processing",
"reduces too similar geometry points");
155 oc.
addDescription(
"geometry.max-angle",
"Processing",
"Warn about edge geometries with an angle above DEGREES in successive segments");
158 oc.
addDescription(
"geometry.min-radius",
"Processing",
"Warn about edge geometries with a turning radius less than METERS at the start or end");
161 oc.
addDescription(
"geometry.min-radius.fix",
"Processing",
"Straighten edge geometries to avoid turning radii less than geometry.min-radius");
164 oc.
addDescription(
"geometry.junction-mismatch-threshold",
"Processing",
"Warn if the junction shape is to far away from the original node position");
167 oc.
addDescription(
"geometry.check-overlap",
"Processing",
"Warn if edges overlap by more than the given threshold value");
170 oc.
addDescription(
"geometry.check-overlap.vertical-threshold",
"Processing",
"Ignore overlapping edges if they are separated vertically by the given threshold.");
173 oc.
addDescription(
"geometry.avoid-overlap",
"Processing",
"Modify edge geometries to avoid overlap at junctions");
176 oc.
addDescription(
"join-lanes",
"Processing",
"join adjacent lanes that have the same permissions and which do not admit lane-changing (sidewalks and disallowed lanes)");
181 oc.
addDescription(
"railway.topology.repair",
"Railway",
"Repair topology of the railway network");
184 oc.
addDescription(
"railway.topology.repair.connect-straight",
"Railway",
"Allow bidiretional rail use wherever rails with opposite directions meet at a straight angle");
187 oc.
addDescription(
"railway.topology.all-bidi",
"Railway",
"Make all rails usable in both direction");
190 oc.
addDescription(
"railway.access-distance",
"Railway",
"The search radius for finding suitable road accesses for rail stops");
191 oc.
addSynonyme(
"railway.access-distance",
"osm.stop-output.footway-access-distance",
true);
194 oc.
addDescription(
"railway.max-accesses",
"Railway",
"The maximum roud accesses registered per rail stops");
195 oc.
addSynonyme(
"railway.max-accesses",
"osm.stop-output.footway-max-accesses",
true);
198 oc.
addDescription(
"railway.access-factor",
"Railway",
"The walking length of the access is computed as air-line distance multiplied by FLOAT");
199 oc.
addSynonyme(
"railway.access-factor",
"osm.stop-output.footway-access-factor",
true);
203 oc.
addDescription(
"geometry.max-grade",
"Processing",
"Warn about edge geometries with a grade in % above FLOAT.");
206 oc.
addDescription(
"geometry.max-grade.fix",
"Processing",
"Smooth edge edge geometries with a grade in above the warning threshold.");
209 oc.
addSynonyme(
"offset.disable-normalization",
"disable-normalize-node-positions",
true);
210 oc.
addDescription(
"offset.disable-normalization",
"Processing",
"Turn off normalizing node positions");
213 oc.
addSynonyme(
"offset.x",
"x-offset-to-apply",
true);
214 oc.
addDescription(
"offset.x",
"Processing",
"Adds FLOAT to net x-positions");
217 oc.
addSynonyme(
"offset.y",
"y-offset-to-apply",
true);
218 oc.
addDescription(
"offset.y",
"Processing",
"Adds FLOAT to net y-positions");
222 oc.
addDescription(
"flip-y-axis",
"Processing",
"Flips the y-coordinate along zero");
225 oc.
addSynonyme(
"roundabouts.guess",
"guess-roundabouts",
true);
226 oc.
addDescription(
"roundabouts.guess",
"Processing",
"Enable roundabout-guessing");
229 oc.
addDescription(
"opposites.guess",
"Processing",
"Enable guessing of opposite direction lanes usable for overtaking");
232 oc.
addDescription(
"opposites.guess.fix-lengths",
"Processing",
"Ensure that opposite edges have the same length");
235 oc.
addDescription(
"lefthand",
"Processing",
"Assumes left-hand traffic on the network");
239 "Merges edges which connect the same nodes and are close to each other (recommended for VISSIM import)");
243 "Joins junctions that are close to each other (recommended for OSM import)");
247 "Determines the maximal distance for joining junctions (defaults to 10)");
251 oc.
addDescription(
"junctions.join-exclude",
"Junctions",
"Interprets STR as list of junctions to exclude from joining");
254 oc.
addDescription(
"speed.offset",
"Processing",
"Modifies all edge speeds by adding FLOAT");
257 oc.
addDescription(
"speed.factor",
"Processing",
"Modifies all edge speeds by multiplying by FLOAT");
260 oc.
addDescription(
"speed.minimum",
"Processing",
"Modifies all edge speeds to at least FLOAT");
264 oc.
addDescription(
"junctions.corner-detail",
"Junctions",
"Generate INT intermediate points to smooth out intersection corners");
267 oc.
addDescription(
"junctions.internal-link-detail",
"Junctions",
"Generate INT intermediate points to smooth out lanes within the intersection");
270 oc.
addDescription(
"junctions.scurve-stretch",
"Junctions",
"Generate longer intersections to allow for smooth s-curves when the number of lanes changes");
274 "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");
278 "Limits speed on junctions to an average lateral acceleration of at most FLOAT m/s^2)");
281 oc.
addDescription(
"junctions.limit-turn-speed.min-angle",
"Junctions",
282 "Do not limit turn speed for angular changes below FLOAT (degrees). The value is subtracted from the geometric angle before computing the turning radius.");
285 oc.
addDescription(
"junctions.limit-turn-speed.min-angle.railway",
"Junctions",
286 "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.");
289 oc.
addDescription(
"junctions.limit-turn-speed.warn.straight",
"Junctions",
290 "Warn about turn speed limits that reduce the speed of straight connections by more than FLOAT");
293 oc.
addDescription(
"junctions.limit-turn-speed.warn.turn",
"Junctions",
294 "Warn about turn speed limits that reduce the speed of turning connections (no u-turns) by more than FLOAT");
299 "Default radius for junctions that do not require wide vehicle turns");
302 oc.
addDescription(
"rectangular-lane-cut",
"Junctions",
"Forces rectangular cuts between lanes and intersections");
306 "Allow driving onto a multi-lane road if there are foes on other lanes (at roundabouts)");
310 "Allow driving onto a multi-lane road if there are foes on other lanes (everywhere)");
314 "Guess pedestrian sidewalks based on edge speed");
318 "Add sidewalks for edges with a speed equal or below the given limit");
322 "Add sidewalks for edges with a speed above the given limit");
325 oc.
addDescription(
"sidewalks.guess.from-permissions",
"Pedestrian",
326 "Add sidewalks for edges that allow pedestrians on any of their lanes regardless of speed");
330 "Do not guess sidewalks for the given list of edges");
334 "Guess bike lanes based on edge speed");
338 "Add bike lanes for edges with a speed equal or below the given limit");
342 "Add bike lanes for edges with a speed above the given limit");
346 "Add bike lanes for edges that allow bicycles on any of their lanes regardless of speed");
350 "Do not guess bikelanes for the given list of edges");
354 "Guess pedestrian crossings based on the presence of sidewalks");
357 oc.
addDescription(
"crossings.guess.speed-threshold",
"Pedestrian",
358 "At uncontrolled nodes, do not build crossings across edges with a speed above the threshold");
361 oc.
addDescription(
"walkingareas",
"Pedestrian",
"Always build walking areas even if there are no crossings");
367 oc.
addDescription(
"tls.set",
"TLS Building",
"Interprets STR as list of junctions to be controlled by TLS");
370 oc.
addSynonyme(
"tls.unset",
"explicite-no-tls",
true);
371 oc.
addDescription(
"tls.unset",
"TLS Building",
"Interprets STR as list of junctions to be not controlled by TLS");
376 oc.
addDescription(
"tls.guess",
"TLS Building",
"Turns on TLS guessing");
379 oc.
addDescription(
"tls.guess.threshold",
"TLS Building",
"Sets minimum value for the sum of all incoming lane speeds when guessing TLS");
383 oc.
addSynonyme(
"tls.taz-nodes",
"tls-guess.district-nodes",
true);
384 oc.
addDescription(
"tls.taz-nodes",
"TLS Building",
"Sets district nodes as tls-controlled");
388 oc.
addSynonyme(
"tls.guess.joining",
"tls-guess.joining",
true);
389 oc.
addDescription(
"tls.guess.joining",
"TLS Building",
"Includes node clusters into guess");
393 oc.
addDescription(
"tls.join",
"TLS Building",
"Tries to cluster tls-controlled nodes");
397 "Determines the maximal distance for joining traffic lights (defaults to 20)");
401 "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");
405 oc.
addDescription(
"tls.guess-signals",
"TLS Building",
"Interprets tls nodes surrounding an intersection as signal positions for a larger TLS. This is typical pattern for OSM-derived networks");
408 oc.
addDescription(
"tls.guess-signals.dist",
"TLS Building",
"Distance for interpreting nodes as signal locations");
414 oc.
addDescription(
"tls.cycle.time",
"TLS Building",
"Use INT as cycle duration");
417 oc.
addSynonyme(
"tls.green.time",
"traffic-light-green",
true);
418 oc.
addDescription(
"tls.green.time",
"TLS Building",
"Use INT as green phase duration");
421 oc.
addSynonyme(
"tls.yellow.min-decel",
"min-decel",
true);
422 oc.
addDescription(
"tls.yellow.min-decel",
"TLS Building",
"Defines smallest vehicle deceleration");
425 oc.
addSynonyme(
"tls.yellow.patch-small",
"patch-small-tyellow",
true);
426 oc.
addDescription(
"tls.yellow.patch-small",
"TLS Building",
"Given yellow times are patched even if being too short");
429 oc.
addSynonyme(
"tls.yellow.time",
"traffic-light-yellow",
true);
430 oc.
addDescription(
"tls.yellow.time",
"TLS Building",
"Set INT as fixed time for yellow phase durations");
433 oc.
addDescription(
"tls.red.time",
"TLS Building",
"Set INT as fixed time for red phase duration at traffic lights that do not have a conflicting flow");
436 oc.
addDescription(
"tls.allred.time",
"TLS Building",
"Set INT as fixed time for intermediate red phase after every switch");
439 oc.
addDescription(
"tls.minor-left.max-speed",
"TLS Building",
"Use FLOAT as threshold for allowing left-turning vehicles to move in the same phase as oncoming straight-going vehicles");
442 oc.
addDescription(
"tls.left-green.time",
"TLS Building",
"Use INT as green phase duration for left turns (s). Setting this value to 0 disables additional left-turning phases");
445 oc.
addDescription(
"tls.crossing-min.time",
"TLS Building",
"Use INT as minimum green duration for pedestrian crossings (s).");
448 oc.
addDescription(
"tls.crossing-clearance.time",
"TLS Building",
"Use INT as clearance time for pedestrian crossings (s).");
451 oc.
addDescription(
"tls.scramble.time",
"TLS Building",
"Use INT as green phase duration for pedestrian scramble phase (s).");
455 oc.
addSynonyme(
"tls.half-offset",
"tl-logics.half-offset",
true);
456 oc.
addDescription(
"tls.half-offset",
"TLS Building",
"TLSs in STR will be shifted by half-phase");
459 oc.
addSynonyme(
"tls.quarter-offset",
"tl-logics.quarter-offset",
true);
460 oc.
addDescription(
"tls.quarter-offset",
"TLS Building",
"TLSs in STR will be shifted by quarter-phase");
464 oc.
addDescription(
"tls.default-type",
"TLS Building",
"TLSs with unspecified type will use STR as their algorithm");
467 oc.
addDescription(
"tls.layout",
"TLS Building",
"Set phase layout four grouping opposite directions or grouping all movements for one incoming edge ['opposites', 'incoming']");
470 oc.
addDescription(
"tls.min-dur",
"TLS Building",
"Default minimum phase duration for traffic lights with variable phase length");
473 oc.
addDescription(
"tls.max-dur",
"TLS Building",
"Default maximum phase duration for traffic lights with variable phase length");
477 oc.
addSynonyme(
"keep-edges.min-speed",
"edges-min-speed",
true);
478 oc.
addDescription(
"keep-edges.min-speed",
"Edge Removal",
"Only keep edges with speed in meters/second > FLOAT");
481 oc.
addSynonyme(
"remove-edges.explicit",
"remove-edges");
482 oc.
addDescription(
"remove-edges.explicit",
"Edge Removal",
"Remove edges in STR");
485 oc.
addSynonyme(
"keep-edges.explicit",
"keep-edges");
486 oc.
addDescription(
"keep-edges.explicit",
"Edge Removal",
"Only keep edges in STR or those which are kept due to other keep-edges or remove-edges options");
489 oc.
addDescription(
"keep-edges.input-file",
"Edge Removal",
"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");
492 oc.
addDescription(
"remove-edges.input-file",
"Edge Removal",
"Remove edges in FILE. (Each id on a single line. Selection files from SUMO-GUI are also supported)");
496 oc.
addDescription(
"keep-edges.postload",
"Edge Removal",
"Remove edges after joining");
500 oc.
addDescription(
"keep-edges.in-boundary",
"Edge Removal",
"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,...>)");
503 oc.
addDescription(
"keep-edges.in-geo-boundary",
"Edge Removal",
"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,...>)");
507 oc.
addDescription(
"keep-edges.by-vclass",
"Edge Removal",
"Only keep edges which allow one of the vclasss in STR");
510 oc.
addDescription(
"remove-edges.by-vclass",
"Edge Removal",
"Remove edges which allow only vclasses from STR");
513 oc.
addDescription(
"keep-edges.by-type",
"Edge Removal",
"Only keep edges where type is in STR");
516 oc.
addDescription(
"keep-edges.components",
"Edge Removal",
"Only keep the INT largest weakly connected components");
519 oc.
addDescription(
"remove-edges.by-type",
"Edge Removal",
"Remove edges where type is in STR");
522 oc.
addSynonyme(
"remove-edges.isolated",
"remove-isolated",
true);
523 oc.
addDescription(
"remove-edges.isolated",
"Edge Removal",
"Removes isolated edges");
529 oc.
addSynonyme(
"keep-nodes-unregulated",
"keep-unregulated");
530 oc.
addDescription(
"keep-nodes-unregulated",
"Unregulated Nodes",
"All nodes will be unregulated");
533 oc.
addSynonyme(
"keep-nodes-unregulated.explicit",
"keep-unregulated.explicit");
534 oc.
addSynonyme(
"keep-nodes-unregulated.explicit",
"keep-unregulated.nodes",
true);
535 oc.
addDescription(
"keep-nodes-unregulated.explicit",
"Unregulated Nodes",
"Do not regulate nodes in STR");
538 oc.
addSynonyme(
"keep-nodes-unregulated.district-nodes",
"keep-unregulated.district-nodes");
539 oc.
addDescription(
"keep-nodes-unregulated.district-nodes",
"Unregulated Nodes",
"Do not regulate district nodes");
544 oc.
addSynonyme(
"ramps.guess",
"guess-ramps",
true);
545 oc.
addDescription(
"ramps.guess",
"Ramp Guessing",
"Enable ramp-guessing");
548 oc.
addDescription(
"ramps.guess-acceleration-lanes",
"Ramp Guessing",
"Guess on-ramps and mark acceleration lanes if they exist but do not add new lanes");
551 oc.
addSynonyme(
"ramps.max-ramp-speed",
"ramp-guess.max-ramp-speed",
true);
552 oc.
addDescription(
"ramps.max-ramp-speed",
"Ramp Guessing",
"Treat edges with speed > FLOAT as no ramps");
555 oc.
addSynonyme(
"ramps.min-highway-speed",
"ramp-guess.min-highway-speed",
true);
556 oc.
addDescription(
"ramps.min-highway-speed",
"Ramp Guessing",
"Treat edges with speed < FLOAT as no highways");
559 oc.
addSynonyme(
"ramps.ramp-length",
"ramp-guess.ramp-length",
true);
560 oc.
addDescription(
"ramps.ramp-length",
"Ramp Guessing",
"Use FLOAT as ramp-length");
563 oc.
addSynonyme(
"ramps.set",
"ramp-guess.explicite",
true);
564 oc.
addDescription(
"ramps.set",
"Ramp Guessing",
"Tries to handle the given edges as ramps");
567 oc.
addDescription(
"ramps.unset",
"Ramp Guessing",
"Do not consider the given edges as ramps");
570 oc.
addSynonyme(
"ramps.no-split",
"ramp-guess.no-split",
true);
571 oc.
addDescription(
"ramps.no-split",
"Ramp Guessing",
"Avoids edge splitting");
582 WRITE_ERROR(
"unsupported value '" + oc.
getString(
"tls.default-type") +
"' for option '--tls.default-type'");
585 if (oc.
isSet(
"keep-edges.in-boundary") && oc.
isSet(
"keep-edges.in-geo-boundary")) {
586 WRITE_ERROR(
"only one of the options 'keep-edges.in-boundary' or 'keep-edges.in-geo-boundary' may be given");
589 if (oc.
getBool(
"no-internal-links") && oc.
getBool(
"crossings.guess")) {
590 WRITE_ERROR(
"only one of the options 'no-internal-links' or 'crossings.guess' may be given");
593 if (oc.
getBool(
"no-internal-links") && oc.
getBool(
"walkingareas")) {
594 WRITE_ERROR(
"only one of the options 'no-internal-links' or 'walkareas' may be given");
598 WRITE_ERROR(
"only one of the options 'tls.green.time' or 'tls.cycle.time' may be given");
601 if (oc.
getInt(
"junctions.internal-link-detail") < 2) {
602 WRITE_ERROR(
"junctions.internal-link-detail must >= 2");
605 if (oc.
getFloat(
"junctions.scurve-stretch") > 0) {
606 if (oc.
getBool(
"no-internal-links")) {
607 WRITE_WARNING(
"option 'junctions.scurve-stretch' requires internal lanes to work. Option '--no-internal-links' was disabled.");
610 oc.
set(
"no-internal-links",
"false");
612 if (oc.
getFloat(
"junctions.small-radius") > oc.
getFloat(
"default.junctions.radius") && oc.
getFloat(
"default.junctions.radius") >= 0) {
613 WRITE_ERROR(
"option 'default.junctions.radius' cannot be smaller than option 'junctions.small-radius'");
616 if (oc.
getString(
"tls.layout") !=
"opposites" && oc.
getString(
"tls.layout") !=
"incoming") {
617 WRITE_ERROR(
"tls.layout must be 'opposites' or 'incoming'");
620 if (!oc.
isDefault(
"default.right-of-way") &&
bool isSet(const std::string &name, bool failOnNonExistant=true) const
Returns the information whether the named option is set.
int getInt(const std::string &name) const
Returns the int-value of the named option (only for Option_Integer)
#define WRITE_WARNING(msg)
bool set(const std::string &name, const std::string &value)
Sets the given value for the named option.
std::string getString(const std::string &name) const
Returns the string-value of the named option (only for Option_String)
static StringBijection< RightOfWay > RightOfWayValues
righ of way algorithms
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.
void addDescription(const std::string &name, const std::string &subtopic, const std::string &description)
Adds a description for an option.
static bool checkOptions()
Checks set options from the OptionsCont-singleton for being valid.
void addSynonyme(const std::string &name1, const std::string &name2, bool isDeprecated=false)
Adds a synonyme for an options name (any order)
void doRegister(const std::string &name, Option *v)
Adds an option under the given name.
A storage for options typed value containers)
static void fillOptions(bool forNetgen)
Inserts options used by the network converter.
bool isDefault(const std::string &name) const
Returns the information whether the named option has still the default value.
double getFloat(const std::string &name) const
Returns the double-value of the named option (only for Option_Float)
std::string toString(const T &t, std::streamsize accuracy=gPrecision)
static const double UNSPECIFIED_WIDTH
unspecified lane width
static StringBijection< TrafficLightType > TrafficLightTypes
traffic light types
bool hasString(const std::string &str) const