Skip to content

sveinn-steinarsson/highcharts-downsample

Repository files navigation

highcharts-downsample: Downsample plugin for Highcharts

This plugin for Highcharts downsamples data before rendering the chart. The purpose is to try retain the visual characteristics of the original line using considerably fewer data points. The algorithm (called Largest-Triangle-Three-Buckets) used in this plugin is described in a Master's thesis (see hdl.handle.net/1946/15343) in Computer Science by Sveinn Steinarsson at the University of Iceland. The topic of the thesis is how to downsample time series for visual representation and was initially suggested by DataMarket. JavaScript optimization was done with the help of Borgar Þorsteinsson.

Demo

Demo can viewed at highcharts.base.is.

Additional demo is also available in JSFiddle

Usage

series: [{
  downsample: {
    threshold: 1000 // 0 disables downsampling for this series.
  },
  data: // Your data (array of arrays with two values or array of numerical values)
}]

Notes

This plugin is mainly for downsampling line charts but might work for other types, e.g. area or column. The recommended input data format is array of arrays with two values. Array of numerical values is also supported but might be slower. Array of objects and range series are not supported!

Known limitations

  • Does not support gaps (null values) in the data array.
  • X-values must be in a strictly increasing order.

Articles about the algorithm (LTTB)

The algorithm (LTTB) adapted for other programming languages or frameworks

Note: I have not tested all these versions and some might have different or additional features.

(Please let me know if you make your own port of the LTTB algorithm so I can list it here.)

License

highcharts-downsample is released under the terms of the MIT License.

About

Downsample plugin for Highcharts.

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published