org.opentrafficsim.road.gtu.lane.tactical

Interface LaneBasedTacticalPlannerFactory<T extends LaneBasedTacticalPlanner>

Type Parameters:

T - class of the tactical planner generated

All Superinterfaces:

ModelComponentFactory

All Known Implementing Classes:

AbstractLaneBasedTacticalPlannerFactory, LaneBasedCFLCTacticalPlannerFactory, LaneBasedGTUFollowingDirectedChangeTacticalPlannerFactory, LaneBasedGTUFollowingTacticalPlannerFactory, LMRSFactory, ToledoFactory

public interface LaneBasedTacticalPlannerFactory<T extends LaneBasedTacticalPlanner>
extends ModelComponentFactory

A factory class is used to generate tactical planners as the tactical planner is state-full.

Copyright (c) 2013-2019 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 Jul 29, 2016

Author:

Alexander Verbraeck, Peter Knoppers, Wouter Schakel

Method Summary

Modifier and Type	Method and Description
T	create(LaneBasedGTU gtu) Creates a new tactical planner for the given GTU.
default Length	peekDesiredHeadway(GTUType gtuType, Speed speed, Parameters parameters) Peek to see the desired headway of the next GTU to be generated at the given speed.
default Speed	peekDesiredSpeed(GTUType gtuType, Speed speedLimit, Speed maxGtuSpeed, Parameters parameters) Peek to see the desired speed of the next GTU to be generated at the given location.

Methods inherited from interface org.opentrafficsim.road.gtu.lane.tactical.ModelComponentFactory

getParameters

Method Detail

create

T create(LaneBasedGTU gtu)
  throws GTUException

Creates a new tactical planner for the given GTU.

Parameters:

gtu - LaneBasedGTU; GTU

Returns:

tactical planner for the given GTU

Throws:

GTUException - if the gtu is not suitable in any way for the creation of the tactical planner

peekDesiredSpeed

default Speed peekDesiredSpeed(GTUType gtuType,
                               Speed speedLimit,
                               Speed maxGtuSpeed,
                               Parameters parameters)
                        throws GTUException

Peek to see the desired speed of the next GTU to be generated at the given location. The default implementation returns null, at which point the GTU generator will use some other speed.

Parameters:

gtuType - GTUType; GTU type

speedLimit - Speed; speed limit

maxGtuSpeed - Speed; maximum GTU speed

parameters - Parameters; parameters for the next GTU

Returns:

desired speed of the next GTU to be generated at the given location, may be null at which point the GTU generator will use some other speed

Throws:

GTUException - on any exception

peekDesiredHeadway

default Length peekDesiredHeadway(GTUType gtuType,
                                  Speed speed,
                                  Parameters parameters)
                           throws GTUException

Peek to see the desired headway of the next GTU to be generated at the given speed. The default implementation returns null, at which point the GTU generator will only generate GTU's at fixed locations.

Parameters:

gtuType - GTUType; GTU type

speed - Speed; speed the GTU might be generated at

parameters - Parameters; parameters for the next GTU

Returns:

Length; desired headway of the next GTU to be generated at the given speed, may be null at which point the GTU generator will only generate GTU's at fixed locations

Throws:

GTUException - on any exception