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

Field Summary

Fields

Modifier and Type	Field and Description
protected static org.opentrafficsim.base.parameters.ParameterTypeLength	LOOKAHEAD Look ahead parameter type.
static org.opentrafficsim.base.parameters.ParameterTypeDuration	T0 Look-ahead time for mandatory lane changes parameter type.

Constructor Summary

Constructors

Constructor and Description
IncentiveRoute()

Method Summary

Modifier and Type	Method and Description
Desire	determineDesire(org.opentrafficsim.base.parameters.Parameters parameters, LanePerception perception, CarFollowingModel carFollowingModel, Desire mandatoryDesire) Determines level of lane change desire for a lane change incentive.
static double	getDesireToLeave(org.opentrafficsim.base.parameters.Parameters params, 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

Field Detail

LOOKAHEAD

protected static final org.opentrafficsim.base.parameters.ParameterTypeLength LOOKAHEAD

Look ahead parameter type.

T0

public static final org.opentrafficsim.base.parameters.ParameterTypeDuration T0

Look-ahead time for mandatory lane changes parameter type.

Constructor Detail

IncentiveRoute

public IncentiveRoute()

Method Detail

determineDesire

public final Desire determineDesire(org.opentrafficsim.base.parameters.Parameters parameters,
                                    LanePerception perception,
                                    CarFollowingModel carFollowingModel,
                                    Desire mandatoryDesire)
                             throws org.opentrafficsim.base.parameters.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:

parameters - parameters

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.base.parameters.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.base.parameters.Parameters params,
                                      org.djunits.value.vdouble.scalar.Length x,
                                      int n,
                                      org.djunits.value.vdouble.scalar.Speed v)
                               throws org.opentrafficsim.base.parameters.ParameterException

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

Parameters:

params - parameters

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.base.parameters.ParameterException - in case of a parameter exception

toString

public final String toString()

Overrides:

toString in class Object