12345678910111213141516171819202122232425262728293031323334353637383940414243444546474849505152535455565758596061626364656667686970717273747576777879808182838485868788899091929394959697989910010110210310410510610710810911011111211311411511611711811912012112212312412512612712812913013113213313413513613713813914014114214314414514614714814915015115215315415515615715815916016116216316416516616716816917017117217317417517617717817918018118218318418518618718818919019119219319419519619719819920020120220320420520620720820921021121221321421521621721821922022122222322422522622722822923023123223323423523623723823924024124224324424524624724824925025125225325425525625725825926026126226326426526626726826927027127227327427527627727827928028128228328428528628728828929029129229329429529629729829930030130230330430530630730830931031131231331431531631731831932032132232332432532632732832933033133233333433533633733833934034134234334434534634734834935035135235335435535635735835936036136236336436536636736836937037137237337437537637737837938038138238338438538638738838939039139239339439539639739839940040140240340440540640740840941041141241341441541641741841942042142242342442542642742842943043143243343443543643743843944044144244344444544644744844945045145245345445545645745845946046146246346446546646746846947047147247347447547647747847948048148248348448548648748848949049149249349449549649749849950050150250350450550650750850951051151251351451551651751851952052152252352452552652752852953053153253353453553653753853954054154254354454554654754854955055155255355455555655755855956056156256356456556656756856957057157257357457557657757857958058158258358458558658758858959059159259359459559659759859960060160260360460560660760860961061161261361461561661761861962062162262362462562662762862963063163263363463563663763863964064164264364464564664764864965065165265365465565665765865966066166266366466566666766866967067167267367467567667767867968068168268368468568668768868969069169269369469569669769869970070170270370470570670770870971071171271371471571671771871972072172272372472572672772872973073173273373473573673773873974074174274374474574674774874975075175275375475575675775875976076176276376476576676776876977077177277377477577677777877978078178278378478578678778878979079179279379479579679779879980080180280380480580680780880981081181281381481581681781881982082182282382482582682782882983083183283383483583683783883984084184284384484584684784884985085185285385485585685785885986086186286386486586686786886987087187287387487587687787887988088188288388488588688788888989089189289389489589689789889990090190290390490590690790890991091191291391491591691791891992092192292392492592692792892993093193293393493593693793893994094194294394494594694794894995095195295395495595695795895996096196296396496596696796896997097197297397497597697797897998098198298398498598698798898999099199299399499599699799899910001001100210031004100510061007100810091010101110121013101410151016101710181019102010211022102310241025102610271028102910301031103210331034103510361037103810391040104110421043104410451046104710481049105010511052105310541055105610571058105910601061106210631064106510661067106810691070107110721073107410751076107710781079108010811082108310841085108610871088108910901091109210931094109510961097109810991100110111021103110411051106110711081109111011111112111311141115111611171118111911201121112211231124112511261127112811291130113111321133113411351136113711381139114011411142114311441145114611471148114911501151115211531154115511561157115811591160116111621163116411651166116711681169117011711172117311741175117611771178117911801181118211831184118511861187118811891190119111921193119411951196119711981199120012011202120312041205120612071208120912101211121212131214121512161217121812191220122112221223122412251226122712281229123012311232123312341235123612371238123912401241124212431244124512461247124812491250125112521253125412551256125712581259126012611262126312641265126612671268126912701271127212731274127512761277127812791280128112821283128412851286128712881289129012911292129312941295129612971298129913001301130213031304130513061307130813091310131113121313131413151316131713181319132013211322132313241325132613271328132913301331133213331334133513361337133813391340134113421343134413451346134713481349135013511352135313541355135613571358135913601361136213631364136513661367136813691370137113721373137413751376137713781379138013811382138313841385138613871388138913901391139213931394139513961397139813991400140114021403140414051406140714081409141014111412141314141415141614171418141914201421142214231424142514261427142814291430143114321433143414351436143714381439144014411442144314441445144614471448144914501451145214531454145514561457145814591460146114621463146414651466146714681469147014711472147314741475147614771478147914801481148214831484148514861487148814891490149114921493149414951496149714981499150015011502150315041505150615071508150915101511151215131514151515161517151815191520152115221523152415251526152715281529153015311532153315341535153615371538153915401541154215431544154515461547154815491550155115521553155415551556155715581559156015611562156315641565156615671568156915701571157215731574157515761577157815791580158115821583158415851586158715881589159015911592159315941595159615971598159916001601160216031604160516061607160816091610161116121613161416151616161716181619162016211622162316241625162616271628162916301631163216331634163516361637163816391640164116421643164416451646164716481649165016511652165316541655165616571658165916601661166216631664166516661667166816691670167116721673167416751676167716781679168016811682168316841685168616871688168916901691169216931694169516961697169816991700170117021703170417051706170717081709171017111712171317141715171617171718171917201721172217231724172517261727172817291730173117321733173417351736173717381739174017411742 |
- /**
- * @license Highcharts JS v9.1.1 (2021-06-04)
- *
- * Sankey diagram module
- *
- * (c) 2010-2021 Torstein Honsi
- *
- * License: www.highcharts.com/license
- */
- 'use strict';
- (function (factory) {
- if (typeof module === 'object' && module.exports) {
- factory['default'] = factory;
- module.exports = factory;
- } else if (typeof define === 'function' && define.amd) {
- define('highcharts/modules/sankey', ['highcharts'], function (Highcharts) {
- factory(Highcharts);
- factory.Highcharts = Highcharts;
- return factory;
- });
- } else {
- factory(typeof Highcharts !== 'undefined' ? Highcharts : undefined);
- }
- }(function (Highcharts) {
- var _modules = Highcharts ? Highcharts._modules : {};
- function _registerModule(obj, path, args, fn) {
- if (!obj.hasOwnProperty(path)) {
- obj[path] = fn.apply(null, args);
- }
- }
- _registerModule(_modules, 'Mixins/Nodes.js', [_modules['Core/Globals.js'], _modules['Core/Series/Point.js'], _modules['Core/Series/Series.js'], _modules['Core/Utilities.js']], function (H, Point, Series, U) {
- /* *
- *
- * !!!!!!! SOURCE GETS TRANSPILED BY TYPESCRIPT. EDIT TS FILE ONLY. !!!!!!!
- *
- * */
- var defined = U.defined,
- extend = U.extend,
- find = U.find,
- pick = U.pick;
- var NodesMixin = H.NodesMixin = {
- /* eslint-disable valid-jsdoc */
- /**
- * Create a single node that holds information on incoming and outgoing
- * links.
- * @private
- */
- createNode: function (id) {
- /**
- * @private
- */
- function findById(nodes,
- id) {
- return find(nodes,
- function (node) {
- return node.id === id;
- });
- }
- var node = findById(this.nodes,
- id),
- PointClass = this.pointClass,
- options;
- if (!node) {
- options = this.options.nodes && findById(this.options.nodes, id);
- node = (new PointClass()).init(this, extend({
- className: 'highcharts-node',
- isNode: true,
- id: id,
- y: 1 // Pass isNull test
- }, options));
- node.linksTo = [];
- node.linksFrom = [];
- node.formatPrefix = 'node';
- node.name = node.name || node.options.id || ''; // for use in formats
- // Mass is used in networkgraph:
- node.mass = pick(
- // Node:
- node.options.mass, node.options.marker && node.options.marker.radius,
- // Series:
- this.options.marker && this.options.marker.radius,
- // Default:
- 4);
- /**
- * Return the largest sum of either the incoming or outgoing links.
- * @private
- */
- node.getSum = function () {
- var sumTo = 0,
- sumFrom = 0;
- node.linksTo.forEach(function (link) {
- sumTo += link.weight;
- });
- node.linksFrom.forEach(function (link) {
- sumFrom += link.weight;
- });
- return Math.max(sumTo, sumFrom);
- };
- /**
- * Get the offset in weight values of a point/link.
- * @private
- */
- node.offset = function (point, coll) {
- var offset = 0;
- for (var i = 0; i < node[coll].length; i++) {
- if (node[coll][i] === point) {
- return offset;
- }
- offset += node[coll][i].weight;
- }
- };
- // Return true if the node has a shape, otherwise all links are
- // outgoing.
- node.hasShape = function () {
- var outgoing = 0;
- node.linksTo.forEach(function (link) {
- if (link.outgoing) {
- outgoing++;
- }
- });
- return (!node.linksTo.length ||
- outgoing !== node.linksTo.length);
- };
- this.nodes.push(node);
- }
- return node;
- },
- /**
- * Extend generatePoints by adding the nodes, which are Point objects
- * but pushed to the this.nodes array.
- */
- generatePoints: function () {
- var chart = this.chart,
- nodeLookup = {};
- Series.prototype.generatePoints.call(this);
- if (!this.nodes) {
- this.nodes = []; // List of Point-like node items
- }
- this.colorCounter = 0;
- // Reset links from previous run
- this.nodes.forEach(function (node) {
- node.linksFrom.length = 0;
- node.linksTo.length = 0;
- node.level = node.options.level;
- });
- // Create the node list and set up links
- this.points.forEach(function (point) {
- if (defined(point.from)) {
- if (!nodeLookup[point.from]) {
- nodeLookup[point.from] = this.createNode(point.from);
- }
- nodeLookup[point.from].linksFrom.push(point);
- point.fromNode = nodeLookup[point.from];
- // Point color defaults to the fromNode's color
- if (chart.styledMode) {
- point.colorIndex = pick(point.options.colorIndex, nodeLookup[point.from].colorIndex);
- }
- else {
- point.color =
- point.options.color || nodeLookup[point.from].color;
- }
- }
- if (defined(point.to)) {
- if (!nodeLookup[point.to]) {
- nodeLookup[point.to] = this.createNode(point.to);
- }
- nodeLookup[point.to].linksTo.push(point);
- point.toNode = nodeLookup[point.to];
- }
- point.name = point.name || point.id; // for use in formats
- }, this);
- // Store lookup table for later use
- this.nodeLookup = nodeLookup;
- },
- // Destroy all nodes on setting new data
- setData: function () {
- if (this.nodes) {
- this.nodes.forEach(function (node) {
- node.destroy();
- });
- this.nodes.length = 0;
- }
- Series.prototype.setData.apply(this, arguments);
- },
- // Destroy alll nodes and links
- destroy: function () {
- // Nodes must also be destroyed (#8682, #9300)
- this.data = []
- .concat(this.points || [], this.nodes);
- return Series.prototype.destroy.apply(this, arguments);
- },
- /**
- * When hovering node, highlight all connected links. When hovering a link,
- * highlight all connected nodes.
- */
- setNodeState: function (state) {
- var args = arguments,
- others = this.isNode ? this.linksTo.concat(this.linksFrom) :
- [this.fromNode,
- this.toNode];
- if (state !== 'select') {
- others.forEach(function (linkOrNode) {
- if (linkOrNode && linkOrNode.series) {
- Point.prototype.setState.apply(linkOrNode, args);
- if (!linkOrNode.isNode) {
- if (linkOrNode.fromNode.graphic) {
- Point.prototype.setState.apply(linkOrNode.fromNode, args);
- }
- if (linkOrNode.toNode && linkOrNode.toNode.graphic) {
- Point.prototype.setState.apply(linkOrNode.toNode, args);
- }
- }
- }
- });
- }
- Point.prototype.setState.apply(this, args);
- }
- /* eslint-enable valid-jsdoc */
- };
- return NodesMixin;
- });
- _registerModule(_modules, 'Series/Sankey/SankeyPoint.js', [_modules['Mixins/Nodes.js'], _modules['Core/Series/Point.js'], _modules['Core/Series/SeriesRegistry.js'], _modules['Core/Utilities.js']], function (NodesMixin, Point, SeriesRegistry, U) {
- /* *
- *
- * Sankey diagram module
- *
- * (c) 2010-2021 Torstein Honsi
- *
- * License: www.highcharts.com/license
- *
- * !!!!!!! SOURCE GETS TRANSPILED BY TYPESCRIPT. EDIT TS FILE ONLY. !!!!!!!
- *
- * */
- var __extends = (this && this.__extends) || (function () {
- var extendStatics = function (d,
- b) {
- extendStatics = Object.setPrototypeOf ||
- ({ __proto__: [] } instanceof Array && function (d,
- b) { d.__proto__ = b; }) ||
- function (d,
- b) { for (var p in b) if (b.hasOwnProperty(p)) d[p] = b[p]; };
- return extendStatics(d, b);
- };
- return function (d, b) {
- extendStatics(d, b);
- function __() { this.constructor = d; }
- d.prototype = b === null ? Object.create(b) : (__.prototype = b.prototype, new __());
- };
- })();
- var ColumnSeries = SeriesRegistry.seriesTypes.column;
- var defined = U.defined,
- extend = U.extend;
- /* *
- *
- * Class
- *
- * */
- var SankeyPoint = /** @class */ (function (_super) {
- __extends(SankeyPoint, _super);
- function SankeyPoint() {
- /* *
- *
- * Properties
- *
- * */
- var _this = _super !== null && _super.apply(this,
- arguments) || this;
- _this.className = void 0;
- _this.fromNode = void 0;
- _this.level = void 0;
- _this.linkBase = void 0;
- _this.linksFrom = void 0;
- _this.linksTo = void 0;
- _this.mass = void 0;
- _this.nodeX = void 0;
- _this.nodeY = void 0;
- _this.options = void 0;
- _this.series = void 0;
- _this.toNode = void 0;
- return _this;
- /* eslint-enable valid-jsdoc */
- }
- /* *
- *
- * Functions
- *
- * */
- /* eslint-disable valid-jsdoc */
- /**
- * @private
- */
- SankeyPoint.prototype.applyOptions = function (options, x) {
- Point.prototype.applyOptions.call(this, options, x);
- // Treat point.level as a synonym of point.column
- if (defined(this.options.level)) {
- this.options.column = this.column = this.options.level;
- }
- return this;
- };
- /**
- * @private
- */
- SankeyPoint.prototype.getClassName = function () {
- return (this.isNode ? 'highcharts-node ' : 'highcharts-link ') +
- Point.prototype.getClassName.call(this);
- };
- /**
- * @private
- */
- SankeyPoint.prototype.isValid = function () {
- return this.isNode || typeof this.weight === 'number';
- };
- return SankeyPoint;
- }(ColumnSeries.prototype.pointClass));
- extend(SankeyPoint.prototype, {
- setState: NodesMixin.setNodeState
- });
- /* *
- *
- * Default Export
- *
- * */
- return SankeyPoint;
- });
- _registerModule(_modules, 'Mixins/TreeSeries.js', [_modules['Core/Color/Color.js'], _modules['Core/Utilities.js']], function (Color, U) {
- /* *
- *
- * !!!!!!! SOURCE GETS TRANSPILED BY TYPESCRIPT. EDIT TS FILE ONLY. !!!!!!!
- *
- * */
- var extend = U.extend,
- isArray = U.isArray,
- isNumber = U.isNumber,
- isObject = U.isObject,
- merge = U.merge,
- pick = U.pick;
- var isBoolean = function (x) {
- return typeof x === 'boolean';
- }, isFn = function (x) {
- return typeof x === 'function';
- };
- /* eslint-disable valid-jsdoc */
- /**
- * @todo Combine buildTree and buildNode with setTreeValues
- * @todo Remove logic from Treemap and make it utilize this mixin.
- * @private
- */
- var setTreeValues = function setTreeValues(tree,
- options) {
- var before = options.before,
- idRoot = options.idRoot,
- mapIdToNode = options.mapIdToNode,
- nodeRoot = mapIdToNode[idRoot],
- levelIsConstant = (isBoolean(options.levelIsConstant) ?
- options.levelIsConstant :
- true),
- points = options.points,
- point = points[tree.i],
- optionsPoint = point && point.options || {},
- childrenTotal = 0,
- children = [],
- value;
- tree.levelDynamic = tree.level - (levelIsConstant ? 0 : nodeRoot.level);
- tree.name = pick(point && point.name, '');
- tree.visible = (idRoot === tree.id ||
- (isBoolean(options.visible) ? options.visible : false));
- if (isFn(before)) {
- tree = before(tree, options);
- }
- // First give the children some values
- tree.children.forEach(function (child, i) {
- var newOptions = extend({},
- options);
- extend(newOptions, {
- index: i,
- siblings: tree.children.length,
- visible: tree.visible
- });
- child = setTreeValues(child, newOptions);
- children.push(child);
- if (child.visible) {
- childrenTotal += child.val;
- }
- });
- tree.visible = childrenTotal > 0 || tree.visible;
- // Set the values
- value = pick(optionsPoint.value, childrenTotal);
- tree.children = children;
- tree.childrenTotal = childrenTotal;
- tree.isLeaf = tree.visible && !childrenTotal;
- tree.val = value;
- return tree;
- };
- /**
- * @private
- */
- var getColor = function getColor(node,
- options) {
- var index = options.index,
- mapOptionsToLevel = options.mapOptionsToLevel,
- parentColor = options.parentColor,
- parentColorIndex = options.parentColorIndex,
- series = options.series,
- colors = options.colors,
- siblings = options.siblings,
- points = series.points,
- getColorByPoint,
- chartOptionsChart = series.chart.options.chart,
- point,
- level,
- colorByPoint,
- colorIndexByPoint,
- color,
- colorIndex;
- /**
- * @private
- */
- function variation(color) {
- var colorVariation = level && level.colorVariation;
- if (colorVariation) {
- if (colorVariation.key === 'brightness') {
- return Color.parse(color).brighten(colorVariation.to * (index / siblings)).get();
- }
- }
- return color;
- }
- if (node) {
- point = points[node.i];
- level = mapOptionsToLevel[node.level] || {};
- getColorByPoint = point && level.colorByPoint;
- if (getColorByPoint) {
- colorIndexByPoint = point.index % (colors ?
- colors.length :
- chartOptionsChart.colorCount);
- colorByPoint = colors && colors[colorIndexByPoint];
- }
- // Select either point color, level color or inherited color.
- if (!series.chart.styledMode) {
- color = pick(point && point.options.color, level && level.color, colorByPoint, parentColor && variation(parentColor), series.color);
- }
- colorIndex = pick(point && point.options.colorIndex, level && level.colorIndex, colorIndexByPoint, parentColorIndex, options.colorIndex);
- }
- return {
- color: color,
- colorIndex: colorIndex
- };
- };
- /**
- * Creates a map from level number to its given options.
- *
- * @private
- * @function getLevelOptions
- * @param {object} params
- * Object containing parameters.
- * - `defaults` Object containing default options. The default options
- * are merged with the userOptions to get the final options for a
- * specific level.
- * - `from` The lowest level number.
- * - `levels` User options from series.levels.
- * - `to` The highest level number.
- * @return {Highcharts.Dictionary<object>|null}
- * Returns a map from level number to its given options.
- */
- var getLevelOptions = function getLevelOptions(params) {
- var result = null,
- defaults,
- converted,
- i,
- from,
- to,
- levels;
- if (isObject(params)) {
- result = {};
- from = isNumber(params.from) ? params.from : 1;
- levels = params.levels;
- converted = {};
- defaults = isObject(params.defaults) ? params.defaults : {};
- if (isArray(levels)) {
- converted = levels.reduce(function (obj, item) {
- var level,
- levelIsConstant,
- options;
- if (isObject(item) && isNumber(item.level)) {
- options = merge({}, item);
- levelIsConstant = (isBoolean(options.levelIsConstant) ?
- options.levelIsConstant :
- defaults.levelIsConstant);
- // Delete redundant properties.
- delete options.levelIsConstant;
- delete options.level;
- // Calculate which level these options apply to.
- level = item.level + (levelIsConstant ? 0 : from - 1);
- if (isObject(obj[level])) {
- extend(obj[level], options);
- }
- else {
- obj[level] = options;
- }
- }
- return obj;
- }, {});
- }
- to = isNumber(params.to) ? params.to : 1;
- for (i = 0; i <= to; i++) {
- result[i] = merge({}, defaults, isObject(converted[i]) ? converted[i] : {});
- }
- }
- return result;
- };
- /**
- * Update the rootId property on the series. Also makes sure that it is
- * accessible to exporting.
- *
- * @private
- * @function updateRootId
- *
- * @param {object} series
- * The series to operate on.
- *
- * @return {string}
- * Returns the resulting rootId after update.
- */
- var updateRootId = function (series) {
- var rootId,
- options;
- if (isObject(series)) {
- // Get the series options.
- options = isObject(series.options) ? series.options : {};
- // Calculate the rootId.
- rootId = pick(series.rootNode, options.rootId, '');
- // Set rootId on series.userOptions to pick it up in exporting.
- if (isObject(series.userOptions)) {
- series.userOptions.rootId = rootId;
- }
- // Set rootId on series to pick it up on next update.
- series.rootNode = rootId;
- }
- return rootId;
- };
- var result = {
- getColor: getColor,
- getLevelOptions: getLevelOptions,
- setTreeValues: setTreeValues,
- updateRootId: updateRootId
- };
- return result;
- });
- _registerModule(_modules, 'Series/Sankey/SankeySeries.js', [_modules['Core/Color/Color.js'], _modules['Core/Globals.js'], _modules['Mixins/Nodes.js'], _modules['Series/Sankey/SankeyPoint.js'], _modules['Core/Series/SeriesRegistry.js'], _modules['Mixins/TreeSeries.js'], _modules['Core/Utilities.js']], function (Color, H, NodesMixin, SankeyPoint, SeriesRegistry, TreeSeriesMixin, U) {
- /* *
- *
- * Sankey diagram module
- *
- * (c) 2010-2021 Torstein Honsi
- *
- * License: www.highcharts.com/license
- *
- * !!!!!!! SOURCE GETS TRANSPILED BY TYPESCRIPT. EDIT TS FILE ONLY. !!!!!!!
- *
- * */
- var __extends = (this && this.__extends) || (function () {
- var extendStatics = function (d,
- b) {
- extendStatics = Object.setPrototypeOf ||
- ({ __proto__: [] } instanceof Array && function (d,
- b) { d.__proto__ = b; }) ||
- function (d,
- b) { for (var p in b) if (b.hasOwnProperty(p)) d[p] = b[p]; };
- return extendStatics(d, b);
- };
- return function (d, b) {
- extendStatics(d, b);
- function __() { this.constructor = d; }
- d.prototype = b === null ? Object.create(b) : (__.prototype = b.prototype, new __());
- };
- })();
- var Series = SeriesRegistry.series,
- ColumnSeries = SeriesRegistry.seriesTypes.column;
- var getLevelOptions = TreeSeriesMixin.getLevelOptions;
- var defined = U.defined,
- extend = U.extend,
- find = U.find,
- isObject = U.isObject,
- merge = U.merge,
- pick = U.pick,
- relativeLength = U.relativeLength,
- stableSort = U.stableSort;
- /* *
- *
- * Class
- *
- * */
- /**
- * @private
- * @class
- * @name Highcharts.seriesTypes.sankey
- *
- * @augments Highcharts.Series
- */
- var SankeySeries = /** @class */ (function (_super) {
- __extends(SankeySeries, _super);
- function SankeySeries() {
- /* *
- *
- * Static Properties
- *
- * */
- var _this = _super !== null && _super.apply(this,
- arguments) || this;
- /* *
- *
- * Properties
- *
- * */
- _this.colDistance = void 0;
- _this.data = void 0;
- _this.group = void 0;
- _this.nodeLookup = void 0;
- _this.nodePadding = void 0;
- _this.nodes = void 0;
- _this.nodeWidth = void 0;
- _this.options = void 0;
- _this.points = void 0;
- _this.translationFactor = void 0;
- return _this;
- /* eslint-enable valid-jsdoc */
- }
- /* *
- *
- * Static Functions
- *
- * */
- // eslint-disable-next-line valid-jsdoc
- /**
- * @private
- */
- SankeySeries.getDLOptions = function (params) {
- var optionsPoint = (isObject(params.optionsPoint) ?
- params.optionsPoint.dataLabels :
- {}),
- optionsLevel = (isObject(params.level) ?
- params.level.dataLabels :
- {}),
- options = merge({
- style: {}
- },
- optionsLevel,
- optionsPoint);
- return options;
- };
- /* *
- *
- * Functions
- *
- * */
- /* eslint-disable valid-jsdoc */
- /**
- * Create a node column.
- * @private
- */
- SankeySeries.prototype.createNodeColumn = function () {
- var series = this,
- chart = this.chart,
- column = [];
- column.sum = function () {
- return this.reduce(function (sum, node) {
- return sum + node.getSum();
- }, 0);
- };
- // Get the offset in pixels of a node inside the column.
- column.offset = function (node, factor) {
- var offset = 0,
- totalNodeOffset,
- nodePadding = series.nodePadding;
- for (var i = 0; i < column.length; i++) {
- var sum = column[i].getSum();
- var height = Math.max(sum * factor,
- series.options.minLinkWidth);
- if (sum) {
- totalNodeOffset = height + nodePadding;
- }
- else {
- // If node sum equals 0 nodePadding is missed #12453
- totalNodeOffset = 0;
- }
- if (column[i] === node) {
- return {
- relativeTop: offset + relativeLength(node.options.offset || 0, totalNodeOffset)
- };
- }
- offset += totalNodeOffset;
- }
- };
- // Get the top position of the column in pixels.
- column.top = function (factor) {
- var nodePadding = series.nodePadding;
- var height = this.reduce(function (height,
- node) {
- if (height > 0) {
- height += nodePadding;
- }
- var nodeHeight = Math.max(node.getSum() * factor,
- series.options.minLinkWidth);
- height += nodeHeight;
- return height;
- }, 0);
- return (chart.plotSizeY - height) / 2;
- };
- return column;
- };
- /**
- * Create node columns by analyzing the nodes and the relations between
- * incoming and outgoing links.
- * @private
- */
- SankeySeries.prototype.createNodeColumns = function () {
- var columns = [];
- this.nodes.forEach(function (node) {
- var fromColumn = -1,
- fromNode,
- i,
- point;
- if (!defined(node.options.column)) {
- // No links to this node, place it left
- if (node.linksTo.length === 0) {
- node.column = 0;
- // There are incoming links, place it to the right of the
- // highest order column that links to this one.
- }
- else {
- for (i = 0; i < node.linksTo.length; i++) {
- point = node.linksTo[0];
- if (point.fromNode.column > fromColumn) {
- fromNode = point.fromNode;
- fromColumn = fromNode.column;
- }
- }
- node.column = fromColumn + 1;
- // Hanging layout for organization chart
- if (fromNode &&
- fromNode.options.layout === 'hanging') {
- node.hangsFrom = fromNode;
- i = -1; // Reuse existing variable i
- find(fromNode.linksFrom, function (link, index) {
- var found = link.toNode === node;
- if (found) {
- i = index;
- }
- return found;
- });
- node.column += i;
- }
- }
- }
- if (!columns[node.column]) {
- columns[node.column] = this.createNodeColumn();
- }
- columns[node.column].push(node);
- }, this);
- // Fill in empty columns (#8865)
- for (var i = 0; i < columns.length; i++) {
- if (typeof columns[i] === 'undefined') {
- columns[i] = this.createNodeColumn();
- }
- }
- return columns;
- };
- /**
- * Extend generatePoints by adding the nodes, which are Point objects
- * but pushed to the this.nodes array.
- * @private
- */
- SankeySeries.prototype.generatePoints = function () {
- NodesMixin.generatePoints.apply(this, arguments);
- /**
- * Order the nodes, starting with the root node(s). (#9818)
- * @private
- */
- function order(node, level) {
- // Prevents circular recursion:
- if (typeof node.level === 'undefined') {
- node.level = level;
- node.linksFrom.forEach(function (link) {
- if (link.toNode) {
- order(link.toNode, level + 1);
- }
- });
- }
- }
- if (this.orderNodes) {
- this.nodes
- // Identify the root node(s)
- .filter(function (node) {
- return node.linksTo.length === 0;
- })
- // Start by the root node(s) and recursively set the level
- // on all following nodes.
- .forEach(function (node) {
- order(node, 0);
- });
- stableSort(this.nodes, function (a, b) {
- return a.level - b.level;
- });
- }
- };
- /**
- * Overridable function to get node padding, overridden in dependency
- * wheel series type.
- * @private
- */
- SankeySeries.prototype.getNodePadding = function () {
- var nodePadding = this.options.nodePadding || 0;
- // If the number of columns is so great that they will overflow with
- // the given nodePadding, we sacrifice the padding in order to
- // render all nodes within the plot area (#11917).
- if (this.nodeColumns) {
- var maxLength = this.nodeColumns.reduce(function (acc,
- col) { return Math.max(acc,
- col.length); }, 0);
- if (maxLength * nodePadding > this.chart.plotSizeY) {
- nodePadding = this.chart.plotSizeY / maxLength;
- }
- }
- return nodePadding;
- };
- /**
- * Define hasData function for non-cartesian series.
- * @private
- * @return {boolean}
- * Returns true if the series has points at all.
- */
- SankeySeries.prototype.hasData = function () {
- return !!this.processedXData.length; // != 0
- };
- /**
- * Return the presentational attributes.
- * @private
- */
- SankeySeries.prototype.pointAttribs = function (point, state) {
- if (!point) {
- return {};
- }
- var series = this, level = point.isNode ? point.level : point.fromNode.level, levelOptions = series.mapOptionsToLevel[level || 0] || {}, options = point.options, stateOptions = (levelOptions.states && levelOptions.states[state || '']) || {}, values = [
- 'colorByPoint', 'borderColor', 'borderWidth', 'linkOpacity'
- ].reduce(function (obj, key) {
- obj[key] = pick(stateOptions[key], options[key], levelOptions[key], series.options[key]);
- return obj;
- }, {}), color = pick(stateOptions.color, options.color, values.colorByPoint ? point.color : levelOptions.color);
- // Node attributes
- if (point.isNode) {
- return {
- fill: color,
- stroke: values.borderColor,
- 'stroke-width': values.borderWidth
- };
- }
- // Link attributes
- return {
- fill: Color.parse(color).setOpacity(values.linkOpacity).get()
- };
- };
- /**
- * Extend the render function to also render this.nodes together with
- * the points.
- * @private
- */
- SankeySeries.prototype.render = function () {
- var points = this.points;
- this.points = this.points.concat(this.nodes || []);
- ColumnSeries.prototype.render.call(this);
- this.points = points;
- };
- /**
- * Run pre-translation by generating the nodeColumns.
- * @private
- */
- SankeySeries.prototype.translate = function () {
- var _this = this;
- // Get the translation factor needed for each column to fill up the
- // plot height
- var getColumnTranslationFactor = function (column) {
- var nodes = column.slice();
- var minLinkWidth = _this.options.minLinkWidth || 0;
- var exceedsMinLinkWidth;
- var factor = 0;
- var i;
- var remainingHeight = chart.plotSizeY -
- options.borderWidth - (column.length - 1) * series.nodePadding;
- // Because the minLinkWidth option doesn't obey the direct
- // translation, we need to run translation iteratively, check
- // node heights, remove those nodes affected by minLinkWidth,
- // check again, etc.
- while (column.length) {
- factor = remainingHeight / column.sum();
- exceedsMinLinkWidth = false;
- i = column.length;
- while (i--) {
- if (column[i].getSum() * factor < minLinkWidth) {
- column.splice(i, 1);
- remainingHeight -= minLinkWidth;
- exceedsMinLinkWidth = true;
- }
- }
- if (!exceedsMinLinkWidth) {
- break;
- }
- }
- // Re-insert original nodes
- column.length = 0;
- nodes.forEach(function (node) { return column.push(node); });
- return factor;
- };
- if (!this.processedXData) {
- this.processData();
- }
- this.generatePoints();
- this.nodeColumns = this.createNodeColumns();
- this.nodeWidth = relativeLength(this.options.nodeWidth, this.chart.plotSizeX);
- var series = this,
- chart = this.chart,
- options = this.options,
- nodeWidth = this.nodeWidth,
- nodeColumns = this.nodeColumns;
- this.nodePadding = this.getNodePadding();
- // Find out how much space is needed. Base it on the translation
- // factor of the most spaceous column.
- this.translationFactor = nodeColumns.reduce(function (translationFactor, column) { return Math.min(translationFactor, getColumnTranslationFactor(column)); }, Infinity);
- this.colDistance =
- (chart.plotSizeX - nodeWidth -
- options.borderWidth) / Math.max(1, nodeColumns.length - 1);
- // Calculate level options used in sankey and organization
- series.mapOptionsToLevel = getLevelOptions({
- // NOTE: if support for allowTraversingTree is added, then from
- // should be the level of the root node.
- from: 1,
- levels: options.levels,
- to: nodeColumns.length - 1,
- defaults: {
- borderColor: options.borderColor,
- borderRadius: options.borderRadius,
- borderWidth: options.borderWidth,
- color: series.color,
- colorByPoint: options.colorByPoint,
- // NOTE: if support for allowTraversingTree is added, then
- // levelIsConstant should be optional.
- levelIsConstant: true,
- linkColor: options.linkColor,
- linkLineWidth: options.linkLineWidth,
- linkOpacity: options.linkOpacity,
- states: options.states
- }
- });
- // First translate all nodes so we can use them when drawing links
- nodeColumns.forEach(function (column) {
- column.forEach(function (node) {
- series.translateNode(node, column);
- });
- }, this);
- // Then translate links
- this.nodes.forEach(function (node) {
- // Translate the links from this node
- node.linksFrom.forEach(function (linkPoint) {
- // If weight is 0 - don't render the link path #12453,
- // render null points (for organization chart)
- if ((linkPoint.weight || linkPoint.isNull) && linkPoint.to) {
- series.translateLink(linkPoint);
- linkPoint.allowShadow = false;
- }
- });
- });
- };
- /**
- * Run translation operations for one link.
- * @private
- */
- SankeySeries.prototype.translateLink = function (point) {
- var getY = function (node,
- fromOrTo) {
- var linkTop = (node.offset(point,
- fromOrTo) *
- translationFactor);
- var y = Math.min(node.nodeY + linkTop,
- // Prevent links from spilling below the node (#12014)
- node.nodeY + (node.shapeArgs && node.shapeArgs.height || 0) - linkHeight);
- return y;
- };
- var fromNode = point.fromNode, toNode = point.toNode, chart = this.chart, translationFactor = this.translationFactor, linkHeight = Math.max(point.weight * translationFactor, this.options.minLinkWidth), options = this.options, curvy = ((chart.inverted ? -this.colDistance : this.colDistance) *
- options.curveFactor), fromY = getY(fromNode, 'linksFrom'), toY = getY(toNode, 'linksTo'), nodeLeft = fromNode.nodeX, nodeW = this.nodeWidth, right = toNode.column * this.colDistance, outgoing = point.outgoing, straight = right > nodeLeft + nodeW;
- if (chart.inverted) {
- fromY = chart.plotSizeY - fromY;
- toY = (chart.plotSizeY || 0) - toY;
- right = chart.plotSizeX - right;
- nodeW = -nodeW;
- linkHeight = -linkHeight;
- straight = nodeLeft > right;
- }
- point.shapeType = 'path';
- point.linkBase = [
- fromY,
- fromY + linkHeight,
- toY,
- toY + linkHeight
- ];
- // Links going from left to right
- if (straight && typeof toY === 'number') {
- point.shapeArgs = {
- d: [
- ['M', nodeLeft + nodeW, fromY],
- [
- 'C',
- nodeLeft + nodeW + curvy,
- fromY,
- right - curvy,
- toY,
- right,
- toY
- ],
- ['L', right + (outgoing ? nodeW : 0), toY + linkHeight / 2],
- ['L', right, toY + linkHeight],
- [
- 'C',
- right - curvy,
- toY + linkHeight,
- nodeLeft + nodeW + curvy,
- fromY + linkHeight,
- nodeLeft + nodeW, fromY + linkHeight
- ],
- ['Z']
- ]
- };
- // Experimental: Circular links pointing backwards. In
- // v6.1.0 this breaks the rendering completely, so even
- // this experimental rendering is an improvement. #8218.
- // @todo
- // - Make room for the link in the layout
- // - Automatically determine if the link should go up or
- // down.
- }
- else if (typeof toY === 'number') {
- var bend = 20,
- vDist = chart.plotHeight - fromY - linkHeight,
- x1 = right - bend - linkHeight,
- x2 = right - bend,
- x3 = right,
- x4 = nodeLeft + nodeW,
- x5 = x4 + bend,
- x6 = x5 + linkHeight,
- fy1 = fromY,
- fy2 = fromY + linkHeight,
- fy3 = fy2 + bend,
- y4 = fy3 + vDist,
- y5 = y4 + bend,
- y6 = y5 + linkHeight,
- ty1 = toY,
- ty2 = ty1 + linkHeight,
- ty3 = ty2 + bend,
- cfy1 = fy2 - linkHeight * 0.7,
- cy2 = y5 + linkHeight * 0.7,
- cty1 = ty2 - linkHeight * 0.7,
- cx1 = x3 - linkHeight * 0.7,
- cx2 = x4 + linkHeight * 0.7;
- point.shapeArgs = {
- d: [
- ['M', x4, fy1],
- ['C', cx2, fy1, x6, cfy1, x6, fy3],
- ['L', x6, y4],
- ['C', x6, cy2, cx2, y6, x4, y6],
- ['L', x3, y6],
- ['C', cx1, y6, x1, cy2, x1, y4],
- ['L', x1, ty3],
- ['C', x1, cty1, cx1, ty1, x3, ty1],
- ['L', x3, ty2],
- ['C', x2, ty2, x2, ty2, x2, ty3],
- ['L', x2, y4],
- ['C', x2, y5, x2, y5, x3, y5],
- ['L', x4, y5],
- ['C', x5, y5, x5, y5, x5, y4],
- ['L', x5, fy3],
- ['C', x5, fy2, x5, fy2, x4, fy2],
- ['Z']
- ]
- };
- }
- // Place data labels in the middle
- point.dlBox = {
- x: nodeLeft + (right - nodeLeft + nodeW) / 2,
- y: fromY + (toY - fromY) / 2,
- height: linkHeight,
- width: 0
- };
- // And set the tooltip anchor in the middle
- point.tooltipPos = chart.inverted ? [
- chart.plotSizeY - point.dlBox.y - linkHeight / 2,
- chart.plotSizeX - point.dlBox.x
- ] : [
- point.dlBox.x,
- point.dlBox.y + linkHeight / 2
- ];
- // Pass test in drawPoints
- point.y = point.plotY = 1;
- if (!point.color) {
- point.color = fromNode.color;
- }
- };
- /**
- * Run translation operations for one node.
- * @private
- */
- SankeySeries.prototype.translateNode = function (node, column) {
- var translationFactor = this.translationFactor,
- chart = this.chart,
- options = this.options,
- sum = node.getSum(),
- nodeHeight = Math.max(Math.round(sum * translationFactor),
- this.options.minLinkWidth),
- crisp = Math.round(options.borderWidth) % 2 / 2,
- nodeOffset = column.offset(node,
- translationFactor),
- fromNodeTop = Math.floor(pick(nodeOffset.absoluteTop, (column.top(translationFactor) +
- nodeOffset.relativeTop))) + crisp,
- left = Math.floor(this.colDistance * node.column +
- options.borderWidth / 2) + crisp,
- nodeLeft = chart.inverted ?
- chart.plotSizeX - left :
- left,
- nodeWidth = Math.round(this.nodeWidth);
- node.sum = sum;
- // If node sum is 0, don't render the rect #12453
- if (sum) {
- // Draw the node
- node.shapeType = 'rect';
- node.nodeX = nodeLeft;
- node.nodeY = fromNodeTop;
- var x = nodeLeft,
- y = fromNodeTop,
- width = node.options.width || options.width || nodeWidth,
- height = node.options.height || options.height || nodeHeight;
- if (chart.inverted) {
- x = nodeLeft - nodeWidth;
- y = chart.plotSizeY - fromNodeTop - nodeHeight;
- width = node.options.height || options.height || nodeWidth;
- height = node.options.width || options.width || nodeHeight;
- }
- // Calculate data label options for the point
- node.dlOptions = SankeySeries.getDLOptions({
- level: this.mapOptionsToLevel[node.level],
- optionsPoint: node.options
- });
- // Pass test in drawPoints
- node.plotX = 1;
- node.plotY = 1;
- // Set the anchor position for tooltips
- node.tooltipPos = chart.inverted ? [
- chart.plotSizeY - y - height / 2,
- chart.plotSizeX - x - width / 2
- ] : [
- x + width / 2,
- y + height / 2
- ];
- node.shapeArgs = {
- x: x,
- y: y,
- width: width,
- height: height,
- display: node.hasShape() ? '' : 'none'
- };
- }
- else {
- node.dlOptions = {
- enabled: false
- };
- }
- };
- /**
- * A sankey diagram is a type of flow diagram, in which the width of the
- * link between two nodes is shown proportionally to the flow quantity.
- *
- * @sample highcharts/demo/sankey-diagram/
- * Sankey diagram
- * @sample highcharts/plotoptions/sankey-inverted/
- * Inverted sankey diagram
- * @sample highcharts/plotoptions/sankey-outgoing
- * Sankey diagram with outgoing links
- *
- * @extends plotOptions.column
- * @since 6.0.0
- * @product highcharts
- * @excluding animationLimit, boostThreshold, borderRadius,
- * crisp, cropThreshold, colorAxis, colorKey, depth, dragDrop,
- * edgeColor, edgeWidth, findNearestPointBy, grouping,
- * groupPadding, groupZPadding, maxPointWidth, negativeColor,
- * pointInterval, pointIntervalUnit, pointPadding,
- * pointPlacement, pointRange, pointStart, pointWidth,
- * shadow, softThreshold, stacking, threshold, zoneAxis,
- * zones, minPointLength, dataSorting, boostBlending
- * @requires modules/sankey
- * @optionparent plotOptions.sankey
- */
- SankeySeries.defaultOptions = merge(ColumnSeries.defaultOptions, {
- borderWidth: 0,
- colorByPoint: true,
- /**
- * Higher numbers makes the links in a sankey diagram or dependency
- * wheelrender more curved. A `curveFactor` of 0 makes the lines
- * straight.
- *
- * @private
- */
- curveFactor: 0.33,
- /**
- * Options for the data labels appearing on top of the nodes and links.
- * For sankey charts, data labels are visible for the nodes by default,
- * but hidden for links. This is controlled by modifying the
- * `nodeFormat`, and the `format` that applies to links and is an empty
- * string by default.
- *
- * @declare Highcharts.SeriesSankeyDataLabelsOptionsObject
- *
- * @private
- */
- dataLabels: {
- enabled: true,
- backgroundColor: 'none',
- crop: false,
- /**
- * The
- * [format string](https://www.highcharts.com/docs/chart-concepts/labels-and-string-formatting)
- * specifying what to show for _nodes_ in the sankey diagram. By
- * default the `nodeFormatter` returns `{point.name}`.
- *
- * @sample highcharts/plotoptions/sankey-link-datalabels/
- * Node and link data labels
- *
- * @type {string}
- */
- nodeFormat: void 0,
- // eslint-disable-next-line valid-jsdoc
- /**
- * Callback to format data labels for _nodes_ in the sankey diagram.
- * The `nodeFormat` option takes precedence over the
- * `nodeFormatter`.
- *
- * @type {Highcharts.SeriesSankeyDataLabelsFormatterCallbackFunction}
- * @since 6.0.2
- */
- nodeFormatter: function () {
- return this.point.name;
- },
- format: void 0,
- // eslint-disable-next-line valid-jsdoc
- /**
- * @type {Highcharts.SeriesSankeyDataLabelsFormatterCallbackFunction}
- */
- formatter: function () {
- return;
- },
- inside: true
- },
- /**
- * @ignore-option
- *
- * @private
- */
- inactiveOtherPoints: true,
- /**
- * Set options on specific levels. Takes precedence over series options,
- * but not node and link options.
- *
- * @sample highcharts/demo/sunburst
- * Sunburst chart
- *
- * @type {Array<*>}
- * @since 7.1.0
- * @apioption plotOptions.sankey.levels
- */
- /**
- * Can set `borderColor` on all nodes which lay on the same level.
- *
- * @type {Highcharts.ColorString}
- * @apioption plotOptions.sankey.levels.borderColor
- */
- /**
- * Can set `borderWidth` on all nodes which lay on the same level.
- *
- * @type {number}
- * @apioption plotOptions.sankey.levels.borderWidth
- */
- /**
- * Can set `color` on all nodes which lay on the same level.
- *
- * @type {Highcharts.ColorString|Highcharts.GradientColorObject|Highcharts.PatternObject}
- * @apioption plotOptions.sankey.levels.color
- */
- /**
- * Can set `colorByPoint` on all nodes which lay on the same level.
- *
- * @type {boolean}
- * @default true
- * @apioption plotOptions.sankey.levels.colorByPoint
- */
- /**
- * Can set `dataLabels` on all points which lay on the same level.
- *
- * @extends plotOptions.sankey.dataLabels
- * @apioption plotOptions.sankey.levels.dataLabels
- */
- /**
- * Decides which level takes effect from the options set in the levels
- * object.
- *
- * @type {number}
- * @apioption plotOptions.sankey.levels.level
- */
- /**
- * Can set `linkOpacity` on all points which lay on the same level.
- *
- * @type {number}
- * @default 0.5
- * @apioption plotOptions.sankey.levels.linkOpacity
- */
- /**
- * Can set `states` on all nodes and points which lay on the same level.
- *
- * @extends plotOptions.sankey.states
- * @apioption plotOptions.sankey.levels.states
- */
- /**
- * Opacity for the links between nodes in the sankey diagram.
- *
- * @private
- */
- linkOpacity: 0.5,
- /**
- * The minimal width for a line of a sankey. By default,
- * 0 values are not shown.
- *
- * @sample highcharts/plotoptions/sankey-minlinkwidth
- * Sankey diagram with minimal link height
- *
- * @type {number}
- * @since 7.1.3
- * @default 0
- * @apioption plotOptions.sankey.minLinkWidth
- *
- * @private
- */
- minLinkWidth: 0,
- /**
- * The pixel width of each node in a sankey diagram or dependency wheel,
- * or the height in case the chart is inverted.
- *
- * @private
- */
- nodeWidth: 20,
- /**
- * The padding between nodes in a sankey diagram or dependency wheel, in
- * pixels.
- *
- * If the number of nodes is so great that it is possible to lay them
- * out within the plot area with the given `nodePadding`, they will be
- * rendered with a smaller padding as a strategy to avoid overflow.
- *
- * @private
- */
- nodePadding: 10,
- showInLegend: false,
- states: {
- hover: {
- /**
- * Opacity for the links between nodes in the sankey diagram in
- * hover mode.
- */
- linkOpacity: 1
- },
- /**
- * The opposite state of a hover for a single point node/link.
- *
- * @declare Highcharts.SeriesStatesInactiveOptionsObject
- */
- inactive: {
- /**
- * Opacity for the links between nodes in the sankey diagram in
- * inactive mode.
- */
- linkOpacity: 0.1,
- /**
- * Opacity of inactive markers.
- *
- * @type {number}
- * @apioption plotOptions.series.states.inactive.opacity
- */
- opacity: 0.1,
- /**
- * Animation when not hovering over the marker.
- *
- * @type {boolean|Partial<Highcharts.AnimationOptionsObject>}
- * @apioption plotOptions.series.states.inactive.animation
- */
- animation: {
- /** @internal */
- duration: 50
- }
- }
- },
- tooltip: {
- /**
- * A callback for defining the format for _nodes_ in the chart's
- * tooltip, as opposed to links.
- *
- * @type {Highcharts.FormatterCallbackFunction<Highcharts.SankeyNodeObject>}
- * @since 6.0.2
- * @apioption plotOptions.sankey.tooltip.nodeFormatter
- */
- /**
- * Whether the tooltip should follow the pointer or stay fixed on
- * the item.
- */
- followPointer: true,
- headerFormat: '<span style="font-size: 10px">{series.name}</span><br/>',
- pointFormat: '{point.fromNode.name} \u2192 {point.toNode.name}: <b>{point.weight}</b><br/>',
- /**
- * The
- * [format string](https://www.highcharts.com/docs/chart-concepts/labels-and-string-formatting)
- * specifying what to show for _nodes_ in tooltip of a diagram
- * series, as opposed to links.
- */
- nodeFormat: '{point.name}: <b>{point.sum}</b><br/>'
- }
- });
- return SankeySeries;
- }(ColumnSeries));
- extend(SankeySeries.prototype, {
- animate: Series.prototype.animate,
- // Create a single node that holds information on incoming and outgoing
- // links.
- createNode: NodesMixin.createNode,
- destroy: NodesMixin.destroy,
- forceDL: true,
- invertible: true,
- isCartesian: false,
- orderNodes: true,
- pointArrayMap: ['from', 'to'],
- pointClass: SankeyPoint,
- searchPoint: H.noop,
- setData: NodesMixin.setData
- });
- SeriesRegistry.registerSeriesType('sankey', SankeySeries);
- /* *
- *
- * Default Export
- *
- * */
- /* *
- *
- * API Declarations
- *
- * */
- /**
- * A node in a sankey diagram.
- *
- * @interface Highcharts.SankeyNodeObject
- * @extends Highcharts.Point
- * @product highcharts
- */ /**
- * The color of the auto generated node.
- *
- * @name Highcharts.SankeyNodeObject#color
- * @type {Highcharts.ColorString|Highcharts.GradientColorObject|Highcharts.PatternObject}
- */ /**
- * The color index of the auto generated node, especially for use in styled
- * mode.
- *
- * @name Highcharts.SankeyNodeObject#colorIndex
- * @type {number}
- */ /**
- * An optional column index of where to place the node. The default behaviour is
- * to place it next to the preceding node.
- *
- * @see {@link https://jsfiddle.net/gh/get/library/pure/highcharts/highcharts/tree/master/samples/highcharts/plotoptions/sankey-node-column/|Highcharts-Demo:}
- * Specified node column
- *
- * @name Highcharts.SankeyNodeObject#column
- * @type {number}
- * @since 6.0.5
- */ /**
- * The id of the auto-generated node, refering to the `from` or `to` setting of
- * the link.
- *
- * @name Highcharts.SankeyNodeObject#id
- * @type {string}
- */ /**
- * The name to display for the node in data labels and tooltips. Use this when
- * the name is different from the `id`. Where the id must be unique for each
- * node, this is not necessary for the name.
- *
- * @see {@link https://jsfiddle.net/gh/get/library/pure/highcharts/highcharts/tree/master/samples/highcharts/css/sankey/|Highcharts-Demo:}
- * Sankey diagram with node options
- *
- * @name Highcharts.SankeyNodeObject#name
- * @type {string}
- * @product highcharts
- */ /**
- * The vertical offset of a node in terms of weight. Positive values shift the
- * node downwards, negative shift it upwards.
- *
- * @see {@link https://jsfiddle.net/gh/get/library/pure/highcharts/highcharts/tree/master/samples/highcharts/plotoptions/sankey-node-column/|Highcharts-Demo:}
- * Specified node offset
- *
- * @name Highcharts.SankeyNodeObject#offset
- * @type {number}
- * @default 0
- * @since 6.0.5
- */
- /**
- * Formatter callback function.
- *
- * @callback Highcharts.SeriesSankeyDataLabelsFormatterCallbackFunction
- *
- * @param {Highcharts.SeriesSankeyDataLabelsFormatterContextObject|Highcharts.PointLabelObject} this
- * Data label context to format
- *
- * @return {string|undefined}
- * Formatted data label text
- */
- /**
- * Context for the node formatter function.
- *
- * @interface Highcharts.SeriesSankeyDataLabelsFormatterContextObject
- * @extends Highcharts.PointLabelObject
- */ /**
- * The node object. The node name, if defined, is available through
- * `this.point.name`.
- * @name Highcharts.SeriesSankeyDataLabelsFormatterContextObject#point
- * @type {Highcharts.SankeyNodeObject}
- */
- ''; // detach doclets above
- /* *
- *
- * API Options
- *
- * */
- /**
- * A `sankey` series. If the [type](#series.sankey.type) option is not
- * specified, it is inherited from [chart.type](#chart.type).
- *
- * @extends series,plotOptions.sankey
- * @excluding animationLimit, boostBlending, boostThreshold, borderColor,
- * borderRadius, borderWidth, crisp, cropThreshold, dataParser,
- * dataURL, depth, dragDrop, edgeColor, edgeWidth,
- * findNearestPointBy, getExtremesFromAll, grouping, groupPadding,
- * groupZPadding, label, maxPointWidth, negativeColor, pointInterval,
- * pointIntervalUnit, pointPadding, pointPlacement, pointRange,
- * pointStart, pointWidth, shadow, softThreshold, stacking,
- * threshold, zoneAxis, zones, dataSorting
- * @product highcharts
- * @requires modules/sankey
- * @apioption series.sankey
- */
- /**
- * A collection of options for the individual nodes. The nodes in a sankey
- * diagram are auto-generated instances of `Highcharts.Point`, but options can
- * be applied here and linked by the `id`.
- *
- * @sample highcharts/css/sankey/
- * Sankey diagram with node options
- *
- * @declare Highcharts.SeriesSankeyNodesOptionsObject
- * @type {Array<*>}
- * @product highcharts
- * @apioption series.sankey.nodes
- */
- /**
- * The id of the auto-generated node, refering to the `from` or `to` setting of
- * the link.
- *
- * @type {string}
- * @product highcharts
- * @apioption series.sankey.nodes.id
- */
- /**
- * The color of the auto generated node.
- *
- * @type {Highcharts.ColorString|Highcharts.GradientColorObject|Highcharts.PatternObject}
- * @product highcharts
- * @apioption series.sankey.nodes.color
- */
- /**
- * The color index of the auto generated node, especially for use in styled
- * mode.
- *
- * @type {number}
- * @product highcharts
- * @apioption series.sankey.nodes.colorIndex
- */
- /**
- * An optional column index of where to place the node. The default behaviour is
- * to place it next to the preceding node. Note that this option name is
- * counter intuitive in inverted charts, like for example an organization chart
- * rendered top down. In this case the "columns" are horizontal.
- *
- * @sample highcharts/plotoptions/sankey-node-column/
- * Specified node column
- *
- * @type {number}
- * @since 6.0.5
- * @product highcharts
- * @apioption series.sankey.nodes.column
- */
- /**
- * Individual data label for each node. The options are the same as
- * the ones for [series.sankey.dataLabels](#series.sankey.dataLabels).
- *
- * @extends plotOptions.sankey.dataLabels
- * @apioption series.sankey.nodes.dataLabels
- */
- /**
- * An optional level index of where to place the node. The default behaviour is
- * to place it next to the preceding node. Alias of `nodes.column`, but in
- * inverted sankeys and org charts, the levels are laid out as rows.
- *
- * @type {number}
- * @since 7.1.0
- * @product highcharts
- * @apioption series.sankey.nodes.level
- */
- /**
- * The name to display for the node in data labels and tooltips. Use this when
- * the name is different from the `id`. Where the id must be unique for each
- * node, this is not necessary for the name.
- *
- * @sample highcharts/css/sankey/
- * Sankey diagram with node options
- *
- * @type {string}
- * @product highcharts
- * @apioption series.sankey.nodes.name
- */
- /**
- * In a horizontal layout, the vertical offset of a node in terms of weight.
- * Positive values shift the node downwards, negative shift it upwards. In a
- * vertical layout, like organization chart, the offset is horizontal.
- *
- * If a percantage string is given, the node is offset by the percentage of the
- * node size plus `nodePadding`.
- *
- * @sample highcharts/plotoptions/sankey-node-column/
- * Specified node offset
- *
- * @type {number|string}
- * @default 0
- * @since 6.0.5
- * @product highcharts
- * @apioption series.sankey.nodes.offset
- */
- /**
- * An array of data points for the series. For the `sankey` series type,
- * points can be given in the following way:
- *
- * 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.area.turboThreshold),
- * this option is not available.
- *
- * ```js
- * data: [{
- * from: 'Category1',
- * to: 'Category2',
- * weight: 2
- * }, {
- * from: 'Category1',
- * to: 'Category3',
- * weight: 5
- * }]
- * ```
- *
- * @sample {highcharts} highcharts/series/data-array-of-objects/
- * Config objects
- *
- * @declare Highcharts.SeriesSankeyPointOptionsObject
- * @type {Array<*>}
- * @extends series.line.data
- * @excluding dragDrop, drilldown, marker, x, y
- * @product highcharts
- * @apioption series.sankey.data
- */
- /**
- * The color for the individual _link_. By default, the link color is the same
- * as the node it extends from. The `series.fillOpacity` option also applies to
- * the points, so when setting a specific link color, consider setting the
- * `fillOpacity` to 1.
- *
- * @type {Highcharts.ColorString|Highcharts.GradientColorObject|Highcharts.PatternObject}
- * @product highcharts
- * @apioption series.sankey.data.color
- */
- /**
- * @type {Highcharts.SeriesSankeyDataLabelsOptionsObject|Array<Highcharts.SeriesSankeyDataLabelsOptionsObject>}
- * @product highcharts
- * @apioption series.sankey.data.dataLabels
- */
- /**
- * The node that the link runs from.
- *
- * @type {string}
- * @product highcharts
- * @apioption series.sankey.data.from
- */
- /**
- * The node that the link runs to.
- *
- * @type {string}
- * @product highcharts
- * @apioption series.sankey.data.to
- */
- /**
- * Whether the link goes out of the system.
- *
- * @sample highcharts/plotoptions/sankey-outgoing
- * Sankey chart with outgoing links
- *
- * @type {boolean}
- * @default false
- * @product highcharts
- * @apioption series.sankey.data.outgoing
- */
- /**
- * The weight of the link.
- *
- * @type {number|null}
- * @product highcharts
- * @apioption series.sankey.data.weight
- */
- ''; // adds doclets above to transpiled file
- return SankeySeries;
- });
- _registerModule(_modules, 'masters/modules/sankey.src.js', [], function () {
- });
- }));
|