org.opentrafficsim.core.car

Class LaneBasedIndividualCar

java.lang.Object

org.opentrafficsim.core.gtu.AbstractGTU

org.opentrafficsim.core.gtu.lane.AbstractLaneBasedGTU

org.opentrafficsim.core.gtu.lane.AbstractLaneBasedIndividualGTU

org.opentrafficsim.core.car.LaneBasedIndividualCar

All Implemented Interfaces:

Serializable, LocatableInterface, org.djunits.unit.UNITS, org.djunits.value.vdouble.scalar.DOUBLE_SCALAR, GTU, LaneBasedGTU, OTS_SCALAR

public class LaneBasedIndividualCar
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: 1378 $, $LastChangedDate: 2015-09-03 13:38:01 +0200 (Thu, 03 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	LaneBasedIndividualCar.LaneBasedIndividualCarBuilder Build an individual car and use easy setter methods to instantiate the car.

Nested classes/interfaces inherited from interface org.djunits.value.vdouble.scalar.DOUBLE_SCALAR

org.djunits.value.vdouble.scalar.DOUBLE_SCALAR.Acceleration, org.djunits.value.vdouble.scalar.DOUBLE_SCALAR.AnglePlane, org.djunits.value.vdouble.scalar.DOUBLE_SCALAR.AngleSlope, org.djunits.value.vdouble.scalar.DOUBLE_SCALAR.AngleSolid, org.djunits.value.vdouble.scalar.DOUBLE_SCALAR.Area, org.djunits.value.vdouble.scalar.DOUBLE_SCALAR.Density, org.djunits.value.vdouble.scalar.DOUBLE_SCALAR.Dimensionless, org.djunits.value.vdouble.scalar.DOUBLE_SCALAR.ElectricalCharge, org.djunits.value.vdouble.scalar.DOUBLE_SCALAR.ElectricalCurrent, org.djunits.value.vdouble.scalar.DOUBLE_SCALAR.ElectricalPotential, org.djunits.value.vdouble.scalar.DOUBLE_SCALAR.ElectricalResistance, org.djunits.value.vdouble.scalar.DOUBLE_SCALAR.Energy, org.djunits.value.vdouble.scalar.DOUBLE_SCALAR.FlowMass, org.djunits.value.vdouble.scalar.DOUBLE_SCALAR.FlowVolume, org.djunits.value.vdouble.scalar.DOUBLE_SCALAR.Force, org.djunits.value.vdouble.scalar.DOUBLE_SCALAR.Frequency, org.djunits.value.vdouble.scalar.DOUBLE_SCALAR.Length, org.djunits.value.vdouble.scalar.DOUBLE_SCALAR.LinearDensity, org.djunits.value.vdouble.scalar.DOUBLE_SCALAR.Mass, org.djunits.value.vdouble.scalar.DOUBLE_SCALAR.Power, org.djunits.value.vdouble.scalar.DOUBLE_SCALAR.Pressure, org.djunits.value.vdouble.scalar.DOUBLE_SCALAR.Speed, org.djunits.value.vdouble.scalar.DOUBLE_SCALAR.Temperature, org.djunits.value.vdouble.scalar.DOUBLE_SCALAR.Time, org.djunits.value.vdouble.scalar.DOUBLE_SCALAR.Torque, org.djunits.value.vdouble.scalar.DOUBLE_SCALAR.Volume

Field Summary

Fields inherited from interface org.djunits.unit.UNITS

ABAMPERE, ABCOULOMB, ABVOLT, ACRE, AMPERE, ARCMINUTE, ARCSECOND, ARE, ATMOSPHERE_STANDARD, ATMOSPHERE_TECHNICAL, ATOMIC_UNIT, BAR, BARYE, BTU_ISO, BTU_IT, CALORIE_IT, CENTESIMAL_ARCMINUTE, CENTESIMAL_ARCSECOND, CENTIMETER, CENTIMETER_MERCURY, COULOMB, CUBIC_CENTIMETER, CUBIC_DECIMETER, CUBIC_FEET_PER_MINUTE, CUBIC_FEET_PER_SECOND, CUBIC_FOOT, CUBIC_INCH, CUBIC_INCH_PER_MINUTE, CUBIC_INCH_PER_SECOND, CUBIC_KM, CUBIC_METER, CUBIC_METER_PER_DAY, CUBIC_METER_PER_HOUR, CUBIC_METER_PER_MINUTE, CUBIC_METER_PER_SECOND, CUBIC_MILE, CUBIC_YARD, DALTON, DAY, DECIMETER, DEG, DEGREE, DEGREE_CELSIUS, DEGREE_FAHRENHEIT, DEGREE_RANKINE, DEGREE_REAUMUR, DEKAMETER, DYNE, ELECTRONVOLT, EMU, ERG, ERG_PER_SECOND, ESU, EXA_ELECTRONVOLT, FARADAY, FOOT, FOOT_MERCURY, FOOT_PER_SECOND, FOOT_PER_SECOND_2, FOOT_POUND_FORCE, FOOT_POUND_FORCE_PER_HOUR, FOOT_POUND_FORCE_PER_MINUTE, FOOT_POUND_FORCE_PER_SECOND, FRANKLIN, GAL, GALLON_IMP, GALLON_PER_DAY, GALLON_PER_HOUR, GALLON_PER_MINUTE, GALLON_PER_SECOND, GALLON_US_FLUID, GIGA_ELECTRONVOLT, GIGAHERTZ, GIGAWATT, GIGAWATT_HOUR, GRAD, GRAM, GRAM_PER_CENTIMETER_3, HECTARE, HECTOMETER, HECTOPASCAL, HERTZ, HORSEPOWER_METRIC, HOUR, INCH, INCH_MERCURY, INCH_PER_SECOND_2, INCH_POUND_FORCE, JOULE, KELVIN, KG_PER_METER_3, KGF_PER_SQUARE_MM, KILO_ELECTRONVOLT, KILOAMPERE, KILOCALORIE, KILOGRAM, KILOGRAM_FORCE, KILOGRAM_PER_SECOND, KILOHERTZ, KILOMETER, KILOOHM, KILOPASCAL, KILOVOLT, KILOWATT, KILOWATT_HOUR, KM_PER_HOUR, KM_PER_HOUR_2, KNOT, KNOT_PER_SECOND, LITER, LITER_PER_DAY, LITER_PER_HOUR, LITER_PER_MINUTE, LITER_PER_SECOND, MEGA_ELECTRONVOLT, MEGAHERTZ, MEGAOHM, MEGAVOLT, MEGAWATT, MEGAWATT_HOUR, METER, METER_KILOGRAM_FORCE, METER_PER_SECOND, METER_PER_SECOND_2, MICROAMPERE, MICROVOLT, MICROWATT_HOUR, MILE, MILE_PER_HOUR, MILE_PER_HOUR_2, MILE_PER_HOUR_PER_SECOND, MILLI_ELECTRONVOLT, MILLIAMPERE, MILLIAMPERE_HOUR, MILLIBAR, MILLIMETER, MILLIMETER_MERCURY, MILLIOHM, MILLISECOND, MILLIVOLT, MILLIWATT_HOUR, MINUTE, NANOAMPERE, NAUTICAL_MILE, NEWTON, NEWTON_METER, OHM, OUNCE, OUNCE_FORCE, OUNCE_IMP_FLUID, OUNCE_US_FLUID, PASCAL, PER_CENTIMETER, PER_DAY, PER_DECIMETER, PER_DEKAMETER, PER_FOOT, PER_HECTOMETER, PER_HOUR, PER_INCH, PER_KILOMETER, PER_METER, PER_MILE, PER_MILLIMETER, PER_MILLISECOND, PER_MINUTE, PER_NAUTICAL_MILE, PER_SECOND, PER_WEEK, PER_YARD, PETA_ELECTRONVOLT, PIEZE, PINT_IMP, PINT_US_FLUID, POUND, POUND_FOOT, POUND_FORCE, POUND_INCH, POUND_PER_SECOND, POUND_PER_SQUARE_FOOT, POUND_PER_SQUARE_INCH, QUART_IMP, QUART_US_FLUID, RAD, RADIAN, RPM, SECOND, SLOPE_ARCMINUTE, SLOPE_ARCSECOND, SLOPE_CENTESIMAL_ARCMINUTE, SLOPE_CENTESIMAL_ARCSECOND, SLOPE_DEGREE, SLOPE_GRAD, SLOPE_RADIAN, SQUARE_CENTIMETER, SQUARE_DEGREE, SQUARE_FOOT, SQUARE_INCH, SQUARE_METER, SQUARE_MILE, SQUARE_MILLIMETER, SQUARE_YARD, STANDARD_GRAVITY, STATAMPERE, STATCOULOMB, STATVOLT, STERADIAN, STHENE, STHENE_METER, STHENE_METER_PER_SECOND, TERA_ELECTRONVOLT, TERAHERTZ, TERAWATT_HOUR, TON_FORCE, TON_LONG, TON_METRIC, TON_SHORT, TONNE, TORR, VOLT, WATT, WATT_HOUR, WEEK, YARD

Constructor Summary

Constructors

Constructor and Description
LaneBasedIndividualCar(String id, GTUType gtuType, GTUFollowingModel gtuFollowingModel, LaneChangeModel laneChangeModel, Map<Lane,org.djunits.value.vdouble.scalar.Length.Rel> initialLongitudinalPositions, org.djunits.value.vdouble.scalar.Speed.Abs initialSpeed, org.djunits.value.vdouble.scalar.Length.Rel length, org.djunits.value.vdouble.scalar.Length.Rel width, org.djunits.value.vdouble.scalar.Speed.Abs maximumVelocity, LaneBasedRouteNavigator routeNavigator, OTSDEVSSimulatorInterface simulator)
LaneBasedIndividualCar(String id, GTUType gtuType, GTUFollowingModel gtuFollowingModel, LaneChangeModel laneChangeModel, Map<Lane,org.djunits.value.vdouble.scalar.Length.Rel> initialLongitudinalPositions, org.djunits.value.vdouble.scalar.Speed.Abs initialSpeed, org.djunits.value.vdouble.scalar.Length.Rel length, org.djunits.value.vdouble.scalar.Length.Rel width, org.djunits.value.vdouble.scalar.Speed.Abs maximumVelocity, LaneBasedRouteNavigator routeNavigator, OTSDEVSSimulatorInterface simulator, Class<? extends Renderable2D> animationClass, GTUColorer gtuColorer) Construct a new LaneBasedIndividualCar.

Method Summary

Modifier and Type	Method and Description
void	destroy() destroy the vehicle from the simulation and animation.
RelativePosition	getFront()
RelativePosition	getRear()
Map<RelativePosition.TYPE,RelativePosition>	getRelativePositions()
String	toString()

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

getLength, getMaximumVelocity, getSimulator, getWidth

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

bestAccessibleAdjacentLane, deltaTimeForDistance, enterLane, fractionalPosition, fractionalPosition, fractionalPositions, fractionalPositions, getAcceleration, getAcceleration, getBounds, getGTUFollowingModel, getLaneChangeDistanceAndDirection, getLanes, getLastEvaluationTime, getLateralVelocity, getLocation, getLongitudinalVelocity, getLongitudinalVelocity, getNextEvaluationTime, getOdometer, getVelocity, headway, headway, leaveLane, leaveLane, move, parallel, parallel, position, position, positions, positions, projectedPosition, timeAtDistance, toString

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

getGTUType, getId, getReference, getRouteNavigator, setRouteNavigator

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

getGTUType, getId, getReference

Constructor Detail

LaneBasedIndividualCar

public LaneBasedIndividualCar(String id,
                              GTUType gtuType,
                              GTUFollowingModel gtuFollowingModel,
                              LaneChangeModel laneChangeModel,
                              Map<Lane,org.djunits.value.vdouble.scalar.Length.Rel> initialLongitudinalPositions,
                              org.djunits.value.vdouble.scalar.Speed.Abs initialSpeed,
                              org.djunits.value.vdouble.scalar.Length.Rel length,
                              org.djunits.value.vdouble.scalar.Length.Rel width,
                              org.djunits.value.vdouble.scalar.Speed.Abs maximumVelocity,
                              LaneBasedRouteNavigator routeNavigator,
                              OTSDEVSSimulatorInterface simulator)
                       throws NamingException,
                              RemoteException,
                              NetworkException,
                              SimRuntimeException,
                              GTUException

Parameters:

id - ID; the id of the GTU

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

gtuFollowingModel - GTUFollowingModel; the following model, including a reference to the simulator

laneChangeModel - LaneChangeModel; the lane change model

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

initialSpeed - DoubleScalar.Abs<SpeedUnit>; the initial speed of the car on the lane

length - DoubleScalar.Rel<LengthUnit>; the maximum length of the GTU (parallel with driving direction)

width - DoubleScalar.Rel<LengthUnit>; the maximum width of the GTU (perpendicular to driving direction)

maximumVelocity - DoubleScalar.Abs<SpeedUnit>;the maximum speed of the GTU (in the driving direction)

routeNavigator - Route; the route that the GTU will follow

simulator - OTSDEVSSimulatorInterface; the simulator

Throws:

NamingException - if an error occurs when adding the animation handler

RemoteException - when the simulator cannot be reached

NetworkException - when the GTU cannot be placed on the given lane

SimRuntimeException - when the move method cannot be scheduled

GTUException - when a parameter is invalid

LaneBasedIndividualCar

public LaneBasedIndividualCar(String id,
                              GTUType gtuType,
                              GTUFollowingModel gtuFollowingModel,
                              LaneChangeModel laneChangeModel,
                              Map<Lane,org.djunits.value.vdouble.scalar.Length.Rel> initialLongitudinalPositions,
                              org.djunits.value.vdouble.scalar.Speed.Abs initialSpeed,
                              org.djunits.value.vdouble.scalar.Length.Rel length,
                              org.djunits.value.vdouble.scalar.Length.Rel width,
                              org.djunits.value.vdouble.scalar.Speed.Abs maximumVelocity,
                              LaneBasedRouteNavigator routeNavigator,
                              OTSDEVSSimulatorInterface simulator,
                              Class<? extends Renderable2D> animationClass,
                              GTUColorer gtuColorer)
                       throws NamingException,
                              RemoteException,
                              NetworkException,
                              SimRuntimeException,
                              GTUException

Construct a new LaneBasedIndividualCar.

Parameters:

id - ID; the id of the GTU

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

gtuFollowingModel - GTUFollowingModel; the following model, including a reference to the simulator

laneChangeModel - LaneChangeModel; the lane change model

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

initialSpeed - DoubleScalar.Abs<SpeedUnit>; the initial speed of the car on the lane

length - DoubleScalar.Rel<LengthUnit>; the maximum length of the GTU (parallel with driving direction)

width - DoubleScalar.Rel<LengthUnit>; the maximum width of the GTU (perpendicular to driving direction)

maximumVelocity - DoubleScalar.Abs<SpeedUnit>;the maximum speed of the GTU (in the driving direction)

routeNavigator - Route the route that the GTU will follow

simulator - OTSDEVSSimulatorInterface; the simulator

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)

Throws:

NamingException - if an error occurs when adding the animation handler

RemoteException - when the simulator cannot be reached

NetworkException - when the GTU cannot be placed on the given lane

SimRuntimeException - when the move method cannot be scheduled

GTUException - when a parameter is invalid

Method Detail

getFront

public RelativePosition getFront()

Returns:

the front position of the GTU, relative to its reference point.

getRear

public RelativePosition getRear()

Returns:

the rear position of the GTU, relative to its reference point.

getRelativePositions

public final Map<RelativePosition.TYPE,RelativePosition> getRelativePositions()

Returns:

the positions for this GTU.

destroy

public final void destroy()

destroy the vehicle from the simulation and animation.

Specified by:

destroy in interface GTU

Overrides:

destroy in class AbstractLaneBasedGTU

toString

public final String toString()

Overrides:

toString in class Object