Bunifu Polar Chart

Overview
Bunifu Polar Chart is a chart component that displays two-dimensional (2D) circular layout chart data in polar coordinates, comprising of several equal-angled segments. What varies is the segment's radius which varies depending on the value it has been set. It is helpful in presenting scales that facilitate comparison between several quantitative aspects of a situation. The example below illustrates how Bunifu Polar Chart has been beautifully crafted to display the app's data.
Getting started
Getting Started with Design View
This section explains the steps required to start creating a simple polar chart and demonstrates the primary usage of the chart control.
Step 1: Drag the canvas control to the form from the toolbox.
Step 2: Access the canvas label property and add the following values in the collection editor.
Step 3: In the property section, set ShowXAxis, ShowYAxis, XAxesGridLines and YAxesGridlines properties to have a false value.
Step 4: Add BunifuPolarChart component to the form by dragging it from the controls' toolbox panel.
Step 5: To begin, go to the label property of the polar chart and set it to, for example, Share of State tax collection.
Step 6: On the target property of the Polar component, select bunifuCanvas1 as the target component.
Step 6: Access BunifuPolarChart's Data property and populate the collection editor with the following values:
Step 8: Set a list of colors in the BackgroundColor/colors property to specify the back color for each sector in the pie chart. For instance, the following is a list of colors assigned to the sectors in the color collection editor.
Copy each of the following R.G.B color sets to the color editor:
1.
128, 255, 0
2.
0, 255, 0
3.
0, 255, 128
4.
0, 255, 255
5.
0, 128, 255
6.
0, 0, 255
Step 9: Run the application.
We can code and render a polar chart without using the design view. Here's how to do it:
Code
C#
VB
1
void renderPolarChart()
2
        {
3
            Bunifu.Charts.WinForms.ChartTypes.BunifuPolarAreaChart bunifuPolarChart = new Bunifu.Charts.WinForms.ChartTypes.BunifuPolarAreaChart();
4
            /*
5
             * For this example we will use random numbers
6
             */
7
            var r = new Random();
8
​
9
            /*
10
             * Add your data from your source - accepts double list
11
             * Below is an example from a random number
12
             */
13
            List<double> data = new List<double>();
14
​
15
            for (int i = 0; i < 5; i++)
16
            {
17
                data.Add(r.NextDouble());
18
            }
19
            /*
20
             * Set your data             
21
             */
22
            bunifuPolarChart.Data = data;
23
​
24
            /*
25
             * Specify the target canvas
26
             */
27
            bunifuPolarChart.TargetCanvas = bunifuChartCanvas1;
28
​
29
            /*
30
            * Hide grid lines
31
            */
32
            bunifuChartCanvas1.XAxesGridLines = false;
33
            bunifuChartCanvas1.YAxesGridLines = false;
34
​
35
            /*
36
             * Add labels to your canvas
37
             * Label count should correspond to data count for charts like Bar charts
38
             */
39
            bunifuChartCanvas1.Labels = new string[] { "Label1", "Label2", "Label3", "Label4", "Label5" };
40
​
41
            /*
42
             * Beautify the chart by sepcifying the colors
43
             * Color count should correspond to data count
44
             */
45
            List<Color> bgColors = new List<Color>();
46
            for (int i = 0; i < data.Count; i++)
47
            {
48
                bgColors.Add(Color.FromArgb(r.Next(256), r.Next(256), r.Next(256)));
49
            }
50
​
51
            bunifuPolarChart.BackgroundColor = bgColors;
52
        }
Copied!
1
Private Sub renderPolarChart()
2
    Dim bunifuPolarChart As Bunifu.Charts.WinForms.ChartTypes.BunifuPolarAreaChart = New Bunifu.Charts.WinForms.ChartTypes.BunifuPolarAreaChart()
3
    ' 
4
    '  For this example we will use random numbers
5
    ' 
6
    Dim r = New Random()
7
​
8
    ' 
9
    '  Add your data from your source - accepts double list
10
    '  Below is an example from a random number
11
    ' 
12
    Dim data As List(Of Double) = New List(Of Double)()
13
​
14
    For i As Integer = 0 To 5 - 1
15
        data.Add(r.NextDouble())
16
    Next
17
​
18
    ' 
19
    '  Set your data             
20
    ' 
21
    bunifuPolarChart.Data = data
22
​
23
    ' 
24
    '  Specify the target canvas
25
    ' 
26
    bunifuPolarChart.TargetCanvas = bunifuChartCanvas1
27
​
28
    ' 
29
    '  Hide grid lines
30
    ' 
31
    bunifuChartCanvas1.XAxesGridLines = False
32
    bunifuChartCanvas1.YAxesGridLines = False
33
​
34
    ' 
35
    '  Add labels to your canvas
36
    '  Label count should correspond to data count for charts like Bar charts
37
    ' 
38
    bunifuChartCanvas1.Labels = New String() {"Label1", "Label2", "Label3", "Label4", "Label5"}
39
​
40
    ' 
41
    '  Beautify the chart by sepcifying the colors
42
    '  Color count should correspond to data count
43
    ' 
44
    Dim bgColors As List(Of Color) = New List(Of Color)()
