org.opentrafficsim.draw.graphs

Class ContourDataSource<G extends GtuDataInterface>

java.lang.Object

org.opentrafficsim.draw.graphs.ContourDataSource<G>

Type Parameters:

G - gtu type data

public class ContourDataSource<G extends GtuDataInterface>
extends Object

Class that contains data for contour plots. One data source can be shared between contour plots, in which case the granularity, path, sampler, update interval, and whether the data is smoothed (EGTF) are equal between the plots.

By default the source contains traveled time and traveled distance per cell.

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.

Version:

$Revision$, $LastChangedDate$, by $Author$, initial version 5 okt. 2018

Author:

Alexander Verbraeck, Peter Knoppers, Wouter Schakel

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static interface	ContourDataSource.ContourDataType<Z extends Number,I> Interface for data types of which a contour plot can be made.
static class	ContourDataSource.Dimension Enum to refer to either the distance or time axis.

Field Summary

Fields

Modifier and Type	Field and Description
protected static Time	DEFAULT_LOWER_TIME_BOUND Initial lower bound for the time scale.
protected static double[]	DEFAULT_SPACE_GRANULARITIES Space granularity values.
protected static int	DEFAULT_SPACE_GRANULARITY_INDEX Index of the initial space granularity.
protected static double[]	DEFAULT_TIME_GRANULARITIES Time granularity values.
protected static int	DEFAULT_TIME_GRANULARITY_INDEX Index of the initial time granularity.

Constructor Summary

Constructors

Constructor and Description
ContourDataSource(Sampler<G> sampler, Duration delay, GraphPath<KpiLaneDirection> path, double[] spaceGranularity, int initSpaceIndex, double[] timeGranularity, int initTimeIndex, Time start, Time initialEnd) Constructor for non-default input.
ContourDataSource(Sampler<G> sampler, GraphPath<KpiLaneDirection> path) Constructor using default granularities.

Method Summary

Modifier and Type	Method and Description
double	get(int item, ContourDataSource.ContourDataType<?,?> contourDataType) Returns data of the given ContourDataType for a specific item.
Sampler<G>	getSampler() Returns the sampler for an AbstractContourPlot using this ContourDataSource.
double	getSpeed(int item) Returns the speed of the cell pertaining to plot item.
double	getTotalDistance(int item) Returns the total distance traveled in the cell pertaining to plot item.
double	getTotalTime(int item) Returns the total time traveled in the cell pertaining to plot item.
String	toString()

Methods inherited from class java.lang.Object

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

Field Detail

DEFAULT_SPACE_GRANULARITIES

protected static final double[] DEFAULT_SPACE_GRANULARITIES

Space granularity values.

DEFAULT_SPACE_GRANULARITY_INDEX

protected static final int DEFAULT_SPACE_GRANULARITY_INDEX

Index of the initial space granularity.

See Also:

Constant Field Values

DEFAULT_TIME_GRANULARITIES

protected static final double[] DEFAULT_TIME_GRANULARITIES

Time granularity values.

DEFAULT_TIME_GRANULARITY_INDEX

protected static final int DEFAULT_TIME_GRANULARITY_INDEX

Index of the initial time granularity.

See Also:

Constant Field Values

DEFAULT_LOWER_TIME_BOUND

protected static final Time DEFAULT_LOWER_TIME_BOUND

Initial lower bound for the time scale.

Constructor Detail

ContourDataSource

public ContourDataSource(Sampler<G> sampler,
                         GraphPath<KpiLaneDirection> path)

Constructor using default granularities.

Parameters:

sampler - Sampler<G>; sampler

path - GraphPath<KpiLaneDirection>; path

ContourDataSource

public ContourDataSource(Sampler<G> sampler,
                         Duration delay,
                         GraphPath<KpiLaneDirection> path,
                         double[] spaceGranularity,
                         int initSpaceIndex,
                         double[] timeGranularity,
                         int initTimeIndex,
                         Time start,
                         Time initialEnd)

Constructor for non-default input.

Parameters:

sampler - Sampler<G>; sampler

delay - Duration; delay so critical future events have occurred, e.g. GTU's next move's to extend trajectories

path - GraphPath<KpiLaneDirection>; path

spaceGranularity - double[]; granularity options for space dimension

initSpaceIndex - int; initial selected space granularity

timeGranularity - double[]; granularity options for time dimension

initTimeIndex - int; initial selected time granularity

start - Time; start time

initialEnd - Time; initial end time of plots, will be expanded if simulation time exceeds it

Method Detail

getSampler

public final Sampler<G> getSampler()

Returns the sampler for an AbstractContourPlot using this ContourDataSource.

Returns:

Sampler<G>; the sampler

getSpeed

public double getSpeed(int item)

Returns the speed of the cell pertaining to plot item.

Parameters:

item - int; plot item

Returns:

double; speed of the cell, calculated as 'total distance' / 'total space'.

getTotalDistance

public double getTotalDistance(int item)

Returns the total distance traveled in the cell pertaining to plot item.

Parameters:

item - int; plot item

Returns:

double; total distance traveled in the cell

getTotalTime

public double getTotalTime(int item)

Returns the total time traveled in the cell pertaining to plot item.

Parameters:

item - int; plot item

Returns:

double; total time traveled in the cell

get

public double get(int item,
                  ContourDataSource.ContourDataType<?,?> contourDataType)

Returns data of the given ContourDataType for a specific item.

Parameters:

item - int; plot item

contourDataType - ContourDataType<?, ?>; contour data type

Returns:

data of the given ContourDataType for a specific item

toString

public String toString()

Overrides:

toString in class Object