Chart for .NET / User's Guide / Chart Types / XYZ Scatter Series Functionality

XYZ Scatter Series Functionality
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.

See Also