Class DefaultHeatMapDataset

java.lang.Object
org.jfree.data.general.AbstractDataset
org.jfree.data.general.DefaultHeatMapDataset
All Implemented Interfaces:
ObjectInputValidation, Serializable, Cloneable, PublicCloneable, Dataset, HeatMapDataset

public class DefaultHeatMapDataset extends AbstractDataset implements HeatMapDataset, Cloneable, PublicCloneable, Serializable
A default implementation of the HeatMapDataset interface.
See Also:
  • Field Summary

    Fields
    Modifier and Type
    Field
    Description
    private double
    The maximum x-value in the dataset.
    private double
    The maximum y-value in the dataset.
    private double
    The minimum x-value in the dataset.
    private double
    The minimum y-value in the dataset.
    private int
    The number of samples in this dataset for the x-dimension.
    private int
    The number of samples in this dataset for the y-dimension.
    private double[][]
    Storage for the z-values.
  • Constructor Summary

    Constructors
    Constructor
    Description
    DefaultHeatMapDataset(int xSamples, int ySamples, double minX, double maxX, double minY, double maxY)
    Creates a new dataset where all the z-values are initially 0.
  • Method Summary

    Modifier and Type
    Method
    Description
    Returns an independent copy of this dataset.
    boolean
    Tests this dataset for equality with an arbitrary object.
    double
    Returns the highest x-value represented in this dataset.
    double
    Returns the highest y-value represented in this dataset.
    double
    Returns the lowest x-value represented in this dataset.
    double
    Returns the lowest y-value represented in this dataset.
    int
    Returns the number of x values across the width of the dataset.
    double
    getXValue(int xIndex)
    A convenience method that returns the x-value for the given index.
    int
    Returns the number of y values (or samples) for the dataset.
    double
    getYValue(int yIndex)
    A convenience method that returns the y-value for the given index.
    getZ(int xIndex, int yIndex)
    Returns the z-value at the specified sample position in the dataset.
    double
    getZValue(int xIndex, int yIndex)
    Returns the z-value at the specified sample position in the dataset.
    void
    setZValue(int xIndex, int yIndex, double z)
    Updates a z-value in the dataset and sends a DatasetChangeEvent to all registered listeners.
    void
    setZValue(int xIndex, int yIndex, double z, boolean notify)
    Updates a z-value in the dataset and, if requested, sends a DatasetChangeEvent to all registered listeners.

    Methods inherited from class java.lang.Object

    finalize, getClass, notify, notifyAll, toString, wait, wait, wait
  • Field Details

    • xSamples

      private int xSamples
      The number of samples in this dataset for the x-dimension.
    • ySamples

      private int ySamples
      The number of samples in this dataset for the y-dimension.
    • minX

      private double minX
      The minimum x-value in the dataset.
    • maxX

      private double maxX
      The maximum x-value in the dataset.
    • minY

      private double minY
      The minimum y-value in the dataset.
    • maxY

      private double maxY
      The maximum y-value in the dataset.
    • zValues

      private double[][] zValues
      Storage for the z-values.
  • Constructor Details

    • DefaultHeatMapDataset

      public DefaultHeatMapDataset(int xSamples, int ySamples, double minX, double maxX, double minY, double maxY)
      Creates a new dataset where all the z-values are initially 0. This is a fixed size array of z-values.
      Parameters:
      xSamples - the number of x-values.
      ySamples - the number of y-values
      minX - the minimum x-value in the dataset.
      maxX - the maximum x-value in the dataset.
      minY - the minimum y-value in the dataset.
      maxY - the maximum y-value in the dataset.
  • Method Details

    • getXSampleCount

      public int getXSampleCount()
      Returns the number of x values across the width of the dataset. The values are evenly spaced between getMinimumXValue() and getMaximumXValue().
      Specified by:
      getXSampleCount in interface HeatMapDataset
      Returns:
      The number of x-values (always > 0).
    • getYSampleCount

      public int getYSampleCount()
      Returns the number of y values (or samples) for the dataset. The values are evenly spaced between getMinimumYValue() and getMaximumYValue().
      Specified by:
      getYSampleCount in interface HeatMapDataset
      Returns:
      The number of y-values (always > 0).
    • getMinimumXValue

      public double getMinimumXValue()
      Returns the lowest x-value represented in this dataset. A requirement of this interface is that this method must never return infinite or Double.NAN values.
      Specified by:
      getMinimumXValue in interface HeatMapDataset
      Returns:
      The lowest x-value represented in this dataset.
    • getMaximumXValue

      public double getMaximumXValue()
      Returns the highest x-value represented in this dataset. A requirement of this interface is that this method must never return infinite or Double.NAN values.
      Specified by:
      getMaximumXValue in interface HeatMapDataset
      Returns:
      The highest x-value represented in this dataset.
    • getMinimumYValue

      public double getMinimumYValue()
      Returns the lowest y-value represented in this dataset. A requirement of this interface is that this method must never return infinite or Double.NAN values.
      Specified by:
      getMinimumYValue in interface HeatMapDataset
      Returns:
      The lowest y-value represented in this dataset.
    • getMaximumYValue

      public double getMaximumYValue()
      Returns the highest y-value represented in this dataset. A requirement of this interface is that this method must never return infinite or Double.NAN values.
      Specified by:
      getMaximumYValue in interface HeatMapDataset
      Returns:
      The highest y-value represented in this dataset.
    • getXValue

      public double getXValue(int xIndex)
      A convenience method that returns the x-value for the given index.
      Specified by:
      getXValue in interface HeatMapDataset
      Parameters:
      xIndex - the xIndex.
      Returns:
      The x-value.
    • getYValue

      public double getYValue(int yIndex)
      A convenience method that returns the y-value for the given index.
      Specified by:
      getYValue in interface HeatMapDataset
      Parameters:
      yIndex - the yIndex.
      Returns:
      The y-value.
    • getZValue

      public double getZValue(int xIndex, int yIndex)
      Returns the z-value at the specified sample position in the dataset. For a missing or unknown value, this method should return Double.NAN.
      Specified by:
      getZValue in interface HeatMapDataset
      Parameters:
      xIndex - the position of the x sample in the dataset.
      yIndex - the position of the y sample in the dataset.
      Returns:
      The z-value.
    • getZ

      public Number getZ(int xIndex, int yIndex)
      Returns the z-value at the specified sample position in the dataset. In this implementation, where the underlying values are stored in an array of double primitives, you should avoid using this method and use getZValue(int, int) instead.
      Specified by:
      getZ in interface HeatMapDataset
      Parameters:
      xIndex - the position of the x sample in the dataset.
      yIndex - the position of the y sample in the dataset.
      Returns:
      The z-value.
    • setZValue

      public void setZValue(int xIndex, int yIndex, double z)
      Updates a z-value in the dataset and sends a DatasetChangeEvent to all registered listeners.
      Parameters:
      xIndex - the x-index.
      yIndex - the y-index.
      z - the new z-value.
    • setZValue

      public void setZValue(int xIndex, int yIndex, double z, boolean notify)
      Updates a z-value in the dataset and, if requested, sends a DatasetChangeEvent to all registered listeners.
      Parameters:
      xIndex - the x-index.
      yIndex - the y-index.
      z - the new z-value.
      notify - notify listeners?
    • equals

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

      public Object clone() throws CloneNotSupportedException
      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 a problem cloning.