org.opentrafficsim.road.network.lane.object

Class AbstractLaneBasedObject

java.lang.Object

nl.tudelft.simulation.event.EventProducer

org.opentrafficsim.core.object.StaticObject

org.opentrafficsim.road.network.lane.object.AbstractLaneBasedObject

All Implemented Interfaces:

Serializable, nl.tudelft.simulation.dsol.animation.Locatable, nl.tudelft.simulation.event.EventProducerInterface, org.opentrafficsim.base.Identifyable, org.opentrafficsim.core.object.ObjectInterface, LaneBasedObject

Direct Known Subclasses:

AbstractSensor, AbstractTrafficLight, Conflict, LaneBlock

public abstract class AbstractLaneBasedObject
extends org.opentrafficsim.core.object.StaticObject
implements LaneBasedObject

An abstract implementation of the LaneBasedObject interface with the required fields being initialized and getters for those fields. All StaticObjects are EventProducers, allowing them to provide state changes to subscribers.

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 Sep 10, 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 nl.tudelft.simulation.event.EventProducerInterface

FIRST_POSITION, LAST_POSITION

Constructor Summary

Constructors

Constructor and Description
AbstractLaneBasedObject(String id, Lane lane, org.djunits.value.vdouble.scalar.Length longitudinalPosition, org.opentrafficsim.core.geometry.OTSLine3D geometry) Construct a new LaneBasedObject with the required fields.
AbstractLaneBasedObject(String id, Lane lane, org.djunits.value.vdouble.scalar.Length longitudinalPosition, org.opentrafficsim.core.geometry.OTSLine3D geometry, org.djunits.value.vdouble.scalar.Length height) Construct a new AbstractLanebasedObject with the required fields.

Method Summary

Modifier and Type	Method and Description
abstract AbstractLaneBasedObject	clone(CrossSectionElement newCSE, org.opentrafficsim.core.dsol.OTSSimulatorInterface newSimulator, boolean animation) Clone the LaneBasedObject for e.g., copying a network.
org.opentrafficsim.core.object.StaticObject	clone(org.opentrafficsim.core.network.Network newNetwork, org.opentrafficsim.core.dsol.OTSSimulatorInterface newSimulator, boolean animation)
Lane	getLane()
nl.tudelft.simulation.language.d3.DirectedPoint	getLocation() Return the location without throwing a RemoteException.
org.djunits.value.vdouble.scalar.Length	getLongitudinalPosition()

Methods inherited from class org.opentrafficsim.core.object.StaticObject

getBounds, getGeometry, getHeight, getId, toString

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.road.network.lane.object.LaneBasedObject

getBounds, makeGeometry

Methods inherited from interface org.opentrafficsim.core.object.ObjectInterface

getGeometry, getHeight

Methods inherited from interface org.opentrafficsim.base.Identifyable

getId

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

addListener, addListener, addListener, addListener, removeListener

Constructor Detail

AbstractLaneBasedObject

public AbstractLaneBasedObject(String id,
                               Lane lane,
                               org.djunits.value.vdouble.scalar.Length longitudinalPosition,
                               org.opentrafficsim.core.geometry.OTSLine3D geometry,
                               org.djunits.value.vdouble.scalar.Length height)
                        throws org.opentrafficsim.core.network.NetworkException

Construct a new AbstractLanebasedObject with the required fields.

Parameters:

id - String; the id of the new object

lane - Lane; The lane on which the new object resides. If the new object is a Sensor; it is automatically registered on the lane

longitudinalPosition - Length; The position (between 0.0 and the length of the Lane) of the sensor on the design line of the lane

geometry - OTSLine3D; the geometry of the object, which provides its location and bounds as well

height - Length; the height of the object, in case it is a 3D object

Throws:

org.opentrafficsim.core.network.NetworkException - when the position on the lane is out of bounds

AbstractLaneBasedObject

public AbstractLaneBasedObject(String id,
                               Lane lane,
                               org.djunits.value.vdouble.scalar.Length longitudinalPosition,
                               org.opentrafficsim.core.geometry.OTSLine3D geometry)
                        throws org.opentrafficsim.core.network.NetworkException

Construct a new LaneBasedObject with the required fields.

Parameters:

id - String; the id of the new AbstractLaneBasedObject

lane - Lane; The lane for which this is a sensor

longitudinalPosition - Length; The position (between 0.0 and the length of the Lane) of the sensor on the design line of the lane

geometry - OTSLine3D; the geometry of the object, which provides its location and bounds as well

Throws:

org.opentrafficsim.core.network.NetworkException - when the position on the lane is out of bounds

Method Detail

getLane

public final Lane getLane()

Specified by:

getLane in interface LaneBasedObject

Returns:

The lane for which this is a sensor.

getLongitudinalPosition

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

Specified by:

getLongitudinalPosition in interface LaneBasedObject

Returns:

the position (between 0.0 and the length of the Lane) of the sensor on the design line of the lane.

getLocation

public nl.tudelft.simulation.language.d3.DirectedPoint getLocation()

Return the location without throwing a RemoteException.

Specified by:

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

Specified by:

getLocation in interface LaneBasedObject

Overrides:

getLocation in class org.opentrafficsim.core.object.StaticObject

Returns:

DirectedPoint; the location

clone

public final org.opentrafficsim.core.object.StaticObject clone(org.opentrafficsim.core.network.Network newNetwork,
                                                               org.opentrafficsim.core.dsol.OTSSimulatorInterface newSimulator,
                                                               boolean animation)
                                                        throws org.opentrafficsim.core.network.NetworkException

Overrides:

clone in class org.opentrafficsim.core.object.StaticObject

Throws:

org.opentrafficsim.core.network.NetworkException

clone

public abstract AbstractLaneBasedObject clone(CrossSectionElement newCSE,
                                              org.opentrafficsim.core.dsol.OTSSimulatorInterface newSimulator,
                                              boolean animation)
                                       throws org.opentrafficsim.core.network.NetworkException

Clone the LaneBasedObject for e.g., copying a network.

Parameters:

newCSE - CrossSectionElement; the new cross section element to which the clone belongs

newSimulator - OTSSimulatorInterface; the new simulator for this network

animation - boolean; whether to (re)create animation or not

Returns:

AbstractLaneBasedObject; a clone of this object

Throws:

org.opentrafficsim.core.network.NetworkException - in case the cloning fails