org.opentrafficsim.road.gtu.generator

Class TTCRoomChecker

java.lang.Object

org.opentrafficsim.road.gtu.generator.TTCRoomChecker

All Implemented Interfaces:

LaneBasedGTUGenerator.RoomChecker

public class TTCRoomChecker
extends Object
implements LaneBasedGTUGenerator.RoomChecker

Room checker based on time-to-collision. The room is considered ok if:

1. The headway is larger than speed*1.0s + 3m
2. time-to-collision < value

where 'value' is a given value in the constructor.

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.

Version:

$Revision$, $LastChangedDate$, by $Author$, initial version 17 nov. 2016

Author:

Alexander Verbraeck, Peter Knoppers, Wouter Schakel

Constructor Summary

Constructors

Constructor and Description
TTCRoomChecker(org.djunits.value.vdouble.scalar.Duration ttc) Constructor.

Method Summary

Modifier and Type	Method and Description
org.djunits.value.vdouble.scalar.Speed	canPlace(org.djunits.value.vdouble.scalar.Speed leaderSpeed, org.djunits.value.vdouble.scalar.Length headway, LaneBasedGTUCharacteristics laneBasedGTUCharacteristics) Return the maximum safe speed for a new GTU with the specified characteristics.

Methods inherited from class java.lang.Object

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

Constructor Detail

TTCRoomChecker

public TTCRoomChecker(org.djunits.value.vdouble.scalar.Duration ttc)

Constructor.

Parameters:

ttc - time to collision

Method Detail

canPlace

public final org.djunits.value.vdouble.scalar.Speed canPlace(org.djunits.value.vdouble.scalar.Speed leaderSpeed,
                                                             org.djunits.value.vdouble.scalar.Length headway,
                                                             LaneBasedGTUCharacteristics laneBasedGTUCharacteristics)
                                                      throws org.opentrafficsim.core.network.NetworkException

Return the maximum safe speed for a new GTU with the specified characteristics. Return null if there is no safe speed. This method will never be called if the newly proposed GTU overlaps with the leader. Nor will this method be called if there is no leader.

Specified by:

canPlace in interface LaneBasedGTUGenerator.RoomChecker

Parameters:

leaderSpeed - Speed; speed of the nearest leader

headway - Length; net distance to the nearest leader (always > 0)

laneBasedGTUCharacteristics - LaneBasedGTUCharacteristics; characteristics of the proposed new GTU

Returns:

Speed; maximum safe speed, or null if a GTU with the specified characteristics cannot be placed at the current time

Throws:

org.opentrafficsim.core.network.NetworkException - this method may throw a NetworkException if it encounters an error in the network structure