org.opentrafficsim.road.gtu.lane.perception.categories

Interface InfrastructurePerception

All Superinterfaces:

org.opentrafficsim.core.gtu.perception.PerceptionCategory

All Known Implementing Classes:

DirectInfrastructurePerception

public interface InfrastructurePerception
extends org.opentrafficsim.core.gtu.perception.PerceptionCategory

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.

Version:

$Revision$, $LastChangedDate$, by $Author$, initial version 14 feb. 2017

Author:

Alexander Verbraeck, Peter Knoppers, Wouter Schakel

Method Summary

Modifier and Type	Method and Description
SortedSet<RelativeLane>	getCrossSection() Returns a set of relative lanes representing the cross section.
SortedSet<InfrastructureLaneChangeInfo>	getInfrastructureLaneChangeInfo(RelativeLane lane) Returns infrastructure lane change info of a lane.
org.djunits.value.vdouble.scalar.Length	getLegalLaneChangePossibility(RelativeLane fromLane, org.opentrafficsim.core.network.LateralDirectionality lat) Returns the distance over which a lane change remains legally possible.
org.djunits.value.vdouble.scalar.Length	getPhysicalLaneChangePossibility(RelativeLane fromLane, org.opentrafficsim.core.network.LateralDirectionality lat) Returns the distance over which a lane change remains physically possible.
SpeedLimitProspect	getSpeedLimitProspect(RelativeLane lane) Returns the prospect for speed limits on a lane (dynamic speed limits may vary between lanes).
default void	updateAll()
void	updateCrossSection() Updates a set of relative lanes representing the cross section.
void	updateInfrastructureLaneChangeInfo(RelativeLane lane) Updates the infrastructural lane change info.
void	updateLegalLaneChangePossibility(RelativeLane lane, org.opentrafficsim.core.network.LateralDirectionality lat) Updates the distance over which lane changes remains legally possible.
void	updatePhysicalLaneChangePossibility(RelativeLane lane, org.opentrafficsim.core.network.LateralDirectionality lat) Updates the distance over which lane changes remains physically possible.
void	updateSpeedLimitProspect(RelativeLane lane) Updates the speed limit prospect.

Method Detail

updateInfrastructureLaneChangeInfo

void updateInfrastructureLaneChangeInfo(RelativeLane lane)
                                 throws org.opentrafficsim.core.gtu.GTUException,
                                        org.opentrafficsim.core.gtu.behavioralcharacteristics.ParameterException

Updates the infrastructural lane change info. It starts at the given lane and moves downstream over the network. Whenever a point is encountered where lane changes are required, this information is saved.

Parameters:

lane - relative lateral lane

Throws:

org.opentrafficsim.core.gtu.GTUException - if the GTU was not initialized or if the lane is not in the cross section

org.opentrafficsim.core.gtu.behavioralcharacteristics.ParameterException - if a parameter is not defined

updateSpeedLimitProspect

void updateSpeedLimitProspect(RelativeLane lane)
                       throws org.opentrafficsim.core.gtu.GTUException,
                              org.opentrafficsim.core.gtu.behavioralcharacteristics.ParameterException

Updates the speed limit prospect.

Parameters:

lane - relative lateral lane

Throws:

org.opentrafficsim.core.gtu.GTUException - if the GTU was not initialized or if the lane is not in the cross section

org.opentrafficsim.core.gtu.behavioralcharacteristics.ParameterException - if a parameter is not defined

updateLegalLaneChangePossibility

void updateLegalLaneChangePossibility(RelativeLane lane,
                                      org.opentrafficsim.core.network.LateralDirectionality lat)
                               throws org.opentrafficsim.core.gtu.GTUException,
                                      org.opentrafficsim.core.gtu.behavioralcharacteristics.ParameterException

Updates the distance over which lane changes remains legally possible.

Parameters:

lane - lane from which the lane change possibility is requested

lat - LEFT or RIGHT, null not allowed

Throws:

org.opentrafficsim.core.gtu.GTUException - if the GTU was not initialized or if the lane is not in the cross section

org.opentrafficsim.core.gtu.behavioralcharacteristics.ParameterException - if a parameter is not defined

updatePhysicalLaneChangePossibility

