Eclipse SUMO - Simulation of Urban MObility
MSCFModel_Wiedemann.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 // The psycho-physical model of Wiedemann
16 /****************************************************************************/
17 #ifndef MSCFModel_Wiedemann_H
18 #define MSCFModel_Wiedemann_H
19 
20 // ===========================================================================
21 // included modules
22 // ===========================================================================
23 #include <config.h>
24 
25 #include "MSCFModel.h"
26 #include <microsim/MSLane.h>
27 #include <microsim/MSVehicle.h>
28 #include <microsim/MSVehicleType.h>
30 
31 
32 // ===========================================================================
33 // class definitions
34 // ===========================================================================
39 // XXX: which Wiedemann is this? There are several versions... Below it is stated that it is modified it with Krauss vsafe... (Leo)
41 public:
42 
46  MSCFModel_Wiedemann(const MSVehicleType* vtype);
47 
48 
51 
52 
55 
61  double finalizeSpeed(MSVehicle* const veh, double vPos) const;
62 
63 
72  double followSpeed(const MSVehicle* const veh, double speed, double gap2pred, double predSpeed, double predMaxDecel, const MSVehicle* const pred = 0) const;
73 
74 
82  double stopSpeed(const MSVehicle* const veh, const double speed, double gap) const;
83 
84 
94  double interactionGap(const MSVehicle* const, double vL) const;
95 
103  double getSecureGap(const MSVehicle* const veh, const MSVehicle* const pred, const double speed, const double leaderSpeed, const double leaderMaxDecel) const;
104 
109  int getModelID() const {
110  return SUMO_TAG_CF_WIEDEMANN;
111  }
112 
113 
118  MSCFModel* duplicate(const MSVehicleType* vtype) const;
119 
120 
122  return new VehicleVariables();
123  }
125 
126 
127 private:
129  public:
132  double accelSign;
133  };
134 
135 
136 private:
137  /* @brief the main enty point for the speed computation
138  * @param[in] gap The netto gap (front bumper of ego to back bumper of leader)
139  */
140  double _v(const MSVehicle* veh, double predSpeed, double gap) const;
141 
144  double fullspeed(double v, double vpref, double dx, double bx) const; // also 'WUNSCH'
145  double following(double sign) const; // also 'FOLGEN'
146  double approaching(double dv, double dx, double abx) const; // also 'BREMSBX'
147  double emergency(double dv, double dx) const; // also 'BREMSAX'
149 
150 private:
153 
155  const double mySecurity;
156 
158  const double myEstimation;
159 
161  const double myAX;
162 
164  const double myCX;
165 
167  const double myMinAccel;
168 
170  static const double D_MAX;
172 
173 private:
176 };
177 
178 #endif /* MSCFModel_Wiedemann_H */
MSVehicleType
The car-following model and parameter.
Definition: MSVehicleType.h:65
MSCFModel_Wiedemann::VehicleVariables
Definition: MSCFModel_Wiedemann.h:128
MSCFModel_Wiedemann::finalizeSpeed
double finalizeSpeed(MSVehicle *const veh, double vPos) const
Applies interaction with stops and lane changing model influences.
Definition: MSCFModel_Wiedemann.cpp:62
MSCFModel_Wiedemann::mySecurity
const double mySecurity
The driver's security parameter // also 'ZF1'.
Definition: MSCFModel_Wiedemann.h:155
MSCFModel_Wiedemann::MSCFModel_Wiedemann
MSCFModel_Wiedemann(const MSVehicleType *vtype)
Constructor.
Definition: MSCFModel_Wiedemann.cpp:48
MSCFModel_Wiedemann::following
double following(double sign) const
Definition: MSCFModel_Wiedemann.cpp:174
MSCFModel_Wiedemann::fullspeed
double fullspeed(double v, double vpref, double dx, double bx) const
Definition: MSCFModel_Wiedemann.cpp:161
MSCFModel_Wiedemann::getSecureGap
double getSecureGap(const MSVehicle *const veh, const MSVehicle *const pred, const double speed, const double leaderSpeed, const double leaderMaxDecel) const
Returns the minimum gap to reserve if the leader is braking at maximum (>=0)
Definition: MSCFModel_Wiedemann.cpp:102
MSCFModel_Wiedemann::createVehicleVariables
VehicleVariables * createVehicleVariables() const
Returns model specific values which are stored inside a vehicle and must be used with casting.
Definition: MSCFModel_Wiedemann.h:121
MSCFModel_Wiedemann::approaching
double approaching(double dv, double dx, double abx) const
Definition: MSCFModel_Wiedemann.cpp:180
MSCFModel_Wiedemann::followSpeed
double followSpeed(const MSVehicle *const veh, double speed, double gap2pred, double predSpeed, double predMaxDecel, const MSVehicle *const pred=0) const
Computes the vehicle's safe speed (no dawdling)
Definition: MSCFModel_Wiedemann.cpp:71
MSCFModel_Wiedemann::~MSCFModel_Wiedemann
~MSCFModel_Wiedemann()
Destructor.
Definition: MSCFModel_Wiedemann.cpp:58
MSVehicle.h
MSVehicleType.h
MSCFModel_Wiedemann::VehicleVariables::accelSign
double accelSign
state variable for remembering the drift direction
Definition: MSCFModel_Wiedemann.h:132
MSCFModel_Wiedemann::_v
double _v(const MSVehicle *veh, double predSpeed, double gap) const
Definition: MSCFModel_Wiedemann.cpp:110
MSCFModel_Wiedemann::operator=
MSCFModel_Wiedemann & operator=(const MSCFModel_Wiedemann &s)
Invalidated assignment operator.
MSCFModel_Wiedemann::D_MAX
static const double D_MAX
free-flow distance in m
Definition: MSCFModel_Wiedemann.h:170
MSCFModel_Wiedemann::interactionGap
double interactionGap(const MSVehicle *const, double vL) const
Returns the maximum gap at which an interaction between both vehicles occurs.
Definition: MSCFModel_Wiedemann.cpp:89
MSCFModel_Wiedemann::myEstimation
const double myEstimation
The driver's estimation parameter // also 'ZF2'.
Definition: MSCFModel_Wiedemann.h:158
SUMO_TAG_CF_WIEDEMANN
@ SUMO_TAG_CF_WIEDEMANN
Definition: SUMOXMLDefinitions.h:285
MSCFModel::VehicleVariables
Definition: MSCFModel.h:60
MSCFModel_Wiedemann::VehicleVariables::VehicleVariables
VehicleVariables()
Definition: MSCFModel_Wiedemann.h:130
MSCFModel_Wiedemann::duplicate
MSCFModel * duplicate(const MSVehicleType *vtype) const
Duplicates the car-following model.
Definition: MSCFModel_Wiedemann.cpp:96
MSCFModel.h
MSCFModel_Wiedemann::emergency
double emergency(double dv, double dx) const
Definition: MSCFModel_Wiedemann.cpp:188
MSCFModel_Wiedemann
The Wiedemann Model car-following model.
Definition: MSCFModel_Wiedemann.h:40
MSCFModel
The car-following model abstraction.
Definition: MSCFModel.h:56
MSCFModel_Wiedemann::myAX
const double myAX
the minimum front-bumper to front-bumper distance when standing
Definition: MSCFModel_Wiedemann.h:161
config.h
MSLane.h
MSCFModel_Wiedemann::getModelID
int getModelID() const
Returns the model's name.
Definition: MSCFModel_Wiedemann.h:109
MSCFModel_Wiedemann::myCX
const double myCX
perception threshold modifier
Definition: MSCFModel_Wiedemann.h:164
MSCFModel_Wiedemann::myMinAccel
const double myMinAccel
The vehicle's minimum acceleration [m/s^2] // also b_null.
Definition: MSCFModel_Wiedemann.h:167
SUMOXMLDefinitions.h
MSCFModel_Wiedemann::stopSpeed
double stopSpeed(const MSVehicle *const veh, const double speed, double gap) const
Computes the vehicle's safe speed for approaching a non-moving obstacle (no dawdling)
Definition: MSCFModel_Wiedemann.cpp:77
MSVehicle
Representation of a vehicle in the micro simulation.
Definition: MSVehicle.h:79