| 123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511512513514515516517518519520521522523524525526527528529530531532533534535536537538539540541542543544545546547548 |
- /**
- * @license Highcharts JS v6.1.0 (2018-04-13)
- *
- * (c) 2010-2017 Highsoft AS
- * Author: Sebastian Domas
- *
- * License: www.highcharts.com/license
- */
- 'use strict';
- (function (factory) {
- if (typeof module === 'object' && module.exports) {
- module.exports = factory;
- } else {
- factory(Highcharts);
- }
- }(function (Highcharts) {
- var derivedSeriesMixin = (function (H) {
- var each = H.each,
- Series = H.Series,
- addEvent = H.addEvent,
- noop = H.noop;
- /* ***************************************************************************
- *
- * DERIVED SERIES MIXIN
- *
- **************************************************************************** */
- /**
- * Provides methods for auto setting/updating series data based on the based
- * series data.
- *
- * @mixin
- **/
- var derivedSeriesMixin = {
- /**
- * Initialise series
- *
- * returns {undefined}
- **/
- init: function () {
- Series.prototype.init.apply(this, arguments);
- this.initialised = false;
- this.baseSeries = null;
- this.eventRemovers = [];
- this.addEvents();
- },
- /**
- * Method to be implemented - inside the method the series has already access
- * to the base series via m `this.baseSeries` and the bases data is
- * initialised. It should return data in the format accepted by
- * `Series.setData()` method
- *
- * @returns {Array} - an array of data
- **/
- setDerivedData: noop,
- /**
- * Sets base series for the series
- *
- * returns {undefined}
- **/
- setBaseSeries: function () {
- var chart = this.chart,
- baseSeriesOptions = this.options.baseSeries,
- baseSeries =
- baseSeriesOptions &&
- (chart.series[baseSeriesOptions] || chart.get(baseSeriesOptions));
- this.baseSeries = baseSeries || null;
- },
- /**
- * Adds events for the series
- *
- * @returns {undefined}
- **/
- addEvents: function () {
- var derivedSeries = this,
- chartSeriesLinked;
- chartSeriesLinked = addEvent(
- this.chart,
- 'afterLinkSeries',
- function () {
- derivedSeries.setBaseSeries();
- if (derivedSeries.baseSeries && !derivedSeries.initialised) {
- derivedSeries.setDerivedData();
- derivedSeries.addBaseSeriesEvents();
- derivedSeries.initialised = true;
- }
- }
- );
- this.eventRemovers.push(
- chartSeriesLinked
- );
- },
- /**
- * Adds events to the base series - it required for recalculating the data in
- * the series if the base series is updated / removed / etc.
- *
- * @returns {undefined}
- **/
- addBaseSeriesEvents: function () {
- var derivedSeries = this,
- updatedDataRemover,
- destroyRemover;
- updatedDataRemover = addEvent(
- derivedSeries.baseSeries,
- 'updatedData',
- function () {
- derivedSeries.setDerivedData();
- }
- );
- destroyRemover = addEvent(
- derivedSeries.baseSeries,
- 'destroy',
- function () {
- derivedSeries.baseSeries = null;
- derivedSeries.initialised = false;
- }
- );
- derivedSeries.eventRemovers.push(
- updatedDataRemover,
- destroyRemover
- );
- },
- /**
- * Destroys the series
- *
- * @returns {undefined}
- **/
- destroy: function () {
- each(this.eventRemovers, function (remover) {
- remover();
- });
- Series.prototype.destroy.apply(this, arguments);
- }
- };
- return derivedSeriesMixin;
- }(Highcharts));
- (function (H, derivedSeriesMixin) {
- var each = H.each,
- objectEach = H.objectEach,
- seriesType = H.seriesType,
- correctFloat = H.correctFloat,
- isNumber = H.isNumber,
- arrayMax = H.arrayMax,
- arrayMin = H.arrayMin,
- merge = H.merge;
- /* ***************************************************************************
- *
- * HISTOGRAM
- *
- **************************************************************************** */
- /**
- * A dictionary with formulas for calculating number of bins based on the
- * base series
- **/
- var binsNumberFormulas = {
- 'square-root': function (baseSeries) {
- return Math.round(Math.sqrt(baseSeries.options.data.length));
- },
- 'sturges': function (baseSeries) {
- return Math.ceil(Math.log(baseSeries.options.data.length) * Math.LOG2E);
- },
- 'rice': function (baseSeries) {
- return Math.ceil(2 * Math.pow(baseSeries.options.data.length, 1 / 3));
- }
- };
- /**
- * Returns a function for mapping number to the closed (right opened) bins
- *
- * @param {number} binWidth - width of the bin
- * @returns {function}
- **/
- function fitToBinLeftClosed(binWidth) {
- return function (y) {
- return Math.floor(y / binWidth) * binWidth;
- };
- }
- /**
- * Identity function - takes a param and returns that param
- * It is used to grouping data with the same values
- *
- * @param {number} y - value
- * @returns {number}
- **/
- function identity(y) {
- return y;
- }
- /**
- * Histogram class
- *
- * @constructor seriesTypes.histogram
- * @augments seriesTypes.column
- * @mixes DerivedSeriesMixin
- **/
- /**
- * A histogram is a column series which represents the distribution of the data
- * set in the base series. Histogram splits data into bins and shows their
- * frequencies.
- *
- * @product highcharts
- * @sample {highcharts} highcharts/demo/histogram/ Histogram
- * @since 6.0.0
- * @extends plotOptions.column
- * @excluding boostThreshold, pointInterval, pointIntervalUnit, stacking
- * @optionparent plotOptions.histogram
- **/
- seriesType('histogram', 'column', {
- /**
- * A preferable number of bins. It is a suggestion, so a histogram may have
- * a different number of bins. By default it is set to the square root
- * of the base series' data length. Available options are: `square-root`,
- * `sturges`, `rice`. You can also define a function which takes a
- * `baseSeries` as a parameter and should return a positive integer.
- *
- * @type {String|Number|Function}
- * @validvalue ["square-root", "sturges", "rice"]
- */
- binsNumber: 'square-root',
- /**
- * Width of each bin. By default the bin's width is calculated as
- * `(max - min) / number of bins`. This option takes precedence over
- * [binsNumber](#plotOptions.histogram.binsNumber).
- *
- * @type {Number}
- */
- binWidth: undefined,
- pointPadding: 0,
- groupPadding: 0,
- grouping: false,
- pointPlacement: 'between',
- tooltip: {
- headerFormat: '',
- pointFormat: '<span style="font-size:10px">{point.x} - {point.x2}' +
- '</span><br/>' +
- '<span style="color:{point.color}">\u25CF</span>' +
- ' {series.name} <b>{point.y}</b><br/>'
- }
- }, merge(derivedSeriesMixin, {
- setDerivedData: function () {
- var data = this.derivedData(
- this.baseSeries.yData,
- this.binsNumber(),
- this.options.binWidth
- );
- this.setData(data, false);
- },
- derivedData: function (baseData, binsNumber, binWidth) {
- var max = arrayMax(baseData),
- min = arrayMin(baseData),
- frequencies = {},
- data = [],
- x,
- fitToBin;
- binWidth = this.binWidth = isNumber(binWidth) ?
- binWidth :
- (max - min) / binsNumber;
- fitToBin = binWidth ? fitToBinLeftClosed(binWidth) : identity;
- // If binWidth is 0 then max and min are equaled,
- // increment the x with some positive value to quit the loop
- for (
- x = fitToBin(min);
- x <= max;
- x = correctFloat(x + (binWidth || 1))
- ) {
- frequencies[correctFloat(fitToBin((x)))] = 0;
- }
- each(baseData, function (y) {
- var x = correctFloat(fitToBin(y));
- frequencies[x]++;
- });
- objectEach(frequencies, function (frequency, x) {
- data.push({
- x: Number(x),
- y: frequency,
- x2: correctFloat(Number(x) + binWidth)
- });
- });
- data.sort(function (a, b) {
- return a.x - b.x;
- });
- return data;
- },
- binsNumber: function () {
- var binsNumberOption = this.options.binsNumber;
- var binsNumber = binsNumberFormulas[binsNumberOption] ||
- // #7457
- (typeof binsNumberOption === 'function' && binsNumberOption);
- return Math.ceil(
- (binsNumber && binsNumber(this.baseSeries)) ||
- (
- isNumber(binsNumberOption) ?
- binsNumberOption :
- binsNumberFormulas['square-root'](this.baseSeries)
- )
- );
- }
- }));
- /**
- * A `histogram` series. If the [type](#series.histogram.type) option is not
- * specified, it is inherited from [chart.type](#chart.type).
- *
- * @type {Object}
- * @since 6.0.0
- * @extends series,plotOptions.histogram
- * @excluding dataParser,dataURL,data
- * @product highcharts
- * @apioption series.histogram
- */
- /**
- * An integer identifying the index to use for the base series, or a string
- * representing the id of the series.
- *
- * @type {Number|String}
- * @default undefined
- * @apioption series.histogram.baseSeries
- */
- /**
- * An array of data points for the series. For the `histogram` series type,
- * points are calculated dynamically. See
- * [histogram.baseSeries](#series.histogram.baseSeries).
- *
- * @type {Array<Object|Array>}
- * @since 6.0.0
- * @extends series.column.data
- * @product highcharts
- * @apioption series.histogram.data
- */
- }(Highcharts, derivedSeriesMixin));
- (function (H, derivedSeriesMixin) {
- var seriesType = H.seriesType,
- correctFloat = H.correctFloat,
- isNumber = H.isNumber,
- merge = H.merge,
- reduce = H.reduce;
- /** ****************************************************************************
- *
- * BELL CURVE
- *
- ******************************************************************************/
- function mean(data) {
- var length = data.length,
- sum = reduce(data, function (sum, value) {
- return (sum += value);
- }, 0);
- return length > 0 && sum / length;
- }
- function standardDeviation(data, average) {
- var len = data.length,
- sum;
- average = isNumber(average) ? average : mean(data);
- sum = reduce(data, function (sum, value) {
- var diff = value - average;
- return (sum += diff * diff);
- }, 0);
- return len > 1 && Math.sqrt(sum / (len - 1));
- }
- function normalDensity(x, mean, standardDeviation) {
- var translation = x - mean;
- return Math.exp(
- -(translation * translation) /
- (2 * standardDeviation * standardDeviation)
- ) / (standardDeviation * Math.sqrt(2 * Math.PI));
- }
- /**
- * Bell curve class
- *
- * @constructor seriesTypes.bellcurve
- * @augments seriesTypes.areaspline
- * @mixes DerivedSeriesMixin
- **/
- /**
- * A bell curve is an areaspline series which represents the probability density
- * function of the normal distribution. It calculates mean and standard
- * deviation of the base series data and plots the curve according to the
- * calculated parameters.
- *
- * @product highcharts
- * @sample {highcharts} highcharts/demo/bellcurve/ Bell curve
- * @since 6.0.0
- * @extends plotOptions.areaspline
- * @excluding boostThreshold,connectNulls,stacking,pointInterval,
- * pointIntervalUnit
- * @optionparent plotOptions.bellcurve
- **/
- seriesType('bellcurve', 'areaspline', {
- /**
- * This option allows to define the length of the bell curve. A unit of the
- * length of the bell curve is standard deviation.
- *
- * @sample highcharts/plotoptions/bellcurve-intervals-pointsininterval
- * Intervals and points in interval
- */
- intervals: 3,
- /**
- * Defines how many points should be plotted within 1 interval. See
- * `plotOptions.bellcurve.intervals`.
- *
- * @sample highcharts/plotoptions/bellcurve-intervals-pointsininterval
- * Intervals and points in interval
- */
- pointsInInterval: 3,
- marker: {
- enabled: false
- }
- }, merge(derivedSeriesMixin, {
- setMean: function () {
- this.mean = correctFloat(mean(this.baseSeries.yData));
- },
- setStandardDeviation: function () {
- this.standardDeviation = correctFloat(
- standardDeviation(this.baseSeries.yData, this.mean)
- );
- },
- setDerivedData: function () {
- if (this.baseSeries.yData.length > 1) {
- this.setMean();
- this.setStandardDeviation();
- this.setData(
- this.derivedData(this.mean, this.standardDeviation), false
- );
- }
- },
- derivedData: function (mean, standardDeviation) {
- var intervals = this.options.intervals,
- pointsInInterval = this.options.pointsInInterval,
- x = mean - intervals * standardDeviation,
- stop = intervals * pointsInInterval * 2 + 1,
- increment = standardDeviation / pointsInInterval,
- data = [],
- i;
- for (i = 0; i < stop; i++) {
- data.push([x, normalDensity(x, mean, standardDeviation)]);
- x += increment;
- }
- return data;
- }
- }));
- /**
- * A `bellcurve` series. If the [type](#series.bellcurve.type) option is not
- * specified, it is inherited from [chart.type](#chart.type).
- *
- * For options that apply to multiple series, it is recommended to add
- * them to the [plotOptions.series](#plotOptions.series) options structure.
- * To apply to all series of this specific type, apply it to
- * [plotOptions.bellcurve](#plotOptions.bellcurve).
- *
- * @type {Object}
- * @since 6.0.0
- * @extends series,plotOptions.bellcurve
- * @excluding dataParser,dataURL,data
- * @product highcharts
- * @apioption series.bellcurve
- */
- /**
- * An integer identifying the index to use for the base series, or a string
- * representing the id of the series.
- *
- * @type {Number|String}
- * @default undefined
- * @apioption series.bellcurve.baseSeries
- */
- /**
- * An array of data points for the series. For the `bellcurve` series type,
- * points are calculated dynamically.
- *
- * @type {Array<Object|Array>}
- * @since 6.0.0
- * @extends series.areaspline.data
- * @product highcharts
- * @apioption series.bellcurve.data
- */
- }(Highcharts, derivedSeriesMixin));
- }));
|