h2. 4.1.6 Pie2D Series

Pie Series

Pie Series displays data as sectors in circular chart. Data is composed from KEY which contains slice name and VALUE which holds quantity representing proportion of how much space slice should take. Chart's style is set either for all sectors using getStyle() and getTextStyle() methods for PieSeries object, or for each sector separately using MetaDataModel and setting it to PieSeries object when constructing PieSeries object.

// Sets PieSeries object, named pie, where 
//   pieModel is an instance of ChartDataModel and contains values which
//            will be shown on chart
//   meta1    is an instance of MetaDataModel and holds style settings
PieSeries pie = new PieSeries(pieModel, meta1);

Pie2D Demonstration

Figure 4.1.6.1 Pie2D Series Demonstration

View Source

Figure 4.1.6.1: Pie2D Series Demonstration

import java.awt.BorderLayout;
import java.awt.Color;
import java.awt.Dimension;
import java.awt.Font;
import javax.swing.JFrame;
import lt.monarch.chart.chart2D.Chart2D;
import lt.monarch.chart.chart2D.series.PieLabelsLayouters;
import lt.monarch.chart.chart2D.series.PieSeries;
import lt.monarch.chart.engine.ChartObject;
import lt.monarch.chart.engine.SimpleHotSpotMap;
import lt.monarch.chart.legend.Legend;
import lt.monarch.chart.models.ChartDataModel;
import lt.monarch.chart.models.MetaDataModel;
import lt.monarch.chart.models.MetaDataType;
import lt.monarch.chart.style.Styles;
import lt.monarch.chart.style.enums.PieLabelAlignment;
import lt.monarch.chart.style.enums.PieLabelFormat;
import lt.monarch.chart.style.enums.PieLegendFormat;
import lt.monarch.chart.style.tags.SeriesPaintTags;
import lt.monarch.chart.swing.JChartPanel;
import lt.monarch.chart.view.LabeledChart;
 
public class Pie2DSeriesDemo extends JFrame {
 
 
	private JChartPanel m_chartPanel;
 
	public Pie2DSeriesDemo() {
 
		setLayout(new BorderLayout());
		initChart();
		add(m_chartPanel, BorderLayout.CENTER);
 
	}
 
	private void initChart() {
 
		// setting chart data model
		ChartDataModel pieModel = new ChartDataModel();
		pieModel.add(new Object[] { "Chevrolet", new Double(0.58) });
		pieModel.add(new Object[] { "Dodge", new Double(0.58) });
		pieModel.add(new Object[] { "Honda motorcycles", new Double(0.64) });
		pieModel.add(new Object[] { "Hyundai", new Double(0.83) });
		pieModel.add(new Object[] { "Harley Davidson", new Double(0.99) });
		pieModel.add(new Object[] { "Nissan", new Double(1.05) });
		pieModel.add(new Object[] { "Ford", new Double(1.08) });
		pieModel.add(new Object[] { "Oreilly auto parts", new Double(1.24) });
		pieModel.add(new Object[] { "Honda", new Double(1.35) });
		pieModel.add(new Object[] { "Toyota", new Double(1.44) });
 
		// setting chart style
		MetaDataModel meta1 = new MetaDataModel();
 
		// creating style objects
		Styles<SeriesPaintTags> style1 = new Styles<SeriesPaintTags>();
		Styles<SeriesPaintTags> style2 = new Styles<SeriesPaintTags>();
		Styles<SeriesPaintTags> style3 = new Styles<SeriesPaintTags>();
		Styles<SeriesPaintTags> style4 = new Styles<SeriesPaintTags>();
		Styles<SeriesPaintTags> style5 = new Styles<SeriesPaintTags>();
		Styles<SeriesPaintTags> style6 = new Styles<SeriesPaintTags>();
		Styles<SeriesPaintTags> style7 = new Styles<SeriesPaintTags>();
		Styles<SeriesPaintTags> style8 = new Styles<SeriesPaintTags>();
		Styles<SeriesPaintTags> style9 = new Styles<SeriesPaintTags>();
		Styles<SeriesPaintTags> style10 = new Styles<SeriesPaintTags>();
 
		// setting background color for each slice
		style1.getPaintStyle().setBackground(new Color(251, 178, 47));
		style2.getPaintStyle().setBackground(new Color(143, 60, 168));
		style3.getPaintStyle().setBackground(new Color(49, 119, 31));
		style4.getPaintStyle().setBackground(new Color(219, 67, 47));
		style5.getPaintStyle().setBackground(new Color(223, 95, 32));
		style6.getPaintStyle().setBackground(new Color(218, 24, 121));
		style7.getPaintStyle().setBackground(new Color(75, 146, 188));
		style8.getPaintStyle().setBackground(new Color(216, 205, 1));
		style9.getPaintStyle().setBackground(new Color(255, 56, 35));
		style10.getPaintStyle().setBackground(new Color(144, 193, 13));
 
		// setting foreground color for each slice
		style1.getPaintStyle().setForeground(new Color(251, 178, 47));
		style2.getPaintStyle().setForeground(new Color(143, 60, 168));
		style3.getPaintStyle().setForeground(new Color(49, 119, 31));
		style4.getPaintStyle().setForeground(new Color(219, 67, 47));
		style5.getPaintStyle().setForeground(new Color(223, 95, 32));
		style6.getPaintStyle().setForeground(new Color(218, 24, 121));
		style7.getPaintStyle().setForeground(new Color(75, 146, 188));
		style8.getPaintStyle().setForeground(new Color(216, 205, 1));
		style9.getPaintStyle().setForeground(new Color(255, 56, 35));
		style10.getPaintStyle().setForeground(new Color(144, 193, 13));
 
		// setting text font for each slice
		style1.getTextStyle().setFont(new Font("Arial", Font.BOLD, 12));
		style2.getTextStyle().setFont(new Font("Arial", Font.BOLD, 12));
		style3.getTextStyle().setFont(new Font("Arial", Font.BOLD, 12));
		style4.getTextStyle().setFont(new Font("Arial", Font.BOLD, 12));
		style5.getTextStyle().setFont(new Font("Arial", Font.BOLD, 12));
		style6.getTextStyle().setFont(new Font("Arial", Font.BOLD, 12));
		style7.getTextStyle().setFont(new Font("Arial", Font.BOLD, 12));
		style8.getTextStyle().setFont(new Font("Arial", Font.BOLD, 12));
		style9.getTextStyle().setFont(new Font("Arial", Font.BOLD, 12));
		style10.getTextStyle().setFont(new Font("Arial", Font.BOLD, 12));
 
		// adding styles to meta data
		meta1.setData(MetaDataType.STYLE, 0, style1);
		meta1.setData(MetaDataType.STYLE, 1, style2);
		meta1.setData(MetaDataType.STYLE, 2, style3);
		meta1.setData(MetaDataType.STYLE, 3, style4);
		meta1.setData(MetaDataType.STYLE, 4, style5);
		meta1.setData(MetaDataType.STYLE, 5, style6);
		meta1.setData(MetaDataType.STYLE, 6, style7);
		meta1.setData(MetaDataType.STYLE, 7, style8);
		meta1.setData(MetaDataType.STYLE, 8, style9);
		meta1.setData(MetaDataType.STYLE, 9, style10);
 
		// setting explode for slices
		// second parameter sets for which slice explode will be set
		// third parameter - sets how much explode there should be
		meta1.setData(MetaDataType.PIE_EXPLODE, 0, new Double(0.05));
		meta1.setData(MetaDataType.PIE_EXPLODE, 1, new Double(0.05));
		meta1.setData(MetaDataType.PIE_EXPLODE, 3, new Double(0.05));
		meta1.setData(MetaDataType.PIE_EXPLODE, 4, new Double(0.05));
 
		// setting series
		PieSeries pie = new PieSeries(pieModel, meta1);
 
		// setting labels
		pie
				.setLabelLayouter(PieLabelsLayouters.LABELS_OUTSIDE_WITH_STRAIGHT_LINE);
		pie.setLabelAlignment(PieLabelAlignment.LEFT_RIGHT);
		pie.setLabelFormat(PieLabelFormat.SLICE_NAME_LABELS);
 
		// setting legend format
		pie.setLegendFormat(PieLegendFormat.CUSTOM_LABELS);
		pie.setLegendFormatPattern("%3$s -  %2$.1f%%");
 
		// setting chart
		Chart2D chart = new Chart2D();
		chart.setObjects(new ChartObject[] { pie });
 
		LabeledChart m_chart = new LabeledChart(chart);
		// setting title
		m_chart
				.setTitle("Top 10 Search Terms for Automotive Manufacturers in 2009 March");
		// setting legend
		Legend legend = new Legend(chart);
		m_chart.setRightView(legend);
 
		// setting JChartPanel
		m_chartPanel = new JChartPanel(m_chart);
		m_chartPanel.setHotSpotMap(new SimpleHotSpotMap());
	}
 
