org.opentrafficsim.road.gtu.lane.tactical.directedlanechange

Class AbstractDirectedLaneChangeModel

java.lang.Object

org.opentrafficsim.road.gtu.lane.tactical.directedlanechange.AbstractDirectedLaneChangeModel

All Implemented Interfaces:

DirectedLaneChangeModel

Direct Known Subclasses:

DirectedAltruistic, DirectedEgoistic

public abstract class AbstractDirectedLaneChangeModel
extends Object
implements DirectedLaneChangeModel

Common code for a family of lane change models like in M. Treiber and A. Kesting Traffic Flow Dynamics, Springer-Verlag Berlin Heidelberg 2013, pp 239-244.

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: 1401 $, $LastChangedDate: 2015-09-14 01:33:02 +0200 (Mon, 14 Sep 2015) $, by $Author: averbraeck $, initial version 4 nov. 2014

Author:

Peter Knoppers

Constructor Summary

Constructors

Constructor and Description
AbstractDirectedLaneChangeModel(LanePerception perception) Construct a DirectedLaneChangeModel.

Method Summary

Modifier and Type	Method and Description
abstract org.djunits.value.vdouble.scalar.Acceleration	applyDriverPersonality(DualAccelerationStep accelerationStep) Return the weighted acceleration as described by the personality.
DirectedLaneMovementStep	computeLaneChangeAndAcceleration(LaneBasedGTU gtu, org.opentrafficsim.core.network.LateralDirectionality direction, Collection<Headway> sameLaneGTUs, Collection<Headway> otherLaneGTUs, org.djunits.value.vdouble.scalar.Length maxDistance, org.djunits.value.vdouble.scalar.Speed speedLimit, org.djunits.value.vdouble.scalar.Acceleration otherLaneRouteIncentive, org.djunits.value.vdouble.scalar.Acceleration laneChangeThreshold, org.djunits.value.vdouble.scalar.Duration laneChangeTime) Compute the acceleration and lane change.
LanePerception	getPerception()

Methods inherited from class java.lang.Object

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

Methods inherited from interface org.opentrafficsim.road.gtu.lane.tactical.directedlanechange.DirectedLaneChangeModel

getLongName, getName

Constructor Detail

AbstractDirectedLaneChangeModel

public AbstractDirectedLaneChangeModel(LanePerception perception)

Construct a DirectedLaneChangeModel.

Parameters:

perception - the perception.

Method Detail

computeLaneChangeAndAcceleration

public final DirectedLaneMovementStep computeLaneChangeAndAcceleration(LaneBasedGTU gtu,
                                                                       org.opentrafficsim.core.network.LateralDirectionality direction,
                                                                       Collection<Headway> sameLaneGTUs,
                                                                       Collection<Headway> otherLaneGTUs,
                                                                       org.djunits.value.vdouble.scalar.Length maxDistance,
                                                                       org.djunits.value.vdouble.scalar.Speed speedLimit,
                                                                       org.djunits.value.vdouble.scalar.Acceleration otherLaneRouteIncentive,
                                                                       org.djunits.value.vdouble.scalar.Acceleration laneChangeThreshold,
                                                                       org.djunits.value.vdouble.scalar.Duration laneChangeTime)
                                                                throws org.opentrafficsim.core.gtu.GTUException,
                                                                       org.opentrafficsim.core.gtu.behavioralcharacteristics.ParameterException,
                                                                       org.opentrafficsim.core.gtu.plan.operational.OperationalPlanException

Compute the acceleration and lane change.

Specified by:

computeLaneChangeAndAcceleration in interface DirectedLaneChangeModel

Parameters:

gtu - GTU; the GTU for which the acceleration and lane change is computed

direction - the direction of the lane we want to change to

sameLaneGTUs - Collection<HeadwayGTU>; the set of information about observable GTUs in the current lane (can not be null and may include the gtu)

otherLaneGTUs - Collection<HeadwayGTU>; the set of information about observable GTUs in the adjacent lane where GTUs should drive in the absence of other traffic (must be null if there is no such lane)

maxDistance - the maximum distance that the current GTU can drive, e.g. due to a lane drop

speedLimit - Speed; the local speed limit

otherLaneRouteIncentive - Acceleration; route incentive to merge to the adjacent lane where GTUs should drive in the absence of other traffic

laneChangeThreshold - Acceleration; threshold that prevents lane changes that have very little benefit merge to overtake other traffic

laneChangeTime - time spent to overtake

Returns:

LaneMovementStep; the result of the lane change and GTU following model

Throws:

org.opentrafficsim.core.gtu.GTUException - when the position of the GTU on the lane(s) cannot be determined

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

org.opentrafficsim.core.gtu.plan.operational.OperationalPlanException - if DefaultAlexander perception category is not present

applyDriverPersonality

public abstract org.djunits.value.vdouble.scalar.Acceleration applyDriverPersonality(DualAccelerationStep accelerationStep)

Return the weighted acceleration as described by the personality. This incorporates the personality of the driver to the lane change decisions.

Parameters:

accelerationStep - DualAccelerationStep; the DualAccelerationStep that contains the AccelerationStep that the reference GTU will make and the AccelerationStep that the (new) follower GTU will make

Returns:

Acceleration; the acceleration that the personality of the driver uses (in a comparison to a similarly computed acceleration in the non-, or different-lane-changed state) to decide if a lane change should be performed

getPerception

public final LanePerception getPerception()

Specified by:

getPerception in interface DirectedLaneChangeModel

Returns:

the perception.