SUMO - Simulation of Urban MObility
MSTrafficLightLogic.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-2018 German Aerospace Center (DLR) and others.
4 // This program and the accompanying materials
5 // are made available under the terms of the Eclipse Public License v2.0
6 // which accompanies this distribution, and is available at
7 // http://www.eclipse.org/legal/epl-v20.html
8 // SPDX-License-Identifier: EPL-2.0
9 /****************************************************************************/
19 // The parent class for traffic light logics
20 /****************************************************************************/
21 #ifndef MSTrafficLightLogic_h
22 #define MSTrafficLightLogic_h
23 
24 
25 // ===========================================================================
26 // included modules
27 // ===========================================================================
28 #include <config.h>
29 
30 #include <map>
31 #include <string>
32 #include <bitset>
33 #include <utils/common/Command.h>
36 #include <microsim/MSLink.h>
37 #include "MSPhaseDefinition.h"
38 
39 
40 // ===========================================================================
41 // class declarations
42 // ===========================================================================
43 class MSNet;
44 class MSLink;
45 class MSTLLogicControl;
46 class NLDetectorBuilder;
47 
48 
49 // ===========================================================================
50 // class definitions
51 // ===========================================================================
56 class MSTrafficLightLogic : public Named, public Parameterised {
57 public:
60 
62  typedef std::vector<MSPhaseDefinition*> Phases;
63 
65  typedef std::vector<MSLink*> LinkVector;
66 
68  typedef std::vector<LinkVector> LinkVectorVector;
69 
71  typedef std::vector<MSLane*> LaneVector;
72 
74  typedef std::vector<LaneVector> LaneVectorVector;
76 
77 
78 public:
88  const std::string& id,
89  const std::string& programID,
90  const TrafficLightType logicType,
91  const SUMOTime delay,
92  const std::map<std::string, std::string>& parameters);
93 
94 
100  virtual void init(NLDetectorBuilder& nb);
101 
102 
104  virtual ~MSTrafficLightLogic();
105 
106 
107 
110 
116  virtual void addLink(MSLink* link, MSLane* lane, int pos);
117 
119  void ignoreLinkIndex(int pos);
120 
121 
129  virtual void adaptLinkInformationFrom(const MSTrafficLightLogic& logic);
130 
131 
135  std::map<MSLink*, LinkState> collectLinkStates() const;
136 
137 
141  void resetLinkStates(const std::map<MSLink*, LinkState>& vals) const;
143 
144 
145 
148 
152  virtual SUMOTime trySwitch() = 0;
153 
154 
161  bool setTrafficLightSignals(SUMOTime t) const;
163 
164 
165 
168 
172  const std::string& getProgramID() const {
173  return myProgramID;
174  }
175 
176 
180  const LaneVectorVector& getLaneVectors() const {
181  return myLanes;
182  }
183 
184 
189  const LaneVector& getLanesAt(int i) const {
190  if (i < (int)myLanes.size()) {
191  return myLanes[i];
192  } else {
193  return myEmptyLaneVector;
194  }
195  }
196 
197 
201  const LinkVectorVector& getLinks() const {
202  return myLinks;
203  }
204 
205 
210  const LinkVector& getLinksAt(int i) const {
211  return myLinks[i];
212  }
213 
214 
219  int getLinkIndex(const MSLink* const link) const;
220 
221 
225  virtual int getPhaseNumber() const = 0;
226 
227 
231  virtual const Phases& getPhases() const = 0;
232 
233 
238  virtual const MSPhaseDefinition& getPhase(int givenstep) const = 0;
239 
244  return myLogicType;
245  }
247 
248 
249 
252 
256  virtual int getCurrentPhaseIndex() const = 0;
257 
258 
262  virtual const MSPhaseDefinition& getCurrentPhaseDef() const = 0;
263 
264 
269  return myDefaultCycleTime;
270  }
271 
272 
278  SUMOTime getNextSwitchTime() const;
279 
280 
285  SUMOTime getSpentDuration() const;
287 
288 
289 
292 
296  virtual SUMOTime getPhaseIndexAtTime(SUMOTime simStep) const = 0;
297 
298 
303  virtual SUMOTime getOffsetFromIndex(int index) const = 0;
304 
305 
310  virtual int getIndexFromOffset(SUMOTime offset) const = 0;
312 
313 
314 
317 
321  void addOverridingDuration(SUMOTime duration);
322 
323 
328 
329 
336  virtual void changeStepAndDuration(MSTLLogicControl& tlcontrol,
337  SUMOTime simStep, int step, SUMOTime stepDuration) = 0;
338 
340 
341 
342 protected:
347  class SwitchCommand : public Command {
348  public:
354  SwitchCommand(MSTLLogicControl& tlcontrol,
355  MSTrafficLightLogic* tlLogic,
356  SUMOTime nextSwitch);
357 
359  ~SwitchCommand();
360 
365  SUMOTime execute(SUMOTime currentTime);
366 
367 
371  void deschedule(MSTrafficLightLogic* tlLogic);
372 
373 
378  return myAssumedNextSwitch;
379  }
380 
381 
382  private:
385 
388 
391 
393  bool myAmValid;
394 
395  private:
398 
401 
402  };
403 
404 
405 protected:
407  const std::string myProgramID;
408 
411 
413  LinkVectorVector myLinks;
414 
416  LaneVectorVector myLanes;
417 
419  std::vector<SUMOTime> myOverridingTimes;
420 
423 
426 
429 
431  static const LaneVector myEmptyLaneVector;
432 
434  std::set<int> myIgnoredIndices;
435 
436 private:
438  void initMesoTLSPenalties();
439 
440 
441 private:
444 
447 
448 };
449 
450 
451 #endif
452 
453 /****************************************************************************/
454 
SUMOTime myCurrentDurationIncrement
A value for enlarge the current duration.
TrafficLightType getLogicType() const
Returns the type of the logic.
virtual const MSPhaseDefinition & getCurrentPhaseDef() const =0
Returns the definition of the current phase.
Builds detectors for microsim.
void initMesoTLSPenalties()
initialize optional meso penalties
long long int SUMOTime
Definition: SUMOTime.h:36
MSTLLogicControl & myTLControl
The responsible traffic lights control.
virtual SUMOTime getOffsetFromIndex(int index) const =0
Returns the position (start of a phase during a cycle) from of a given step.
std::vector< SUMOTime > myOverridingTimes
A list of duration overrides.
SwitchCommand(MSTLLogicControl &tlcontrol, MSTrafficLightLogic *tlLogic, SUMOTime nextSwitch)
Constructor.
SUMOTime myAssumedNextSwitch
Assumed switch time (may change in case of adaptive traffic lights)
virtual void changeStepAndDuration(MSTLLogicControl &tlcontrol, SUMOTime simStep, int step, SUMOTime stepDuration)=0
Changes the current phase and her duration.
static const LaneVector myEmptyLaneVector
An empty lane vector.
virtual SUMOTime getPhaseIndexAtTime(SUMOTime simStep) const =0
Returns the index of the logic at the given simulation step.
const LaneVectorVector & getLaneVectors() const
Returns the list of lists of all lanes controlled by this tls.
virtual const MSPhaseDefinition & getPhase(int givenstep) const =0
Returns the definition of the phase from the given position within the plan.
virtual int getCurrentPhaseIndex() const =0
Returns the current index within the program.
SUMOTime getNextSwitchTime() const
Returns the assumed next switch time.
Base (microsim) event class.
Definition: Command.h:54
const TrafficLightType myLogicType
The type of the logic.
bool setTrafficLightSignals(SUMOTime t) const
Applies the current signal states to controlled links.
void resetLinkStates(const std::map< MSLink *, LinkState > &vals) const
Resets the states of controlled links.
const LinkVectorVector & getLinks() const
Returns the list of lists of all affected links.
int getLinkIndex(const MSLink *const link) const
Returns the index of the given link.
const LinkVector & getLinksAt(int i) const
Returns the list of links that are controlled by the signals at the given position.
std::set< int > myIgnoredIndices
list of indices that are ignored in mesoscopic simulatino
The simulated network and simulation perfomer.
Definition: MSNet.h:84
LaneVectorVector myLanes
The list of LaneVectors; each vector contains the incoming lanes that belong to the same link index...
const LaneVector & getLanesAt(int i) const
Returns the list of lanes that are controlled by the signals at the given position.
virtual ~MSTrafficLightLogic()
Destructor.
A class that stores and controls tls and switching of their programs.
SUMOTime getDefaultCycleTime() const
Returns the cycle time (in ms)
void deschedule(MSTrafficLightLogic *tlLogic)
Marks this swicth as invalid (if the phase duration has changed, f.e.)
Class realising the switch between the traffic light phases.
std::vector< LinkVector > LinkVectorVector
Definition of a list that holds lists of links that do have the same attribute.
MSTrafficLightLogic(MSTLLogicControl &tlcontrol, const std::string &id, const std::string &programID, const TrafficLightType logicType, const SUMOTime delay, const std::map< std::string, std::string > &parameters)
Constructor.
virtual int getPhaseNumber() const =0
Returns the number of phases.
SUMOTime myDefaultCycleTime
The cycle time (without changes)
const std::string & getProgramID() const
Returns this tl-logic&#39;s id.
MSTrafficLightLogic * myTLLogic
The logic to be executed on a switch.
virtual void init(NLDetectorBuilder &nb)
Initialises the tls with information about incoming lanes.
virtual void adaptLinkInformationFrom(const MSTrafficLightLogic &logic)
Applies information about controlled links and lanes from the given logic.
std::map< MSLink *, LinkState > collectLinkStates() const
Returns the (uncontrolled) states of the controlled links.
An upper class for objects with additional parameters.
Definition: Parameterised.h:44
void setCurrentDurationIncrement(SUMOTime delay)
Delays current phase by the given delay.
Base class for objects which have an id.
Definition: Named.h:58
const std::string myProgramID
The id of the logic.
std::vector< MSLink * > LinkVector
Definition of the list of links that are subjected to this tls.
SwitchCommand & operator=(const SwitchCommand &)
Invalidated assignment operator.
std::vector< MSPhaseDefinition * > Phases
Definition of a list of phases, being the junction logic.
virtual const Phases & getPhases() const =0
Returns the phases of this tls program.
void addOverridingDuration(SUMOTime duration)
Changes the duration of the next phase.
LinkVectorVector myLinks
The list of LinkVectors; each vector contains the links that belong to the same link index...
std::vector< MSLane * > LaneVector
Definition of the list of arrival lanes subjected to this tls.
std::vector< LaneVector > LaneVectorVector
Definition of a list that holds lists of lanes that do have the same attribute.
void ignoreLinkIndex(int pos)
ignore pedestrian crossing index in mesosim
SUMOTime getNextSwitchTime() const
Returns the assumed next switch time.
virtual void addLink(MSLink *link, MSLane *lane, int pos)
Adds a link on building.
SwitchCommand * mySwitchCommand
The current switch command.
The parent class for traffic light logics.
SUMOTime getSpentDuration() const
Returns the duration spent in the current phase.
bool myAmValid
Information whether this switch command is still valid.
virtual SUMOTime trySwitch()=0
Switches to the next phase.
The definition of a single phase of a tls logic.
Representation of a lane in the micro simulation.
Definition: MSLane.h:78
SUMOTime execute(SUMOTime currentTime)
Executes the regarded junction&#39;s "trySwitch"- method.
virtual int getIndexFromOffset(SUMOTime offset) const =0
Returns the step (the phasenumber) of a given position of the cycle.
TrafficLightType