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

Class AbstractLMRS

java.lang.Object

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

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

All Implemented Interfaces:

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

Direct Known Subclasses:

LMRS, LMRSsync

public abstract class AbstractLMRS
extends AbstractLaneBasedTacticalPlanner

Houses common functionality for LMRS models.

• Set of mandatory lane change incentives, with check on having at least one.
• Set of voluntary lane change incentives.
• Static parameter type definitions for dfree, dsync and dcoop, which are LMRS specific parameters.
• Method to get the minimum acceleration.

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

Field Summary

Fields

Modifier and Type	Field and Description
static org.opentrafficsim.core.gtu.behavioralcharacteristics.ParameterTypeAcceleration	A_LAT Maximum comfortable acceleration in the lateral direction.
static org.opentrafficsim.core.gtu.behavioralcharacteristics.ParameterTypeDouble	DCOOP Cooperative lane change desire threshold.
static org.opentrafficsim.core.gtu.behavioralcharacteristics.ParameterTypeDouble	DFREE Free lane change desire threshold.
static org.opentrafficsim.core.gtu.behavioralcharacteristics.ParameterTypeDouble	DSYNC Synchronized lane change desire threshold.
static org.opentrafficsim.core.gtu.behavioralcharacteristics.ParameterTypeDuration	DT Fixed model time step.

Constructor Summary

Constructors

Constructor and Description
AbstractLMRS(CarFollowingModel carFollowingModel) Constructor setting the car-following model.

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	considerSpeedLimitTransitions(org.opentrafficsim.core.gtu.behavioralcharacteristics.BehavioralCharacteristics behavioralCharacteristics, org.djunits.value.vdouble.scalar.Speed speed, SpeedLimitProspect speedLimitProspect, AbstractCarFollowingModel carFollowingModel) Acceleration for speed limit transitions.
void	disableLaneChanges() Disables lane changes by clearing all incentives and setting a dummy incentive as mandatory incentive.
protected void	exponentialHeadwayRelaxation(org.opentrafficsim.core.gtu.behavioralcharacteristics.BehavioralCharacteristics bc) Updates the desired headway following an exponential shape approximated with fixed time step DT.
abstract Set<MandatoryIncentive>	getDefaultMandatoryIncentives() Returns a set of default mandatory incentives.
abstract Set<VoluntaryIncentive>	getDefaultVoluntaryIncentives() Returns a set of default voluntary incentives.
Set<MandatoryIncentive>	getMandatoryIncentives() Returns a defensive copy of the mandatory incentives.
Set<VoluntaryIncentive>	getVoluntaryIncentives() Returns a defensive copy of the voluntary incentives.
protected org.djunits.value.vdouble.scalar.Acceleration	limitDeceleration(org.djunits.value.vdouble.scalar.Acceleration a, org.djunits.value.vdouble.scalar.Acceleration b) Limits the supplied acceleration to a given maximum deceleration.
org.djunits.value.vdouble.scalar.Acceleration	minOf(org.djunits.value.vdouble.scalar.Acceleration a1, org.djunits.value.vdouble.scalar.Acceleration a2) Returns the minimum of two accelerations.
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, getCarFollowingModel, getReferenceLane, noLaneDrop, setCarFollowingModel

Methods inherited from class java.lang.Object

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

Methods inherited from interface org.opentrafficsim.core.gtu.plan.tactical.TacticalPlanner

generateOperationalPlan

Field Detail

DT

public static final org.opentrafficsim.core.gtu.behavioralcharacteristics.ParameterTypeDuration DT

Fixed model time step.

DFREE

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

Free lane change desire threshold.

DSYNC

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

Synchronized lane change desire threshold.

DCOOP

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

Cooperative lane change desire threshold.

A_LAT

public static final org.opentrafficsim.core.gtu.behavioralcharacteristics.ParameterTypeAcceleration A_LAT

Maximum comfortable acceleration in the lateral direction.

Constructor Detail

AbstractLMRS

