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

Class DirectedFixedLaneChangeModel

java.lang.Object

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

All Implemented Interfaces:

DirectedLaneChangeModel

public class DirectedFixedLaneChangeModel
extends Object
implements DirectedLaneChangeModel

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

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 11 feb. 2015

Author:

Peter Knoppers

Constructor Summary

Constructors

Constructor and Description
DirectedFixedLaneChangeModel()

Method Summary

Modifier and Type	Method and Description
DirectedLaneMovementStep	computeLaneChangeAndAcceleration(LaneBasedGTU gtu, org.opentrafficsim.core.network.LateralDirectionality direction, Collection<HeadwayGTU> sameLaneTraffic, Collection<HeadwayGTU> otherLaneTraffic, org.djunits.value.vdouble.scalar.Length.Rel 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.Time.Rel laneChangeTime) Compute the acceleration and lane change.
String	getLongName() Return complete textual information about this instantiation of this GTU following model.
String	getName() Return the name of this GTU following model.

Methods inherited from class java.lang.Object

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

Constructor Detail

DirectedFixedLaneChangeModel

public DirectedFixedLaneChangeModel()

Method Detail

computeLaneChangeAndAcceleration

public final DirectedLaneMovementStep computeLaneChangeAndAcceleration(LaneBasedGTU gtu,
                                                                       org.opentrafficsim.core.network.LateralDirectionality direction,
                                                                       Collection<HeadwayGTU> sameLaneTraffic,
                                                                       Collection<HeadwayGTU> otherLaneTraffic,
                                                                       org.djunits.value.vdouble.scalar.Length.Rel 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.Time.Rel laneChangeTime)
                                                                throws org.opentrafficsim.core.gtu.GTUException

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

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

otherLaneTraffic - 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

getName

public final String getName()

Return the name of this GTU following model.

Specified by:

getName in interface DirectedLaneChangeModel

Returns:

String; just the name of the GTU following model

getLongName

public final String getLongName()

Return complete textual information about this instantiation of this GTU following model.

Specified by:

getLongName in interface DirectedLaneChangeModel

Returns:

String; the name and parameter values of the GTU following model