| 123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511512513514515516517518519520521522523524525526527528529530531532533534535536537538539540541542543544545546547548549550551552553554555556557558559560561562563564565566567568569570571572573574575576577578579580581582583584585586587588589590591592593594595596597598599600601602603604605606607608609610611612613614615616617618619620621622623624625626627628629630631632633634635636637638639640641642643644645646647648649650651652653654655656657658659660661662663664665666667668669670671672673674675676677678679680681682683684685686687688689690691692693694695696697698699700701702703704705706707708709710711712713714715716717718719720721722723724725726727728729730731732733734735736737738739740741742743744745746747748749750751752753754755756757758759760761762763764765766767768769770771772773774775776777778779780781782783784785786787788789790791792793794795796797798799800801802803804805806807808809810811812813814815816817818819820821822823824825826827828829830831832833834835836837838839840841842843844845846847848849850851852853854855856857858859860861862863864865866867868869870871872873874875876877878879880881882883884885886887888889890891892893894895896897898899900901902903904905906907908909910911912913914915916917918919920921922923924925926927928929930931932933934935936937938939940941942943944945946947948949950951952953954955956957958 |
- /* *
- *
- * (c) 2010-2020 Torstein Honsi
- *
- * License: www.highcharts.com/license
- *
- * !!!!!!! SOURCE GETS TRANSPILED BY TYPESCRIPT. EDIT TS FILE ONLY. !!!!!!!
- *
- * */
- 'use strict';
- import H from '../Core/Globals.js';
- import LegendSymbolMixin from '../Mixins/LegendSymbol.js';
- import SVGRenderer from '../Core/Renderer/SVG/SVGRenderer.js';
- import U from '../Core/Utilities.js';
- var clamp = U.clamp, extend = U.extend, fireEvent = U.fireEvent, isNumber = U.isNumber, merge = U.merge, pick = U.pick, seriesType = U.seriesType;
- /* *
- * @interface Highcharts.PointOptionsObject in parts/Point.ts
- */ /**
- * Heatmap series only. Point padding for a single point.
- * @name Highcharts.PointOptionsObject#pointPadding
- * @type {number|undefined}
- */ /**
- * Heatmap series only. The value of the point, resulting in a color controled
- * by options as set in the colorAxis configuration.
- * @name Highcharts.PointOptionsObject#value
- * @type {number|null|undefined}
- */
- ''; // detach doclets above
- import '../Core/Options.js';
- import '../Core/Series/Series.js';
- import '../Mixins/ColorMapSeries.js';
- var colorMapPointMixin = H.colorMapPointMixin, colorMapSeriesMixin = H.colorMapSeriesMixin, noop = H.noop, Series = H.Series, seriesTypes = H.seriesTypes, symbols = SVGRenderer.prototype.symbols;
- /**
- * @private
- * @class
- * @name Highcharts.seriesTypes.heatmap
- *
- * @augments Highcharts.Series
- */
- seriesType('heatmap', 'scatter',
- /**
- * A heatmap is a graphical representation of data where the individual
- * values contained in a matrix are represented as colors.
- *
- * @productdesc {highcharts}
- * Requires `modules/heatmap`.
- *
- * @sample highcharts/demo/heatmap/
- * Simple heatmap
- * @sample highcharts/demo/heatmap-canvas/
- * Heavy heatmap
- *
- * @extends plotOptions.scatter
- * @excluding animationLimit, connectEnds, connectNulls, cropThreshold,
- * dashStyle, findNearestPointBy, getExtremesFromAll, jitter,
- * linecap, lineWidth, pointInterval, pointIntervalUnit,
- * pointRange, pointStart, shadow, softThreshold, stacking,
- * step, threshold, cluster
- * @product highcharts highmaps
- * @optionparent plotOptions.heatmap
- */
- {
- /**
- * Animation is disabled by default on the heatmap series.
- */
- animation: false,
- /**
- * The border width for each heat map item.
- */
- borderWidth: 0,
- /**
- * Padding between the points in the heatmap.
- *
- * @type {number}
- * @default 0
- * @since 6.0
- * @apioption plotOptions.heatmap.pointPadding
- */
- /**
- * @default value
- * @apioption plotOptions.heatmap.colorKey
- */
- /**
- * The main color of the series. In heat maps this color is rarely used,
- * as we mostly use the color to denote the value of each point. Unless
- * options are set in the [colorAxis](#colorAxis), the default value
- * is pulled from the [options.colors](#colors) array.
- *
- * @type {Highcharts.ColorString|Highcharts.GradientColorObject|Highcharts.PatternObject}
- * @since 4.0
- * @product highcharts
- * @apioption plotOptions.heatmap.color
- */
- /**
- * The column size - how many X axis units each column in the heatmap
- * should span.
- *
- * @sample {highcharts} maps/demo/heatmap/
- * One day
- * @sample {highmaps} maps/demo/heatmap/
- * One day
- *
- * @type {number}
- * @default 1
- * @since 4.0
- * @product highcharts highmaps
- * @apioption plotOptions.heatmap.colsize
- */
- /**
- * The row size - how many Y axis units each heatmap row should span.
- *
- * @sample {highcharts} maps/demo/heatmap/
- * 1 by default
- * @sample {highmaps} maps/demo/heatmap/
- * 1 by default
- *
- * @type {number}
- * @default 1
- * @since 4.0
- * @product highcharts highmaps
- * @apioption plotOptions.heatmap.rowsize
- */
- /**
- * The color applied to null points. In styled mode, a general CSS class
- * is applied instead.
- *
- * @type {Highcharts.ColorString|Highcharts.GradientColorObject|Highcharts.PatternObject}
- */
- nullColor: '#f7f7f7',
- dataLabels: {
- formatter: function () {
- return this.point.value;
- },
- inside: true,
- verticalAlign: 'middle',
- crop: false,
- overflow: false,
- padding: 0 // #3837
- },
- /**
- * @excluding radius, enabledThreshold
- * @since 8.1
- */
- marker: {
- /**
- * A predefined shape or symbol for the marker. When undefined, the
- * symbol is pulled from options.symbols. Other possible values are
- * `'circle'`, `'square'`,`'diamond'`, `'triangle'`,
- * `'triangle-down'`, `'rect'`, and `'ellipse'`.
- *
- * Additionally, the URL to a graphic can be given on this form:
- * `'url(graphic.png)'`. Note that for the image to be applied to
- * exported charts, its URL needs to be accessible by the export
- * server.
- *
- * Custom callbacks for symbol path generation can also be added to
- * `Highcharts.SVGRenderer.prototype.symbols`. The callback is then
- * used by its method name, as shown in the demo.
- *
- * @sample {highcharts} highcharts/plotoptions/series-marker-symbol/
- * Predefined, graphic and custom markers
- * @sample {highstock} highcharts/plotoptions/series-marker-symbol/
- * Predefined, graphic and custom markers
- */
- symbol: 'rect',
- /** @ignore-option */
- radius: 0,
- lineColor: void 0,
- states: {
- /**
- * @excluding radius, radiusPlus
- */
- hover: {
- /**
- * Set the marker's fixed width on hover state.
- *
- * @sample {highcharts} maps/plotoptions/heatmap-marker-states-hover-width
- * 70px fixed marker's width and height on hover
- *
- * @type {number|undefined}
- * @default undefined
- * @product highcharts highmaps
- * @apioption plotOptions.heatmap.marker.states.hover.width
- */
- /**
- * Set the marker's fixed height on hover state.
- *
- * @sample {highcharts} maps/plotoptions/heatmap-marker-states-hover-width
- * 70px fixed marker's width and height on hover
- *
- * @type {number|undefined}
- * @default undefined
- * @product highcharts highmaps
- * @apioption plotOptions.heatmap.marker.states.hover.height
- */
- /**
- * The number of pixels to increase the width of the
- * selected point.
- *
- * @sample {highcharts} maps/plotoptions/heatmap-marker-states-hover-widthplus
- * 20px greater width and height on hover
- *
- * @type {number|undefined}
- * @default undefined
- * @product highcharts highmaps
- * @apioption plotOptions.heatmap.marker.states.hover.widthPlus
- */
- /**
- * The number of pixels to increase the height of the
- * selected point.
- *
- * @sample {highcharts} maps/plotoptions/heatmap-marker-states-hover-widthplus
- * 20px greater width and height on hover
- *
- * @type {number|undefined}
- * @default undefined
- * @product highcharts highmaps
- * @apioption plotOptions.heatmap.marker.states.hover.heightPlus
- */
- /**
- * The additional line width for a hovered point.
- *
- * @sample {highcharts} maps/plotoptions/heatmap-marker-states-hover-linewidthplus
- * 5 pixels wider lineWidth on hover
- * @sample {highmaps} maps/plotoptions/heatmap-marker-states-hover-linewidthplus
- * 5 pixels wider lineWidth on hover
- */
- lineWidthPlus: 0
- },
- /**
- * @excluding radius
- */
- select: {
- /**
- * Set the marker's fixed width on select state.
- *
- * @sample {highcharts} maps/plotoptions/heatmap-marker-states-hover-width
- * 70px fixed marker's width and height on hover
- *
- * @type {number|undefined}
- * @default undefined
- * @product highcharts highmaps
- * @apioption plotOptions.heatmap.marker.states.select.width
- */
- /**
- * Set the marker's fixed height on select state.
- *
- * @sample {highcharts} maps/plotoptions/heatmap-marker-states-hover-width
- * 70px fixed marker's width and height on hover
- *
- * @type {number|undefined}
- * @default undefined
- * @product highcharts highmaps
- * @apioption plotOptions.heatmap.marker.states.select.height
- */
- /**
- * The number of pixels to increase the width of the
- * selected point.
- *
- * @sample {highcharts} maps/plotoptions/heatmap-marker-states-hover-widthplus
- * 20px greater width and height on hover
- *
- * @type {number|undefined}
- * @default undefined
- * @product highcharts highmaps
- * @apioption plotOptions.heatmap.marker.states.select.widthPlus
- */
- /**
- * The number of pixels to increase the height of the
- * selected point.
- *
- * @sample {highcharts} maps/plotoptions/heatmap-marker-states-hover-widthplus
- * 20px greater width and height on hover
- *
- * @type {number|undefined}
- * @default undefined
- * @product highcharts highmaps
- * @apioption plotOptions.heatmap.marker.states.select.heightPlus
- */
- }
- }
- },
- clip: true,
- /** @ignore-option */
- pointRange: null,
- tooltip: {
- pointFormat: '{point.x}, {point.y}: {point.value}<br/>'
- },
- states: {
- hover: {
- /** @ignore-option */
- halo: false,
- /**
- * How much to brighten the point on interaction. Requires the
- * main color to be defined in hex or rgb(a) format.
- *
- * In styled mode, the hover brightening is by default replaced
- * with a fill-opacity set in the `.highcharts-point:hover`
- * rule.
- */
- brightness: 0.2
- }
- }
- }, merge(colorMapSeriesMixin, {
- pointArrayMap: ['y', 'value'],
- hasPointSpecificOptions: true,
- getExtremesFromAll: true,
- directTouch: true,
- /* eslint-disable valid-jsdoc */
- /**
- * Override the init method to add point ranges on both axes.
- *
- * @private
- * @function Highcharts.seriesTypes.heatmap#init
- * @return {void}
- */
- init: function () {
- var options;
- Series.prototype.init.apply(this, arguments);
- options = this.options;
- // #3758, prevent resetting in setData
- options.pointRange = pick(options.pointRange, options.colsize || 1);
- // general point range
- this.yAxis.axisPointRange = options.rowsize || 1;
- // Bind new symbol names
- extend(symbols, {
- ellipse: symbols.circle,
- rect: symbols.square
- });
- },
- getSymbol: Series.prototype.getSymbol,
- /**
- * @private
- * @function Highcharts.seriesTypes.heatmap#setClip
- * @return {void}
- */
- setClip: function (animation) {
- var series = this, chart = series.chart;
- Series.prototype.setClip.apply(series, arguments);
- if (series.options.clip !== false || animation) {
- series.markerGroup
- .clip((animation || series.clipBox) && series.sharedClipKey ?
- chart[series.sharedClipKey] :
- chart.clipRect);
- }
- },
- /**
- * @private
- * @function Highcharts.seriesTypes.heatmap#translate
- * @return {void}
- */
- translate: function () {
- var series = this, options = series.options, symbol = options.marker && options.marker.symbol || '', shape = symbols[symbol] ? symbol : 'rect', options = series.options, hasRegularShape = ['circle', 'square'].indexOf(shape) !== -1;
- series.generatePoints();
- series.points.forEach(function (point) {
- var pointAttr, sizeDiff, hasImage, cellAttr = point.getCellAttributes(), shapeArgs = {
- x: Math.min(cellAttr.x1, cellAttr.x2),
- y: Math.min(cellAttr.y1, cellAttr.y2),
- width: Math.max(Math.abs(cellAttr.x2 - cellAttr.x1), 0),
- height: Math.max(Math.abs(cellAttr.y2 - cellAttr.y1), 0)
- };
- hasImage = point.hasImage =
- (point.marker && point.marker.symbol || symbol || '')
- .indexOf('url') === 0;
- // If marker shape is regular (symetric), find shorter
- // cell's side.
- if (hasRegularShape) {
- sizeDiff = Math.abs(shapeArgs.width - shapeArgs.height);
- shapeArgs.x = Math.min(cellAttr.x1, cellAttr.x2) +
- (shapeArgs.width < shapeArgs.height ? 0 : sizeDiff / 2);
- shapeArgs.y = Math.min(cellAttr.y1, cellAttr.y2) +
- (shapeArgs.width < shapeArgs.height ? sizeDiff / 2 : 0);
- shapeArgs.width = shapeArgs.height =
- Math.min(shapeArgs.width, shapeArgs.height);
- }
- pointAttr = {
- plotX: (cellAttr.x1 + cellAttr.x2) / 2,
- plotY: (cellAttr.y1 + cellAttr.y2) / 2,
- clientX: (cellAttr.x1 + cellAttr.x2) / 2,
- shapeType: 'path',
- shapeArgs: merge(true, shapeArgs, {
- d: symbols[shape](shapeArgs.x, shapeArgs.y, shapeArgs.width, shapeArgs.height)
- })
- };
- if (hasImage) {
- point.marker = {
- width: shapeArgs.width,
- height: shapeArgs.height
- };
- }
- extend(point, pointAttr);
- });
- fireEvent(series, 'afterTranslate');
- },
- /**
- * @private
- * @function Highcharts.seriesTypes.heatmap#pointAttribs
- * @param {Highcharts.HeatmapPoint} point
- * @param {string} state
- * @return {Highcharts.SVGAttributes}
- */
- pointAttribs: function (point, state) {
- var series = this, attr = Series.prototype.pointAttribs
- .call(series, point, state), seriesOptions = series.options || {}, plotOptions = series.chart.options.plotOptions || {}, seriesPlotOptions = plotOptions.series || {}, heatmapPlotOptions = plotOptions.heatmap || {}, stateOptions, brightness,
- // Get old properties in order to keep backward compatibility
- borderColor = seriesOptions.borderColor ||
- heatmapPlotOptions.borderColor ||
- seriesPlotOptions.borderColor, borderWidth = seriesOptions.borderWidth ||
- heatmapPlotOptions.borderWidth ||
- seriesPlotOptions.borderWidth ||
- attr['stroke-width'];
- // Apply lineColor, or set it to default series color.
- attr.stroke = ((point && point.marker && point.marker.lineColor) ||
- (seriesOptions.marker && seriesOptions.marker.lineColor) ||
- borderColor ||
- this.color);
- // Apply old borderWidth property if exists.
- attr['stroke-width'] = borderWidth;
- if (state) {
- stateOptions =
- merge(seriesOptions.states[state], seriesOptions.marker &&
- seriesOptions.marker.states[state], point.options.states &&
- point.options.states[state] || {});
- brightness = stateOptions.brightness;
- attr.fill =
- stateOptions.color ||
- H.color(attr.fill).brighten(brightness || 0).get();
- attr.stroke = stateOptions.lineColor;
- }
- return attr;
- },
- /**
- * @private
- * @function Highcharts.seriesTypes.heatmap#markerAttribs
- * @param {Highcharts.HeatmapPoint} point
- * @return {Highcharts.SVGAttributes}
- */
- markerAttribs: function (point, state) {
- var pointMarkerOptions = point.marker || {}, seriesMarkerOptions = this.options.marker || {}, seriesStateOptions, pointStateOptions, shapeArgs = point.shapeArgs || {}, hasImage = point.hasImage, attribs = {};
- if (hasImage) {
- return {
- x: point.plotX,
- y: point.plotY
- };
- }
- // Setting width and height attributes on image does not affect
- // on its dimensions.
- if (state) {
- seriesStateOptions = seriesMarkerOptions.states[state] || {};
- pointStateOptions = pointMarkerOptions.states &&
- pointMarkerOptions.states[state] || {};
- [['width', 'x'], ['height', 'y']].forEach(function (dimension) {
- // Set new width and height basing on state options.
- attribs[dimension[0]] = (pointStateOptions[dimension[0]] ||
- seriesStateOptions[dimension[0]] ||
- shapeArgs[dimension[0]]) + (pointStateOptions[dimension[0] + 'Plus'] ||
- seriesStateOptions[dimension[0] + 'Plus'] || 0);
- // Align marker by a new size.
- attribs[dimension[1]] = shapeArgs[dimension[1]] +
- (shapeArgs[dimension[0]] - attribs[dimension[0]]) / 2;
- });
- }
- return state ? attribs : shapeArgs;
- },
- /**
- * @private
- * @function Highcharts.seriesTypes.heatmap#drawPoints
- * @return {void}
- */
- drawPoints: function () {
- var _this = this;
- // In styled mode, use CSS, otherwise the fill used in the style
- // sheet will take precedence over the fill attribute.
- var seriesMarkerOptions = this.options.marker || {};
- if (seriesMarkerOptions.enabled || this._hasPointMarkers) {
- Series.prototype.drawPoints.call(this);
- this.points.forEach(function (point) {
- point.graphic &&
- point.graphic[_this.chart.styledMode ? 'css' : 'animate'](_this.colorAttribs(point));
- });
- }
- },
- // Define hasData function for non-cartesian series.
- // Returns true if the series has points at all.
- hasData: function () {
- return !!this.processedXData.length; // != 0
- },
- // Override to also allow null points, used when building the k-d-tree
- // for tooltips in boost mode.
- getValidPoints: function (points, insideOnly) {
- return Series.prototype.getValidPoints.call(this, points, insideOnly, true);
- },
- /**
- * @ignore
- * @deprecated
- * @function Highcharts.seriesTypes.heatmap#getBox
- */
- getBox: noop,
- /**
- * @private
- * @borrows Highcharts.LegendSymbolMixin.drawRectangle as Highcharts.seriesTypes.heatmap#drawLegendSymbol
- */
- drawLegendSymbol: LegendSymbolMixin.drawRectangle,
- /**
- * @private
- * @borrows Highcharts.seriesTypes.column#alignDataLabel as Highcharts.seriesTypes.heatmap#alignDataLabel
- */
- alignDataLabel: seriesTypes.column.prototype.alignDataLabel,
- /**
- * @private
- * @function Highcharts.seriesTypes.heatmap#getExtremes
- * @return {void}
- */
- getExtremes: function () {
- // Get the extremes from the value data
- var _a = Series.prototype.getExtremes
- .call(this, this.valueData), dataMin = _a.dataMin, dataMax = _a.dataMax;
- if (isNumber(dataMin)) {
- this.valueMin = dataMin;
- }
- if (isNumber(dataMax)) {
- this.valueMax = dataMax;
- }
- // Get the extremes from the y data
- return Series.prototype.getExtremes.call(this);
- }
- /* eslint-enable valid-jsdoc */
- }), merge(colorMapPointMixin, {
- /**
- * Heatmap series only. Padding between the points in the heatmap.
- * @name Highcharts.Point#pointPadding
- * @type {number|undefined}
- */
- /**
- * Heatmap series only. The value of the point, resulting in a color
- * controled by options as set in the colorAxis configuration.
- * @name Highcharts.Point#value
- * @type {number|null|undefined}
- */
- /* eslint-disable valid-jsdoc */
- /**
- * @private
- * @function Highcharts.Point#applyOptions
- * @param {Highcharts.HeatmapPointOptions} options
- * @param {number} x
- * @return {Highcharts.SVGPathArray}
- */
- applyOptions: function (options, x) {
- var point = H.Point.prototype
- .applyOptions.call(this, options, x);
- point.formatPrefix =
- point.isNull || point.value === null ?
- 'null' : 'point';
- return point;
- },
- /**
- * Color points have a value option that determines whether or not it is
- * a null point
- * @private
- * @function Highcharts.HeatmapPoint.isValid
- * @return {boolean}
- */
- isValid: function () {
- // undefined is allowed
- return (this.value !== Infinity &&
- this.value !== -Infinity);
- },
- /**
- * @private
- * @function Highcharts.Point#haloPath
- * @param {number} size
- * @return {Highcharts.SVGPathArray}
- */
- haloPath: function (size) {
- if (!size) {
- return [];
- }
- var rect = this.shapeArgs;
- return [
- 'M',
- rect.x - size,
- rect.y - size,
- 'L',
- rect.x - size,
- rect.y + rect.height + size,
- rect.x + rect.width + size,
- rect.y + rect.height + size,
- rect.x + rect.width + size,
- rect.y - size,
- 'Z'
- ];
- },
- getCellAttributes: function () {
- var point = this, series = point.series, seriesOptions = series.options, xPad = (seriesOptions.colsize || 1) / 2, yPad = (seriesOptions.rowsize || 1) / 2, xAxis = series.xAxis, yAxis = series.yAxis, markerOptions = point.options.marker || series.options.marker, pointPlacement = series.pointPlacementToXValue(), // #7860
- pointPadding = pick(point.pointPadding, seriesOptions.pointPadding, 0), cellAttr = {
- x1: clamp(Math.round(xAxis.len -
- (xAxis.translate(point.x - xPad, false, true, false, true, -pointPlacement) || 0)), -xAxis.len, 2 * xAxis.len),
- x2: clamp(Math.round(xAxis.len -
- (xAxis.translate(point.x + xPad, false, true, false, true, -pointPlacement) || 0)), -xAxis.len, 2 * xAxis.len),
- y1: clamp(Math.round((yAxis.translate(point.y - yPad, false, true, false, true) || 0)), -yAxis.len, 2 * yAxis.len),
- y2: clamp(Math.round((yAxis.translate(point.y + yPad, false, true, false, true) || 0)), -yAxis.len, 2 * yAxis.len)
- };
- // Handle marker's fixed width, and height values including border
- // and pointPadding while calculating cell attributes.
- [['width', 'x'], ['height', 'y']].forEach(function (dimension) {
- var prop = dimension[0], direction = dimension[1];
- var start = direction + '1', end = direction + '2';
- var side = Math.abs(cellAttr[start] - cellAttr[end]), borderWidth = markerOptions &&
- markerOptions.lineWidth || 0, plotPos = Math.abs(cellAttr[start] + cellAttr[end]) / 2;
- if (markerOptions[prop] &&
- markerOptions[prop] < side) {
- cellAttr[start] = plotPos - (markerOptions[prop] / 2) -
- (borderWidth / 2);
- cellAttr[end] = plotPos + (markerOptions[prop] / 2) +
- (borderWidth / 2);
- }
- // Handle pointPadding
- if (pointPadding) {
- if (direction === 'y') {
- start = end;
- end = direction + '1';
- }
- cellAttr[start] += pointPadding;
- cellAttr[end] -= pointPadding;
- }
- });
- return cellAttr;
- }
- /* eslint-enable valid-jsdoc */
- }));
- /**
- * A `heatmap` series. If the [type](#series.heatmap.type) option is
- * not specified, it is inherited from [chart.type](#chart.type).
- *
- * @productdesc {highcharts}
- * Requires `modules/heatmap`.
- *
- * @extends series,plotOptions.heatmap
- * @excluding cropThreshold, dataParser, dataURL, pointRange, stack,
- * @product highcharts highmaps
- * @apioption series.heatmap
- */
- /**
- * An array of data points for the series. For the `heatmap` series
- * type, points can be given in the following ways:
- *
- * 1. An array of arrays with 3 or 2 values. In this case, the values
- * correspond to `x,y,value`. If the first value is a string, it is
- * applied as the name of the point, and the `x` value is inferred.
- * The `x` value can also be omitted, in which case the inner arrays
- * should be of length 2\. Then the `x` value is automatically calculated,
- * either starting at 0 and incremented by 1, or from `pointStart`
- * and `pointInterval` given in the series options.
- *
- * ```js
- * data: [
- * [0, 9, 7],
- * [1, 10, 4],
- * [2, 6, 3]
- * ]
- * ```
- *
- * 2. An array of objects with named values. The following snippet shows only a
- * few settings, see the complete options set below. If the total number of data
- * points exceeds the series' [turboThreshold](#series.heatmap.turboThreshold),
- * this option is not available.
- *
- * ```js
- * data: [{
- * x: 1,
- * y: 3,
- * value: 10,
- * name: "Point2",
- * color: "#00FF00"
- * }, {
- * x: 1,
- * y: 7,
- * value: 10,
- * name: "Point1",
- * color: "#FF00FF"
- * }]
- * ```
- *
- * @sample {highcharts} highcharts/chart/reflow-true/
- * Numerical values
- * @sample {highcharts} highcharts/series/data-array-of-arrays/
- * Arrays of numeric x and y
- * @sample {highcharts} highcharts/series/data-array-of-arrays-datetime/
- * Arrays of datetime x and y
- * @sample {highcharts} highcharts/series/data-array-of-name-value/
- * Arrays of point.name and y
- * @sample {highcharts} highcharts/series/data-array-of-objects/
- * Config objects
- *
- * @type {Array<Array<number>|*>}
- * @extends series.line.data
- * @product highcharts highmaps
- * @apioption series.heatmap.data
- */
- /**
- * The color of the point. In heat maps the point color is rarely set
- * explicitly, as we use the color to denote the `value`. Options for
- * this are set in the [colorAxis](#colorAxis) configuration.
- *
- * @type {Highcharts.ColorString|Highcharts.GradientColorObject|Highcharts.PatternObject}
- * @product highcharts highmaps
- * @apioption series.heatmap.data.color
- */
- /**
- * The value of the point, resulting in a color controled by options
- * as set in the [colorAxis](#colorAxis) configuration.
- *
- * @type {number}
- * @product highcharts highmaps
- * @apioption series.heatmap.data.value
- */
- /**
- * The x value of the point. For datetime axes,
- * the X value is the timestamp in milliseconds since 1970.
- *
- * @type {number}
- * @product highcharts highmaps
- * @apioption series.heatmap.data.x
- */
- /**
- * The y value of the point.
- *
- * @type {number}
- * @product highcharts highmaps
- * @apioption series.heatmap.data.y
- */
- /**
- * Point padding for a single point.
- *
- * @sample maps/plotoptions/tilemap-pointpadding
- * Point padding on tiles
- *
- * @type {number}
- * @product highcharts highmaps
- * @apioption series.heatmap.data.pointPadding
- */
- /**
- * @excluding radius, enabledThreshold
- * @product highcharts highmaps
- * @since 8.1
- * @apioption series.heatmap.data.marker
- */
- /**
- * @excluding radius, enabledThreshold
- * @product highcharts highmaps
- * @since 8.1
- * @apioption series.heatmap.marker
- */
- /**
- * @excluding radius, radiusPlus
- * @product highcharts highmaps
- * @apioption series.heatmap.marker.states.hover
- */
- /**
- * @excluding radius
- * @product highcharts highmaps
- * @apioption series.heatmap.marker.states.select
- */
- /**
- * @excluding radius, radiusPlus
- * @product highcharts highmaps
- * @apioption series.heatmap.data.marker.states.hover
- */
- /**
- * @excluding radius
- * @product highcharts highmaps
- * @apioption series.heatmap.data.marker.states.select
- */
- /**
- * Set the marker's fixed width on hover state.
- *
- * @sample {highcharts} maps/plotoptions/heatmap-marker-states-hover-linewidthplus
- * 5 pixels wider lineWidth on hover
- *
- * @type {number|undefined}
- * @default 0
- * @product highcharts highmaps
- * @apioption series.heatmap.marker.states.hover.lineWidthPlus
- */
- /**
- * Set the marker's fixed width on hover state.
- *
- * @sample {highcharts} maps/plotoptions/heatmap-marker-states-hover-width
- * 70px fixed marker's width and height on hover
- *
- * @type {number|undefined}
- * @default undefined
- * @product highcharts highmaps
- * @apioption series.heatmap.marker.states.hover.width
- */
- /**
- * Set the marker's fixed height on hover state.
- *
- * @sample {highcharts} maps/plotoptions/heatmap-marker-states-hover-width
- * 70px fixed marker's width and height on hover
- *
- * @type {number|undefined}
- * @default undefined
- * @product highcharts highmaps
- * @apioption series.heatmap.marker.states.hover.height
- */
- /**
- * The number of pixels to increase the width of the
- * hovered point.
- *
- * @sample {highcharts} maps/plotoptions/heatmap-marker-states-hover-widthplus
- * One day
- *
- * @type {number|undefined}
- * @default undefined
- * @product highcharts highmaps
- * @apioption series.heatmap.marker.states.hover.widthPlus
- */
- /**
- * The number of pixels to increase the height of the
- * hovered point.
- *
- * @sample {highcharts} maps/plotoptions/heatmap-marker-states-hover-widthplus
- * One day
- *
- * @type {number|undefined}
- * @default undefined
- * @product highcharts highmaps
- * @apioption series.heatmap.marker.states.hover.heightPlus
- */
- /**
- * The number of pixels to increase the width of the
- * hovered point.
- *
- * @sample {highcharts} maps/plotoptions/heatmap-marker-states-hover-widthplus
- * One day
- *
- * @type {number|undefined}
- * @default undefined
- * @product highcharts highmaps
- * @apioption series.heatmap.marker.states.select.widthPlus
- */
- /**
- * The number of pixels to increase the height of the
- * hovered point.
- *
- * @sample {highcharts} maps/plotoptions/heatmap-marker-states-hover-widthplus
- * One day
- *
- * @type {number|undefined}
- * @default undefined
- * @product highcharts highmaps
- * @apioption series.heatmap.marker.states.select.heightPlus
- */
- /**
- * Set the marker's fixed width on hover state.
- *
- * @sample {highcharts} maps/plotoptions/heatmap-marker-states-hover-linewidthplus
- * 5 pixels wider lineWidth on hover
- *
- * @type {number|undefined}
- * @default 0
- * @product highcharts highmaps
- * @apioption series.heatmap.data.marker.states.hover.lineWidthPlus
- */
- /**
- * Set the marker's fixed width on hover state.
- *
- * @sample {highcharts} maps/plotoptions/heatmap-marker-states-hover-width
- * 70px fixed marker's width and height on hover
- *
- * @type {number|undefined}
- * @default undefined
- * @product highcharts highmaps
- * @apioption series.heatmap.data.marker.states.hover.width
- */
- /**
- * Set the marker's fixed height on hover state.
- *
- * @sample {highcharts} maps/plotoptions/heatmap-marker-states-hover-width
- * 70px fixed marker's width and height on hover
- *
- * @type {number|undefined}
- * @default undefined
- * @product highcharts highmaps
- * @apioption series.heatmap.data.marker.states.hover.height
- */
- /**
- * The number of pixels to increase the width of the
- * hovered point.
- *
- * @sample {highcharts} maps/plotoptions/heatmap-marker-states-hover-widthplus
- * One day
- *
- * @type {number|undefined}
- * @default undefined
- * @product highcharts highstock
- * @apioption series.heatmap.data.marker.states.hover.widthPlus
- */
- /**
- * The number of pixels to increase the height of the
- * hovered point.
- *
- * @sample {highcharts} maps/plotoptions/heatmap-marker-states-hover-widthplus
- * One day
- *
- * @type {number|undefined}
- * @default undefined
- * @product highcharts highstock
- * @apioption series.heatmap.data.marker.states.hover.heightPlus
- */
- /**
- * Set the marker's fixed width on select state.
- *
- * @sample {highcharts} maps/plotoptions/heatmap-marker-states-hover-width
- * 70px fixed marker's width and height on hover
- *
- * @type {number|undefined}
- * @default undefined
- * @product highcharts highmaps
- * @apioption series.heatmap.data.marker.states.select.width
- */
- /**
- * Set the marker's fixed height on select state.
- *
- * @sample {highcharts} maps/plotoptions/heatmap-marker-states-hover-width
- * 70px fixed marker's width and height on hover
- *
- * @type {number|undefined}
- * @default undefined
- * @product highcharts highmaps
- * @apioption series.heatmap.data.marker.states.select.height
- */
- /**
- * The number of pixels to increase the width of the
- * hovered point.
- *
- * @sample {highcharts} maps/plotoptions/heatmap-marker-states-hover-widthplus
- * One day
- *
- * @type {number|undefined}
- * @default undefined
- * @product highcharts highstock
- * @apioption series.heatmap.data.marker.states.select.widthPlus
- */
- /**
- * The number of pixels to increase the height of the
- * hovered point.
- *
- * @sample {highcharts} maps/plotoptions/heatmap-marker-states-hover-widthplus
- * One day
- *
- * @type {number|undefined}
- * @default undefined
- * @product highcharts highstock
- * @apioption series.heatmap.data.marker.states.select.heightPlus
- */
- ''; // adds doclets above to transpiled file
|