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

Interface VoluntaryIncentive

All Superinterfaces:

Incentive

All Known Implementing Classes:

IncentiveCourtesy, IncentiveKeep, IncentiveSocioSpeed, IncentiveSpeed, IncentiveSpeedWithCourtesy, IncentiveStayRight

public interface VoluntaryIncentive
extends Incentive

Interface for voluntary incentives.

Copyright (c) 2013-2018 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 Apr 13, 2016

Author:

Alexander Verbraeck, Peter Knoppers, Wouter Schakel

Method Summary

Modifier and Type	Method and Description
Desire	determineDesire(Parameters parameters, LanePerception perception, CarFollowingModel carFollowingModel, Desire mandatoryDesire, Desire voluntaryDesire) Determines level of lane change desire for a lane change incentive.

Method Detail

determineDesire

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.

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