org.opentrafficsim.road.network.route

Class RandomLaneBasedRouteNavigator

java.lang.Object

org.opentrafficsim.road.network.route.AbstractLaneBasedRouteNavigator

org.opentrafficsim.road.network.route.RandomLaneBasedRouteNavigator

All Implemented Interfaces:

Serializable, org.opentrafficsim.core.network.route.RouteNavigator, LaneBasedRouteNavigator

public class RandomLaneBasedRouteNavigator
extends AbstractLaneBasedRouteNavigator

A RouteNavigator helps to navigate on a route. In addition, helper methods are available to see if the GTU needs to change lanes to reach the next link on the route.

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

$LastChangedDate: 2015-07-16 10:20:53 +0200 (Thu, 16 Jul 2015) $, @version $Revision: 1124 $, by $Author: pknoppers $, initial version Jul 22, 2015

Author:

Alexander Verbraeck, Peter Knoppers

See Also:

Serialized Form

Field Summary

Fields

Modifier and Type	Field and Description
protected org.opentrafficsim.core.network.Node	lastVisitedNode last visited node on the route (given -- I have been there).
protected org.opentrafficsim.core.network.Link	nextNextLinkToVisit link to take after the next node to visit on the route (look ahead to choose the right lane).
protected org.opentrafficsim.core.network.Node	nextNextNodeToVisit node to take after the next node to visit on the route (look ahead to choose the right lane).
protected org.opentrafficsim.core.network.Node	nextNodeToVisit next node to visit on the route (given -- I am on this route).

Fields inherited from class org.opentrafficsim.road.network.route.AbstractLaneBasedRouteNavigator

GETOFFTHISLANENOW, NOLANECHANGENEEDED

Constructor Summary

Constructors

Constructor and Description
RandomLaneBasedRouteNavigator(org.opentrafficsim.core.network.Link generationLink) Create a navigator.

Method Summary

Modifier and Type	Method and Description
protected void	determineNextNextNode() Choose a random link out.
org.opentrafficsim.core.network.Node	lastVisitedNode()
org.opentrafficsim.core.network.Node	nextNextNodeToVisit()
org.opentrafficsim.core.network.Node	nextNodeToVisit()
org.djunits.value.vdouble.scalar.Length.Rel	suitability(Lane lane, org.djunits.value.vdouble.scalar.Length.Rel longitudinalPosition, LaneBasedGTU gtu, org.djunits.value.vdouble.scalar.Time.Rel timeHorizon) Determine the suitability of being at a particular longitudinal position in a particular Lane for following this Route.
org.opentrafficsim.core.network.Node	visitNextNode()

Methods inherited from class org.opentrafficsim.road.network.route.AbstractLaneBasedRouteNavigator

computeSuitabilityWithLaneChanges, countCompatibleLanes

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Detail

lastVisitedNode

protected org.opentrafficsim.core.network.Node lastVisitedNode

last visited node on the route (given -- I have been there).

nextNodeToVisit

protected org.opentrafficsim.core.network.Node nextNodeToVisit

next node to visit on the route (given -- I am on this route).

nextNextNodeToVisit

protected org.opentrafficsim.core.network.Node nextNextNodeToVisit

node to take after the next node to visit on the route (look ahead to choose the right lane).

nextNextLinkToVisit

protected org.opentrafficsim.core.network.Link nextNextLinkToVisit

link to take after the next node to visit on the route (look ahead to choose the right lane).

Constructor Detail

RandomLaneBasedRouteNavigator

public RandomLaneBasedRouteNavigator(org.opentrafficsim.core.network.Link generationLink)

Create a navigator.

Parameters:

generationLink - the link on which the GTU is generated

Method Detail

lastVisitedNode

public final org.opentrafficsim.core.network.Node lastVisitedNode()
                                                           throws org.opentrafficsim.core.network.NetworkException

Throws:

org.opentrafficsim.core.network.NetworkException

nextNodeToVisit

public final org.opentrafficsim.core.network.Node nextNodeToVisit()
                                                           throws org.opentrafficsim.core.network.NetworkException

Throws:

org.opentrafficsim.core.network.NetworkException

nextNextNodeToVisit

public final org.opentrafficsim.core.network.Node nextNextNodeToVisit()

Returns:

nnnode

visitNextNode

public final org.opentrafficsim.core.network.Node visitNextNode()
                                                         throws org.opentrafficsim.core.network.NetworkException

Throws:

org.opentrafficsim.core.network.NetworkException

determineNextNextNode

protected void determineNextNextNode()

Choose a random link out. Equal probabilities.

suitability

public final org.djunits.value.vdouble.scalar.Length.Rel suitability(Lane lane,
                                                                     org.djunits.value.vdouble.scalar.Length.Rel longitudinalPosition,
                                                                     LaneBasedGTU gtu,
                                                                     org.djunits.value.vdouble.scalar.Time.Rel timeHorizon)
                                                              throws org.opentrafficsim.core.network.NetworkException

Determine the suitability of being at a particular longitudinal position in a particular Lane for following this Route.

Parameters:

lane - Lane; the lane to consider

longitudinalPosition - DoubleScalar.Rel<LengthUnit>; the longitudinal position in the lane

gtu - GTU; the GTU (used to check lane compatibility of lanes, and current lane the GTU is on)

timeHorizon - DoubleScalar.Rel<TimeUnit>; the maximum time that a driver may want to look ahead

Returns:

DoubleScalar.Rel<LengthUnit>; a value that indicates within what distance the GTU should try to vacate this lane.

Throws:

org.opentrafficsim.core.network.NetworkException - on network inconsistency, or when the continuation Link at a branch cannot be determined