Eclipse SUMO - Simulation of Urban MObility
MSCFModel_CC.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-2019 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 /****************************************************************************/
15 // A series of automatic Cruise Controllers (CC, ACC, CACC)
16 /****************************************************************************/
17 #ifndef MSCFMODEL_CC_H
18 #define MSCFMODEL_CC_H
19 
20 // ===========================================================================
21 // included modules
22 // ===========================================================================
23 #include <config.h>
24 
25 #include "CC_Const.h"
27 #include <microsim/MSLane.h>
28 #include <microsim/MSVehicle.h>
29 #include <microsim/MSVehicleType.h>
32 #include <string.h>
33 
37 
38 #include "CC_VehicleVariables.h"
39 
40 
41 // ===========================================================================
42 // class definitions
43 // ===========================================================================
58 class MSCFModel_CC : public MSCFModel {
59 public:
60 
76  MSCFModel_CC(const MSVehicleType* vtype);
77 
79  ~MSCFModel_CC();
80 
81 
84 
90  virtual double finalizeSpeed(MSVehicle* const veh, double vPos) const;
91 
92 
101  double followSpeed(const MSVehicle* const veh, double speed, double gap2pred, double predSpeed, double predMaxDecel, const MSVehicle* const pred = 0) const;
102 
108  virtual double insertionFollowSpeed(const MSVehicle* const veh, double speed, double gap2pred, double predSpeed, double predMaxDecel, const MSVehicle* const pred = 0) const;
109 
110 
118  double stopSpeed(const MSVehicle* const veh, const double speed, double gap2pred) const;
119 
132  virtual double freeSpeed(const MSVehicle* const veh, double speed, double seen,
133  double maxSpeed, const bool onInsertion = false) const;
134 
135  virtual double maxNextSpeed(double speed, const MSVehicle* const veh) const;
136 
137  virtual double minNextSpeed(double speed, const MSVehicle* const veh = 0) const;
138 
139 
149  double interactionGap(const MSVehicle* const, double vL) const;
150 
151 
156  int getModelID() const {
157  return SUMO_TAG_CF_CC;
158  }
160 
161 
162 
167  MSCFModel* duplicate(const MSVehicleType* vtype) const;
168 
170 
177  double getCACCConstantSpacing(const MSVehicle* veh) const;
178 
190 // void setVehicleInformation(const MSVehicle* veh, double speed, double acceleration, Position position, double time) const;
191 
199  virtual std::string getParameter(const MSVehicle* veh, const std::string& key) const;
200 
208  virtual void setParameter(MSVehicle* veh, const std::string& key, const std::string& value) const;
209 
222  void getVehicleInformation(const MSVehicle* veh, double& speed, double& acceleration, double& controllerAcceleration, Position& position, double& time) const;
223 
230  void switchOnACC(const MSVehicle* veh, double ccDesiredSpeed) const;
231 
239 
243  void getRadarMeasurements(const MSVehicle* veh, double& distance, double& relativeSpeed) const;
244 
250  double getACCAcceleration(const MSVehicle* veh) const;
251 
255  int getMyLanesCount() const;
256 
257 private:
258 
262  void recomputeParameters(const MSVehicle* veh) const;
263 
269  void resetConsensus(const MSVehicle* veh) const;
270 
271 private:
272  void performAutoLaneChange(MSVehicle* const veh) const;
273 
274  double _v(const MSVehicle* const veh, double gap2pred, double egoSpeed, double predSpeed) const;
275 
282  double _cc(const MSVehicle* veh, double egoSpeed, double desSpeed) const;
283 
292  double _acc(const MSVehicle* veh, double egoSpeed, double predSpeed, double gap2pred, double headwayTime) const;
293 
305  double _cacc(const MSVehicle* veh, double egoSpeed, double predSpeed, double predAcceleration, double gap2pred, double leaderSpeed, double leaderAcceleration, double spacing) const;
306 
317  double _ploeg(const MSVehicle* veh, double egoSpeed, double predSpeed, double predAcceleration, double gap2pred) const;
318 
326  double _consensus(const MSVehicle* veh, double egoSpeed, Position egoPosition, double time) const;
327 
337  double d_i_j(const struct Plexe::VEHICLE_DATA* vehicles, const double h[MAX_N_CARS], int i, int j) const;
338 
347  double _flatbed(const MSVehicle* veh, double egoAcceleration, double egoSpeed, double predSpeed,
348  double gap2pred, double leaderSpeed) const;
349 
350 
351 private:
352 
355 
357  const double myCcDecel;
358 
360  const double myCcAccel;
361 
363  const double myConstantSpacing;
364 
366  const double myKp;
367 
369  const double myLambda;
370 
372  const double myC1;
373 
375  const double myXi;
376 
378  const double myOmegaN;
379 
381  const double myTau;
382 
385  const int myLanesCount;
386 
388  const double myPloegH;
389  const double myPloegKp;
390  const double myPloegKd;
391 
393  const double myFlatbedKa;
394  const double myFlatbedKv;
395  const double myFlatbedKp;
396  const double myFlatbedH;
397  const double myFlatbedD;
398 
399 private:
401  MSCFModel_CC& operator=(const MSCFModel_CC&) = delete;
402 };
403 
404 #endif /* MSCFMODEL_CC_H */
const double myFlatbedH
Definition: MSCFModel_CC.h:396
const double myXi
design constant for CACC
Definition: MSCFModel_CC.h:375
Representation of a vehicle in the micro simulation.
Definition: MSVehicle.h:80
MSCFModel_CC & operator=(const MSCFModel_CC &)=delete
Invalidated assignment operator.
~MSCFModel_CC()
Destructor.
virtual double finalizeSpeed(MSVehicle *const veh, double vPos) const
Applies interaction with stops and lane changing model influences.
virtual double freeSpeed(const MSVehicle *const veh, double speed, double seen, double maxSpeed, const bool onInsertion=false) const
Computes the vehicle&#39;s safe speed without a leader.
virtual double maxNextSpeed(double speed, const MSVehicle *const veh) const
Returns the maximum speed given the current speed.
The car-following model abstraction.
Definition: MSCFModel.h:57
A set of automatic Cruise Controllers, including classic Cruise Control (CC), Adaptive Cruise Control...
Definition: MSCFModel_CC.h:58
virtual void setParameter(MSVehicle *veh, const std::string &key, const std::string &value) const
try to set the given parameter for this carFollowingModel
const double myFlatbedD
Definition: MSCFModel_CC.h:397
double getACCAcceleration(const MSVehicle *veh) const
returns the ACC computed acceleration when the faked CACC is controlling the car. This can be used to...
MSCFModel * myHumanDriver
the car following model which drives the car when automated cruising is disabled, i...
Definition: MSCFModel_CC.h:354
const double myC1
design constant for CACC
Definition: MSCFModel_CC.h:372
The car-following model and parameter.
Definition: MSVehicleType.h:66
double _consensus(const MSVehicle *veh, double egoSpeed, Position egoPosition, double time) const
controller based on consensus strategy
double _v(const MSVehicle *const veh, double gap2pred, double egoSpeed, double predSpeed) const
double interactionGap(const MSVehicle *const, double vL) const
Returns the maximum gap at which an interaction between both vehicles occurs.
double _cc(const MSVehicle *veh, double egoSpeed, double desSpeed) const
controller for the CC which computes the acceleration to be applied. the value needs to be passed to ...
const double myOmegaN
design constant for CACC
Definition: MSCFModel_CC.h:378
void recomputeParameters(const MSVehicle *veh) const
Recomputes controller related parameters after setting them.
void switchOnACC(const MSVehicle *veh, double ccDesiredSpeed) const
switch on the ACC, so disabling the human driver car control
virtual double insertionFollowSpeed(const MSVehicle *const veh, double speed, double gap2pred, double predSpeed, double predMaxDecel, const MSVehicle *const pred=0) const
Overload base MSCFModel::insertionFollowSpeed method to inject automated vehicles as soon as they are...
A point in 2D or 3D with translation and scaling methods.
Definition: Position.h:39
MSCFModel_CC(const MSVehicleType *vtype)
Constructor.
const double myLambda
design constant for ACC
Definition: MSCFModel_CC.h:369
VehicleVariables * createVehicleVariables() const
Returns model specific values which are stored inside a vehicle and must be used with casting...
double _acc(const MSVehicle *veh, double egoSpeed, double predSpeed, double gap2pred, double headwayTime) const
controller for the ACC which computes the acceleration to be applied. the value needs to be passed to...
MSCFModel * duplicate(const MSVehicleType *vtype) const
Duplicates the car-following model.
double _ploeg(const MSVehicle *veh, double egoSpeed, double predSpeed, double predAcceleration, double gap2pred) const
controller for the Ploeg&#39;s CACC which computes the control input variation. Opposed to other controll...
int getMyLanesCount() const
returns the number of lanes set in the configuration file
double followSpeed(const MSVehicle *const veh, double speed, double gap2pred, double predSpeed, double predMaxDecel, const MSVehicle *const pred=0) const
Computes the vehicle&#39;s safe speed (no dawdling)
double _cacc(const MSVehicle *veh, double egoSpeed, double predSpeed, double predAcceleration, double gap2pred, double leaderSpeed, double leaderAcceleration, double spacing) const
controller for the CACC which computes the acceleration to be applied. the value needs to be passed t...
const double myFlatbedKp
Definition: MSCFModel_CC.h:395
double _flatbed(const MSVehicle *veh, double egoAcceleration, double egoSpeed, double predSpeed, double gap2pred, double leaderSpeed) const
flatbed platoon towing model
void performAutoLaneChange(MSVehicle *const veh) const
const int myLanesCount
number of lanes in the highway, in the absence of on-/off-ramps. This is used to move to the correct ...
Definition: MSCFModel_CC.h:385
virtual double minNextSpeed(double speed, const MSVehicle *const veh=0) const
Returns the minimum speed given the current speed (depends on the numerical update scheme and its ste...
const double myCcDecel
The maximum deceleration that the CC can output.
Definition: MSCFModel_CC.h:357
const double myPloegKd
Definition: MSCFModel_CC.h:390
const double myFlatbedKa
flatbed CACC parameters
Definition: MSCFModel_CC.h:393
const double myConstantSpacing
the constant gap for CACC
Definition: MSCFModel_CC.h:363
virtual std::string getParameter(const MSVehicle *veh, const std::string &key) const
set the information about a generic car. This method should be invoked by TraCI when a wireless messa...
const double myFlatbedKv
Definition: MSCFModel_CC.h:394
enum Plexe::ACTIVE_CONTROLLER getActiveController(const MSVehicle *veh) const
return the currently active controller
double getCACCConstantSpacing(const MSVehicle *veh) const
returns CACC desired constant spacing
const double myPloegKp
Definition: MSCFModel_CC.h:389
const double myTau
engine time constant used for actuation lag
Definition: MSCFModel_CC.h:381
const double myPloegH
Ploeg&#39;s CACC parameters.
Definition: MSCFModel_CC.h:388
ACTIVE_CONTROLLER
Determines the currently active controller, i.e., ACC, CACC, or the driver. In future we might need t...
Definition: CC_Const.h:45
void getVehicleInformation(const MSVehicle *veh, double &speed, double &acceleration, double &controllerAcceleration, Position &position, double &time) const
get the information about a vehicle. This can be used by TraCI in order to get speed and acceleration...
void resetConsensus(const MSVehicle *veh) const
Resets the consensus controller. In particular, sets the "initialized" vector all to false...
const double myCcAccel
The maximum acceleration that the CC can output.
Definition: MSCFModel_CC.h:360
const double myKp
design constant for CC
Definition: MSCFModel_CC.h:366
double d_i_j(const struct Plexe::VEHICLE_DATA *vehicles, const double h[MAX_N_CARS], int i, int j) const
computes the desired distance between vehicle i and vehicle j
#define MAX_N_CARS
Definition: CC_Const.h:74
double stopSpeed(const MSVehicle *const veh, const double speed, double gap2pred) const
Computes the vehicle&#39;s safe speed for approaching a non-moving obstacle (no dawdling) ...
void getRadarMeasurements(const MSVehicle *veh, double &distance, double &relativeSpeed) const
return the data that is currently being measured by the radar
int getModelID() const
Returns the model&#39;s name.
Definition: MSCFModel_CC.h:156