org.opentrafficsim.road.network.lane

Class CrossSectionLink

java.lang.Object

nl.tudelft.simulation.event.EventProducer

org.opentrafficsim.core.network.OTSLink

org.opentrafficsim.road.network.lane.CrossSectionLink

All Implemented Interfaces:

Serializable, nl.tudelft.simulation.dsol.animation.Locatable, nl.tudelft.simulation.event.EventProducerInterface, org.opentrafficsim.core.network.Link

public class CrossSectionLink
extends org.opentrafficsim.core.network.OTSLink
implements Serializable

A CrossSectionLink is a link with lanes where GTUs can possibly switch between lanes.

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

$LastChangedDate: 2015-09-16 19:20:07 +0200 (Wed, 16 Sep 2015) $, @version $Revision: 1405 $, by $Author: averbraeck $, initial version Aug 19, 2014

Author:

Alexander Verbraeck, Peter Knoppers, Guus Tamminga

See Also:

Serialized Form

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	CrossSectionLink.Priority Priority of a link.

Field Summary

Fields

Modifier and Type	Field and Description
static nl.tudelft.simulation.event.EventType	LANE_ADD_EVENT The (regular, not timed) event type for pub/sub indicating the addition of a Lane to a CrossSectionLink.
static nl.tudelft.simulation.event.EventType	LANE_REMOVE_EVENT The (regular, not timed) event type for pub/sub indicating the removal of a Lane from a CrossSectionLink.

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

listeners

Fields inherited from interface org.opentrafficsim.core.network.Link

GTU_ADD_EVENT, GTU_REMOVE_EVENT

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

FIRST_POSITION, LAST_POSITION

Constructor Summary

Constructors

Modifier	Constructor and Description
protected	CrossSectionLink(org.opentrafficsim.core.network.Network newNetwork, org.opentrafficsim.core.dsol.OTSSimulatorInterface newSimulator, boolean animation, CrossSectionLink link) Clone a CrossSectionLink for a new network.
	CrossSectionLink(org.opentrafficsim.core.network.Network network, String id, org.opentrafficsim.core.network.Node startNode, org.opentrafficsim.core.network.Node endNode, org.opentrafficsim.core.network.LinkType linkType, org.opentrafficsim.core.geometry.OTSLine3D designLine, org.opentrafficsim.core.dsol.OTSSimulatorInterface simulator, org.opentrafficsim.core.network.LongitudinalDirectionality directionality, LaneKeepingPolicy laneKeepingPolicy) Construction of a link, with a general directionality for GTUType.ALL.
	CrossSectionLink(org.opentrafficsim.core.network.Network network, String id, org.opentrafficsim.core.network.Node startNode, org.opentrafficsim.core.network.Node endNode, org.opentrafficsim.core.network.LinkType linkType, org.opentrafficsim.core.geometry.OTSLine3D designLine, org.opentrafficsim.core.dsol.OTSSimulatorInterface simulator, Map<org.opentrafficsim.core.gtu.GTUType,org.opentrafficsim.core.network.LongitudinalDirectionality> directionalityMap, LaneKeepingPolicy laneKeepingPolicy) Construction of a cross section link.
	CrossSectionLink(org.opentrafficsim.core.network.Network network, String id, org.opentrafficsim.core.network.OTSNode startNode, org.opentrafficsim.core.network.OTSNode endNode, org.opentrafficsim.core.network.LinkType linkType, org.opentrafficsim.core.geometry.OTSLine3D designLine, org.opentrafficsim.core.dsol.OTSSimulatorInterface simulator, LaneKeepingPolicy laneKeepingPolicy) Construction of a link, on which no traffic is allowed after construction of the link.

Method Summary

