https://github.com/grokify/gocharts
Go code to help create various charts, e.g. C3, D3, Rickshaw, go-chart, etc.
https://github.com/grokify/gocharts
c3js d3js golang-library rickshaw
Last synced: 8 months ago
JSON representation
Go code to help create various charts, e.g. C3, D3, Rickshaw, go-chart, etc.
- Host: GitHub
- URL: https://github.com/grokify/gocharts
- Owner: grokify
- License: mit
- Created: 2017-05-27T18:25:55.000Z (over 8 years ago)
- Default Branch: master
- Last Pushed: 2024-04-07T12:23:21.000Z (over 1 year ago)
- Last Synced: 2024-04-08T12:33:03.351Z (over 1 year ago)
- Topics: c3js, d3js, golang-library, rickshaw
- Language: Go
- Homepage:
- Size: 1.22 MB
- Stars: 41
- Watchers: 3
- Forks: 4
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- License: LICENSE
Awesome Lists containing this project
README
GoCharts
========
[![Build Status][build-status-svg]][build-status-url]
[![Go Report Card][goreport-svg]][goreport-url]
[![Docs][docs-godoc-svg]][docs-godoc-url]
[![SLOC][loc-svg]][repo-url]
[![License][license-svg]][license-url]
GoCharts is a library to assist with building charts, by directly working with charting libraries, generating tabular data for Excel XLSX files and CSV files, or to transfer data to/from analytics solutions like [Metabase](https://pkg.go.dev/github.com/grokify/go-metabase/metabaseutil) and [SimpleKPI](https://pkg.go.dev/github.com/grokify/go-simplekpi/simplekpiutil).
## Contents
It includes two sets of packages:
1. data structures to generically hold and manipulate different types of data
1. chart library helpers to make generating charts eaiser, often times using data structures mentioned above
### Data Structures
Commonly used data structures include:
* [Table](https://pkg.go.dev/github.com/grokify/gocharts/v2/data/table) - easy manipulation of tabular data including [writing to CSV and XLSX](data/table/write.go).
* [Time Series](https://pkg.go.dev/github.com/grokify/gocharts/v2/data/timeseries) - for building time-based line charts and bar charts.
* [Histogram](https://pkg.go.dev/github.com/grokify/gocharts/v2/data/histogram) - for building histograms and bar charts.
A full list is available in the [`data`](data) folder.
### Chart Helpers
* [C3](https://pkg.go.dev/github.com/grokify/gocharts/v2/charts/c3) - [code](charts/c3), [project](https://c3js.org/)
* [D3](https://pkg.go.dev/github.com/grokify/gocharts/v2/charts/d3) - [code](charts/d3), [project](https://d3js.org/)
* [Google Charts](https://pkg.go.dev/github.com/grokify/gocharts/v2/charts/google) - [code](charts/google), [project](https://developers.google.com/chart/interactive/docs)
* [Rickshaw](https://pkg.go.dev/github.com/grokify/gocharts/v2/charts/rickshaw) - [code](charts/rickshaw), [project](https://github.com/shutterstock/rickshaw)
* [wcharczuk/go-chart](https://pkg.go.dev/github.com/grokify/gocharts/v2/charts/wchart) - [code](charts/wchart), [project](https://github.com/wcharczuk/go-chart)
[`quicktemplate`](https://github.com/valyala/quicktemplate) is used for rendering some of the charts.
An example chart is the Rickshaw chart shown below:
### Collections
Data collections are provided in the [`collections`](collections) folder for the primary purpose of providing example data to run in the examples. Currently, cryptocurrency data from Yahoo! Finance is included.
### Applications
Various helpers to use applications are located in the [`apps`](apps) folder for the primary purpose of providing reusable and example code.
## Installation
```bash
$ go get github.com/grokify/gocharts/v2/...
```
## Usage
See the example here:
[charts/rickshaw/examples/report.go](charts/rickshaw/examples/report.go)
[build-status-svg]: https://github.com/grokify/gocharts/actions/workflows/ci.yaml/badge.svg?branch=master
[build-status-url]: https://github.com/grokify/gocharts/actions/workflows/ci.yaml
[goreport-svg]: https://goreportcard.com/badge/github.com/grokify/gocharts
[goreport-url]: https://goreportcard.com/report/github.com/grokify/gocharts
[docs-godoc-svg]: https://pkg.go.dev/badge/github.com/grokify/gocharts
[docs-godoc-url]: https://pkg.go.dev/github.com/grokify/gocharts/v2
[license-svg]: https://img.shields.io/badge/license-MIT-blue.svg
[license-url]: https://github.com/grokify/gocharts/blob/master/LICENSE
[used-by-svg]: https://sourcegraph.com/github.com/grokify/gocharts/-/badge.svg
[used-by-url]: https://sourcegraph.com/github.com/grokify/gocharts?badge
[loc-svg]: https://tokei.rs/b1/github/grokify/gocharts
[repo-url]: https://github.com/grokify/gocharts
## Mentions
1. [Philip Gardner's GitHub stars: `github.com/gaahrdner/starred`](https://github.com/gaahrdner/starred)