org.opentrafficsim.road.network.lane.changing

Class OvertakingConditions.LeftSetRightSpeed

java.lang.Object

org.opentrafficsim.road.network.lane.changing.OvertakingConditions.LeftSetRightSpeed

All Implemented Interfaces:

OvertakingConditions

Enclosing interface:

OvertakingConditions

public static class OvertakingConditions.LeftSetRightSpeed
extends Object
implements OvertakingConditions

Provide a collection of GTUs that can overtake another collection of GTUs on the left side, but not vice versa. Example: {CAR, TRUCK, BUS} can overtake {BICYCLE, SCOOTER}, or {CAR, TRUCK, BUS} can overtake {CAR, TRUCK, BUS, BICYCLE, SCOOTER}. In the latter case, cars, trucks and busses can overtake all other GTUs, but bicycles and scooters cannot overtake cars, trucks or busses. Another example is a lane where cars and motors can overtake all other road users, but trucks are not allowed to overtake. In that case, we would allow {CAR, MOTOR} to overtake {ALL} or {CAR, MOTOR} to overtake {CAR, MOTOR, TRUCK} in that lane. In addition, overtaking on the other side is allowed under a given driving speed.

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

Author:

Alexander Verbraeck

Nested Class Summary

Nested classes/interfaces inherited from interface org.opentrafficsim.road.network.lane.changing.OvertakingConditions

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

Constructor Summary

Constructors

Constructor and Description
LeftSetRightSpeed(Collection<org.opentrafficsim.core.gtu.GTUType> overtakingGTUs, Collection<org.opentrafficsim.core.gtu.GTUType> overtakenGTUs, org.djunits.value.vdouble.scalar.Speed rightOvertakingSpeedMax) Provide a collection of GTUs that can overtake another collection of GTUs on the left, but not vice versa.

Method Summary

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

Methods inherited from class java.lang.Object

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

Constructor Detail

LeftSetRightSpeed

public LeftSetRightSpeed(Collection<org.opentrafficsim.core.gtu.GTUType> overtakingGTUs,
                         Collection<org.opentrafficsim.core.gtu.GTUType> overtakenGTUs,
                         org.djunits.value.vdouble.scalar.Speed rightOvertakingSpeedMax)

Provide a collection of GTUs that can overtake another collection of GTUs on the left, but not vice versa. Example: {CAR, TRUCK, BUS} can overtake {BICYCLE, SCOOTER}, or {CAR, TRUCK, BUS} can overtake {CAR, TRUCK, BUS, BICYCLE, SCOOTER}, or {CAR, TRUCK, BUS} can overtake {TRACTOR}. In addition, overtaking on the other side is allowed under a given driving speed.

Parameters:

overtakingGTUs - the GTUs that can overtake a set of other GTUs, e.g., CAR, TRUCK. If overtakingGTUs contains GTUType.ALL, all GTUs can overtake.

overtakenGTUs - the GTUs that can be overtaken, e.g., BICYCLE, SCOOTER. If overtakenGTUs contains GTUType.ALL, all GTUs can be overtaken.

rightOvertakingSpeedMax - the speed under which overtaking on the "wrong" side is allowed

Method Detail

checkOvertaking

public final 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)?

Specified by:

checkOvertaking in interface OvertakingConditions

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