org.opentrafficsim.road.network.lane.changing

Interface OvertakingConditions

All Known Implementing Classes:

OvertakingConditions.LeftAlwaysRightSpeed, OvertakingConditions.LeftAndRight, OvertakingConditions.LeftOnly, OvertakingConditions.LeftSet, OvertakingConditions.LeftSetRightSpeed, OvertakingConditions.None, OvertakingConditions.RightAlwaysLeftSpeed, OvertakingConditions.RightOnly, OvertakingConditions.RightSet, OvertakingConditions.RightSetLeftSpeed, OvertakingConditions.SameLaneBoth, OvertakingConditions.SameLaneLeft, OvertakingConditions.SameLaneRight

public interface OvertakingConditions

This class implements the overtaking conditions. Examples are:

• Overtaking on the left is allowed for all GTU types (not likely when there are e.g., both cars and bicycles in the model).
• A GTU type CAR can overtake a GTU type TRACTOR on the left on this road, but no other types of GTUs.
• When the speed of the GTU you try to overtake is lower than 50 km/h, you can overtake on the left.
• When the speed of the GTU you try to overtake is 25 km/h less than the maximum speed of the lane on which you and the other GTU are driving, you can overtake on the left or right.
• only overtake vehicles that have a maximum speed of under 25 km/h.
• Overtaking on the left is allowed for all GTU types, but overtaking on the right is also allowed when traffic density is below a certain number
• Overtaking on the left is allowed for all GTU types, but overtaking on the right is also allowed when the distance to a traffic light is less than 200 m
• Overtaking on the left and the right is allowed for all GTUs. This can e.g. be used on an American highway where all GTUs that are allowed on the highway can indeed overtake on the right or the left.

Note: The class only checks whether it is allowed to overtake another GTU on this road, not whether it is possible or safe to do so. That has to be checked by the GTU itself based on e.g., gap acceptance.

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 Sep 13, 2015

Author:

Alexander Verbraeck

Nested Class Summary

Nested Classes

Modifier and Type	Interface and Description
static class	OvertakingConditions.LeftAlwaysRightSpeed Overtaking on the left allowed for all GTUs, and overtaking on the right allowed under a given speed.
static class	OvertakingConditions.LeftAndRight Overtaking on both sides allowed.
static class	OvertakingConditions.LeftOnly Overtaking on the left allowed for all GTUs.
static class	OvertakingConditions.LeftSet Provide a collection of GTUs that can overtake another collection of GTUs on the left side, but not vice versa.
static class	OvertakingConditions.LeftSetRightSpeed Provide a collection of GTUs that can overtake another collection of GTUs on the left side, but not vice versa.
static class	OvertakingConditions.None No overtaking allowed.
static class	OvertakingConditions.RightAlwaysLeftSpeed Overtaking on the right allowed for all GTUs, and overtaking on the left allowed under a given speed.
static class	OvertakingConditions.RightOnly Overtaking on the right allowed for all GTUs.
static class	OvertakingConditions.RightSet Provide a collection of GTUs that can overtake another collection of GTUs on the right side, but not vice versa.
static class	OvertakingConditions.RightSetLeftSpeed Provide a collection of GTUs that can overtake another collection of GTUs on the right side, but not vice versa.
static class	OvertakingConditions.SameLaneBoth Overtaking on both sides allowed for all GTUs; they stay on the same lane (e.g., pedestrians).
static class	OvertakingConditions.SameLaneLeft Overtaking on the left allowed for all GTUs; they stay on the same lane (e.g., bicycles).
static class	OvertakingConditions.SameLaneRight Overtaking on the right allowed for all GTUs; they stay on the same lane (e.g., bicycles).

Method Summary

Modifier and Type	Method and Description
OvertakingDirection	checkOvertaking(Lane lane, LaneBasedGTU gtu, LaneBasedGTU predecessorGTU) Implementation of the overtaking conditions.

Method Detail

checkOvertaking

OvertakingDirection checkOvertaking(Lane lane,
                                    LaneBasedGTU gtu,
                                    LaneBasedGTU predecessorGTU)

Implementation of the overtaking conditions. E.g., is a car allowed on this road to overtake a tractor? If so, on which side(s)?

Parameters:

lane - the lane for which to evaluate the overtaking conditions

gtu - the GTU that might overtake another GTU

predecessorGTU - the GTU in front of the GTU that might want to overtake

Returns:

an overtaking direction: LEFT, RIGHT, BOTH or NONE