Eclipse SUMO - Simulation of Urban MObility
RORoutable.h
Go to the documentation of this file.
1 /****************************************************************************/
2 // Eclipse SUMO, Simulation of Urban MObility; see https://eclipse.org/sumo
3 // Copyright (C) 2002-2020 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 /****************************************************************************/
18 // A routable thing such as a vehicle or person
19 /****************************************************************************/
20 #pragma once
21 #include <config.h>
22 
23 #include <string>
24 #include <iostream>
25 #include <utils/common/StdDefs.h>
26 #include <utils/common/SUMOTime.h>
30 
31 // ===========================================================================
32 // class declarations
33 // ===========================================================================
34 class OutputDevice;
35 class ROEdge;
36 class ROLane;
37 class RONode;
38 class ROVehicle;
39 
40 typedef std::vector<const ROEdge*> ConstROEdgeVector;
43 
44 
45 // ===========================================================================
46 // class definitions
47 // ===========================================================================
52 class RORoutable {
53 public:
60  : myParameter(pars), myType(type), myRoutingSuccess(false) {}
61 
62 
64  virtual ~RORoutable() {}
65 
66 
71  inline const SUMOVehicleParameter& getParameter() const {
72  return myParameter;
73  }
74 
75 
82  inline const SUMOVTypeParameter* getType() const {
83  return myType;
84  }
85 
86 
91  inline const std::string& getID() const {
92  return myParameter.id;
93  }
94 
95 
100  inline SUMOTime getDepart() const {
101  return myParameter.depart;
102  }
103 
104 
105  inline SUMOVehicleClass getVClass() const {
106  return getType() != 0 ? getType()->vehicleClass : SVC_IGNORING;
107  }
108 
109 
111  inline double getMaxSpeed() const {
112  return myType->maxSpeed;
113  }
114 
115 
116  virtual const ROEdge* getDepartEdge() const = 0;
117 
118 
119  inline bool isPublicTransport() const {
120  return myParameter.line != "";
121  }
122 
123  inline bool isPartOfFlow() const {
124  return myParameter.repetitionNumber >= 0;
125  }
126 
127  virtual void computeRoute(const RORouterProvider& provider,
128  const bool removeLoops, MsgHandler* errorHandler) = 0;
129 
130 
138  void write(OutputDevice& os, OutputDevice* const altos,
139  OutputDevice* const typeos, OptionsCont& options) const {
140  if (altos == 0 && typeos == 0) {
141  saveAsXML(os, &os, false, options);
142  } else {
143  saveAsXML(os, typeos, false, options);
144  }
145  if (altos != 0) {
146  saveAsXML(*altos, typeos, true, options);
147  }
148  }
149 
150 
151  inline bool getRoutingSuccess() const {
152  return myRoutingSuccess;
153  }
154 
155 
156 protected:
167  virtual void saveAsXML(OutputDevice& os, OutputDevice* const typeos, bool asAlternatives, OptionsCont& options) const = 0;
168 
169 
170 private:
173 
176 
177 protected:
180 
181 
182 private:
184  RORoutable(const RORoutable& src);
185 
188 
189 };
IntermodalRouter< ROEdge, ROLane, RONode, ROVehicle > ROIntermodalRouter
Definition: RORoutable.h:41
RouterProvider< ROEdge, ROLane, RONode, ROVehicle > RORouterProvider
Definition: RORoutable.h:42
std::vector< const ROEdge * > ConstROEdgeVector
Definition: RORoutable.h:38
long long int SUMOTime
Definition: SUMOTime.h:31
SUMOVehicleClass
Definition of vehicle classes to differ between different lane usage and authority types.
@ SVC_IGNORING
vehicles ignoring classes
A storage for options typed value containers)
Definition: OptionsCont.h:89
Static storage of an output device and its base (abstract) implementation.
Definition: OutputDevice.h:60
A basic edge for routing applications.
Definition: ROEdge.h:70
A single lane the router may use.
Definition: ROLane.h:48
Base class for nodes used by the router.
Definition: RONode.h:43
A routable thing such as a vehicle or person.
Definition: RORoutable.h:52
bool getRoutingSuccess() const
Definition: RORoutable.h:151
SUMOVehicleParameter myParameter
The vehicle's parameter.
Definition: RORoutable.h:172
void write(OutputDevice &os, OutputDevice *const altos, OutputDevice *const typeos, OptionsCont &options) const
Saves the routable including the vehicle type (if it was not saved before).
Definition: RORoutable.h:138
RORoutable(const RORoutable &src)
Invalidated copy constructor.
const SUMOVTypeParameter *const myType
The type of the vehicle.
Definition: RORoutable.h:175
const SUMOVehicleParameter & getParameter() const
Returns the definition of the vehicle / person parameter.
Definition: RORoutable.h:71
const std::string & getID() const
Returns the id of the routable.
Definition: RORoutable.h:91
SUMOVehicleClass getVClass() const
Definition: RORoutable.h:105
bool isPublicTransport() const
Definition: RORoutable.h:119
const SUMOVTypeParameter * getType() const
Returns the type of the routable.
Definition: RORoutable.h:82
bool isPartOfFlow() const
Definition: RORoutable.h:123
RORoutable(const SUMOVehicleParameter &pars, const SUMOVTypeParameter *type)
Constructor.
Definition: RORoutable.h:59
virtual void computeRoute(const RORouterProvider &provider, const bool removeLoops, MsgHandler *errorHandler)=0
SUMOTime getDepart() const
Returns the time the vehicle starts at, -1 for triggered vehicles.
Definition: RORoutable.h:100
bool myRoutingSuccess
Whether the last routing was successful.
Definition: RORoutable.h:179
virtual const ROEdge * getDepartEdge() const =0
RORoutable & operator=(const RORoutable &src)
Invalidated assignment operator.
double getMaxSpeed() const
Returns the vehicle's maximum speed.
Definition: RORoutable.h:111
virtual ~RORoutable()
Destructor.
Definition: RORoutable.h:64
virtual void saveAsXML(OutputDevice &os, OutputDevice *const typeos, bool asAlternatives, OptionsCont &options) const =0
Saves the complete routable description.
A vehicle as used by router.
Definition: ROVehicle.h:50
Structure representing possible vehicle parameter.
double maxSpeed
The vehicle type's maximum speed [m/s].
SUMOVehicleClass vehicleClass
The vehicle's class.
Structure representing possible vehicle parameter.
std::string id
The vehicle's id.
std::string line
The vehicle's line (mainly for public transport)