1 package org.opentrafficsim.road.gtu.lane;
2
3 import org.djunits.unit.SpeedUnit;
4 import org.djunits.value.vdouble.scalar.Speed;
5
6 /**
7 * Different methods of dealing with lane bookkeeping when changing lane.
8 * <p>
9 * Copyright (c) 2024-2024 Delft University of Technology, PO Box 5, 2600 AA, Delft, the Netherlands. All rights reserved. <br>
10 * BSD-style license. See <a href="https://opentrafficsim.org/docs/license.html">OpenTrafficSim License</a>.
11 * </p>
12 * @author <a href="https://github.com/wjschakel">Wouter Schakel</a>
13 */
14 public enum LaneBookkeeping
15 {
16
17 /**
18 * Instantaneous lane changes. GTUs make a lateral jump. This is advised for scientific output as models are not well
19 * developed regarding lane change movement, lane change cancellation, the leader in the start lane (particularly at low
20 * speed), and how potential followers respond.
21 */
22 INSTANT,
23
24 /**
25 * Bookkeeping changes at the start of a lane change. The GTU has to make the lateral move with possible GTU overlap in the
26 * from lane. Trajectories are instantaneously recorded in the target lane.
27 */
28 START,
29
30 /**
31 * Bookkeeping changes when the reference point of the GTU enters the adjacent lane. Due to model limitations this can
32 * create dead-locks and severe decelerations at low speed in dense traffic. This is advised for control of vehicles in
33 * driver simulators due to the full continuous movement without overlap between GTUs.
34 */
35 EDGE,
36
37 /**
38 * The same as EDGE, but START is used when the speed drops below a low threshold. This prevents dead-locks and severe
39 * decelerations, but allows GTU overlap in the from lane at low speeds. This is advised for microscopic simulations with
40 * visual purposes. Using START only at low speeds makes the trajectories more correlated to the movement.
41 */
42 START_AND_EDGE;
43
44 /** Threshold speed below which START is used in START_AND_EDGE. */
45 public static final Speed START_THRESHOLD = new Speed(5.0, SpeedUnit.KM_PER_HOUR);
46
47 }