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, TacticalPlanner<LaneBasedGTU,LanePerception>, Blockable, DesireBased, LaneBasedTacticalPlanner, Synchronizable

public class LMRS
extends AbstractLaneBasedTacticalPlanner
implements DesireBased, Synchronizable, Blockable

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.

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

See Also:

Serialized Form

Nested Class Summary

Nested classes/interfaces inherited from interface org.opentrafficsim.road.gtu.lane.tactical.Synchronizable

Synchronizable.State

Field Summary

Fields

Modifier and Type	Field and Description
static ParameterTypeClassList<AccelerationIncentive>	ACCELERATION Parameter type for acceleration incentives.
static ParameterTypeClassList<MandatoryIncentive>	MANDATORY Parameter type for mandatory lane change incentives.
static ParameterTypeClassList<VoluntaryIncentive>	VOLUNTARY Parameter type for voluntary lane change incentives.

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

DT, LOOKAHEAD, TACTICAL_PLANNER

Constructor Summary

Constructors

Constructor and Description
LMRS(CarFollowingModel carFollowingModel, LaneBasedGTU gtu, LanePerception lanePerception, Synchronization synchronization, Cooperation cooperation, GapAcceptance gapAcceptance, Tailgating tailGating) Constructor setting the car-following model.

Method Summary

Modifier and Type	Method and Description
void	addAccelerationIncentive(AccelerationIncentive incentive) Adds an acceleration incentive.
void	addMandatoryIncentive(MandatoryIncentive incentive) Adds a mandatory incentive.
void	addVoluntaryIncentive(VoluntaryIncentive incentive) Adds a voluntary incentive.
OperationalPlan	generateOperationalPlan(Time startTime, DirectedPoint locationAtStartTime)
Desire	getLatestDesire(Class<? extends Incentive> incentiveClass) Returns the latest desire from the specified incentive.
Synchronizable.State	getSynchronizationState() Returns the synchronization state.
boolean	isBlocking() Returns whether the GTU is blocking conflicts.
void	setDefaultIncentives() Sets the default lane change incentives.
String	toString()

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

buildLanePathInfo, buildLanePathInfo, buildLinkListForward, concatenateNull, connectsToPath, determineNextSplit, getCarFollowingModel, getGtu, getPerception, noLaneDrop, setCarFollowingModel

Methods inherited from class java.lang.Object

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

Methods inherited from interface org.opentrafficsim.road.gtu.lane.tactical.LaneBasedTacticalPlanner

chooseLaneAtSplit, okDistance, rightMost

Field Detail

MANDATORY

public static final ParameterTypeClassList<MandatoryIncentive> MANDATORY

Parameter type for mandatory lane change incentives.

VOLUNTARY

public static final ParameterTypeClassList<VoluntaryIncentive> VOLUNTARY

Parameter type for voluntary lane change incentives.

ACCELERATION

public static final ParameterTypeClassList<AccelerationIncentive> ACCELERATION

Parameter type for acceleration incentives.

Constructor Detail

LMRS

public LMRS(CarFollowingModel carFollowingModel,
            LaneBasedGTU gtu,
            LanePerception lanePerception,
            Synchronization synchronization,
            Cooperation cooperation,
            GapAcceptance gapAcceptance,
            Tailgating tailGating)

Constructor setting the car-following model.

Parameters:

carFollowingModel - CarFollowingModel; Car-following model.

gtu - LaneBasedGTU; GTU

lanePerception - LanePerception; perception

synchronization - Synchronization; type of synchronization

cooperation - Cooperation; type of cooperation

gapAcceptance - GapAcceptance; gap-acceptance

tailGating - Tailgating; tail gating

Method Detail

addMandatoryIncentive

public final void addMandatoryIncentive(MandatoryIncentive incentive)

Adds a mandatory incentive. Ignores null.

Parameters:

incentive - MandatoryIncentive; Incentive to add.

addVoluntaryIncentive

public final void addVoluntaryIncentive(VoluntaryIncentive incentive)

Adds a voluntary incentive. Ignores null.

Parameters:

incentive - VoluntaryIncentive; Incentive to add.

addAccelerationIncentive

public final void addAccelerationIncentive(AccelerationIncentive incentive)

Adds an acceleration incentive. Ignores null.

Parameters:

incentive - AccelerationIncentive; Incentive to add.

setDefaultIncentives

public final void setDefaultIncentives()

Sets the default lane change incentives.

generateOperationalPlan

public final OperationalPlan generateOperationalPlan(Time startTime,
                                                     DirectedPoint locationAtStartTime)
                                              throws OperationalPlanException,
                                                     GTUException,
                                                     NetworkException,
                                                     ParameterException

Specified by:

generateOperationalPlan in interface TacticalPlanner<LaneBasedGTU,LanePerception>

Throws:

OperationalPlanException

GTUException

NetworkException

ParameterException

getLatestDesire

public final Desire getLatestDesire(Class<? extends Incentive> incentiveClass)

Returns the latest desire from the specified incentive.

Specified by:

getLatestDesire in interface DesireBased

Parameters:

incentiveClass - Class<? extends Incentive>; incentive class

Returns:

latest desire from the specified incentive

getSynchronizationState

public Synchronizable.State getSynchronizationState()

Returns the synchronization state.

Specified by:

getSynchronizationState in interface Synchronizable

Returns:

State; synchronization state

isBlocking

public boolean isBlocking()

Returns whether the GTU is blocking conflicts.

Specified by:

isBlocking in interface Blockable

Returns:

boolean; whether the GTU is blocking conflicts

toString

public final String toString()

Overrides:

toString in class Object