SUMO - Simulation of Urban MObility
 All Data Structures Namespaces Files Functions Variables Typedefs Enumerations Enumerator Friends Macros Groups Pages
NBEdgeCont.h
Go to the documentation of this file.
1 /****************************************************************************/
9 // Storage for edges, including some functionality operating on multiple edges
10 /****************************************************************************/
11 // SUMO, Simulation of Urban MObility; see http://sumo-sim.org/
12 // Copyright (C) 2001-2013 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 #ifndef NBEdgeCont_h
23 #define NBEdgeCont_h
24 
25 
26 // ===========================================================================
27 // included modules
28 // ===========================================================================
29 #ifdef _MSC_VER
30 #include <windows_config.h>
31 #else
32 #include <config.h>
33 #endif
34 
35 #include <map>
36 #include <iostream>
37 #include <string>
38 #include <vector>
39 #include <set>
40 #include "NBCont.h"
44 
45 
46 // ===========================================================================
47 // class declarations
48 // ===========================================================================
49 class NBNodeCont;
50 class NBTypeCont;
51 class NBEdge;
52 class NBNode;
53 class OptionsCont;
54 class NBDistrictCont;
56 class OutputDevice;
57 
58 
59 // ===========================================================================
60 // class definitions
61 // ===========================================================================
66 class NBEdgeCont {
67 public:
72 
73 
75  ~NBEdgeCont();
76 
77 
86  void applyOptions(OptionsCont& oc);
87 
88 
90  void clear();
91 
92 
93 
94 
97 
111  bool insert(NBEdge* edge, bool ignorePrunning = false);
112 
113 
122  NBEdge* retrieve(const std::string& id, bool retrieveExtracted = false) const;
123 
124 
135  NBEdge* retrievePossiblySplit(const std::string& id, bool downstream) const;
136 
137 
150  NBEdge* retrievePossiblySplit(const std::string& id, const std::string& hint, bool incoming) const;
151 
152 
163  NBEdge* retrievePossiblySplit(const std::string& id, SUMOReal pos) const;
164 
165 
172  void erase(NBDistrictCont& dc, NBEdge* edge);
173 
174 
184  void extract(NBDistrictCont& dc, NBEdge* edge, bool remember = false);
185 
186 
190  std::map<std::string, NBEdge*>::const_iterator begin() const {
191  return myEdges.begin();
192  }
193 
194 
198  std::map<std::string, NBEdge*>::const_iterator end() const {
199  return myEdges.end();
200  }
202 
203 
204 
207 
221  bool splitAt(NBDistrictCont& dc, NBEdge* edge, NBNode* node);
222 
223 
244  bool splitAt(NBDistrictCont& dc, NBEdge* edge, NBNode* node,
245  const std::string& firstEdgeName, const std::string& secondEdgeName,
246  unsigned int noLanesFirstEdge, unsigned int noLanesSecondEdge);
247 
248 
261  bool splitAt(NBDistrictCont& dc, NBEdge* edge, SUMOReal edgepos, NBNode* node,
262  const std::string& firstEdgeName, const std::string& secondEdgeName,
263  unsigned int noLanesFirstEdge, unsigned int noLanesSecondEdge);
265 
266 
267 
270 
274  unsigned int size() const {
275  return (unsigned int) myEdges.size();
276  }
277 
278 
283  std::vector<std::string> getAllNames() const;
284 
285 
289  unsigned int getNoEdgeSplits() const {
290  return myEdgesSplit;
291  }
293 
294 
295 
298 
304 
305 
314  void splitGeometry(NBNodeCont& nc);
315 
316 
321  void reduceGeometries(const SUMOReal minDist);
322 
323 
330  void checkGeometries(const SUMOReal maxAngle, const SUMOReal minRadius, bool fix);
332 
333 
334 
337 
346 
347 
356  void computeEdge2Edges(bool noLeftMovers);
357 
358 
366  void computeLanes2Edges();
367 
368 
376  void recheckLanes();
377 
378 
387  void appendTurnarounds(bool noTLSControlled);
388 
389 
396  void appendTurnarounds(const std::set<std::string>& ids, bool noTLSControlled);
397 
398 
407  void computeEdgeShapes();
408 
409 
418  void computeLaneShapes();
419 
420 
423  void clearControllingTLInformation() const;
424 
425 
434  NBTrafficLightLogicCont& tlc, EdgeVector edges);
435 
436 
441  void recheckLaneSpread();
443 
444 
445 
449  void guessRoundabouts(std::vector<EdgeVector>& marked);
450 
451 
455  bool isLeftHanded() const {
456  return myAmLeftHanded;
457  }
458 
459 
463  bool wasIgnored(std::string id) const {
464  return myIgnoredEdges.count(id) != 0;
465  }
466 
467 
470  bool wasRemoved(std::string id) const {
471  return myExtractedEdges.count(id) != 0;
472  }
473 
476  void rename(NBEdge* edge, const std::string& newID);
477 
478 
479 
482 
490  void addPostProcessConnection(const std::string& from, int fromLane, const std::string& to, int toLane, bool mayDefinitelyPass);
491 
492 
497 
499  void generateStreetSigns();
500 
501 private:
508  EdgeVector getGeneratedFrom(const std::string& id) const;
509 
510 
512  bool ignoreFilterMatch(NBEdge* edge);
513 
514 
515 private:
518 
523  public:
531  PostProcessConnection(const std::string& from_, int fromLane_, const std::string& to_, int toLane_, bool mayDefinitelyPass_)
532  : from(from_), fromLane(fromLane_), to(to_), toLane(toLane_), mayDefinitelyPass(mayDefinitelyPass_)
533  { }
535  std::string from;
537  int fromLane;
539  std::string to;
541  int toLane;
544  };
545 
547  std::vector<PostProcessConnection> myConnections;
548 
549 
551  typedef std::map<std::string, NBEdge*> EdgeCont;
552 
555 
558 
560  std::set<std::string> myIgnoredEdges;
561 
563  unsigned int myEdgesSplit;
564 
567 
568 
571 
574 
577 
579  std::set<std::string> myEdges2Keep;
580 
582  std::set<std::string> myEdges2Remove;
583 
586 
589 
591  std::set<std::string> myTypes2Keep;
592 
594  std::set<std::string> myTypes2Remove;
595 
598 
602 
603 
604 private:
606  NBEdgeCont(const NBEdgeCont& s);
607 
609  NBEdgeCont& operator=(const NBEdgeCont& s);
610 
611 
612 };
613 
614 
615 #endif
616 
617 /****************************************************************************/
618 
~NBEdgeCont()
Destructor.
Definition: NBEdgeCont.cpp:78
void sortOutgoingLanesConnections()
Sorts all lanes of all edges within the container by their direction.
Definition: NBEdgeCont.cpp:566
bool myAmLeftHanded
Whether the network is left-handed.
Definition: NBEdgeCont.h:566
NBEdge * retrievePossiblySplit(const std::string &id, bool downstream) const
Tries to retrieve an edge, even if it is splitted.
Definition: NBEdgeCont.cpp:268
std::vector< std::string > getAllNames() const
Returns all ids of known edges.
Definition: NBEdgeCont.cpp:500
bool myNeedGeoTransformedPrunningBoundary
whether a geo transform has been applied to the pruning boundary
Definition: NBEdgeCont.h:600
A container for traffic light definitions and built programs.
bool myRemoveEdgesAfterJoining
Whether edges shall be joined first, then removed.
Definition: NBEdgeCont.h:576
std::map< std::string, NBEdge * > EdgeCont
The type of the dictionary where an edge may be found by its id.
Definition: NBEdgeCont.h:551
The representation of a single edge during network building.
Definition: NBEdge.h:71
unsigned int getNoEdgeSplits() const
Returns the number of edge splits.
Definition: NBEdgeCont.h:289
A container for districts.
void clearControllingTLInformation() const
Clears information about controlling traffic lights for all connenections of all edges.
Definition: NBEdgeCont.cpp:558
void generateStreetSigns()
assigns street signs to edges based on toNode types
Definition: NBEdgeCont.cpp:912
void rename(NBEdge *edge, const std::string &newID)
Renames the edge. Throws exception if newID already exists.
Definition: NBEdgeCont.cpp:382
bool splitAt(NBDistrictCont &dc, NBEdge *edge, NBNode *node)
Splits the edge at the position nearest to the given node.
Definition: NBEdgeCont.cpp:394
void recheckPostProcessConnections()
Try to set any stored connections.
Definition: NBEdgeCont.cpp:735
unsigned int myEdgesSplit
the number of splits of edges during the building
Definition: NBEdgeCont.h:563
void computeLanes2Edges()
Computes for each edge which lanes approach the next edges.
Definition: NBEdgeCont.cpp:582
PostProcessConnection(const std::string &from_, int fromLane_, const std::string &to_, int toLane_, bool mayDefinitelyPass_)
Constructor.
Definition: NBEdgeCont.h:531
std::vector< PostProcessConnection > myConnections
The list of connections to recheck.
Definition: NBEdgeCont.h:547
void checkGeometries(const SUMOReal maxAngle, const SUMOReal minRadius, bool fix)
Definition: NBEdgeCont.cpp:547
void guessRoundabouts(std::vector< EdgeVector > &marked)
Determines which edges belong to roundabouts and increases their priority.
Definition: NBEdgeCont.cpp:807
NBEdgeCont(NBTypeCont &tc)
Constructor.
Definition: NBEdgeCont.cpp:69
SVCPermissions myVehicleClasses2Keep
Set of vehicle types which must be allowed on edges in order to keep them.
Definition: NBEdgeCont.h:585
void reduceGeometries(const SUMOReal minDist)
Definition: NBEdgeCont.cpp:539
std::map< std::string, NBEdge * >::const_iterator end() const
Returns the pointer to the end of the stored edges.
Definition: NBEdgeCont.h:198
bool insert(NBEdge *edge, bool ignorePrunning=false)
Adds an edge to the dictionary.
Definition: NBEdgeCont.cpp:164
void removeUnwishedEdges(NBDistrictCont &dc)
Removes unwished edges (not in keep-edges)
Definition: NBEdgeCont.cpp:511
void extract(NBDistrictCont &dc, NBEdge *edge, bool remember=false)
Removes the given edge from the container like erase but does not delete it.
Definition: NBEdgeCont.cpp:370
A list of positions.
void applyOptions(OptionsCont &oc)
Initialises the storage by applying given options.
Definition: NBEdgeCont.cpp:84
bool mayDefinitelyPass
Whether the connection may be passed without braking.
Definition: NBEdgeCont.h:543
std::set< std::string > myEdges2Keep
Set of ids of edges which shall explicitly be kept.
Definition: NBEdgeCont.h:579
void computeEdge2Edges(bool noLeftMovers)
Computes for each edge the approached edges.
Definition: NBEdgeCont.cpp:574
void computeLaneShapes()
Computes the shapes of all lanes of all edges stored in the container.
Definition: NBEdgeCont.cpp:622
Storage for edges, including some functionality operating on multiple edges.
Definition: NBEdgeCont.h:66
void splitGeometry(NBNodeCont &nc)
Splits edges into multiple if they have a complex geometry.
Definition: NBEdgeCont.cpp:528
EdgeCont myEdges
The instance of the dictionary (id-&gt;edge)
Definition: NBEdgeCont.h:554
void clear()
Deletes all edges.
Definition: NBEdgeCont.cpp:149
EdgeCont myExtractedEdges
The extracted nodes which are kept for reference.
Definition: NBEdgeCont.h:557
void joinSameNodeConnectingEdges(NBDistrictCont &dc, NBTrafficLightLogicCont &tlc, EdgeVector edges)
Joins the given edges because they connect the same nodes.
Definition: NBEdgeCont.cpp:630
SVCPermissions myVehicleClasses2Remove
Set of vehicle types which need not be supported (edges which allow ONLY these are removed) ...
Definition: NBEdgeCont.h:588
std::string from
The id of the edge the connection starts at.
Definition: NBEdgeCont.h:535
std::map< std::string, NBEdge * >::const_iterator begin() const
Returns the pointer to the begin of the stored edges.
Definition: NBEdgeCont.h:190
PositionVector myPrunningBoundary
Boundary within which an edge must be located in order to be kept.
Definition: NBEdgeCont.h:597
std::set< std::string > myTypes2Keep
Set of edges types which shall be kept.
Definition: NBEdgeCont.h:591
SUMOReal myEdgesMinSpeed
The minimum speed an edge may have in order to be kept (default: -1)
Definition: NBEdgeCont.h:573
NBEdge * retrieve(const std::string &id, bool retrieveExtracted=false) const
Returns the edge that has the given id.
Definition: NBEdgeCont.cpp:251
bool wasRemoved(std::string id) const
Returns whether the edge with the id was deleted explicitly.
Definition: NBEdgeCont.h:470
void appendTurnarounds(bool noTLSControlled)
Appends turnarounds to all edges stored in the container.
Definition: NBEdgeCont.cpp:598
bool isLeftHanded() const
Returns whether the built edges are left-handed.
Definition: NBEdgeCont.h:455
std::vector< NBEdge * > EdgeVector
Definition: NBCont.h:38
int toLane
The number of the lane the connection ends at.
Definition: NBEdgeCont.h:541
A storage for options typed value containers)
Definition: OptionsCont.h:108
void erase(NBDistrictCont &dc, NBEdge *edge)
Removes the given edge from the container (deleting it)
Definition: NBEdgeCont.cpp:363
NBEdgeCont & operator=(const NBEdgeCont &s)
invalidated assignment operator
A structure representing a connection between two lanes.
Definition: NBEdgeCont.h:522
void computeEdgeShapes()
Computes the shapes of all edges stored in the container.
Definition: NBEdgeCont.cpp:614
Represents a single node (junction) during network building.
Definition: NBNode.h:74
NBTypeCont & myTypeCont
The network builder; used to obtain type information.
Definition: NBEdgeCont.h:517
std::string to
The id of the edge the connection ends at.
Definition: NBEdgeCont.h:539
void recheckLaneSpread()
Rechecks whether the lane spread is proper.
Definition: NBEdgeCont.cpp:708
Static storage of an output device and its base (abstract) implementation.
Definition: OutputDevice.h:70
#define SUMOReal
Definition: config.h:215
bool wasIgnored(std::string id) const
Returns whether the edge with the id was ignored during parsing.
Definition: NBEdgeCont.h:463
std::set< std::string > myTypes2Remove
Set of edges types which shall be removed.
Definition: NBEdgeCont.h:594
void recheckLanes()
Rechecks whether all lanes have a successor for each of the stored edges.
Definition: NBEdgeCont.cpp:590
Container for nodes during the netbuilding process.
Definition: NBNodeCont.h:63
int fromLane
The number of the lane the connection starts at.
Definition: NBEdgeCont.h:537
std::set< std::string > myIgnoredEdges
The ids of ignored edges.
Definition: NBEdgeCont.h:560
EdgeVector getGeneratedFrom(const std::string &id) const
Returns the edges which have been built by splitting the edge of the given id.
Definition: NBEdgeCont.cpp:765
void addPostProcessConnection(const std::string &from, int fromLane, const std::string &to, int toLane, bool mayDefinitelyPass)
Adds a connection which could not be set during loading.
Definition: NBEdgeCont.cpp:729
bool ignoreFilterMatch(NBEdge *edge)
Returns true if this edge matches one of the removal criteria.
Definition: NBEdgeCont.cpp:188
unsigned int size() const
Returns the number of edges.
Definition: NBEdgeCont.h:274
A storage for available types of edges.
Definition: NBTypeCont.h:56
std::set< std::string > myEdges2Remove
Set of ids of edges which shall explicitly be removed.
Definition: NBEdgeCont.h:582