org.opentrafficsim.road.gtu.generator

Class AbstractGTUGenerator

java.lang.Object

org.opentrafficsim.road.gtu.generator.AbstractGTUGenerator

All Implemented Interfaces:

org.djunits.unit.UNITS, org.djunits.value.vdouble.scalar.DOUBLE_SCALAR, org.opentrafficsim.core.OTS_DIST, org.opentrafficsim.core.OTS_SCALAR, org.opentrafficsim.core.units.distributions.OTS_DOUBLE_DIST

Direct Known Subclasses:

GTUGeneratorIndividual

public abstract class AbstractGTUGenerator
extends Object
implements org.opentrafficsim.core.OTS_SCALAR, org.opentrafficsim.core.OTS_DIST

Common code for LaneBasedGTU generators that may have to postpone putting a GTU on the road due to congestion growing into the generator.
Generally, these generators will discover that there is not enough room AFTER having decided what kind (particular length) of GTU will be constructed next. When this happens, the generator must remember the properties of the GTU, but postpone actual generation until there is enough room.

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 Feb 2, 2015

Author:

Alexander Verbraeck, Peter Knoppers

Nested Class Summary

Nested classes/interfaces inherited from interface org.opentrafficsim.core.units.distributions.OTS_DOUBLE_DIST

org.opentrafficsim.core.units.distributions.OTS_DOUBLE_DIST.ContinuousDistScalar, org.opentrafficsim.core.units.distributions.OTS_DOUBLE_DIST.DiscreteDistScalar

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

Modifier and Type	Field and Description
protected long	numberGTUs Number of generated GTUs.

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

AbstractGTUGenerator(String name, org.opentrafficsim.core.dsol.OTSDEVSSimulatorInterface simulator, org.opentrafficsim.core.gtu.GTUType gtuType, Class<?> gtuClass, GTUFollowingModel gtuFollowingModel, LaneChangeModel laneChangeModel, org.opentrafficsim.core.units.distributions.ContinuousDistDoubleScalar.Abs<org.djunits.value.vdouble.scalar.Speed.Abs,org.djunits.unit.SpeedUnit> initialSpeedDist, org.opentrafficsim.core.units.distributions.ContinuousDistDoubleScalar.Rel<org.djunits.value.vdouble.scalar.Time.Rel,org.djunits.unit.TimeUnit> interarrivelTimeDist, long maxGTUs, org.djunits.value.vdouble.scalar.Time.Abs startTime, org.djunits.value.vdouble.scalar.Time.Abs endTime, Lane lane, org.djunits.value.vdouble.scalar.Length.Rel position, LaneBasedRouteGenerator routeGenerator, org.opentrafficsim.core.gtu.animation.GTUColorer gtuColorer)

Method Summary

