XYZ Scatter Series Functionality

In This Topic

The NXYZScatterSeries class is the base class of all series that provide XYZ scatter functionality. It is derived from the NXYScatterSeries class and extends its capabilities with the following features:

Z Values Data Series

The ZValues data series contains double values that determine the positions of the data points along the Z axis. This data series is accessible through the ZValues property of the NXYZScatterSeries object.

Control over the usage of the Z Values

The UseZValues property of the NXYZScatterSeries object controls whether the series will use the custom Z positions or use the default ones (equal to the data point index e.g. 0, 1, 2 ... n). By default this property is set to false. The following code will enable the custom Z positions of the data points:

C#	Copy Code
series.UseZValues = true;

Visual Basic	Copy Code
series.UseZValues = True

Formatting Commands

The NXYZScatterSeries class extends the formatting commands set inherited from the NXYScatterSeries base class with the following formatting commands:

<zvalue> - the current data point Z value (extracted from the ZValues data series)

Notes on scaling

The Z values affect the scale of the Z axis. All series are scaled on the Z axis, which by default operates in Ordinal scale mode. If you display XYZ scatter charts it is recommended that you change the scaling mode to Numeric, DateTime or Logarithmic. The following code demonstrates how to do this:

C#	Copy Code
NChart chart = chartControl.Charts[0]; chart.Axis(StandardAxis.Depth).ScaleConfigurator = new NLinearScaleConfigurator();

Visual Basic	Copy Code
Dim chart As NChart = chartControl.Charts(0) chart.Axis(StandardAxis.Depth).ScaleConfigurator = New NLinearScaleConfigurator

Please refer to the Axis scaling topic for more information.