2D Polar Diagram
- 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
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:
<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:
// Cast Diagram to the PolarDiagram2D type.
PolarDiagram2D diagram = chart.Diagram as PolarDiagram2D;
if (diagram != null) {
// Access the diagram's options.
diagram.ShapeStyle = CircularDiagramShapeStyle.Polygon;
}