SUMO - Simulation of Urban MObility
 All Data Structures Namespaces Files Functions Variables Typedefs Enumerations Enumerator Friends Macros Groups Pages
NBFrame.cpp
Go to the documentation of this file.
1 /****************************************************************************/
9 // Sets and checks options for netbuild
10 /****************************************************************************/
11 // SUMO, Simulation of Urban MObility; see http://sumo-sim.org/
12 // Copyright (C) 2001-2014 DLR (http://www.dlr.de/) and contributors
13 /****************************************************************************/
14 //
15 // This file is part of SUMO.
16 // SUMO is free software: you can redistribute it and/or modify
17 // it under the terms of the GNU General Public License as published by
18 // the Free Software Foundation, either version 3 of the License, or
19 // (at your option) any later version.
20 //
21 /****************************************************************************/
22 
23 
24 // ===========================================================================
25 // included modules
26 // ===========================================================================
27 #ifdef _MSC_VER
28 #include <windows_config.h>
29 #else
30 #include <config.h>
31 #endif
32 
33 #include <string>
34 #include <fstream>
35 #include "NBFrame.h"
36 #include "NBNodeCont.h"
37 #include "NBEdgeCont.h"
39 #include "NBDistrictCont.h"
40 #include "NBDistribution.h"
41 #include "NBRequest.h"
42 #include "NBTypeCont.h"
47 #include <utils/common/ToString.h>
51 
52 #ifdef CHECK_MEMORY_LEAKS
53 #include <foreign/nvwa/debug_new.h>
54 #endif // CHECK_MEMORY_LEAKS
55 
56 
57 // ===========================================================================
58 // method definitions
59 // ===========================================================================
60 void
61 NBFrame::fillOptions(bool forNetgen) {
63  // register building defaults
64  oc.doRegister("default.lanenumber", 'L', new Option_Integer(1));
65  oc.addSynonyme("default.lanenumber", "lanenumber", true);
66  oc.addDescription("default.lanenumber", "Building Defaults", "The default number of lanes in an edge");
67 
68  oc.doRegister("default.speed", 'S', new Option_Float((SUMOReal) 13.9));
69  oc.addSynonyme("default.speed", "speed", true);
70  oc.addDescription("default.speed", "Building Defaults", "The default speed on an edge (in m/s)");
71 
72  oc.doRegister("default.priority", 'P', new Option_Integer(-1));
73  oc.addSynonyme("default.priority", "priority", true);
74  oc.addDescription("default.priority", "Building Defaults", "The default priority of an edge");
75 
76 
77  // register the data processing options
78  oc.doRegister("no-internal-links", new Option_Bool(false)); // !!! not described
79  oc.addDescription("no-internal-links", "Processing", "Omits internal links");
80 
81  if (!forNetgen) {
82  oc.doRegister("dismiss-vclasses", new Option_Bool(false));
83  oc.addDescription("dismiss-vclasses", "Processing", "Removes vehicle class restrictions from imported edges");
84  }
85 
86  oc.doRegister("no-turnarounds", new Option_Bool(false));
87  oc.addDescription("no-turnarounds", "Processing", "Disables building turnarounds");
88 
89  oc.doRegister("no-turnarounds.tls", new Option_Bool(false));
90  oc.addSynonyme("no-turnarounds.tls", "no-tls-turnarounds", true);
91  oc.addDescription("no-turnarounds.tls", "Processing", "Disables building turnarounds at tls-controlled junctions");
92 
93  oc.doRegister("no-left-connections", new Option_Bool(false));
94  oc.addDescription("no-left-connections", "Processing", "Disables building connections to left");
95 
96  if (!forNetgen) {
97  oc.doRegister("geometry.split", new Option_Bool(false)); // !!!not described
98  oc.addSynonyme("geometry.split", "split-geometry", true);
99  oc.addDescription("geometry.split", "Processing", "Splits edges across geometry nodes");
100 
101  oc.doRegister("geometry.remove", 'R', new Option_Bool(false));
102  oc.addSynonyme("geometry.remove", "remove-geometry", true);
103  oc.addDescription("geometry.remove", "Processing", "Replace nodes which only define edge geometry by geometry points (joins edges)");
104 
105  oc.doRegister("geometry.max-segment-length", new Option_Float(0));
106  oc.addDescription("geometry.max-segment-length", "Processing", "splits geometry to restrict segment length");
107 
108  oc.doRegister("geometry.min-dist", new Option_Float());
109  oc.addDescription("geometry.min-dist", "Processing", "reduces too similar geometry points");
110 
111  oc.doRegister("geometry.max-angle", new Option_Float(99));
112  oc.addDescription("geometry.max-angle", "Processing", "Warn about edge geometries with an angle above DEGREES in successive segments");
113 
114  oc.doRegister("geometry.min-radius", new Option_Float(9));
115  oc.addDescription("geometry.min-radius", "Processing", "Warn about edge geometries with a turning radius less than METERS at the start or end");
116 
117  oc.doRegister("geometry.min-radius.fix", new Option_Bool(false));
118  oc.addDescription("geometry.min-radius.fix", "Processing", "Straighten edge geometries to avoid turning radii less than geometry.min-radius");
119 
120  oc.doRegister("geometry.junction-mismatch-threshold", new Option_Float(20));
121  oc.addDescription("geometry.junction-mismatch-threshold", "Processing", "Warn if the junction shape is to far away from the original node position");
122  }
123 
124  oc.doRegister("offset.disable-normalization", new Option_Bool(false));
125  oc.addSynonyme("offset.disable-normalization", "disable-normalize-node-positions", true);
126  oc.addDescription("offset.disable-normalization", "Processing", "Turn off normalizing node positions");
127 
128  oc.doRegister("offset.x", new Option_Float(0));
129  oc.addSynonyme("offset.x", "x-offset-to-apply", true);
130  oc.addDescription("offset.x", "Processing", "Adds FLOAT to net x-positions");
131 
132  oc.doRegister("offset.y", new Option_Float(0));
133  oc.addSynonyme("offset.y", "y-offset-to-apply", true);
134  oc.addDescription("offset.y", "Processing", "Adds FLOAT to net y-positions");
135 
136  oc.doRegister("flip-y-axis", new Option_Bool(false));
137  oc.addSynonyme("flip-y-axis", "flip-y");
138  oc.addDescription("flip-y-axis", "Processing", "Flips the y-coordinate along zero");
139 
140  oc.doRegister("roundabouts.guess", new Option_Bool(false));
141  oc.addSynonyme("roundabouts.guess", "guess-roundabouts", true);
142  oc.addDescription("roundabouts.guess", "Processing", "Enable roundabout-guessing");
143 
144  oc.doRegister("lefthand", new Option_Bool(false));
145  oc.addDescription("lefthand", "Processing", "Assumes left-hand traffic on the network");
146 
147  oc.doRegister("junctions.join", new Option_Bool(false));
148  oc.addDescription("junctions.join", "Processing",
149  "Joins junctions that are close to each other (recommended for OSM import)");
150 
151  oc.doRegister("junctions.join-dist", new Option_Float(10));
152  oc.addDescription("junctions.join-dist", "Processing",
153  "Determines the maximal distance for joining junctions (defaults to 10)");
154 
155  if (!forNetgen) {
156  oc.doRegister("junctions.join-exclude", new Option_String());
157  oc.addDescription("junctions.join-exclude", "Processing", "Interprets STR as list of junctions to exclude from joining");
158 
159  oc.doRegister("speed.offset", new Option_Float(0));
160  oc.addDescription("speed.offset", "Processing", "Modifies all edge speeds by adding FLOAT");
161 
162  oc.doRegister("speed.factor", new Option_Float(1));
163  oc.addDescription("speed.factor", "Processing", "Modifies all edge speeds by multiplying FLOAT");
164  }
165 
166 
167  oc.doRegister("check-lane-foes.roundabout", new Option_Bool(true));
168  oc.addDescription("check-lane-foes.roundabout", "Processing",
169  "Allow driving onto a multi-lane road if there are foes on other lanes (at roundabouts)");
170  oc.doRegister("check-lane-foes.all", new Option_Bool(false));
171  oc.addDescription("check-lane-foes.all", "Processing",
172  "Allow driving onto a multi-lane road if there are foes on other lanes (everywhere)");
173 
174  // tls setting options
175  // explicit tls
176  oc.doRegister("tls.set", new Option_String());
177  oc.addSynonyme("tls.set", "explicite-tls", true);
178  oc.addDescription("tls.set", "TLS Building", "Interprets STR as list of junctions to be controlled by TLS");
179 
180  oc.doRegister("tls.unset", new Option_String());
181  oc.addSynonyme("tls.unset", "explicite-no-tls", true);
182  oc.addDescription("tls.unset", "TLS Building", "Interprets STR as list of junctions to be not controlled by TLS");
183 
184  // tls-guessing
185  oc.doRegister("tls.guess", new Option_Bool(false));
186  oc.addSynonyme("tls.guess", "guess-tls", true);
187  oc.addDescription("tls.guess", "TLS Building", "Turns on TLS guessing");
188 
189  if (!forNetgen) {
190  oc.doRegister("tls.taz-nodes", new Option_Bool(false));
191  oc.addSynonyme("tls.taz-nodes", "tls-guess.district-nodes", true);
192  oc.addDescription("tls.taz-nodes", "TLS Building", "Sets district nodes as tls-controlled"); // !!! describe
193  }
194 
195  oc.doRegister("tls-guess.joining", new Option_Bool(false));
196  oc.addDescription("tls-guess.joining", "TLS Building", "Includes node clusters into guess"); // !!! describe
197 
198  oc.doRegister("tls.join", new Option_Bool(false));
199  oc.addSynonyme("tls.join", "try-join-tls", true);
200  oc.addDescription("tls.join", "TLS Building", "Tries to cluster tls-controlled nodes"); // !!! describe
201 
202  oc.doRegister("tls.join-dist", new Option_Float(20));
203  oc.addDescription("tls.join-dist", "Processing",
204  "Determines the maximal distance for joining traffic lights (defaults to 20)");
205 
206  // computational
207  oc.doRegister("tls.green.time", new Option_Integer(31));
208  oc.addSynonyme("tls.green.time", "traffic-light-green", true);
209  oc.addDescription("tls.green.time", "TLS Building", "Use INT as green phase duration");
210 
211  oc.doRegister("tls.yellow.min-decel", 'D', new Option_Float(3.0));
212  oc.addSynonyme("tls.yellow.min-decel", "min-decel", true);
213  oc.addDescription("tls.yellow.min-decel", "TLS Building", "Defines smallest vehicle deceleration");
214 
215  oc.doRegister("tls.yellow.patch-small", new Option_Bool(false));
216  oc.addSynonyme("tls.yellow.patch-small", "patch-small-tyellow", true);
217  oc.addDescription("tls.yellow.patch-small", "TLS Building", "Given yellow times are patched even if being too short");
218 
219  oc.doRegister("tls.yellow.time", new Option_Integer());
220  oc.addSynonyme("tls.yellow.time", "traffic-light-yellow", true);
221  oc.addDescription("tls.yellow.time", "TLS Building", "Set INT as fixed time for yellow phase durations");
222 
223  // tls-shifts
224  oc.doRegister("tls.half-offset", new Option_String());
225  oc.addSynonyme("tls.half-offset", "tl-logics.half-offset", true);
226  oc.addDescription("tls.half-offset", "TLS Building", "TLSs in STR will be shifted by half-phase");
227 
228  oc.doRegister("tls.quarter-offset", new Option_String());
229  oc.addSynonyme("tls.quarter-offset", "tl-logics.quarter-offset", true);
230  oc.addDescription("tls.quarter-offset", "TLS Building", "TLSs in STR will be shifted by quarter-phase");
231 
232  // tls type
233  oc.doRegister("tls.default-type", new Option_String("static"));
234  oc.addDescription("tls.default-type", "TLS Building", "TLSs with unspecified type will use STR as their algorithm");
235 
236 
237  // edge pruning
238  oc.doRegister("keep-edges.min-speed", new Option_Float());
239  oc.addSynonyme("keep-edges.min-speed", "edges-min-speed", true);
240  oc.addDescription("keep-edges.min-speed", "Edge Removal", "Only keep edges with speed in meters/second > FLOAT");
241 
242  oc.doRegister("remove-edges.explicit", new Option_String());
243  oc.addSynonyme("remove-edges.explicit", "remove-edges");
244  oc.addDescription("remove-edges.explicit", "Edge Removal", "Remove edges in STR");
245 
246  oc.doRegister("keep-edges.explicit", new Option_String());
247  oc.addSynonyme("keep-edges.explicit", "keep-edges");
248  oc.addDescription("keep-edges.explicit", "Edge Removal", "Only keep edges in STR");
249 
250  oc.doRegister("keep-edges.input-file", new Option_FileName());
251  oc.addDescription("keep-edges.input-file", "Edge Removal", "Only keep edges in FILE");
252 
253  if (!forNetgen) {
254  oc.doRegister("keep-edges.postload", new Option_Bool(false));
255  oc.addDescription("keep-edges.postload", "Edge Removal", "Remove edges after joining");
256  }
257 
258  oc.doRegister("keep-edges.in-boundary", new Option_String());
259  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,...>)");
260 
261  oc.doRegister("keep-edges.in-geo-boundary", new Option_String());
262  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,...>)");
263 
264  if (!forNetgen) {
265  oc.doRegister("keep-edges.by-vclass", new Option_String());
266  oc.addDescription("keep-edges.by-vclass", "Edge Removal", "Only keep edges which allow one of the vclasss in STR");
267 
268  oc.doRegister("remove-edges.by-vclass", new Option_String());
269  oc.addDescription("remove-edges.by-vclass", "Edge Removal", "Remove edges which allow only vclasses from STR");
270 
271  oc.doRegister("keep-edges.by-type", new Option_String());
272  oc.addDescription("keep-edges.by-type", "Edge Removal", "Only keep edges where type is in STR");
273 
274  oc.doRegister("remove-edges.by-type", new Option_String());
275  oc.addDescription("remove-edges.by-type", "Edge Removal", "Remove edges where type is in STR");
276 
277  oc.doRegister("remove-edges.isolated", new Option_Bool(false));
278  oc.addSynonyme("remove-edges.isolated", "remove-isolated", true);
279  oc.addDescription("remove-edges.isolated", "Edge Removal", "Removes isolated edges");
280  }
281 
282 
283  // unregulated nodes options
284  oc.doRegister("keep-nodes-unregulated", new Option_Bool(false));
285  oc.addSynonyme("keep-nodes-unregulated", "keep-unregulated");
286  oc.addDescription("keep-nodes-unregulated", "Unregulated Nodes", "All nodes will be unregulated");
287 
288  oc.doRegister("keep-nodes-unregulated.explicit", new Option_String());
289  oc.addSynonyme("keep-nodes-unregulated.explicit", "keep-unregulated.explicit");
290  oc.addSynonyme("keep-nodes-unregulated.explicit", "keep-unregulated.nodes", true);
291  oc.addDescription("keep-nodes-unregulated.explicit", "Unregulated Nodes", "Do not regulate nodes in STR");
292 
293  oc.doRegister("keep-nodes-unregulated.district-nodes", new Option_Bool(false));
294  oc.addSynonyme("keep-nodes-unregulated.district-nodes", "keep-unregulated.district-nodes");
295  oc.addDescription("keep-nodes-unregulated.district-nodes", "Unregulated Nodes", "Do not regulate district nodes");
296 
297 
298  // ramp guessing options
299  if (!forNetgen) {
300  oc.doRegister("ramps.guess", new Option_Bool(false));
301  oc.addSynonyme("ramps.guess", "guess-ramps", true);
302  oc.addDescription("ramps.guess", "Ramp Guessing", "Enable ramp-guessing");
303 
304  oc.doRegister("ramps.max-ramp-speed", new Option_Float(-1));
305  oc.addSynonyme("ramps.max-ramp-speed", "ramp-guess.max-ramp-speed", true);
306  oc.addDescription("ramps.max-ramp-speed", "Ramp Guessing", "Treat edges with speed > FLOAT as no ramps");
307 
308  oc.doRegister("ramps.min-highway-speed", new Option_Float((SUMOReal)(79 / 3.6)));
309  oc.addSynonyme("ramps.min-highway-speed", "ramp-guess.min-highway-speed", true);
310  oc.addDescription("ramps.min-highway-speed", "Ramp Guessing", "Treat edges with speed < FLOAT as no highways");
311 
312  oc.doRegister("ramps.ramp-length", new Option_Float(100));
313  oc.addSynonyme("ramps.ramp-length", "ramp-guess.ramp-length", true);
314  oc.addDescription("ramps.ramp-length", "Ramp Guessing", "Use FLOAT as ramp-length");
315 
316  oc.doRegister("ramps.set", new Option_String());
317  oc.addSynonyme("ramps.set", "ramp-guess.explicite", true);
318  oc.addDescription("ramps.set", "Ramp Guessing", "Tries to handle the given edges as ramps");
319 
320  oc.doRegister("ramps.no-split", new Option_Bool(false));
321  oc.addSynonyme("ramps.no-split", "ramp-guess.no-split", true);
322  oc.addDescription("ramps.no-split", "Ramp Guessing", "Avoids edge splitting");
323  }
324 }
325 
326 
327 bool
330  bool ok = true;
331  //
332  if (!oc.isDefault("tls-guess.joining")) {
333  WRITE_WARNING("'--tls-guess.joining' was joined with '--tls.join'.\n Please use '--tls.join' in future only.");
334  if (!oc.isSet("tls.join")) {
335  oc.set("tls.join", "true");
336  }
337  }
338  if (!SUMOXMLDefinitions::TrafficLightTypes.hasString(oc.getString("tls.default-type"))) {
339  WRITE_ERROR("unsupported value '" + oc.getString("tls.default-type") + "' for option '--tls.default-type'");
340  ok = false;
341  }
342  if (oc.isSet("keep-edges.in-boundary") && oc.isSet("keep-edges.in-geo-boundary")) {
343  WRITE_ERROR("only one of the options 'keep-edges.in-boundary' or 'keep-edges.in-geo-boundary' may be given");
344  ok = false;
345  }
346  return ok;
347 }
348 
349 
350 /****************************************************************************/
void doRegister(const std::string &name, Option *v)
Adds an option under the given name.
Definition: OptionsCont.cpp:84
static bool checkOptions()
Checks set options from the OptionsCont-singleton for being valid.
Definition: NBFrame.cpp:328
#define WRITE_WARNING(msg)
Definition: MsgHandler.h:196
static OptionsCont & getOptions()
Retrieves the options.
Definition: OptionsCont.cpp:67
void addSynonyme(const std::string &name1, const std::string &name2, bool isDeprecated=false)
Adds a synonyme for an options name (any order)
std::string getString(const std::string &name) const
Returns the string-value of the named option (only for Option_String)
static StringBijection< TrafficLightType > TrafficLightTypes
bool isDefault(const std::string &name) const
Returns the information whether the named option has still the default value.
#define WRITE_ERROR(msg)
Definition: MsgHandler.h:201
bool set(const std::string &name, const std::string &value)
Sets the given value for the named option.
An integer-option.
Definition: Option.h:308
A storage for options typed value containers)
Definition: OptionsCont.h:108
static void fillOptions(bool forNetgen)
Inserts options used by the network converter.
Definition: NBFrame.cpp:61
#define SUMOReal
Definition: config.h:215
void addDescription(const std::string &name, const std::string &subtopic, const std::string &description)
Adds a description for an option.
bool isSet(const std::string &name, bool failOnNonExistant=true) const
Returns the information whether the named option is set.