45
​
46
    For i As Integer = 0 To data.Count - 1
47
        bgColors.Add(Color.FromArgb(r.[Next](256), r.[Next](256), r.[Next](256)))
48
    Next
49
​
50
    bunifuPolarChart.BackgroundColor = bgColors
51
End Sub
52
​
Copied!
​
Let us examine Bunifu Polar charting properties.
Data Properties
1. Data
This property gets or sets a collection of values, which will be presented on the polar chart. The order in which data values are added to the property corresponds to the order in which the canvas's label values are input.
Setting and assigning data to the polar chart can be done by either using the Data property found on the property pane of the design mode or using code. The example below illustrates using both C# and VB.NET codes to populate the polar chart with data at run-time:
C#
VB.NET
1
 private void Form1_Load(object sender, EventArgs e)
2
    {
3
      Dictionary<string, double> polarData = new Dictionary<string, double>();
4
      polarData.Add("Africa", 62);
5
      polarData.Add("East Mediterranean",56);
6
      polarData.Add("South Asia", 67);
7
      polarData.Add("Europe", 45);
8
      polarData.Add("America", 32);
9
      bunifuChartCanvas1.Labels = polarData.Keys.ToArray();
10
      bunifuPolarAreaChart1.Data = polarData.Values.ToList();
11
      bunifuChartCanvas1.Update();      
12
     }
Copied!
1
 Private Sub Form1_Load(ByVal sender As Object, ByVal e As EventArgs)
2
	  Dim polarData As New Dictionary(Of String, Double)()
3
	  polarData.Add("Africa", 62)
4
	  polarData.Add("East Mediterranean",56)
5
	  polarData.Add("South Asia", 67)
6
	  polarData.Add("Europe", 45)
7
	  polarData.Add("America", 32)
8
	  bunifuChartCanvas1.Labels = polarData.Keys.ToArray()
9
	  bunifuPolarAreaChart1.Data = polarData.Values.ToList()
10
	  bunifuChartCanvas1.Update()
11
 End Sub
12
​
Copied!
Here's the polar chart output of the code above:
2. Target Canvas
This property gets or sets the canvas which will render the polar chart.
Take note of the following properties to be modified on the targetted canvas:
a) Set the ShowXAxis and ShowYAxis to false.
b) Additionally, set the properties XAxesGridLines and YAxesGridLines to false.
Background and border Properties
1. BackgroundColor
This property gets or sets a fill color to the polar segments. We can specify the colors using the Red Green Blue (RGB) color format as well as the Alpha, Red, Green, and Blue (ARGB) color values in the color collection editor.
The background color of each sector is set by adding color sets for each segment in the color selection editor as shown below:
Each color set will correspond with the order of the data provided in the Data property.
Let's provide each segment with its background color as shown below via code:
C#
VB.NET
1
  private void Form1_Load(object sender, EventArgs e)
2
        {
3
            List<Color> polarColors = new List<Color>()
4
            {
5
                Color.FromArgb(167, 225, 0),
6
                Color.FromArgb(204, 239, 0),
7
                Color.FromArgb(210, 250, 10),
8
                Color.FromArgb(220, 250, 100),
9
                Color.FromArgb(242, 240, 93)
10
            };
11
            bunifuPolarAreaChart1.BackgroundColor = polarColors;
12
            bunifuChartCanvas1.Update();
13
        }
Copied!
1
	 Private Sub Form1_Load(ByVal sender As Object, ByVal e As EventArgs)
2
			Dim polarColors As New List(Of Color)() From {Color.FromArgb(167, 225, 0),
3
			 Color.FromArgb(204, 239, 0), Color.FromArgb(210, 250, 10), 
4
			 Color.FromArgb(220, 250, 100), Color.FromArgb(242, 240, 93)}
5
			bunifuPolarAreaChart1.BackgroundColor = polarColors
6
			bunifuChartCanvas1.Update()
7
	 End Sub
8
​
Copied!
Here's the output of the back colors from the code above:
2. BorderColor
This property gets or sets a color set to a segment border. The sample form illustrates a polar chart with the border color set to:100, 0, 123
Alternatively, we can set each polar segment to have its border color by adding additional color sets to its color collection editor.
Take note that the order in which the border colors in the color collection editor are set will correspond to the order in which the data in the Data property is defined. 
3. BorderWidth
This property gets and sets an integer value that changes the width of the polar segment boundary. The greater the value, the denser the segment borders.
4. HoverBackgroundColor
This property sets a fill color value to a polar segment in which the mouse pointer is suspended.
5. HoverBorderColor
This property changes the border's color around the polar segment that the mouse pointer is hovering over.
6. HoverBorderWidth
This property specifies an integer value that alters the boundary width of a targetted polar segment over which the mouse pointer is hovering.
Take Away
Bunifu Polar Chart is in essence a great chart tool that can be used as live statistical diagrams in your data-centric applications. We can name it a " radially plotted bar chart " since the chart is a cross between a bar chart (using length as a pre-attentive feature) and a pie chart (radial in nature, segments that are wider at the top, thinner in the center, ie. polar coordinates). This helps us understand the form of the chart as a means for representing data.