Package 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-2024 Delft University of Technology, PO Box 5, 2600 AA, Delft, the Netherlands. All rights reserved.
BSD-style license. See OpenTrafficSim License.

Author:

Alexander Verbraeck, Peter Knoppers, Wouter Schakel

Field Summary

Fields

Modifier and Type	Field	Description
static final ParameterTypeAcceleration	BCRIT	Maximum critical deceleration, e.g. stop/go at traffic light.
static final ParameterTypeDuration	DT	Fixed model time step.
static final ParameterTypeDuration	T	Current car-following headway.
static final Object	T_KEY	Parameter key for T.
static final ParameterTypeDuration	TAU	Headway relaxation time.
static final ParameterTypeDuration	TMAX	Maximum car-following headway.
static final ParameterTypeDuration	TMIN	Minimum car-following headway.

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

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

Method Summary

Modifier and Type	Method	Description
static SimpleOperationalPlan	determinePlan(LaneBasedGtu gtu, CarFollowingModel carFollowingModel, LmrsData lmrsData, LanePerception perception, Iterable<MandatoryIncentive> mandatoryIncentives, Iterable<VoluntaryIncentive> voluntaryIncentives)	Determines a simple representation of an operational plan.
static Desire	getLaneChangeDesire(Parameters parameters, LanePerception perception, CarFollowingModel carFollowingModel, Iterable<MandatoryIncentive> mandatoryIncentives, Iterable<VoluntaryIncentive> voluntaryIncentives, Map<Class<? extends Incentive>,Desire> desireMap)	Determines lane change desire for the given GtU.
static Acceleration	singleAcceleration(Length distance, Speed followerSpeed, Speed leaderSpeed, double desire, 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 Details

DT

public static final ParameterTypeDuration DT

Fixed model time step.

TMIN

public static final ParameterTypeDuration TMIN

Minimum car-following headway.

T

public static final ParameterTypeDuration T

Current car-following headway.

TMAX

public static final ParameterTypeDuration TMAX

Maximum car-following headway.

TAU

public static final ParameterTypeDuration TAU

Headway relaxation time.

BCRIT

public static final ParameterTypeAcceleration BCRIT

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

T_KEY

public static final Object T_KEY

Parameter key for T. This value might e.g. be set by relaxation, its initialization, and tailgating.

Method Details

determinePlan

public static SimpleOperationalPlan determinePlan(LaneBasedGtu gtu,
 CarFollowingModel carFollowingModel,
 LmrsData lmrsData,
 LanePerception perception,
 Iterable<MandatoryIncentive> mandatoryIncentives,
 Iterable<VoluntaryIncentive> voluntaryIncentives)
                                           throws GtuException,
NetworkException,
ParameterException

Determines a simple representation of an operational plan.

Parameters:

gtu - gtu

carFollowingModel - car-following model

lmrsData - LMRS data

perception - perception

mandatoryIncentives - set of mandatory lane change incentives

voluntaryIncentives - set of voluntary lane change incentives

Returns:

simple operational plan

Throws:

GtuException - gtu exception

NetworkException - network exception

ParameterException - parameter exception

OperationalPlanException - operational plan exception

getLaneChangeDesire

public static Desire getLaneChangeDesire(Parameters parameters,
 LanePerception perception,
 CarFollowingModel carFollowingModel,
 Iterable<MandatoryIncentive> mandatoryIncentives,
 Iterable<VoluntaryIncentive> voluntaryIncentives,
 Map<Class<? extends Incentive>,Desire> desireMap)
                                  throws ParameterException,
GtuException

Determines lane change desire for the given GtU. 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:

ParameterException - if a parameter is not defined

GtuException - if there is no mandatory incentive, the model requires at least one

singleAcceleration

public static Acceleration singleAcceleration(Length distance,
 Speed followerSpeed,
 Speed leaderSpeed,
 double desire,
 Parameters params,
 SpeedLimitInfo sli,
 CarFollowingModel cfm)
                                       throws 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:

ParameterException - if a parameter is not defined