org.opentrafficsim.core.gtu.lane.changing

Class AbstractLaneChangeModel

java.lang.Object

org.opentrafficsim.core.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: 1293 $, $LastChangedDate: 2015-08-23 12:51:29 +0200 (Sun, 23 Aug 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 DoubleScalar.Abs<AccelerationUnit>	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, DoubleScalar.Abs<SpeedUnit> speedLimit, DoubleScalar.Rel<AccelerationUnit> preferredLaneRouteIncentive, DoubleScalar.Rel<AccelerationUnit> laneChangeThreshold, DoubleScalar.Rel<AccelerationUnit> 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.core.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,
                                                               DoubleScalar.Abs<SpeedUnit> speedLimit,
                                                               DoubleScalar.Rel<AccelerationUnit> preferredLaneRouteIncentive,
                                                               DoubleScalar.Rel<AccelerationUnit> laneChangeThreshold,
                                                               DoubleScalar.Rel<AccelerationUnit> nonPreferredLaneRouteIncentive)
                                                        throws RemoteException

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

Throws:

RemoteException - in case the simulation time cannot be retrieved.

applyDriverPersonality

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