Class TimePeriodValuesCollection

All Implemented Interfaces:
ObjectInputValidation, Serializable, Cloneable, EventListener, Dataset, DomainInfo, IntervalXYDataset, SeriesChangeListener, SeriesDataset, XYDataset

public class TimePeriodValuesCollection
extends AbstractIntervalXYDataset
implements IntervalXYDataset, DomainInfo, Serializable
A collection of TimePeriodValues objects.

This class implements the XYDataset interface, as well as the extended IntervalXYDataset interface. This makes it a convenient dataset for use with the XYPlot class.

See Also:
Serialized Form
  • Field Details

    • START

      public static final int START
      Deprecated.
      Replaced by TimePeriodAnchor.START.
      Useful constant for controlling the x-value returned for a time period.
      See Also:
      Constant Field Values
    • MIDDLE

      public static final int MIDDLE
      Deprecated.
      Replaced by TimePeriodAnchor.MIDDLE.
      Useful constant for controlling the x-value returned for a time period.
      See Also:
      Constant Field Values
    • END

      public static final int END
      Deprecated.
      Replaced by TimePeriodAnchor.END.
      Useful constant for controlling the x-value returned for a time period.
      See Also:
      Constant Field Values
  • Constructor Details

    • TimePeriodValuesCollection

      public TimePeriodValuesCollection()
      Constructs an empty dataset, tied to the default timezone.
    • TimePeriodValuesCollection

      public TimePeriodValuesCollection​(TimeZone zone)
      Deprecated.
      The TimeZone is ignored, use an alternative constructor.
      Constructs an empty dataset, tied to a specific timezone.
      Parameters:
      zone - the timezone.
    • TimePeriodValuesCollection

      public TimePeriodValuesCollection​(TimePeriodValues series)
      Constructs a dataset containing a single series. Additional series can be added.
      Parameters:
      series - the series.
    • TimePeriodValuesCollection

      public TimePeriodValuesCollection​(TimePeriodValues series, TimeZone zone)
      Deprecated.
      TimeZone parameter is not used.
      Constructs a dataset containing a single series (more can be added), tied to a specific timezone.
      Parameters:
      series - the series.
      zone - the timezone.
  • Method Details

    • getPosition

      public int getPosition()
      Deprecated.
      Use getXPosition().
      Returns the position of the x-value returned for a time period (START, MIDDLE, or END).
      Returns:
      the position.
    • setPosition

      public void setPosition​(int position)
      Deprecated.
      Use setXPosition(...).
      Sets the position - this controls the x-value that is returned for a particular time period.

      Use the constants START, MIDDLE and END.

      Parameters:
      position - the position.
    • getXPosition

      public TimePeriodAnchor getXPosition()
      Returns the position of the X value within each time period.
      Returns:
      The position.
    • setXPosition

      public void setXPosition​(TimePeriodAnchor position)
      Sets the position of the x axis within each time period.
      Parameters:
      position - the position.
    • getDomainIsPointsInTime

      public boolean getDomainIsPointsInTime()
      Returns a flag that controls whether the domain is treated as 'points in time'.

      This flag is used when determining the max and min values for the domain. If true, then only the x-values are considered for the max and min values. If false, then the start and end x-values will also be taken into consideration

      Returns:
      The flag.
    • setDomainIsPointsInTime

      public void setDomainIsPointsInTime​(boolean flag)
      Sets a flag that controls whether the domain is treated as 'points in time', or time periods.
      Parameters:
      flag - the new value of the flag.
    • getSeriesCount

      public int getSeriesCount()
      Returns the number of series in the collection.
      Specified by:
      getSeriesCount in interface SeriesDataset
      Specified by:
      getSeriesCount in class AbstractSeriesDataset
      Returns:
      The series count.
    • getSeries

      public TimePeriodValues getSeries​(int series)
      Returns a series.
      Parameters:
      series - The index of the series (zero-based).
      Returns:
      the series.
    • getSeriesName

      public String getSeriesName​(int series)
      Returns the name of a series.

      This method is provided for convenience.

      Specified by:
      getSeriesName in interface SeriesDataset
      Specified by:
      getSeriesName in class AbstractSeriesDataset
      Parameters:
      series - The index of the series (zero-based).
      Returns:
      the name of a series.
    • addSeries

      public void addSeries​(TimePeriodValues series)
      Adds a series to the collection. A DatasetChangeEvent is sent to all registered listeners.
      Parameters:
      series - the time series.
    • removeSeries

      public void removeSeries​(TimePeriodValues series)
      Removes the specified series from the collection.
      Parameters:
      series - the series to remove.
    • removeSeries

      public void removeSeries​(int index)
      Removes a series from the collection.
      Parameters:
      index - the series index (zero-based).
    • getItemCount

      public int getItemCount​(int series)
      Returns the number of items in the specified series.

      This method is provided for convenience.

      Specified by:
      getItemCount in interface XYDataset
      Parameters:
      series - The index of the series of interest (zero-based).
      Returns:
      the number of items in the specified series.
    • getXValue

      public Number getXValue​(int series, int item)
      Returns the x-value for the specified series and item.
      Specified by:
      getXValue in interface XYDataset
      Parameters:
      series - The series (zero-based index).
      item - The item (zero-based index).
      Returns:
      the x-value for the specified series and item.
    • getStartXValue

      public Number getStartXValue​(int series, int item)
      Returns the starting X value for the specified series and item.
      Specified by:
      getStartXValue in interface IntervalXYDataset
      Parameters:
      series - The series (zero-based index).
      item - The item (zero-based index).
      Returns:
      the starting X value for the specified series and item.
    • getEndXValue

      public Number getEndXValue​(int series, int item)
      Returns the ending X value for the specified series and item.
      Specified by:
      getEndXValue in interface IntervalXYDataset
      Parameters:
      series - The series (zero-based index).
      item - The item (zero-based index).
      Returns:
      the ending X value for the specified series and item.
    • getYValue

      public Number getYValue​(int series, int item)
      Returns the y-value for the specified series and item.
      Specified by:
      getYValue in interface XYDataset
      Parameters:
      series - The series (zero-based index).
      item - The item (zero-based index).
      Returns:
      the y-value for the specified series and item.
    • getStartYValue

      public Number getStartYValue​(int series, int item)
      Returns the starting Y value for the specified series and item.
      Specified by:
      getStartYValue in interface IntervalXYDataset
      Parameters:
      series - The series (zero-based index).
      item - The item (zero-based index).
      Returns:
      the starting Y value for the specified series and item.
    • getEndYValue

      public Number getEndYValue​(int series, int item)
      Returns the ending Y value for the specified series and item.
      Specified by:
      getEndYValue in interface IntervalXYDataset
      Parameters:
      series - The series (zero-based index).
      item - The item (zero-based index).
      Returns:
      the ending Y value for the specified series and item.
    • getMinimumDomainValue

      public Number getMinimumDomainValue()
      Returns the minimum value in the dataset (or null if all the values in the domain are null).
      Specified by:
      getMinimumDomainValue in interface DomainInfo
      Returns:
      the minimum value.
    • getMaximumDomainValue

      public Number getMaximumDomainValue()
      Returns the maximum value in the dataset (or null if all the values in the domain are null).
      Specified by:
      getMaximumDomainValue in interface DomainInfo
      Returns:
      the maximum value.
    • getDomainRange

      public Range getDomainRange()
      Returns the range of the values in the series domain.
      Specified by:
      getDomainRange in interface DomainInfo
      Returns:
      the range.