Class IncentiveKeep

  • All Implemented Interfaces:
    Incentive, VoluntaryIncentive

    public class IncentiveKeep
    extends Object
    implements VoluntaryIncentive
    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-2022 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:
    Wouter Schakel
    • Field Detail

      • DFREE

        protected static final org.opentrafficsim.base.parameters.ParameterTypeDouble DFREE
        Free lane change threshold parameter type.
    • Constructor Detail

      • IncentiveKeep

        public IncentiveKeep()
    • Method Detail

      • determineDesire

        public final Desire determineDesire​(org.opentrafficsim.base.parameters.Parameters parameters,
                                            LanePerception perception,
                                            CarFollowingModel carFollowingModel,
                                            Desire mandatoryDesire,
                                            Desire voluntaryDesire)
                                     throws org.opentrafficsim.base.parameters.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:
        org.opentrafficsim.base.parameters.ParameterException - if a parameter is not given or out of bounds
        OperationalPlanException - in case of a perception exception