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, LaneBasedTacticalPlanner

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-2017 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	GETOFFTHISLANENOW Return value of suitability when a lane change is required right now.
static org.djunits.value.vdouble.scalar.Length	NOLANECHANGENEEDED Return value of suitability when no lane change is required within the time horizon.

Constructor Summary

Constructors

Constructor and Description
LaneBasedCFLCTacticalPlanner(GTUFollowingModelOld carFollowingModel, LaneChangeModel laneChangeModel, LaneBasedGTU gtu) 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	computeSuitabilityWithLaneChanges(Lane startLane, double remainingDistance, Map<Lane,org.djunits.value.vdouble.scalar.Length> 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.djunits.value.vdouble.scalar.Time startTime, nl.tudelft.simulation.language.d3.DirectedPoint locationAtStartTime)
String	toString()

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

buildLanePathInfo, buildLanePathInfo, buildLinkListForward, buildPlanFromSimplePlan, connectsToPath, determineNextSplit, getCarFollowingModel, getGtu, getPerception, noLaneDrop, setCarFollowingModel

Methods inherited from class java.lang.Object

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

Field Detail

NOLANECHANGENEEDED

public static final org.djunits.value.vdouble.scalar.Length 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 GETOFFTHISLANENOW

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

Constructor Detail

LaneBasedCFLCTacticalPlanner

public LaneBasedCFLCTacticalPlanner(GTUFollowingModelOld carFollowingModel,
                                    LaneChangeModel laneChangeModel,
                                    LaneBasedGTU gtu)

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

Parameters:

carFollowingModel - Car-following model.

laneChangeModel - Lane change model.

gtu - GTU

Method Detail

generateOperationalPlan

public final org.opentrafficsim.core.gtu.plan.operational.OperationalPlan generateOperationalPlan(org.djunits.value.vdouble.scalar.Time 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,
                                                                                                  org.opentrafficsim.core.gtu.behavioralcharacteristics.ParameterException

Throws:

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

org.opentrafficsim.core.network.NetworkException

org.opentrafficsim.core.gtu.GTUException

org.opentrafficsim.core.gtu.behavioralcharacteristics.ParameterException

computeSuitabilityWithLaneChanges

protected final org.djunits.value.vdouble.scalar.Length computeSuitabilityWithLaneChanges(Lane startLane,
                                                                                          double remainingDistance,
                                                                                          Map<Lane,org.djunits.value.vdouble.scalar.Length> 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

toString

public final String toString()

Overrides:

toString in class Object