Our library focuses on generating beautiful charts and graphs within Go. Graphs are used to show a lot of different types of data, needing to be represented in a unique in order to convey the meaning behind the data. This Go module attempts to use sophisticated defaults to try and render this data in a simple way, while still offering intuitive options to update the graph rendering as you see fit.
Forked from vicanso/go-charts and the archived wcharczuk/go-chart, our project introduces enhancements for rendering challenging datasets. We aim to build upon their solid foundation to offer a more versatile and user-friendly charting solution.
We're committed to refining the API, incorporating feedback and new ideas to enhance flexibility and ease of use.
Until the v1.0.0 release, API changes should be anticipated. We detail needed API changes on our wiki Version Migration Guide.
Notable early improvements in our fork include:
- Axis Improvements: Significant enhancements to axis rendering, data range selection, and configuration simplification were made in PR #3.
- Theming: In PR #4 (and some subsequent changes) we introduced
vivid-lightandvivid-darkthemes for more vibrant visualizations, alongside API changes for greater theme and font control. Long term we plan to make themes easier to mutate and define. - Configuration Simplification: PR #5 began our effort to streamline chart configuration, making names more descriptive and specific while focusing on a theme-centric approach. Documentation on configuration and use is also being improved. (See also #15, #20)
- Expanded Testing: Ongoing test coverage expansions have led to bug discoveries and fixes. This will continue to help ensure that our charts render perfectly for a wide range of configurations and use.
Our library is a work in progress, aiming to become a standout choice for Go developers seeking powerful, yet easy-to-use charting tools. We welcome contributions and feedback as we continue to enhance our library's functionality, configurability, and reliability.
If you are a former user of wcharczuk/go-chart, you should be able to use this project with reasonable changes. The wcharczuk/go-chart project was forked under our chartdraw package. Any code changes necessary are documented on our wcharczuk/go‐chart Migration Guide.
These chart types are supported: line, bar, horizontal bar, pie, radar or funnel and table.
Please see the ./examples/ directory and the README within it to see a variety of implementations of our different chart types and configurations.
Our built in themes are: light, dark, vivid-light, vivid-dark, ant, grafana
import (
"github.com/go-analyze/charts"
)
func main() {
// values specified where the first index is for each data series or source, and the second index is for each sample.
values := [][]float64{
{ // Email
120, // Mon
132, // Tue
101, // Wed
134, // Thu
90, // Fri
230, // Sat
210, // Sun
},
{
// values for 'Search Engine' go here
},
}
p, err := charts.LineRender(
values,
charts.TitleTextOptionFunc("Line Chart Demo"),
charts.XAxisDataOptionFunc([]string{
// The 7 labels here match to the 7 values above
"Mon", "Tue", "Wed", "Thu", "Fri", "Sat", "Sun",
}),
charts.LegendLabelsOptionFunc([]string{
"Email",
"Search Engine",
}),
// other options as desired...
import (
"github.com/go-analyze/charts"
)
func main() {
// values specified where the first index is for each data series or source, and the second index is for each sample.
values := [][]float64{
{ // Rainfall data
2.0, 4.9, 7.0, 23.2, 25.6, 76.7, 135.6, 162.2, 32.6, 20.0, 6.4, 3.3,
},
{
// 'Evaporation' data goes here
},
}
p, err := charts.BarRender(
values,
charts.XAxisDataOptionFunc([]string{
// A label for each position in the values above
"Jan", "Feb", "Mar", "Apr", "May", "Jun", "Jul", "Aug", "Sep", "Oct", "Nov", "Dec",
}),
charts.LegendLabelsOptionFunc([]string{
"Rainfall",
"Evaporation",
}),
// Example of adding a mark line across the bars, or mark points for specific values
charts.MarkLineOptionFunc(0, charts.SeriesMarkDataTypeAverage),
charts.MarkPointOptionFunc(0, charts.SeriesMarkDataTypeMax, charts.SeriesMarkDataTypeMin),
// other options as desired...
import (
"github.com/go-analyze/charts"
)
func main() {
values := [][]float64{
{ // 2011 data
18203, // Brazil
23489, // Indonesia
29034, // USA
104970, // India
131744, // China
630230, // World
},
{
// 2012 data goes here
},
}
p, err := charts.HorizontalBarRender(
values,
charts.TitleTextOptionFunc("World Population"),
charts.YAxisDataOptionFunc([]string{
"Brazil", "Indonesia", "USA", "India", "China", "World",
}),
charts.LegendLabelsOptionFunc([]string{
"2011",
"2012",
}),
// other options as desired...
import (
"github.com/go-analyze/charts"
)
func main() {
values := []float64{
1048, // Search Engine
735, // Direct
580, // Email
484, // Union Ads
300, // Video Ads
}
p, err := charts.PieRender(
values,
charts.TitleOptionFunc(charts.TitleOption{
Text: "Rainfall vs Evaporation",
Subtext: "Fake Data",
Offset: charts.OffsetCenter,
}),
charts.LegendOptionFunc(charts.LegendOption{
Data: []string{
"Search Engine",
"Direct",
"Email",
"Union Ads",
"Video Ads",
},
}),
// other options as desired...
import (
"github.com/go-analyze/charts"
)
func main() {
values := [][]float64{
{
4200, 3000, 20000, 35000, 50000, 18000,
},
{
// snip...
},
}
p, err := charts.RadarRender(
values,
charts.TitleTextOptionFunc("Basic Radar Chart"),
charts.LegendLabelsOptionFunc([]string{
"Allocated Budget",
"Actual Spending",
}),
charts.RadarIndicatorOptionFunc([]string{
"Sales",
"Administration",
"Information Technology",
"Customer Support",
"Development",
"Marketing",
}, []float64{
6500, 16000, 30000, 38000, 52000, 25000,
}),
// other options as desired...
import (
"github.com/go-analyze/charts"
)
func main() {
header := []string{
"Name",
"Age",
"Address",
"Tag",
"Action",
}
data := [][]string{
{
"John Brown",
"32",
"New York No. 1 Lake Park",
"nice, developer",
"Send Mail",
},
{
"Jim Green ",
"42",
"London No. 1 Lake Park",
"wow",
"Send Mail",
},
{
"Joe Black ",
"32",
"Sidney No. 1 Lake Park",
"cool, teacher",
"Send Mail",
},
}
spans := map[int]int{
0: 2,
1: 1,
2: 3,
3: 2,
4: 2,
}
p, err := charts.TableRender(
header,
data,
spans,
)
// snip...import (
"github.com/go-analyze/charts"
)
func main() {
values := []float64{
100, // Show
80, // Click
60, // Visit
40, // Inquiry
20, // Order
}
p, err := charts.FunnelRender(
values,
charts.TitleTextOptionFunc("Funnel"),
charts.LegendLabelsOptionFunc([]string{
"Show",
"Click",
"Visit",
"Inquiry",
"Order",
}),
)
// snip...import (
"github.com/go-analyze/charts"
)
func main() {
buf, err := charts.RenderEChartsToPNG(`{
"title": {
"text": "Line"
},
"xAxis": {
"data": ["Mon", "Tue", "Wed", "Thu", "Fri", "Sat", "Sun"]
},
"series": [
{
"data": [150, 230, 224, 218, 135, 147, 260]
}
]
}`)
// snip...