Modifier and Type	Method and Description
protected void	checkCarBuilderList() Check if car can be generated.
protected boolean	enoughSpace(LaneBasedIndividualCar.LaneBasedIndividualCarBuilder carBuilder) Check if the car to be built is not overlapping with another GTU on the same lane, and if it has enough headway to be generated safely.
protected void	generate() Generate a GTU.
org.djunits.value.vdouble.scalar.Time.Abs	getEndTime()
Class<?>	getGtuClass()
org.opentrafficsim.core.gtu.animation.GTUColorer	getGtuColorer()
GTUFollowingModel	getGtuFollowingModel()
org.opentrafficsim.core.gtu.GTUType	getGtuType()
org.opentrafficsim.core.units.distributions.ContinuousDistDoubleScalar.Abs<org.djunits.value.vdouble.scalar.Speed.Abs,org.djunits.unit.SpeedUnit>	getInitialSpeedDist()
org.opentrafficsim.core.units.distributions.ContinuousDistDoubleScalar.Rel<org.djunits.value.vdouble.scalar.Time.Rel,org.djunits.unit.TimeUnit>	getInterarrivelTimeDist()
LaneChangeModel	getLaneChangeModel()
abstract org.opentrafficsim.core.units.distributions.ContinuousDistDoubleScalar.Rel<org.djunits.value.vdouble.scalar.Length.Rel,org.djunits.unit.LengthUnit>	getLengthDist()
long	getMaxGTUs()
abstract org.opentrafficsim.core.units.distributions.ContinuousDistDoubleScalar.Abs<org.djunits.value.vdouble.scalar.Speed.Abs,org.djunits.unit.SpeedUnit>	getMaximumSpeedDist()
String	getName()
org.opentrafficsim.core.network.route.RouteGenerator	getRouteGenerator()
abstract org.opentrafficsim.core.dsol.OTSDEVSSimulatorInterface	getSimulator()
org.djunits.value.vdouble.scalar.Time.Abs	getStartTime()
abstract org.opentrafficsim.core.units.distributions.ContinuousDistDoubleScalar.Rel<org.djunits.value.vdouble.scalar.Length.Rel,org.djunits.unit.LengthUnit>	getWidthDist()
HeadwayGTU	headway(org.djunits.value.vdouble.scalar.Length.Rel maxDistance, LaneBasedRouteNavigator routeNavigator, Lane generatorLane) Check the available headway for GTU that is about to be constructed.
void	setRouteGenerator(LaneBasedRouteGenerator routeGenerator)

Methods inherited from class java.lang.Object

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

Field Detail

numberGTUs

protected long numberGTUs

Number of generated GTUs.

Constructor Detail

AbstractGTUGenerator

public AbstractGTUGenerator(String name,
                            org.opentrafficsim.core.dsol.OTSDEVSSimulatorInterface simulator,
                            org.opentrafficsim.core.gtu.GTUType gtuType,
                            Class<?> gtuClass,
                            GTUFollowingModel gtuFollowingModel,
                            LaneChangeModel laneChangeModel,
                            org.opentrafficsim.core.units.distributions.ContinuousDistDoubleScalar.Abs<org.djunits.value.vdouble.scalar.Speed.Abs,org.djunits.unit.SpeedUnit> initialSpeedDist,
                            org.opentrafficsim.core.units.distributions.ContinuousDistDoubleScalar.Rel<org.djunits.value.vdouble.scalar.Time.Rel,org.djunits.unit.TimeUnit> interarrivelTimeDist,
                            long maxGTUs,
                            org.djunits.value.vdouble.scalar.Time.Abs startTime,
                            org.djunits.value.vdouble.scalar.Time.Abs endTime,
                            Lane lane,
                            org.djunits.value.vdouble.scalar.Length.Rel position,
                            LaneBasedRouteGenerator routeGenerator,
                            org.opentrafficsim.core.gtu.animation.GTUColorer gtuColorer)
                     throws nl.tudelft.simulation.dsol.SimRuntimeException

Parameters:

name - the name of the generator

simulator - the simulator to schedule the start of the generation

gtuType - the type of GTU to generate

gtuClass - the GTU class to instantiate

gtuFollowingModel - the GTU following model to use

laneChangeModel - the lane change model to use

initialSpeedDist - distribution of the initial speed of the GTU

interarrivelTimeDist - distribution of the interarrival time

maxGTUs - maximum number of GTUs to generate

startTime - start time of generation (delayed start)

endTime - end time of generation

lane - the lane to generate the GTU on

position - position on the lane, relative to the design line of the link

routeGenerator - RouteGenerator; the route generator that will create a route for each generated GTU

gtuColorer - the GTUColorer to use

Throws:

nl.tudelft.simulation.dsol.SimRuntimeException - when simulation scheduling fails

Method Detail

generate

protected final void generate()
                       throws Exception

Generate a GTU.

Throws:

Exception - when something in the generation fails.

enoughSpace

protected final boolean enoughSpace(LaneBasedIndividualCar.LaneBasedIndividualCarBuilder carBuilder)
                             throws org.opentrafficsim.core.network.NetworkException

Check if the car to be built is not overlapping with another GTU on the same lane, and if it has enough headway to be generated safely.

