org.opentrafficsim.road.gtu.lane.tactical.lanechangemobil

Class FixedLaneChangeModel

java.lang.Object

org.opentrafficsim.road.gtu.lane.tactical.lanechangemobil.FixedLaneChangeModel

All Implemented Interfaces:

Serializable, LaneChangeModel

public class FixedLaneChangeModel
extends Object
implements LaneChangeModel, Serializable

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

Copyright (c) 2013-2017 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

See Also:

Serialized Form

Constructor Summary

Constructors

Constructor and Description
FixedLaneChangeModel(org.opentrafficsim.core.network.LateralDirectionality laneChange) Construct a FixedLaneChangeModel.

Method Summary

Modifier and Type	Method and Description
LaneMovementStep	computeLaneChangeAndAcceleration(LaneBasedGTU gtu, Collection<Headway> sameLaneTraffic, Collection<Headway> rightLaneTraffic, Collection<Headway> leftLaneTraffic, 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.
String	getLongName() Return complete textual information about this instantiation of this GTU following model.
String	getName() Return the name of this GTU following model.
String	toString()

Methods inherited from class java.lang.Object

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

Constructor Detail

FixedLaneChangeModel

public FixedLaneChangeModel(org.opentrafficsim.core.network.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<Headway> sameLaneTraffic,
                                                               Collection<Headway> rightLaneTraffic,
                                                               Collection<Headway> leftLaneTraffic,
                                                               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)
                                                        throws org.opentrafficsim.core.gtu.GTUException,
                                                               org.opentrafficsim.core.gtu.behavioralcharacteristics.ParameterException

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

sameLaneTraffic - Collection<GTU>; the set of observable GTUs in the current lane (can not be null and may include the 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 - 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

nonPreferredLaneRouteIncentive - Acceleration; 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:

org.opentrafficsim.core.gtu.GTUException - when the speed of the GTU can not be determined

org.opentrafficsim.core.gtu.behavioralcharacteristics.ParameterException - in case of a parameter problem.

getName

public final String getName()

Return the name of this GTU following model.

Specified by:

getName in interface LaneChangeModel

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 LaneChangeModel

Returns:

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

toString

public final String toString()

Overrides:

toString in class Object