2D Polar Diagram

May 28, 2021
3 minutes to read

A 2D Polar Diagram is a diagram in which each point is represented using an angle and the distance from a coordinate origin.

The document consists of the following sections:

Compatible Series Types
How to Create a Chart with a Polar Diagram

Compatible Series Types

The Polar Diagram diagram can only contain the following compatible series types:

Refer to the Series Type Compatibility document to learn more about series compatibility.

How to Create a Chart with a Polar Diagram

The Polar diagram’s circular x-axis shows arguments from 0 to 360 degrees. This axis is available using the PolarDiagram2D.AxisX property.

Note

Note that polar diagram axes do not support additional elements such as constant lines, axis titles and strips.

The following markup demonstrates how to create a chart with the Polar diagram:

XAML

xaml

<dxc:ChartControl>
    <!-- Polar diagram's settings. -->
    <dxc:PolarDiagram2D RotationDirection="Counterclockwise" 
                        ShapeStyle="Polygon" 
                        DomainBrush="AliceBlue"
                        DomainBorderBrush="AliceBlue"
                        StartAngle="180"
                        LabelsResolveOverlappingMinIndent="5">
        <!-- X-axis settings. --> 
        <dxc:PolarDiagram2D.AxisX>
            <dxc:PolarAxisX2D/>
        </dxc:PolarDiagram2D.AxisX>
        <!-- Y-axis settings. -->
        <dxc:PolarDiagram2D.AxisY>
            <dxc:PolarAxisY2D/>
        </dxc:PolarDiagram2D.AxisY>
        <!-- Polar Line series settings. -->
        <dxc:PolarLineSeries2D DisplayName="Taubin's Heart">
           <dxc:SeriesPoint Argument="0" Value="2.0"/>          
           <dxc:SeriesPoint Argument="30" Value="1.24"/>
           <dxc:SeriesPoint Argument="90" Value="0"/>
           <dxc:SeriesPoint Argument="150" Value="1.24"/>
           <dxc:SeriesPoint Argument="180" Value="2.0"/>
           <dxc:SeriesPoint Argument="210" Value="2.48"/>
           <dxc:SeriesPoint Argument="270" Value="4.0"/>
           <dxc:SeriesPoint Argument="330" Value="2.48"/>
           <dxc:SeriesPoint Argument="360" Value="2.0"/>
        </dxc:PolarLineSeries2D>
    </dxc:PolarDiagram2D>
</dxc:ChartControl>

The following table lists classes and properties the markup uses:

Class or Property	Description
ChartControl	The Chart control.
PolarDiagram2D	The 2D Polar diagram.
CircularDiagram2D.RotationDirection	Specifies the direction in which the diagram’s argument axis is drawn.
CircularDiagram2D.ShapeStyle	Specifies the diagram’s shape style.
CircularDiagram2D.DomainBrush	Specifies the brush used to draw the diagram’s area.
CircularDiagram2D.DomainBorderBrush	Specifies the brush used to draw the diagram’s area border.
CircularDiagram2D.StartAngle	Specifies an angle that defines the x-axis coordinates’ origin position and y-axis deflection.
CircularDiagram2D.LabelsResolveOverlappingMinIndent	Specifies the minimum gap between two adjacent series point labels.
PolarDiagram2D.AxisX	Gets or sets the x-axis settings.
PolarAxisX2D	The polar diagram’s circular axis of arguments.
PolarDiagram2D.AxisY	Gets or sets the y-axis settings.
PolarAxisY2D	The polar diagram’s circular axis of values.
PolarLineSeries2D	The polar line series.
Series.DisplayName	Specifies a series display name.
SeriesPoint	A series point.
SeriesPoint.Argument	Specifies the series point’s argument.
SeriesPoint.Value	Specifies the series point’s value.

Refer to the code below to access the Polar diagram’s settings at runtime:

C#
VB.NET

csharp

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

' Cast Diagram to the PolarDiagram2D type. 
Dim diagram As PolarDiagram2D = TryCast(chart.Diagram, PolarDiagram2D)
If diagram IsNot Nothing Then
    ' Access the diagram's options. 
    diagram.ShapeStyle = CircularDiagramShapeStyle.Polygon
End If