go-chart/README.md

59 lines
1.6 KiB
Markdown
Raw Normal View History

2016-07-08 05:37:57 +02:00
go-chart
========
Package `chart` is a very simple golang native charting library that supports timeseries and continuous
line charts.
# Installation
To install `chart` run the following:
```bash
> go get -u github.com/wcharczuk/go-chart
```
Most of the components are interchangeable so feel free to crib whatever you want.
# Usage
![](https://raw.githubusercontent.com/wcharczuk/go-chart/master/images/goog_ltm.png)
The chart code to produce the above is as follows:
```go
// note this assumes that xvalues and yvalues
// have been pulled from a pricing service.
graph := chart.Chart{
Width: 1024,
Height: 400,
Axes: chart.Style{
Show: true,
},
FinalValueLabel: chart.Style{
Show: true,
},
Series: []chart.Series{
chart.TimeSeries{
XValues: xvalues,
YValues: yvalues,
},
},
}
graph.Render(chart.PNG, buffer) //thats it!
```
2016-07-08 05:43:13 +02:00
The key areas to note are that we have to explicitly turn on two features, the axes and the last value label. When calling `.Render(..)` we add a parameter, `chart.PNG` that tells the renderer to use a raster renderer (in this case, an awesome library called `draw2d`).
Coming in the near future will be the option to output to SVG.
2016-07-08 05:37:57 +02:00
# Design Philosophy
I wanted to make a charting library that used only native golang, that could be stood up on a server (i.e. it had built in fonts).
The goal with the API itself is to have the "zero value be useful", and to require the user to not code more than they absolutely needed.
# Contributions
This library is super early but contributions are welcome.