# Uses of Interface
org.jfree.chart3d.data.xyz.XYZDataset

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

## Uses of XYZDataset in org.jfree.chart3d

Methods in org.jfree.chart3d with parameters of type XYZDataset
Modifier and Type
Method
Description
`static Chart3D`
Chart3DFactory.`createScatterChart(String title, String subtitle, XYZDataset dataset, String xAxisLabel, String yAxisLabel, 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(String title, String subtitle, XYZDataset dataset, String xAxisLabel, String yAxisLabel, 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(String title, String subtitle, XYZDataset dataset, String xAxisLabel, String yAxisLabel, String zAxisLabel)`
Creates and returns a line chart based on the supplied dataset.

## Uses of XYZDataset in org.jfree.chart3d.data

Methods in org.jfree.chart3d.data that return XYZDataset
Modifier and Type
Method
Description
`static <S extends Comparable<S>, R extends Comparable<R>, C extends Comparable<C>>
XYZDataset<S>`
DataUtils.`extractXYZDatasetFromColumns(KeyedValues3D<S,R,C,? extends Number> source, C xColKey, C yColKey, C 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 <S extends Comparable<S>, R extends Comparable<R>, C extends Comparable<C>>
XYZDataset<S>`
DataUtils.`extractXYZDatasetFromColumns(KeyedValues3D<S,R,C,? extends Number> source, C xColKey, C yColKey, C zColKey, NullConversion nullConversion, List<KeyedValues3DItemKey> exceptions)`
Creates an `XYZDataset` by extracting values from specified columns in a `KeyedValues3D` instance.
`static <S extends Comparable<S>, R extends Comparable<R>, C extends Comparable<C>>
XYZDataset`
DataUtils.`extractXYZDatasetFromRows(KeyedValues3D<S,R,C,? extends Number> source, R xRowKey, R yRowKey, R 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 <S extends Comparable<S>, R extends Comparable<R>, C extends Comparable<C>>
XYZDataset`
DataUtils.`extractXYZDatasetFromRows(KeyedValues3D<S,R,C,? extends Number> source, R xRowKey, R yRowKey, R zRowKey, NullConversion nullConversion, List<KeyedValues3DItemKey> exceptions)`
Creates an `XYZDataset` by extracting values from specified rows in a `KeyedValues3D` instance.
`static XYZDataset<String>`
JSONUtils.`readXYZDataset(Reader reader)`
Parses character data from the reader and (if possible) creates an {XYZDataset} instance that represents the data.
`static XYZDataset<String>`
JSONUtils.`readXYZDataset(String json)`
Parses the string and (if possible) creates an {XYZDataset} instance that represents the data.
Methods in org.jfree.chart3d.data with parameters of type XYZDataset
Modifier and Type
Method
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 <S extends Comparable<S>>
double`
DataUtils.`total(XYZDataset<S> data, S seriesKey)`
Returns the total of the non-`NaN` entries in the dataset for the specified series.
`static String`
JSONUtils.`writeXYZDataset(XYZDataset dataset)`
Returns a string containing the dataset in JSON format.
`static void`
JSONUtils.`writeXYZDataset(XYZDataset dataset, Writer writer)`
Writes the dataset in JSON format to the supplied writer.

## Uses of XYZDataset in org.jfree.chart3d.data.xyz

Classes in org.jfree.chart3d.data.xyz that implement XYZDataset
Modifier and Type
Class
Description
`class`
`XYZSeriesCollection<S extends Comparable<S>>`
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 org.jfree.chart3d.data.xyz that return XYZDataset
Modifier and Type
Method
Description
`static XYZDataset<String>`
XYZDatasetUtils.`sampleFunction(Function3D f, 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<String>`
XYZDatasetUtils.`sampleFunction(Function3D f, String key, Range xrange, double xcount, Range zrange, double zcount)`
Creates an `XYZDataset` by sampling a `Function3D` over a specified range.
Methods in org.jfree.chart3d.data.xyz with parameters of type XYZDataset
Modifier and Type
Method
Description
`static <S extends Comparable<S>>
Collection<XYZItemKey<S>>`
XYZItemKeys.`itemKeysForSeries(XYZDataset<S> dataset, S seriesKey)`
Returns a collection of item keys extracted from one series in the specified dataset.

## Uses of XYZDataset in org.jfree.chart3d.label

Methods in org.jfree.chart3d.label with parameters of type XYZDataset
Modifier and Type
Method
Description
`String`
StandardXYZItemLabelGenerator.`generateItemLabel(XYZDataset dataset, Comparable<?> seriesKey, int itemIndex)`
Generates a label for the specified data item.
`String`
XYZItemLabelGenerator.`generateItemLabel(XYZDataset dataset, Comparable<?> seriesKey, int itemIndex)`
Generates an item label for one data item in an `XYZDataset`.
`<S extends Comparable<S>>
String`
StandardXYZLabelGenerator.`generateSeriesLabel(XYZDataset<S> dataset, S seriesKey)`
Generates a series label.
`<S extends Comparable<S>>
String`
XYZLabelGenerator.`generateSeriesLabel(XYZDataset<S> dataset, S seriesKey)`
Generates a label for one series in a `XYZDataset`.

## Uses of XYZDataset in org.jfree.chart3d.plot

Methods in org.jfree.chart3d.plot that return XYZDataset
Modifier and Type
Method
Description
`XYZDataset`
XYZPlot.`getDataset()`
Returns the dataset for the plot.
Methods in org.jfree.chart3d.plot with parameters of type XYZDataset
Modifier and Type
Method
Description
`void`
XYZPlot.`setDataset(XYZDataset dataset)`
Sets the dataset and sends a change event notification to all registered listeners.
Constructors in org.jfree.chart3d.plot with parameters of type XYZDataset
Modifier
Constructor
Description
``
`XYZPlot(XYZDataset dataset, XYZRenderer renderer, ValueAxis3D xAxis, ValueAxis3D yAxis, ValueAxis3D zAxis)`
Creates a new plot with the specified axes.

## Uses of XYZDataset in org.jfree.chart3d.renderer.xyz

Methods in org.jfree.chart3d.renderer.xyz with parameters of type XYZDataset
Modifier and Type
Method
Description
`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.
`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`
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`
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`
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.
`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`
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`
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`
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`
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`
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`
SurfaceRenderer.`findYRange(XYZDataset dataset)`
Returns the range that the renderer requires on the y-axis to display all the data in the function.
`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`
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.
`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`
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`
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.