void updatePhysicalLaneChangePossibility(RelativeLane lane,
                                         org.opentrafficsim.core.network.LateralDirectionality lat)
                                  throws org.opentrafficsim.core.gtu.GTUException,
                                         org.opentrafficsim.core.gtu.behavioralcharacteristics.ParameterException

Updates the distance over which lane changes remains physically possible.

Parameters:

lane - lane from which the lane change possibility is requested

lat - LEFT or RIGHT, null not allowed

Throws:

org.opentrafficsim.core.gtu.GTUException - if the GTU was not initialized or if the lane is not in the cross section

org.opentrafficsim.core.gtu.behavioralcharacteristics.ParameterException - if a parameter is not defined

updateCrossSection

void updateCrossSection()
                 throws org.opentrafficsim.core.gtu.GTUException,
                        org.opentrafficsim.core.gtu.behavioralcharacteristics.ParameterException

Updates a set of relative lanes representing the cross section. This set consists of all lanes on the current link, and an additional lane on the left and/or right side in case of a merge that is sufficiently nearby.

Throws:

org.opentrafficsim.core.gtu.GTUException - if the GTU was not initialized

org.opentrafficsim.core.gtu.behavioralcharacteristics.ParameterException - if a parameter is not defined

getInfrastructureLaneChangeInfo

SortedSet<InfrastructureLaneChangeInfo> getInfrastructureLaneChangeInfo(RelativeLane lane)

Returns infrastructure lane change info of a lane. A set is returned as multiple points may force lane changes. Which point is considered most critical is a matter of driver interpretation and may change over time. This is shown below. Suppose vehicle A needs to take the off-ramp, and that behavior is that the minimum distance per required lane change determines how critical it is. First, 400m before the lane-drop, the off-ramp is critical. 300m downstream, the lane-drop is critical. Info is sorted by distance, closest first.

 _______
 _ _A_ _\_________
 _ _ _ _ _ _ _ _ _
 _________ _ _ ___
          \_______
     (-)        Lane-drop: 1 lane change  in 400m (400m per lane change)
     (--------) Off-ramp:  3 lane changes in 900m (300m per lane change, critical)
     
     (-)        Lane-drop: 1 lane change  in 100m (100m per lane change, critical)
     (--------) Off-ramp:  3 lane changes in 600m (200m per lane change)
 

Parameters:

lane - relative lateral lane

Returns:

infrastructure lane change info of a lane

getSpeedLimitProspect

SpeedLimitProspect getSpeedLimitProspect(RelativeLane lane)

Returns the prospect for speed limits on a lane (dynamic speed limits may vary between lanes).

Parameters:

lane - relative lateral lane

Returns:

prospect for speed limits on a lane

getLegalLaneChangePossibility

org.djunits.value.vdouble.scalar.Length getLegalLaneChangePossibility(RelativeLane fromLane,
                                                                      org.opentrafficsim.core.network.LateralDirectionality lat)

Returns the distance over which a lane change remains legally possible. Negative values indicate the distance over which a lane change is legally not possible.

Parameters:

fromLane - lane from which the lane change possibility is requested

lat - LEFT or RIGHT, null not allowed

Returns:

distance over which a lane change remains possible

Throws:

NullPointerException - if lat == null

getPhysicalLaneChangePossibility

org.djunits.value.vdouble.scalar.Length getPhysicalLaneChangePossibility(RelativeLane fromLane,
                                                                         org.opentrafficsim.core.network.LateralDirectionality lat)

Returns the distance over which a lane change remains physically possible. Negative values indicate the distance over which a lane change is physically not possible.

Parameters:

fromLane - lane from which the lane change possibility is requested

lat - LEFT or RIGHT, null not allowed

Returns:

distance over which a lane change remains possible

Throws:

NullPointerException - if lat == null

getCrossSection

SortedSet<RelativeLane> getCrossSection()

Returns a set of relative lanes representing the cross section. Lanes are sorted left to right.

Returns:

set of relative lanes representing the cross section

updateAll

default void updateAll()
                throws org.opentrafficsim.core.gtu.GTUException,
                       org.opentrafficsim.core.gtu.behavioralcharacteristics.ParameterException

Specified by:

updateAll in interface org.opentrafficsim.core.gtu.perception.PerceptionCategory

Throws:

org.opentrafficsim.core.gtu.GTUException

org.opentrafficsim.core.gtu.behavioralcharacteristics.ParameterException