Interface DirectedLaneChangeModel

    • Method Detail

      • computeLaneChangeAndAcceleration

        DirectedLaneMovementStep computeLaneChangeAndAcceleration​(LaneBasedGTU gtu,
                                                                  LateralDirectionality direction,
                                                                  Collection<Headway> sameLaneTraffic,
                                                                  Collection<Headway> otherLaneTraffic,
                                                                  Length maxDistance,
                                                                  Speed speedLimit,
                                                                  Acceleration otherLaneRouteIncentive,
                                                                  Acceleration laneChangeThreshold,
                                                                  Duration laneChangeTime)
                                                           throws GTUException,
                                                                  ParameterException,
                                                                  OperationalPlanException
        Compute the acceleration and lane change.
        Parameters:
        gtu - LaneBasedGTU; the GTU for which the acceleration and lane change is computed
        direction - LateralDirectionality; the direction of the lane we want to change to
        sameLaneTraffic - Collection<Headway>; the set of information about observable GTUs in the current lane (can not be null and may include the gtu)
        otherLaneTraffic - Collection<Headway>; the set of information about observable GTUs in the adjacent lane where GTUs should drive in the absence of other traffic (must be null if there is no such lane)
        maxDistance - Length; the maximum distance that the current GTU can drive, e.g. due to a lane drop
        speedLimit - Speed; the local speed limit
        otherLaneRouteIncentive - Acceleration; route incentive to merge to the adjacent lane where GTUs should drive in the absence of other traffic
        laneChangeThreshold - Acceleration; threshold that prevents lane changes that have very little benefit merge to overtake other traffic
        laneChangeTime - Duration; time spent to overtake
        Returns:
        LaneMovementStep; the result of the lane change and GTU following model
        Throws:
        GTUException - when the position of the GTU on the lane(s) cannot be determined
        ParameterException - in case of a parameter problem.
        OperationalPlanException - if DefaultAlexander perception category is not present
      • getPerception

        LanePerception getPerception()
        Returns:
        the perception.
      • getName

        String getName()
        Return the name of this GTU following model.
        Returns:
        String; just the name of the GTU following model
      • getLongName

        String getLongName()
        Return complete textual information about this instantiation of this GTU following model.
        Returns:
        String; the name and parameter values of the GTU following model