org.opentrafficsim.kpi.sampling

Class Sampler

java.lang.Object

org.opentrafficsim.kpi.sampling.Sampler

public abstract class Sampler
extends Object

Sampler is the highest level organizer for sampling.

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

Version:

$Revision$, $LastChangedDate$, by $Author$, initial version Sep 22, 2016

Author:

Alexander Verbraeck, Peter Knoppers, Wouter Schakel

Constructor Summary

Constructors

Constructor and Description
Sampler()

Method Summary

Modifier and Type	Method and Description
boolean	contains(KpiLaneDirection kpiLaneDirection) Returns whether there is data for the give lane direction.
boolean	equals(Object obj)
abstract void	finalizeRecording(KpiLaneDirection kpiLaneDirection) Remove listeners to stop recording.
TrajectoryGroup	getTrajectoryGroup(KpiLaneDirection kpiLaneDirection) Returns the trajectory group of given lane direction.
int	hashCode()
abstract void	initRecording(KpiLaneDirection kpiLaneDirection) Adds listeners to start recording.
abstract org.djunits.value.vdouble.scalar.Time	now() Returns the current simulation time.
void	processGtuAddEvent(KpiLaneDirection kpiLaneDirection, org.djunits.value.vdouble.scalar.Length position, org.djunits.value.vdouble.scalar.Speed speed, org.djunits.value.vdouble.scalar.Acceleration acceleration, org.djunits.value.vdouble.scalar.Time time, GtuDataInterface gtu) Creates a trajectory with the current snapshot of a GTU.
void	processGtuMoveEvent(KpiLaneDirection kpiLaneDirection, org.djunits.value.vdouble.scalar.Length position, org.djunits.value.vdouble.scalar.Speed speed, org.djunits.value.vdouble.scalar.Acceleration acceleration, org.djunits.value.vdouble.scalar.Time time, GtuDataInterface gtu) Adds a new snapshot of a GTU to its recording trajectory, if recorded.
void	processGtuRemoveEvent(KpiLaneDirection kpiLaneDirection, GtuDataInterface gtu) Finalizes a trajectory.
void	processGtuRemoveEvent(KpiLaneDirection kpiLaneDirection, org.djunits.value.vdouble.scalar.Length position, org.djunits.value.vdouble.scalar.Speed speed, org.djunits.value.vdouble.scalar.Acceleration acceleration, org.djunits.value.vdouble.scalar.Time time, GtuDataInterface gtu) Finalizes a trajectory with the current snapshot of a GTU.
void	registerExtendedDataType(ExtendedDataType<?> extendedDataType) Registers extended data type that will be stored with the trajectories.
void	registerMetaDataTypes(Set<MetaDataType<?>> metaDataTypes) Registers meta data types that will be stored with the trajectories.
void	registerSpaceTimeRegion(SpaceTimeRegion spaceTimeRegion)
abstract void	scheduleStartRecording(org.djunits.value.vdouble.scalar.Time time, KpiLaneDirection kpiLaneDirection) Schedules the start of recording for a given lane-direction.
abstract void	scheduleStopRecording(org.djunits.value.vdouble.scalar.Time time, KpiLaneDirection kpiLaneDirection) Schedules the stop of recording for a given lane-direction.
void	startRecording(KpiLaneDirection kpiLaneDirection) Start recording at the given time (which should be the current time) on the given lane direction.
void	stopRecording(KpiLaneDirection kpiLaneDirection) Stop recording at given lane direction.

Methods inherited from class java.lang.Object

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

Constructor Detail

Sampler

public Sampler()

Method Detail

registerSpaceTimeRegion

public final void registerSpaceTimeRegion(SpaceTimeRegion spaceTimeRegion)

Parameters:

spaceTimeRegion - space-time region

Throws:

IllegalStateException - if data is not available from the requested start time

now

public abstract org.djunits.value.vdouble.scalar.Time now()

Returns the current simulation time.

Returns:

current simulation time

scheduleStartRecording

public abstract void scheduleStartRecording(org.djunits.value.vdouble.scalar.Time time,
                                            KpiLaneDirection kpiLaneDirection)

Schedules the start of recording for a given lane-direction.

Parameters:

time - time to start recording

kpiLaneDirection - lane-direction to start recording

scheduleStopRecording

public abstract void scheduleStopRecording(org.djunits.value.vdouble.scalar.Time time,
                                           KpiLaneDirection kpiLaneDirection)

