go chart is a basic charting library in native golang.
Go
Clone or download
Latest commit 9e3a080 Apr 15, 2018
Permalink
Failed to load latest commit information.
_examples Port changes 'fixing styling issues w/ the stack bar chart.' from com… Jan 24, 2018
_images can rotate text + add y axis names Aug 7, 2016
drawing fixing find and replace issue Apr 5, 2018
matrix fixing tests Apr 5, 2018
roboto Helper API refactor (#40) May 13, 2017
seq fixing tests Apr 5, 2018
util allow 'zero y-range delta' (#72) Apr 15, 2018
.gitignore Update .gitignore (#73) Apr 15, 2018
.travis.yml fixing find and replace issue Apr 5, 2018
LICENSE license and readme. Jul 8, 2016
Makefile profanity tweaks Apr 15, 2018
PROFANITY adding profanity checks Apr 15, 2018
README.md readme updates. Aug 7, 2016
annotation_series.go Helper API refactor (#40) May 13, 2017
annotation_series_test.go fixing find and replace issue Apr 5, 2018
axis.go can just supply inverted ranges. Jan 10, 2017
bar_chart.go Port changes 'fixing styling issues w/ the stack bar chart.' from com… Jan 24, 2018
bar_chart_test.go fixing tests Apr 5, 2018
bollinger_band_series.go Helper API refactor (#40) May 13, 2017
bollinger_band_series_test.go fixing find and replace issue Apr 5, 2018
box.go Helper API refactor (#40) May 13, 2017
box_test.go fixing find and replace issue Apr 5, 2018
chart.go allow 'zero y-range delta' (#72) Apr 15, 2018
chart_test.go allow 'zero y-range delta' (#72) Apr 15, 2018
colors.go color maps Apr 15, 2017
concat_series.go Helper API refactor (#40) May 13, 2017
concat_series_test.go fixing find and replace issue Apr 5, 2018
continuous_range.go descending Jan 10, 2017
continuous_range_test.go fixing find and replace issue Apr 5, 2018
continuous_series.go Helper API refactor (#40) May 13, 2017
continuous_series_test.go fixing find and replace issue Apr 5, 2018
defaults.go color maps Apr 15, 2017
draw.go Helper API refactor (#40) May 13, 2017
ema_series.go Helper API refactor (#40) May 13, 2017
ema_series_test.go fixing find and replace issue Apr 5, 2018
font.go Helper API refactor (#40) May 13, 2017
grid_line.go changing gridline behavior. Aug 12, 2016
grid_line_test.go fixing tests Apr 5, 2018
histogram_series.go Helper API refactor (#40) May 13, 2017
histogram_series_test.go fixing find and replace issue Apr 5, 2018
image_writer.go adding validation. Feb 3, 2017
jet.go Separation of DotColorProvider and ColorProvider Interfaces (#34) Apr 17, 2017
last_value_annotation_series.go Helper API refactor (#40) May 13, 2017
legend.go Helper API refactor (#40) May 13, 2017
legend_test.go fixing find and replace issue Apr 5, 2018
linear_regression_series.go Helper API refactor (#40) May 13, 2017
linear_regression_series_test.go fixing find and replace issue Apr 5, 2018
macd_series.go Helper API refactor (#40) May 13, 2017
macd_series_test.go fixing find and replace issue Apr 5, 2018
market_hours_range.go Helper API refactor (#40) May 13, 2017
market_hours_range_test.go fixing tests Apr 5, 2018
min_max_series.go Helper API refactor (#40) May 13, 2017
pie_chart.go fix for issues/56 Oct 12, 2017
pie_chart_test.go fixing find and replace issue Apr 5, 2018
polynomial_regression_series.go Helper API refactor (#40) May 13, 2017
polynomial_regression_test.go fixing find and replace issue Apr 5, 2018
range.go descending Jan 10, 2017
raster_renderer.go removing dep on go-util from blend Apr 5, 2018
renderable.go api tweaks. Jul 15, 2016
renderer.go text rotation works, ish. Oct 21, 2016
renderer_provider.go snapshot. Jul 10, 2016
series.go adding validation. Feb 3, 2017
sma_series.go Helper API refactor (#40) May 13, 2017
sma_series_test.go fixing find and replace issue Apr 5, 2018
stacked_bar_chart.go fixing styling issues w/ the stack bar chart. Jun 11, 2017
style.go removing dep on go-util from blend Apr 5, 2018
style_test.go fixing find and replace issue Apr 5, 2018
text.go Helper API refactor (#40) May 13, 2017
text_test.go fixing tests Apr 5, 2018
tick.go changed the tick sanity ount variable (#42) May 23, 2017
tick_test.go fixing tests Apr 5, 2018
time_series.go Helper API refactor (#40) May 13, 2017
time_series_test.go fixing find and replace issue Apr 5, 2018
value.go removing dep on go-util from blend Apr 5, 2018
value_formatter.go ??? Apr 26, 2017
value_formatter_provider.go mostly works. Jul 10, 2016
value_formatter_test.go fixing find and replace issue Apr 5, 2018
value_provider.go Helper API refactor (#40) May 13, 2017
value_test.go fixing tests Apr 5, 2018
vector_renderer.go removing dep on go-util from blend Apr 5, 2018
vector_renderer_test.go fixing find and replace issue Apr 5, 2018
viridis.go Separation of DotColorProvider and ColorProvider Interfaces (#34) Apr 17, 2017
xaxis.go Helper API refactor (#40) May 13, 2017
xaxis_test.go fixing tests Apr 5, 2018
yaxis.go Helper API refactor (#40) May 13, 2017
yaxis_test.go fixing tests Apr 5, 2018

README.md

go-chart

Build StatusGo Report Card

Package chart is a very simple golang native charting library that supports timeseries and continuous line charts.

The v1.0 release has been tagged so things should be more or less stable, if something changes please log an issue.

Master should now be on the v2.x codebase, which brings a couple new features and better handling of basics like axes labeling etc. Per usual, see _examples for more information.

Installation

To install chart run the following:

> go get -u github.com/wcharczuk/go-chart

Most of the components are interchangeable so feel free to crib whatever you want.

Output Examples

Spark Lines:

Single axis:

Two axis:

Other Chart Types

Pie Chart:

The code for this chart can be found in _examples/pie_chart/main.go.

Stacked Bar:

The code for this chart can be found in _examples/stacked_bar/main.go.

Code Examples

Actual chart configurations and examples can be found in the ./_examples/ directory. They are web servers, so start them with go run main.go then access http://localhost:8080 to see the output.

Usage

Everything starts with the chart.Chart object. The bare minimum to draw a chart would be the following:

import (
    ...
    "bytes"
    ...
    "github.com/wcharczuk/go-chart" //exposes "chart"
)

graph := chart.Chart{
    Series: []chart.Series{
        chart.ContinuousSeries{
            XValues: []float64{1.0, 2.0, 3.0, 4.0},
            YValues: []float64{1.0, 2.0, 3.0, 4.0},
        },
    },
}

buffer := bytes.NewBuffer([]byte{})
err := graph.Render(chart.PNG, buffer)

Explanation of the above: A chart can have many Series, a Series is a collection of things that need to be drawn according to the X range and the Y range(s).

Here, we have a single series with x range values as float64s, rendered to a PNG. Note; we can pass any type of io.Writer into Render(...), meaning that we can render the chart to a file or a resonse or anything else that implements io.Writer.

API Overview

Everything on the chart.Chart object has defaults that can be overriden. Whenever a developer sets a property on the chart object, it is to be assumed that value will be used instead of the default. One complication here is any object's root chart.Style object (i.e named Style) and the Show property specifically, if any other property is set and the Show property is unset, it is assumed to be it's default value of False.

The best way to see the api in action is to look at the examples in the ./_examples/ directory.

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.