58 lines
1.6 KiB
Markdown
58 lines
1.6 KiB
Markdown
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
|
|
|
|
|
|
|
|
|
|
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!
|
|
```
|
|
|
|
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.
|
|
|
|
# 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.
|