Package org.opentrafficsim.road.network.lane

Class Shoulder

java.lang.Object

org.djutils.event.LocalEventProducer

org.opentrafficsim.road.network.lane.CrossSectionElement

org.opentrafficsim.road.network.lane.Lane

org.opentrafficsim.road.network.lane.Shoulder

All Implemented Interfaces:

nl.tudelft.simulation.dsol.animation.Locatable, Identifiable, EventProducer, OtsShape, HierarchicallyTyped<LaneType,Lane>

public class Shoulder
extends Lane

This class is mostly the same as a Lane. But as a shoulder it can be recognized by algorithms and models to be responded to differently.

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

Author:

Wouter Schakel

Field Summary

Fields inherited from class org.opentrafficsim.road.network.lane.Lane

DETECTOR_ADD_EVENT, DETECTOR_REMOVE_EVENT, GTU_ADD_EVENT, GTU_REMOVE_EVENT, MARGIN, OBJECT_ADD_EVENT, OBJECT_REMOVE_EVENT

Fields inherited from class org.opentrafficsim.road.network.lane.CrossSectionElement

link

Fields inherited from interface org.djutils.event.EventProducer

FIRST_POSITION, LAST_POSITION

Fields inherited from interface org.opentrafficsim.base.geometry.OtsShape

DEFAULT_POLYGON_SEGMENTS, WORLD_MARGIN_LINE

Constructor Summary

Constructors

Constructor	Description
Shoulder(CrossSectionLink link, String id, CrossSectionGeometry geometry, LaneType laneType)	Constructor specifying geometry.

Method Summary

Modifier and Type	Method	Description
Optional<Lane>	getAdjacentLane(LateralDirectionality laneChangeDirection, GtuType gtuType)	Returns one adjacent lane.
Speed	getSpeedLimit(GtuType gtuType)	Get the speed limit of this lane, which can differ per GTU type.
double	getZ()	Retrieve the Z offset (used to determine what covers what when drawing).

Methods inherited from class org.opentrafficsim.road.network.lane.Lane

accessibleAdjacentLanesLegal, accessibleAdjacentLanesPhysical, addDetector, addGtu, addGtu, addLaneBasedObject, coveredDistance, equals, forceNextLanes, forcePrevLanes, fraction, fractionAtCoveredDistance, fractionSI, getDetectorMap, getDetectors, getDetectors, getDetectors, getFirstGtu, getGtu, getGtu, getGtuAhead, getGtuBehind, getGtuList, getGtuList, getHighestSpeedLimit, getLaneBasedObjectMap, getLaneBasedObjects, getLaneBasedObjects, getLastGtu, getLeft, getLowestSpeedLimit, getObjectAhead, getObjectBehind, getRight, getType, hashCode, indexOfGtu, nextLanes, numberOfGtus, numberOfGtus, position, positionSI, prevLanes, remainingDistance, removeDetector, removeGtu, removeLaneBasedObject, removeSpeedLimit, setSpeedLimit, toString

Methods inherited from class org.opentrafficsim.road.network.lane.CrossSectionElement

getAbsoluteContour, getBeginWidth, getCenterLine, getElevation, getElevation, getEndWidth, getFullId, getGrade, getGrade, getId, getLateralBoundaryPosition, getLateralBoundaryPosition, getLateralCenterPosition, getLateralCenterPosition, getLength, getLink, getLocation, getNetwork, getOffsetAtBegin, getOffsetAtEnd, getRelativeBounds, getRelativeContour, getWidth, getWidth

Methods inherited from class org.djutils.event.LocalEventProducer

getEventListenerMap

Methods inherited from class java.lang.Object

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

Methods inherited from interface org.djutils.event.EventProducer

addListener, addListener, addListener, addListener, fireEvent, fireEvent, fireEvent, fireTimedEvent, fireTimedEvent, fireTimedEvent, fireUnverifiedEvent, fireUnverifiedEvent, fireUnverifiedTimedEvent, fireUnverifiedTimedEvent, getEventTypesWithListeners, getListenerReferences, hasListeners, numberOfListeners, removeAllListeners, removeAllListeners, removeListener

Methods inherited from interface org.opentrafficsim.base.HierarchicallyTyped

isOfType

Methods inherited from interface org.opentrafficsim.base.geometry.OtsShape

contains, contains, getAbsoluteBounds, getAbsoluteContour, getDirZ, signedDistance, signedDistance

Constructor Details

Shoulder

public Shoulder(CrossSectionLink link,
 String id,
 CrossSectionGeometry geometry,
 LaneType laneType)
         throws NetworkException

Constructor specifying geometry.

Parameters:

link - link

id - the id of this lane within the link; should be unique within the link

geometry - geometry

laneType - lane type

Throws:

NetworkException - when no cross-section slice is defined

Method Details

getAdjacentLane

public Optional<Lane> getAdjacentLane(LateralDirectionality laneChangeDirection,
 GtuType gtuType)

Returns one adjacent lane.

Overrides:

getAdjacentLane in class Lane

Parameters:

laneChangeDirection - lane change direction

gtuType - GTU type.

Returns:

adjacent lane, empty if none

getZ

public double getZ()

Description copied from class: CrossSectionElement

Retrieve the Z offset (used to determine what covers what when drawing).

Specified by:

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

Overrides:

getZ in class CrossSectionElement

Returns:

the Z-offset for drawing (what's on top, what's underneath).

getSpeedLimit

public Speed getSpeedLimit(GtuType gtuType)
                    throws NetworkException

Description copied from class: Lane

Get the speed limit of this lane, which can differ per GTU type. E.g., cars might be allowed to drive 120 km/h and trucks 90 km/h.

Overrides:

getSpeedLimit in class Lane

Parameters:

gtuType - the GTU type to provide the speed limit for

Returns:

the speedLimit.

Throws:

NetworkException - on network inconsistency