SUMO - Simulation of Urban MObility
 All Data Structures Namespaces Files Functions Variables Typedefs Enumerations Enumerator Friends Macros Groups Pages
MSRoute.h
Go to the documentation of this file.
1 /****************************************************************************/
10 // A vehicle route
11 /****************************************************************************/
12 // SUMO, Simulation of Urban MObility; see http://sumo-sim.org/
13 // Copyright (C) 2001-2013 DLR (http://www.dlr.de/) and contributors
14 /****************************************************************************/
15 //
16 // This file is part of SUMO.
17 // SUMO is free software: you can redistribute it and/or modify
18 // it under the terms of the GNU General Public License as published by
19 // the Free Software Foundation, either version 3 of the License, or
20 // (at your option) any later version.
21 //
22 /****************************************************************************/
23 #ifndef MSRoute_h
24 #define MSRoute_h
25 
26 
27 // ===========================================================================
28 // included modules
29 // ===========================================================================
30 #ifdef _MSC_VER
31 #include <windows_config.h>
32 #else
33 #include <config.h>
34 #endif
35 
36 #include <string>
37 #include <map>
38 #include <vector>
39 #include <algorithm>
40 #include <utils/common/Named.h>
42 #include <utils/common/RGBColor.h>
45 
46 
47 // ===========================================================================
48 // class declarations
49 // ===========================================================================
50 class MSEdge;
51 class BinaryInputDevice;
53 
54 
55 // ===========================================================================
56 // types definitions
57 // ===========================================================================
58 typedef std::vector<const MSEdge*> MSEdgeVector;
59 typedef MSEdgeVector::const_iterator MSRouteIterator;
60 
61 
62 // ===========================================================================
63 // class definitions
64 // ===========================================================================
68 class MSRoute : public Named, public Parameterised {
69 public:
71  MSRoute(const std::string& id, const MSEdgeVector& edges,
72  unsigned int references, const RGBColor* const c,
73  const std::vector<SUMOVehicleParameter::Stop>& stops);
74 
76  virtual ~MSRoute();
77 
79  MSRouteIterator begin() const;
80 
82  MSRouteIterator end() const;
83 
85  unsigned size() const;
86 
88  const MSEdge* getLastEdge() const;
89 
91  void addReference() const;
92 
94  void release() const;
95 
102  int writeEdgeIDs(OutputDevice& os, const MSEdge* const from, const MSEdge* const upTo = 0) const;
103 
104  bool contains(const MSEdge* const edge) const {
105  return std::find(myEdges.begin(), myEdges.end(), edge) != myEdges.end();
106  }
107 
108  bool containsAnyOf(const std::vector<MSEdge*>& edgelist) const;
109 
110  const MSEdge* operator[](unsigned index) const;
111 
114 
119  static void dict_saveState(OutputDevice& out);
121 
122  const MSEdgeVector& getEdges() const {
123  return myEdges;
124  }
125 
126  SUMOReal getLength() const;
127 
136  SUMOReal getDistanceBetween(SUMOReal fromPos, SUMOReal toPos, const MSEdge* fromEdge, const MSEdge* toEdge) const;
137 
139  const RGBColor& getColor() const;
140 
142  const std::vector<SUMOVehicleParameter::Stop>& getStops() const;
143 
144 public:
154  static bool dictionary(const std::string& id, const MSRoute* route);
155 
165  static bool dictionary(const std::string& id, RandomDistributor<const MSRoute*>* routeDist);
166 
175  static const MSRoute* dictionary(const std::string& id);
176 
184  static RandomDistributor<const MSRoute*>* distDictionary(const std::string& id);
185 
187  static void clear();
188 
189  static void insertIDs(std::vector<std::string>& into);
190 
192  static void releaseRoute(const MSRoute* route) {
193  route->release();
194  }
195 
196  static void setMaxRouteDistSize(unsigned int size) {
198  }
199 
200  static unsigned int getMaxRouteDistSize() {
201  return MaxRouteDistSize;
202  }
203 
204 private:
207 
209  mutable unsigned int myReferenceCounter;
210 
212  const RGBColor* const myColor;
213 
215  std::vector<SUMOVehicleParameter::Stop> myStops;
216 
217 private:
219  typedef std::map<std::string, const MSRoute*> RouteDict;
220 
223 
225  typedef std::map<std::string, RandomDistributor<const MSRoute*>*> RouteDistDict;
226 
229 
231  static unsigned int MaxRouteDistSize;
232 
233 private:
235  MSRoute& operator=(const MSRoute& s);
236 
237 };
238 
239 
240 #endif
241 
242 /****************************************************************************/
243 
std::map< std::string, const MSRoute * > RouteDict
Definition of the dictionary container.
Definition: MSRoute.h:219
int writeEdgeIDs(OutputDevice &os, const MSEdge *const from, const MSEdge *const upTo=0) const
Output the edge ids up to but not including the id of the given edge.
Definition: MSRoute.cpp:185
MSRoute & operator=(const MSRoute &s)
MSEdgeVector::const_iterator MSRouteIterator
Definition: MSRoute.h:59
const MSEdge * getLastEdge() const
returns the destination edge
Definition: MSRoute.cpp:93
const MSEdgeVector & getEdges() const
Definition: MSRoute.h:122
static RandomDistributor< const MSRoute * > * distDictionary(const std::string &id)
Returns the named route distribution.
Definition: MSRoute.cpp:150
SUMOReal getDistanceBetween(SUMOReal fromPos, SUMOReal toPos, const MSEdge *fromEdge, const MSEdge *toEdge) const
Compute the distance between 2 given edges on this route, including the length of internal lanes...
Definition: MSRoute.cpp:250
const std::vector< SUMOVehicleParameter::Stop > & getStops() const
Returns the stops.
Definition: MSRoute.cpp:302
static void releaseRoute(const MSRoute *route)
release the route (to be used as function pointer with RandomDistributor)
Definition: MSRoute.h:192
static void dict_saveState(OutputDevice &out)
Saves all known routes into the given stream.
Definition: MSRoute.cpp:224
static unsigned int getMaxRouteDistSize()
Definition: MSRoute.h:200
static void insertIDs(std::vector< std::string > &into)
Definition: MSRoute.cpp:173
A road/street connecting two junctions.
Definition: MSEdge.h:73
static void clear()
Clears the dictionary (delete all known routes, too)
Definition: MSRoute.cpp:160
std::map< std::string, RandomDistributor< const MSRoute * > * > RouteDistDict
Definition of the dictionary container.
Definition: MSRoute.h:225
std::vector< const MSEdge * > MSEdgeVector
Definition: MSPerson.h:53
bool containsAnyOf(const std::vector< MSEdge * > &edgelist) const
Definition: MSRoute.cpp:206
static RouteDistDict myDistDict
The dictionary container.
Definition: MSRoute.h:228
MSEdgeVector myEdges
The list of edges to pass.
Definition: MSRoute.h:206
bool contains(const MSEdge *const edge) const
Definition: MSRoute.h:104
virtual ~MSRoute()
Destructor.
Definition: MSRoute.cpp:69
SUMOReal getLength() const
Definition: MSRoute.cpp:240
An upper class for objects with additional parameters.
Definition: Parameterised.h:46
static void setMaxRouteDistSize(unsigned int size)
Definition: MSRoute.h:196
void addReference() const
increments the reference counter for the route
Definition: MSRoute.cpp:100
std::vector< SUMOVehicleParameter::Stop > myStops
List of the stops on the parsed route.
Definition: MSRoute.h:215
Base class for objects which have an id.
Definition: Named.h:45
MSRouteIterator end() const
Returns the end of the list of edges to pass.
Definition: MSRoute.cpp:81
MSRoute(const std::string &id, const MSEdgeVector &edges, unsigned int references, const RGBColor *const c, const std::vector< SUMOVehicleParameter::Stop > &stops)
Constructor.
Definition: MSRoute.cpp:60
unsigned size() const
Returns the number of edges to pass.
Definition: MSRoute.cpp:87
const MSEdge * operator[](unsigned index) const
Definition: MSRoute.cpp:218
Static storage of an output device and its base (abstract) implementation.
Definition: OutputDevice.h:70
const RGBColor & getColor() const
Returns the color.
Definition: MSRoute.cpp:293
#define SUMOReal
Definition: config.h:221
unsigned int myReferenceCounter
Information by how many vehicles the route is used.
Definition: MSRoute.h:209
void release() const
deletes the route if there are no further references to it
Definition: MSRoute.cpp:106
Encapsulates binary reading operations on a file.
static unsigned int MaxRouteDistSize
the maximum size for each routeDistribution
Definition: MSRoute.h:231
static RouteDict myDict
The dictionary container.
Definition: MSRoute.h:222
const RGBColor *const myColor
The color.
Definition: MSRoute.h:212
MSRouteIterator begin() const
Returns the begin of the list of edges to pass.
Definition: MSRoute.cpp:75
static bool dictionary(const std::string &id, const MSRoute *route)
Adds a route to the dictionary.
Definition: MSRoute.cpp:116