org.opentrafficsim.road.network.lane.object.sensor

Class TrafficLightSensor

java.lang.Object

nl.tudelft.simulation.event.EventProducer

org.opentrafficsim.road.network.lane.object.sensor.TrafficLightSensor

All Implemented Interfaces:

Serializable, EventListener, Locatable, nl.tudelft.simulation.event.EventListenerInterface, nl.tudelft.simulation.event.EventProducerInterface, NonDirectionalOccupancySensor, Sensor

public class TrafficLightSensor
extends nl.tudelft.simulation.event.EventProducer
implements nl.tudelft.simulation.event.EventListenerInterface, NonDirectionalOccupancySensor, nl.tudelft.simulation.event.EventProducerInterface, Locatable, Sensor

This traffic light sensor reports whether it whether any GTUs are within its area. The area is a sub-section of a Lane. This traffic sensor does not report the total number of GTUs within the area; only whether that number is zero or non-zero.

Copyright (c) 2013-2016 Delft University of Technology, PO Box 5, 2600 AA, Delft, the Netherlands. All rights reserved.
BSD-style license. See OpenTrafficSim License.

Version:

$Revision$, $LastChangedDate$, by $Author$, initial version Oct 27, 2016

Author:

Alexander Verbraeck, Peter Knoppers, Wouter Schakel

See Also:

Serialized Form

Field Summary

Fields inherited from class nl.tudelft.simulation.event.EventProducer

listeners

Fields inherited from interface org.opentrafficsim.road.network.lane.object.sensor.NonDirectionalOccupancySensor

NON_DIRECTIONAL_OCCUPANCY_SENSOR_TRIGGER_ENTRY_EVENT, NON_DIRECTIONAL_OCCUPANCY_SENSOR_TRIGGER_EXIT_EVENT

Fields inherited from interface nl.tudelft.simulation.event.EventProducerInterface

FIRST_POSITION, LAST_POSITION

Constructor Summary

Constructors

Constructor and Description

TrafficLightSensor(String id, Lane laneA, org.djunits.value.vdouble.scalar.Length positionA, Lane laneB, org.djunits.value.vdouble.scalar.Length positionB, List<Lane> intermediateLanes, org.opentrafficsim.core.gtu.RelativePosition.TYPE entryPosition, org.opentrafficsim.core.gtu.RelativePosition.TYPE exitPosition, org.opentrafficsim.core.dsol.OTSDEVSSimulatorInterface simulator) Construct a new traffic light sensor. TODO Possibly provide the GTUTypes that trigger the sensor as an argument for the constructor

Method Summary

Modifier and Type	Method and Description
protected void	addGTU(LaneBasedGTU gtu) Add a GTU to the set.
Bounds	getBounds()
String	getId()
org.djunits.value.vdouble.scalar.Length	getLanePositionA() Return the A position of this NonDirectionalOccupancySensor.
org.djunits.value.vdouble.scalar.Length	getLanePositionB() Return the B position of this NonDirectionalOccupancySensor.
DirectedPoint	getLocation()
boolean	getOccupancy() Return the state of this traffic light sensor.
org.opentrafficsim.core.geometry.OTSLine3D	getPath() Return the path of this traffic light sensor.
org.opentrafficsim.core.gtu.RelativePosition.TYPE	getPositionTypeEntry()
org.opentrafficsim.core.gtu.RelativePosition.TYPE	getPositionTypeExit()
org.opentrafficsim.core.dsol.OTSDEVSSimulatorInterface	getSimulator()
void	notify(nl.tudelft.simulation.event.EventInterface event)
protected void	removeGTU(LaneBasedGTU gtu) Remove a GTU from the set.
(package private) void	signalDetection(FlankSensor sensor, LaneBasedGTU gtu) One of our flank sensors has triggered.

Methods inherited from class nl.tudelft.simulation.event.EventProducer

addListener, addListener, addListener, addListener, fireEvent, fireEvent, fireEvent, fireEvent, fireEvent, fireEvent, fireEvent, fireEvent, fireEvent, fireEvent, fireTimedEvent, fireTimedEvent, fireTimedEvent, fireTimedEvent, fireTimedEvent, fireTimedEvent, fireTimedEvent, removeAllListeners, removeAllListeners, removeListener

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Methods inherited from interface nl.tudelft.simulation.event.EventProducerInterface

addListener, addListener, addListener, addListener, removeListener

Constructor Detail

TrafficLightSensor

