org.opentrafficsim.core.gtu.lane.changing

Class FixedLaneChangeModel

java.lang.Object

org.opentrafficsim.core.gtu.lane.changing.FixedLaneChangeModel

All Implemented Interfaces:

LaneChangeModel

public class FixedLaneChangeModel
extends Object
implements LaneChangeModel

Dummy lane change model with totally predictable results (used for testing).

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:

11 feb. 2015

Author:

Peter Knoppers

Constructor Summary

Constructors

Constructor and Description
FixedLaneChangeModel(LateralDirectionality laneChange) Construct a FixedLaneChangeModel.

Method Summary

Methods

Modifier and Type

Method and Description

LaneMovementStep

computeLaneChangeAndAcceleration(LaneBasedGTU<?> gtu, Collection<HeadwayGTU> sameLaneTraffic, Collection<HeadwayGTU> rightLaneTraffic, Collection<HeadwayGTU> leftLaneTraffic, 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

FixedLaneChangeModel

public FixedLaneChangeModel(LateralDirectionality laneChange)

Construct a FixedLaneChangeModel.

Parameters:

laneChange - LateralDirectionality; the lane change that (always) be returned by this FixedLaneChangeModel.

Method Detail

computeLaneChangeAndAcceleration

public final LaneMovementStep computeLaneChangeAndAcceleration(LaneBasedGTU<?> gtu,
                                                Collection<HeadwayGTU> sameLaneTraffic,
                                                Collection<HeadwayGTU> rightLaneTraffic,
                                                Collection<HeadwayGTU> leftLaneTraffic,
                                                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

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

rightLaneTraffic - 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)

leftLaneTraffic - 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.