Modifier and Type	Method and Description
protected void	addCrossSectionElement(CrossSectionElement cse) Add a cross section element at the end of the list.
CrossSectionLink	clone(org.opentrafficsim.core.network.Network newNetwork, org.opentrafficsim.core.dsol.OTSSimulatorInterface newSimulator, boolean animation)
CrossSectionElement	getCrossSectionElement(String id) Find a cross section element with a specified id.
List<CrossSectionElement>	getCrossSectionElementList() Retrieve a safe copy of the cross section element list.
LaneKeepingPolicy	getLaneKeepingPolicy() Retrieve the lane keeping policy.
List<Lane>	getLanes() Return a safe copy of the list of lanes of this CrossSectionLink.
CrossSectionLink.Priority	getPriority()
void	setPriority(CrossSectionLink.Priority priority)
String	toString()

Methods inherited from class org.opentrafficsim.core.network.OTSLink

addDirectionality, addGTU, equals, getBounds, getDesignLine, getDirectionality, getDirectionalityMap, getEndNode, getGTUCount, getGTUs, getId, getLength, getLinkType, getLocation, getNetwork, getSimulator, getStartNode, hashCode, removeDirectionality, removeGTU

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, finalize, getClass, notify, notifyAll, wait, wait, wait

Field Detail

LANE_ADD_EVENT

public static final nl.tudelft.simulation.event.EventType LANE_ADD_EVENT

The (regular, not timed) event type for pub/sub indicating the addition of a Lane to a CrossSectionLink.
Payload: Object[] { String networkId, String linkId, String LaneId, Lane lane, int laneNumber }
TODO work in a different way with lane numbers to align to standard lane numbering.

LANE_REMOVE_EVENT

public static final nl.tudelft.simulation.event.EventType LANE_REMOVE_EVENT

The (regular, not timed) event type for pub/sub indicating the removal of a Lane from a CrossSectionLink.
Payload: Object[] { String networkId, String linkId, String LaneId }
TODO allow for the removal of a Lane; currently this is not possible.

Constructor Detail

CrossSectionLink

public CrossSectionLink(org.opentrafficsim.core.network.Network network,
                        String id,
                        org.opentrafficsim.core.network.Node startNode,
                        org.opentrafficsim.core.network.Node endNode,
                        org.opentrafficsim.core.network.LinkType linkType,
                        org.opentrafficsim.core.geometry.OTSLine3D designLine,
                        org.opentrafficsim.core.dsol.OTSSimulatorInterface simulator,
                        Map<org.opentrafficsim.core.gtu.GTUType,org.opentrafficsim.core.network.LongitudinalDirectionality> directionalityMap,
                        LaneKeepingPolicy laneKeepingPolicy)
                 throws org.opentrafficsim.core.network.NetworkException

Construction of a cross section link.

Parameters:

network - Network; the network

id - String; the link id.

startNode - OTSNode; the start node (directional).

endNode - OTSNode; the end node (directional).

linkType - LinkType; the link type

designLine - OTSLine3D; the design line of the Link

simulator - the simulator on which events can be scheduled

directionalityMap - Map<GTUType, LongitudinalDirectionality>; the directions (FORWARD, BACKWARD, BOTH, NONE) that various GTUtypes can traverse this link

laneKeepingPolicy - LaneKeepingPolicy; the policy to generally keep left, keep right, or keep lane

Throws:

org.opentrafficsim.core.network.NetworkException - if link already exists in the network, if name of the link is not unique, or if the start node or the end node of the link are not registered in the network.

CrossSectionLink

public CrossSectionLink(org.opentrafficsim.core.network.Network network,
                        String id,
                        org.opentrafficsim.core.network.Node startNode,
                        org.opentrafficsim.core.network.Node endNode,
                        org.opentrafficsim.core.network.LinkType linkType,
                        org.opentrafficsim.core.geometry.OTSLine3D designLine,
                        org.opentrafficsim.core.dsol.OTSSimulatorInterface simulator,
                        org.opentrafficsim.core.network.LongitudinalDirectionality directionality,
                        LaneKeepingPolicy laneKeepingPolicy)
                 throws org.opentrafficsim.core.network.NetworkException

Construction of a link, with a general directionality for GTUType.ALL. Other directionalities can be added with the method addDirectionality(...) later.

Parameters:

network - Network; the network

id - String; the link id.

startNode - OTSnode; the start node (directional).

