1 package org.opentrafficsim.road.network.lane.object;
2
3 import javax.media.j3d.Bounds;
4
5 import org.djunits.value.vdouble.scalar.Length;
6 import org.opentrafficsim.core.geometry.OTSGeometryException;
7 import org.opentrafficsim.core.geometry.OTSLine3D;
8 import org.opentrafficsim.core.geometry.OTSPoint3D;
9 import org.opentrafficsim.core.object.ObjectInterface;
10 import org.opentrafficsim.road.network.lane.Lane;
11
12 import nl.tudelft.simulation.language.Throw;
13 import nl.tudelft.simulation.language.d3.DirectedPoint;
14
15 /**
16 * Objects that can be encountered on a Lane like conflict areas, GTUs, traffic lights, stop lines, etc.
17 * <p>
18 * Copyright (c) 2013-2016 Delft University of Technology, PO Box 5, 2600 AA, Delft, the Netherlands. All rights reserved. <br>
19 * BSD-style license. See <a href="http://opentrafficsim.org/docs/license.html">OpenTrafficSim License</a>.
20 * </p>
21 * $LastChangedDate: 2015-07-24 02:58:59 +0200 (Fri, 24 Jul 2015) $, @version $Revision: 1147 $, by $Author: averbraeck $,
22 * initial version Sep 9, 2016 <br>
23 * @author <a href="http://www.tbm.tudelft.nl/averbraeck">Alexander Verbraeck</a>
24 * @author <a href="http://www.tudelft.nl/pknoppers">Peter Knoppers</a>
25 * @author <a href="http://www.transport.citg.tudelft.nl">Wouter Schakel</a>
26 */
27 public interface LaneBasedObject extends ObjectInterface
28 {
29 /** @return The lane for which this is a sensor. */
30 Lane getLane();
31
32 /** @return the position (between 0.0 and the length of the Lane) of the sensor on the design line of the lane. */
33 Length getLongitudinalPosition();
34
35 /**
36 * Return the location without throwing a RemoteException.
37 * @return DirectedPoint; the location
38 */
39 @Override
40 DirectedPoint getLocation();
41
42 /**
43 * Return the bounds without throwing a RemoteException.
44 * @return Bounds; the (usually rectangular) bounds of the object
45 */
46 @Override
47 Bounds getBounds();
48
49 /**
50 * Make a geometry perpendicular to the center line of the lane at the given position.
51 * @param lane Lane; the lane where the sensor resides
52 * @param position Length; The length of the object in the longitudinal direction, on the center line of the lane
53 * @return a geometry perpendicular to the center line that describes the sensor
54 */
55 static OTSLine3D makeGeometry(final Lane lane, final Length position)
56 {
57 Throw.whenNull(lane, "lane is null");
58 Throw.whenNull(position, "position is null");
59 DirectedPoint sp = lane.getCenterLine().getLocationExtended(position);
60 double w45 = 0.45 * lane.getWidth(position).si;
61 double a = sp.getRotZ() + Math.PI / 2.0;
62 OTSPoint3D p1 = new OTSPoint3D(sp.x + w45 * Math.cos(a), sp.y - w45 * Math.sin(a), sp.z + 0.0001);
63 OTSPoint3D p2 = new OTSPoint3D(sp.x - w45 * Math.cos(a), sp.y + w45 * Math.sin(a), sp.z + 0.0001);
64 try
65 {
66 return new OTSLine3D(p1, p2);
67 }
68 catch (OTSGeometryException exception)
69 {
70 throw new RuntimeException(exception);
71 }
72 }
73
74 }