org.opentrafficsim.road.gtu.lane.tactical.util

Class TrafficLightUtil

java.lang.Object

org.opentrafficsim.road.gtu.lane.tactical.util.TrafficLightUtil

public final class TrafficLightUtil
extends Object

Static methods regarding traffic lights for composition in tactical planners.

Copyright (c) 2013-2016 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 May 13, 2016

Author:

Wouter Schakel

Field Summary

Fields

Modifier and Type	Field and Description
static org.opentrafficsim.core.gtu.behavioralcharacteristics.ParameterTypeAcceleration	B_YELLOW Maximum deceleration for stopping for yellow traffic light.

Method Summary

Modifier and Type	Method and Description
static org.djunits.value.vdouble.scalar.Acceleration	respondToTrafficLight(org.opentrafficsim.core.gtu.behavioralcharacteristics.BehavioralCharacteristics behavioralCharacteristics, HeadwayTrafficLight headwayTrafficLight, CarFollowingModel carFollowingModel, org.djunits.value.vdouble.scalar.Speed speed, SpeedLimitInfo speedLimitInfo) Returns an acceleration as response to a traffic light, being positive infinity if ignored.
static org.djunits.value.vdouble.scalar.Acceleration	respondToTrafficLights(org.opentrafficsim.core.gtu.behavioralcharacteristics.BehavioralCharacteristics behavioralCharacteristics, Set<HeadwayTrafficLight> headwayTrafficLights, CarFollowingModel carFollowingModel, org.djunits.value.vdouble.scalar.Speed speed, SpeedLimitInfo speedLimitInfo) Returns an acceleration as response to a set of traffic lights, being positive infinity if ignored.

Methods inherited from class java.lang.Object

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

Field Detail

B_YELLOW

public static final org.opentrafficsim.core.gtu.behavioralcharacteristics.ParameterTypeAcceleration B_YELLOW

Maximum deceleration for stopping for yellow traffic light.

Method Detail

respondToTrafficLights

public static org.djunits.value.vdouble.scalar.Acceleration respondToTrafficLights(org.opentrafficsim.core.gtu.behavioralcharacteristics.BehavioralCharacteristics behavioralCharacteristics,
                                                                                   Set<HeadwayTrafficLight> headwayTrafficLights,
                                                                                   CarFollowingModel carFollowingModel,
                                                                                   org.djunits.value.vdouble.scalar.Speed speed,
                                                                                   SpeedLimitInfo speedLimitInfo)
                                                                            throws org.opentrafficsim.core.gtu.behavioralcharacteristics.ParameterException

Returns an acceleration as response to a set of traffic lights, being positive infinity if ignored. The response is governed by the car-following model in case a traffic light is yellow or red. A constant deceleration to stop is also calculated, and the highest acceleration of both is used. If this value is below -bYellow (B_YELLOW), the traffic light is ignored, which usually occurs only during the yellow phase. By using the highest acceleration of the car-following model and the constant deceleration, it is ensured that comfortable deceleration is applied if approaching a red traffic light from far away, while strong deceleration is only applied if required and appropriately represents stopping for yellow.

Parameters:

behavioralCharacteristics - behavioral characteristics

headwayTrafficLights - set of headway traffic lights

carFollowingModel - car following model

speed - speed

speedLimitInfo - speed limit info

Returns:

acceleration as response to a traffic light, being positive infinity if ignored

Throws:

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

NullPointerException - if any input is null

IllegalArgumentException - if the traffic light is not downstream

respondToTrafficLight

public static org.djunits.value.vdouble.scalar.Acceleration respondToTrafficLight(org.opentrafficsim.core.gtu.behavioralcharacteristics.BehavioralCharacteristics behavioralCharacteristics,
                                                                                  HeadwayTrafficLight headwayTrafficLight,
                                                                                  CarFollowingModel carFollowingModel,
                                                                                  org.djunits.value.vdouble.scalar.Speed speed,
                                                                                  SpeedLimitInfo speedLimitInfo)
                                                                           throws org.opentrafficsim.core.gtu.behavioralcharacteristics.ParameterException

Returns an acceleration as response to a traffic light, being positive infinity if ignored. The response is governed by the car-following model in case the traffic light is yellow or red. A constant deceleration to stop is also calculated, and the highest acceleration of both is used. If this value is below -bYellow (B_YELLOW), the traffic light is ignored, which usually occurs only during the yellow phase. By using the highest acceleration of the car-following model and the constant deceleration, it is ensured that comfortable deceleration is applied if approaching a red traffic light from far away, while strong deceleration is only applied if required and appropriately represents stopping for yellow.

Parameters:

behavioralCharacteristics - behavioral characteristics

headwayTrafficLight - headway traffic light

carFollowingModel - car following model

speed - speed

speedLimitInfo - speed limit info

Returns:

acceleration as response to a traffic light, being positive infinity if ignored

Throws:

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

NullPointerException - if any input is null

IllegalArgumentException - if the traffic light is not downstream