Version

Radial Series

This topic explains the common properties for Radial Series in the UltraDataChart™ control.

Introduction

Radial Series is a group of series that takes data and render it as collection of data points wrapped around a circle (rather than stretching along a horizontal line as Category Series do). Just like Category Series, Radial Series are also mapping a list of categories from the minimum to the maximum of the extent of the chart, and support the same category grouping mechanisms of Category Series.

Types of Radial Series

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

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

Preview of Radial Series

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

xamDataChart Radial Series 01.png

Figure 1: Sample Radial Pie Series

xamDataChart Radial Series 02.png

Figure 2: Sample Radial Column Series

xamDataChart Radial Series 03.png

Figure 3: Sample Radial Line Series

xamDataChart Radial Series 04.png

Figure 4: Sample Radial Area Series

Similar Series

Every Radial Series have a rough Category Series equivalent. The following table shows an analogy between these types of series by mapping types of the Radial Series to types of Category Series.

Supported Axes

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

Series Type Radius Axis Type Angle Axis Type

RadialAreaSeries

RadialLineSeries

RadialColumnSeries

RadialPieSeries

Note
Note:

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

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

Data Binding

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

Data Requirements

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

  • The data model must contain at least one category data column which is mapped to the Label property of the CategoryAngleAxis

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

  • The data source must contain at least one data items otherwise the chart will not render the Radial 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 Sample Category Data which you can download and use it in your project.

Binding Diagrams

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

xamDataChart Radial Series 05 WinForms.png