Version

Polar Series

This topic provides conceptual information to all types of Polar Series in the UltraDataChart™ control.

Introduction

In the UltraDataChart control, Polar Series is a group of series that use the polar (angle, radius) coordinate system instead of the Cartesian (x, y) coordinate system to plot data in chart. In other words, Polar Series take concepts of Scatter Series and wrap them around a circle rather than stretching along a horizontal line. This group of series is used to show the relationship among the items in several distinct series of data using the polar coordinates system.

Polar Series draw attention to uneven intervals or clusters of data. They are often used to plot scientific data (e.g. wind direction and speed, direction, and strength of magnetic field, location of objects in solar system), and can highlight the deviation of collected data from predicted results.

Types of Polar Series

The UltraDataChart control supports the following types of Polar Series and each of them is discussed in an individual topic:

Refer to above topics to learn how to create a specific type of Polar Series and bind data to it.

Preview of Polar Series

This section provides preview images for all types of Polar Series.

xamDataChart Polar Series 01.png

Figure 1: Sample Polar Area Series

xamDataChart Polar Series 02.png

Figure 2: Sample Polar Line Series

xamDataChart Polar Series 03.png

Figure 3: Sample Polar Scatter Series

xamDataChart Polar Series 04.png

Figure 4: Sample Polar Spline Series

xamDataChart Polar Series 05.png

Figure 5: Sample Polar Spline Area Series

Similar Series

Some Polar Series have a rough equivalent to Scatter Series. The following table shows an analogy between these types of series by mapping types of the Polar Series to types of Scatter Series.

Supported Axes

The UltraDataChart control provides various types of axes but only two types of axes can be used with all types of Polar Series. The following table lists these supported axes:

Series Type Radius Axis Type Angle Axis Type

PolarAreaSeries

PolarLineSeries

PolarScatterSeries

PolarSplineAreaSeries

PolarSplineSeries

Note
Note:

Polar Series do not support CategoryAngleAxis type. Refer to Radial Series topic if you want to use NumericRadiusAxis with CategoryAngleAxis to plot one numeric data columns.

In addition, each of Polar Series must have binding set to one angle axis using the AngleAxis property and one radius axis using the RadiusAxis property. For more information on axes refer to these topics:

Coordinate System

In polar coordinate systems, the location of data points is determined by an angle (angular coordinate) from a fixed direction and distance (radial coordinate) from a fixed point (analogous to the origin of a Cartesian coordinate) which is called "the pole". The lines that start from the pole and point outwards are gridlines of the angular axis (NumericAngleAxis) and the concentric rings that surround the pole are gridlines of the radius axis (NumericRadiusAxis). For more information on how to use axes with Polar Series, refer to the Chart Axes topic.

Figure 6 shows PolarScatterSeries with four data points at various locations in polar coordinate system:

  • the blue point is located at the center of the polar chart (0,0 is the pole in the polar coordinate system)

  • the red point has a radial coordinate of 120 and angular coordinate of 90 (120, 90)

  • the green point has a radial coordinate of 80 and angular coordinate of 60 (80, 60)

  • the orange point has a radial coordinate of 160 and angular coordinate of 150 (160, 150)

xamDataChart Polar Series 06.png

Figure 6: Schematic representation of data plotting in polar coordinate system in the UltraDataChart control

Data Binding

This section provides information about binding data for all types of Polar Series from data requirements through data sample to binding diagrams.

Data Requirements

Similarly to other types of series in the UltraDataChart control, Polar Series also use DataSource property to bind data. The following is a list of data requirements for Polar Series:

  • The data model must contain at least one numeric data column (e.g. Angle) which is mapped using the AngleMemberPath property of Polar series (e.g. PolarLineSeries)

  • The data model must contain at least second numeric data column (e.g. Radius) which is mapped using the RadiusMemberPath property of Polar series (e.g. PolarLineSeries)

  • The data source must contain at least one data items otherwise the chart will not render the Polar series.

  • The data source must implement the IEnumerable interface (e.g. List, Collection, Queue, or Stack)

For more information on the requirements for the specific types of series, refer to the Series Requirements topic.

Data Sample

An example of object that meets above criteria is the PolarDataSource which you can download and use it in your project.

Binding Diagram

The following figure shows how binding data to Polar Series works in the UltraDataChart control.

xamDataChart Polar Series 07 WinForms.png