Eclipse SUMO - Simulation of Urban MObility
Loading...
Searching...
No Matches
NWWriter_XML.cpp
Go to the documentation of this file.
1/****************************************************************************/
2// Eclipse SUMO, Simulation of Urban MObility; see https://eclipse.dev/sumo
3// Copyright (C) 2001-2025 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// Exporter writing networks using XML (native input) format
22/****************************************************************************/
23#include <config.h>
24#include <algorithm>
31#include <netbuild/NBEdge.h>
32#include <netbuild/NBEdgeCont.h>
33#include <netbuild/NBNode.h>
34#include <netbuild/NBNodeCont.h>
37#include <netbuild/NBPTStop.h>
38#include <netbuild/NBParking.h>
39#include "NWFrame.h"
40#include "NWWriter_SUMO.h"
41#include "NWWriter_XML.h"
42
43
44// ===========================================================================
45// method definitions
46// ===========================================================================
47// ---------------------------------------------------------------------------
48// static methods
49// ---------------------------------------------------------------------------
50void
51NWWriter_XML::writeNetwork(const OptionsCont& oc, const std::string& prefix, NBNetBuilder& nb) {
52 // check whether plain-output files shall be generated
53 if (prefix != "") {
54 const bool haveTypes = nb.getTypeCont().size() > 0;
55 writeNodes(oc, prefix, nb.getNodeCont());
56 if (haveTypes) {
57 writeTypes(prefix, nb.getEdgeCont(), nb.getTypeCont());
58 }
59 writeEdgesAndConnections(oc, prefix, nb.getNodeCont(), nb.getEdgeCont());
61 writeConfig(oc, prefix, haveTypes);
62 }
63 if (oc.isSet("junctions.join-output")) {
64 writeJoinedJunctions(oc.getString("junctions.join-output"), nb.getNodeCont());
65 }
66 if (oc.isSet("street-sign-output")) {
68 }
69 if (oc.exists("ptstop-output") && oc.isSet("ptstop-output")) {
71 }
72 if (oc.exists("ptline-output") && oc.isSet("ptline-output")) {
74 }
75
76 if (oc.exists("parking-output") && oc.isSet("parking-output")) {
78 }
79 if (oc.exists("taz-output") && oc.isSet("taz-output")) {
81 }
82}
83
84
85void
86NWWriter_XML::writeConfig(const OptionsCont& oc, const std::string& prefix, bool haveTypes) {
87 if (!oc.exists("node-files")) {
88 // do not write configuration for netgen
89 return;
90 }
91 OptionsCont* tmp = oc.clone();
92 tmp->set("node-files", prefix + ".nod.xml");
93 tmp->set("edge-files", prefix + ".edg.xml");
94 tmp->set("connection-files", prefix + ".con.xml");
95 tmp->set("tllogic-files", prefix + ".tll.xml");
96 if (haveTypes) {
97 tmp->set("type-files", prefix + ".typ.xml");
98 }
99 tmp->setDefault("sumo-net-file", "");
100 tmp->setDefault("plain-output-prefix", "");
101
102 const std::string configPath = prefix + ".netccfg";
103 std::ofstream out(configPath.c_str());
104 if (!out.good()) {
105 delete tmp;
106 throw ProcessError(TLF("Could not save configuration to '%'", configPath));
107 } else {
108 tmp->writeConfiguration(out, true, false, false);
109 }
110 delete tmp;
111}
112
113
114void
115NWWriter_XML::writeNodes(const OptionsCont& oc, const std::string& prefix, NBNodeCont& nc) {
117 bool useGeo = oc.exists("proj.plain-geo") && oc.getBool("proj.plain-geo");
118 if (useGeo && !gch.usingGeoProjection()) {
119 WRITE_WARNING(TL("Ignoring option \"proj.plain-geo\" because no geo-conversion has been defined"));
120 useGeo = false;
121 }
122 const bool geoAccuracy = useGeo || gch.usingInverseGeoProjection();
123
124 OutputDevice& device = OutputDevice::getDevice(prefix + ".nod.xml");
125 std::map<SumoXMLAttr, std::string> attrs;
127 device.writeXMLHeader("nodes", "nodes_file.xsd", attrs);
128
129 // write network offsets and projection to allow reconstruction of original coordinates
130 if (!useGeo) {
132 }
133
134 // write nodes
135 TrafficLightType tlsDefaultType = SUMOXMLDefinitions::TrafficLightTypes.get(oc.getString("tls.default-type"));
136 for (std::map<std::string, NBNode*>::const_iterator i = nc.begin(); i != nc.end(); ++i) {
137 NBNode* n = (*i).second;
138 device.openTag(SUMO_TAG_NODE);
139 device.writeAttr(SUMO_ATTR_ID, n->getID());
140 // write position
141 Position pos = n->getPosition();
142 if (useGeo) {
143 gch.cartesian2geo(pos);
144 }
145 if (geoAccuracy) {
147 }
148 NWFrame::writePositionLong(pos, device);
149 if (geoAccuracy) {
150 device.setPrecision();
151 }
152
154 if (n->isTLControlled()) {
155 // set may contain multiple programs for the same id.
156 // make sure ids are unique and sorted
157 std::set<std::string> tlsIDs;
158 std::set<std::string> controlledInnerEdges;
159 std::string tlType = "";
161 tlsIDs.insert(tl->getID());
162 std::vector<std::string> cie = tl->getControlledInnerEdges();
163 controlledInnerEdges.insert(cie.begin(), cie.end());
164 if (tl->getType() != tlsDefaultType) {
165 tlType = toString(tl->getType());
166 }
167 }
168 std::vector<std::string> sortedIDs(tlsIDs.begin(), tlsIDs.end());
169 sort(sortedIDs.begin(), sortedIDs.end());
170 device.writeAttr(SUMO_ATTR_TLID, sortedIDs);
171 if (tlType != "") {
172 device.writeAttr(SUMO_ATTR_TLTYPE, tlType);
173 }
174 if (controlledInnerEdges.size() > 0) {
175 std::vector<std::string> sortedCIEs(controlledInnerEdges.begin(), controlledInnerEdges.end());
176 sort(sortedCIEs.begin(), sortedCIEs.end());
177 device.writeAttr(SUMO_ATTR_CONTROLLED_INNER, joinToString(sortedCIEs, " "));
178 }
179 }
180 if (n->hasCustomShape()) {
181 writeShape(device, gch, n->getShape(), SUMO_ATTR_SHAPE, useGeo, geoAccuracy);
182 }
185 }
186 if (!n->getKeepClear()) {
187 device.writeAttr<bool>(SUMO_ATTR_KEEP_CLEAR, n->getKeepClear());
188 }
190 device.writeAttr<std::string>(SUMO_ATTR_RIGHT_OF_WAY, toString(n->getRightOfWay()));
191 }
193 device.writeAttr<std::string>(SUMO_ATTR_FRINGE, toString(n->getFringeType()));
194 }
195 if (n->getName() != "") {
196 device.writeAttr<std::string>(SUMO_ATTR_NAME, StringUtils::escapeXML(n->getName()));
197 }
198 n->writeParams(device);
199 device.closeTag();
200 }
201 device.close();
202}
203
204
205void
206NWWriter_XML::writeTypes(const std::string& prefix, NBEdgeCont& ec, NBTypeCont& tc) {
207 OutputDevice& device = OutputDevice::getDevice(prefix + ".typ.xml");
208 std::map<SumoXMLAttr, std::string> attrs;
210 device.writeXMLHeader(toString(SUMO_TAG_TYPES), "types_file.xsd", attrs);
211 std::set<std::string> usedTypes = ec.getUsedTypes();
212 tc.writeEdgeTypes(device, usedTypes);
213 device.close();
214}
215
216
217void
218NWWriter_XML::writeEdgesAndConnections(const OptionsCont& oc, const std::string& prefix, NBNodeCont& nc, NBEdgeCont& ec) {
220 bool useGeo = oc.exists("proj.plain-geo") && oc.getBool("proj.plain-geo");
221 const bool geoAccuracy = useGeo || gch.usingInverseGeoProjection();
222
223 std::map<SumoXMLAttr, std::string> attrs;
225 OutputDevice& edevice = OutputDevice::getDevice(prefix + ".edg.xml");
226 edevice.writeXMLHeader("edges", "edges_file.xsd", attrs);
227 OutputDevice& cdevice = OutputDevice::getDevice(prefix + ".con.xml");
228 cdevice.writeXMLHeader("connections", "connections_file.xsd", attrs);
229 const bool writeNames = oc.getBool("output.street-names");
230 const bool writeLanes = oc.getBool("plain-output.lanes");
231
232 // write network offsets and projection to allow reconstruction of original coordinates at least for geo-referenced networks
233 if (!useGeo && gch.usingGeoProjection()) {
235 }
236 LaneSpreadFunction defaultSpread = SUMOXMLDefinitions::LaneSpreadFunctions.get(oc.getString("default.spreadtype"));
237 for (std::map<std::string, NBEdge*>::const_iterator i = ec.begin(); i != ec.end(); ++i) {
238 // write the edge itself to the edges-files
239 NBEdge* e = (*i).second;
240 edevice.openTag(SUMO_TAG_EDGE);
241 edevice.writeAttr(SUMO_ATTR_ID, e->getID());
242 edevice.writeAttr(SUMO_ATTR_FROM, e->getFromNode()->getID());
243 edevice.writeAttr(SUMO_ATTR_TO, e->getToNode()->getID());
244 if (writeNames && e->getStreetName() != "") {
246 }
248 // write the type if given
249 if (e->getTypeID() != "") {
250 edevice.writeAttr(SUMO_ATTR_TYPE, e->getTypeID());
251 }
252 if (e->getRoutingType() != "") {
254 }
256 if (!e->hasLaneSpecificSpeed()) {
257 edevice.writeAttr(SUMO_ATTR_SPEED, e->getSpeed());
258 }
259 if (!e->hasLaneSpecificFriction()) {
262 }
263 }
264 // write non-default geometry
265 if (!e->hasDefaultGeometry()) {
266 writeShape(edevice, gch, e->getGeometry(), SUMO_ATTR_SHAPE, useGeo, geoAccuracy);
267 }
268 // write the spread type if not default ("right")
269 if (e->getLaneSpreadFunction() != defaultSpread) {
271 }
272 // write the length if it was specified
273 if (e->hasLoadedLength()) {
275 }
276 // some attributes can be set by edge default or per lane. Write as default if possible (efficiency)
279 }
282 }
283 if (!e->hasLaneSpecificPermissions()) {
284 writePermissions(edevice, e->getPermissions(0));
285 }
288 }
289 if (e->getDistance() != 0) {
291 }
292 if (e->getBidiEdge() != 0) {
293 edevice.writeAttr(SUMO_ATTR_BIDI, e->getBidiEdge()->getID());
294 }
295 if (e->needsLaneSpecificOutput() || writeLanes) {
296 int idx = 0;
297 for (const NBEdge::Lane& lane : e->getLanes()) {
298 edevice.openTag(SUMO_TAG_LANE);
299 edevice.writeAttr(SUMO_ATTR_INDEX, idx++);
300 // write allowed lanes
301 if (e->hasLaneSpecificPermissions() || writeLanes) {
302 writePermissions(edevice, lane.permissions);
303 }
304 writePreferences(edevice, lane.preferred);
305 // write other attributes
306 if (lane.width != NBEdge::UNSPECIFIED_WIDTH && (e->hasLaneSpecificWidth() || writeLanes)) {
307 edevice.writeAttr(SUMO_ATTR_WIDTH, lane.width);
308 }
309 if (lane.endOffset != NBEdge::UNSPECIFIED_OFFSET && (e->hasLaneSpecificEndOffset() || writeLanes)) {
310 edevice.writeAttr(SUMO_ATTR_ENDOFFSET, lane.endOffset);
311 }
312 if (e->hasLaneSpecificSpeed() || writeLanes) {
313 edevice.writeAttr(SUMO_ATTR_SPEED, lane.speed);
314 }
315 if (lane.accelRamp) {
316 edevice.writeAttr(SUMO_ATTR_ACCELERATION, lane.accelRamp);
317 }
318 if (lane.customShape.size() > 0 || writeLanes) {
319 writeShape(edevice, gch, lane.customShape.size() > 0 ? lane.customShape : lane.shape, SUMO_ATTR_SHAPE, useGeo, geoAccuracy);
320 }
321 if (lane.type != "") {
322 edevice.writeAttr(SUMO_ATTR_TYPE, lane.type);
323 }
324 if (lane.changeLeft != SVCAll && lane.changeLeft != SVC_UNSPECIFIED && lane.changeLeft != SVC_IGNORING) {
325 edevice.writeAttr(SUMO_ATTR_CHANGE_LEFT, getVehicleClassNames(lane.changeLeft));
326 }
327 if (lane.changeRight != SVCAll && lane.changeRight != SVC_UNSPECIFIED && lane.changeRight != SVC_IGNORING) {
328 edevice.writeAttr(SUMO_ATTR_CHANGE_RIGHT, getVehicleClassNames(lane.changeRight));
329 }
330 if (lane.oppositeID != "") {
331 edevice.openTag(SUMO_TAG_NEIGH);
332 edevice.writeAttr(SUMO_ATTR_LANE, lane.oppositeID);
333 edevice.closeTag();
334 }
335 lane.writeParams(edevice);
336 NWWriter_SUMO::writeStopOffsets(edevice, lane.laneStopOffset);
337 edevice.closeTag();
338 }
339 }
340 e->writeParams(edevice);
341 edevice.closeTag();
342 // write this edge's connections to the connections-files
343 const std::vector<NBEdge::Connection> connections = e->getConnections();
344 if (connections.empty()) {
345 // if there are no connections and this appears to be customized, preserve the information
346 const int numOutgoing = (int)e->getToNode()->getOutgoingEdges().size();
347 if (numOutgoing > 0) {
348 const SVCPermissions inPerm = e->getPermissions();
349 SVCPermissions outPerm = 0;
350 for (auto out : e->getToNode()->getOutgoingEdges()) {
351 outPerm |= out->getPermissions();
352 }
353 if ((inPerm & outPerm) != 0 && (inPerm & outPerm) != SVC_PEDESTRIAN) {
355 cdevice.writeAttr(SUMO_ATTR_FROM, e->getID());
356 cdevice.closeTag();
357 cdevice << "\n";
358 }
359 }
360 } else {
361 for (NBEdge::Connection c : connections) {
362 if (useGeo) {
363 for (Position& p : c.customShape) {
364 gch.cartesian2geo(p);
365 }
366 }
367 NWWriter_SUMO::writeConnection(cdevice, *e, c, false, NWWriter_SUMO::PLAIN, geoAccuracy);
368 }
369 cdevice << "\n";
370 }
371 }
372 // write roundabout information to the edges-files
373 if (ec.getRoundabouts().size() > 0) {
374 edevice.lf();
376 }
377
378 // write loaded prohibitions to the connections-file
379 for (std::map<std::string, NBNode*>::const_iterator i = nc.begin(); i != nc.end(); ++i) {
380 NWWriter_SUMO::writeProhibitions(cdevice, i->second->getProhibitions());
381 }
382 // write pedestrian crossings to the connections-file
383 for (std::map<std::string, NBNode*>::const_iterator it_node = nc.begin(); it_node != nc.end(); ++it_node) {
384 const std::vector<NBNode::Crossing*>& crossings = (*it_node).second->getCrossings();
385 for (auto c : crossings) {
386 cdevice.openTag(SUMO_TAG_CROSSING);
387 cdevice.writeAttr(SUMO_ATTR_NODE, (*it_node).second->getID());
388 cdevice.writeAttr(SUMO_ATTR_EDGES, c->edges);
389 cdevice.writeAttr(SUMO_ATTR_PRIORITY, c->priority);
390 if (c->customWidth != NBEdge::UNSPECIFIED_WIDTH) {
391 cdevice.writeAttr(SUMO_ATTR_WIDTH, c->customWidth);
392 }
393 if (c->customTLIndex != -1) {
394 cdevice.writeAttr(SUMO_ATTR_TLLINKINDEX, c->customTLIndex);
395 }
396 if (c->customTLIndex2 != -1) {
397 cdevice.writeAttr(SUMO_ATTR_TLLINKINDEX2, c->customTLIndex2);
398 }
399 if (c->customShape.size() != 0) {
400 writeShape(cdevice, gch, c->customShape, SUMO_ATTR_SHAPE, useGeo, geoAccuracy);
401 }
402 if (c->outlineShape.size() != 0) {
403 writeShape(cdevice, gch, c->outlineShape, SUMO_ATTR_OUTLINESHAPE, useGeo, geoAccuracy);
404 }
405 c->writeParams(cdevice);
406 cdevice.closeTag();
407 }
408 }
409 // write custom walkingarea shapes to the connections file
410 for (std::map<std::string, NBNode*>::const_iterator it_node = nc.begin(); it_node != nc.end(); ++it_node) {
411 for (const auto& wacs : it_node->second->getWalkingAreaCustomShapes()) {
413 cdevice.writeAttr(SUMO_ATTR_NODE, it_node->first);
414 cdevice.writeAttr(SUMO_ATTR_EDGES, joinNamedToString(wacs.edges, " "));
415 if (wacs.shape.size() != 0) {
416 writeShape(cdevice, gch, wacs.shape, SUMO_ATTR_SHAPE, useGeo, geoAccuracy);
417 }
418 if (wacs.width != NBEdge::UNSPECIFIED_WIDTH) {
419 cdevice.writeAttr(SUMO_ATTR_WIDTH, wacs.width);
420 }
421 cdevice.closeTag();
422 }
423 }
424
425 edevice.close();
426 cdevice.close();
427}
428
429
430void
432 std::map<SumoXMLAttr, std::string> attrs;
434 OutputDevice& device = OutputDevice::getDevice(prefix + ".tll.xml");
435 device.writeXMLHeader("tlLogics", "tllogic_file.xsd", attrs);
437 // we also need to remember the associations between tlLogics and connections
438 // since the information in con.xml is insufficient
439 for (std::map<std::string, NBEdge*>::const_iterator i = ec.begin(); i != ec.end(); ++i) {
440 NBEdge* e = (*i).second;
441 // write this edge's tl-controlled connections
442 const std::vector<NBEdge::Connection> connections = e->getConnections();
443 for (std::vector<NBEdge::Connection>::const_iterator c = connections.begin(); c != connections.end(); ++c) {
444 if (c->tlID != "") {
446 }
447 }
448 }
449 device.close();
450}
451
452
453void
454NWWriter_XML::writeJoinedJunctions(const std::string& filename, NBNodeCont& nc) {
455 std::map<SumoXMLAttr, std::string> attrs;
457 OutputDevice& device = OutputDevice::getDevice(filename);
458 device.writeXMLHeader("nodes", "nodes_file.xsd", attrs);
459 const std::vector<std::set<std::string> >& clusters = nc.getJoinedClusters();
460 for (std::vector<std::set<std::string> >::const_iterator it = clusters.begin(); it != clusters.end(); it++) {
461 assert((*it).size() > 0);
462 device.openTag(SUMO_TAG_JOIN);
463 // prepare string
464 std::ostringstream oss;
465 for (std::set<std::string>::const_iterator it_id = it->begin(); it_id != it->end(); it_id++) {
466 oss << *it_id << " ";
467 }
468 // remove final space
469 std::string ids = oss.str();
470 device.writeAttr(SUMO_ATTR_NODES, ids.substr(0, ids.size() - 1));
471 device.closeTag();
472 }
473 device.close();
474}
475
476
477void
479 OutputDevice& device = OutputDevice::getDevice(oc.getString("street-sign-output"));
480 device.writeXMLHeader("additional", "additional_file.xsd");
481 for (std::map<std::string, NBEdge*>::const_iterator i = ec.begin(); i != ec.end(); ++i) {
482 NBEdge* e = (*i).second;
483 const std::vector<NBSign>& signs = e->getSigns();
484 for (std::vector<NBSign>::const_iterator it = signs.begin(); it != signs.end(); ++it) {
485 it->writeAsPOI(device, e);
486 }
487 }
488 device.close();
489}
490
491
492void
494 OutputDevice& device = OutputDevice::getDevice(oc.getString("ptstop-output"));
495 device.writeXMLHeader("additional", "additional_file.xsd");
496 for (const auto& stopIt : sc.getStops()) {
497 stopIt.second->write(device);
498 }
499 device.close();
500}
501
502
504 OutputDevice& device = OutputDevice::getDevice(oc.getString("ptline-output"));
505 device.writeXMLHeader("ptLines", "ptlines_file.xsd");
506 for (const auto& item : lc.getLines()) {
507 item.second->write(device);
508 }
509 device.close();
510}
511
512
514 OutputDevice& device = OutputDevice::getDevice(oc.getString("parking-output"));
515 device.writeXMLHeader("additional", "additional_file.xsd");
516 for (NBParking& p : pc) {
517 p.write(device, ec);
518 }
519 device.close();
520}
521
522
523void
525 OutputDevice& device = OutputDevice::getDevice(oc.getString("taz-output"));
526 device.writeXMLHeader("additional", "additional_file.xsd");
527 for (std::map<std::string, NBDistrict*>::const_iterator i = dc.begin(); i != dc.end(); i++) {
528 NWWriter_SUMO::writeDistrict(device, *(*i).second);
529 }
530}
531
532
533void
534NWWriter_XML::writeShape(OutputDevice& out, const GeoConvHelper& gch, PositionVector shape, SumoXMLAttr attr, bool useGeo, bool geoAccuracy) {
535 if (useGeo) {
536 for (int i = 0; i < (int) shape.size(); i++) {
537 gch.cartesian2geo(shape[i]);
538 }
539 }
540 if (geoAccuracy) {
542 }
543 out.writeAttr(attr, shape);
544 if (geoAccuracy) {
545 out.setPrecision();
546 }
547}
548
549
550/****************************************************************************/
#define WRITE_WARNING(msg)
Definition MsgHandler.h:286
#define TL(string)
Definition MsgHandler.h:304
#define TLF(string,...)
Definition MsgHandler.h:306
const SVCPermissions SVCAll
all VClasses are allowed
const SVCPermissions SVC_UNSPECIFIED
permissions not specified
const std::string & getVehicleClassNames(SVCPermissions permissions, bool expand)
Returns the ids of the given classes, divided using a ' '.
void writePermissions(OutputDevice &into, SVCPermissions permissions)
writes allowed disallowed attributes if needed;
void writePreferences(OutputDevice &into, SVCPermissions preferred)
writes allowed disallowed attributes if needed;
long long int SVCPermissions
bitset where each bit declares whether a certain SVC may use this edge/lane
@ SVC_IGNORING
vehicles ignoring classes
@ SVC_PEDESTRIAN
pedestrian
@ SUMO_TAG_JOIN
Join operation.
@ SUMO_TAG_CONNECTION
connectioon between two lanes
@ SUMO_TAG_WALKINGAREA
walking area for pedestrians
@ SUMO_TAG_TYPES
types (edge)
@ SUMO_TAG_CROSSING
crossing between edges for pedestrians
@ SUMO_TAG_NODE
alternative definition for junction
@ SUMO_TAG_LANE
begin/end of the description of a single lane
@ SUMO_TAG_NEIGH
begin/end of the description of a neighboring lane
@ SUMO_TAG_EDGE
begin/end of the description of an edge
LaneSpreadFunction
Numbers representing special SUMO-XML-attribute values Information how the edge's lateral offset shal...
SumoXMLAttr
Numbers representing SUMO-XML - attributes.
@ SUMO_ATTR_NODE
@ SUMO_ATTR_LANE
@ SUMO_ATTR_NODES
a list of node ids, used for controlling joining
@ SUMO_ATTR_TLLINKINDEX2
link: the index of the opposite direction link of a pedestrian crossing
@ SUMO_ATTR_SPEED
@ SUMO_ATTR_RADIUS
The turning radius at an intersection in m.
@ SUMO_ATTR_EDGES
the edges of a route
@ SUMO_ATTR_FRINGE
Fringe type of node.
@ SUMO_ATTR_BIDI
@ SUMO_ATTR_PRIORITY
@ SUMO_ATTR_NUMLANES
@ SUMO_ATTR_SHAPE
edge: the shape in xml-definition
@ SUMO_ATTR_TLTYPE
node: the type of traffic light
@ SUMO_ATTR_CHANGE_LEFT
@ SUMO_ATTR_INDEX
@ SUMO_ATTR_NAME
@ SUMO_ATTR_SPREADTYPE
The information about how to spread the lanes from the given position.
@ SUMO_ATTR_ENDOFFSET
@ SUMO_ATTR_TO
@ SUMO_ATTR_FROM
@ SUMO_ATTR_ACCELERATION
@ SUMO_ATTR_CHANGE_RIGHT
@ SUMO_ATTR_TLID
link,node: the traffic light id responsible for this link
@ SUMO_ATTR_DISTANCE
@ SUMO_ATTR_TYPE
@ SUMO_ATTR_LENGTH
@ SUMO_ATTR_VERSION
@ SUMO_ATTR_ID
@ SUMO_ATTR_RIGHT_OF_WAY
How to compute right of way.
@ SUMO_ATTR_OUTLINESHAPE
edge: the outline shape in xml-definition
@ SUMO_ATTR_CONTROLLED_INNER
@ SUMO_ATTR_WIDTH
@ SUMO_ATTR_TLLINKINDEX
link: the index of the link within the traffic light
@ SUMO_ATTR_KEEP_CLEAR
Whether vehicles must keep the junction clear.
@ SUMO_ATTR_FRICTION
@ SUMO_ATTR_ROUTINGTYPE
int gPrecisionGeo
Definition StdDefs.cpp:29
const MMVersion NETWORK_VERSION(1, 20)
std::string joinNamedToString(const std::set< T *, C > &ns, const T_BETWEEN &between)
Definition ToString.h:326
std::string joinToString(const std::vector< T > &v, const T_BETWEEN &between, std::streamsize accuracy=gPrecision)
Definition ToString.h:283
std::string toString(const T &t, std::streamsize accuracy=gPrecision)
Definition ToString.h:46
static methods for processing the coordinates conversion for the current net
static void writeLocation(OutputDevice &into)
writes the location element
static const GeoConvHelper & getFinal()
the coordinate transformation for writing the location element and for tracking the original coordina...
void cartesian2geo(Position &cartesian) const
Converts the given cartesian (shifted) position to its geo (lat/long) representation.
bool usingInverseGeoProjection() const
Returns the information whether an inverse transformation will happen.
bool usingGeoProjection() const
Returns whether a transformation from geo to metric coordinates will be performed.
A container for districts.
std::map< std::string, NBDistrict * >::const_iterator end() const
Returns the pointer to the end of the stored districts.
std::map< std::string, NBDistrict * >::const_iterator begin() const
Returns the pointer to the begin of the stored districts.
Storage for edges, including some functionality operating on multiple edges.
Definition NBEdgeCont.h:59
const std::set< EdgeSet > getRoundabouts() const
Returns the determined roundabouts.
std::map< std::string, NBEdge * >::const_iterator begin() const
Returns the pointer to the begin of the stored edges.
Definition NBEdgeCont.h:171
std::map< std::string, NBEdge * >::const_iterator end() const
Returns the pointer to the end of the stored edges.
Definition NBEdgeCont.h:178
std::set< std::string > getUsedTypes() const
return all edge types in used
The representation of a single edge during network building.
Definition NBEdge.h:92
SVCPermissions getPermissions(int lane=-1) const
get the union of allowed classes over all lanes or for a specific lane
Definition NBEdge.cpp:4540
const std::vector< Connection > & getConnections() const
Returns the connections.
Definition NBEdge.h:1047
double getLoadedLength() const
Returns the length was set explicitly or the computed length if it wasn't set.
Definition NBEdge.h:608
bool hasLaneSpecificFriction() const
whether lanes differ in friction
Definition NBEdge.cpp:2485
double getLaneWidth() const
Returns the default width of lanes of this edge.
Definition NBEdge.h:648
NBNode * getToNode() const
Returns the destination node of the edge.
Definition NBEdge.h:552
static const double UNSPECIFIED_FRICTION
unspecified lane friction
Definition NBEdge.h:355
const std::vector< NBSign > & getSigns() const
get Signs
Definition NBEdge.h:1478
bool hasLaneSpecificSpeed() const
whether lanes differ in speed
Definition NBEdge.cpp:2475
const PositionVector & getGeometry() const
Returns the geometry of the edge.
Definition NBEdge.h:789
LaneSpreadFunction getLaneSpreadFunction() const
Returns how this edge's lanes' lateral offset is computed.
Definition NBEdge.cpp:1021
bool hasLoadedLength() const
Returns whether a length was set explicitly.
Definition NBEdge.h:618
const std::string & getRoutingType() const
return whether this edge should be a bidi edge
Definition NBEdge.h:1446
const std::vector< NBEdge::Lane > & getLanes() const
Returns the lane definitions.
Definition NBEdge.h:736
bool hasLaneSpecificStopOffsets() const
whether lanes differ in stopOffsets
Definition NBEdge.cpp:2528
double getSpeed() const
Returns the speed allowed on this edge.
Definition NBEdge.h:625
const std::string & getID() const
Definition NBEdge.h:1551
double getDistance() const
get distance
Definition NBEdge.h:685
const StopOffset & getEdgeStopOffset() const
Returns the stopOffset to the end of the edge.
Definition NBEdge.cpp:4393
bool hasLaneSpecificPermissions() const
whether lanes differ in allowed vehicle classes
Definition NBEdge.cpp:2461
bool needsLaneSpecificOutput() const
whether at least one lane has values differing from the edges values
Definition NBEdge.cpp:2583
int getNumLanes() const
Returns the number of lanes.
Definition NBEdge.h:526
bool hasLaneSpecificWidth() const
whether lanes differ in width
Definition NBEdge.cpp:2495
double getFriction() const
Returns the friction on this edge.
Definition NBEdge.h:632
bool hasLaneSpecificEndOffset() const
whether lanes differ in offset
Definition NBEdge.cpp:2517
const std::string & getTypeID() const
get ID of type
Definition NBEdge.h:1187
const std::string & getStreetName() const
Returns the street name of this edge.
Definition NBEdge.h:675
const NBEdge * getBidiEdge() const
Definition NBEdge.h:1537
NBNode * getFromNode() const
Returns the origin node of the edge.
Definition NBEdge.h:545
bool hasDefaultGeometry() const
Returns whether the geometry consists only of the node positions.
Definition NBEdge.cpp:619
int getPriority() const
Returns the priority of the edge.
Definition NBEdge.h:533
static const double UNSPECIFIED_WIDTH
unspecified lane width
Definition NBEdge.h:346
double getEndOffset() const
Returns the offset to the destination node.
Definition NBEdge.h:695
static const double UNSPECIFIED_OFFSET
unspecified lane offset
Definition NBEdge.h:349
Instance responsible for building networks.
NBPTLineCont & getPTLineCont()
Returns a reference to the pt line container.
NBParkingCont & getParkingCont()
NBPTStopCont & getPTStopCont()
Returns a reference to the pt stop container.
NBNodeCont & getNodeCont()
Returns a reference to the node container.
NBEdgeCont & getEdgeCont()
NBDistrictCont & getDistrictCont()
Returns a reference the districts container.
NBTypeCont & getTypeCont()
Returns a reference to the type container.
NBTrafficLightLogicCont & getTLLogicCont()
Returns a reference to the traffic light logics container.
Container for nodes during the netbuilding process.
Definition NBNodeCont.h:57
std::map< std::string, NBNode * >::const_iterator begin() const
Returns the pointer to the begin of the stored nodes.
Definition NBNodeCont.h:113
std::map< std::string, NBNode * >::const_iterator end() const
Returns the pointer to the end of the stored nodes.
Definition NBNodeCont.h:118
const std::vector< std::set< std::string > > & getJoinedClusters() const
gets all joined clusters (see doc for myClusters2Join)
Definition NBNodeCont.h:350
Represents a single node (junction) during network building.
Definition NBNode.h:66
RightOfWay getRightOfWay() const
Returns hint on how to compute right of way.
Definition NBNode.h:300
const std::set< NBTrafficLightDefinition * > & getControllingTLS() const
Returns the traffic lights that were assigned to this node (The set of tls that control this node)
Definition NBNode.h:340
static const double UNSPECIFIED_RADIUS
unspecified lane width
Definition NBNode.h:220
FringeType getFringeType() const
Returns fringe type.
Definition NBNode.h:305
SumoXMLNodeType getType() const
Returns the type of this node.
Definition NBNode.h:285
const EdgeVector & getOutgoingEdges() const
Returns this node's outgoing edges (The edges which start at this node)
Definition NBNode.h:273
bool hasCustomShape() const
return whether the shape was set by the user
Definition NBNode.h:591
const std::string & getName() const
Returns intersection name.
Definition NBNode.h:310
const Position & getPosition() const
Definition NBNode.h:260
const PositionVector & getShape() const
retrieve the junction shape
Definition NBNode.cpp:2781
double getRadius() const
Returns the turning radius of this node.
Definition NBNode.h:290
bool isTLControlled() const
Returns whether this node is controlled by any tls.
Definition NBNode.h:331
bool getKeepClear() const
Returns the keepClear flag.
Definition NBNode.h:295
const std::map< std::string, NBPTLine * > & getLines() const
Container for public transport stops during the net building process.
const std::map< std::string, std::shared_ptr< NBPTStop > > & getStops() const
Returns an unmodifiable reference to the stored pt stops.
The representation of an imported parking area.
Definition NBParking.h:42
The base class for traffic light logic definitions.
A container for traffic light definitions and built programs.
A storage for available edgeTypes of edges.
Definition NBTypeCont.h:52
int size() const
Returns the number of known edgeTypes.
void writeEdgeTypes(OutputDevice &into, const std::set< std::string > &typeIDs=std::set< std::string >()) const
writes all EdgeTypes (and their lanes) as XML
static void writePositionLong(const Position &pos, OutputDevice &dev)
Writes the given position to device in long format (one attribute per dimension)
Definition NWFrame.cpp:216
static void writeConnection(OutputDevice &into, const NBEdge &from, const NBEdge::Connection &c, bool includeInternal, ConnectionStyle style=SUMONET, bool geoAccuracy=false)
Writes connections outgoing from the given edge (also used in NWWriter_XML)
static void writeProhibitions(OutputDevice &into, const NBConnectionProhibits &prohibitions)
writes the given prohibitions
static void writeDistrict(OutputDevice &into, const NBDistrict &d)
Writes a district.
static void writeRoundabouts(OutputDevice &into, const std::set< EdgeSet > &roundabouts, const NBEdgeCont &ec)
Writes roundabouts.
static void writeStopOffsets(OutputDevice &into, const StopOffset &stopOffset)
Write a stopOffset element into output device.
static void writeTrafficLights(OutputDevice &into, const NBTrafficLightLogicCont &tllCont)
writes the traffic light logics to the given device
static void writeStreetSigns(const OptionsCont &oc, NBEdgeCont &ec)
Writes street signs as POIs to file.
static void writeTrafficLights(const std::string &prefix, NBTrafficLightLogicCont &tc, NBEdgeCont &ec)
Writes the traffic lights file.
static void writeTypes(const std::string &prefix, NBEdgeCont &ec, NBTypeCont &tc)
Writes the types file.
static void writeParkingAreas(const OptionsCont &cont, NBParkingCont &pc, NBEdgeCont &ec)
writes imported parking areas to file
static void writeJoinedJunctions(const std::string &filename, NBNodeCont &nc)
Writes the joined-juncionts to file.
static void writeConfig(const OptionsCont &oc, const std::string &prefix, bool haveTypes)
Writes the configuration file for assempling the network from plain-xml files.
static void writeNetwork(const OptionsCont &oc, const std::string &prefix, NBNetBuilder &nb)
Writes the network into XML-files (nodes, edges, connections, traffic lights)
static void writePTLines(const OptionsCont &cont, NBPTLineCont &lc)
static void writeEdgesAndConnections(const OptionsCont &oc, const std::string &prefix, NBNodeCont &nc, NBEdgeCont &ec)
Writes the edges and connections files.
static void writePTStops(const OptionsCont &oc, NBPTStopCont &ec)
Writes the pt stops file.
static void writeShape(OutputDevice &out, const GeoConvHelper &gch, PositionVector shape, SumoXMLAttr attr, bool useGeo, bool geoAccuracy)
static void writeDistricts(const OptionsCont &oc, NBDistrictCont &dc)
writes imported districts (TAZ) to file
static void writeNodes(const OptionsCont &oc, const std::string &prefix, NBNodeCont &nc)
Writes the nodes file.
const std::string & getID() const
Returns the id.
Definition Named.h:74
A storage for options typed value containers)
Definition OptionsCont.h:89
void writeConfiguration(std::ostream &os, const bool filled, const bool complete, const bool addComments, const std::string &relativeTo="", const bool forceRelative=false, const bool inComment=false, const std::string &indent="") const
Writes the configuration.
bool isSet(const std::string &name, bool failOnNonExistant=true) const
Returns the information whether the named option is set.
OptionsCont * clone() const
make a copy of this OptionsCont instance
std::string getString(const std::string &name) const
Returns the string-value of the named option (only for Option_String)
bool setDefault(const std::string &name, const std::string &value)
Sets the given value for the named option as new default value.
bool exists(const std::string &name) const
Returns the information whether the named option is known.
bool set(const std::string &name, const std::string &value, const bool append=false)
Sets the given value for the named option.
bool getBool(const std::string &name) const
Returns the boolean-value of the named option (only for Option_Bool)
Static storage of an output device and its base (abstract) implementation.
void lf()
writes a line feed if applicable
OutputDevice & writeAttr(const SumoXMLAttr attr, const T &val)
writes a named attribute
void close()
Closes the device and removes it from the dictionary.
OutputDevice & openTag(const std::string &xmlElement)
Opens an XML tag.
bool closeTag(const std::string &comment="")
Closes the most recently opened tag and optionally adds a comment.
void setPrecision(int precision=gPrecision)
Sets the precision or resets it to default.
static OutputDevice & getDevice(const std::string &name, bool usePrefix=true)
Returns the described OutputDevice.
bool writeXMLHeader(const std::string &rootElement, const std::string &schemaFile, std::map< SumoXMLAttr, std::string > attrs=std::map< SumoXMLAttr, std::string >(), bool includeConfig=true)
Writes an XML header with optional configuration.
void writeParams(OutputDevice &device) const
write Params in the given outputdevice
A point in 2D or 3D with translation and scaling methods.
Definition Position.h:37
A list of positions.
static StringBijection< LaneSpreadFunction > LaneSpreadFunctions
lane spread functions
static StringBijection< TrafficLightType > TrafficLightTypes
traffic light types
bool isDefined() const
check if stopOffset was defined
T get(const std::string &str) const
get key
static std::string escapeXML(const std::string &orig, const bool maskDoubleHyphen=false)
Replaces the standard escapes by their XML entities.
A structure which describes a connection between edges or lanes.
Definition NBEdge.h:201
An (internal) definition of a single lane of an edge.
Definition NBEdge.h:143