org.opentrafficsim.core.network

Class LinkType

java.lang.Object

org.opentrafficsim.base.Type<T>

org.opentrafficsim.base.HierarchicalType<LinkType>

org.opentrafficsim.core.network.LinkType

All Implemented Interfaces:

Serializable, Identifiable, Compatibility<GTUType,LinkType>

public class LinkType
extends HierarchicalType<LinkType>
implements Serializable, Identifiable, Compatibility<GTUType,LinkType>

Link type to indicate compatibility with GTU types. The id of a LinkType should be unique within a simulation. This is, however, not checked or enforced, as different simulations running in the same JVM can have different compatibilitySets for LinkTypes with the same id. Therefore, uniqueness is not enforced.

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

$LastChangedDate: 2015-08-30 00:16:51 +0200 (Sun, 30 Aug 2015) $, @version $Revision: 1329 $, by $Author: averbraeck $, initial version Aug 21, 2014

Author:

Alexander Verbraeck, Peter Knoppers

See Also:

Serialized Form

Field Summary

Fields

Modifier and Type	Field and Description
static LinkType	CONNECTOR Virtual connection between nodes, e.g.
static LinkType	FREEWAY One-directional road, accessible to all road GTU types (excluding PEDESTRIAN and BICYCLE).
static LinkType	NONE The link type that does not allow any vehicles, or pedestrians.
static LinkType	RAIL_WAY Two-directional rail link.
static LinkType	ROAD Two-directional road, accessible to all road GTU types (including PEDESTRIAN).
static LinkType	WATER_WAY Two-directional water way.

Constructor Summary

Constructors

Constructor and Description
LinkType(String id, LinkType parent, GTUCompatibility<LinkType> compatibility) Create a new Link type with compatibility set.

Method Summary

Modifier and Type	Method and Description
LongitudinalDirectionality	getDirectionality(GTUType gtuType, boolean tryParentsOfGTUType) Retrieve the allowed driving directions for a GTUType.
Boolean	isCompatible(GTUType gtuType, GTUDirectionality directionality) Test if a GTUType can travel over the infrastructure.
boolean	isConnector()
boolean	isNone()
boolean	isRailWay()
boolean	isRoad()
boolean	isWaterWay()
LinkType	reverse() Returns a link type with directionality reversed.
String	toString()

Methods inherited from class org.opentrafficsim.base.HierarchicalType

commonAncestor, equals, getId, getParent, hashCode, isOfType

Methods inherited from class org.opentrafficsim.base.Type

isType

Methods inherited from class java.lang.Object

clone, finalize, getClass, notify, notifyAll, wait, wait, wait

Methods inherited from interface org.opentrafficsim.base.Identifiable

getId

Field Detail

NONE

public static final LinkType NONE

The link type that does not allow any vehicles, or pedestrians.

ROAD

public static final LinkType ROAD

Two-directional road, accessible to all road GTU types (including PEDESTRIAN).

FREEWAY

public static final LinkType FREEWAY

One-directional road, accessible to all road GTU types (excluding PEDESTRIAN and BICYCLE).

WATER_WAY

public static final LinkType WATER_WAY

Two-directional water way.

RAIL_WAY

public static final LinkType RAIL_WAY

Two-directional rail link.

CONNECTOR

public static final LinkType CONNECTOR

Virtual connection between nodes, e.g. to distribute demand.

Constructor Detail

LinkType

public LinkType(String id,
                LinkType parent,
                GTUCompatibility<LinkType> compatibility)

Create a new Link type with compatibility set.

Parameters:

id - String; the id of the lane type (may not be null)

parent - LinkType; the parent type (may be null)

compatibility - the collection of compatible GTUTypes for this LinkType; can be null (resulting in a LinkType that is inaccessible to all GTU types). This constructor makes a deep copy of the compatibility.

Method Detail

isCompatible

public Boolean isCompatible(GTUType gtuType,
                            GTUDirectionality directionality)

Test if a GTUType can travel over the infrastructure.

Specified by:

isCompatible in interface Compatibility<GTUType,LinkType>

Parameters:

gtuType - GTUType; the type of the GTU

directionality - GTUDirectionality; the direction of the GTU with respect to the design direction of the infrastructure

Returns:

boolean; true if the GTU can travel over the infrastructure in the given direction; false if the GTU can not travel over the infrastructure in the given direction; null if the decision should be made by calling isCompatible on a higher level in the infrastructure hierarchy

reverse

public final LinkType reverse()

Returns a link type with directionality reversed.

Returns:

LinkType; link type with directionality reversed

isNone

public final boolean isNone()

Returns:

whether this is NONE

isRoad

public final boolean isRoad()

Returns:

whether this is ROAD

isWaterWay

public final boolean isWaterWay()

Returns:

whether this is WATER_WAY

isRailWay

public final boolean isRailWay()

Returns:

whether this is RAIL_WAY

isConnector

public final boolean isConnector()

Returns:

whether this is CONNECTOR

toString

public String toString()

Overrides:

toString in class Object

getDirectionality

public final LongitudinalDirectionality getDirectionality(GTUType gtuType,
                                                          boolean tryParentsOfGTUType)

Retrieve the allowed driving directions for a GTUType. If there is no match for the specified GTUType in this infrastructure type, this method will recursively check the parent types of the infrastructure element until either a match is found or the root parental type of the infrastructure is reached. When the latter happens without finding a match, what happens next depends on the value of tryParentsOfGTUType.
If tryParentsOfGTUType is false, the value null is returned. If true; the parent of the GTUType is used and the search is repeated, etc. If none of the parents of the GTUType yields a result, this method returns LongitudinalDirectionality.DIR_NONE.

Specified by:

getDirectionality in interface Compatibility<GTUType,LinkType>

Parameters:

gtuType - GTUType; type of the GTU

tryParentsOfGTUType - boolean; if true; the parents of the GTUType are tried if no match was found for the given GTUType

Returns:

LongitudinalDirectionality; the driving directions for the GTUType, or LongitudinalDirectionality.DIR_NONE if neither the GTUType or any of its parents specifies a directionality