org.opentrafficsim.road.gtu.lane

Class LaneBasedIndividualGTU

java.lang.Object

org.opentrafficsim.core.gtu.AbstractGTU

org.opentrafficsim.road.gtu.lane.AbstractLaneBasedGTU

org.opentrafficsim.road.gtu.lane.AbstractLaneBasedIndividualGTU

org.opentrafficsim.road.gtu.lane.LaneBasedIndividualGTU

All Implemented Interfaces:

Serializable, nl.tudelft.simulation.dsol.animation.LocatableInterface, org.opentrafficsim.core.gtu.GTU, LaneBasedGTU

Direct Known Subclasses:

RTICars

public class LaneBasedIndividualGTU
extends AbstractLaneBasedIndividualGTU

Augments the AbstractLaneBasedIndividualGTU with a LaneBasedIndividualCarBuilder and animation support

Copyright (c) 2013-2015 Delft University of Technology, PO Box 5, 2600 AA, Delft, the Netherlands. All rights reserved.
BSD-style license. See OpenTrafficSim License.

Version:

$Revision: 1401 $, $LastChangedDate: 2015-09-14 01:33:02 +0200 (Mon, 14 Sep 2015) $, by $Author: averbraeck $, initial version Oct 22, 2014

Author:

Alexander Verbraeck, Peter Knoppers

See Also:

Serialized Form

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	LaneBasedIndividualGTU.LaneBasedIndividualCarBuilder Build an individual car and use easy setter methods to instantiate the car.

Constructor Summary

Constructors

Constructor and Description
LaneBasedIndividualGTU(String id, org.opentrafficsim.core.gtu.GTUType gtuType, Set<DirectedLanePosition> initialLongitudinalPositions, org.djunits.value.vdouble.scalar.Speed initialSpeed, org.djunits.value.vdouble.scalar.Length.Rel length, org.djunits.value.vdouble.scalar.Length.Rel width, org.djunits.value.vdouble.scalar.Speed maximumVelocity, org.opentrafficsim.core.dsol.OTSDEVSSimulatorInterface simulator, LaneBasedStrategicalPlanner strategicalPlanner, LanePerceptionFull perception, Class<? extends nl.tudelft.simulation.dsol.animation.D2.Renderable2D> animationClass, org.opentrafficsim.core.gtu.animation.GTUColorer gtuColorer, org.opentrafficsim.core.network.OTSNetwork network) Construct a new LaneBasedIndividualCar.
LaneBasedIndividualGTU(String id, org.opentrafficsim.core.gtu.GTUType gtuType, Set<DirectedLanePosition> initialLongitudinalPositions, org.djunits.value.vdouble.scalar.Speed initialSpeed, org.djunits.value.vdouble.scalar.Length.Rel length, org.djunits.value.vdouble.scalar.Length.Rel width, org.djunits.value.vdouble.scalar.Speed maximumVelocity, org.opentrafficsim.core.dsol.OTSDEVSSimulatorInterface simulator, LaneBasedStrategicalPlanner strategicalPlanner, LanePerceptionFull perception, org.opentrafficsim.core.network.OTSNetwork network)

Method Summary

Modifier and Type	Method and Description
void	destroy()
org.opentrafficsim.core.gtu.RelativePosition	getFront()
org.opentrafficsim.core.gtu.RelativePosition	getRear()
Map<org.opentrafficsim.core.gtu.RelativePosition.TYPE,org.opentrafficsim.core.gtu.RelativePosition>	getRelativePositions()

Methods inherited from class org.opentrafficsim.road.gtu.lane.AbstractLaneBasedIndividualGTU

getLength, getMaximumVelocity, getWidth

Methods inherited from class org.opentrafficsim.road.gtu.lane.AbstractLaneBasedGTU

addTrigger, enterLane, fractionalPosition, fractionalPosition, fractionalPositions, fractionalPositions, getBehavioralCharacteristics, getBounds, getLanes, getPerception, getStrategicalPlanner, leaveLane, leaveLane, move, position, position, positions, positions, projectedPosition, toString

Methods inherited from class org.opentrafficsim.core.gtu.AbstractGTU

getAcceleration, getAcceleration, getGTUType, getId, getLocation, getMaximumAcceleration, getMaximumDeceleration, getOdometer, getOperationalPlan, getPerceivableContext, getReference, getSimulator, getTacticalPlanner, getTurnIndicatorStatus, getVelocity, getVelocity, interruptMove, isDestroyed, setMaximumAcceleration, setMaximumDeceleration, setTurnIndicatorStatus

Methods inherited from class java.lang.Object

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

Methods inherited from interface org.opentrafficsim.core.gtu.GTU

getAcceleration, getAcceleration, getGTUType, getId, getLocation, getMaximumAcceleration, getMaximumDeceleration, getOdometer, getOperationalPlan, getReference, getSimulator, getTacticalPlanner, getTurnIndicatorStatus, getVelocity, getVelocity, setTurnIndicatorStatus

Constructor Detail

LaneBasedIndividualGTU

