Important note

GRAL is now on Github:

Downloads of GRAL will be hosted here for the moment. If you want to get the current source code, or if you have found an issue you'll have to use Github.

This website will be online as long as the migration process will take.

Welcome to GRAL

GRAL is a free Java library for displaying plots (graphs, diagrams, and charts). The acronym GRAL simply stands for GRAphing Library.


  • Ready-to-use classes for data management
  • Data processing and filtering (smoothing, rescaling, statistics, histograms)
  • Many different plot types: xy/scatter plot, bubble plot, line plot, area plot, bar plot, pie plot, donut plot, box-and-whisker plot, raster plot
  • Legends: horizontal and vertical
  • Various axis types: linear axes, logarithmic axes, arbitrary number of axes
  • Several file formats are supported as data sources or data sinks (CSV, bitmap image data, audio file data)
  • Exporting plots in bitmap and vector file formats (PNG, GIF, JPEG, EPS, PDF, SVG)
  • Small footprint (about 300 kilobytes)

Read more about GRAL in the comparison table of Comparison Java plotting libraries.

To see examples of GRAL's output visit the plot gallery.

Download and installation

More information on how to get and install GRAL can be found on the download and installation pages.


You can browse the latest version of GRAL's API documentation online.

There are several tutorials will teach you how to get started. You can also get small snippets of code for your problem in the list of how-tos. Additionally, the packages contain a bundle of example applications which show how to code with GRAL.

Join the GRAL community in the IRC channel #gral on freenode to get answers in realtime.

Get involved

If you want to report issues, bugs, or file feature requests just register with the link on top of this page. If you even like to contribute your own code please send an email message to <dev [at]>. You will get an account for the wiki pages and for the GRAL git repository.


GRAL uses the GNU Lesser General Public License (LGPL v3) so loosely speaking you may use the library for your own application whether commercial or not. Any changes to the library itself however have to be licensed under the GNU LGPL, too.

Last modified 5 years ago Last modified on Mar 17, 2016, 2:06:01 PM