Skip to content
Snippets Groups Projects
README.md 2.1 KiB
Newer Older
Tim Molter's avatar
Tim Molter committed
## XChart
Tim Molter's avatar
Tim Molter committed
A Simple Charting Library for Java

Tim Molter's avatar
Tim Molter committed
## Description
Tim Molter's avatar
Tim Molter committed
XChart is a light-weight and convenient library for plotting data.
timmolter's avatar
timmolter committed

Tim Molter's avatar
Tim Molter committed
Its focus is on simplicity and ease-of-use, requiring only two lines of code to save or display a basic default chart.
Tim Molter's avatar
Tim Molter committed
Usage is very simple: Create a Chart instance, add a series of data to it, and either save it or display it.

Tim Molter's avatar
Tim Molter committed
## Example
Tim Molter's avatar
Tim Molter committed

Tim Molter's avatar
Tim Molter committed
    double[] xData = new double[] { 0.0, 1.0, 2.0 };
    double[] yData = new double[] { 2.0, 1.0, 0.0 };
Tim Molter's avatar
Tim Molter committed
    // Create Chart
    Chart chart = QuickChart.getChart("Sample Chart", "X", "Y", "y(x)", xData, yData);

    // Show it
    new SwingWrapper(chart).displayChart();

    // Save it
    BitmapEncoder.savePNG(chart, "./Sample_Chart.png");
    
Now go ahead and [study some more examples](http://xeiam.com/xchart_examplecode.jsp), [download the thing](http://xeiam.com/xchart_changelog.jsp) and [provide feedback](https://github.com/timmolter/XChart/issues).

Tim Molter's avatar
Tim Molter committed
## Features
Tim Molter's avatar
Tim Molter committed
* no additional dependencies
* ~50KB Jar
* line charts
* scatter charts
* error bars
* Date x-axis
* multiple series
* extensive customization
timmolter's avatar
timmolter committed

Tim Molter's avatar
Tim Molter committed
## Getting Started
### Non-Maven
timmolter's avatar
timmolter committed
Download Jar: http://xeiam.com/xchart.jsp

Tim Molter's avatar
Tim Molter committed
### Maven
Tim Molter's avatar
Tim Molter committed
The XChart release artifacts are hosted on Maven Central.
Tim Molter's avatar
Tim Molter committed

Tim Molter's avatar
Tim Molter committed
Add the XChart library as a dependency to your pom.xml file:
timmolter's avatar
timmolter committed

timmolter's avatar
timmolter committed
    <dependency>
      <groupId>com.xeiam</groupId>
      <artifactId>xchart</artifactId>
Tim Molter's avatar
Tim Molter committed
      <version>1.3.0</version>
timmolter's avatar
timmolter committed
    </dependency>
Tim Molter's avatar
Tim Molter committed
For snapshots, add the following to your pom.xml file:
Tim Molter's avatar
Tim Molter committed

    <repository>
      <id>xchart-snapshot</id>
      <snapshots/>
      <url>https://oss.sonatype.org/content/repositories/snapshots</url>
    </repository>
Tim Molter's avatar
Tim Molter committed
    
    <dependency>
      <groupId>com.xeiam</groupId>
      <artifactId>xchart</artifactId>
Tim Molter's avatar
Tim Molter committed
      <version>1.3.1-SNAPSHOT</version>
Tim Molter's avatar
Tim Molter committed
    </dependency>
Tim Molter's avatar
Tim Molter committed

Tim Molter's avatar
Tim Molter committed
## Building
timmolter's avatar
timmolter committed
mvn clean package  
Tim Molter's avatar
Tim Molter committed
mvn javadoc:javadoc  

Tim Molter's avatar
Tim Molter committed
## Bugs
Please report any bugs or submit feature requests to [XChart's Github issue tracker](https://github.com/timmolter/XChart/issues).  
Tim Molter's avatar
Tim Molter committed

Tim Molter's avatar
Tim Molter committed
## More Info
Sonar Code Quality: http://sonar.xeiam.com/  
Jenkins CI: http://ci.xeiam.com/  

## Donations
17dQktcAmU4urXz7tGk2sbuiCqykm3WLs6