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

Class LMRS

java.lang.Object

org.opentrafficsim.road.gtu.lane.tactical.AbstractLaneBasedTacticalPlanner

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

All Implemented Interfaces:

Serializable, org.opentrafficsim.core.gtu.plan.tactical.TacticalPlanner

Direct Known Subclasses:

LMRSsync

public class LMRS
extends AbstractLaneBasedTacticalPlanner

Implementation of the LMRS (Lane change Model with Relaxation and Synchronization). See Schakel, W.J., Knoop, V.L., and Van Arem, B. (2012), LMRS: Integrated Lane Change Model with Relaxation and Synchronization, Transportation Research Records: Journal of the Transportation Research Board, No. 2316, pp. 47-57. Note in the official versions of TRB and TRR some errors appeared due to the typesetting of the papers (not in the preprint provided here). A list of errata for the official versions is found here.

Author:

Wouter Schakel

See Also:

Serialized Form

Field Summary

Fields

Modifier and Type	Field and Description
static org.opentrafficsim.core.gtu.drivercharacteristics.ParameterTypeDouble	DCOOP Cooperative lane change desire threshold.
static org.opentrafficsim.core.gtu.drivercharacteristics.ParameterTypeDouble	DFREE Free lane change desire threshold.
static org.opentrafficsim.core.gtu.drivercharacteristics.ParameterTypeDouble	DSYNC Synchronized lane change desire threshold.
protected ArrayList<MandatoryIncentive>	mandatoryIncentives List of mandatory lane change incentives.
protected org.djunits.value.vdouble.scalar.Acceleration	minimumAcceleration Minimum acceleration for current plan.
protected ArrayList<VoluntaryIncentive>	voluntaryIncentives List of voluntary lane change incentives.

Constructor Summary

Constructors

Constructor and Description
LMRS()

Method Summary

Modifier and Type	Method and Description
void	addMandatoryIncentive(MandatoryIncentive incentive) Adds a mandatory incentive.
void	addVoluntaryIncentive(VoluntaryIncentive incentive) Adds a voluntary incentive.
protected org.djunits.value.vdouble.scalar.Acceleration	calculateAcceleration(LaneBasedGTU follower, HeadwayGTU leader)
protected org.djunits.value.vdouble.scalar.Acceleration	calculateAcceleration(LaneBasedGTU follower, HeadwayGTU leader, double d)
void	disableLaneChanges() Disables lane changes by clearing all incentives and setting a dummy incentive as mandatory incentive.
org.opentrafficsim.core.gtu.plan.operational.OperationalPlan	generateOperationalPlan(org.opentrafficsim.core.gtu.GTU gtu, org.djunits.value.vdouble.scalar.Time.Abs startTime, nl.tudelft.simulation.language.d3.DirectedPoint locationAtStartTime)
protected void	lowerAcceleration(org.djunits.value.vdouble.scalar.Acceleration a) Remembers the lowest acceleration per tactical plan.
protected org.djunits.value.vdouble.scalar.Acceleration	safe(org.djunits.value.vdouble.scalar.Acceleration a, org.djunits.value.vdouble.scalar.Acceleration b) Limits the supplied acceleration to safe values, i.e.
void	setDefaultIncentives() Sets the default lane change incentives.

Methods inherited from class org.opentrafficsim.road.gtu.lane.tactical.AbstractLaneBasedTacticalPlanner

buildLaneListForwardXXX, buildLanePathInfo, buildLanePathInfo, buildLanePathInfo, buildLinkListForward, connectsToPath, determineNextSplit, getReferenceLane, noLaneDrop

Methods inherited from class java.lang.Object

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

Field Detail

DFREE

public static final org.opentrafficsim.core.gtu.drivercharacteristics.ParameterTypeDouble DFREE

Free lane change desire threshold.

DSYNC

public static final org.opentrafficsim.core.gtu.drivercharacteristics.ParameterTypeDouble DSYNC

Synchronized lane change desire threshold.

DCOOP

public static final org.opentrafficsim.core.gtu.drivercharacteristics.ParameterTypeDouble DCOOP

Cooperative lane change desire threshold.

minimumAcceleration

protected org.djunits.value.vdouble.scalar.Acceleration minimumAcceleration

Minimum acceleration for current plan.

mandatoryIncentives

protected ArrayList<MandatoryIncentive> mandatoryIncentives

List of mandatory lane change incentives.

voluntaryIncentives

protected ArrayList<VoluntaryIncentive> voluntaryIncentives

List of voluntary lane change incentives.

Constructor Detail

LMRS

public LMRS()

Method Detail

addMandatoryIncentive

public void addMandatoryIncentive(MandatoryIncentive incentive)

Adds a mandatory incentive.

Parameters:

incentive - Incentive to add.

addVoluntaryIncentive

public void addVoluntaryIncentive(VoluntaryIncentive incentive)

Adds a voluntary incentive.

Parameters:

incentive - Incentive to add.

setDefaultIncentives

public void setDefaultIncentives()

Sets the default lane change incentives. These are the mandatory route incentive, and the voluntary speed and keep incentives. Any existing incentives are removed.

disableLaneChanges

public void disableLaneChanges()

Disables lane changes by clearing all incentives and setting a dummy incentive as mandatory incentive.

generateOperationalPlan

public org.opentrafficsim.core.gtu.plan.operational.OperationalPlan generateOperationalPlan(org.opentrafficsim.core.gtu.GTU gtu,
                                                                                            org.djunits.value.vdouble.scalar.Time.Abs startTime,
                                                                                            nl.tudelft.simulation.language.d3.DirectedPoint locationAtStartTime)
                                                                                     throws org.opentrafficsim.core.gtu.plan.operational.OperationalPlanException,
                                                                                            org.opentrafficsim.core.gtu.GTUException,
                                                                                            org.opentrafficsim.core.network.NetworkException

Throws:

org.opentrafficsim.core.gtu.plan.operational.OperationalPlanException

org.opentrafficsim.core.gtu.GTUException

org.opentrafficsim.core.network.NetworkException

calculateAcceleration

protected org.djunits.value.vdouble.scalar.Acceleration calculateAcceleration(LaneBasedGTU follower,
                                                                              HeadwayGTU leader,
                                                                              double d)

calculateAcceleration

protected org.djunits.value.vdouble.scalar.Acceleration calculateAcceleration(LaneBasedGTU follower,
                                                                              HeadwayGTU leader)

lowerAcceleration

protected void lowerAcceleration(org.djunits.value.vdouble.scalar.Acceleration a)

Remembers the lowest acceleration per tactical plan.

Parameters:

a - Acceleration to remember if lower than any previous acceleration.

safe

protected org.djunits.value.vdouble.scalar.Acceleration safe(org.djunits.value.vdouble.scalar.Acceleration a,
                                                             org.djunits.value.vdouble.scalar.Acceleration b)

Limits the supplied acceleration to safe values, i.e. above or equal to -b.

Parameters:

a - Acceleration to limit.

b - Deceleration to limit to.

Returns:

Limited acceleration.