public LaneBasedIndividualGTU(String id,
                              org.opentrafficsim.core.gtu.GTUType gtuType,
                              Set<DirectedLanePosition> initialLongitudinalPositions,
                              org.djunits.value.vdouble.scalar.Speed initialSpeed,
                              org.djunits.value.vdouble.scalar.Length.Rel length,
                              org.djunits.value.vdouble.scalar.Length.Rel width,
                              org.djunits.value.vdouble.scalar.Speed maximumVelocity,
                              org.opentrafficsim.core.dsol.OTSDEVSSimulatorInterface simulator,
                              LaneBasedStrategicalPlanner strategicalPlanner,
                              LanePerceptionFull perception,
                              org.opentrafficsim.core.network.OTSNetwork network)
                       throws NamingException,
                              org.opentrafficsim.core.network.NetworkException,
                              nl.tudelft.simulation.dsol.SimRuntimeException,
                              org.opentrafficsim.core.gtu.GTUException,
                              org.opentrafficsim.core.geometry.OTSGeometryException

Parameters:

id - ID; the id of the GTU

gtuType - GTUType; the type of GTU, e.g. TruckType, CarType, BusType

initialLongitudinalPositions - Map<Lane, Length.Rel>; the initial positions of the car on one or more lanes

initialSpeed - Speed; the initial speed of the car on the lane

length - Length.Rel; the maximum length of the GTU (parallel with driving direction)

width - Length.Rel; the maximum width of the GTU (perpendicular to driving direction)

maximumVelocity - Speed;the maximum speed of the GTU (in the driving direction)

simulator - OTSDEVSSimulatorInterface; the simulator

strategicalPlanner - the strategical planner (e.g., route determination) to use

perception - the lane-based perception model of the GTU

network - the network that the GTU is initially registered in

Throws:

NamingException - if an error occurs when adding the animation handler

org.opentrafficsim.core.network.NetworkException - when the GTU cannot be placed on the given lane

nl.tudelft.simulation.dsol.SimRuntimeException - when the move method cannot be scheduled

org.opentrafficsim.core.gtu.GTUException - when a parameter is invalid

org.opentrafficsim.core.geometry.OTSGeometryException - when the initial path is wrong

LaneBasedIndividualGTU

public LaneBasedIndividualGTU(String id,
                              org.opentrafficsim.core.gtu.GTUType gtuType,
                              Set<DirectedLanePosition> initialLongitudinalPositions,
                              org.djunits.value.vdouble.scalar.Speed initialSpeed,
                              org.djunits.value.vdouble.scalar.Length.Rel length,
                              org.djunits.value.vdouble.scalar.Length.Rel width,
                              org.djunits.value.vdouble.scalar.Speed maximumVelocity,
                              org.opentrafficsim.core.dsol.OTSDEVSSimulatorInterface simulator,
                              LaneBasedStrategicalPlanner strategicalPlanner,
                              LanePerceptionFull perception,
                              Class<? extends nl.tudelft.simulation.dsol.animation.D2.Renderable2D> animationClass,
                              org.opentrafficsim.core.gtu.animation.GTUColorer gtuColorer,
                              org.opentrafficsim.core.network.OTSNetwork network)
                       throws NamingException,
                              org.opentrafficsim.core.network.NetworkException,
                              nl.tudelft.simulation.dsol.SimRuntimeException,
                              org.opentrafficsim.core.gtu.GTUException,
                              org.opentrafficsim.core.geometry.OTSGeometryException

Construct a new LaneBasedIndividualCar.

Parameters:

id - ID; the id of the GTU

gtuType - GTUTYpe; the type of GTU, e.g. TruckType, CarType, BusType

initialLongitudinalPositions - Map<Lane, Length.Rel>; the initial positions of the car on one or more lanes

initialSpeed - Speed; the initial speed of the car on the lane

length - Length.Rel; the maximum length of the GTU (parallel with driving direction)

width - Length.Rel; the maximum width of the GTU (perpendicular to driving direction)

maximumVelocity - Speed;the maximum speed of the GTU (in the driving direction)

simulator - OTSDEVSSimulatorInterface; the simulator

strategicalPlanner - the strategical planner (e.g., route determination) to use

perception - the lane-based perception model of the GTU

animationClass - Class<? extends Renderable2D>; the class for animation or null if no animation

gtuColorer - GTUColorer; the GTUColorer that will be linked from the animation to determine the color (may be null in which case a default will be used)

network - the network that the GTU is initially registered in

Throws:

NamingException - if an error occurs when adding the animation handler

org.opentrafficsim.core.network.NetworkException - when the GTU cannot be placed on the given lane

nl.tudelft.simulation.dsol.SimRuntimeException - when the move method cannot be scheduled

org.opentrafficsim.core.gtu.GTUException - when a parameter is invalid

org.opentrafficsim.core.geometry.OTSGeometryException - when the initial path is wrong

Method Detail

getFront

public org.opentrafficsim.core.gtu.RelativePosition getFront()

getRear

public org.opentrafficsim.core.gtu.RelativePosition getRear()

getRelativePositions

public final Map<org.opentrafficsim.core.gtu.RelativePosition.TYPE,org.opentrafficsim.core.gtu.RelativePosition> getRelativePositions()

destroy

public final void destroy()

Specified by:

destroy in interface org.opentrafficsim.core.gtu.GTU

Overrides:

destroy in class AbstractLaneBasedGTU