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

Class IncentiveRoute

java.lang.Object

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

All Implemented Interfaces:

Incentive, MandatoryIncentive

public class IncentiveRoute
extends Object
implements MandatoryIncentive

Determines desire by assessing the number of required lane change to be performed and the distance within which these have to be performed. Desire starts to increase from 0 linearly over a distance of x0 per required lane change, or per v*t0 per required lane change. For v>x0/t0 this gives that remaining time is critical, while for v<x0/t0 remaining space is critical. The desire is set towards the adjacent lane with a better situation. Negative desire towards the other lane, the extent of which pertains to the other adjacent lane, is also set.

Copyright (c) 2013-2017 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

Constructor Summary

Constructors

Constructor and Description
IncentiveRoute()

Method Summary

Modifier and Type	Method and Description
Desire	determineDesire(org.opentrafficsim.core.gtu.behavioralcharacteristics.BehavioralCharacteristics behavioralCharacteristics, LanePerception perception, CarFollowingModel carFollowingModel, Desire mandatoryDesire) Determines level of lane change desire for a lane change incentive.
static double	getDesireToLeave(org.opentrafficsim.core.gtu.behavioralcharacteristics.BehavioralCharacteristics bc, org.djunits.value.vdouble.scalar.Length x, int n, org.djunits.value.vdouble.scalar.Speed v) Calculates desire to leave a lane for a single infrastructure info.
String	toString()

Methods inherited from class java.lang.Object

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

Constructor Detail

IncentiveRoute

public IncentiveRoute()

Method Detail

determineDesire

public final Desire determineDesire(org.opentrafficsim.core.gtu.behavioralcharacteristics.BehavioralCharacteristics behavioralCharacteristics,
                                    LanePerception perception,
                                    CarFollowingModel carFollowingModel,
                                    Desire mandatoryDesire)
                             throws org.opentrafficsim.core.gtu.behavioralcharacteristics.ParameterException,
                                    org.opentrafficsim.core.gtu.plan.operational.OperationalPlanException

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

Specified by:

determineDesire in interface MandatoryIncentive

Parameters:

behavioralCharacteristics - behavioral characteristics

perception - perception

carFollowingModel - car-following model

mandatoryDesire - level of mandatory desire at current time

Returns:

level of lane change desire for this incentive

Throws:

org.opentrafficsim.core.gtu.behavioralcharacteristics.ParameterException - if a parameter is not given or out of bounds

org.opentrafficsim.core.gtu.plan.operational.OperationalPlanException - in case of a perception exception

getDesireToLeave

public static double getDesireToLeave(org.opentrafficsim.core.gtu.behavioralcharacteristics.BehavioralCharacteristics bc,
                                      org.djunits.value.vdouble.scalar.Length x,
                                      int n,
                                      org.djunits.value.vdouble.scalar.Speed v)
                               throws org.opentrafficsim.core.gtu.behavioralcharacteristics.ParameterException

Calculates desire to leave a lane for a single infrastructure info.

Parameters:

bc - behavioral characteristics

x - remaining distance for lane changes

n - number of required lane changes

v - current speed

Returns:

desire to leave a lane for a single infrastructure info

Throws:

org.opentrafficsim.core.gtu.behavioralcharacteristics.ParameterException - in case of a parameter exception

toString

public final String toString()

Overrides:

toString in class Object