Package org.opentrafficsim.road.gtu.lane.tactical.following

Class AbstractGTUFollowingModelMobil

    • Field Detail

      • TOODANGEROUS

        public static final DualAccelerationStep TOODANGEROUS
        Return value if lane change causes immediate collision.

    • Constructor Detail

      • AbstractGTUFollowingModelMobil

        public AbstractGTUFollowingModelMobil()

    • Method Detail

      • computeDualAccelerationStep

        public final DualAccelerationStep computeDualAccelerationStep​(LaneBasedGTU referenceGTU,
                                                              Collection<Headway> otherGTUs,
                                                              Length maxDistance,
                                                              Speed speedLimit)
                                                       throws GTUException
        Compute the lowest accelerations (or most severe decelerations) that would be used if a referenceGTU is present (inserted, or not removed) in a set of other GTUs.
        If any GTU in the set of otherGTUs has a null headway (indicating that the other GTU is in fact parallel to the referenceGTU), prohibitive decelerations shall be returned.
        Two AccelerationStep values are returned in a DualAccelerationStep.
        or should slow down for a crossing from accelerating to unsafe speeds.
        Specified by:
        computeDualAccelerationStep in interface GTUFollowingModelOld
        Parameters:
        referenceGTU - LaneBasedGTU; the GTU for which the accelerations are computed
        otherGTUs - Collection<Headway>; the other GTUs. A negative headway value indicates that the other GTU is a follower. NB. If the referenceGTU is contained in this Collection, it is ignored.
        maxDistance - Length; the maximum distance we can cover at the current time, e.g. as the result of a lane drop
        speedLimit - Speed; the local speed limit
        Returns:
        DualAccelerationStep; the result with the lowest accelerations (or most severe decelerations) of application of the GTU following model of the referenceGTU for each leader and follower
        Throws:
        GTUException - when the speed of the gtu cannot be determined

      • computeDualAccelerationStep

        public final DualAccelerationStep computeDualAccelerationStep​(LaneBasedGTU referenceGTU,
                                                              Collection<Headway> otherHeadways,
                                                              Length maxDistance,
                                                              Speed speedLimit,
                                                              Duration stepSize)
                                                       throws GTUException
        Compute the lowest accelerations (or most severe decelerations) that would be used if a referenceGTU is present (inserted, or not removed) in a set of other GTUs.
        If any GTU in the set of otherGTUs has a null headway (indicating that the other GTU is in fact parallel to the referenceGTU), prohibitive decelerations shall be returned.
        Two AccelerationStep values are returned in a DualAccelerationStep.
        or should slow down for a crossing from accelerating to unsafe speeds.
        Specified by:
        computeDualAccelerationStep in interface GTUFollowingModelOld
        Parameters:
        referenceGTU - LaneBasedGTU; the GTU for which the accelerations are computed
        otherHeadways - Collection<Headway>; the other GTUs. A negative headway value indicates that the other GTU is a follower. NB. If the referenceGTU is contained in this Collection, it is ignored.
        maxDistance - Length; the maximum distance we can cover at the current time, e.g. as the result of a lane drop
        speedLimit - Speed; the local speed limit
        stepSize - Duration; given step size, which can be longer or shorter than the provided step size in the algorithms.
        Returns:
        DualAccelerationStep; the result with the lowest accelerations (or most severe decelerations) of application of the GTU following model of the referenceGTU for each leader and follower
        Throws:
        GTUException - when the speed of the gtu cannot be determined

      • computeAccelerationStep

        public final AccelerationStep computeAccelerationStep​(LaneBasedGTU gtu,
                                                      Speed leaderSpeed,
                                                      Length headway,
                                                      Length maxDistance,
                                                      Speed speedLimit)
                                               throws GTUException
        Compute the acceleration that would be used to follow a leader.
        Specified by:
        computeAccelerationStep in interface GTUFollowingModelOld
        Parameters:
        gtu - LaneBasedGTU; the GTU for which acceleration is computed
        leaderSpeed - Speed; the speed of the leader
        headway - Length; the headway of the leader
        maxDistance - Length; the maximum distance we can cover at the current time, e.g. as the result of a lane drop
        speedLimit - Speed; the local speed limit
        Returns:
        AccelerationStep; the result of application of the GTU following model
        Throws:
        GTUException - when the speed of the gtu cannot be determined

      • computeAccelerationStep

        public final AccelerationStep computeAccelerationStep​(LaneBasedGTU gtu,
                                                      Speed leaderSpeed,
                                                      Length headway,
                                                      Length maxDistance,
                                                      Speed speedLimit,
                                                      Duration stepSize)
                                               throws GTUException
        Compute the acceleration that would be used to follow a leader.
        Specified by:
        computeAccelerationStep in interface GTUFollowingModelOld
        Parameters:
        gtu - LaneBasedGTU; the GTU for which acceleration is computed
        leaderSpeed - Speed; the speed of the leader
        headway - Length; the headway of the leader
        maxDistance - Length; the maximum distance we can cover at the current time, e.g. as the result of a lane drop
        speedLimit - Speed; the local speed limit
        stepSize - Duration; given step size, which can be longer or shorter than the provided step size in the algorithms.
        Returns:
        AccelerationStep; the result of application of the GTU following model
        Throws:
        GTUException - when the speed of the gtu cannot be determined

      • computeAccelerationStep

        public final AccelerationStep computeAccelerationStep​(Speed followerSpeed,
                                                      Speed leaderSpeed,
                                                      Length headway,
                                                      Speed speedLimit,
                                                      Time currentTime)
        Compute the acceleration that would be used to follow a leader.
        Specified by:
        computeAccelerationStep in interface GTUFollowingModelOld
        Parameters:
        followerSpeed - Speed; the speed of the follower at the current time
        leaderSpeed - Speed; the speed of the follower at the current time
        headway - Length; the net headway (distance between the front of the follower to the rear of the leader) at the current time, or the maximum distance we can cover at the current time, e.g. as the result of a lane drop
        speedLimit - Speed; the local speed limit
        currentTime - Time; to be used to determine the validity of the AccelerationStep
        Returns:
        Acceleration; the acceleration (or, if negative, deceleration) resulting from application of the GTU following model

      • computeAccelerationStep

        public final AccelerationStep computeAccelerationStep​(Speed followerSpeed,
                                                      Speed leaderSpeed,
                                                      Length headway,
                                                      Speed speedLimit,
                                                      Time currentTime,
                                                      Duration stepSize)
        Compute the acceleration that would be used to follow a leader.
        Specified by:
        computeAccelerationStep in interface GTUFollowingModelOld
        Parameters:
        followerSpeed - Speed; the speed of the follower at the current time
        leaderSpeed - Speed; the speed of the follower at the current time
        headway - Length; the net headway (distance between the front of the follower to the rear of the leader) at the current time, or the maximum distance we can cover at the current time, e.g. as the result of a lane drop
        speedLimit - Speed; the local speed limit
        currentTime - Time; to be used to determine the validity of the AccelerationStep
        stepSize - Duration; given step size, which can be longer or shorter than the provided step size in the algorithms.
        Returns:
        Acceleration; the acceleration (or, if negative, deceleration) resulting from application of the GTU following model

      • computeAccelerationStepWithNoLeader

        public final AccelerationStep computeAccelerationStepWithNoLeader​(LaneBasedGTU gtu,
                                                                  Length maxDistance,
                                                                  Speed speedLimit)
                                                           throws GTUException
        Compute the acceleration that would be used if the is not leader in sight.
        Specified by:
        computeAccelerationStepWithNoLeader in interface GTUFollowingModelOld
        Parameters:
        gtu - LaneBasedGTU; the GTU for which acceleration is computed
        maxDistance - Length; the maximum distance we can cover at the current time, e.g. as the result of a lane drop
        speedLimit - Speed; the local speed limit
        Returns:
        AccelerationStep; the result of application of the GTU following model
        Throws:
        GTUException - when the speed of the gtu cannot be determined

      • computeAccelerationStepWithNoLeader

        public final AccelerationStep computeAccelerationStepWithNoLeader​(LaneBasedGTU gtu,
                                                                  Length maxDistance,
                                                                  Speed speedLimit,
                                                                  Duration stepSize)
                                                           throws GTUException
        Compute the acceleration that would be used if the is not leader in sight.
        Specified by:
        computeAccelerationStepWithNoLeader in interface GTUFollowingModelOld
        Parameters:
        gtu - LaneBasedGTU; the GTU for which acceleration is computed
        maxDistance - Length; the maximum distance we can cover at the current time, e.g. as the result of a lane drop
        speedLimit - Speed; the local speed limit
        stepSize - Duration; given step size, which can be longer or shorter than the provided step size in the algorithms.
        Returns:
        AccelerationStep; the result of application of the GTU following model
        Throws:
        GTUException - when the speed of the gtu cannot be determined

      • minimumHeadway

        public final Length minimumHeadway​(Speed followerSpeed,
                                   Speed leaderSpeed,
                                   Length precision,
                                   Length maxDistance,
                                   Speed speedLimit,
                                   Speed followerMaximumSpeed)
        Compute the minimum net headway given the speed of the follower and the leader.
        At the returned headway, the follower would decelerate with it's maximum comfortable deceleration.
        Specified by:
        minimumHeadway in interface GTUFollowingModelOld
        Parameters:
        followerSpeed - Speed; speed of the follower
        leaderSpeed - Speed; speed of the leader
        precision - Length; the required precision of the result (must be > 0)
        maxDistance - Length; the maximum distance we can cover at the current time, e.g. as the result of a lane drop
        speedLimit - Speed; the local speed limit
        followerMaximumSpeed - Speed; the maximum speed that the follower can drive at
        Returns:
        Length