public abstract class AbstractLaneBasedGTU extends AbstractGTU implements LaneBasedGTU
When calculating a headway, the GTU has to look in successive lanes. When Lanes (or underlying CrossSectionLinks) diverge, the headway algorithms have to look at multiple Lanes and return the minimum headway in each of the Lanes. When the Lanes (or underlying CrossSectionLinks) converge, "parallel" traffic is not taken into account in the headway calculation. Instead, gap acceptance algorithms or their equivalent should guide the merging behavior.
To decide its movement, an AbstractLaneBasedGTU applies its car following algorithm and lane change algorithm to set the acceleration and any lane change operation to perform. It then schedules the triggers that will add it to subsequent lanes and remove it from current lanes as needed during the time step that is has committed to. Finally, it re-schedules its next movement evaluation with the simulator.
Copyright (c) 2013-2019 Delft University of Technology, PO Box 5, 2600 AA, Delft, the Netherlands. All rights reserved.
BSD-style license. See OpenTrafficSim License.
Modifier and Type | Field and Description |
---|---|
static int |
CACHED_POSITION
cached position count.
|
static boolean |
CACHING
Caching on or off.
|
static Length |
initialLocationThresholdDifference
The threshold distance for differences between initial locations of the GTU on different lanes.
|
static int |
NON_CACHED_POSITION
cached position count.
|
ALIGN_COUNT, ALIGNED, operationalPlan
listeners
LANE_CHANGE_EVENT, LANE_ENTER_EVENT, LANE_EXIT_EVENT, LANEBASED_DESTROY_EVENT, LANEBASED_INIT_EVENT, LANEBASED_MOVE_EVENT, LINK_ENTER_EVENT, LINK_EXIT_EVENT
DESTROY_EVENT, INIT_EVENT, MOVE_EVENT
FIRST_POSITION, LAST_POSITION
Constructor and Description |
---|
AbstractLaneBasedGTU(String id,
GTUType gtuType,
OTSSimulatorInterface simulator,
OTSNetwork network)
Construct a Lane Based GTU.
|
Modifier and Type | Method and Description |
---|---|
protected void |
addGtuToLane(Lane lane,
Length position)
Part of 'enterLane' which registers the GTU with the lane so the lane can report its GTUs.
|
void |
addTrigger(Lane lane,
SimEventInterface<SimTimeDoubleUnit> event)
Add an event to the list of lane triggers scheduled for this GTU.
|
void |
changeLaneInstantaneously(LateralDirectionality laneChangeDirection)
Change lanes instantaneously.
|
void |
destroy() |
void |
enterLane(Lane lane,
Length position,
GTUDirectionality gtuDirection)
insert GTU at a certain position.
|
protected void |
finalizeLaneChange(LateralDirectionality laneChangeDirection)
Performs the finalization of a lane change by leaving the from lanes.
|
double |
fractionalPosition(Lane lane,
RelativePosition relativePosition)
Return the longitudinal position of a point relative to this GTU, relative to the center line of the Lane, as a fraction
of the length of the lane.
|
double |
fractionalPosition(Lane lane,
RelativePosition relativePosition,
Time when)
Return the longitudinal position of a point relative to this GTU, relative to the center line of the Lane, as a fraction
of the length of the lane.
|
Map<Lane,Double> |
fractionalPositions(RelativePosition relativePosition)
Return the longitudinal positions of a point relative to this GTU, relative to the center line of the Lanes in which the
vehicle is registered, as fractions of the length of the lane.
|
Map<Lane,Double> |
fractionalPositions(RelativePosition relativePosition,
Time when)
Return the longitudinal positions of a point relative to this GTU, relative to the center line of the Lanes in which the
vehicle is registered, as fractions of the length of the lane.
|
javax.media.j3d.Bounds |
getBounds() |
Acceleration |
getCarFollowingAcceleration()
This method returns the current car-following acceleration of the GTU.
|
Speed |
getDesiredSpeed()
This method returns the current desired speed of the GTU.
|
GTUDirectionality |
getDirection(Lane lane)
Return the directionality of a lane on which the GTU is registered for its current operational plan.
|
DirectedLanePosition |
getReferencePosition()
Return the current Lane, position and directionality of the GTU.
|
LaneBasedStrategicalPlanner |
getStrategicalPlanner() |
LaneBasedStrategicalPlanner |
getStrategicalPlanner(Time time) |
TurnIndicatorStatus |
getTurnIndicatorStatus() |
TurnIndicatorStatus |
getTurnIndicatorStatus(Time time) |
VehicleModel |
getVehicleModel()
Returns the vehicle model.
|
void |
init(LaneBasedStrategicalPlanner strategicalPlanner,
Set<DirectedLanePosition> initialLongitudinalPositions,
Speed initialSpeed) |
void |
initLaneChange(LateralDirectionality laneChangeDirection)
Register on lanes in target lane.
|
boolean |
isSafeToChange()
Hack method.
|
void |
leaveLane(Lane lane)
Unregister the GTU from a lane.
|
void |
leaveLane(Lane lane,
boolean beingDestroyed)
Leave a lane but do not complain about having no lanes left when beingDestroyed is true.
|
protected void |
move(DirectedPoint fromLocation) |
Length |
position(Lane lane,
RelativePosition relativePosition)
Return the longitudinal position of a point relative to this GTU, relative to the center line of the Lane at the current
simulation time.
|
Length |
position(Lane lane,
RelativePosition relativePosition,
Time when)
Return the longitudinal position of a point relative to this GTU, relative to the center line of the Lane.
|
Map<Lane,Length> |
positions(RelativePosition relativePosition)
Return the longitudinal positions of a point relative to this GTU, relative to the center line of the Lanes in which the
vehicle is registered.
|
Map<Lane,Length> |
positions(RelativePosition relativePosition,
Time when)
Return the longitudinal positions of a point relative to this GTU, relative to the center line of the Lanes in which the
vehicle is registered.
|
Length |
projectedPosition(Lane projectionLane,
RelativePosition relativePosition,
Time when)
Return the longitudinal position on the projection lane that has the same fractional position on one of the current lanes
of the indicated relative position.
|
void |
reinit(Set<DirectedLanePosition> initialLongitudinalPositions)
Reinitializes the GTU on the network using the existing strategical planner and zero speed.
|
protected void |
scheduleEnterLeaveTriggers()
Schedule the triggers for this GTU that are going to happen until the next evaluation time.
|
void |
setFinalizeLaneChangeEvent(SimEventInterface<SimTimeDoubleUnit> event)
Sets event to finalize lane change.
|
void |
setParent(GTU gtu)
All lanes the GTU is on will be left.
|
void |
setTurnIndicatorStatus(TurnIndicatorStatus turnIndicatorStatus)
Set the status of the turn indicator.
|
void |
setVehicleModel(VehicleModel vehicleModel)
Sets a vehicle model.
|
String |
toString() |
Length |
translatedPosition(Lane projectionLane,
RelativePosition relativePosition,
Time when)
Return the longitudinal position that the indicated relative position of this GTU would have if it were to change to
another Lane with a / the current CrossSectionLink.
|
addGtu, equals, getAcceleration, getAcceleration, getChildren, getGTUType, getId, getLocation, getMaximumAcceleration, getMaximumDeceleration, getNextMoveEvent, getOdometer, getOdometer, getOperationalPlan, getOperationalPlan, getParameters, getParent, getPerceivableContext, getReference, getSimulator, getSpeed, getSpeed, hashCode, init, interruptMove, isDestroyed, removeGtu, setMaximumAcceleration, setMaximumDeceleration, setParameters
addListener, addListener, addListener, addListener, fireEvent, fireEvent, fireEvent, fireEvent, fireEvent, fireEvent, fireEvent, fireEvent, fireEvent, fireEvent, fireTimedEvent, fireTimedEvent, fireTimedEvent, fireTimedEvent, fireTimedEvent, fireTimedEvent, fireTimedEvent, removeAllListeners, removeAllListeners, removeListener
clone, finalize, getClass, notify, notifyAll, wait, wait, wait
getLocation, getTacticalPlanner, getTacticalPlanner, isBrakingLightsOn, isBrakingLightsOn, laneChangeAllowed, setNoLaneChangeDistance
addGtu, getAcceleration, getAcceleration, getCenter, getChildren, getContourPoints, getFront, getGTUType, getId, getLength, getMaximumAcceleration, getMaximumDeceleration, getMaximumSpeed, getOdometer, getOdometer, getOperationalPlan, getOperationalPlan, getParameters, getParent, getRear, getReference, getRelativePositions, getSimulator, getSpeed, getSpeed, getWidth, isDestroyed, removeGtu, setParameters
addListener, addListener, addListener, addListener, removeListener
public static Length initialLocationThresholdDifference
public static boolean CACHING
public static int CACHED_POSITION
public static int NON_CACHED_POSITION
public AbstractLaneBasedGTU(String id, GTUType gtuType, OTSSimulatorInterface simulator, OTSNetwork network) throws GTUException
id
- String; the id of the GTUgtuType
- GTUType; the type of GTU, e.g. TruckType, CarType, BusTypesimulator
- OTSSimulatorInterface; to initialize the move method and to get the current timenetwork
- OTSNetwork; the network that the GTU is initially registered inGTUException
- when initial values are not correctpublic void init(LaneBasedStrategicalPlanner strategicalPlanner, Set<DirectedLanePosition> initialLongitudinalPositions, Speed initialSpeed) throws NetworkException, SimRuntimeException, GTUException, OTSGeometryException
strategicalPlanner
- LaneBasedStrategicalPlanner; the strategical planner (e.g., route determination) to useinitialLongitudinalPositions
- Set<DirectedLanePosition>; the initial positions of the car on one or more
lanes with their directionsinitialSpeed
- Speed; the initial speed of the car on the laneNetworkException
- when the GTU cannot be placed on the given laneSimRuntimeException
- when the move method cannot be scheduledGTUException
- when initial values are not correctOTSGeometryException
- when the initial path is wrongpublic void setParent(GTU gtu) throws GTUException
setParent
in interface GTU
setParent
in class AbstractGTU
GTUException
public void reinit(Set<DirectedLanePosition> initialLongitudinalPositions) throws NetworkException, SimRuntimeException, GTUException, OTSGeometryException
initialLongitudinalPositions
- Set<DirectedLanePosition>; initial positionNetworkException
- when the GTU cannot be placed on the given laneSimRuntimeException
- when the move method cannot be scheduledGTUException
- when initial values are not correctOTSGeometryException
- when the initial path is wrongpublic final boolean isSafeToChange() throws GTUException
GTUException
- on errorpublic void enterLane(Lane lane, Length position, GTUDirectionality gtuDirection) throws GTUException
enterLane
in interface LaneBasedGTU
lane
- Lane; the lane to add to the list of lanes on which the GTU is registered.position
- Length; the position on the lane.gtuDirection
- GTUDirectionality; the direction of the GTU on the lane (which can be bidirectional). If the GTU has
a positive speed, it is moving in this direction.GTUException
- when positioning the GTU on the lane causes a problemprotected void addGtuToLane(Lane lane, Length position) throws GTUException
lane
- Lane; laneposition
- Length; positionGTUException
- on exceptionpublic void leaveLane(Lane lane) throws GTUException
leaveLane
in interface LaneBasedGTU
lane
- Lane; the lane to remove from the list of lanes on which the GTU is registered.GTUException
- when leaveLane should not be calledpublic void leaveLane(Lane lane, boolean beingDestroyed) throws GTUException
lane
- Lane; the lane to leavebeingDestroyed
- boolean; if true, no complaints about having no lanes leftGTUException
- in case leaveLane should not be calledpublic void changeLaneInstantaneously(LateralDirectionality laneChangeDirection) throws GTUException
changeLaneInstantaneously
in interface LaneBasedGTU
laneChangeDirection
- LateralDirectionality; the direction to change toGTUException
- in case lane change failspublic void initLaneChange(LateralDirectionality laneChangeDirection) throws GTUException
laneChangeDirection
- LateralDirectionality; direction of lane changeGTUException
- exceptionprotected void finalizeLaneChange(LateralDirectionality laneChangeDirection)
laneChangeDirection
- LateralDirectionality; direction of lane changepublic void setFinalizeLaneChangeEvent(SimEventInterface<SimTimeDoubleUnit> event)
setFinalizeLaneChangeEvent
in interface LaneBasedGTU
event
- SimEventInterface<SimTimeDoubleUnit>; eventpublic final GTUDirectionality getDirection(Lane lane) throws GTUException
getDirection
in interface LaneBasedGTU
lane
- Lane; the lane for which we want to know the directionGTUException
- in case the GTU is not registered on the Laneprotected void move(DirectedPoint fromLocation) throws SimRuntimeException, GTUException, OperationalPlanException, NetworkException, ParameterException
move
in class AbstractGTU
SimRuntimeException
GTUException
OperationalPlanException
NetworkException
ParameterException
public final Map<Lane,Length> positions(RelativePosition relativePosition) throws GTUException
positions
in interface LaneBasedGTU
relativePosition
- RelativePosition; the position on the vehicle relative to the reference point.GTUException
- when the vehicle is not on one of the lanes on which it is registered.public final Map<Lane,Length> positions(RelativePosition relativePosition, Time when) throws GTUException
positions
in interface LaneBasedGTU
relativePosition
- RelativePosition; the position on the vehicle relative to the reference point.when
- Time; the future time for which to calculate the positions.GTUException
- when the vehicle is not on one of the lanes on which it is registered.public final Length position(Lane lane, RelativePosition relativePosition) throws GTUException
position
in interface LaneBasedGTU
lane
- Lane; the position on this lane will be returned.relativePosition
- RelativePosition; the position on the vehicle relative to the reference point.GTUException
- when the vehicle is not on the given lane.public Length translatedPosition(Lane projectionLane, RelativePosition relativePosition, Time when) throws GTUException
translatedPosition
in interface LaneBasedGTU
projectionLane
- Lane; the lane onto which the position of this GTU must be projectedrelativePosition
- RelativePosition; the point on this GTU that must be projectedwhen
- Time; the time for which to project the position of this GTUGTUException
- when projectionLane it not in any of the CrossSectionLink that the GTU is onpublic Length projectedPosition(Lane projectionLane, RelativePosition relativePosition, Time when) throws GTUException
projectedPosition
in interface LaneBasedGTU
projectionLane
- Lane; the lane onto which the position of this GTU must be projectedrelativePosition
- RelativePosition; the point on this GTU that must be projectedwhen
- Time; the time for which to project the position of this GTUGTUException
- when projectionLane it not in any of the CrossSectionLink that the GTU is onpublic Length position(Lane lane, RelativePosition relativePosition, Time when) throws GTUException
position
in interface LaneBasedGTU
lane
- Lane; the position on this lane will be returned.relativePosition
- RelativePosition; the position on the vehicle relative to the reference point.when
- Time; the future time for which to calculate the positions.GTUException
- when the vehicle is not on the given lane.public DirectedLanePosition getReferencePosition() throws GTUException
getReferencePosition
in interface LaneBasedGTU
GTUException
- in case the reference position of the GTU cannot be found on the lanes in its current pathprotected void scheduleEnterLeaveTriggers() throws NetworkException, SimRuntimeException, GTUException
NetworkException
- on network inconsistencySimRuntimeException
- should never happenGTUException
- when a branch is reached where the GTU does not know where to go nextpublic final Map<Lane,Double> fractionalPositions(RelativePosition relativePosition) throws GTUException
fractionalPositions
in interface LaneBasedGTU
relativePosition
- RelativePosition; the position on the vehicle relative to the reference point.GTUException
- when the vehicle is not on one of the lanes on which it is registered.public final Map<Lane,Double> fractionalPositions(RelativePosition relativePosition, Time when) throws GTUException
fractionalPositions
in interface LaneBasedGTU
relativePosition
- RelativePosition; the position on the vehicle relative to the reference point.when
- Time; the future time for which to calculate the positions.GTUException
- when the vehicle is not on one of the lanes on which it is registered.public final double fractionalPosition(Lane lane, RelativePosition relativePosition, Time when) throws GTUException
fractionalPosition
in interface LaneBasedGTU
lane
- Lane; the position on this lane will be returned.relativePosition
- RelativePosition; the position on the vehicle relative to the reference point.when
- Time; the future time for which to calculate the positions.GTUException
- when the vehicle is not on the given lane.public final double fractionalPosition(Lane lane, RelativePosition relativePosition) throws GTUException
fractionalPosition
in interface LaneBasedGTU
lane
- Lane; the position on this lane will be returned.relativePosition
- RelativePosition; the position on the vehicle relative to the reference point.GTUException
- when the vehicle is not on the given lane.public final void addTrigger(Lane lane, SimEventInterface<SimTimeDoubleUnit> event)
addTrigger
in interface LaneBasedGTU
lane
- Lane; the lane on which the event occursevent
- SimEventInterface<SimTimeDoubleUnit>; SimeEvent<SimTimeDoubleUnit> the eventpublic void setVehicleModel(VehicleModel vehicleModel)
vehicleModel
- VehicleModel; vehicle modelpublic VehicleModel getVehicleModel()
getVehicleModel
in interface LaneBasedGTU
public void destroy()
destroy
in interface GTU
destroy
in class AbstractGTU
public final javax.media.j3d.Bounds getBounds()
public final LaneBasedStrategicalPlanner getStrategicalPlanner()
getStrategicalPlanner
in interface GTU
getStrategicalPlanner
in interface LaneBasedGTU
getStrategicalPlanner
in class AbstractGTU
public final LaneBasedStrategicalPlanner getStrategicalPlanner(Time time)
getStrategicalPlanner
in interface GTU
getStrategicalPlanner
in interface LaneBasedGTU
getStrategicalPlanner
in class AbstractGTU
public Speed getDesiredSpeed()
getDesiredSpeed
in interface LaneBasedGTU
public Acceleration getCarFollowingAcceleration()
getCarFollowingAcceleration
in interface LaneBasedGTU
public final TurnIndicatorStatus getTurnIndicatorStatus()
getTurnIndicatorStatus
in interface LaneBasedGTU
public final TurnIndicatorStatus getTurnIndicatorStatus(Time time)
getTurnIndicatorStatus
in interface LaneBasedGTU
time
- Time; time to obtain the turn indicator status atpublic final void setTurnIndicatorStatus(TurnIndicatorStatus turnIndicatorStatus)
setTurnIndicatorStatus
in interface LaneBasedGTU
turnIndicatorStatus
- TurnIndicatorStatus; the new status of the turn indicator.Copyright © 2014–2019 Delft University of Technology. All rights reserved.