Support free tutorials

vogella training Training Books

JFreeChart - Tutorial

Lars Vogel

Version 1.4



This article describes the usage of the Java library JFreeChart. As example we create a pie chart.

Table of Contents

1. Overview
2. Download JFreeChart
3. Creating Pie Charts with JFreeChart
3.1. Create Project
3.2. Add jars to build path of your project
3.3. Code
3.4. Run
4. Support this website
4.1. Thank you
4.2. Questions and Discussion
5. Links and Literature
5.1. JFreeChart Resources
5.2. Source Code
5.3. vogella Resources

1. Overview

JFreeChart is a free 100% Java chart library created by David Gilbert. JFreeChart makes it easy for developers to display professional quality charts in their applications. For details on JFreeChart please check the following link.

2. Download JFreeChart

Download the JFreeChart distribution from the website

3. Creating Pie Charts with JFreeChart

3.1. Create Project

Create a new Java project "de.vogella.jfreechart.swing.pie". Create also a package "de.vogella.jfreechart.swing.pie".

3.2. Add jars to build path of your project

In your project create a folder "lib", and paste the JFreeChart jars into this folder.

You only need the following libraries. Please replace the version numbers with the version you are using.

  • jcommon-1.0.16.jar

  • jfreechart-1.0.13.jar

Add these libraries to your classpath. See Eclipse Java IDE - Classpath for details).

3.3. Code

Create the following two classes.

package de.vogella.jfreechart.swing.pie;

import javax.swing.JFrame;

import org.jfree.chart.ChartFactory;
import org.jfree.chart.ChartPanel;
import org.jfree.chart.JFreeChart;
import org.jfree.chart.plot.PiePlot3D;
import org.jfree.util.Rotation;
package de.vogella.jfreechart.swing.pie;

public class PieChart extends JFrame {

  private static final long serialVersionUID = 1L;

  public PieChart(String applicationTitle, String chartTitle) {
        // This will create the dataset 
        PieDataset dataset = createDataset();
        // based on the dataset we create the chart
        JFreeChart chart = createChart(dataset, chartTitle);
        // we put the chart into a panel
        ChartPanel chartPanel = new ChartPanel(chart);
        // default size
        chartPanel.setPreferredSize(new java.awt.Dimension(500, 270));
        // add it to our application

/** * Creates a sample dataset */
private PieDataset createDataset() { DefaultPieDataset result = new DefaultPieDataset(); result.setValue("Linux", 29); result.setValue("Mac", 20); result.setValue("Windows", 51); return result; }
/** * Creates a chart */
private JFreeChart createChart(PieDataset dataset, String title) { JFreeChart chart = ChartFactory.createPieChart3D(title, // chart title dataset, // data true, // include legend true, false); PiePlot3D plot = (PiePlot3D) chart.getPlot(); plot.setStartAngle(290); plot.setDirection(Rotation.CLOCKWISE); plot.setForegroundAlpha(0.5f); return chart; } }

package de.vogella.jfreechart.swing.pie;

public class Main {
   public static void main(String[] args) {
          PieChart demo = new PieChart("Comparison", "Which operating system are you using?");

I assume that the code is pretty much self-explaining. I tried to add lots of comments to make it easier to understand. For more complex examples have a look at the JFreeChart homepage.


David Gilbert is also selling an excellent developer guide on the JFreeChart homepage. If you are intensively using JFreeChart you should buy the developer guide from David to support him and to get excellent information access.

3.4. Run

Run The result should look like the following.

4. Support this website

This tutorial is Open Content under the CC BY-NC-SA 3.0 DE license. Source code in this tutorial is distributed under the Eclipse Public License. See the vogella License page for details on the terms of reuse.

Writing and updating these tutorials is a lot of work. If this free community service was helpful, you can support the cause by giving a tip as well as reporting typos and factual errors.

4.1. Thank you

Please consider a contribution if this article helped you. It will help to maintain our content and our Open Source activities.

4.2. Questions and Discussion

If you find errors in this tutorial, please notify me (see the top of the page). Please note that due to the high volume of feedback I receive, I cannot answer questions to your implementation. Ensure you have read the vogella FAQ as I don't respond to questions already answered there.

5. Links and Literature

5.1. JFreeChart Resources JFreeChart Homepage

5.2. Source Code

Source Code of Examples

5.3. vogella Resources

vogella Training Android and Eclipse Training from the vogella team

Android Tutorial Introduction to Android Programming

GWT Tutorial Program in Java, compile to JavaScript and HTML

Eclipse RCP Tutorial Create native applications in Java

JUnit Tutorial Test your application

Git Tutorial Put all your files in a distributed version control system