public AbstractLMRS(CarFollowingModel carFollowingModel)

Constructor setting the car-following model.

Parameters:

carFollowingModel - Car-following model.

Method Detail

addMandatoryIncentive

public final void addMandatoryIncentive(MandatoryIncentive incentive)

Adds a mandatory incentive. Ignores null.

Parameters:

incentive - Incentive to add.

addVoluntaryIncentive

public final void addVoluntaryIncentive(VoluntaryIncentive incentive)

Adds a voluntary incentive. Ignores null.

Parameters:

incentive - Incentive to add.

setDefaultIncentives

public final void setDefaultIncentives()

Sets the default lane change incentives.

getDefaultMandatoryIncentives

public abstract Set<MandatoryIncentive> getDefaultMandatoryIncentives()

Returns a set of default mandatory incentives.

Returns:

Set of default mandatory incentives.

getDefaultVoluntaryIncentives

public abstract Set<VoluntaryIncentive> getDefaultVoluntaryIncentives()

Returns a set of default voluntary incentives.

Returns:

Set of default voluntary incentives.

disableLaneChanges

public final void disableLaneChanges()

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

limitDeceleration

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

Limits the supplied acceleration to a given maximum deceleration.

Parameters:

a - Acceleration to limit.

b - Maximum deceleration to limit to.

Returns:

Limited acceleration ≥-b.

minOf

public final org.djunits.value.vdouble.scalar.Acceleration minOf(org.djunits.value.vdouble.scalar.Acceleration a1,
                                                                 org.djunits.value.vdouble.scalar.Acceleration a2)

Returns the minimum of two accelerations.

Parameters:

a1 - First acceleration.

a2 - Second acceleration.

Returns:

Minimum of two accelerations.

getMandatoryIncentives

public final Set<MandatoryIncentive> getMandatoryIncentives()
                                                     throws org.opentrafficsim.core.gtu.plan.operational.OperationalPlanException

Returns a defensive copy of the mandatory incentives.

Returns:

Defensive copy of the mandatory incentives.

Throws:

org.opentrafficsim.core.gtu.plan.operational.OperationalPlanException - If there is no mandatory incentive. The model requires at least one.

getVoluntaryIncentives

public final Set<VoluntaryIncentive> getVoluntaryIncentives()

Returns a defensive copy of the voluntary incentives.

Returns:

Defensive copy of the voluntary incentives.

exponentialHeadwayRelaxation

protected final void exponentialHeadwayRelaxation(org.opentrafficsim.core.gtu.behavioralcharacteristics.BehavioralCharacteristics bc)
                                           throws org.opentrafficsim.core.gtu.behavioralcharacteristics.ParameterException

Updates the desired headway following an exponential shape approximated with fixed time step DT.

Parameters:

bc - Behavioral characteristics.

Throws:

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

considerSpeedLimitTransitions

protected final org.djunits.value.vdouble.scalar.Acceleration considerSpeedLimitTransitions(org.opentrafficsim.core.gtu.behavioralcharacteristics.BehavioralCharacteristics behavioralCharacteristics,
                                                                                            org.djunits.value.vdouble.scalar.Speed speed,
                                                                                            SpeedLimitProspect speedLimitProspect,
                                                                                            AbstractCarFollowingModel carFollowingModel)
                                                                                     throws org.opentrafficsim.core.gtu.behavioralcharacteristics.ParameterException

Acceleration for speed limit transitions. This implementation decelerates before curves and speed bumps. For this it uses approachTargetSpeed() of the abstract car-following model implementation. All remaining transitions happen in the default manner, i.e. deceleration and acceleration after the speed limit change and governed by the car-following model.

Parameters:

behavioralCharacteristics - behavioral characteristics

speed - current speed

speedLimitProspect - speed limit prospect

carFollowingModel - car following model

Returns:

acceleration for speed limit transitions

Throws:

org.opentrafficsim.core.gtu.behavioralcharacteristics.ParameterException - if a required parameter is not found