Line data Source code
1 : /****************************************************************************/
2 : // Eclipse SUMO, Simulation of Urban MObility; see https://eclipse.dev/sumo
3 : // Copyright (C) 2001-2024 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 : /****************************************************************************/
14 : /// @file NWFrame.cpp
15 : /// @author Daniel Krajzewicz
16 : /// @author Jakob Erdmann
17 : /// @author Michael Behrisch
18 : /// @date Tue, 20 Nov 2001
19 : ///
20 : // Sets and checks options for netwrite
21 : /****************************************************************************/
22 : #include <config.h>
23 :
24 : #include <string>
25 : #include <utils/options/Option.h>
26 : #include <utils/options/OptionsCont.h>
27 : #include <utils/common/MsgHandler.h>
28 : #include <utils/common/SystemFrame.h>
29 : #include <utils/common/SysUtils.h>
30 : #include <utils/iodevices/OutputDevice.h>
31 : #include <netbuild/NBNetBuilder.h>
32 : #include "NWFrame.h"
33 : #include "NWWriter_SUMO.h"
34 : #include "NWWriter_Amitran.h"
35 : #include "NWWriter_MATSim.h"
36 : #include "NWWriter_XML.h"
37 : #include "NWWriter_OpenDrive.h"
38 : #include "NWWriter_DlrNavteq.h"
39 :
40 : // ===========================================================================
41 : // static members
42 : // ===========================================================================
43 :
44 : // ===========================================================================
45 : // method definitions
46 : // ===========================================================================
47 :
48 : void
49 2030 : NWFrame::fillOptions(OptionsCont& oc, bool forNetgen) {
50 : // register options
51 2030 : oc.doRegister("output-file", 'o', new Option_FileName());
52 4060 : oc.addSynonyme("output-file", "sumo-output");
53 4060 : oc.addSynonyme("output-file", "output");
54 4060 : oc.addDescription("output-file", "Output", TL("The generated net will be written to FILE"));
55 :
56 2030 : oc.doRegister("plain-output-prefix", 'p', new Option_FileName());
57 4060 : oc.addSynonyme("plain-output-prefix", "plain-output");
58 4060 : oc.addSynonyme("plain-output-prefix", "plain");
59 4060 : oc.addDescription("plain-output-prefix", "Output", TL("Prefix of files to write plain xml nodes, edges and connections to"));
60 :
61 2030 : oc.doRegister("plain-output.lanes", new Option_Bool(false));
62 4060 : oc.addDescription("plain-output.lanes", "Output", TL("Write all lanes and their attributes even when they are not customized"));
63 :
64 2030 : oc.doRegister("junctions.join-output", new Option_FileName());
65 4060 : oc.addDescription("junctions.join-output", "Output",
66 : "Writes information about joined junctions to FILE (can be loaded as additional node-file to reproduce joins");
67 :
68 4060 : oc.doRegister("prefix", new Option_String(""));
69 4060 : oc.addDescription("prefix", "Output", TL("Defines a prefix for edge and junction names"));
70 :
71 : #ifdef PROJ_API_FILE
72 2030 : if (!forNetgen) {
73 1912 : oc.doRegister("proj.plain-geo", new Option_Bool(false));
74 3824 : oc.addDescription("proj.plain-geo", "Projection", TL("Write geo coordinates in plain-xml"));
75 : }
76 : #endif // PROJ_API_FILE
77 :
78 2030 : oc.doRegister("amitran-output", new Option_FileName());
79 4060 : oc.addDescription("amitran-output", "Output", TL("The generated net will be written to FILE using Amitran format"));
80 :
81 2030 : oc.doRegister("matsim-output", new Option_FileName());
82 4060 : oc.addDescription("matsim-output", "Output", TL("The generated net will be written to FILE using MATSim format"));
83 :
84 2030 : oc.doRegister("opendrive-output", new Option_FileName());
85 4060 : oc.addDescription("opendrive-output", "Output", TL("The generated net will be written to FILE using OpenDRIVE format"));
86 :
87 2030 : oc.doRegister("dlr-navteq-output", new Option_FileName());
88 4060 : oc.addDescription("dlr-navteq-output", "Output", TL("The generated net will be written to dlr-navteq files with the given PREFIX"));
89 :
90 4060 : oc.doRegister("dlr-navteq.version", new Option_String("6.5"));
91 4060 : oc.addDescription("dlr-navteq.version", "Output", TL("The dlr-navteq output format version to write"));
92 :
93 2030 : oc.doRegister("dlr-navteq.precision", new Option_Integer(2));
94 4060 : oc.addDescription("dlr-navteq.precision", "Output", TL("The network coordinates are written with the specified level of output precision"));
95 :
96 2030 : oc.doRegister("output.street-names", new Option_Bool(false));
97 4060 : oc.addDescription("output.street-names", "Output", TL("Street names will be included in the output (if available)"));
98 :
99 2030 : oc.doRegister("output.original-names", new Option_Bool(false));
100 4060 : oc.addDescription("output.original-names", "Output", TL("Writes original names, if given, as parameter"));
101 :
102 2030 : oc.doRegister("street-sign-output", new Option_FileName());
103 4060 : oc.addDescription("street-sign-output", "Output", TL("Writes street signs as POIs to FILE"));
104 :
105 2030 : if (!forNetgen) {
106 1912 : oc.doRegister("ptstop-output", new Option_FileName());
107 3824 : oc.addDescription("ptstop-output", "Output", TL("Writes public transport stops to FILE"));
108 1912 : oc.doRegister("ptline-output", new Option_FileName());
109 3824 : oc.addDescription("ptline-output", "Output", TL("Writes public transport lines to FILE"));
110 1912 : oc.doRegister("ptline-clean-up", new Option_Bool(false));
111 3824 : oc.addDescription("ptline-clean-up", "Output", TL("Clean-up pt stops that are not served by any line"));
112 :
113 1912 : oc.doRegister("parking-output", new Option_FileName());
114 3824 : oc.addDescription("parking-output", "Output", TL("Writes parking areas to FILE"));
115 :
116 1912 : oc.doRegister("railway.topology.output", new Option_FileName());
117 3824 : oc.addDescription("railway.topology.output", "Output", TL("Analyze topology of the railway network"));
118 :
119 1912 : oc.doRegister("polygon-output", new Option_FileName());
120 3824 : oc.addSynonyme("polygon-output", "taz-output");
121 3824 : oc.addDescription("polygon-output", "Output", TL("Write shapes that are embedded in the network input and that are not supported by polyconvert (OpenDRIVE)"));
122 : }
123 :
124 : // register opendrive options
125 2030 : oc.doRegister("opendrive-output.straight-threshold", new Option_Float(0.00000001)); // matching the angular output precision in NWWriter_OpenDrive
126 4060 : oc.addDescription("opendrive-output.straight-threshold", "Output", TL("Builds parameterized curves whenever the angular change between straight segments exceeds FLOAT degrees"));
127 :
128 2030 : if (!forNetgen) {
129 1912 : oc.doRegister("opendrive-output.lefthand-left", new Option_Bool(false));
130 3824 : oc.addDescription("opendrive-output.lefthand-left", "Output", TL("Write lanes in lefthand networks on the left side (positive indices)"));
131 :
132 1912 : oc.doRegister("opendrive-output.shape-match-dist", new Option_Float(-1));
133 3824 : oc.addDescription("opendrive-output.shape-match-dist", "Output", TL("Match loaded shapes to the closest edge within FLOAT and export as road objects"));
134 : }
135 2030 : }
136 :
137 :
138 : bool
139 2008 : NWFrame::checkOptions(OptionsCont& oc) {
140 : bool ok = true;
141 : // check whether the output is valid and can be build
142 4016 : if (!oc.isSet("output-file")
143 2583 : && !oc.isSet("plain-output-prefix")
144 2534 : && !oc.isSet("amitran-output")
145 2533 : && !oc.isSet("matsim-output")
146 2531 : && !oc.isSet("opendrive-output")
147 3095 : && !oc.isSet("dlr-navteq-output")) {
148 500 : std::string net = "net.net.xml";
149 1000 : if (oc.isSet("configuration-file")) {
150 12 : net = FileHelpers::getConfigurationRelative(oc.getString("configuration-file"), net);
151 : }
152 1000 : oc.setDefault("output-file", net);
153 : }
154 : // some outputs need internal lanes
155 2041 : if (oc.isSet("opendrive-output") && oc.getBool("no-internal-links")) {
156 0 : WRITE_ERROR(TL("OpenDRIVE export needs internal links computation."));
157 : ok = false;
158 : }
159 2041 : if (oc.isSet("opendrive-output") && oc.isDefault("no-internal-links")) {
160 64 : oc.setDefault("no-internal-links", "false");
161 : }
162 2041 : if (oc.isSet("opendrive-output") && oc.isDefault("rectangular-lane-cut")) {
163 66 : oc.setDefault("rectangular-lane-cut", "true");
164 : }
165 2074 : if (oc.isSet("opendrive-output") && !oc.getBool("rectangular-lane-cut")) {
166 0 : WRITE_WARNING(TL("OpenDRIVE cannot represent oblique lane cuts and should use option 'rectangular-lane-cut'."));
167 : }
168 2017 : if (oc.isSet("dlr-navteq-output") && oc.isDefault("numerical-ids")) {
169 10 : oc.setDefault("numerical-ids", "true");
170 : }
171 2017 : if (oc.isSet("dlr-navteq-output") && oc.isDefault("osm.all-attributes")) {
172 18 : oc.setDefault("osm.all-attributes", "true");
173 18 : oc.setDefault("osm.extra-attributes", "bridge,tunnel,layer,postal_code,maxheight,maxwidth,maxweight,surface");
174 : }
175 3996 : if (oc.exists("ptline-output") && oc.isSet("ptline-output") && !oc.isSet("ptstop-output")) {
176 0 : WRITE_ERROR(TL("public transport lines output requires 'ptstop-output' to be set"));
177 : ok = false;
178 : }
179 3910 : if (oc.exists("ptline-clean-up") && oc.getBool("ptline-clean-up") && !oc.isSet("ptline-output")) {
180 0 : WRITE_WARNING(TL("'ptline-clean-up' only works in conjunction with 'ptline-output'. Ignoring invalid option."));
181 : }
182 :
183 2008 : return ok;
184 : }
185 :
186 :
187 : void
188 1692 : NWFrame::writeNetwork(const OptionsCont& oc, NBNetBuilder& nb) {
189 3384 : const long before = PROGRESS_BEGIN_TIME_MESSAGE(TL("Writing network"));
190 1692 : NWWriter_SUMO::writeNetwork(oc, nb);
191 1689 : NWWriter_Amitran::writeNetwork(oc, nb);
192 1689 : NWWriter_MATSim::writeNetwork(oc, nb);
193 1689 : NWWriter_OpenDrive::writeNetwork(oc, nb);
194 1689 : NWWriter_DlrNavteq::writeNetwork(oc, nb);
195 3542 : NWWriter_XML::writeNetwork(oc, oc.isSet("plain-output-prefix") ? oc.getString("plain-output-prefix") : "", nb);
196 1687 : PROGRESS_TIME_MESSAGE(before);
197 1687 : }
198 :
199 :
200 : void
201 67794 : NWFrame::writePositionLong(const Position& pos, OutputDevice& dev) {
202 135588 : dev.writeAttr(SUMO_ATTR_X, pos.x());
203 135588 : dev.writeAttr(SUMO_ATTR_Y, pos.y());
204 67794 : if (pos.z() != 0) {
205 1372 : dev.writeAttr(SUMO_ATTR_Z, pos.z());
206 : }
207 67794 : }
208 :
209 : /****************************************************************************/
|