endNode - OTSNode; the end node (directional).

linkType - LinkType; the link type

designLine - OTSLine3D; the design line of the Link

simulator - the simulator on which events can be scheduled

directionality - LongitudinalDirectionality; the default directionality for all GTUs

laneKeepingPolicy - LaneKeepingPolicy; the policy to generally keep left, keep right, or keep lane

Throws:

org.opentrafficsim.core.network.NetworkException - if link already exists in the network, if name of the link is not unique, or if the start node or the end node of the link are not registered in the network.

CrossSectionLink

public CrossSectionLink(org.opentrafficsim.core.network.Network network,
                        String id,
                        org.opentrafficsim.core.network.OTSNode startNode,
                        org.opentrafficsim.core.network.OTSNode endNode,
                        org.opentrafficsim.core.network.LinkType linkType,
                        org.opentrafficsim.core.geometry.OTSLine3D designLine,
                        org.opentrafficsim.core.dsol.OTSSimulatorInterface simulator,
                        LaneKeepingPolicy laneKeepingPolicy)
                 throws org.opentrafficsim.core.network.NetworkException

Construction of a link, on which no traffic is allowed after construction of the link. Directionality for GTUTypes can be added with the method addDirectionality(...) later.

Parameters:

network - Network; the network

id - String; the link id.

startNode - OTSNode; the start node (directional).

endNode - OTSNode; the end node (directional).

linkType - LinkType; the link type

designLine - OTSLine3D; the design line of the Link

simulator - the simulator on which events can be scheduled

laneKeepingPolicy - LaneKeepingPolicy; the policy to generally keep left, keep right, or keep lane

Throws:

org.opentrafficsim.core.network.NetworkException - if link already exists in the network, if name of the link is not unique, or if the start node or the end node of the link are not registered in the network.

CrossSectionLink

protected CrossSectionLink(org.opentrafficsim.core.network.Network newNetwork,
                           org.opentrafficsim.core.dsol.OTSSimulatorInterface newSimulator,
                           boolean animation,
                           CrossSectionLink link)
                    throws org.opentrafficsim.core.network.NetworkException

Clone a CrossSectionLink for a new network.

Parameters:

newNetwork - the new network to which the clone belongs

newSimulator - the new simulator for this network

animation - whether to (re)create animation or not

link - the link to clone from

Throws:

org.opentrafficsim.core.network.NetworkException - if link already exists in the network, if name of the link is not unique, or if the start node or the end node of the link are not registered in the network.

Method Detail

addCrossSectionElement

protected final void addCrossSectionElement(CrossSectionElement cse)

Add a cross section element at the end of the list.
Note: LEFT is seen as a positive lateral direction, RIGHT as a negative lateral direction.

Parameters:

cse - CrossSectionElement; the cross section element to add.

getCrossSectionElementList

public final List<CrossSectionElement> getCrossSectionElementList()

Retrieve a safe copy of the cross section element list.

Returns:

List<CrossSectionElement>; the cross section element list.

getLaneKeepingPolicy

public final LaneKeepingPolicy getLaneKeepingPolicy()

Retrieve the lane keeping policy.

Returns:

LaneKeepingPolicy; the lane keeping policy on this CrossSectionLink

getCrossSectionElement

public final CrossSectionElement getCrossSectionElement(String id)

Find a cross section element with a specified id.

Parameters:

id - String; the id to search for

Returns:

CrossSectionElement; the cross section element with the given id, or null if not found

getLanes

public final List<Lane> getLanes()

Return a safe copy of the list of lanes of this CrossSectionLink.

Returns:

List<Lane>; the list of lanes.

getPriority

public final CrossSectionLink.Priority getPriority()

Returns:

priority.

setPriority

public final void setPriority(CrossSectionLink.Priority priority)

Parameters:

priority - set priority.

toString

public final String toString()

Overrides:

toString in class org.opentrafficsim.core.network.OTSLink

clone

public CrossSectionLink 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.network.OTSLink

Throws:

org.opentrafficsim.core.network.NetworkException