org.opentrafficsim.road.gtu.lane.tactical.util.lmrs

Class LmrsUtil

java.lang.Object

org.opentrafficsim.road.gtu.lane.tactical.util.lmrs.LmrsUtil

All Implemented Interfaces:

LmrsParameters

public final class LmrsUtil
extends Object
implements LmrsParameters

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 Jul 26, 2016

Author:

Alexander Verbraeck, Peter Knoppers, Wouter Schakel

Field Summary

Fields inherited from interface org.opentrafficsim.road.gtu.lane.tactical.util.lmrs.LmrsParameters

COURTESY, DCOOP, DFREE, DLC, DLEFT, DRIGHT, DSYNC, HIERARCHY, VGAIN

Method Summary

Modifier and Type	Method and Description
(package private) static boolean	acceptGapNeighbors(LanePerception perception, org.opentrafficsim.core.gtu.behavioralcharacteristics.BehavioralCharacteristics bc, SpeedLimitInfo sli, CarFollowingModel cfm, double desire, org.djunits.value.vdouble.scalar.Speed ownSpeed, org.opentrafficsim.core.network.LateralDirectionality lat) Determine whether a gap is acceptable.
static SimpleOperationalPlan	determinePlan(LaneBasedGTU gtu, org.djunits.value.vdouble.scalar.Time startTime, CarFollowingModel carFollowingModel, LaneOperationalPlanBuilder.LaneChange laneChange, LmrsData lmrsData, LanePerception perception, LinkedHashSet<MandatoryIncentive> mandatoryIncentives, LinkedHashSet<VoluntaryIncentive> voluntaryIncentives, Map<Class<? extends Incentive>,Desire> desireMap) Determines a simple representation of an operational plan.
(package private) static void	resetDesiredHeadway(org.opentrafficsim.core.gtu.behavioralcharacteristics.BehavioralCharacteristics bc) Resets value for T depending on level of lane change desire.
(package private) static void	setDesiredHeadway(org.opentrafficsim.core.gtu.behavioralcharacteristics.BehavioralCharacteristics bc, double desire) Sets value for T depending on level of lane change desire.
static org.djunits.value.vdouble.scalar.Acceleration	singleAcceleration(org.djunits.value.vdouble.scalar.Length distance, org.djunits.value.vdouble.scalar.Speed followerSpeed, org.djunits.value.vdouble.scalar.Speed leaderSpeed, double desire, org.opentrafficsim.core.gtu.behavioralcharacteristics.BehavioralCharacteristics bc, SpeedLimitInfo sli, CarFollowingModel cfm) Determine acceleration from car-following.

Methods inherited from class java.lang.Object

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

Method Detail

determinePlan

public static SimpleOperationalPlan determinePlan(LaneBasedGTU gtu,
                                                  org.djunits.value.vdouble.scalar.Time startTime,
                                                  CarFollowingModel carFollowingModel,
                                                  LaneOperationalPlanBuilder.LaneChange laneChange,
                                                  LmrsData lmrsData,
                                                  LanePerception perception,
                                                  LinkedHashSet<MandatoryIncentive> mandatoryIncentives,
                                                  LinkedHashSet<VoluntaryIncentive> voluntaryIncentives,
                                                  Map<Class<? extends Incentive>,Desire> desireMap)
                                           throws org.opentrafficsim.core.gtu.GTUException,
                                                  org.opentrafficsim.core.network.NetworkException,
                                                  org.opentrafficsim.core.gtu.behavioralcharacteristics.ParameterException,
                                                  org.opentrafficsim.core.gtu.plan.operational.OperationalPlanException

Determines a simple representation of an operational plan.

Parameters:

gtu - gtu

startTime - start time

carFollowingModel - car-following model

laneChange - lane change status

lmrsData - LMRS data

perception - perception

mandatoryIncentives - set of mandatory lane change incentives

voluntaryIncentives - set of voluntary lane change incentives

desireMap - map where calculated desires are stored in

Returns:

simple operational plan

Throws:

org.opentrafficsim.core.gtu.GTUException - gtu exception

org.opentrafficsim.core.network.NetworkException - network exception

org.opentrafficsim.core.gtu.behavioralcharacteristics.ParameterException - parameter exception

org.opentrafficsim.core.gtu.plan.operational.OperationalPlanException - operational plan exception

acceptGapNeighbors

static boolean acceptGapNeighbors(LanePerception perception,
                                  org.opentrafficsim.core.gtu.behavioralcharacteristics.BehavioralCharacteristics bc,
                                  SpeedLimitInfo sli,
                                  CarFollowingModel cfm,
                                  double desire,
                                  org.djunits.value.vdouble.scalar.Speed ownSpeed,
                                  org.opentrafficsim.core.network.LateralDirectionality lat)
                           throws org.opentrafficsim.core.gtu.behavioralcharacteristics.ParameterException,
                                  org.opentrafficsim.core.gtu.plan.operational.OperationalPlanException

Determine whether a gap is acceptable.

Parameters:

perception - perception

bc - behavioral characteristics

sli - speed limit info

cfm - car-following model

desire - level of lane change desire

ownSpeed - own speed

lat - lateral direction for synchronization

Returns:

whether a gap is acceptable

Throws:

org.opentrafficsim.core.gtu.behavioralcharacteristics.ParameterException - if a parameter is not defined

org.opentrafficsim.core.gtu.plan.operational.OperationalPlanException - perception exception

setDesiredHeadway

static void setDesiredHeadway(org.opentrafficsim.core.gtu.behavioralcharacteristics.BehavioralCharacteristics bc,
                              double desire)
                       throws org.opentrafficsim.core.gtu.behavioralcharacteristics.ParameterException

Sets value for T depending on level of lane change desire.

Parameters:

bc - behavioral characteristics

desire - lane change desire

Throws:

org.opentrafficsim.core.gtu.behavioralcharacteristics.ParameterException - if T, TMIN or TMAX is not in the behavioral characteristics

resetDesiredHeadway

static void resetDesiredHeadway(org.opentrafficsim.core.gtu.behavioralcharacteristics.BehavioralCharacteristics bc)
                         throws org.opentrafficsim.core.gtu.behavioralcharacteristics.ParameterException

Resets value for T depending on level of lane change desire.

Parameters:

bc - behavioral characteristics

Throws:

org.opentrafficsim.core.gtu.behavioralcharacteristics.ParameterException - if T is not in the behavioral characteristics

singleAcceleration

public static org.djunits.value.vdouble.scalar.Acceleration singleAcceleration(org.djunits.value.vdouble.scalar.Length distance,
                                                                               org.djunits.value.vdouble.scalar.Speed followerSpeed,
                                                                               org.djunits.value.vdouble.scalar.Speed leaderSpeed,
                                                                               double desire,
                                                                               org.opentrafficsim.core.gtu.behavioralcharacteristics.BehavioralCharacteristics bc,
                                                                               SpeedLimitInfo sli,
                                                                               CarFollowingModel cfm)
                                                                        throws org.opentrafficsim.core.gtu.behavioralcharacteristics.ParameterException

Determine acceleration from car-following.

Parameters:

distance - distance from follower to leader

followerSpeed - speed of follower

leaderSpeed - speed of leader

desire - level of lane change desire

bc - behavioral characteristics

sli - speed limit info

cfm - car-following model

Returns:

acceleration from car-following

Throws:

org.opentrafficsim.core.gtu.behavioralcharacteristics.ParameterException - if a parameter is not defined