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") && (oc.getString("junctions.join-output").size() > 0)) {
64 writeJoinedJunctions(oc.getString("junctions.join-output"), nb.getNodeCont());
65 }
66 if (oc.isSet("street-sign-output") && (oc.getString("street-sign-output").size() > 0)) {
68 }
69 if (oc.exists("ptstop-output") && oc.isSet("ptstop-output") && (oc.getString("ptstop-output").size() > 0)) {
71 }
72 if (oc.exists("ptline-output") && oc.isSet("ptline-output") && (oc.getString("ptline-output").size() > 0)) {
74 }
75 if (oc.exists("parking-output") && oc.isSet("parking-output") && (oc.getString("parking-output").size() > 0)) {
77 }
78 if (oc.exists("taz-output") && oc.isSet("taz-output") && (oc.getString("taz-output").size() > 0)) {
80 }
81}
82
83
84void
85NWWriter_XML::writeConfig(const OptionsCont& oc, const std::string& prefix, bool haveTypes) {
86 if (!oc.exists("node-files")) {
87 // do not write configuration for netgen
88 return;
89 }
90 OptionsCont* tmp = oc.clone();
91 tmp->set("node-files", prefix + ".nod.xml");
92 tmp->set("edge-files", prefix + ".edg.xml");
93 tmp->set("connection-files", prefix + ".con.xml");
94 tmp->set("tllogic-files", prefix + ".tll.xml");
95 if (haveTypes) {
96 tmp->set("type-files", prefix + ".typ.xml");
97 }
98 tmp->setDefault("sumo-net-file", "");
99 tmp->setDefault("plain-output-prefix", "");
100
101 const std::string configPath = prefix + ".netccfg";
102 std::ofstream out(configPath.c_str());
103 if (!out.good()) {
104 delete tmp;
105 throw ProcessError(TLF("Could not save configuration to '%'", configPath));
106 } else {
107 tmp->writeConfiguration(out, true, false, false);
108 }
109 delete tmp;
110}
111
112
113void
114NWWriter_XML::writeNodes(const OptionsCont& oc, const std::string& prefix, NBNodeCont& nc) {
116 bool useGeo = oc.exists("proj.plain-geo") && oc.getBool("proj.plain-geo");
117 if (useGeo && !gch.usingGeoProjection()) {
118 WRITE_WARNING(TL("Ignoring option \"proj.plain-geo\" because no geo-conversion has been defined"));
119 useGeo = false;
120 }
121 const bool geoAccuracy = useGeo || gch.usingInverseGeoProjection();
122
123 OutputDevice& device = OutputDevice::getDevice(prefix + ".nod.xml");
124 std::map<SumoXMLAttr, std::string> attrs;
126 device.writeXMLHeader("nodes", "nodes_file.xsd", attrs);
127
128 // write network offsets and projection to allow reconstruction of original coordinates
129 if (!useGeo) {
131 }
132
133 // write nodes
134 TrafficLightType tlsDefaultType = SUMOXMLDefinitions::TrafficLightTypes.get(oc.getString("tls.default-type"));
135 for (std::map<std::string, NBNode*>::const_iterator i = nc.begin(); i != nc.end(); ++i) {
136 NBNode* n = (*i).second;
137 device.openTag(SUMO_TAG_NODE);
138 device.writeAttr(SUMO_ATTR_ID, n->getID());
139 // write position
140 Position pos = n->getPosition();
141 if (useGeo) {
142 gch.cartesian2geo(pos);
143 }
144 if (geoAccuracy) {
146 }
147 NWFrame::writePositionLong(pos, device);
148 if (geoAccuracy) {
149 device.setPrecision();
150 }
151
153 if (n->isTLControlled()) {
154 // set may contain multiple programs for the same id.
155 // make sure ids are unique and sorted
156 std::set<std::string> tlsIDs;
157 std::set<std::string> controlledInnerEdges;
158 std::string tlType = "";
160 tlsIDs.insert(tl->getID());
161 std::vector<std::string> cie = tl->getControlledInnerEdges();
162 controlledInnerEdges.insert(cie.begin(), cie.end());
163 if (tl->getType() != tlsDefaultType) {
164 tlType = toString(tl->getType());
165 }
166 }
167 std::vector<std::string> sortedIDs(tlsIDs.begin(), tlsIDs.end());
168 sort(sortedIDs.begin(), sortedIDs.end());
169 device.writeAttr(SUMO_ATTR_TLID, sortedIDs);
170 if (tlType != "") {
171 device.writeAttr(SUMO_ATTR_TLTYPE, tlType);
172 }
173 if (controlledInnerEdges.size() > 0) {
174 std::vector<std::string> sortedCIEs(controlledInnerEdges.begin(), controlledInnerEdges.end());
175 sort(sortedCIEs.begin(), sortedCIEs.end());
176 device.writeAttr(SUMO_ATTR_CONTROLLED_INNER, joinToString(sortedCIEs, " "));
177 }
178 }
179 if (n->hasCustomShape()) {
180 writeShape(device, gch, n->getShape(), SUMO_ATTR_SHAPE, useGeo, geoAccuracy);
181 }
184 }
185 if (!n->getKeepClear()) {
186 device.writeAttr<bool>(SUMO_ATTR_KEEP_CLEAR, n->getKeepClear());
187 }
189 device.writeAttr<std::string>(SUMO_ATTR_RIGHT_OF_WAY, toString(n->getRightOfWay()));
190 }
192 device.writeAttr<std::string>(SUMO_ATTR_FRINGE, toString(n->getFringeType()));
193 }
195 device.writeAttr<std::string>(SUMO_ATTR_ROUNDABOUT, toString(n->getRoundaboutType()));
196 }
197 if (n->getName() != "") {
198 device.writeAttr<std::string>(SUMO_ATTR_NAME, StringUtils::escapeXML(n->getName()));
199 }
200 n->writeParams(device);
201 device.closeTag();
202 }
203 device.close();
204}
205
206
207void
208NWWriter_XML::writeTypes(const std::string& prefix, NBEdgeCont& ec, NBTypeCont& tc) {
209 OutputDevice& device = OutputDevice::getDevice(prefix + ".typ.xml");
210 std::map<SumoXMLAttr, std::string> attrs;
212 device.writeXMLHeader(toString(SUMO_TAG_TYPES), "types_file.xsd", attrs);
213 std::set<std::string> usedTypes = ec.getUsedTypes();
214 tc.writeEdgeTypes(device, usedTypes);
215 device.close();
216}
217
218
219void
220NWWriter_XML::writeEdgesAndConnections(const OptionsCont& oc, const std::string& prefix, NBNodeCont& nc, NBEdgeCont& ec) {
222 bool useGeo = oc.exists("proj.plain-geo") && oc.getBool("proj.plain-geo");
223 const bool geoAccuracy = useGeo || gch.usingInverseGeoProjection();
224
225 std::map<SumoXMLAttr, std::string> attrs;
227 OutputDevice& edevice = OutputDevice::getDevice(prefix + ".edg.xml");
228 edevice.writeXMLHeader("edges", "edges_file.xsd", attrs);
229 OutputDevice& cdevice = OutputDevice::getDevice(prefix + ".con.xml");
230 cdevice.writeXMLHeader("connections", "connections_file.xsd", attrs);
231 const bool writeNames = oc.getBool("output.street-names");
232 const bool writeLanes = oc.getBool("plain-output.lanes");
233
234 // write network offsets and projection to allow reconstruction of original coordinates at least for geo-referenced networks
235 if (!useGeo && gch.usingGeoProjection()) {
237 }
238 LaneSpreadFunction defaultSpread = SUMOXMLDefinitions::LaneSpreadFunctions.get(oc.getString("default.spreadtype"));
239 for (std::map<std::string, NBEdge*>::const_iterator i = ec.begin(); i != ec.end(); ++i) {
240 // write the edge itself to the edges-files
241 NBEdge* e = (*i).second;
242 edevice.openTag(SUMO_TAG_EDGE);
243 edevice.writeAttr(SUMO_ATTR_ID, e->getID());
244 edevice.writeAttr(SUMO_ATTR_FROM, e->getFromNode()->getID());
245 edevice.writeAttr(SUMO_ATTR_TO, e->getToNode()->getID());
246 if (writeNames && e->getStreetName() != "") {
248 }
250 // write the type if given
251 if (e->getTypeID() != "") {
252 edevice.writeAttr(SUMO_ATTR_TYPE, e->getTypeID());
253 }
254 if (e->getRoutingType() != "") {
256 }
258 if (!e->hasLaneSpecificSpeed()) {
259 edevice.writeAttr(SUMO_ATTR_SPEED, e->getSpeed());
260 }
261 if (!e->hasLaneSpecificFriction()) {
264 }
265 }
266 // write non-default geometry
267 if (!e->hasDefaultGeometry()) {
268 writeShape(edevice, gch, e->getGeometry(), SUMO_ATTR_SHAPE, useGeo, geoAccuracy);
269 }
270 // write the spread type if not default ("right")
271 if (e->getLaneSpreadFunction() != defaultSpread) {
273 }
274 // write the length if it was specified
275 if (e->hasLoadedLength()) {
277 }
278 // some attributes can be set by edge default or per lane. Write as default if possible (efficiency)
281 }
284 }
285 if (!e->hasLaneSpecificPermissions()) {
286 writePermissions(edevice, e->getPermissions(0));
287 }
290 }
291 if (e->getDistance() != 0) {
293 }
294 if (e->getBidiEdge() != 0) {
295 edevice.writeAttr(SUMO_ATTR_BIDI, e->getBidiEdge()->getID());
296 }
297 if (e->needsLaneSpecificOutput() || writeLanes) {
298 int idx = 0;
299 for (const NBEdge::Lane& lane : e->getLanes()) {
300 edevice.openTag(SUMO_TAG_LANE);
301 edevice.writeAttr(SUMO_ATTR_INDEX, idx++);
302 // write allowed lanes
303 if (e->hasLaneSpecificPermissions() || writeLanes) {
304 writePermissions(edevice, lane.permissions);
305 }
306 writePreferences(edevice, lane.preferred);
307 // write other attributes
308 if (lane.width != NBEdge::UNSPECIFIED_WIDTH && (e->hasLaneSpecificWidth() || writeLanes)) {
309 edevice.writeAttr(SUMO_ATTR_WIDTH, lane.width);
310 }
311 if (lane.endOffset != NBEdge::UNSPECIFIED_OFFSET && (e->hasLaneSpecificEndOffset() || writeLanes)) {
312 edevice.writeAttr(SUMO_ATTR_ENDOFFSET, lane.endOffset);
313 }
314 if (e->hasLaneSpecificSpeed() || writeLanes) {
315 edevice.writeAttr(SUMO_ATTR_SPEED, lane.speed);
316 }
317 if (lane.accelRamp) {
318 edevice.writeAttr(SUMO_ATTR_ACCELERATION, lane.accelRamp);
319 }
320 if (lane.customShape.size() > 0 || writeLanes) {
321 writeShape(edevice, gch, lane.customShape.size() > 0 ? lane.customShape : lane.shape, SUMO_ATTR_SHAPE, useGeo, geoAccuracy);
322 }
323 if (lane.type != "") {
324 edevice.writeAttr(SUMO_ATTR_TYPE, lane.type);
325 }
326 if (lane.changeLeft != SVCAll && lane.changeLeft != SVC_UNSPECIFIED && lane.changeLeft != SVC_IGNORING) {
327 edevice.writeAttr(SUMO_ATTR_CHANGE_LEFT, getVehicleClassNames(lane.changeLeft));
328 }
329 if (lane.changeRight != SVCAll && lane.changeRight != SVC_UNSPECIFIED && lane.changeRight != SVC_IGNORING) {
330 edevice.writeAttr(SUMO_ATTR_CHANGE_RIGHT, getVehicleClassNames(lane.changeRight));
331 }
332 if (lane.oppositeID != "") {
333 edevice.openTag(SUMO_TAG_NEIGH);
334 edevice.writeAttr(SUMO_ATTR_LANE, lane.oppositeID);
335 edevice.closeTag();
336 }
337 lane.writeParams(edevice);
338 NWWriter_SUMO::writeStopOffsets(edevice, lane.laneStopOffset);
339 edevice.closeTag();
340 }
341 }
342 e->writeParams(edevice);
343 edevice.closeTag();
344 // write this edge's connections to the connections-files
345 const std::vector<NBEdge::Connection> connections = e->getConnections();
346 if (connections.empty()) {
347 // if there are no connections and this appears to be customized, preserve the information
348 const int numOutgoing = (int)e->getToNode()->getOutgoingEdges().size();
349 if (numOutgoing > 0) {
350 const SVCPermissions inPerm = e->getPermissions();
351 SVCPermissions outPerm = 0;
352 for (auto out : e->getToNode()->getOutgoingEdges()) {
353 outPerm |= out->getPermissions();
354 }
355 if ((inPerm & outPerm) != 0 && (inPerm & outPerm) != SVC_PEDESTRIAN) {
357 cdevice.writeAttr(SUMO_ATTR_FROM, e->getID());
358 cdevice.closeTag();
359 cdevice << "\n";
360 }
361 }
362 } else {
363 for (NBEdge::Connection c : connections) {
364 if (useGeo) {
365 for (Position& p : c.customShape) {
366 gch.cartesian2geo(p);
367 }
368 }
369 NWWriter_SUMO::writeConnection(cdevice, *e, c, false, NWWriter_SUMO::PLAIN, geoAccuracy);
370 }
371 cdevice << "\n";
372 }
373 }
374 // write roundabout information to the edges-files
375 if (ec.getRoundabouts().size() > 0) {
376 edevice.lf();
378 }
379
380 // write loaded prohibitions to the connections-file
381 for (std::map<std::string, NBNode*>::const_iterator i = nc.begin(); i != nc.end(); ++i) {
382 NWWriter_SUMO::writeProhibitions(cdevice, i->second->getProhibitions(), ec);
383 }
384 // write pedestrian crossings to the connections-file
385 for (std::map<std::string, NBNode*>::const_iterator it_node = nc.begin(); it_node != nc.end(); ++it_node) {
386 const std::vector<NBNode::Crossing*>& crossings = (*it_node).second->getCrossings();
387 for (auto c : crossings) {
388 cdevice.openTag(SUMO_TAG_CROSSING);
389 cdevice.writeAttr(SUMO_ATTR_NODE, (*it_node).second->getID());
390 cdevice.writeAttr(SUMO_ATTR_EDGES, c->edges);
391 cdevice.writeAttr(SUMO_ATTR_PRIORITY, c->priority);
392 if (c->customWidth != NBEdge::UNSPECIFIED_WIDTH) {
393 cdevice.writeAttr(SUMO_ATTR_WIDTH, c->customWidth);
394 }
395 if (c->customTLIndex != -1) {
396 cdevice.writeAttr(SUMO_ATTR_TLLINKINDEX, c->customTLIndex);
397 }
398 if (c->customTLIndex2 != -1) {
399 cdevice.writeAttr(SUMO_ATTR_TLLINKINDEX2, c->customTLIndex2);
400 }
401 if (c->customShape.size() != 0) {
402 writeShape(cdevice, gch, c->customShape, SUMO_ATTR_SHAPE, useGeo, geoAccuracy);
403 }
404 if (c->outlineShape.size() != 0) {
405 writeShape(cdevice, gch, c->outlineShape, SUMO_ATTR_OUTLINESHAPE, useGeo, geoAccuracy);
406 }
407 c->writeParams(cdevice);
408 cdevice.closeTag();
409 }
410 }
411 // write custom walkingarea shapes to the connections file
412 for (std::map<std::string, NBNode*>::const_iterator it_node = nc.begin(); it_node != nc.end(); ++it_node) {
413 for (const auto& wacs : it_node->second->getWalkingAreaCustomShapes()) {
415 cdevice.writeAttr(SUMO_ATTR_NODE, it_node->first);
416 cdevice.writeAttr(SUMO_ATTR_EDGES, joinNamedToString(wacs.edges, " "));
417 if (wacs.shape.size() != 0) {
418 writeShape(cdevice, gch, wacs.shape, SUMO_ATTR_SHAPE, useGeo, geoAccuracy);
419 }
420 if (wacs.width != NBEdge::UNSPECIFIED_WIDTH) {
421 cdevice.writeAttr(SUMO_ATTR_WIDTH, wacs.width);
422 }
423 cdevice.closeTag();
424 }
425 }
426
427 edevice.close();
428 cdevice.close();
429}
430
431
432void
434 std::map<SumoXMLAttr, std::string> attrs;
436 OutputDevice& device = OutputDevice::getDevice(prefix + ".tll.xml");
437 device.writeXMLHeader("tlLogics", "tllogic_file.xsd", attrs);
439 // we also need to remember the associations between tlLogics and connections
440 // since the information in con.xml is insufficient
441 for (std::map<std::string, NBEdge*>::const_iterator i = ec.begin(); i != ec.end(); ++i) {
442 NBEdge* e = (*i).second;
443 // write this edge's tl-controlled connections
444 const std::vector<NBEdge::Connection> connections = e->getConnections();
445 for (std::vector<NBEdge::Connection>::const_iterator c = connections.begin(); c != connections.end(); ++c) {
446 if (c->tlID != "") {
448 }
449 }
450 }
451 device.close();
452}
453
454
455void
456NWWriter_XML::writeJoinedJunctions(const std::string& filename, NBNodeCont& nc) {
457 std::map<SumoXMLAttr, std::string> attrs;
459 OutputDevice& device = OutputDevice::getDevice(filename);
460 device.writeXMLHeader("nodes", "nodes_file.xsd", attrs);
461 const std::vector<std::set<std::string> >& clusters = nc.getJoinedClusters();
462 for (std::vector<std::set<std::string> >::const_iterator it = clusters.begin(); it != clusters.end(); it++) {
463 assert((*it).size() > 0);
464 device.openTag(SUMO_TAG_JOIN);
465 // prepare string
466 std::ostringstream oss;
467 for (std::set<std::string>::const_iterator it_id = it->begin(); it_id != it->end(); it_id++) {
468 oss << *it_id << " ";
469 }
470 // remove final space
471 std::string ids = oss.str();
472 device.writeAttr(SUMO_ATTR_NODES, ids.substr(0, ids.size() - 1));
473 device.closeTag();
474 }
475 device.close();
476}
477
478
479void
481 OutputDevice& device = OutputDevice::getDevice(oc.getString("street-sign-output"));
482 device.writeXMLHeader("additional", "additional_file.xsd");
483 for (std::map<std::string, NBEdge*>::const_iterator i = ec.begin(); i != ec.end(); ++i) {
484 NBEdge* e = (*i).second;
485 const std::vector<NBSign>& signs = e->getSigns();
486 for (std::vector<NBSign>::const_iterator it = signs.begin(); it != signs.end(); ++it) {
487 it->writeAsPOI(device, e);
488 }
489 }
490 device.close();
491}
492
493
494void
496 OutputDevice& device = OutputDevice::getDevice(oc.getString("ptstop-output"));
497 device.writeXMLHeader("additional", "additional_file.xsd");
498 for (const auto& stopIt : sc.getStops()) {
499 stopIt.second->write(device);
500 }
501 device.close();
502}
503
504
506 OutputDevice& device = OutputDevice::getDevice(oc.getString("ptline-output"));
507 device.writeXMLHeader("ptLines", "ptlines_file.xsd");
508 for (const auto& item : lc.getLines()) {
509 item.second->write(device);
510 }
511 device.close();
512}
513
514
516 OutputDevice& device = OutputDevice::getDevice(oc.getString("parking-output"));
517 device.writeXMLHeader("additional", "additional_file.xsd");
518 for (NBParking& p : pc) {
519 p.write(device, ec);
520 }
521 device.close();
522}
523
524
525void
527 OutputDevice& device = OutputDevice::getDevice(oc.getString("taz-output"));
528 device.writeXMLHeader("additional", "additional_file.xsd");
529 for (std::map<std::string, NBDistrict*>::const_iterator i = dc.begin(); i != dc.end(); i++) {
530 NWWriter_SUMO::writeDistrict(device, *(*i).second);
531 }
532}
533
534
535void
536NWWriter_XML::writeShape(OutputDevice& out, const GeoConvHelper& gch, PositionVector shape, SumoXMLAttr attr, bool useGeo, bool geoAccuracy) {
537 if (useGeo) {
538 for (int i = 0; i < (int) shape.size(); i++) {
539 gch.cartesian2geo(shape[i]);
540 }
541 }
542 if (geoAccuracy) {
544 }
545 out.writeAttr(attr, shape);
546 if (geoAccuracy) {
547 out.setPrecision();
548 }
549}
550
551
552/****************************************************************************/
#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_ROUNDABOUT
Roundabout type of node.
@ 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:332
std::string joinToString(const std::vector< T > &v, const T_BETWEEN &between, std::streamsize accuracy=gPrecision)
Definition ToString.h:289
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:345
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:601
const std::string & getName() const
Returns intersection name.
Definition NBNode.h:315
const Position & getPosition() const
Definition NBNode.h:260
const PositionVector & getShape() const
retrieve the junction shape
Definition NBNode.cpp:2783
RoundaboutType getRoundaboutType() const
Returns roundabout type.
Definition NBNode.h:310
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:336
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 writeProhibitions(OutputDevice &into, const NBConnectionProhibits &prohibitions, const NBEdgeCont &ec)
writes the given prohibitions
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 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