 |
Eclipse SUMO - Simulation of Urban MObility
|
Go to the documentation of this file.
53 oc.
addDescription(
"sumo-net-file",
"Input",
"Read SUMO-net from FILE");
57 oc.
addSynonyme(
"node-files",
"xml-node-files",
true);
60 oc.
addDescription(
"node-files",
"Input",
"Read XML-node defs from FILE");
63 oc.
addSynonyme(
"edge-files",
"xml-edge-files",
true);
66 oc.
addDescription(
"edge-files",
"Input",
"Read XML-edge defs from FILE");
69 oc.
addSynonyme(
"connection-files",
"xml-connection-files",
true);
70 oc.
addSynonyme(
"connection-files",
"xml-connections",
true);
72 oc.
addDescription(
"connection-files",
"Input",
"Read XML-connection defs from FILE");
75 oc.
addDescription(
"tllogic-files",
"Input",
"Read XML-traffic light defs from FILE");
78 oc.
addSynonyme(
"type-files",
"xml-type-files",
true);
81 oc.
addDescription(
"type-files",
"Input",
"Read XML-type defs from FILE");
86 oc.
addDescription(
"ptstop-files",
"Input",
"Reads public transport stops from FILE");
88 oc.
addDescription(
"ptline-files",
"Input",
"Reads public transport lines from FILE");
90 oc.
addDescription(
"polygon-files",
"Input",
"Reads polygons from FILE for embedding in network where applicable");
95 oc.
addSynonyme(
"shapefile-prefix",
"arcview",
true);
97 oc.
addDescription(
"shapefile-prefix",
"Input",
"Read shapefiles (ArcView, Tiger, ...) from files starting with 'FILE'");
101 oc.
addSynonyme(
"dlr-navteq-prefix",
"elmar2",
true);
102 oc.
addDescription(
"dlr-navteq-prefix",
"Input",
"Read converted Navteq GDF data (unsplitted Elmar-network) from path 'FILE'");
106 oc.
addDescription(
"osm-files",
"Input",
"Read OSM-network from path 'FILE(s)'");
110 oc.
addDescription(
"opendrive-files",
"Input",
"Read OpenDRIVE-network from FILE");
114 oc.
addDescription(
"visum-file",
"Input",
"Read VISUM-net from FILE");
118 oc.
addDescription(
"vissim-file",
"Input",
"Read VISSIM-net from FILE");
121 oc.
addSynonyme(
"robocup-dir",
"robocup-net",
true);
123 oc.
addDescription(
"robocup-dir",
"Input",
"Read RoboCup-net from DIR");
127 oc.
addDescription(
"matsim-files",
"Input",
"Read MATsim-net from FILE");
131 oc.
addDescription(
"itsumo-files",
"Input",
"Read ITSUMO-net from FILE");
134 oc.
addDescription(
"heightmap.shapefiles",
"Input",
"Read heightmap from ArcGIS shapefile");
137 oc.
addDescription(
"heightmap.geotiff",
"Input",
"Read heightmap from GeoTIFF");
141 oc.
addSynonyme(
"ignore-errors",
"dismiss-loading-errors",
true);
142 oc.
addDescription(
"ignore-errors",
"Report",
"Continue on broken input");
145 oc.
addDescription(
"ignore-errors.connections",
"Report",
"Continue on invalid connections");
148 oc.
addDescription(
"show-errors.connections-first-try",
"Report",
"Show errors in connections at parsing");
151 oc.
addDescription(
"ignore-errors.edge-type",
"Report",
"Continue on unknown edge types");
154 oc.
addDescription(
"speed-in-kmh",
"Processing",
"vmax is parsed as given in km/h (some)");
157 oc.
addDescription(
"construction-date",
"Processing",
"Use YYYY-MM-DD date to determine the readiness of features under construction");
164 oc.
addSynonyme(
"plain.extend-edge-shape",
"xml.keep-shape",
true);
165 oc.
addDescription(
"plain.extend-edge-shape",
"Processing",
"If edge shapes do not end at the node positions, extend them");
169 oc.
addDescription(
"osm.skip-duplicates-check",
"Formats",
"Skips the check for duplicate nodes and edges");
172 oc.
addDescription(
"osm.elevation",
"Formats",
"Imports elevation data");
175 oc.
addDescription(
"osm.layer-elevation",
"Formats",
"Reconstruct (relative) elevation based on layer data. Each layer is raised by FLOAT m");
178 oc.
addDescription(
"osm.layer-elevation.max-grade",
"Formats",
"Maximum grade threshold in % at 50km/h when reconstrucing elevation based on layer data. The value is scaled according to road speed.");
181 oc.
addDescription(
"osm.oneway-spread-right",
"Formats",
"Whether one-way roads should be spread to the side instead of centered");
184 oc.
addDescription(
"osm.stop-output.length",
"Formats",
"The default length of a public transport stop in FLOAT m");
186 oc.
addDescription(
"osm.stop-output.length.bus",
"Formats",
"The default length of a bus stop in FLOAT m");
188 oc.
addDescription(
"osm.stop-output.length.tram",
"Formats",
"The default length of a tram stop in FLOAT m");
190 oc.
addDescription(
"osm.stop-output.length.train",
"Formats",
"The default length of a train stop in FLOAT m");
193 oc.
addDescription(
"osm.all-attributes",
"Formats",
"Whether additional attributes shall be imported");
198 oc.
addDescription(
"matsim.keep-length",
"Formats",
"The edge lengths given in the MATSIM-file will be kept");
201 oc.
addDescription(
"matsim.lanes-from-capacity",
"Formats",
"The lane number will be computed from the capacity");
206 oc.
addSynonyme(
"shapefile.street-id",
"arcview.street-id",
true);
207 oc.
addDescription(
"shapefile.street-id",
"Formats",
"Read edge ids from column STR");
210 oc.
addSynonyme(
"shapefile.from-id",
"arcview.from-id",
true);
211 oc.
addDescription(
"shapefile.from-id",
"Formats",
"Read from-node ids from column STR");
214 oc.
addSynonyme(
"shapefile.to-id",
"arcview.to-id",
true);
215 oc.
addDescription(
"shapefile.to-id",
"Formats",
"Read to-node ids from column STR");
218 oc.
addSynonyme(
"shapefile.type-id",
"arcview.type-id",
true);
219 oc.
addDescription(
"shapefile.type-id",
"Formats",
"Read type ids from column STR");
222 oc.
addDescription(
"shapefile.laneNumber",
"Formats",
"Read lane number from column STR");
225 oc.
addDescription(
"shapefile.speed",
"Formats",
"Read speed from column STR");
228 oc.
addDescription(
"shapefile.name",
"Formats",
"Read (non-unique) name from column STR");
231 oc.
addDescription(
"shapefile.node-join-dist",
"Formats",
"Distance threshold for determining whether distinct shapes are connected (used when from-id and to-id are not available)");
234 oc.
addDescription(
"shapefile.add-params",
"Formats",
"Add the list of field names as edge params");
237 oc.
addSynonyme(
"shapefile.use-defaults-on-failure",
"arcview.use-defaults-on-failure",
true);
238 oc.
addDescription(
"shapefile.use-defaults-on-failure",
"Formats",
"Uses edge type defaults on problems");
241 oc.
addSynonyme(
"shapefile.all-bidirectional",
"shapefile.all-bidi");
242 oc.
addSynonyme(
"shapefile.all-bidirectional",
"arcview.all-bidi",
true);
243 oc.
addDescription(
"shapefile.all-bidirectional",
"Formats",
"Insert edges in both directions");
246 oc.
addSynonyme(
"shapefile.guess-projection",
"arcview.guess-projection",
true);
247 oc.
addDescription(
"shapefile.guess-projection",
"Formats",
"Guess the proper projection");
252 oc.
addSynonyme(
"vissim.join-distance",
"vissim.offset",
true);
253 oc.
addDescription(
"vissim.join-distance",
"Formats",
"Structure join offset");
256 oc.
addDescription(
"vissim.default-speed",
"Formats",
"Use FLOAT as default speed");
259 oc.
addDescription(
"vissim.speed-norm",
"Formats",
"Factor for edge velocity");
262 oc.
addDescription(
"vissim.report-unset-speeds",
"Formats",
"Writes lanes without an explicit speed set");
267 oc.
addDescription(
"visum.language-file",
"Formats",
"Load language mappings from FILE");
270 oc.
addDescription(
"visum.use-type-priority",
"Formats",
"Uses priorities from types");
273 oc.
addDescription(
"visum.use-type-laneno",
"Formats",
"Uses lane numbers from types");
276 oc.
addDescription(
"visum.use-type-speed",
"Formats",
"Uses speeds from types");
279 oc.
addDescription(
"visum.connector-speeds",
"Formats",
"Sets connector speed");
282 oc.
addSynonyme(
"visum.connectors-lane-number",
"visum.connector-laneno",
true);
283 oc.
addDescription(
"visum.connectors-lane-number",
"Formats",
"Sets connector lane number");
286 oc.
addDescription(
"visum.no-connectors",
"Formats",
"Excludes connectors");
289 oc.
addSynonyme(
"visum.recompute-lane-number",
"visum.recompute-laneno",
true);
290 oc.
addDescription(
"visum.recompute-lane-number",
"Formats",
"Computes the number of lanes from the edges' capacities");
293 oc.
addDescription(
"visum.verbose-warnings",
"Formats",
"Prints all warnings, some of which are due to VISUM misbehaviour");
296 oc.
addSynonyme(
"visum.lanes-from-capacity.norm",
"capacity-norm",
true);
297 oc.
addSynonyme(
"visum.lanes-from-capacity.norm",
"lanes-from-capacity.norm");
298 oc.
addDescription(
"visum.lanes-from-capacity.norm",
"Formats",
"The factor for flow to no. lanes conversion");
303 oc.
addDescription(
"opendrive.import-all-lanes",
"Formats",
"Imports all lane types");
305 oc.
addDescription(
"opendrive.ignore-widths",
"Formats",
"Whether lane widths shall be ignored.");
307 oc.
addDescription(
"opendrive.curve-resolution",
"Formats",
"The geometry resolution in m when importing curved geometries as line segments.");
309 oc.
addDescription(
"opendrive.advance-stopline",
"Formats",
"Allow stop lines to be built beyond the start of the junction if the geometries allow so");
311 oc.
addDescription(
"opendrive.min-width",
"Formats",
"The minimum lane width for determining start or end of variable-width lanes");
313 oc.
addDescription(
"opendrive.internal-shapes",
"Formats",
"Import internal lane shapes");
317 oc.
addDescription(
"tls.discard-loaded",
"TLS Building",
"Does not instatiate traffic lights loaded from other formats than plain-XML");
320 oc.
addDescription(
"tls.discard-simple",
"TLS Building",
"Does not instatiate traffic lights at geometry-like nodes loaded from other formats than plain-XML");
324 oc.
addDescription(
"railway.signals.discard",
"Railway",
"Discard all railway signal information loaded from other formats than plain-xml");
336 if ((oc.
isSet(
"osm-files") || oc.
isSet(
"dlr-navteq-prefix") || oc.
isSet(
"shapefile-prefix")) && numProjections == 0) {
338 oc.
set(
"proj.utm",
"true");
341 if (oc.
isSet(
"dlr-navteq-prefix") && oc.
isDefault(
"proj.scale")) {
345 if ((oc.
isSet(
"osm-files") || oc.
isSet(
"dlr-navteq-prefix") || oc.
isSet(
"shapefile-prefix")) && !oc.
getBool(
"simple-projection")) {
346 WRITE_ERROR(
"Cannot import network data without PROJ-Library. Please install packages proj before building sumo");
350 if (oc.
isSet(
"sumo-net-file")) {
353 oc.
set(
"no-turnarounds",
"true");
355 if (oc.
isWriteable(
"offset.disable-normalization")) {
357 oc.
set(
"offset.disable-normalization",
"true");
361 oc.
set(
"geometry.max-grade.fix",
"false");
363 if (oc.
isWriteable(
"geometry.min-radius.fix.railways")) {
365 oc.
set(
"geometry.min-radius.fix.railways",
"false");
368 if (!oc.
isSet(
"type-files")) {
369 const char* sumoPath = std::getenv(
"SUMO_HOME");
370 if (sumoPath ==
nullptr) {
371 WRITE_WARNING(
"Environment variable SUMO_HOME is not set, using built in type maps.");
373 const std::string path = sumoPath + std::string(
"/data/typemap/");
374 if (oc.
isSet(
"osm-files")) {
375 oc.
setDefault(
"type-files", path +
"osmNetconvert.typ.xml");
377 if (oc.
isSet(
"opendrive-files")) {
378 oc.
setDefault(
"type-files", path +
"opendriveNetconvert.typ.xml");
382 if (oc.
isSet(
"opendrive-files")) {
383 if (oc.
isDefault(
"tls.left-green.time")) {
385 oc.
set(
"tls.left-green.time",
"0");
387 if (oc.
isDefault(
"rectangular-lane-cut")) {
389 oc.
set(
"rectangular-lane-cut",
"true");
391 if (oc.
isDefault(
"geometry.max-grade.fix")) {
393 oc.
set(
"geometry.max-grade.fix",
"false");
bool isSet(const std::string &name, bool failOnNonExistant=true) const
Returns the information whether the named option is set.
bool checkDependingSuboptions(const std::string &name, const std::string &prefix) const
Checks whether an option is set, which has options with a prefix depending on it.
#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)
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.
static bool checkOptions()
Checks set options from the OptionsCont-singleton for being valid.
void addDescription(const std::string &name, const std::string &subtopic, const std::string &description)
Adds a description for an option.
void addSynonyme(const std::string &name1, const std::string &name2, bool isDeprecated=false)
Adds a synonyme for an options name (any order)
static void fillOptions(bool forNetedit=false)
Inserts options used by the network importer and network building modules.
void doRegister(const std::string &name, Option *v)
Adds an option under the given name.
A storage for options typed value containers)
static const std::string GEO_SCALE
scaling factor for geo coordinates (DLRNavteq format uses this to increase floating point precisions)
void addXMLDefault(const std::string &name, const std::string &xmlRoot="")
Adds an XML root element to handle by default. The special root "" denotes the default handler.
bool isDefault(const std::string &name) const
Returns the information whether the named option has still the default value.
bool isWriteable(const std::string &name)
Returns the information whether the named option may be set.
bool setDefault(const std::string &name, const std::string &value)
Sets the given value for the named option as new default value.