org.opentrafficsim.road.gtu.lane.tactical

Class LaneBasedCFLCTacticalPlanner

java.lang.Object

org.opentrafficsim.road.gtu.lane.tactical.AbstractLaneBasedTacticalPlanner

org.opentrafficsim.road.gtu.lane.tactical.LaneBasedCFLCTacticalPlanner

All Implemented Interfaces:

Serializable, org.opentrafficsim.core.gtu.plan.tactical.TacticalPlanner

public class LaneBasedCFLCTacticalPlanner
extends AbstractLaneBasedTacticalPlanner

Lane-based tactical planner that implements car following and lane change behavior. This lane-based tactical planner makes decisions based on headway (GTU following model) and lane change (Lane Change model), and will generate an operational plan for the GTU. It can ask the strategic planner for assistance on the route to take when the network splits.

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-24 02:58:59 +0200 (Fri, 24 Jul 2015) $, @version $Revision: 1147 $, by $Author: averbraeck $, initial version Nov 25, 2015

Author:

Alexander Verbraeck, Peter Knoppers

See Also:

Serialized Form

Field Summary

Fields

Modifier and Type	Field and Description
static org.djunits.value.vdouble.scalar.Length.Rel	GETOFFTHISLANENOW Return value of suitability when a lane change is required right now.
static org.djunits.value.vdouble.scalar.Length.Rel	NOLANECHANGENEEDED Return value of suitability when no lane change is required within the time horizon.

Constructor Summary

Constructors

Constructor and Description
LaneBasedCFLCTacticalPlanner() Instantiated a tactical planner with GTU following and lane change behavior.

Method Summary

Modifier and Type	Method and Description
protected org.djunits.value.vdouble.scalar.Length.Rel	computeSuitabilityWithLaneChanges(Lane startLane, double remainingDistance, Map<Lane,org.djunits.value.vdouble.scalar.Length.Rel> suitabilities, int totalLanes, org.opentrafficsim.core.network.LateralDirectionality direction, org.opentrafficsim.core.gtu.GTUType gtuType) Compute the suitability of a lane from which lane changes are required to get to the next point on the Route. This method weighs the suitability of the nearest suitable lane by (m - n) / m where n is the number of lane changes required and m is the total number of lanes in the CrossSectionLink.
protected int	countCompatibleLanes(CrossSectionLink link, org.opentrafficsim.core.gtu.GTUType gtuType) Determine how many lanes on a CrossSectionLink are compatible with a particular GTU type. TODO: this method should probably be moved into the CrossSectionLink class
org.opentrafficsim.core.gtu.plan.operational.OperationalPlan	generateOperationalPlan(org.opentrafficsim.core.gtu.GTU gtu, org.djunits.value.vdouble.scalar.Time.Abs startTime, nl.tudelft.simulation.language.d3.DirectedPoint locationAtStartTime)

Methods inherited from class org.opentrafficsim.road.gtu.lane.tactical.AbstractLaneBasedTacticalPlanner

buildLaneListForwardXXX, buildLanePathInfo, buildLanePathInfo, buildLanePathInfo, buildLinkListForward, connectsToPath, determineNextSplit, getReferenceLane, noLaneDrop

Methods inherited from class java.lang.Object

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

Field Detail

NOLANECHANGENEEDED

public static final org.djunits.value.vdouble.scalar.Length.Rel NOLANECHANGENEEDED

Return value of suitability when no lane change is required within the time horizon.

GETOFFTHISLANENOW

public static final org.djunits.value.vdouble.scalar.Length.Rel GETOFFTHISLANENOW

Return value of suitability when a lane change is required right now.

Constructor Detail

LaneBasedCFLCTacticalPlanner

public LaneBasedCFLCTacticalPlanner()

Instantiated a tactical planner with GTU following and lane change behavior.

Method Detail

generateOperationalPlan

public org.opentrafficsim.core.gtu.plan.operational.OperationalPlan generateOperationalPlan(org.opentrafficsim.core.gtu.GTU gtu,
                                                                                            org.djunits.value.vdouble.scalar.Time.Abs startTime,
                                                                                            nl.tudelft.simulation.language.d3.DirectedPoint locationAtStartTime)
                                                                                     throws org.opentrafficsim.core.gtu.plan.operational.OperationalPlanException,
                                                                                            org.opentrafficsim.core.network.NetworkException,
                                                                                            org.opentrafficsim.core.gtu.GTUException

Throws:

org.opentrafficsim.core.gtu.plan.operational.OperationalPlanException

org.opentrafficsim.core.network.NetworkException

org.opentrafficsim.core.gtu.GTUException

computeSuitabilityWithLaneChanges

protected final org.djunits.value.vdouble.scalar.Length.Rel computeSuitabilityWithLaneChanges(Lane startLane,
                                                                                              double remainingDistance,
                                                                                              Map<Lane,org.djunits.value.vdouble.scalar.Length.Rel> suitabilities,
                                                                                              int totalLanes,
                                                                                              org.opentrafficsim.core.network.LateralDirectionality direction,
                                                                                              org.opentrafficsim.core.gtu.GTUType gtuType)

Compute the suitability of a lane from which lane changes are required to get to the next point on the Route.
This method weighs the suitability of the nearest suitable lane by (m - n) / m where n is the number of lane changes required and m is the total number of lanes in the CrossSectionLink.

Parameters:

startLane - Lane; the current lane of the GTU

remainingDistance - double; distance in m of GTU to first branch

suitabilities - Map<Lane, Double>; the set of suitable lanes and their suitability

totalLanes - integer; total number of lanes compatible with the GTU type

direction - LateralDirectionality; the direction of the lane changes to attempt

gtuType - GTUType; the type of the GTU

Returns:

double; the suitability of the startLane for following the Route

countCompatibleLanes

protected final int countCompatibleLanes(CrossSectionLink link,
                                         org.opentrafficsim.core.gtu.GTUType gtuType)

Determine how many lanes on a CrossSectionLink are compatible with a particular GTU type.
TODO: this method should probably be moved into the CrossSectionLink class

Parameters:

link - CrossSectionLink; the link

gtuType - GTUType; the GTU type

Returns:

integer; the number of lanes on the link that are compatible with the GTU type