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-2018 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

Modifier and Type	Field and Description
static org.opentrafficsim.base.parameters.ParameterTypeAcceleration	BCRIT Maximum critical deceleration, e.g.
static org.opentrafficsim.base.parameters.ParameterTypeDuration	DT Fixed model time step.
static org.opentrafficsim.base.parameters.ParameterTypeDuration	T Current car-following headway.
static org.opentrafficsim.base.parameters.ParameterTypeDuration	TAU Headway relaxation time.
static org.opentrafficsim.base.parameters.ParameterTypeDuration	TMAX Maximum car-following headway.
static org.opentrafficsim.base.parameters.ParameterTypeDuration	TMIN Minimum car-following headway.

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

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

Method Summary

Modifier and Type	Method and Description
(package private) static boolean	acceptLaneChange(LanePerception perception, org.opentrafficsim.base.parameters.Parameters params, SpeedLimitInfo sli, CarFollowingModel cfm, double desire, org.djunits.value.vdouble.scalar.Speed ownSpeed, org.djunits.value.vdouble.scalar.Acceleration ownAcceleration, org.opentrafficsim.core.network.LateralDirectionality lat, GapAcceptance gapAcceptance) Determine whether a lane change is acceptable (gap, lane markings, etc.).
static SimpleOperationalPlan	determinePlan(LaneBasedGTU gtu, org.djunits.value.vdouble.scalar.Time startTime, CarFollowingModel carFollowingModel, LaneChange laneChange, LmrsData lmrsData, LanePerception perception, LinkedHashSet<MandatoryIncentive> mandatoryIncentives, LinkedHashSet<VoluntaryIncentive> voluntaryIncentives) Determines a simple representation of an operational plan.
static Desire	getLaneChangeDesire(org.opentrafficsim.base.parameters.Parameters parameters, LanePerception perception, CarFollowingModel carFollowingModel, LinkedHashSet<MandatoryIncentive> mandatoryIncentives, LinkedHashSet<VoluntaryIncentive> voluntaryIncentives, Map<Class<? extends Incentive>,Desire> desireMap) Determines lane change desire for the given RSU.
(package private) static void	resetDesiredHeadway(org.opentrafficsim.base.parameters.Parameters params) Resets value for T depending on level of lane change desire.
(package private) static void	setDesiredHeadway(org.opentrafficsim.base.parameters.Parameters params, 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.base.parameters.Parameters params, SpeedLimitInfo sli, CarFollowingModel cfm) Determine acceleration from car-following with desire-adjusted headway.

Methods inherited from class java.lang.Object

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

Field Detail

DT

public static final org.opentrafficsim.base.parameters.ParameterTypeDuration DT

Fixed model time step.

TMIN

public static final org.opentrafficsim.base.parameters.ParameterTypeDuration TMIN

Minimum car-following headway.

T

public static final org.opentrafficsim.base.parameters.ParameterTypeDuration T

Current car-following headway.

TMAX

public static final org.opentrafficsim.base.parameters.ParameterTypeDuration TMAX

Maximum car-following headway.

TAU

public static final org.opentrafficsim.base.parameters.ParameterTypeDuration TAU

Headway relaxation time.

BCRIT

public static final org.opentrafficsim.base.parameters.ParameterTypeAcceleration BCRIT

Maximum critical deceleration, e.g. stop/go at traffic light.

Method Detail

determinePlan

public static SimpleOperationalPlan determinePlan(LaneBasedGTU gtu,
                                                  org.djunits.value.vdouble.scalar.Time startTime,
                                                  CarFollowingModel carFollowingModel,
                                                  LaneChange laneChange,
                                                  LmrsData lmrsData,
                                                  LanePerception perception,
                                                  LinkedHashSet<MandatoryIncentive> mandatoryIncentives,
                                                  LinkedHashSet<VoluntaryIncentive> voluntaryIncentives)
                                           throws org.opentrafficsim.core.gtu.GTUException,
                                                  org.opentrafficsim.core.network.NetworkException,
                                                  org.opentrafficsim.base.parameters.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

Returns:

