Radar and Polar Diagrams

  • 4 minutes to read

This document details the specifics of the Radar and Polar diagram types. It lists the series view types associated with this diagram type, demonstrates how its specific options can be accessed (both at design and runtime), and briefly describes these options. Before reading this text, you may wish to review the basics of using diagram in XtraCharts.

This document consists of the following sections.

Associated Series View Types

The Radar and Polar diagrams are used to plot Radar and Polar series.

The series of Radar view types (also called Spider or Star charts) are used to display data as a circular graph. A Radar view is drawn on a circular grid, and has multiple axes along which data can be plotted. A typical example of Radar diagram is shown in the following image.

RadarDiagramSample

Polar view types are similar to Radar views, but display values on the basis of angles (from 0 to 360 degrees). A typical Polar diagram is shown in the following image.

PolarDiagramSample

Below is the list of all available radar and polar series view types.

Note that although these charts normally have a circular shape, they can also be displayed as a polygons.

Accessing a Diagram

To access the options of a radar or polar diagram at design time, click your chart, to select it. Then, in the Properties window, expand the ChartControl.Diagram property.

RadarDiagram_1

At runtime, cast your instance of the Diagram object to the RadarDiagram (or PolarDiagram) type.


// Cast Diagram to the PolarDiagram type.
PolarDiagram diagram = chart.Diagram as PolarDiagram;
if (diagram != null) {
    // Access the diagram's options.
    diagram.DrawingStyle = RadarDiagramDrawingStyle.Polygon;
}

Specific Options

The PolarDiagram class is derived from the RadarDiagram class, and its set of properties is identical to the properties of the Radar diagram. For this reason, in this example the available options are demonstrated for the Radar diagram. They are briefly described below. For the more detailed information about them, refer to these properties' descriptions.

The RadarDiagram.AxisX and the RadarDiagram.AxisY properties provide access to the radar diagram's axes options. Note that there are unique implementation elements for axes of this diagram type, compared with regular axes. In particular, the axis of arguments (X-axis) corresponds to the circular grid onto which Radar series are plotted. You can select this axis by clicking its labels. For more information, refer to Axes.

RadarAxes

The RadarDiagram.DrawingStyle property determines the shape style of a grid used to plot a Radar chart (RadarDiagramDrawingStyle.Circle or RadarDiagramDrawingStyle.Polygon). The following images demonstrate this property in action.

The property value The resulting image
DrawingStyle = Circle DrawingStyle_Circle
DrawingStyle = Polygon DrawingStyle_Polygon

The RadarDiagram.RotationDirection property determines the direction in which the diagram's X-axis should display the arguments (clockwise or counterclockwise). The following images demonstrate this property in action.

The property value The resulting image
RotationDirection = Clockwise RotationDirection_clockwise
RotationDirection = Counterclockwise RotationDirection_counter

The RadarDiagram.StartAngleInDegrees property determines the angle for the diagram's X-axis to start drawing. The following images demonstrate this property in action.

The property value The resulting image
StartAngleInDegrees = 0 RotationDirection_clockwise
StartAngleInDegrees = 30 StartAngleInDegrees_30

Other diagram properties control its appearance in the following ways.

See Also