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-2014 Delft University of Technology, PO Box 5, 2600 AA, Delft, the Netherlands. All rights reserved.
BSD-style license. See OpenTrafficSim License.

Version:

4 nov. 2014

Author:

Peter Knoppers

Constructor Summary

Constructors

Constructor and Description
AbstractLaneChangeModel()

Method Summary

Methods

Modifier and Type	Method and Description
abstract DoubleScalar.Abs<AccelerationUnit>	applyDriverPersonality(AccelerationStep[] 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

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.
FIXME the parameters of this method will change. Hopefully will become straightforward to figure out the nearby vehicles in the current and the adjacent lanes.

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 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>; changing 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(AccelerationStep[] accelerationSteps)

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

Parameters:

accelerationSteps - AccelerationStep[]; the AccelerationStep that the reference GTU will make (in position 0 of the array) and the AccelerationStep that the (new) follower GTU will make (in position 1 of the array)

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