View Javadoc
1   package org.opentrafficsim.road.gtu.lane;
2   
3   import org.djunits.value.vdouble.scalar.Length;
4   import org.djunits.value.vdouble.scalar.Speed;
5   import org.opentrafficsim.core.dsol.OTSSimulatorInterface;
6   import org.opentrafficsim.core.gtu.GTUException;
7   import org.opentrafficsim.core.gtu.GTUType;
8   import org.opentrafficsim.core.network.OTSNetwork;
9   
10  /**
11   * Specific type of LaneBasedGTU. This class adds length, width, maximum speed and a reference to the simulator to the
12   * AbstractLaneBasedGTU.
13   * <p>
14   * Copyright (c) 2013-2019 Delft University of Technology, PO Box 5, 2600 AA, Delft, the Netherlands. All rights reserved. <br>
15   * BSD-style license. See <a href="http://opentrafficsim.org/docs/license.html">OpenTrafficSim License</a>.
16   * <p>
17   * @version $Revision: 1401 $, $LastChangedDate: 2015-09-14 01:33:02 +0200 (Mon, 14 Sep 2015) $, by $Author: averbraeck $,
18   *          initial version Jan 1, 2015 <br>
19   * @author <a href="http://www.tbm.tudelft.nl/averbraeck">Alexander Verbraeck</a>
20   * @author <a href="http://www.tudelft.nl/pknoppers">Peter Knoppers</a>
21   */
22  public abstract class AbstractLaneBasedIndividualGTU extends AbstractLaneBasedGTU
23  {
24      /** */
25      private static final long serialVersionUID = 20140822L;
26  
27      /** The maximum length of the GTU (parallel with driving direction). */
28      private final Length length;
29  
30      /** The maximum width of the GTU (perpendicular to driving direction). */
31      private final Length width;
32  
33      /** The maximum speed of the GTU (in the driving direction). */
34      private final Speed maximumSpeed;
35  
36      /** Distance over which the GTU should not change lane after being created. */
37      private Length noLaneChangeDistance;
38  
39      /**
40       * Construct a new AbstractLaneBasedIndividualGTU.
41       * @param id String; the id of the GTU
42       * @param gtuType GTUType; the type of GTU, e.g. TruckType, CarType, BusType
43       * @param length Length; the maximum length of the GTU (parallel with driving direction)
44       * @param width Length; the maximum width of the GTU (perpendicular to driving direction)
45       * @param maximumSpeed Speed; the maximum speed of the GTU (in the driving direction)
46       * @param simulator OTSSimulatorInterface; the simulator
47       * @param network OTSNetwork; the network that the GTU is initially registered in
48       * @throws GTUException when a parameter is invalid
49       */
50      @SuppressWarnings("checkstyle:parameternumber")
51      public AbstractLaneBasedIndividualGTU(final String id, final GTUType gtuType, final Length length, final Length width,
52              final Speed maximumSpeed, final OTSSimulatorInterface simulator, final OTSNetwork network) throws GTUException
53      {
54          super(id, gtuType, simulator, network);
55          this.length = length;
56          this.width = width;
57          if (null == maximumSpeed)
58          {
59              throw new GTUException("maximumSpeed may not be null");
60          }
61          this.maximumSpeed = maximumSpeed;
62      }
63  
64      /** {@inheritDoc} */
65      @Override
66      public final Length getLength()
67      {
68          return this.length;
69      }
70  
71      /** {@inheritDoc} */
72      @Override
73      public final Length getWidth()
74      {
75          return this.width;
76      }
77  
78      /** {@inheritDoc} */
79      @Override
80      public final Speed getMaximumSpeed()
81      {
82          return this.maximumSpeed;
83      }
84  
85      /** {@inheritDoc} */
86      @Override
87      public final void setNoLaneChangeDistance(final Length distance)
88      {
89          this.noLaneChangeDistance = distance;
90      }
91  
92      /** {@inheritDoc} */
93      @Override
94      public final boolean laneChangeAllowed()
95      {
96          return this.noLaneChangeDistance == null ? true : getOdometer().gt(this.noLaneChangeDistance);
97      }
98  
99  }