Eclipse SUMO - Simulation of Urban MObility
NLJunctionControlBuilder.h
Go to the documentation of this file.
1 /****************************************************************************/
2 // Eclipse SUMO, Simulation of Urban MObility; see https://eclipse.dev/sumo
3 // Copyright (C) 2001-2024 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 /****************************************************************************/
20 // Builder of microsim-junctions and tls
21 /****************************************************************************/
22 #pragma once
23 #include <config.h>
24 
25 #include <string>
26 #include <vector>
27 #include <microsim/MSJunction.h>
30 #include <utils/geom/Position.h>
35 #include <microsim/MSBitSetLogic.h>
38 
39 
40 // ===========================================================================
41 // class declarations
42 // ===========================================================================
43 class OptionsCont;
44 class NLDetectorBuilder;
45 
46 
47 // ===========================================================================
48 // class definitions
49 // ===========================================================================
61 private:
63  typedef std::vector<MSLane*> LaneVector;
64 
65 public:
74 
75 
81  virtual ~NLJunctionControlBuilder();
82 
83 
97  void openJunction(const std::string& id, const std::string& key,
98  const SumoXMLNodeType type,
99  const Position pos,
100  const PositionVector& shape,
101  const std::vector<MSLane*>& incomingLanes,
102  const std::vector<MSLane*>& internalLanes,
103  const std::string& name);
104 
105 
118  void closeJunction(const std::string& basePath);
119 
120 
128  MSJunctionControl* build() const;
129 
130 
134  void initJunctionLogic(const std::string& id);
135 
136 
148  void addLogicItem(int request, const std::string& response,
149  const std::string& foes, bool cont);
150 
160  void initTrafficLightLogic(const std::string& id, const std::string& programID,
161  TrafficLightType type, SUMOTime offset);
162 
167  void addPhase(MSPhaseDefinition* phase);
168 
174  bool addCondition(const std::string& id, const std::string& value);
175 
182  void addAssignment(const std::string& id, const std::string& check, const std::string& value);
183 
189  void addFunction(const std::string& id, int nArgs);
190 
192  void closeFunction();
193 
200  MSTLLogicControl::TLSLogicVariants& getTLLogic(const std::string& id) const;
201 
212 
221  virtual void closeTrafficLightLogic(const std::string& basePath);
222 
230  void addParam(const std::string& key, const std::string& value);
231 
235  const std::string& getActiveKey() const;
236 
240  const std::string& getActiveSubKey() const;
241 
250 
252  void postLoadInitialization();
253 
255  MSJunction* retrieve(const std::string id);
256 
259  return myActivePhases;
260  }
261 
262  void netIsLoaded() {
263  myNetIsLoaded = true;
264  }
265 
266 protected:
269 
276  virtual MSJunction* buildNoLogicJunction();
277 
285  virtual MSJunction* buildLogicJunction(MSJunctionLogic* const logic);
286 
295 
296 protected:
299 
302 
305 
308 
311 
314 
316  std::bitset<SUMO_MAX_CONNECTIONS> myActiveConts;
317 
320 
323 
326 
329 
332 
335 
338 
341 
344 
347 
349  std::string myActiveID;
350 
353 
356 
359 
362 
365 
367  std::string myActiveName;
368 
371 
373  std::vector<MSTrafficLightLogic*> myNetworkLogics;
374  std::vector<MSTrafficLightLogic*> myAdditionalLogics;
375  std::vector<MSTrafficLightLogic*> myRailSignals;
376  std::map<MSTrafficLightLogic*, StringParameterMap> myLogicParams;
377 
380 
383 
386 
387 private:
390 
393 
394  static const int NO_REQUEST_SIZE;
395 
398 
399 
400 };
long long int SUMOTime
Definition: GUI.h:35
TrafficLightType
SumoXMLNodeType
Numbers representing special SUMO-XML-attribute values for representing node- (junction-) types used ...
std::vector< std::tuple< std::string, std::string, std::string > > AssignmentMap
std::map< std::string, Function > FunctionMap
std::vector< std::bitset< N > > Foes
Container holding the information which internal lanes prohibt which links Build the same way as Logi...
Definition: MSBitSetLogic.h:53
std::vector< std::bitset< N > > Logic
Container that holds the right of way bitsets. Each link has its own bitset. The bits in the bitsets ...
Definition: MSBitSetLogic.h:49
Container for junctions; performs operations on all stored junctions.
The base class for an intersection.
Definition: MSJunction.h:58
The simulated network and simulation perfomer.
Definition: MSNet.h:89
The definition of a single phase of a tls logic.
Storage for all programs of a single tls.
A class that stores and controls tls and switching of their programs.
std::vector< MSPhaseDefinition * > Phases
Definition of a list of phases, being the junction logic.
Builds detectors for microsim.
Builder of microsim-junctions and tls.
PositionVector myShape
The shape of the current junction.
NLJunctionControlBuilder(MSNet &net, NLDetectorBuilder &db)
Constructor.
int myRequestItemNumber
Counter for the inserted items.
SumoXMLNodeType myType
The type of the currently chosen junction.
std::vector< MSTrafficLightLogic * > myNetworkLogics
The container for information which junctions shall be initialised using which values.
MSTLLogicControl::TLSLogicVariants & getTLLogic(const std::string &id) const
Returns a previously build tls logic.
std::string myActiveName
the name of the current junction
virtual ~NLJunctionControlBuilder()
Destructor.
void closeFunction()
closes a switching condition function to the traffic lights logic currently build
MSJunction * retrieve(const std::string id)
try to retrieve junction by id
MSActuatedTrafficLightLogic::AssignmentMap myActiveAssignments
The current assignments for an actuated traffic light.
MSBitsetLogic::Foes myActiveFoes
The description about which lanes disallow other passing the junction simultaneously.
std::string myActiveID
The id of the currently chosen junction.
MSActuatedTrafficLightLogic::ConditionMap myActiveConditions
The current switching conditions for an actuated traffic light.
Parameterised::Map StringParameterMap
Definition of a parameter map (key->value)
SUMOTime myOffset
The switch offset within the tls.
MSTLLogicControl * myLogicControl
The tls control to use (0 if net's tls control shall be used)
std::string myActiveKey
The key of the currently chosen junction.
TrafficLightType myLogicType
The current logic type.
bool myCurrentHasError
Information whether the current logic had an error.
MSTLLogicControl * buildTLLogics()
Returns the built tls-logic control.
const MSSimpleTrafficLightLogic::Phases & getLoadedPhases() const
return the phases loaded so far (for error reporting and cleanup)
MSJunctionControl * build() const
Builds the MSJunctionControl which holds all of the simulations junctions.
int myRequestSize
The size of the request.
void addPhase(MSPhaseDefinition *phase)
Adds a phase to the currently built traffic lights logic.
MSTLLogicControl & getTLLogicControlToUse() const
Returns the used tls control.
void addFunction(const std::string &id, int nArgs)
adds a switching condition function to the traffic lights logic currently build
LaneVector myActiveIncomingLanes
The list of the incoming lanes of the currently chosen junction.
const std::string & getActiveSubKey() const
Returns the active sub key.
bool addCondition(const std::string &id, const std::string &value)
Adds a condition to the currently built traffic lights logic.
StringParameterMap myAdditionalParameter
Parameter map (key->value)
void openJunction(const std::string &id, const std::string &key, const SumoXMLNodeType type, const Position pos, const PositionVector &shape, const std::vector< MSLane * > &incomingLanes, const std::vector< MSLane * > &internalLanes, const std::string &name)
Begins the processing of the named junction.
void addParam(const std::string &key, const std::string &value)
Adds a parameter.
LaneVector myActiveInternalLanes
The list of the internal lanes of the currently chosen junction.
void initJunctionLogic(const std::string &id)
Initialises a junction logic.
void initTrafficLightLogic(const std::string &id, const std::string &programID, TrafficLightType type, SUMOTime offset)
Begins the reading of a traffic lights logic.
NLJunctionControlBuilder & operator=(const NLJunctionControlBuilder &s)
invalidated assignment operator
MSActuatedTrafficLightLogic::FunctionMap myActiveFunctions
The current functions for an actuated traffic light.
NLDetectorBuilder & myDetectorBuilder
The detector builder to use.
virtual MSJunction * buildNoLogicJunction()
Builds a junction that does not use a logic.
virtual MSJunction * buildInternalJunction()
Builds an internal junction.
MSJunctionControl * myJunctions
The junctions controls.
std::vector< MSTrafficLightLogic * > myAdditionalLogics
const std::string & getActiveKey() const
Returns the active key.
Position myPosition
The position of the junction.
NLJunctionControlBuilder(const NLJunctionControlBuilder &s)
invalidated copy operator
void addAssignment(const std::string &id, const std::string &check, const std::string &value)
Adds an assignment to the currently built traffic lights logic.
void postLoadInitialization()
initialize junctions after all connections have been loaded
std::map< MSTrafficLightLogic *, StringParameterMap > myLogicParams
std::vector< MSTrafficLightLogic * > myRailSignals
void addLogicItem(int request, const std::string &response, const std::string &foes, bool cont)
Adds a logic item.
MSActuatedTrafficLightLogic::Function myActiveFunction
The current function for an actuated traffic light.
MSBitsetLogic::Logic myActiveLogic
The right-of-way-logic of the currently chosen bitset-logic.
virtual MSJunction * buildLogicJunction(MSJunctionLogic *const logic)
Builds a junction with a logic.
SUMOTime myAbsDuration
The absolute duration of a tls-control loop.
void closeJunction(const std::string &basePath)
Closes (ends) the processing of the current junction.
MSSimpleTrafficLightLogic::Phases myActivePhases
The current phase definitions for a simple traffic light.
bool myNetIsLoaded
whether the network has been loaded
virtual void closeTrafficLightLogic(const std::string &basePath)
Ends the building of a traffic lights logic.
std::vector< MSLane * > LaneVector
Definition of a lane vector.
std::bitset< SUMO_MAX_CONNECTIONS > myActiveConts
The description about which lanes have an internal follower.
A storage for options typed value containers)
Definition: OptionsCont.h:89
std::map< std::string, std::string > Map
parameters map
Definition: Parameterised.h:45
A point in 2D or 3D with translation and scaling methods.
Definition: Position.h:37
A list of positions.