Eclipse SUMO - Simulation of Urban MObility
NIFrame.cpp
Go to the documentation of this file.
1 /****************************************************************************/
2 // Eclipse SUMO, Simulation of Urban MObility; see https://eclipse.org/sumo
3 // Copyright (C) 2001-2020 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 /****************************************************************************/
21 // Sets and checks options for netimport
22 /****************************************************************************/
23 #include <config.h>
24 
25 #include <string>
26 #include <iostream>
27 #include <fstream>
28 #include <utils/options/Option.h>
32 #include <utils/common/ToString.h>
36 #include <netbuild/NBNetBuilder.h>
37 #include <netwrite/NWFrame.h>
39 #include "NIImporter_DlrNavteq.h"
40 #include "NIFrame.h"
41 
42 
43 // ===========================================================================
44 // method definitions
45 // ===========================================================================
46 void
47 NIFrame::fillOptions(bool forNetedit) {
49  // register input formats
50  oc.doRegister("sumo-net-file", 's', new Option_FileName());
51  oc.addSynonyme("sumo-net-file", "sumo-net", true);
52  oc.addSynonyme("sumo-net-file", "net-file");
53  oc.addDescription("sumo-net-file", "Input", "Read SUMO-net from FILE");
54  oc.addXMLDefault("sumo-net-file", "net");
55 
56  oc.doRegister("node-files", 'n', new Option_FileName());
57  oc.addSynonyme("node-files", "xml-node-files", true);
58  oc.addSynonyme("node-files", "xml-nodes", true);
59  oc.addSynonyme("node-files", "nodes");
60  oc.addDescription("node-files", "Input", "Read XML-node defs from FILE");
61 
62  oc.doRegister("edge-files", 'e', new Option_FileName());
63  oc.addSynonyme("edge-files", "xml-edge-files", true);
64  oc.addSynonyme("edge-files", "xml-edges", true);
65  oc.addSynonyme("edge-files", "edges");
66  oc.addDescription("edge-files", "Input", "Read XML-edge defs from FILE");
67 
68  oc.doRegister("connection-files", 'x', new Option_FileName());
69  oc.addSynonyme("connection-files", "xml-connection-files", true);
70  oc.addSynonyme("connection-files", "xml-connections", true);
71  oc.addSynonyme("connection-files", "connections");
72  oc.addDescription("connection-files", "Input", "Read XML-connection defs from FILE");
73 
74  oc.doRegister("tllogic-files", 'i', new Option_FileName());
75  oc.addDescription("tllogic-files", "Input", "Read XML-traffic light defs from FILE");
76 
77  oc.doRegister("type-files", 't', new Option_FileName());
78  oc.addSynonyme("type-files", "xml-type-files", true);
79  oc.addSynonyme("type-files", "xml-types", true);
80  oc.addSynonyme("type-files", "types");
81  oc.addDescription("type-files", "Input", "Read XML-type defs from FILE");
82 
83  if (!forNetedit) {
84  // would cause confusion because netedit loads stops and shapes using option --additional-files
85  oc.doRegister("ptstop-files", new Option_FileName());
86  oc.addDescription("ptstop-files", "Input", "Reads public transport stops from FILE");
87  oc.doRegister("ptline-files", new Option_FileName());
88  oc.addDescription("ptline-files", "Input", "Reads public transport lines from FILE");
89  oc.doRegister("polygon-files", new Option_FileName());
90  oc.addDescription("polygon-files", "Input", "Reads polygons from FILE for embedding in network where applicable");
91  }
92 
93  oc.doRegister("shapefile-prefix", new Option_FileName());
94  oc.addSynonyme("shapefile-prefix", "shapefile");
95  oc.addSynonyme("shapefile-prefix", "arcview", true);
96  oc.addSynonyme("shapefile-prefix", "tiger", true);
97  oc.addDescription("shapefile-prefix", "Input", "Read shapefiles (ArcView, Tiger, ...) from files starting with 'FILE'");
98 
99  oc.doRegister("dlr-navteq-prefix", new Option_FileName());
100  oc.addSynonyme("dlr-navteq-prefix", "dlr-navteq");
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'");
103 
104  oc.doRegister("osm-files", new Option_FileName());
105  oc.addSynonyme("osm-files", "osm");
106  oc.addDescription("osm-files", "Input", "Read OSM-network from path 'FILE(s)'");
107 
108  oc.doRegister("opendrive-files", new Option_FileName());
109  oc.addSynonyme("opendrive-files", "opendrive");
110  oc.addDescription("opendrive-files", "Input", "Read OpenDRIVE-network from FILE");
111 
112  oc.doRegister("visum-file", new Option_FileName());
113  oc.addSynonyme("visum-file", "visum");
114  oc.addDescription("visum-file", "Input", "Read VISUM-net from FILE");
115 
116  oc.doRegister("vissim-file", new Option_FileName());
117  oc.addSynonyme("vissim-file", "vissim");
118  oc.addDescription("vissim-file", "Input", "Read VISSIM-net from FILE");
119 
120  oc.doRegister("robocup-dir", new Option_FileName());
121  oc.addSynonyme("robocup-dir", "robocup-net", true);
122  oc.addSynonyme("robocup-dir", "robocup");
123  oc.addDescription("robocup-dir", "Input", "Read RoboCup-net from DIR");
124 
125  oc.doRegister("matsim-files", new Option_FileName());
126  oc.addSynonyme("matsim-files", "matsim");
127  oc.addDescription("matsim-files", "Input", "Read MATsim-net from FILE");
128 
129  oc.doRegister("itsumo-files", new Option_FileName());
130  oc.addSynonyme("itsumo-files", "itsumo");
131  oc.addDescription("itsumo-files", "Input", "Read ITSUMO-net from FILE");
132 
133  oc.doRegister("heightmap.shapefiles", new Option_FileName());
134  oc.addDescription("heightmap.shapefiles", "Input", "Read heightmap from ArcGIS shapefile");
135 
136  oc.doRegister("heightmap.geotiff", new Option_FileName());
137  oc.addDescription("heightmap.geotiff", "Input", "Read heightmap from GeoTIFF");
138 
139  // need to do this here to be able to check for network and route input options
141 
142  // register basic processing options
143  oc.doRegister("ignore-errors", new Option_Bool(false));
144  oc.addSynonyme("ignore-errors", "dismiss-loading-errors", true);
145  oc.addDescription("ignore-errors", "Report", "Continue on broken input");
146 
147  oc.doRegister("ignore-errors.connections", new Option_Bool(false));
148  oc.addDescription("ignore-errors.connections", "Report", "Continue on invalid connections");
149 
150  oc.doRegister("show-errors.connections-first-try", new Option_Bool(false));
151  oc.addDescription("show-errors.connections-first-try", "Report", "Show errors in connections at parsing");
152 
153  oc.doRegister("ignore-errors.edge-type", new Option_Bool(false));
154  oc.addDescription("ignore-errors.edge-type", "Report", "Continue on unknown edge types");
155 
156  oc.doRegister("speed-in-kmh", new Option_Bool(false));
157  oc.addDescription("speed-in-kmh", "Processing", "vmax is parsed as given in km/h (some)");
158 
159  oc.doRegister("construction-date", new Option_String());
160  oc.addDescription("construction-date", "Processing", "Use YYYY-MM-DD date to determine the readiness of features under construction");
161 
162  oc.doRegister("flatten", new Option_Bool(false));
163  oc.addDescription("flatten", "Processing", "Remove all z-data");
164 
165  oc.doRegister("discard-params", new Option_StringVector());
166  oc.addDescription("discard-params", "Formats", "Remove the list of keys from all params");
167 
168  // register xml options
169  oc.doRegister("plain.extend-edge-shape", new Option_Bool(false));
170  oc.addSynonyme("plain.extend-edge-shape", "xml.keep-shape", true);
171  oc.addDescription("plain.extend-edge-shape", "Processing", "If edge shapes do not end at the node positions, extend them");
172 
173  // register osm options
174  oc.doRegister("osm.skip-duplicates-check", new Option_Bool(false));
175  oc.addDescription("osm.skip-duplicates-check", "Formats", "Skips the check for duplicate nodes and edges");
176 
177  oc.doRegister("osm.elevation", new Option_Bool(false));
178  oc.addDescription("osm.elevation", "Formats", "Imports elevation data");
179 
180  oc.doRegister("osm.layer-elevation", new Option_Float(0));
181  oc.addDescription("osm.layer-elevation", "Formats", "Reconstruct (relative) elevation based on layer data. Each layer is raised by FLOAT m");
182 
183  oc.doRegister("osm.layer-elevation.max-grade", new Option_Float(10));
184  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.");
185 
186  oc.doRegister("osm.oneway-spread-right", new Option_Bool(false));
187  oc.addDescription("osm.oneway-spread-right", "Formats", "Whether one-way roads should be spread to the side instead of centered");
188 
189  oc.doRegister("osm.stop-output.length", new Option_Float(25));
190  oc.addDescription("osm.stop-output.length", "Formats", "The default length of a public transport stop in FLOAT m");
191  oc.doRegister("osm.stop-output.length.bus", new Option_Float(15));
192  oc.addDescription("osm.stop-output.length.bus", "Formats", "The default length of a bus stop in FLOAT m");
193  oc.doRegister("osm.stop-output.length.tram", new Option_Float(25));
194  oc.addDescription("osm.stop-output.length.tram", "Formats", "The default length of a tram stop in FLOAT m");
195  oc.doRegister("osm.stop-output.length.train", new Option_Float(200));
196  oc.addDescription("osm.stop-output.length.train", "Formats", "The default length of a train stop in FLOAT m");
197 
198  oc.doRegister("osm.all-attributes", new Option_Bool(false));
199  oc.addDescription("osm.all-attributes", "Formats", "Whether additional attributes shall be imported");
200 
201 
202  // register matsim options
203  oc.doRegister("matsim.keep-length", new Option_Bool(false));
204  oc.addDescription("matsim.keep-length", "Formats", "The edge lengths given in the MATSIM-file will be kept");
205 
206  oc.doRegister("matsim.lanes-from-capacity", new Option_Bool(false));
207  oc.addDescription("matsim.lanes-from-capacity", "Formats", "The lane number will be computed from the capacity");
208 
209 
210  // register shapefile options
211  oc.doRegister("shapefile.street-id", new Option_String());
212  oc.addSynonyme("shapefile.street-id", "arcview.street-id", true);
213  oc.addDescription("shapefile.street-id", "Formats", "Read edge ids from column STR");
214 
215  oc.doRegister("shapefile.from-id", new Option_String());
216  oc.addSynonyme("shapefile.from-id", "arcview.from-id", true);
217  oc.addDescription("shapefile.from-id", "Formats", "Read from-node ids from column STR");
218 
219  oc.doRegister("shapefile.to-id", new Option_String());
220  oc.addSynonyme("shapefile.to-id", "arcview.to-id", true);
221  oc.addDescription("shapefile.to-id", "Formats", "Read to-node ids from column STR");
222 
223  oc.doRegister("shapefile.type-id", new Option_String());
224  oc.addSynonyme("shapefile.type-id", "arcview.type-id", true);
225  oc.addDescription("shapefile.type-id", "Formats", "Read type ids from column STR");
226 
227  oc.doRegister("shapefile.laneNumber", new Option_String());
228  oc.addDescription("shapefile.laneNumber", "Formats", "Read lane number from column STR");
229 
230  oc.doRegister("shapefile.speed", new Option_String());
231  oc.addDescription("shapefile.speed", "Formats", "Read speed from column STR");
232 
233  oc.doRegister("shapefile.name", new Option_String());
234  oc.addDescription("shapefile.name", "Formats", "Read (non-unique) name from column STR");
235 
236  oc.doRegister("shapefile.node-join-dist", new Option_Float(0));
237  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)");
238 
239  oc.doRegister("shapefile.add-params", new Option_StringVector());
240  oc.addDescription("shapefile.add-params", "Formats", "Add the list of field names as edge params");
241 
242  oc.doRegister("shapefile.use-defaults-on-failure", new Option_Bool(false));
243  oc.addSynonyme("shapefile.use-defaults-on-failure", "arcview.use-defaults-on-failure", true);
244  oc.addDescription("shapefile.use-defaults-on-failure", "Formats", "Uses edge type defaults on problems");
245 
246  oc.doRegister("shapefile.all-bidirectional", new Option_Bool(false));
247  oc.addSynonyme("shapefile.all-bidirectional", "shapefile.all-bidi");
248  oc.addSynonyme("shapefile.all-bidirectional", "arcview.all-bidi", true);
249  oc.addDescription("shapefile.all-bidirectional", "Formats", "Insert edges in both directions");
250 
251  oc.doRegister("shapefile.guess-projection", new Option_Bool(false));
252  oc.addSynonyme("shapefile.guess-projection", "arcview.guess-projection", true);
253  oc.addDescription("shapefile.guess-projection", "Formats", "Guess the proper projection");
254 
255  oc.doRegister("shapefile.traditional-axis-mapping", new Option_Bool(false));
256  oc.addDescription("shapefile.traditional-axis-mapping", "Formats", "Use traditional axis order (lon, lat)");
257 
258 
259  // register dlr-navteq options
260  oc.doRegister("dlr-navteq.tolerant-permissions", new Option_Bool(false));
261  oc.addDescription("dlr-navteq.tolerant-permissions", "Formats", "Allow more vehicle classes by default");
262 
263  oc.doRegister("dlr-navteq.keep-length", new Option_Bool(false));
264  oc.addDescription("dlr-navteq.keep-length", "Formats", "The edge lengths given in the DLR Navteq-file will be kept");
265 
266 
267  // register vissim options
268  oc.doRegister("vissim.join-distance", new Option_Float(5.0f));
269  oc.addSynonyme("vissim.join-distance", "vissim.offset", true);
270  oc.addDescription("vissim.join-distance", "Formats", "Structure join offset");
271 
272  oc.doRegister("vissim.default-speed", new Option_Float(50.0f));
273  oc.addDescription("vissim.default-speed", "Formats", "Use FLOAT as default speed");
274 
275  oc.doRegister("vissim.speed-norm", new Option_Float(1.0f));
276  oc.addDescription("vissim.speed-norm", "Formats", "Factor for edge velocity");
277 
278  oc.doRegister("vissim.report-unset-speeds", new Option_Bool(false));
279  oc.addDescription("vissim.report-unset-speeds", "Formats", "Writes lanes without an explicit speed set");
280 
281 
282  // register visum options
283  oc.doRegister("visum.language-file", new Option_FileName());
284  oc.addDescription("visum.language-file", "Formats", "Load language mappings from FILE");
285 
286  oc.doRegister("visum.use-type-priority", new Option_Bool(false));
287  oc.addDescription("visum.use-type-priority", "Formats", "Uses priorities from types");
288 
289  oc.doRegister("visum.use-type-laneno", new Option_Bool(false));
290  oc.addDescription("visum.use-type-laneno", "Formats", "Uses lane numbers from types");
291 
292  oc.doRegister("visum.use-type-speed", new Option_Bool(false));
293  oc.addDescription("visum.use-type-speed", "Formats", "Uses speeds from types");
294 
295  oc.doRegister("visum.connector-speeds", new Option_Float(100.));
296  oc.addDescription("visum.connector-speeds", "Formats", "Sets connector speed");
297 
298  oc.doRegister("visum.connectors-lane-number", new Option_Integer(3));
299  oc.addSynonyme("visum.connectors-lane-number", "visum.connector-laneno", true);
300  oc.addDescription("visum.connectors-lane-number", "Formats", "Sets connector lane number");
301 
302  oc.doRegister("visum.no-connectors", new Option_Bool(true));
303  oc.addDescription("visum.no-connectors", "Formats", "Excludes connectors");
304 
305  oc.doRegister("visum.recompute-lane-number", new Option_Bool(false));
306  oc.addSynonyme("visum.recompute-lane-number", "visum.recompute-laneno", true);
307  oc.addDescription("visum.recompute-lane-number", "Formats", "Computes the number of lanes from the edges' capacities");
308 
309  oc.doRegister("visum.verbose-warnings", new Option_Bool(false));
310  oc.addDescription("visum.verbose-warnings", "Formats", "Prints all warnings, some of which are due to VISUM misbehaviour");
311 
312  oc.doRegister("visum.lanes-from-capacity.norm", new Option_Float(1800.));
313  oc.addSynonyme("visum.lanes-from-capacity.norm", "capacity-norm", true);
314  oc.addSynonyme("visum.lanes-from-capacity.norm", "lanes-from-capacity.norm");
315  oc.addDescription("visum.lanes-from-capacity.norm", "Formats", "The factor for flow to no. lanes conversion");
316 
317 
318  // register opendrive options
319  oc.doRegister("opendrive.import-all-lanes", new Option_Bool(false));
320  oc.addDescription("opendrive.import-all-lanes", "Formats", "Imports all lane types");
321  oc.doRegister("opendrive.ignore-widths", new Option_Bool(false));
322  oc.addDescription("opendrive.ignore-widths", "Formats", "Whether lane widths shall be ignored.");
323  oc.doRegister("opendrive.curve-resolution", new Option_Float(2.0));
324  oc.addDescription("opendrive.curve-resolution", "Formats", "The geometry resolution in m when importing curved geometries as line segments.");
325  oc.doRegister("opendrive.advance-stopline", new Option_Float(0.0));
326  oc.addDescription("opendrive.advance-stopline", "Formats", "Allow stop lines to be built beyond the start of the junction if the geometries allow so");
327  oc.doRegister("opendrive.min-width", new Option_Float(1.8));
328  oc.addDescription("opendrive.min-width", "Formats", "The minimum lane width for determining start or end of variable-width lanes");
329  oc.doRegister("opendrive.internal-shapes", new Option_Bool(false));
330  oc.addDescription("opendrive.internal-shapes", "Formats", "Import internal lane shapes");
331 
332  // register some additional options
333  oc.doRegister("tls.discard-loaded", new Option_Bool(false));
334  oc.addDescription("tls.discard-loaded", "TLS Building", "Does not instatiate traffic lights loaded from other formats than plain-XML");
335 
336  oc.doRegister("tls.discard-simple", new Option_Bool(false));
337  oc.addDescription("tls.discard-simple", "TLS Building", "Does not instatiate traffic lights at geometry-like nodes loaded from other formats than plain-XML");
338 
339  // register railway options
340  oc.doRegister("railway.signals.discard", new Option_Bool(false));
341  oc.addDescription("railway.signals.discard", "Railway", "Discard all railway signal information loaded from other formats than plain-xml");
342 }
343 
344 
345 bool
348  bool ok = oc.checkDependingSuboptions("shapefile", "shapefile.");
349  ok &= oc.checkDependingSuboptions("visum-file", "visum.");
350  ok &= oc.checkDependingSuboptions("vissim-file", "vissim.");
351 #ifdef PROJ_API_FILE
352  int numProjections = oc.getBool("simple-projection") + oc.getBool("proj.utm") + oc.getBool("proj.dhdn") + (oc.getString("proj").length() > 1);
353  if ((oc.isSet("osm-files") || oc.isSet("dlr-navteq-prefix") || oc.isSet("shapefile-prefix")) && numProjections == 0) {
354  if (oc.isDefault("proj")) {
355  oc.set("proj.utm", "true");
356  }
357  }
358  if (oc.isSet("dlr-navteq-prefix") && oc.isDefault("proj.scale")) {
359  oc.set("proj.scale", NIImporter_DlrNavteq::GEO_SCALE);
360  }
361 #else
362  if ((oc.isSet("osm-files") || oc.isSet("dlr-navteq-prefix") || oc.isSet("shapefile-prefix")) && !oc.getBool("simple-projection")) {
363  WRITE_ERROR("Cannot import network data without PROJ-Library. Please install packages proj before building sumo");
364  ok = false;
365  }
366 #endif
367  if (oc.isSet("sumo-net-file")) {
368  if (oc.isWriteable("no-turnarounds")) {
369  // changed default since turnarounds are loaded from the net file.
370  oc.set("no-turnarounds", "true");
371  }
372  if (oc.isWriteable("offset.disable-normalization")) {
373  // changed default since we wish to preserve the network as far as possible
374  oc.set("offset.disable-normalization", "true");
375  }
376  if (oc.isWriteable("geometry.max-grade.fix")) {
377  // changed default since we wish to preserve the network as far as possible
378  oc.set("geometry.max-grade.fix", "false");
379  }
380  if (oc.isWriteable("geometry.min-radius.fix.railways")) {
381  // changed default since we wish to preserve the network as far as possible
382  oc.set("geometry.min-radius.fix.railways", "false");
383  }
384  }
385  if (!oc.isSet("type-files")) {
386  const char* sumoPath = std::getenv("SUMO_HOME");
387  if (sumoPath == nullptr) {
388  WRITE_WARNING("Environment variable SUMO_HOME is not set, using built in type maps.");
389  } else {
390  const std::string path = sumoPath + std::string("/data/typemap/");
391  if (oc.isSet("osm-files")) {
392  oc.setDefault("type-files", path + "osmNetconvert.typ.xml");
393  }
394  if (oc.isSet("opendrive-files")) {
395  oc.setDefault("type-files", path + "opendriveNetconvert.typ.xml");
396  }
397  }
398  }
399  if (oc.isSet("opendrive-files")) {
400  if (oc.isDefault("tls.left-green.time")) {
401  // legacy behavior. see #2114
402  oc.set("tls.left-green.time", "0");
403  }
404  if (oc.isDefault("rectangular-lane-cut")) {
405  // a better interpretation of imported geometries
406  oc.set("rectangular-lane-cut", "true");
407  }
408  if (oc.isDefault("geometry.max-grade.fix")) {
409  // a better interpretation of imported geometries
410  oc.set("geometry.max-grade.fix", "false");
411  }
412  }
413  return ok;
414 }
415 
416 
417 /****************************************************************************/
#define WRITE_ERROR(msg)
Definition: MsgHandler.h:284
#define WRITE_WARNING(msg)
Definition: MsgHandler.h:276
static bool checkOptions()
Checks set options from the OptionsCont-singleton for being valid.
Definition: NIFrame.cpp:346
static void fillOptions(bool forNetedit=false)
Inserts options used by the network importer and network building modules.
Definition: NIFrame.cpp:47
static const std::string GEO_SCALE
scaling factor for geo coordinates (DLRNavteq format uses this to increase floating point precisions)
An integer-option.
Definition: Option.h:329
A storage for options typed value containers)
Definition: OptionsCont.h:89
void addDescription(const std::string &name, const std::string &subtopic, const std::string &description)
Adds a description for an option.
void doRegister(const std::string &name, Option *v)
Adds an option under the given name.
Definition: OptionsCont.cpp:75
bool isSet(const std::string &name, bool failOnNonExistant=true) const
Returns the information whether the named option is set.
bool isWriteable(const std::string &name)
Returns the information whether the named option may be set.
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)
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:96
bool isDefault(const std::string &name) const
Returns the information whether the named option has still the default value.
bool setDefault(const std::string &name, const std::string &value)
Sets the given value for the named option as new default value.
bool getBool(const std::string &name) const
Returns the boolean-value of the named option (only for Option_Bool)
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.
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.
static OptionsCont & getOptions()
Retrieves the options.
Definition: OptionsCont.cpp:58
static void addReportOptions(OptionsCont &oc)
Adds reporting options to the given container.
Definition: SystemFrame.cpp:63