## Uses of Interface
com.orsoncharts.data.xyz.XYZDataset

- Packages that use XYZDataset
  Package | Description
  --- | ---
  com.orsoncharts | Core classes, including `Chart3D`, `Chart3DPanel` and `Chart3DFactory`.
  com.orsoncharts.data | Core data structures used as the building blocks for datasets in Orson Charts.
  com.orsoncharts.data.xyz | Datasets that can be used by the `XYZPlot` class.
  com.orsoncharts.label | Classes related to chart labels.
  com.orsoncharts.plot | Standard plot types (`PiePlot3D`, `CategoryPlot3D` and `XYZPlot`) that can be used with the `Chart3D` class.
  com.orsoncharts.renderer.xyz | Renderers that can be used with the `XYZPlot` class.

- - ### Uses of XYZDataset in com.orsoncharts

    Methods in com.orsoncharts with parameters of type XYZDataset
    Modifier and Type | Method and Description
    --- | ---
    `static Chart3D` | Chart3DFactory.`createScatterChart(java.lang.String title, java.lang.String subtitle, XYZDataset dataset, java.lang.String xAxisLabel, java.lang.String yAxisLabel, java.lang.String zAxisLabel)` Creates and returns a scatter plot based on the supplied dataset (containing one or more series of `(x, y, z)` values).
    `static Chart3D` | Chart3DFactory.`createXYZBarChart(java.lang.String title, java.lang.String subtitle, XYZDataset dataset, java.lang.String xAxisLabel, java.lang.String yAxisLabel, java.lang.String zAxisLabel)` Creates and returns a bar chart based on the supplied dataset (this is for special cases, most general cases will be covered by the `Chart3DFactory.createBarChart(String, String, CategoryDataset3D, String, String, String)` method).
    `static Chart3D` | Chart3DFactory.`createXYZLineChart(java.lang.String title, java.lang.String subtitle, XYZDataset dataset, java.lang.String xAxisLabel, java.lang.String yAxisLabel, java.lang.String zAxisLabel)` Creates and returns a line chart based on the supplied dataset.

  - ### Uses of XYZDataset in com.orsoncharts.data

    Methods in com.orsoncharts.data that return XYZDataset
    Modifier and Type | Method and Description
    --- | ---
    `static XYZDataset` | DataUtils.`extractXYZDatasetFromColumns(KeyedValues3D<? extends java.lang.Number> source, java.lang.Comparable<?> xColKey, java.lang.Comparable<?> yColKey, java.lang.Comparable<?> zColKey)` Creates an `XYZDataset` by extracting values from specified columns in a `KeyedValues3D` instance, across all the available rows (items where any of the x, y or z values is `null` are skipped).
    `static XYZDataset` | DataUtils.`extractXYZDatasetFromColumns(KeyedValues3D<? extends java.lang.Number> source, java.lang.Comparable<?> xColKey, java.lang.Comparable<?> yColKey, java.lang.Comparable<?> zColKey, NullConversion nullConversion, java.util.List<KeyedValues3DItemKey> exceptions)` Creates an `XYZDataset` by extracting values from specified columns in a `KeyedValues3D` instance.
    `static XYZDataset` | DataUtils.`extractXYZDatasetFromRows(KeyedValues3D<? extends java.lang.Number> source, java.lang.Comparable<?> xRowKey, java.lang.Comparable<?> yRowKey, java.lang.Comparable<?> zRowKey)` Creates an `XYZDataset` by extracting values from specified rows in a `KeyedValues3D` instance, across all the available columns (items where any of the x, y or z values is `null` are skipped).
    `static XYZDataset` | DataUtils.`extractXYZDatasetFromRows(KeyedValues3D<? extends java.lang.Number> source, java.lang.Comparable<?> xRowKey, java.lang.Comparable<?> yRowKey, java.lang.Comparable<?> zRowKey, NullConversion nullConversion, java.util.List<KeyedValues3DItemKey> exceptions)` Creates an `XYZDataset` by extracting values from specified rows in a `KeyedValues3D` instance.
    `static XYZDataset` | JSONUtils.`readXYZDataset(java.io.Reader reader)` Parses character data from the reader and (if possible) creates an {XYZDataset} instance that represents the data.
    `static XYZDataset` | JSONUtils.`readXYZDataset(java.lang.String json)` Parses the string and (if possible) creates an {XYZDataset} instance that represents the data.

    Methods in com.orsoncharts.data with parameters of type XYZDataset
    Modifier and Type | Method and Description
    --- | ---
    `static Range` | DataUtils.`findXRange(XYZDataset dataset)` Returns the range of x-values in the dataset by iterating over all values (and ignoring `Double.NaN` and infinite values).
    `static Range` | DataUtils.`findXRange(XYZDataset dataset, double inc)` Returns the range of x-values in the dataset by iterating over all values (and ignoring `Double.NaN` values).
    `static Range` | DataUtils.`findXRange(XYZDataset dataset, double inc, boolean finite)` Returns the range of x-values in the dataset by iterating over all values (and ignoring `Double.NaN` values).
    `static Range` | DataUtils.`findYRange(XYZDataset dataset)` Returns the range of y-values in the dataset by iterating over all values (and ignoring `Double.NaN` and infinite values).
    `static Range` | DataUtils.`findYRange(XYZDataset dataset, double inc)` Returns the range of y-values in the dataset by iterating over all values (and ignoring `Double.NaN` values).
    `static Range` | DataUtils.`findYRange(XYZDataset dataset, double inc, boolean finite)` Returns the range of y-values in the dataset by iterating over all values (and ignoring `Double.NaN` values).
    `static Range` | DataUtils.`findZRange(XYZDataset dataset)` Returns the range of z-values in the dataset by iterating over all values (and ignoring `Double.NaN` and infinite values).
    `static Range` | DataUtils.`findZRange(XYZDataset dataset, double inc)` Returns the range of z-values in the dataset by iterating over all values (and ignoring `Double.NaN` values).
    `static Range` | DataUtils.`findZRange(XYZDataset dataset, double inc, boolean finite)` Returns the range of z-values in the dataset by iterating over all values (and ignoring `Double.NaN` values).
    `static double` | DataUtils.`total(XYZDataset data, java.lang.Comparable<?> seriesKey)` Returns the total of the non-`NaN` entries in the dataset for the specified series.
    `static java.lang.String` | JSONUtils.`writeXYZDataset(XYZDataset dataset)` Returns a string containing the dataset in JSON format.
    `static void` | JSONUtils.`writeXYZDataset(XYZDataset dataset, java.io.Writer writer)` Writes the dataset in JSON format to the supplied writer.

  - ### Uses of XYZDataset in com.orsoncharts.data.xyz

    Classes in com.orsoncharts.data.xyz that implement XYZDataset
    Modifier and Type | Class and Description
    --- | ---
    `class` | `XYZSeriesCollection` A collection of `XYZSeries` objects (implements the `XYZDataset` interface so that it can be used as a source of data for an `XYZRenderer` on an `XYZPlot`).

    Methods in com.orsoncharts.data.xyz that return XYZDataset
    Modifier and Type | Method and Description
    --- | ---
    `static XYZDataset` | XYZDatasetUtils.`sampleFunction(Function3D f, java.lang.String key, double xmin, double xmax, double xcount, double zmin, double zmax, double zcount)` Creates an `XYZDataset` by sampling a `Function3D` over a specified range.
    `static XYZDataset` | XYZDatasetUtils.`sampleFunction(Function3D f, java.lang.String key, Range xrange, double xcount, Range zrange, double zcount)` Creates an `XYZDataset` by sampling a `Function3D` over a specified range.

    Methods in com.orsoncharts.data.xyz with parameters of type XYZDataset
    Modifier and Type | Method and Description
    --- | ---
    `static java.util.Collection<XYZItemKey>` | XYZItemKeys.`itemKeysForSeries(XYZDataset dataset, java.lang.Comparable<?> seriesKey)` Returns a collection of item keys extracted from one series in the specified dataset.

  - ### Uses of XYZDataset in com.orsoncharts.label

    Methods in com.orsoncharts.label with parameters of type XYZDataset
    Modifier and Type | Method and Description
    --- | ---
    `java.lang.String` | XYZItemLabelGenerator.`generateItemLabel(XYZDataset dataset, java.lang.Comparable<?> seriesKey, int itemIndex)` Generates an item label for one data item in an `XYZDataset`.
    `java.lang.String` | StandardXYZItemLabelGenerator.`generateItemLabel(XYZDataset dataset, java.lang.Comparable<?> seriesKey, int itemIndex)` Generates a label for the specified data item.
    `java.lang.String` | XYZLabelGenerator.`generateSeriesLabel(XYZDataset dataset, java.lang.Comparable<?> seriesKey)` Generates a label for one series in a `XYZDataset`.
    `java.lang.String` | StandardXYZLabelGenerator.`generateSeriesLabel(XYZDataset dataset, java.lang.Comparable<?> seriesKey)` Generates a series label.

  - ### Uses of XYZDataset in com.orsoncharts.plot

    Methods in com.orsoncharts.plot that return XYZDataset
    Modifier and Type | Method and Description
    --- | ---
    `XYZDataset` | XYZPlot.`getDataset()` Returns the dataset for the plot.

    Methods in com.orsoncharts.plot with parameters of type XYZDataset
    Modifier and Type | Method and Description
    --- | ---
    `void` | XYZPlot.`setDataset(XYZDataset dataset)` Sets the dataset and sends a change event notification to all registered listeners.

    Constructors in com.orsoncharts.plot with parameters of type XYZDataset
    Constructor and Description
    `XYZPlot(XYZDataset dataset, XYZRenderer renderer, ValueAxis3D xAxis, ValueAxis3D yAxis, ValueAxis3D zAxis)` Creates a new plot with the specified axes.

  - ### Uses of XYZDataset in com.orsoncharts.renderer.xyz

    Methods in com.orsoncharts.renderer.xyz with parameters of type XYZDataset
    Modifier and Type | Method and Description
    --- | ---
    `void` | XYZRenderer.`composeItem(XYZDataset dataset, int series, int item, World world, Dimension3D dimensions, double xOffset, double yOffset, double zOffset)` Constructs and places one item from the specified dataset into the given world.
    `void` | SurfaceRenderer.`composeItem(XYZDataset dataset, int series, int item, World world, Dimension3D dimensions, double xOffset, double yOffset, double zOffset)` Throws an `UnsupportedOperationException` because this renderer does not support per-item rendering.
    `void` | ScatterXYZRenderer.`composeItem(XYZDataset dataset, int series, int item, World world, Dimension3D dimensions, double xOffset, double yOffset, double zOffset)` Constructs and places one item from the specified dataset into the given world.
    `void` | LineXYZRenderer.`composeItem(XYZDataset dataset, int series, int item, World world, Dimension3D dimensions, double xOffset, double yOffset, double zOffset)` Adds a single line representing one item from the dataset.
    `void` | BarXYZRenderer.`composeItem(XYZDataset dataset, int series, int item, World world, Dimension3D dimensions, double xOffset, double yOffset, double zOffset)` Adds a single bar representing one item from the dataset.
    `Range` | XYZRenderer.`findXRange(XYZDataset dataset)` Returns the range that should be set on the x-axis in order for this renderer to be able to display all the data in the supplied dataset.
    `Range` | SurfaceRenderer.`findXRange(XYZDataset dataset)` Returns the current range for the x-axis - the method is overridden because this renderer does not use a dataset (it samples and plots a function directly).
    `Range` | BarXYZRenderer.`findXRange(XYZDataset dataset)` Returns the range that needs to be set on the x-axis in order for this renderer to be able to display all the data in the supplied dataset.
    `Range` | AbstractXYZRenderer.`findXRange(XYZDataset dataset)` Returns the range that is required on the x-axis for this renderer to display all the items in the specified dataset.
    `Range` | XYZRenderer.`findYRange(XYZDataset dataset)` Returns the range that should be set on the y-axis in order for this renderer to be able to display all the data in the supplied dataset.
    `Range` | SurfaceRenderer.`findYRange(XYZDataset dataset)` Returns the range that the renderer requires on the y-axis to display all the data in the function.
    `Range` | BarXYZRenderer.`findYRange(XYZDataset dataset)` Returns the range to use for the y-axis to ensure that all data values are visible on the chart.
    `Range` | AbstractXYZRenderer.`findYRange(XYZDataset dataset)` Returns the range that is required on the y-axis for this renderer to display all the items in the specified dataset.
    `Range` | XYZRenderer.`findZRange(XYZDataset dataset)` Returns the range that should be set on the z-axis in order for this renderer to be able to display all the data in the supplied dataset.
    `Range` | SurfaceRenderer.`findZRange(XYZDataset dataset)` Returns the current range for the z-axis - the method is overridden because this renderer does not use a dataset (it samples and plots a function directly).
    `Range` | BarXYZRenderer.`findZRange(XYZDataset dataset)` Returns the range to use for the z-axis to ensure that all data values are visible on the chart.
    `Range` | AbstractXYZRenderer.`findZRange(XYZDataset dataset)` Returns the range that is required on the z-axis for this renderer to display all the items in the specified dataset.