Eclipse SUMO - Simulation of Urban MObility
MSTransportable.h
Go to the documentation of this file.
1/****************************************************************************/
2// Eclipse SUMO, Simulation of Urban MObility; see https://eclipse.org/sumo
3// Copyright (C) 2001-2023 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// The common superclass for modelling transportable objects like persons and containers
19/****************************************************************************/
20#pragma once
21#include <config.h>
22
23#include <set>
24#include <cassert>
28#include <utils/geom/Position.h>
30#include <utils/geom/Boundary.h>
33#include "MSStage.h"
34
35
36// ===========================================================================
37// class declarations
38// ===========================================================================
39class MSEdge;
40class MSLane;
41class MSNet;
42class MSStoppingPlace;
43class MSVehicleType;
44class OutputDevice;
46class SUMOVehicle;
48
49typedef std::vector<const MSEdge*> ConstMSEdgeVector;
50
51// ===========================================================================
52// class definitions
53// ===========================================================================
60public:
63 inline bool isPerson() const {
64 return myAmPerson;
65 }
66
67 inline bool isContainer() const {
68 return !myAmPerson;
69 }
70
71 inline std::string getObjectType() {
72 return myAmPerson ? "Person" : "Container";
73 }
74
75 inline NumericalID getNumericalID() const {
76 return myNumericalID;
77 }
78
79 inline bool isStopped() const {
81 }
82
83 double getSlope() const;
84
86
88 virtual bool isJammed() const {
89 return false;
90 }
91
95 double getMaxSpeed() const;
96
98
99 double getPreviousSpeed() const {
100 return getSpeed();
101 }
102
103 double getAcceleration() const {
104 return 0.0;
105 }
106
107 double getPositionOnLane() const {
108 return getEdgePos();
109 }
110
111 double getBackPositionOnLane(const MSLane* lane) const;
112
113 Position getPosition(const double /*offset*/) const {
114 return getPosition();
115 }
117
119 typedef std::vector<MSStage*> MSTransportablePlan;
120
122 MSTransportable(const SUMOVehicleParameter* pars, MSVehicleType* vtype, MSTransportablePlan* plan, const bool isPerson);
123
125 virtual ~MSTransportable();
126
127 /* @brief proceeds to the next step of the route,
128 * @return Whether the transportables plan continues */
129 virtual bool proceed(MSNet* net, SUMOTime time, const bool vehicleArrived = false);
130
131 virtual bool checkAccess(const MSStage* const prior, const bool waitAtStop = true) {
132 UNUSED_PARAMETER(prior);
133 UNUSED_PARAMETER(waitAtStop);
134 return false;
135 }
136
138 void setID(const std::string& newID);
139
140 inline const SUMOVehicleParameter& getParameter() const {
141 return *myParameter;
142 }
143
144 inline const MSVehicleType& getVehicleType() const {
145 return *myVType;
146 }
147
149 SumoRNG* getRNG() const;
150
153
155 void setDeparted(SUMOTime now);
156
158 SUMOTime getDeparture() const;
159
161 const MSEdge* getDestination() const {
162 return (*myStep)->getDestination();
163 }
164
166 const MSEdge* getNextDestination() const {
167 return (*(myStep + 1))->getDestination();
168 }
169
171 const MSEdge* getEdge() const {
172 return (*myStep)->getEdge();
173 }
174
176 const MSLane* getLane() const {
177 return (*myStep)->getLane();
178 }
179
181 const MSEdge* getFromEdge() const {
182 return (*myStep)->getFromEdge();
183 }
184
186 virtual double getEdgePos() const;
187
189 virtual int getDirection() const;
190
192 virtual Position getPosition() const;
193
195 virtual double getAngle() const;
196
198 virtual double getWaitingSeconds() const;
199
201 virtual double getSpeed() const;
202
204 virtual double getChosenSpeedFactor() const {
205 return 1;
206 }
207
210 return (*myStep)->getStageType();
211 }
212
214 MSStageType getStageType(int next) const {
215 assert(myStep + next < myPlan->end());
216 assert(myStep + next >= myPlan->begin());
217 return (*(myStep + next))->getStageType();
218 }
219
221 std::string getStageSummary(int stageIndex) const;
222
224 std::string getCurrentStageDescription() const {
225 return (*myStep)->getStageDescription(myAmPerson);
226 }
227
230 return *myStep;
231 }
232
234 MSStage* getNextStage(int next) const {
235 assert(myStep + next >= myPlan->begin());
236 assert(myStep + next < myPlan->end());
237 return *(myStep + next);
238 }
239
241 ConstMSEdgeVector getEdges(int next) const {
242 assert(myStep + next < myPlan->end());
243 assert(myStep + next >= myPlan->begin());
244 return (*(myStep + next))->getEdges();
245 }
246
248 int getNumRemainingStages() const;
249
251 int getNumStages() const;
252
254 int getRoutePosition() const {
255 return (*myStep)->getRoutePosition();
256 }
257
259 virtual const MSEdge* getNextEdgePtr() const {
260 return nullptr;
261 }
262
268 void tripInfoOutput(OutputDevice& os) const;
269
275 void routeOutput(OutputDevice& os, const bool withRouteLength) const;
276
278 bool isWaitingFor(const SUMOVehicle* vehicle) const {
279 return (*myStep)->isWaitingFor(vehicle);
280 }
281
283 bool isWaiting4Vehicle() const {
284 return (*myStep)->isWaiting4Vehicle();
285 }
286
287 void setAbortWaiting(const SUMOTime timeout);
288
291
294 return (*myStep)->getVehicle();
295 }
296
298 void appendStage(MSStage* stage, int next = -1);
299
301 void removeStage(int next, bool stayInSim = true);
302
304 void setSpeed(double speed);
305
307 double getArrivalPos() const {
308 return myPlan->back()->getArrivalPos();
309 }
310
312 const MSEdge* getArrivalEdge() const {
313 return myPlan->back()->getEdges().back();
314 }
315
325
326
335
336
339
341 bool hasArrived() const;
342
344 bool hasDeparted() const;
345
347 void rerouteParkingArea(MSStoppingPlace* orig, MSStoppingPlace* replacement);
348
350 MSTransportableDevice* getDevice(const std::type_info& type) const;
351
353 void setJunctionModelParameter(const std::string& key, const std::string& value);
354
358 inline const std::vector<MSTransportableDevice*>& getDevices() const {
359 return myDevices;
360 }
361
362 virtual bool hasInfluencer() const {
363 return false;
364 }
365
367 virtual bool isSelected() const {
368 return false;
369 }
370
373 void saveState(OutputDevice& out);
374
377 void loadState(const std::string& state);
378
379protected:
382
386
389
392
394 MSTransportablePlan::iterator myStep;
395
397 std::vector<MSTransportableDevice*> myDevices;
398
399private:
400 const bool myAmPerson;
401
403
405
407
408private:
411
414
415};
long long int SUMOTime
Definition: GUI.h:36
std::vector< const MSEdge * > ConstMSEdgeVector
Definition: MSEdge.h:74
MSStageType
Definition: MSStage.h:54
std::vector< const MSEdge * > ConstMSEdgeVector
SUMOVehicleClass
Definition of vehicle classes to differ between different lane usage and authority types.
#define UNUSED_PARAMETER(x)
Definition: StdDefs.h:30
A road/street connecting two junctions.
Definition: MSEdge.h:77
Representation of a lane in the micro simulation.
Definition: MSLane.h:84
The simulated network and simulation perfomer.
Definition: MSNet.h:88
A lane area vehicles can halt at.
Abstract in-person device.
const MSEdge * getFromEdge() const
Returns the departure edge.
virtual double getChosenSpeedFactor() const
the current speed factor of the transportable (where applicable)
virtual double getEdgePos() const
Return the position on the edge.
bool hasDeparted() const
return whether the transportable has started it's plan
SUMOVehicleClass getVClass() const
Returns the object's access class.
static NumericalID myCurrentNumericalIndex
SUMOTime getWaitingTime() const
const std::vector< MSTransportableDevice * > & getDevices() const
Returns this vehicle's devices.
double getAcceleration() const
Returns the object's acceleration.
SUMOTime getDeparture() const
logs depart time of the current stage
std::string getCurrentStageDescription() const
Returns the current stage description as a string.
const MSLane * getLane() const
Returns the current lane (may be nullptr)
double getBackPositionOnLane(const MSLane *lane) const
Get the object's back position along the given lane.
const MSEdge * getDestination() const
Returns the current destination.
virtual double getAngle() const
return the current angle of the transportable
const MSEdge * getArrivalEdge() const
returns the final arrival edge
void setAbortWaiting(const SUMOTime timeout)
MSStageType getStageType(int next) const
the stage type for the nth next stage
bool myWriteEvents
Whether events shall be written.
void routeOutput(OutputDevice &os, const bool withRouteLength) const
Called on writing vehroute output.
bool isWaiting4Vehicle() const
Whether the transportable waits for a vehicle.
void setJunctionModelParameter(const std::string &key, const std::string &value)
set individual junction model paramete (not type related)
int getNumRemainingStages() const
Return the number of remaining stages (including the current)
virtual double getSpeed() const
the current speed of the transportable
PositionVector getBoundingBox() const
return the bounding box of the person
const bool myAmPerson
virtual bool checkAccess(const MSStage *const prior, const bool waitAtStop=true)
SUMOTime abortStage(SUMOTime step)
Abort current stage (used for aborting waiting for a vehicle)
std::string getStageSummary(int stageIndex) const
return textual summary for the given stage
MSTransportable & operator=(const MSTransportable &)
Invalidated assignment operator.
MSTransportableDevice * getDevice(const std::type_info &type) const
Returns a device of the given type if it exists or 0.
MSStage * getCurrentStage() const
Return the current stage.
void setDeparted(SUMOTime now)
logs depart time of the current stage
void setSpeed(double speed)
set the speed for all present and future (walking) stages and modify the vType so that stages added l...
virtual bool proceed(MSNet *net, SUMOTime time, const bool vehicleArrived=false)
virtual bool isSelected() const
whether this transportable is selected in the GUI
MSTransportablePlan::iterator myStep
the iterator over the route
MSTransportablePlan * myPlan
the plan of the transportable
void removeStage(int next, bool stayInSim=true)
removes the nth next stage
const MSEdge * getNextDestination() const
Returns the destination after the current destination.
bool isStopped() const
Returns whether the object is at a stop.
SUMOVehicle * getVehicle() const
The vehicle associated with this transportable.
MSVehicleType * myVType
This transportable's type. (mainly used for drawing related information Note sure if it is really nec...
int getRoutePosition() const
return index of edge within route
bool isPerson() const
Whether it is a person.
virtual Position getPosition() const
Return the Network coordinate of the transportable.
const SUMOVehicleParameter * myParameter
the plan of the transportable
double getPreviousSpeed() const
Returns the object's previous speed.
ConstMSEdgeVector getEdges(int next) const
Return the edges of the nth next stage.
Position getPosition(const double) const
Return current position (x/y, cartesian)
double getArrivalPos() const
returns the final arrival pos
double getPositionOnLane() const
Get the object's position along the lane.
void saveState(OutputDevice &out)
Saves the current state into the given stream.
bool isContainer() const
Whether it is a container.
const MSVehicleType & getVehicleType() const
Returns the object's "vehicle" type.
virtual ~MSTransportable()
destructor
int getNumStages() const
Return the total number stages in this persons plan.
MSStageType getCurrentStageType() const
the current stage type of the transportable
NumericalID getNumericalID() const
return the numerical ID which is only for internal usage
void rerouteParkingArea(MSStoppingPlace *orig, MSStoppingPlace *replacement)
adapt plan when the vehicle reroutes and now stops at replacement instead of orig
std::string getObjectType()
void loadState(const std::string &state)
Reconstructs the current state.
std::vector< MSTransportableDevice * > myDevices
The devices this transportable has.
virtual double getWaitingSeconds() const
the time this transportable spent waiting in seconds
MSTransportable(const SUMOVehicleParameter *pars, MSVehicleType *vtype, MSTransportablePlan *plan, const bool isPerson)
constructor
MSStage * getNextStage(int next) const
Return the current stage.
bool hasArrived() const
return whether the person has reached the end of its plan
double getSlope() const
Returns the slope of the road at object's position in degrees.
void tripInfoOutput(OutputDevice &os) const
Called on writing tripinfo output.
const NumericalID myNumericalID
virtual bool hasInfluencer() const
whether the vehicle is individually influenced (via TraCI or special parameters)
void appendStage(MSStage *stage, int next=-1)
Appends the given stage to the current plan.
SumoRNG * getRNG() const
returns the associated RNG
virtual bool isJammed() const
whether the transportable (persons) is jammed as defined by the current pedestrian model
MSTransportable(const MSTransportable &)
Invalidated copy constructor.
MSVehicleType & getSingularType()
Replaces the current vehicle type with a new one used by this vehicle only.
const MSEdge * getEdge() const
Returns the current edge.
virtual const MSEdge * getNextEdgePtr() const
returns the next edge ptr (used by walking persons)
virtual int getDirection() const
Return the movement directon on the edge.
std::vector< MSStage * > MSTransportablePlan
the structure holding the plan of a transportable
void setID(const std::string &newID)
set the id (inherited from Named but forbidden for transportables)
WrappingCommand< MSTransportable > * myAbortCommand
void replaceVehicleType(MSVehicleType *type)
Replaces the current vehicle type by the one given.
bool isWaitingFor(const SUMOVehicle *vehicle) const
Whether the transportable waits for the given vehicle in the current step.
SUMOTime getDesiredDepart() const
Returns the desired departure time.
const SUMOVehicleParameter & getParameter() const
Returns the vehicle's parameter (including departure definition)
double getMaxSpeed() const
Returns the maximum speed (the minimum of desired and physical maximum speed)
The car-following model and parameter.
Definition: MSVehicleType.h:63
Static storage of an output device and its base (abstract) implementation.
Definition: OutputDevice.h:61
A point in 2D or 3D with translation and scaling methods.
Definition: Position.h:37
A list of positions.
Representation of a vehicle, person, or container.
long long int NumericalID
Representation of a vehicle.
Definition: SUMOVehicle.h:62
Structure representing possible vehicle parameter.