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

Class IncentiveKeep

java.lang.Object

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

All Implemented Interfaces:

Supplier<IncentiveKeep>, Stateless<IncentiveKeep>, Incentive, VoluntaryIncentive

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

Determines lane change desire in order to adhere to keeping right or left. Such desire only exists if the route and speed (considered within an anticipation distance) are not affected on the adjacent lane. The level of lane change desire is only sufficient to overcome the lowest threshold for free lane changes.

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 ParameterTypeDouble	DFREE	Free lane change threshold parameter type.
static final IncentiveKeep	SINGLETON	Singleton instance.

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

Methods inherited from class java.lang.Object

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

Field Details

DFREE

protected static final ParameterTypeDouble DFREE

Free lane change threshold parameter type.

SINGLETON

public static final IncentiveKeep SINGLETON

Singleton instance.

Method Details

get

public IncentiveKeep get()

Specified by:

get in interface Stateless<IncentiveKeep>

Specified by:

get in interface Supplier<IncentiveKeep>

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