View Javadoc
1   package org.opentrafficsim.road.gtu.lane.tactical.lmrs;
2   
3   import org.opentrafficsim.core.gtu.behavioralcharacteristics.BehavioralCharacteristics;
4   import org.opentrafficsim.core.gtu.behavioralcharacteristics.ParameterException;
5   import org.opentrafficsim.core.gtu.plan.operational.OperationalPlanException;
6   import org.opentrafficsim.road.gtu.lane.perception.LanePerception;
7   import org.opentrafficsim.road.gtu.lane.tactical.following.CarFollowingModel;
8   import org.opentrafficsim.road.gtu.lane.tactical.util.lmrs.Desire;
9   import org.opentrafficsim.road.gtu.lane.tactical.util.lmrs.VoluntaryIncentive;
10  
11  /**
12   * Determines lane change desire for courtesy lane changes, which are performed to supply space for other drivers. In case
13   * drivers in adjacent lanes have desire to change to the current lane, the driver has desire to change to the other adjacent
14   * lane. The level of desire depends on lane change courtesy, as well as the distance of the leading vehicle for which desire
15   * exists. This desire exists for only a single vehicle, i.e. the one giving maximum desire. A negative desire may also result
16   * for leaders in the 2nd adjacent lane desiring to change to the 1st adjacent lane. By not changing to the 1st adjacent lane,
17   * room is reserved for the leader on the 2nd adjacent lane.
18   * <p>
19   * Copyright (c) 2013-2016 Delft University of Technology, PO Box 5, 2600 AA, Delft, the Netherlands. All rights reserved. <br>
20   * BSD-style license. See <a href="http://opentrafficsim.org/docs/current/license.html">OpenTrafficSim License</a>.
21   * <p>
22   * @version $Revision$, $LastChangedDate$, by $Author$, initial version Apr 13, 2016 <br>
23   * @author <a href="http://www.transport.citg.tudelft.nl">Wouter Schakel</a>
24   */
25  public class IncentiveCourtesy implements VoluntaryIncentive
26  {
27  
28      /** {@inheritDoc} */
29      @Override
30      public final Desire determineDesire(final BehavioralCharacteristics behavioralCharacteristics,
31          final LanePerception perception, final CarFollowingModel carFollowingModel, final Desire mandatoryDesire,
32          final Desire voluntaryDesire) throws ParameterException, OperationalPlanException
33      {
34          return new Desire(0, 0); // XXXXX STUB
35      }
36  
37      /** {@inheritDoc} */
38      @Override
39      public final String toString()
40      {
41          return "IncentiveCourtesy";
42      }
43  
44  }