simple operational plan

Throws:

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

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

org.opentrafficsim.base.parameters.ParameterException - parameter exception

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

getLaneChangeDesire

public static Desire getLaneChangeDesire(org.opentrafficsim.base.parameters.Parameters parameters,
                                         LanePerception perception,
                                         CarFollowingModel carFollowingModel,
                                         LinkedHashSet<MandatoryIncentive> mandatoryIncentives,
                                         LinkedHashSet<VoluntaryIncentive> voluntaryIncentives,
                                         Map<Class<? extends Incentive>,Desire> desireMap)
                                  throws org.opentrafficsim.base.parameters.ParameterException,
                                         org.opentrafficsim.core.gtu.GTUException,
                                         org.opentrafficsim.core.gtu.plan.operational.OperationalPlanException

Determines lane change desire for the given RSU. Mandatory desire is deduced as the maximum of a set of mandatory incentives, while voluntary desires are added. Depending on the level of mandatory lane change desire, voluntary desire may be included partially. If both are positive or negative, voluntary desire is fully included. Otherwise, voluntary desire is less considered within the range dSync < |mandatory| < dCoop. The absolute value is used as large negative mandatory desire may also dominate voluntary desire.

Parameters:

parameters - parameters

perception - perception

carFollowingModel - car-following model

mandatoryIncentives - mandatory incentives

voluntaryIncentives - voluntary incentives

desireMap - map where calculated desires are stored in

Returns:

lane change desire for gtu

Throws:

org.opentrafficsim.base.parameters.ParameterException - if a parameter is not defined

org.opentrafficsim.core.gtu.GTUException - if there is no mandatory incentive, the model requires at least one

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

acceptLaneChange

static boolean acceptLaneChange(LanePerception perception,
                                org.opentrafficsim.base.parameters.Parameters params,
                                SpeedLimitInfo sli,
                                CarFollowingModel cfm,
                                double desire,
                                org.djunits.value.vdouble.scalar.Speed ownSpeed,
                                org.djunits.value.vdouble.scalar.Acceleration ownAcceleration,
                                org.opentrafficsim.core.network.LateralDirectionality lat,
                                GapAcceptance gapAcceptance)
                         throws org.opentrafficsim.base.parameters.ParameterException,
                                org.opentrafficsim.core.gtu.plan.operational.OperationalPlanException

Determine whether a lane change is acceptable (gap, lane markings, etc.).

Parameters:

perception - perception

params - parameters

sli - speed limit info

cfm - car-following model

desire - level of lane change desire

ownSpeed - own speed

ownAcceleration - current car-following acceleration

lat - lateral direction for synchronization

gapAcceptance - gap-acceptance model

Returns:

whether a gap is acceptable

Throws:

org.opentrafficsim.base.parameters.ParameterException - if a parameter is not defined

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

setDesiredHeadway

static void setDesiredHeadway(org.opentrafficsim.base.parameters.Parameters params,
                              double desire)
                       throws org.opentrafficsim.base.parameters.ParameterException

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

Parameters:

params - parameters

desire - lane change desire

Throws:

org.opentrafficsim.base.parameters.ParameterException - if T, TMIN or TMAX is not in the parameters

resetDesiredHeadway

static void resetDesiredHeadway(org.opentrafficsim.base.parameters.Parameters params)
                         throws org.opentrafficsim.base.parameters.ParameterException

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

Parameters:

params - parameters

Throws:

org.opentrafficsim.base.parameters.ParameterException - if T is not in the parameters

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.base.parameters.Parameters params,
                                                                               SpeedLimitInfo sli,
                                                                               CarFollowingModel cfm)
                                                                        throws org.opentrafficsim.base.parameters.ParameterException

Determine acceleration from car-following with desire-adjusted headway.

Parameters:

distance - distance from follower to leader

followerSpeed - speed of follower

leaderSpeed - speed of leader

desire - level of lane change desire

params - parameters

sli - speed limit info

cfm - car-following model

Returns:

acceleration from car-following

Throws:

org.opentrafficsim.base.parameters.ParameterException - if a parameter is not defined