	public static void main(String[] args) {
		Pie2DSeriesDemo frame = new Pie2DSeriesDemo();
		frame.setSize(new Dimension(660, 400));
		frame.setDefaultCloseOperation(EXIT_ON_CLOSE);
		frame.setTitle("Top 10 Search Terms for Automotive Manufacturers in 2009 March");
		frame.setVisible(true);
	}
}

Other Pie Series Properties

Radius and Inner Radius

There is a possibility to set chart's radius and inner radius. Chart's radius sets how much place chart will take -values from [0;0.5] interval should be used and inner radius - is used for constructing doughnut charts.

//setting pie radius
pie.setRadius(0.4d);
//setting inner radius
pie.setInnerRadius(0.2);

Pie radius demo

Figure 4.1.6.2 Pie2D Series Demonstration

Overall Angles

There is a feature that makes it possible to set how much space pie will take in degrees 0 - 360.

//setting overall angle
pie.setOverallAngle(270);

Centre Point

Centre point sets place on panel where pie chart will be. Values from [0;1] interval should be used.

//setting point where pie centre will be
pie.setCenterPoint(new Point2D(0.5,0.5));

Labels layout and alignment

It is possible to set layout and alignment type of pie labels: Labels Layout:

LABELS_OFF - Pie labels are hidden, i.e. not drawn at all
LABELS_INSIDE - Pie labels is inside the pie;
LABELS_OUTSIDE() - Pie labels is drawn outside the pie without any connection line to the slice
LABELS_OUTSIDE_WITH_STRAIGHT_LINE - Pie labels is drawn outside the pie and connected with straight line
LABELS_OUTSIDE_WITH_ELBOW() - Pie labels is drawn outside the pie and connected to the slice with an elbow line.

Alignment Type:

HORIZONTAL - Pie labels draws inside the slices as horizontal (only with inside labels layout);
ROTATED - Pie labels draws inside the slices rotated as the angle of pie is rotated (only with inside labels layout);
CIRCULAR - Alignment to according circle (only with outside labels layout))
LEFT_RIGHT - Alignment to the left and right (only with outside labels layout)

    // setting pie label layout
    pie.setLabelLayouter(PieLabelsLayouters.LABELS_INSIDE);
   // setting pie label alignment
    pie.setLabelAlignment(PieLabelAlignment.ROTATED);

Pie labels layout and alignment demo

Figure 4.1.6.3 Pie2D Series Labels Layout and Alignment Demonstration