Class DefaultTableXYDataset

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

An XYDataset where every series shares the same x-values (required for generating stacked area charts).
See Also:
  • Constructor Details

    • DefaultTableXYDataset

      Creates a new empty dataset.
    • DefaultTableXYDataset

      public DefaultTableXYDataset(boolean autoPrune)
      Creates a new empty dataset.
      Parameters:
      autoPrune - a flag that controls whether or not x-values are removed whenever the corresponding y-values are all null.
  • Method Details

    • isAutoPrune

      public boolean isAutoPrune()
      Returns the flag that controls whether or not x-values are removed from the dataset when the corresponding y-values are all null.
      Returns:
      A boolean.
    • addSeries

      public void addSeries(XYSeries series)
      Adds a series to the collection and sends a DatasetChangeEvent to all registered listeners. The series should be configured to NOT allow duplicate x-values.
      Parameters:
      series - the series (null not permitted).
    • updateXPoints

      public void updateXPoints()
      Updates the x-values for all the series in the dataset.
    • 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.
    • getItemCount

      public int getItemCount()
      Returns the number of x values in the dataset.
      Specified by:
      getItemCount in interface TableXYDataset
      Returns:
      The number of x values in the dataset.
    • getSeries

      public XYSeries getSeries(int series)
      Returns a series.
      Parameters:
      series - the series (zero-based index).
      Returns:
      The series (never null).
    • getSeriesKey

      public Comparable getSeriesKey(int series)
      Returns the key for a series.
      Specified by:
      getSeriesKey in interface SeriesDataset
      Specified by:
      getSeriesKey in class AbstractSeriesDataset
      Parameters:
      series - the series (zero-based index).
      Returns:
      The key for a series.
    • getItemCount

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

      public Number getX(int series, int item)
      Returns the x-value for the specified series and item.
      Specified by:
      getX 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.
    • getStartX

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

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

      public Number getY(int series, int index)
      Returns the y-value for the specified series and item.
      Specified by:
      getY in interface XYDataset
      Parameters:
      series - the series (zero-based index).
      index - the index of the item of interest (zero-based).
      Returns:
      The y-value for the specified series and item (possibly null).
    • getStartY

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

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

      public void removeAllSeries()
      Removes all the series from the collection and sends a DatasetChangeEvent to all registered listeners.
    • removeSeries

      public void removeSeries(XYSeries series)
      Removes a series from the collection and sends a DatasetChangeEvent to all registered listeners.
      Parameters:
      series - the series (null not permitted).
    • removeSeries

      public void removeSeries(int series)
      Removes a series from the collection and sends a DatasetChangeEvent to all registered listeners.
      Parameters:
      series - the series (zero based index).
    • removeAllValuesForX

      public void removeAllValuesForX(Number x)
      Removes the items from all series for a given x value.
      Parameters:
      x - the x-value.
    • canPrune

      protected boolean canPrune(Number x)
      Returns true if all the y-values for the specified x-value are null and false otherwise.
      Parameters:
      x - the x-value.
      Returns:
      A boolean.
    • prune

      public void prune()
      Removes all x-values for which all the y-values are null.
    • seriesChanged

      public void seriesChanged(SeriesChangeEvent event)
      This method receives notification when a series belonging to the dataset changes. It responds by updating the x-points for the entire dataset and sending a DatasetChangeEvent to all registered listeners.
      Specified by:
      seriesChanged in interface SeriesChangeListener
      Overrides:
      seriesChanged in class AbstractSeriesDataset
      Parameters:
      event - information about the change.
    • equals

      public boolean equals(Object obj)
      Tests this collection for equality with an arbitrary object.
      Overrides:
      equals in class AbstractDataset
      Parameters:
      obj - the object (null permitted).
      Returns:
      A boolean.
    • hashCode

      public int hashCode()
      Returns a hash code.
      Overrides:
      hashCode in class AbstractDataset
      Returns:
      A hash code.
    • clone

      Returns an independent copy of this dataset.
      Specified by:
      clone in interface PublicCloneable
      Overrides:
      clone in class AbstractDataset
      Returns:
      A clone.
      Throws:
      CloneNotSupportedException - if there is some reason that cloning cannot be performed.
    • getDomainLowerBound

      public double getDomainLowerBound(boolean includeInterval)
      Returns the minimum x-value in the dataset.
      Specified by:
      getDomainLowerBound in interface DomainInfo
      Parameters:
      includeInterval - a flag that determines whether or not the x-interval is taken into account.
      Returns:
      The minimum value.
    • getDomainUpperBound

      public double getDomainUpperBound(boolean includeInterval)
      Returns the maximum x-value in the dataset.
      Specified by:
      getDomainUpperBound in interface DomainInfo
      Parameters:
      includeInterval - a flag that determines whether or not the x-interval is taken into account.
      Returns:
      The maximum value.
    • getDomainBounds

      public Range getDomainBounds(boolean includeInterval)
      Returns the range of the values in this dataset's domain.
      Specified by:
      getDomainBounds in interface DomainInfo
      Parameters:
      includeInterval - a flag that determines whether or not the x-interval is taken into account.
      Returns:
      The range.
    • getIntervalPositionFactor

      public double getIntervalPositionFactor()
      Returns the interval position factor.
      Returns:
      The interval position factor.
    • setIntervalPositionFactor

      public void setIntervalPositionFactor(double d)
      Sets the interval position factor. Must be between 0.0 and 1.0 inclusive. If the factor is 0.5, the gap is in the middle of the x values. If it is lesser than 0.5, the gap is farther to the left and if greater than 0.5 it gets farther to the right.
      Parameters:
      d - the new interval position factor.
    • getIntervalWidth

      public double getIntervalWidth()
      returns the full interval width.
      Returns:
      The interval width to use.
    • setIntervalWidth

      public void setIntervalWidth(double d)
      Sets the interval width to a fixed value, and sends a DatasetChangeEvent to all registered listeners.
      Parameters:
      d - the new interval width (must be > 0).
    • isAutoWidth

      public boolean isAutoWidth()
      Returns whether the interval width is automatically calculated or not.
      Returns:
      A flag that determines whether or not the interval width is automatically calculated.
    • setAutoWidth

      public void setAutoWidth(boolean b)
      Sets the flag that indicates whether the interval width is automatically calculated or not.
      Parameters:
      b - a boolean.