org.opentrafficsim.road.gtu.lane.object

Class AbstractTrafficLight

java.lang.Object

nl.tudelft.simulation.event.EventProducer

org.opentrafficsim.core.gtu.AbstractGTU

org.opentrafficsim.road.gtu.lane.object.AbstractTrafficLight

All Implemented Interfaces:

Serializable, nl.tudelft.simulation.dsol.animation.Locatable, nl.tudelft.simulation.event.EventProducerInterface, org.opentrafficsim.core.gtu.GTU, LaneBasedGTU

Direct Known Subclasses:

LaneBlock, LaneBlockOnOff, SimpleTrafficLight

public class AbstractTrafficLight
extends org.opentrafficsim.core.gtu.AbstractGTU
implements LaneBasedGTU

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.

$LastChangedDate: 2015-07-24 02:58:59 +0200 (Fri, 24 Jul 2015) $, @version $Revision: 1147 $, by $Author: averbraeck $, initial version Jan 6, 2016

Author:

Alexander Verbraeck, Peter Knoppers

See Also:

Serialized Form

Field Summary

Fields

Modifier and Type	Field and Description
static Map<org.opentrafficsim.core.gtu.RelativePosition.TYPE,org.opentrafficsim.core.gtu.RelativePosition>	RELATIVE_POSITIONS Relative position (0,0,0).

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

listeners

Fields inherited from interface org.opentrafficsim.road.gtu.lane.LaneBasedGTU

DESTROY_EVENT, INIT_EVENT, MOVE_EVENT

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

FIRST_POSITION, LAST_POSITION

Constructor Summary

Constructors

Constructor and Description
AbstractTrafficLight(String name, Lane lane, org.djunits.value.vdouble.scalar.Length position, org.opentrafficsim.core.dsol.OTSDEVSSimulatorInterface simulator, org.opentrafficsim.core.network.OTSNetwork network)

Method Summary

Modifier and Type	Method and Description
void	addTrigger(Lane lane, nl.tudelft.simulation.dsol.formalisms.eventscheduling.SimEvent<org.opentrafficsim.core.dsol.OTSSimTimeDouble> event) Add an event to the list of lane triggers scheduled for this GTU.
void	enterLane(Lane lane, org.djunits.value.vdouble.scalar.Length position, org.opentrafficsim.core.gtu.GTUDirectionality gtuDirection) insert GTU at a certain position.
double	fractionalPosition(Lane lane, org.opentrafficsim.core.gtu.RelativePosition relativePosition) Return the longitudinal position of a point relative to this GTU, relative to the center line of the Lane, as a fraction of the length of the lane.
double	fractionalPosition(Lane lane, org.opentrafficsim.core.gtu.RelativePosition relativePosition, org.djunits.value.vdouble.scalar.Time when) Return the longitudinal position of a point relative to this GTU, relative to the center line of the Lane, as a fraction of the length of the lane.
Map<Lane,Double>	fractionalPositions(org.opentrafficsim.core.gtu.RelativePosition relativePosition) Return the longitudinal positions of a point relative to this GTU, relative to the center line of the Lanes in which the vehicle is registered, as fractions of the length of the lane.
Map<Lane,Double>	fractionalPositions(org.opentrafficsim.core.gtu.RelativePosition relativePosition, org.djunits.value.vdouble.scalar.Time when) Return the longitudinal positions of a point relative to this GTU, relative to the center line of the Lanes in which the vehicle is registered, as fractions of the length of the lane.
org.opentrafficsim.core.gtu.behavioralcharacteristics.BehavioralCharacteristics	getBehavioralCharacteristics()
javax.media.j3d.Bounds	getBounds()
org.opentrafficsim.core.gtu.RelativePosition	getCenter()
Set<org.opentrafficsim.core.gtu.RelativePosition>	getContourPoints()
org.opentrafficsim.core.gtu.RelativePosition	getFront()
Lane	getLane()
Map<Lane,org.opentrafficsim.core.gtu.GTUDirectionality>	getLanes()
org.djunits.value.vdouble.scalar.Length	getLength()
org.djunits.value.vdouble.scalar.Speed	getMaximumSpeed()
org.djunits.value.vdouble.scalar.Length	getPositionTL()
org.opentrafficsim.core.gtu.RelativePosition	getRear()
Map<org.opentrafficsim.core.gtu.RelativePosition.TYPE,org.opentrafficsim.core.gtu.RelativePosition>	getRelativePositions()
LaneBasedStrategicalPlanner	getStrategicalPlanner()
LaneBasedTacticalPlanner	getTacticalPlanner()
org.djunits.value.vdouble.scalar.Length	getWidth()
boolean	isBlocked()
void	leaveLane(Lane lane) Unregister the GTU from a lane.
org.djunits.value.vdouble.scalar.Length	position(Lane lane, org.opentrafficsim.core.gtu.RelativePosition relativePosition) Return the longitudinal position of a point relative to this GTU, relative to the center line of the Lane at the current simulation time.
org.djunits.value.vdouble.scalar.Length	position(Lane lane, org.opentrafficsim.core.gtu.RelativePosition relativePosition, org.djunits.value.vdouble.scalar.Time when) Return the longitudinal position of a point relative to this GTU, relative to the center line of the Lane.
Map<Lane,org.djunits.value.vdouble.scalar.Length>	positions(org.opentrafficsim.core.gtu.RelativePosition relativePosition) Return the longitudinal positions of a point relative to this GTU, relative to the center line of the Lanes in which the vehicle is registered.
Map<Lane,org.djunits.value.vdouble.scalar.Length>	positions(org.opentrafficsim.core.gtu.RelativePosition relativePosition, org.djunits.value.vdouble.scalar.Time when) Return the longitudinal positions of a point relative to this GTU, relative to the center line of the Lanes in which the vehicle is registered.
org.djunits.value.vdouble.scalar.Length	projectedPosition(Lane projectionLane, org.opentrafficsim.core.gtu.RelativePosition relativePosition, org.djunits.value.vdouble.scalar.Time when) Return the longitudinal position that this GTU would have if it were to change to another Lane with a / the current CrossSectionLink.
void	setBlocked(boolean blocked)
String	toString()

