org.opentrafficsim.road.gtu.lane.changing

Class AbstractLaneChangeModel

java.lang.Object

org.opentrafficsim.road.gtu.lane.changing.AbstractLaneChangeModel

All Implemented Interfaces:

LaneChangeModel

Direct Known Subclasses:

Altruistic, Egoistic

public abstract class AbstractLaneChangeModel
extends Object
implements LaneChangeModel

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-2015 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
AbstractLaneChangeModel()

Method Summary

Modifier and Type	Method and Description
abstract org.djunits.value.vdouble.scalar.Acceleration	applyDriverPersonality(DualAccelerationStep accelerationSteps) Return the weighted acceleration as described by the personality.
LaneMovementStep	computeLaneChangeAndAcceleration(LaneBasedGTU gtu, Collection<HeadwayGTU> sameLaneGTUs, Collection<HeadwayGTU> preferredLaneGTUs, Collection<HeadwayGTU> nonPreferredLaneGTUs, org.djunits.value.vdouble.scalar.Speed speedLimit, org.djunits.value.vdouble.scalar.Acceleration preferredLaneRouteIncentive, org.djunits.value.vdouble.scalar.Acceleration laneChangeThreshold, org.djunits.value.vdouble.scalar.Acceleration nonPreferredLaneRouteIncentive) Compute the acceleration and lane change.

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.changing.LaneChangeModel

getLongName, getName

Constructor Detail

AbstractLaneChangeModel

public AbstractLaneChangeModel()

Method Detail

computeLaneChangeAndAcceleration

public final LaneMovementStep computeLaneChangeAndAcceleration(LaneBasedGTU gtu,
                                                               Collection<HeadwayGTU> sameLaneGTUs,
                                                               Collection<HeadwayGTU> preferredLaneGTUs,
                                                               Collection<HeadwayGTU> nonPreferredLaneGTUs,
                                                               org.djunits.value.vdouble.scalar.Speed speedLimit,
                                                               org.djunits.value.vdouble.scalar.Acceleration preferredLaneRouteIncentive,
                                                               org.djunits.value.vdouble.scalar.Acceleration laneChangeThreshold,
                                                               org.djunits.value.vdouble.scalar.Acceleration nonPreferredLaneRouteIncentive)

Compute the acceleration and lane change.

Specified by:

computeLaneChangeAndAcceleration in interface LaneChangeModel

Parameters:

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

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

preferredLaneGTUs - Collection<GTU>; the set of 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)

nonPreferredLaneGTUs - Collection<GTU>; the set of observable GTUs in the adjacent lane into which GTUs should merge to overtake other traffic (must be null if there is no such lane)

speedLimit - DoubleScalarAbs<SpeedUnit>; the local speed limit

preferredLaneRouteIncentive - DoubleScalar.Rel<AccelerationUnit>; route incentive to merge to the adjacent lane where GTUs should drive in the absence of other traffic

laneChangeThreshold - DoubleScalar.Rel<AccelerationUnit>; threshold that prevents lane changes that have very little benefit

nonPreferredLaneRouteIncentive - DoubleScalar.Rel<AccelerationUnit>; route incentive to merge to the adjacent lane into which GTUs should merge to overtake other traffic

Returns:

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

applyDriverPersonality

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

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

Parameters:

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

Returns:

DoubleScalar.Abs<AccelerationUnit>; 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