Package org.opentrafficsim.road.gtu.lane.tactical.lmrs

Class IncentiveCourtesy

java.lang.Object

org.opentrafficsim.road.gtu.lane.tactical.lmrs.IncentiveCourtesy

All Implemented Interfaces:

Supplier<IncentiveCourtesy>, Stateless<IncentiveCourtesy>, Incentive, VoluntaryIncentive

public final class IncentiveCourtesy
extends Object
implements VoluntaryIncentive, Stateless<IncentiveCourtesy>

Determines lane change desire for courtesy lane changes, which are performed to supply space for other drivers. In case drivers in adjacent lanes have desire to change to the current lane, the driver has desire to change to the other adjacent lane. The level of desire depends on lane change courtesy, as well as the distance of the leading vehicle for which desire exists. This desire exists for only a single vehicle, i.e. the one giving maximum desire. A negative desire may also result for leaders in the 2nd adjacent lane desiring to change to the 1st adjacent lane. By not changing to the 1st adjacent lane, room is reserved for the leader on the 2nd adjacent lane.

Copyright (c) 2013-2024 Delft University of Technology, PO Box 5, 2600 AA, Delft, the Netherlands. All rights reserved.
BSD-style license. See OpenTrafficSim License.

Author:

Wouter Schakel

Field Summary

Fields

Modifier and Type	Field	Description
protected static final ParameterTypeAcceleration	B	Comfortable deceleration parameter type.
static final IncentiveCourtesy	SINGLETON	Singleton instance.
protected static final ParameterTypeDouble	SOCIO	Socio-speed sensitivity parameter.

Method Summary

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.
IncentiveCourtesy	get()
String	toString()

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

Field Details

B

protected static final ParameterTypeAcceleration B

Comfortable deceleration parameter type.

SOCIO

protected static final ParameterTypeDouble SOCIO

Socio-speed sensitivity parameter.

SINGLETON

public static final IncentiveCourtesy SINGLETON

Singleton instance.

Method Details

get

public IncentiveCourtesy get()

Specified by:

get in interface Stateless<IncentiveCourtesy>

Specified by:

get in interface Supplier<IncentiveCourtesy>

determineDesire

public Desire determineDesire(Parameters parameters,
 LanePerception perception,
 CarFollowingModel carFollowingModel,
 Desire mandatoryDesire,
 Desire voluntaryDesire)
                       throws ParameterException,
OperationalPlanException

Description copied from interface: VoluntaryIncentive

Determines level of lane change desire for a lane change incentive.

Specified by:

determineDesire in interface VoluntaryIncentive

Parameters:

parameters - parameters

perception - perception

carFollowingModel - car-following model

mandatoryDesire - level of mandatory desire at current time

voluntaryDesire - 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 String toString()

Overrides:

toString in class Object