SUMO - Simulation of Urban MObility
NGFrame.cpp
Go to the documentation of this file.
1 /****************************************************************************/
9 // Sets and checks options for netgen
10 /****************************************************************************/
11 // SUMO, Simulation of Urban MObility; see http://sumo.dlr.de/
12 // Copyright (C) 2011-2017 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 "NGFrame.h"
35 #include <netbuild/NBNetBuilder.h>
36 #include <utils/options/Option.h>
40 #include <utils/common/ToString.h>
41 
42 
43 // ===========================================================================
44 // method definitions
45 // ===========================================================================
46 void
49  // register grid-net options
50  oc.doRegister("grid", 'g', new Option_Bool(false));
51  oc.addSynonyme("grid", "grid-net", true);
52  oc.addDescription("grid", "Grid Network", "Forces NETGEN to build a grid-like network");
53 
54  oc.doRegister("grid.number", new Option_Integer(5));
55  oc.addSynonyme("grid.number", "grid-number", true);
56  oc.addSynonyme("grid.number", "number");
57  oc.addDescription("grid.number", "Grid Network", "The number of junctions in both dirs");
58 
59  oc.doRegister("grid.length", new Option_Float(100));
60  oc.addSynonyme("grid.length", "grid-length", true);
61  oc.addSynonyme("grid.length", "length");
62  oc.addDescription("grid.length", "Grid Network", "The length of streets in both dirs");
63 
64  oc.doRegister("grid.x-number", new Option_Integer(5));
65  oc.addSynonyme("grid.x-number", "grid-x-number", true);
66  oc.addSynonyme("grid.x-number", "x-no");
67  oc.addDescription("grid.x-number", "Grid Network", "The number of junctions in x-dir; Overrides --grid-number");
68 
69  oc.doRegister("grid.y-number", new Option_Integer(5));
70  oc.addSynonyme("grid.y-number", "grid-y-number", true);
71  oc.addSynonyme("grid.y-number", "y-no");
72  oc.addDescription("grid.y-number", "Grid Network", "The number of junctions in y-dir; Overrides --grid-number");
73 
74  oc.doRegister("grid.x-length", new Option_Float(100));
75  oc.addSynonyme("grid.x-length", "grid-x-length", true);
76  oc.addSynonyme("grid.x-length", "x-length");
77  oc.addDescription("grid.x-length", "Grid Network", "The length of horizontal streets; Overrides --grid-length");
78 
79  oc.doRegister("grid.y-length", new Option_Float(100));
80  oc.addSynonyme("grid.y-length", "grid-y-length", true);
81  oc.addSynonyme("grid.y-length", "y-length");
82  oc.addDescription("grid.y-length", "Grid Network", "The length of vertical streets; Overrides --grid-length");
83 
84  oc.doRegister("grid.attach-length", new Option_Float(0));
85  oc.addSynonyme("grid.attach-length", "attach-length", true);
86  oc.addDescription("grid.attach-length", "Grid Network", "The length of streets attached at the boundary; 0 means no streets are attached");
87 
88  oc.doRegister("grid.alphanumerical-ids", new Option_Bool(false));
89  oc.addDescription("grid.alphanumerical-ids", "Grid Network", "The Ids of generated nodes use letters for the X axis");
90 
91  // register spider-net options
92  oc.doRegister("spider", 's', new Option_Bool(false));
93  oc.addSynonyme("spider", "spider-net", true);
94  oc.addDescription("spider", "Spider Network", "Forces NETGEN to build a spider-net-like network");
95 
96  oc.doRegister("spider.arm-number", new Option_Integer(13));
97  oc.addSynonyme("spider.arm-number", "spider-arm-number", true);
98  oc.addSynonyme("spider.arm-number", "arms");
99  oc.addDescription("spider.arm-number", "Spider Network", "The number of axes within the net");
100 
101  oc.doRegister("spider.circle-number", new Option_Integer(20));
102  oc.addSynonyme("spider.circle-number", "spider-circle-number", true);
103  oc.addSynonyme("spider.circle-number", "circles");
104  oc.addDescription("spider.circle-number", "Spider Network", "The number of circles of the net");
105 
106  oc.doRegister("spider.space-radius", new Option_Float(100));
107  oc.addSynonyme("spider.space-radius", "spider-space-rad", true);
108  oc.addSynonyme("spider.space-radius", "radius");
109  oc.addDescription("spider.space-radius", "Spider Network", "The distances between the circles");
110 
111  oc.doRegister("spider.omit-center", new Option_Bool(false));
112  oc.addSynonyme("spider.omit-center", "spider-omit-center", true);
113  oc.addSynonyme("spider.omit-center", "nocenter");
114  oc.addDescription("spider.omit-center", "Spider Network", "Omit the central node of the network");
115 
116 
117  // register random-net options
118  oc.doRegister("rand", 'r', new Option_Bool(false));
119  oc.addSynonyme("rand", "random-net", true);
120  oc.addDescription("rand", "Random Network", "Forces NETGEN to build a random network");
121 
122  oc.doRegister("rand.iterations", new Option_Integer(2000));
123  oc.addSynonyme("rand.iterations", "rand-iterations", true);
124  oc.addSynonyme("rand.iterations", "iterations");
125  oc.addDescription("rand.iterations", "Random Network", "Describes how many times an edge shall be added to the net");
126 
127  oc.doRegister("rand.bidi-probability", new Option_Float(1));
128  oc.addSynonyme("rand.bidi-probability", "rand-bidi-probability", true);
129  oc.addSynonyme("rand.bidi-probability", "bidi");
130  oc.addDescription("rand.bidi-probability", "Random Network", "Defines the probability to build a reverse edge");
131 
132  oc.doRegister("rand.max-distance", new Option_Float(250));
133  oc.addSynonyme("rand.max-distance", "rand-max-distance", true);
134  oc.addSynonyme("rand.max-distance", "max-dist");
135  oc.addDescription("rand.max-distance", "Random Network", "The maximum distance for each edge");
136 
137  oc.doRegister("rand.min-distance", new Option_Float(100));
138  oc.addSynonyme("rand.min-distance", "rand-min-distance", true);
139  oc.addSynonyme("rand.min-distance", "min-dist");
140  oc.addDescription("rand.min-distance", "Random Network", "The minimum distance for each edge");
141 
142  oc.doRegister("rand.min-angle", new Option_Float(DEG2RAD(45.0)));
143  oc.addSynonyme("rand.min-angle", "rand-min-anglee", true);
144  oc.addSynonyme("rand.min-angle", "min-angle");
145  oc.addDescription("rand.min-angle", "Random Network", "The minimum angle for each pair of (bidirectional) roads");
146 
147  oc.doRegister("rand.num-tries", new Option_Integer(50));
148  oc.addSynonyme("rand.num-tries", "rand-num-tries", true);
149  oc.addSynonyme("rand.num-tries", "num-tries");
150  oc.addDescription("rand.num-tries", "Random Network", "The number of tries for creating each node");
151 
152  oc.doRegister("rand.connectivity", new Option_Float((double) 0.95));
153  oc.addSynonyme("rand.connectivity", "rand-connectivity", true);
154  oc.addSynonyme("rand.connectivity", "connectivity");
155  oc.addDescription("rand.connectivity", "Random Network", "Probability for roads to continue at each node");
156 
157  oc.doRegister("rand.neighbor-dist1", new Option_Float(0));
158  oc.addSynonyme("rand.neighbor-dist1", "rand-neighbor-dist1", true);
159  oc.addSynonyme("rand.neighbor-dist1", "dist1");
160  oc.addDescription("rand.neighbor-dist1", "Random Network", "Probability for a node having exactly 1 neighbor");
161 
162  oc.doRegister("rand.neighbor-dist2", new Option_Float(0));
163  oc.addSynonyme("rand.neighbor-dist2", "rand-neighbor-dist2", true);
164  oc.addSynonyme("rand.neighbor-dist2", "dist2");
165  oc.addDescription("rand.neighbor-dist2", "Random Network", "Probability for a node having exactly 2 neighbors");
166 
167  oc.doRegister("rand.neighbor-dist3", new Option_Float(10));
168  oc.addSynonyme("rand.neighbor-dist3", "rand-neighbor-dist3", true);
169  oc.addSynonyme("rand.neighbor-dist3", "dist3");
170  oc.addDescription("rand.neighbor-dist3", "Random Network", "Probability for a node having exactly 3 neighbors");
171 
172  oc.doRegister("rand.neighbor-dist4", new Option_Float(10));
173  oc.addSynonyme("rand.neighbor-dist4", "rand-neighbor-dist4", true);
174  oc.addSynonyme("rand.neighbor-dist4", "dist4");
175  oc.addDescription("rand.neighbor-dist4", "Random Network", "Probability for a node having exactly 4 neighbors");
176 
177  oc.doRegister("rand.neighbor-dist5", new Option_Float(2));
178  oc.addSynonyme("rand.neighbor-dist5", "rand-neighbor-dist5", true);
179  oc.addSynonyme("rand.neighbor-dist5", "dist5");
180  oc.addDescription("rand.neighbor-dist5", "Random Network", "Probability for a node having exactly 5 neighbors");
181 
182  oc.doRegister("rand.neighbor-dist6", new Option_Float(1));
183  oc.addSynonyme("rand.neighbor-dist6", "rand-neighbor-dist6", true);
184  oc.addSynonyme("rand.neighbor-dist6", "dist6");
185  oc.addDescription("rand.neighbor-dist6", "Random Network", "Probability for a node having exactly 6 neighbors");
186 }
187 
188 
189 bool
192  bool ok = true;
193  // check whether exactly one type of a network to build was wished
194  int no = 0;
195  if (oc.getBool("spider")) {
196  no++;
197  }
198  if (oc.getBool("grid")) {
199  no++;
200  }
201  if (oc.getBool("rand")) {
202  no++;
203  }
204  if (no == 0) {
205  WRITE_ERROR("You have to specify the type of network to generate.");
206  ok = false;
207  }
208  if (no > 1) {
209  WRITE_ERROR("You may specify only one type of network to generate at once.");
210  ok = false;
211  }
212  // check whether the junction type to use is properly set
213  if (oc.isSet("default-junction-type")) {
214  std::string type = oc.getString("default-junction-type");
215  if (type != toString(NODETYPE_TRAFFIC_LIGHT) &&
218  type != toString(NODETYPE_PRIORITY) &&
219  type != toString(NODETYPE_PRIORITY_STOP) &&
220  type != toString(NODETYPE_ALLWAY_STOP) &&
221  type != toString(NODETYPE_ZIPPER) &&
222  type != toString(NODETYPE_NOJUNCTION) &&
223  type != toString(NODETYPE_RAIL_SIGNAL) &&
224  type != toString(NODETYPE_RAIL_CROSSING) &&
226  WRITE_ERROR("Only the following junction types are known: " +
230  toString(NODETYPE_PRIORITY) + ", " +
233  toString(NODETYPE_ZIPPER) + ", " +
234  toString(NODETYPE_NOJUNCTION) + ", " +
238  ok = false;
239  }
240  }
241  return ok;
242 }
243 
244 
245 /****************************************************************************/
246 
void doRegister(const std::string &name, Option *v)
Adds an option under the given name.
Definition: OptionsCont.cpp:82
bool getBool(const std::string &name) const
Returns the boolean-value of the named option (only for Option_Bool)
static OptionsCont & getOptions()
Retrieves the options.
Definition: OptionsCont.cpp:65
void addSynonyme(const std::string &name1, const std::string &name2, bool isDeprecated=false)
Adds a synonyme for an options name (any order)
bool isSet(const std::string &name, bool failOnNonExistant=true) const
Returns the information whether the named option is set.
std::string toString(const T &t, std::streamsize accuracy=gPrecision)
Definition: ToString.h:56
std::string getString(const std::string &name) const
Returns the string-value of the named option (only for Option_String)
static bool checkOptions()
Checks set options from the OptionsCont-singleton for being valid.
Definition: NGFrame.cpp:190
#define DEG2RAD(x)
Definition: GeomHelper.h:45
#define WRITE_ERROR(msg)
Definition: MsgHandler.h:206
An integer-option.
Definition: Option.h:313
A storage for options typed value containers)
Definition: OptionsCont.h:99
static void fillOptions()
Inserts options used by the network generator.
Definition: NGFrame.cpp:47
void addDescription(const std::string &name, const std::string &subtopic, const std::string &description)
Adds a description for an option.