public TrafficLightSensor(String id,
                          Lane laneA,
                          org.djunits.value.vdouble.scalar.Length positionA,
                          Lane laneB,
                          org.djunits.value.vdouble.scalar.Length positionB,
                          List<Lane> intermediateLanes,
                          org.opentrafficsim.core.gtu.RelativePosition.TYPE entryPosition,
                          org.opentrafficsim.core.gtu.RelativePosition.TYPE exitPosition,
                          org.opentrafficsim.core.dsol.OTSDEVSSimulatorInterface simulator)
                   throws org.opentrafficsim.core.network.NetworkException

Construct a new traffic light sensor.
TODO Possibly provide the GTUTypes that trigger the sensor as an argument for the constructor

Parameters:

id - String; id of this sensor

laneA - Lane; the lane of the A detection point of this traffic light sensor

positionA - Length; the position of the A detection point of this traffic light sensor

laneB - Lane; the lane of the B detection point of this traffic light sensor

positionB - Length; the position of the B detection point of this traffic light sensor

intermediateLanes - List<Lane>; list of intermediate lanes

entryPosition - RelativePosition; the position on the GTUs that trigger the entry events

exitPosition - RelativePosition; the position on the GTUs that trigger the exit events

simulator - OTSDEVSSimulatorInterface; the simulator

Throws:

org.opentrafficsim.core.network.NetworkException - when the network is inconsistent.

Method Detail

addGTU

protected final void addGTU(LaneBasedGTU gtu)

Add a GTU to the set.

Parameters:

gtu - LaneBasedGTU; the GTU that must be added

removeGTU

protected final void removeGTU(LaneBasedGTU gtu)

Remove a GTU from the set.

Parameters:

gtu - LaneBasedGTU; the GTU that must be removed

notify

public final void notify(nl.tudelft.simulation.event.EventInterface event)
                  throws RemoteException

Specified by:

notify in interface nl.tudelft.simulation.event.EventListenerInterface

Throws:

RemoteException

getPositionTypeEntry

public final org.opentrafficsim.core.gtu.RelativePosition.TYPE getPositionTypeEntry()

Specified by:

getPositionTypeEntry in interface NonDirectionalOccupancySensor

Returns:

the relative position type of the vehicle (e.g., FRONT, BACK) that triggers the sensor.

getPositionTypeExit

public final org.opentrafficsim.core.gtu.RelativePosition.TYPE getPositionTypeExit()

Specified by:

getPositionTypeExit in interface NonDirectionalOccupancySensor

Returns:

the relative position type of the vehicle (e.g., FRONT, BACK) that triggers the sensor.

getLanePositionA

public final org.djunits.value.vdouble.scalar.Length getLanePositionA()

Return the A position of this NonDirectionalOccupancySensor.

Specified by:

getLanePositionA in interface NonDirectionalOccupancySensor

Returns:

Length; the lane and position on the lane where GTU entry is detected

getLanePositionB

public final org.djunits.value.vdouble.scalar.Length getLanePositionB()

Return the B position of this NonDirectionalOccupancySensor.

Specified by:

getLanePositionB in interface NonDirectionalOccupancySensor

Returns:

Length; the lane and position on the lane where GTU exit is detected

signalDetection

final void signalDetection(FlankSensor sensor,
                           LaneBasedGTU gtu)

One of our flank sensors has triggered.

Parameters:

sensor - FlankSensor; the sensor that was triggered

gtu - LaneBasedGTU; the gtu that triggered the flank sensor

getId

public final String getId()

Specified by:

getId in interface NonDirectionalOccupancySensor

Returns:

The id of the sensor.

getSimulator

public final org.opentrafficsim.core.dsol.OTSDEVSSimulatorInterface getSimulator()

Specified by:

getSimulator in interface NonDirectionalOccupancySensor

Returns:

The simulator.

getLocation

public final DirectedPoint getLocation()
                                throws RemoteException

Specified by:

getLocation in interface Locatable

Throws:

RemoteException

getBounds

public final Bounds getBounds()
                       throws RemoteException

Specified by:

getBounds in interface Locatable

Throws:

RemoteException

getPath

public final org.opentrafficsim.core.geometry.OTSLine3D getPath()

Return the path of this traffic light sensor.

Returns:

OTSLine3D; the path of this traffic light sensor

getOccupancy

public final boolean getOccupancy()

Return the state of this traffic light sensor.

Returns:

boolean; true if one or more GTUs are currently detected; false of no GTUs are currently detected