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

Author:
Peter Knoppers
See Also:

  • Field Details

    • LOOKAHEAD

      protected static final org.opentrafficsim.base.parameters.ParameterTypeLength LOOKAHEAD
      Look ahead parameter type.

  • Constructor Details

    • FixedLaneChangeModel

      public FixedLaneChangeModel(LateralDirectionality laneChange)
      Construct a FixedLaneChangeModel.
      Parameters:
      laneChange - LateralDirectionality; the lane change that (always) be returned by this FixedLaneChangeModel.

  • Method Details

    • 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 GtuException, org.opentrafficsim.base.parameters.ParameterException
      Compute the acceleration and lane change.
      Specified by:
      computeLaneChangeAndAcceleration in interface LaneChangeModel
      Parameters:
      gtu - LaneBasedGtu; the GTU for which the acceleration and lane change is computed
      sameLaneTraffic - Collection<Headway>; the set of observable GTUs in the current lane (can not be null and may include the gtu)
      rightLaneTraffic - Collection<Headway>; 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<Headway>; 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 - Speed; 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:
      GtuException - when the speed of the GTU can not be determined
      org.opentrafficsim.base.parameters.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