SUMO - Simulation of Urban MObility
NWFrame.cpp
Go to the documentation of this file.
1 /****************************************************************************/
9 // Sets and checks options for netwrite
10 /****************************************************************************/
11 // SUMO, Simulation of Urban MObility; see http://sumo.dlr.de/
12 // Copyright (C) 2001-2016 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 <utils/options/Option.h>
38 #include <utils/common/SysUtils.h>
40 #include <netbuild/NBNetBuilder.h>
41 #include "NWFrame.h"
42 #include "NWWriter_SUMO.h"
43 #include "NWWriter_Amitran.h"
44 #include "NWWriter_MATSim.h"
45 #include "NWWriter_XML.h"
46 #include "NWWriter_OpenDrive.h"
47 #include "NWWriter_DlrNavteq.h"
48 
49 #ifdef CHECK_MEMORY_LEAKS
50 #include <foreign/nvwa/debug_new.h>
51 #endif // CHECK_MEMORY_LEAKS
52 
53 // ===========================================================================
54 // static members
55 // ===========================================================================
56 const std::string NWFrame::MAJOR_VERSION = "version=\"0.27\"";
57 
58 
59 // ===========================================================================
60 // method definitions
61 // ===========================================================================
62 void
63 NWFrame::fillOptions(bool forNetgen) {
65  // register options
66  oc.doRegister("output-file", 'o', new Option_FileName());
67  oc.addSynonyme("output-file", "sumo-output");
68  oc.addSynonyme("output-file", "output");
69  oc.addDescription("output-file", "Output", "The generated net will be written to FILE");
70 
71  oc.doRegister("plain-output-prefix", new Option_FileName());
72  oc.addSynonyme("plain-output-prefix", "plain-output");
73  oc.addSynonyme("plain-output-prefix", "plain");
74  oc.addDescription("plain-output-prefix", "Output", "Prefix of files to write plain xml nodes, edges and connections to");
75 
76  oc.doRegister("junctions.join-output", new Option_FileName());
77  oc.addDescription("junctions.join-output", "Output",
78  "Writes information about joined junctions to FILE (can be loaded as additional node-file to reproduce joins");
79 
80 #ifdef HAVE_PROJ
81  if (!forNetgen) {
82  oc.doRegister("proj.plain-geo", new Option_Bool(false));
83  oc.addDescription("proj.plain-geo", "Projection", "Write geo coordinates in plain-xml");
84  }
85 #endif // HAVE_PROJ
86 
87  oc.doRegister("amitran-output", new Option_FileName());
88  oc.addDescription("amitran-output", "Output", "The generated net will be written to FILE using Amitran format");
89 
90  oc.doRegister("matsim-output", new Option_FileName());
91  oc.addDescription("matsim-output", "Output", "The generated net will be written to FILE using MATsim format");
92 
93  oc.doRegister("opendrive-output", new Option_FileName());
94  oc.addDescription("opendrive-output", "Output", "The generated net will be written to FILE using OpenDRIVE format");
95 
96  oc.doRegister("dlr-navteq-output", new Option_FileName());
97  oc.addDescription("dlr-navteq-output", "Output", "The generated net will be written to dlr-navteq files with the given PREFIX");
98 
99  oc.doRegister("output.street-names", new Option_Bool(false));
100  oc.addDescription("output.street-names", "Output", "Street names will be included in the output (if available)");
101 
102  oc.doRegister("output.original-names", new Option_Bool(false));
103  oc.addDescription("output.original-names", "Output", "Writes original names, if given, as parameter");
104 
105  oc.doRegister("street-sign-output", new Option_FileName());
106  oc.addDescription("street-sign-output", "Output", "Writes street signs as POIs to FILE");
107 }
108 
109 
110 bool
113  bool ok = true;
114  // check whether the output is valid and can be build
115  if (!oc.isSet("output-file")
116  && !oc.isSet("plain-output-prefix")
117  && !oc.isSet("amitran-output")
118  && !oc.isSet("matsim-output")
119  && !oc.isSet("opendrive-output")
120  && !oc.isSet("dlr-navteq-output")) {
121  std::string net = "net.net.xml";
122  if (oc.isSet("configuration-file")) {
123  net = FileHelpers::getConfigurationRelative(oc.getString("configuration-file"), net);
124  }
125  oc.setDefault("output-file", net);
126  }
127  // some outputs need internal lanes
128  if (oc.isSet("opendrive-output") && oc.getBool("no-internal-links")) {
129  WRITE_ERROR("OpenDRIVE export needs internal links computation.");
130  ok = false;
131  }
132  if (oc.isSet("opendrive-output") && oc.isDefault("rectangular-lane-cut")) {
133  oc.set("rectangular-lane-cut", "true");
134  }
135  if (oc.isSet("opendrive-output") && !oc.getBool("rectangular-lane-cut")) {
136  WRITE_WARNING("OpenDRIVE cannot represent oblique lane cuts and should use option 'rectangular-lane-cut'.");
137  }
138  return ok;
139 }
140 
141 
142 void
144  long before = SysUtils::getCurrentMillis();
145  PROGRESS_BEGIN_MESSAGE("Writing network");
152  PROGRESS_TIME_MESSAGE(before);
153 }
154 
155 
156 void
158  dev.writeAttr(SUMO_ATTR_X, pos.x());
159  dev.writeAttr(SUMO_ATTR_Y, pos.y());
160  if (pos.z() != 0) {
161  dev.writeAttr(SUMO_ATTR_Z, pos.z());
162  }
163 }
164 
165 /****************************************************************************/
166 
void doRegister(const std::string &name, Option *v)
Adds an option under the given name.
Definition: OptionsCont.cpp:86
OutputDevice & writeAttr(const SumoXMLAttr attr, const T &val)
writes a named attribute
Definition: OutputDevice.h:257
static bool checkOptions()
Checks set options from the OptionsCont-singleton for being valid.
Definition: NWFrame.cpp:111
static std::string getConfigurationRelative(const std::string &configPath, const std::string &path)
Returns the second path as a relative path to the first file.
Definition: FileHelpers.cpp:86
static void writeNetwork(const OptionsCont &oc, NBNetBuilder &nb)
Writes the network into a Amitran-file.
bool getBool(const std::string &name) const
Returns the boolean-value of the named option (only for Option_Bool)
bool isDefault(const std::string &name) const
Returns the information whether the named option has still the default value.
#define WRITE_WARNING(msg)
Definition: MsgHandler.h:200
static OptionsCont & getOptions()
Retrieves the options.
Definition: OptionsCont.cpp:69
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.
#define PROGRESS_TIME_MESSAGE(before)
Definition: MsgHandler.h:204
static void writeNetwork(const OptionsCont &oc, NBNetBuilder &nb)
Writes the network into a SUMO-file.
static void writeNetwork(const OptionsCont &oc, NBNetBuilder &nb)
Writes the network into a openDRIVE-file.
bool setDefault(const std::string &name, const std::string &value)
Sets the given value for the named option as new default value.
SUMOReal z() const
Returns the z-position.
Definition: Position.h:73
A point in 2D or 3D with translation and scaling methods.
Definition: Position.h:46
std::string getString(const std::string &name) const
Returns the string-value of the named option (only for Option_String)
SUMOReal x() const
Returns the x-position.
Definition: Position.h:63
#define PROGRESS_BEGIN_MESSAGE(msg)
Definition: MsgHandler.h:202
static void writeNetwork(const OptionsCont &oc, NBNetBuilder &nb)
Writes the network into XML-files (nodes, edges, connections, traffic lights)
static void writePositionLong(const Position &pos, OutputDevice &dev)
Writes the given position to device in long format (one attribute per dimension)
Definition: NWFrame.cpp:157
static void writeNetwork(const OptionsCont &oc, NBNetBuilder &nb)
Writes the network into XML-files (nodes, edges, connections, traffic lights)
static void writeNetwork(const OptionsCont &oc, NBNetBuilder &nb)
Writes the network stored in the given net builder.
Definition: NWFrame.cpp:143
#define WRITE_ERROR(msg)
Definition: MsgHandler.h:206
bool set(const std::string &name, const std::string &value)
Sets the given value for the named option.
Instance responsible for building networks.
Definition: NBNetBuilder.h:112
A storage for options typed value containers)
Definition: OptionsCont.h:99
Static storage of an output device and its base (abstract) implementation.
Definition: OutputDevice.h:71
void addDescription(const std::string &name, const std::string &subtopic, const std::string &description)
Adds a description for an option.
static void fillOptions(bool forNetgen)
Inserts options used by the network writer.
Definition: NWFrame.cpp:63
static long getCurrentMillis()
Returns the current time in milliseconds.
Definition: SysUtils.cpp:50
SUMOReal y() const
Returns the y-position.
Definition: Position.h:68
static const std::string MAJOR_VERSION
The version number for written files.
Definition: NWFrame.h:69
static void writeNetwork(const OptionsCont &oc, NBNetBuilder &nb)
Writes the network into a MATSim-file.