Parameters:

carBuilder - the car to be generated

Returns:

true if car can be safely built, false otherwise.

Throws:

org.opentrafficsim.core.network.NetworkException - if GTU does not have a position on the lane where it is registered

headway

public final HeadwayGTU headway(org.djunits.value.vdouble.scalar.Length.Rel maxDistance,
                                LaneBasedRouteNavigator routeNavigator,
                                Lane generatorLane)
                         throws org.opentrafficsim.core.network.NetworkException

Check the available headway for GTU that is about to be constructed.

Parameters:

maxDistance - DoubleScalar.Rel<LengthUnit>; the maximum distance to look for a leader

routeNavigator - RouteNavigator; the route that this GTU intends to take

generatorLane - Lane; the lane on which the GTU is generated

Returns:

HeadwayGTU; the available headway and the GTU at that headway

Throws:

org.opentrafficsim.core.network.NetworkException - on network inconsistency

checkCarBuilderList

protected final void checkCarBuilderList()
                                  throws Exception

Check if car can be generated.

Throws:

Exception - on any problem

getSimulator

public abstract org.opentrafficsim.core.dsol.OTSDEVSSimulatorInterface getSimulator()

Returns:

simulator.

getLengthDist

public abstract org.opentrafficsim.core.units.distributions.ContinuousDistDoubleScalar.Rel<org.djunits.value.vdouble.scalar.Length.Rel,org.djunits.unit.LengthUnit> getLengthDist()

Returns:

lengthDist.

getWidthDist

public abstract org.opentrafficsim.core.units.distributions.ContinuousDistDoubleScalar.Rel<org.djunits.value.vdouble.scalar.Length.Rel,org.djunits.unit.LengthUnit> getWidthDist()

Returns:

widthDist.

getMaximumSpeedDist

public abstract org.opentrafficsim.core.units.distributions.ContinuousDistDoubleScalar.Abs<org.djunits.value.vdouble.scalar.Speed.Abs,org.djunits.unit.SpeedUnit> getMaximumSpeedDist()

Returns:

maximumSpeedDist.

getName

public final String getName()

Returns:

name.

getGtuType

public final org.opentrafficsim.core.gtu.GTUType getGtuType()

Returns:

gtuType.

getGtuClass

public final Class<?> getGtuClass()

Returns:

gtuClass.

getGtuFollowingModel

public final GTUFollowingModel getGtuFollowingModel()

Returns:

gtuFollowingModel.

getInitialSpeedDist

public final org.opentrafficsim.core.units.distributions.ContinuousDistDoubleScalar.Abs<org.djunits.value.vdouble.scalar.Speed.Abs,org.djunits.unit.SpeedUnit> getInitialSpeedDist()

Returns:

initialSpeedDist.

getInterarrivelTimeDist

public final org.opentrafficsim.core.units.distributions.ContinuousDistDoubleScalar.Rel<org.djunits.value.vdouble.scalar.Time.Rel,org.djunits.unit.TimeUnit> getInterarrivelTimeDist()

Returns:

interarrivelTimeDist.

getMaxGTUs

public final long getMaxGTUs()

Returns:

maxGTUs.

getStartTime

public final org.djunits.value.vdouble.scalar.Time.Abs getStartTime()

Returns:

startTime.

getEndTime

public final org.djunits.value.vdouble.scalar.Time.Abs getEndTime()

Returns:

endTime.

getRouteGenerator

public final org.opentrafficsim.core.network.route.RouteGenerator getRouteGenerator()

Returns:

routeGenerator.

setRouteGenerator

public final void setRouteGenerator(LaneBasedRouteGenerator routeGenerator)

Parameters:

routeGenerator - set routeGenerator.

getLaneChangeModel

public final LaneChangeModel getLaneChangeModel()

Returns:

laneChangeModel.

getGtuColorer

public final org.opentrafficsim.core.gtu.animation.GTUColorer getGtuColorer()

Returns:

gtuColorer.