IncentiveSocioSpeed (Open Traffic Sim road classes 1.04.02 API)

java.lang.Object
- org.opentrafficsim.road.gtu.lane.tactical.lmrs.IncentiveSocioSpeed

All Implemented Interfaces:

Incentive, VoluntaryIncentive
```
public class IncentiveSocioSpeed
extends java.lang.Object
implements VoluntaryIncentive
```
Lane change incentive based on social pressure. Drivers may refrain from changing left to not hinder faster traffic, or drivers may change right to get out of the way. When drivers are on the left lane, this is considered 'overtaking', and related to this the desired speed could be increased by using SocioDesiredSpeedModel.
Copyright (c) 2013-2020 Delft University of Technology, PO Box 5, 2600 AA, Delft, the Netherlands. All rights reserved.
BSD-style license. See OpenTrafficSim License.

Version:

$Revision$, $LastChangedDate$, by $Author$, initial version 7 mrt. 2018

Author:

Alexander Verbraeck, Peter Knoppers, Wouter Schakel

Field Summary

Fields
Modifier and Type	Field	Description
`protected static ParameterTypeLength`	`LOOKAHEAD`	Look-ahead distance.
`protected static ParameterTypeDouble`	`RHO`	Social pressure applied to the leader.
`protected static ParameterTypeDouble`	`SOCIO`	Hierarchy parameter.
`protected static ParameterTypeSpeed`	`VCONG`	Speed threshold below which traffic is considered congested.
`protected static ParameterTypeSpeed`	`VGAIN`	Vgain parameter; ego-speed sensitivity.

Constructor Summary

Constructors
Constructor Description

IncentiveSocioSpeed()

Method Summary

All Methods Instance Methods Concrete Methods
Modifier and Type	Method	Description
`Desire`	`determineDesire(Parameters parameters, LanePerception perception, CarFollowingModel carFollowingModel, Desire mandatoryDesire, Desire voluntaryDesire)`	Determines level of lane change desire for a lane change incentive.
`java.lang.String`	`toString()`

Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

Field Detail

RHO

protected static final ParameterTypeDouble RHO

Social pressure applied to the leader.

SOCIO

protected static final ParameterTypeDouble SOCIO

Hierarchy parameter.

VCONG
```
protected static final ParameterTypeSpeed VCONG
```
Speed threshold below which traffic is considered congested.

VGAIN

protected static final ParameterTypeSpeed VGAIN

Vgain parameter; ego-speed sensitivity.

LOOKAHEAD

protected static final ParameterTypeLength LOOKAHEAD

Look-ahead distance.

Constructor Detail
- IncentiveSocioSpeed
```
public IncentiveSocioSpeed()
```

Method Detail
- determineDesire
```
public final Desire determineDesire(Parameters parameters,
                                    LanePerception perception,
                                    CarFollowingModel carFollowingModel,
                                    Desire mandatoryDesire,
                                    Desire voluntaryDesire)
                             throws ParameterException,
                                    OperationalPlanException
```
  Determines level of lane change desire for a lane change incentive.
  
  Specified by:
  
  determineDesire in interface VoluntaryIncentive
  
  Parameters:
  
  parameters - Parameters; parameters
  
  perception - LanePerception; perception
  
  carFollowingModel - CarFollowingModel; car-following model
  
  mandatoryDesire - Desire; level of mandatory desire at current time
  
  voluntaryDesire - Desire; level of voluntary desire at current time, of voluntary incentives calculated before
  
  Returns:
  
  level of lane change desire for this incentive
  
  Throws:
  
  ParameterException - if a parameter is not given or out of bounds
  
  OperationalPlanException - in case of a perception exception
- toString
```
public final java.lang.String toString()
```
  Overrides:
  
  toString in class java.lang.Object