Methods inherited from class org.opentrafficsim.core.gtu.AbstractGTU

destroy, getAcceleration, getGTUType, getId, getLocation, getMaximumAcceleration, getMaximumDeceleration, getOdometer, getOperationalPlan, getPerceivableContext, getReference, getSimulator, getSpeed, getTurnIndicatorStatus, init, interruptMove, isDestroyed, move, setMaximumAcceleration, setMaximumDeceleration, setTurnIndicatorStatus

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, wait, wait, wait

Methods inherited from interface org.opentrafficsim.core.gtu.GTU

destroy, getAcceleration, getGTUType, getId, getLocation, getMaximumAcceleration, getMaximumDeceleration, getOdometer, getOperationalPlan, getReference, getSimulator, getSpeed, getTurnIndicatorStatus, setTurnIndicatorStatus

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

addListener, addListener, addListener, addListener, removeListener

Field Detail

RELATIVE_POSITIONS

public static final Map<org.opentrafficsim.core.gtu.RelativePosition.TYPE,org.opentrafficsim.core.gtu.RelativePosition> RELATIVE_POSITIONS

Relative position (0,0,0).

Constructor Detail

AbstractTrafficLight

public AbstractTrafficLight(String name,
                            Lane lane,
                            org.djunits.value.vdouble.scalar.Length position,
                            org.opentrafficsim.core.dsol.OTSDEVSSimulatorInterface simulator,
                            org.opentrafficsim.core.network.OTSNetwork network)
                     throws org.opentrafficsim.core.gtu.GTUException,
                            org.opentrafficsim.core.network.NetworkException,
                            NamingException,
                            nl.tudelft.simulation.dsol.SimRuntimeException,
                            org.opentrafficsim.core.geometry.OTSGeometryException

Parameters:

name - the name or id of the traffic light

lane - The lane where the block has to be put

position - the position on the lane as a length

simulator - the simulator to avoid NullPointerExceptions

network - the network that the GTU is initially registered in

Throws:

org.opentrafficsim.core.gtu.GTUException - when GTU cannot be created.