Schedules the stop of recording for a given lane-direction.

Parameters:

time - time to stop recording

kpiLaneDirection - lane-direction to stop recording

registerMetaDataTypes

public final void registerMetaDataTypes(Set<MetaDataType<?>> metaDataTypes)

Registers meta data types that will be stored with the trajectories.

Parameters:

metaDataTypes - meta data types to register

registerExtendedDataType

public final void registerExtendedDataType(ExtendedDataType<?> extendedDataType)

Registers extended data type that will be stored with the trajectories.

Parameters:

extendedDataType - extended data type to register

startRecording

public final void startRecording(KpiLaneDirection kpiLaneDirection)

Start recording at the given time (which should be the current time) on the given lane direction.

Parameters:

kpiLaneDirection - lane direction

initRecording

public abstract void initRecording(KpiLaneDirection kpiLaneDirection)

Adds listeners to start recording.

Parameters:

kpiLaneDirection - lane direction to initialize recording for

stopRecording

public final void stopRecording(KpiLaneDirection kpiLaneDirection)

Stop recording at given lane direction.

Parameters:

kpiLaneDirection - lane direction

finalizeRecording

public abstract void finalizeRecording(KpiLaneDirection kpiLaneDirection)

Remove listeners to stop recording.

Parameters:

kpiLaneDirection - lane direction to finalize recording for

processGtuAddEvent

public final void processGtuAddEvent(KpiLaneDirection kpiLaneDirection,
                                     org.djunits.value.vdouble.scalar.Length position,
                                     org.djunits.value.vdouble.scalar.Speed speed,
                                     org.djunits.value.vdouble.scalar.Acceleration acceleration,
                                     org.djunits.value.vdouble.scalar.Time time,
                                     GtuDataInterface gtu)

Creates a trajectory with the current snapshot of a GTU.

Parameters:

kpiLaneDirection - lane direction the gtu is at

position - position of the gtu on the lane

speed - speed of the gtu

acceleration - acceleration of the gtu

time - current time

gtu - gtu

processGtuMoveEvent

public final void processGtuMoveEvent(KpiLaneDirection kpiLaneDirection,
                                      org.djunits.value.vdouble.scalar.Length position,
                                      org.djunits.value.vdouble.scalar.Speed speed,
                                      org.djunits.value.vdouble.scalar.Acceleration acceleration,
                                      org.djunits.value.vdouble.scalar.Time time,
                                      GtuDataInterface gtu)

Adds a new snapshot of a GTU to its recording trajectory, if recorded. This method may be invoked on GTU that are not being recorded; the event will then be ignored.

Parameters:

kpiLaneDirection - lane direction the gtu is at

position - position of the gtu on the lane

speed - speed of the gtu

acceleration - acceleration of the gtu

time - current time

gtu - gtu

processGtuRemoveEvent

public final void processGtuRemoveEvent(KpiLaneDirection kpiLaneDirection,
                                        org.djunits.value.vdouble.scalar.Length position,
                                        org.djunits.value.vdouble.scalar.Speed speed,
                                        org.djunits.value.vdouble.scalar.Acceleration acceleration,
                                        org.djunits.value.vdouble.scalar.Time time,
                                        GtuDataInterface gtu)

Finalizes a trajectory with the current snapshot of a GTU.

Parameters:

kpiLaneDirection - lane direction the gtu is at

position - position of the gtu on the lane

speed - speed of the gtu

acceleration - acceleration of the gtu

time - current time

gtu - gtu

processGtuRemoveEvent

public final void processGtuRemoveEvent(KpiLaneDirection kpiLaneDirection,
                                        GtuDataInterface gtu)

Finalizes a trajectory.

Parameters:

kpiLaneDirection - lane direction the gtu is at

gtu - gtu

contains

public final boolean contains(KpiLaneDirection kpiLaneDirection)

Returns whether there is data for the give lane direction.

Parameters:

kpiLaneDirection - lane direction

Returns:

whether there is data for the give lane direction

getTrajectoryGroup

public final TrajectoryGroup getTrajectoryGroup(KpiLaneDirection kpiLaneDirection)

Returns the trajectory group of given lane direction.

Parameters:

kpiLaneDirection - lane direction

Returns:

trajectory group of given lane direction, null if none

hashCode

public int hashCode()

Overrides:

hashCode in class Object

equals

public boolean equals(Object obj)

Overrides:

equals in class Object