jfreechart.manual

The JFreeChart Class Library

Version 0.9.18

Developer Guide

Written by David GilbertApril 28, 2004c



IMPORTANT NOTICE:If you choose to use this document you do so entirely at your ownrisk.

Contents

1.1 What is JFreeChart?. . . . . . . . . . . . . . . . . . . . . . . . . 131.2 This Document. . . . . . . . . . . . . . . . . . . . . . . . . . . . 151.3 Acknowledgements. . . . . . . . . . . . . . . . . . . . . . . . . . 151.4 Comments and Suggestions. . . . . . . . . . . . . . . . . . . . . 15

2 Sample Charts16

2.1 Introduction. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 162.2 Pie Charts. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 162.3 Bar Charts. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 182.4 Line Chart. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 202.5 XY Plots. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 212.6 Time Series Charts. . . . . . . . . . . . . . . . . . . . . . . . . . 222.7 Histograms. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 232.8 Area Charts. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 242.9 Diﬀerence Chart. . . . . . . . . . . . . . . . . . . . . . . . . . . 242.10 Step Chart. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 262.11 Gantt Chart. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 272.12 Multiple Axis Charts. . . . . . . . . . . . . . . . . . . . . . . . . 282.13 Combined and Overlaid Charts. . . . . . . . . . . . . . . . . . . 292.14 Future Development. . . . . . . . . . . . . . . . . . . . . . . . . 30

3 Downloading and Installing JFreeChart31

3.1 Introduction. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 313.2 Download. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 313.3 Unpacking the Files. . . . . . . . . . . . . . . . . . . . . . . . . 323.4 Running the Demonstration Applications. . . . . . . . . . . . . 333.5 Compiling the Source. . . . . . . . . . . . . . . . . . . . . . . . 333.6 Generating the Javadoc Documentation. . . . . . . . . . . . . . 33

4 Using JFreeChart34

4.1 Overview. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 344.2 Creating Your First Chart. . . . . . . . . . . . . . . . . . . . . . 34

5 Bar Charts37

5.1 Introduction. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 375.2 A Bar Chart. . . . . . . . . . . . . . . . . . . . . . . . . . . . . 375.3 Customising Bar Charts. . . . . . . . . . . . . . . . . . . . . . . 421

CONTENTS

2

6 Line Charts44

6.1 Introduction. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 446.2 A Line Chart Based On A Category Dataset. . . . . . . . . . . 44

7 Time Series Charts55

7.1 Introduction. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 557.2 Time Series Charts. . . . . . . . . . . . . . . . . . . . . . . . . . 55

8 Customising Charts61

8.1 Introduction. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 618.2 Chart Attributes. . . . . . . . . . . . . . . . . . . . . . . . . . . 618.3 Plot Attributes. . . . . . . . . . . . . . . . . . . . . . . . . . . . 638.4 Axis Attributes. . . . . . . . . . . . . . . . . . . . . . . . . . . . 64

9 Dynamic Charts67

9.1 Overview. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 679.2 Background. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 679.3 The Demo Application. . . . . . . . . . . . . . . . . . . . . . . . 68

10 Tooltips72

10.1 Overview. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7210.2 Generating Tool Tips. . . . . . . . . . . . . . . . . . . . . . . . . 7210.3 Collecting Tool Tips. . . . . . . . . . . . . . . . . . . . . . . . . 7310.4 Displaying Tool Tips. . . . . . . . . . . . . . . . . . . . . . . . . 7310.5 Disabling Tool Tips. . . . . . . . . . . . . . . . . . . . . . . . . 7410.6 Customising Tool Tips. . . . . . . . . . . . . . . . . . . . . . . . 74

11 Item Labels75

11.1 Introduction. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7511.2 Displaying Item Labels. . . . . . . . . . . . . . . . . . . . . . . . 7611.3 Item Label Appearance. . . . . . . . . . . . . . . . . . . . . . . 7811.4 Item Label Positioning. . . . . . . . . . . . . . . . . . . . . . . . 7911.5 Customising the Item Label Text. . . . . . . . . . . . . . . . . . 8011.6 Example 1 - Values Above a Threshold. . . . . . . . . . . . . . . 8011.7 Example 2 - Displaying Percentages. . . . . . . . . . . . . . . . 83

12 Using Multiple Axes88

12.1 Introduction. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8812.2 An Example. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8912.3 Hints and Tips. . . . . . . . . . . . . . . . . . . . . . . . . . . . 90

13 Combined Charts91

13.1 Introduction. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9113.2 Combined Domain Category Plot. . . . . . . . . . . . . . . . . . 9113.3 Combined Range Category Plot. . . . . . . . . . . . . . . . . . . 9213.4 Combined Domain XY Plot. . . . . . . . . . . . . . . . . . . . . 9413.5 Combined Range XY Plot. . . . . . . . . . . . . . . . . . . . . . 95