NamingException - if an error occurs when adding the animation handler

org.opentrafficsim.core.network.NetworkException - when the GTU cannot be placed on the given lane

org.opentrafficsim.core.geometry.OTSGeometryException - x

nl.tudelft.simulation.dsol.SimRuntimeException - x

Method Detail

setBlocked

public final void setBlocked(boolean blocked)

Parameters:

blocked - set blocked

isBlocked

public final boolean isBlocked()

Returns:

blocked

getLane

public final Lane getLane()

Returns:

lane

getPositionTL

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

Returns:

positionTL

getLength

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

Specified by:

getLength in interface org.opentrafficsim.core.gtu.GTU

getWidth

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

Specified by:

getWidth in interface org.opentrafficsim.core.gtu.GTU

getMaximumSpeed

public final org.djunits.value.vdouble.scalar.Speed getMaximumSpeed()

Specified by:

getMaximumSpeed in interface org.opentrafficsim.core.gtu.GTU

getFront

public final org.opentrafficsim.core.gtu.RelativePosition getFront()

Specified by:

getFront in interface org.opentrafficsim.core.gtu.GTU

getRear

public final org.opentrafficsim.core.gtu.RelativePosition getRear()

Specified by:

getRear in interface org.opentrafficsim.core.gtu.GTU

getCenter

public final org.opentrafficsim.core.gtu.RelativePosition getCenter()

Specified by:

getCenter in interface org.opentrafficsim.core.gtu.GTU

getRelativePositions

public final Map<org.opentrafficsim.core.gtu.RelativePosition.TYPE,org.opentrafficsim.core.gtu.RelativePosition> getRelativePositions()

Specified by:

getRelativePositions in interface org.opentrafficsim.core.gtu.GTU

getBounds

public final javax.media.j3d.Bounds getBounds()

Specified by:

getBounds in interface nl.tudelft.simulation.dsol.animation.Locatable

Specified by:

getBounds in interface org.opentrafficsim.core.gtu.GTU

getBehavioralCharacteristics

public final org.opentrafficsim.core.gtu.behavioralcharacteristics.BehavioralCharacteristics getBehavioralCharacteristics()

Specified by:

getBehavioralCharacteristics in interface org.opentrafficsim.core.gtu.GTU

getLanes

public final Map<Lane,org.opentrafficsim.core.gtu.GTUDirectionality> getLanes()

Specified by:

getLanes in interface LaneBasedGTU

Returns:

a safe copy of the lanes on which the GTU is registered.

enterLane

public void enterLane(Lane lane,
                      org.djunits.value.vdouble.scalar.Length position,
                      org.opentrafficsim.core.gtu.GTUDirectionality gtuDirection)
               throws org.opentrafficsim.core.gtu.GTUException

insert GTU at a certain position. This can happen at setup (first initialization), and after a lane change of the GTU. The relative position that will be registered is the referencePosition (dx, dy, dz) = (0, 0, 0). Front and rear positions are relative towards this position.

Specified by:

enterLane in interface LaneBasedGTU

Parameters:

lane - the lane to add to the list of lanes on which the GTU is registered.

position - the position on the lane.

gtuDirection - the direction of the GTU on the lane (which can be bidirectional). If the GTU has a positive speed, it is moving in this direction.

Throws:

org.opentrafficsim.core.gtu.GTUException - when positioning the GTU on the lane causes a problem

leaveLane

public void leaveLane(Lane lane)

Unregister the GTU from a lane.

Specified by:

leaveLane in interface LaneBasedGTU

Parameters:

lane - the lane to remove from the list of lanes on which the GTU is registered.

positions

public final Map<Lane,org.djunits.value.vdouble.scalar.Length> positions(org.opentrafficsim.core.gtu.RelativePosition relativePosition)
                                                                  throws org.opentrafficsim.core.gtu.GTUException

Return the longitudinal positions of a point relative to this GTU, relative to the center line of the Lanes in which the vehicle is registered.
Note: If a GTU is registered in multiple parallel lanes, the lateralLaneChangeModel is used to determine the center line of the vehicle at this point in time. Otherwise, the average of the center positions of the lines will be taken.

Specified by:

positions in interface LaneBasedGTU

Parameters:

relativePosition - the position on the vehicle relative to the reference point.

Returns:

the lanes and the position on the lanes where the GTU is currently registered, for the given position of the GTU.

Throws:

org.opentrafficsim.core.gtu.GTUException - when the vehicle is not on one of the lanes on which it is registered.

positions

public final Map<Lane,org.djunits.value.vdouble.scalar.Length> positions(org.opentrafficsim.core.gtu.RelativePosition relativePosition,
                                                                         org.djunits.value.vdouble.scalar.Time when)
                                                                  throws org.opentrafficsim.core.gtu.GTUException

Return the longitudinal positions of a point relative to this GTU, relative to the center line of the Lanes in which the vehicle is registered.

Specified by:

positions in interface LaneBasedGTU

Parameters:

relativePosition - the position on the vehicle relative to the reference point.

when - the future time for which to calculate the positions.

Returns:

the lanes and the position on the lanes where the GTU will be registered at the time, for the given position of the GTU.

Throws:

org.opentrafficsim.core.gtu.GTUException - when the vehicle is not on one of the lanes on which it is registered.

position

public final org.djunits.value.vdouble.scalar.Length position(Lane lane,
                                                              org.opentrafficsim.core.gtu.RelativePosition relativePosition)
                                                       throws org.opentrafficsim.core.gtu.GTUException

Return the longitudinal position of a point relative to this GTU, relative to the center line of the Lane at the current simulation time.

Specified by:

position in interface LaneBasedGTU

Parameters:

lane - the position on this lane will be returned.

relativePosition - the position on the vehicle relative to the reference point.

Returns:

DoubleScalarAbs<LengthUnit>; the position, relative to the center line of the Lane.

Throws:

org.opentrafficsim.core.gtu.GTUException - when the vehicle is not on the given lane.

position

public final org.djunits.value.vdouble.scalar.Length position(Lane lane,
                                                              org.opentrafficsim.core.gtu.RelativePosition relativePosition,
                                                              org.djunits.value.vdouble.scalar.Time when)
                                                       throws org.opentrafficsim.core.gtu.GTUException

Return the longitudinal position of a point relative to this GTU, relative to the center line of the Lane.

Specified by:

position in interface LaneBasedGTU

Parameters:

lane - the position on this lane will be returned.

relativePosition - the position on the vehicle relative to the reference point.

when - the future time for which to calculate the positions.

Returns:

DoubleScalarAbs<LengthUnit>; the position, relative to the center line of the Lane.

Throws:

org.opentrafficsim.core.gtu.GTUException - when the vehicle is not on the given lane.

fractionalPositions

public final Map<Lane,Double> fractionalPositions(org.opentrafficsim.core.gtu.RelativePosition relativePosition)
                                           throws org.opentrafficsim.core.gtu.GTUException

Return the longitudinal positions of a point relative to this GTU, relative to the center line of the Lanes in which the vehicle is registered, as fractions of the length of the lane. This is important when we want to see if two vehicles are next to each other and we compare an 'inner' and 'outer' curve.

Specified by:

fractionalPositions in interface LaneBasedGTU

Parameters:

relativePosition - the position on the vehicle relative to the reference point.

Returns:

the lanes and the position on the lanes where the GTU is currently registered, for the given position of the GTU.

Throws:

org.opentrafficsim.core.gtu.GTUException - when the vehicle is not on one of the lanes on which it is registered.

fractionalPositions

public final Map<Lane,Double> fractionalPositions(org.opentrafficsim.core.gtu.RelativePosition relativePosition,
                                                  org.djunits.value.vdouble.scalar.Time when)
                                           throws org.opentrafficsim.core.gtu.GTUException

Return the longitudinal positions of a point relative to this GTU, relative to the center line of the Lanes in which the vehicle is registered, as fractions of the length of the lane. This is important when we want to see if two vehicles are next to each other and we compare an 'inner' and 'outer' curve.

Specified by:

fractionalPositions in interface LaneBasedGTU

Parameters:

relativePosition - the position on the vehicle relative to the reference point.

when - the future time for which to calculate the positions.

Returns:

the lanes and the position on the lanes where the GTU will be registered at the time, for the given position of the GTU.

Throws:

org.opentrafficsim.core.gtu.GTUException - when the vehicle is not on one of the lanes on which it is registered.

fractionalPosition

public final double fractionalPosition(Lane lane,
                                       org.opentrafficsim.core.gtu.RelativePosition relativePosition)
                                throws org.opentrafficsim.core.gtu.GTUException

Return the longitudinal position of a point relative to this GTU, relative to the center line of the Lane, as a fraction of the length of the lane. This is important when we want to see if two vehicles are next to each other and we compare an 'inner' and 'outer' curve.

Specified by:

fractionalPosition in interface LaneBasedGTU

Parameters:

lane - the position on this lane will be returned.

relativePosition - the position on the vehicle relative to the reference point.

Returns:

the fractional relative position on the lane at the given time.

Throws:

org.opentrafficsim.core.gtu.GTUException - when the vehicle is not on the given lane.

fractionalPosition

public final double fractionalPosition(Lane lane,
                                       org.opentrafficsim.core.gtu.RelativePosition relativePosition,
                                       org.djunits.value.vdouble.scalar.Time when)
                                throws org.opentrafficsim.core.gtu.GTUException

Return the longitudinal position of a point relative to this GTU, relative to the center line of the Lane, as a fraction of the length of the lane. This is important when we want to see if two vehicles are next to each other and we compare an 'inner' and 'outer' curve.

Specified by:

fractionalPosition in interface LaneBasedGTU

Parameters:

lane - the position on this lane will be returned.

relativePosition - the position on the vehicle relative to the reference point.

when - the future time for which to calculate the positions.

Returns:

the fractional relative position on the lane at the given time.

Throws:

org.opentrafficsim.core.gtu.GTUException - when the vehicle is not on the given lane.

projectedPosition

public final org.djunits.value.vdouble.scalar.Length projectedPosition(Lane projectionLane,
                                                                       org.opentrafficsim.core.gtu.RelativePosition relativePosition,
                                                                       org.djunits.value.vdouble.scalar.Time when)
                                                                throws org.opentrafficsim.core.gtu.GTUException

Return the longitudinal position that this GTU would have if it were to change to another Lane with a / the current CrossSectionLink.

Specified by:

projectedPosition in interface LaneBasedGTU

Parameters:

projectionLane - Lane; the lane onto which the position of this GTU must be projected

relativePosition - RelativePosition; the point on this GTU that must be projected

when - Time; the time for which to project the position of this GTU

Returns:

Length; the position of this GTU in the projectionLane

Throws:

org.opentrafficsim.core.gtu.GTUException - when projectionLane it not in any of the CrossSectionLink that the GTU is on

getStrategicalPlanner

public final LaneBasedStrategicalPlanner getStrategicalPlanner()

Specified by:

getStrategicalPlanner in interface org.opentrafficsim.core.gtu.GTU

Specified by:

getStrategicalPlanner in interface LaneBasedGTU

Overrides:

getStrategicalPlanner in class org.opentrafficsim.core.gtu.AbstractGTU

getTacticalPlanner

public final LaneBasedTacticalPlanner getTacticalPlanner()

Specified by:

getTacticalPlanner in interface org.opentrafficsim.core.gtu.GTU

Specified by:

getTacticalPlanner in interface LaneBasedGTU

Overrides:

getTacticalPlanner in class org.opentrafficsim.core.gtu.AbstractGTU

addTrigger

public final void addTrigger(Lane lane,
                             nl.tudelft.simulation.dsol.formalisms.eventscheduling.SimEvent<org.opentrafficsim.core.dsol.OTSSimTimeDouble> event)

Add an event to the list of lane triggers scheduled for this GTU.

Specified by:

addTrigger in interface LaneBasedGTU

Parameters:

lane - Lane; the lane on which the event occurs

event - SimeEvent<OTSSimTimeDouble> the event

getContourPoints

public final Set<org.opentrafficsim.core.gtu.RelativePosition> getContourPoints()

Specified by:

getContourPoints in interface org.opentrafficsim.core.gtu.GTU

toString

public String toString()

Overrides:

toString in class Object