Cartesian Chart

In This Topic

The Cartesian chart displays data in a Cartesian coordinate sytem. NOV Chart for .NET supports 2D and 3D Cartesian charts. In a 2D Cartesian coordinate system two X and Y axes form a plot where data is plotted using the data point's X and Y values. Similarly in a 3D Cartesian Coordinate System a set of X, Y and Depth axis form a 3D plot. You create a Cartesian chart by creating an instance of the NCartesianChart class. The following example shows how to create a simple 2D bar chart:

C#	Copy Code
// create a dock panel with label and chart NDockPanel dockPanel = new NDockPanel(); chartView.Surface.Content = dockPanel; // create a docked label NLabel label = new NLabel(); label.Text = "My First Cartesian Chart"; label.Margins = new NMargins(10); label.Font = new NFont(NFontDescriptor.DefaultSansFamilyName, 12); label.TextFill = new NColorFill(NColor.Black); label.TextAlignment = ENContentAlignment.MiddleCenter; NDockLayout.SetDockArea(label, ENDockArea.Top); dockPanel.AddChild(label); // create a new Cartesian chart NCartesianChart CartesianChart = new NCartesianChart(); CartesianChart.Margins = new NMargins(10); NDockLayout.SetDockArea(CartesianChart, ENDockArea.Center); dockPanel.AddChild(CartesianChart); CartesianChart.SetPredefinedCartesianAxes(ENPredefinedCartesianAxis.XOrdinalYLinear); // create a bar series NBarSeries bar = new NBarSeries(); bar.DataPoints.Add(new NBarDataPoint(10)); bar.DataPoints.Add(new NBarDataPoint(20)); bar.DataPoints.Add(new NBarDataPoint(30)); CartesianChart.Series.Add(bar);

Copy Code

// create a dock panel with label and chart

NDockPanel dockPanel = new NDockPanel();

chartView.Surface.Content = dockPanel;

// create a docked label

NLabel label = new NLabel();

label.Text = "My First Cartesian Chart";

label.Margins = new NMargins(10);

label.Font = new NFont(NFontDescriptor.DefaultSansFamilyName, 12);

label.TextFill = new NColorFill(NColor.Black);

label.TextAlignment = ENContentAlignment.MiddleCenter;

NDockLayout.SetDockArea(label, ENDockArea.Top);

dockPanel.AddChild(label);

// create a new Cartesian chart

NCartesianChart CartesianChart = new NCartesianChart();

CartesianChart.Margins = new NMargins(10);

NDockLayout.SetDockArea(CartesianChart, ENDockArea.Center);

dockPanel.AddChild(CartesianChart);

CartesianChart.SetPredefinedCartesianAxes(ENPredefinedCartesianAxis.XOrdinalYLinear);

// create a bar series

NBarSeries bar = new NBarSeries();

bar.DataPoints.Add(new NBarDataPoint(10));

bar.DataPoints.Add(new NBarDataPoint(20));

bar.DataPoints.Add(new NBarDataPoint(30));

CartesianChart.Series.Add(bar);

Note that in the above example we used SetPredefinedCartesianAxes method to quickly setup the axes of the chart. The following table shows the available options of this method:

ENPredefinedCartesianAxis	Description
Standard	Standard configuration using a pair of two Y axes in numeric mode, two X axes in ordinal and one depth ordinal axis.
XOrdinalYLinear	Represents a Cartesian chart with two axes where the horizontal axis is ordinal and the vertical one is numeric (linear).
XDateTimeYLinear	Represents a Cartesian chart with two axes where the horizontal axis is date time and the vertical one is numeric (linear).
XValueTimelineYLinear	Represents a Cartesian chart with two axes where the horizontal axis is a date time value timeline axis and the vertical one is numeric (linear).
XRangeTimelineYLinear	Represents a Cartesian chart with two axes where the horizontal axis is a date time range timeline axis and the vertical one is numeric (linear).
XYLinear	Represents a Cartesian chart with two xy numeric axes.
PrimaryAndSecondaryLinear	Represents a Cartesian chart with four axes - two horizontal and two vertical docked at the sides of the chart plot. All axes are numeric.
XYZLinear	Represents a Cartesian chart with three numeric (linear) axes of a standard 3D Cartesian coordinate system.
XYZLinear	Represents a Cartesian chart with three numeric (linear) axes of a standard 3D Cartesian coordinate system.
YLinearXZOrdinal	Represents a Cartesian chart with three axes of a standard 3D cartesian coordinate system with Y numeric (linear) axis and XZ ordinal axes.

By default the chart is configured to use a standard set of five axes - two Y axes in linear mode (Primary Y and Secondary Y), two X axes in ordinal mode (Primary X and Secondary X) and a one Depth axis in ordinal mode.