GoCharts

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 and SimpleKPI.

Features

• 📊 Data Structures - Table, TimeSeries, Histogram, Roadmap, and more
• 📈 Multiple Chart Libraries - C3, D3, ECharts, Google Charts, Rickshaw, wchart
• 📗 Excel Integration - Read/write XLSX files with formatting
• 📝 Markdown Output - Generate tables for documentation
• 🔌 Analytics Integration - Metabase and SimpleKPI support
• 💻 Text Charts - Terminal-friendly progress bars and funnel charts

Contents

It includes two sets of packages:

1. data structures to generically hold and manipulate different types of data
2. chart library helpers to make generating charts easier, often times using data structures mentioned above

Data Structures

Commonly used data structures include:

• Table - easy manipulation of tabular data including writing to CSV and XLSX.
• Time Series - for building time-based line charts and bar charts.
• Histogram - for building histograms and bar charts.

A full list is available in the data folder.

Chart Helpers

• C3 - code, project
• D3 - code, project
• ECharts - code, project
• Google Charts - code, project
• Rickshaw - code, project
• go-analyze/charts - code, project
• Text Charts - code - Text-based progress bars and funnel charts

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 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 folder for the primary purpose of providing reusable and example code.

Installation

$ go get github.com/grokify/gocharts/v2/...

Quick Start

Creating a Histogram

import "github.com/grokify/gocharts/v2/data/histogram"

h := histogram.NewHistogram("Response Codes")
h.Add("200", 150)
h.Add("404", 25)
h.Add("500", 10)

// Output as Markdown table
md := h.Markdown()

Creating a Table and Exporting to XLSX

import "github.com/grokify/gocharts/v2/data/table"

tbl := table.NewTable("Sales Report")
tbl.Columns = []string{"Region", "Q1", "Q2", "Q3", "Q4"}
tbl.Rows = [][]string{
    {"North", "100", "120", "130", "150"},
    {"South", "90", "95", "100", "110"},
}

// Write to Excel
err := tbl.WriteXLSX("report.xlsx")

Converting Histogram to Google Charts DataTable

import (
    "github.com/grokify/gocharts/v2/data/histogram"
    "github.com/grokify/gocharts/v2/charts/google"
)

hs := histogram.NewHistogramSet("Traffic by Hour")
// ... populate histogram set ...

dt := google.DataTableFromHistogramSet(hs)

Output Formats

GoCharts supports multiple output formats:

| Format | Package | Description | |--------|---------|-------------| | CSV | data/table | Comma-separated values | | XLSX | data/table | Excel spreadsheets via excelize | | Markdown | data/histogram | GitHub-flavored markdown tables | | HTML | charts/* | Chart library-specific HTML via quicktemplate | | ASCII | data/table | Terminal-friendly tables via tablewriter |

Examples

Examples are available in each chart package's examples/ directory:

| Chart Library | Example Location | |---------------|------------------| | Google Charts | charts/google/examples/ | | wchart | charts/wchart/examples/ | | C3 | charts/c3/examples/ | | Rickshaw | charts/rickshaw/examples/ | | D3 Bullet | charts/d3/d3bullet/examples/ |

Mentions

1. Philip Gardner's GitHub stars: github.com/gaahrdner/starred