devextreme
Version:
HTML5 JavaScript Component Suite for Responsive Web Development
460 lines (436 loc) • 18.3 kB
JavaScript
/**
* DevExtreme (viz/core/series_family.js)
* Version: 19.2.6
* Build date: Thu Jan 30 2020
*
* Copyright (c) 2012 - 2020 Developer Express Inc. ALL RIGHTS RESERVED
* Read about DevExtreme licensing here: https://js.devexpress.com/Licensing/
*/
;
var isNumeric = require("../../core/utils/type").isNumeric;
var extend = require("../../core/utils/extend").extend;
var each = require("../../core/utils/iterator").each;
var isDefined = require("../../core/utils/type").isDefined;
var sign = require("../../core/utils/math").sign;
var _math = Math;
var _round = _math.round;
var _abs = _math.abs;
var _pow = _math.pow;
var _each = each;
var _noop = require("../../core/utils/common").noop;
var vizUtils = require("./utils");
var DEFAULT_BAR_GROUP_PADDING = .3;
var _normalizeEnum = vizUtils.normalizeEnum;
function validateBarPadding(barPadding) {
return barPadding < 0 || barPadding > 1 ? void 0 : barPadding
}
function validateBarGroupPadding(barGroupPadding) {
return barGroupPadding < 0 || barGroupPadding > 1 ? DEFAULT_BAR_GROUP_PADDING : barGroupPadding
}
function isStackExist(series, arg, equalBarWidth) {
return series.some(function(s) {
return equalBarWidth && !s.getOptions().ignoreEmptyPoints || s.getPointsByArg(arg, true).some(function(point) {
return point.hasValue()
})
})
}
function correctStackCoordinates(series, currentStacks, arg, stack, parameters, barsArea, seriesStackIndexCallback) {
series.forEach(function(series) {
var stackIndex = seriesStackIndexCallback(currentStacks.indexOf(stack), currentStacks.length);
var points = series.getPointsByArg(arg, true);
var barPadding = validateBarPadding(series.getOptions().barPadding);
var barWidth = series.getOptions().barWidth;
var offset = getOffset(stackIndex, parameters);
var width = parameters.width;
var extraParameters;
if (stackIndex === -1) {
return
}
if (isDefined(barPadding) || isDefined(barWidth)) {
extraParameters = calculateParams(barsArea, currentStacks.length, 1 - barPadding, barWidth);
width = extraParameters.width;
offset = getOffset(stackIndex, extraParameters)
}
correctPointCoordinates(points, width, offset)
})
}
function adjustBarSeriesDimensionsCore(series, options, seriesStackIndexCallback) {
var commonStacks = [];
var allArguments = [];
var seriesInStacks = {};
var barWidth = options.barWidth;
var barGroupWidth = options.barGroupWidth;
var interval = series[0] && series[0].getArgumentAxis().getTranslator().getInterval();
var barsArea = barGroupWidth ? interval > barGroupWidth ? barGroupWidth : interval : interval * (1 - validateBarGroupPadding(options.barGroupPadding));
series.forEach(function(s, i) {
var stackName = s.getStackName() || s.getBarOverlapGroup() || i.toString();
var argument;
for (argument in s.pointsByArgument) {
if (allArguments.indexOf(argument.valueOf()) === -1) {
allArguments.push(argument.valueOf())
}
}
if (commonStacks.indexOf(stackName) === -1) {
commonStacks.push(stackName);
seriesInStacks[stackName] = []
}
seriesInStacks[stackName].push(s)
});
allArguments.forEach(function(arg) {
var currentStacks = commonStacks.reduce(function(stacks, stack) {
if (isStackExist(seriesInStacks[stack], arg, options.equalBarWidth)) {
stacks.push(stack)
}
return stacks
}, []);
var parameters = calculateParams(barsArea, currentStacks.length, barWidth);
commonStacks.forEach(function(stack) {
correctStackCoordinates(seriesInStacks[stack], currentStacks, arg, stack, parameters, barsArea, seriesStackIndexCallback)
})
})
}
function calculateParams(barsArea, count, percentWidth, fixedBarWidth) {
var spacing;
var width;
if (fixedBarWidth) {
width = Math.min(fixedBarWidth, _round(barsArea / count));
spacing = count > 1 ? _round((barsArea - width * count) / (count - 1)) : 0
} else {
if (isDefined(percentWidth)) {
width = _round(barsArea * percentWidth / count);
spacing = _round(count > 1 ? (barsArea - barsArea * percentWidth) / (count - 1) : 0)
} else {
spacing = _round(barsArea / count * .2);
width = _round((barsArea - spacing * (count - 1)) / count)
}
}
return {
width: width > 1 ? width : 1,
spacing: spacing,
middleIndex: count / 2
}
}
function getOffset(stackIndex, parameters) {
return (stackIndex - parameters.middleIndex + .5) * parameters.width - (parameters.middleIndex - stackIndex - .5) * parameters.spacing
}
function correctPointCoordinates(points, width, offset) {
_each(points, function(_, point) {
point.correctCoordinates({
width: width,
offset: offset
})
})
}
function getValueType(value) {
return value >= 0 ? "positive" : "negative"
}
function getVisibleSeries(that) {
return that.series.filter(function(s) {
return s.isVisible()
})
}
function getAbsStackSumByArg(stackKeepers, stackName, argument) {
var positiveStackValue = (stackKeepers.positive[stackName] || {})[argument] || 0;
var negativeStackValue = -(stackKeepers.negative[stackName] || {})[argument] || 0;
return positiveStackValue + negativeStackValue
}
function getStackSumByArg(stackKeepers, stackName, argument) {
var positiveStackValue = (stackKeepers.positive[stackName] || {})[argument] || 0;
var negativeStackValue = (stackKeepers.negative[stackName] || {})[argument] || 0;
return positiveStackValue + negativeStackValue
}
function getSeriesStackIndexCallback(inverted) {
if (!inverted) {
return function(index) {
return index
}
} else {
return function(index, stackCount) {
return stackCount - index - 1
}
}
}
function isInverted(series) {
return series[0] && series[0].getArgumentAxis().getTranslator().isInverted()
}
function adjustBarSeriesDimensions() {
var series = getVisibleSeries(this);
adjustBarSeriesDimensionsCore(series, this._options, getSeriesStackIndexCallback(isInverted(series)))
}
function getFirstValueSign(series) {
var points = series.getPoints();
var value;
for (var i = 0; i < points.length; i++) {
var point = points[i];
value = point.initialValue && point.initialValue.valueOf();
if (Math.abs(value) > 0) {
break
}
}
return sign(value)
}
function adjustStackedSeriesValues() {
var that = this;
var negativesAsZeroes = that._options.negativesAsZeroes;
var series = getVisibleSeries(that);
var stackKeepers = {
positive: {},
negative: {}
};
var holesStack = {
left: {},
right: {}
};
var lastSeriesInPositiveStack = {};
var lastSeriesInNegativeStack = {};
series.forEach(function(singleSeries) {
var stackName = singleSeries.getStackName() || singleSeries.getBarOverlapGroup();
var hole = false;
var stack = getFirstValueSign(singleSeries) < 0 ? lastSeriesInNegativeStack : lastSeriesInPositiveStack;
singleSeries._prevSeries = stack[stackName];
stack[stackName] = singleSeries;
singleSeries.holes = extend(true, {}, holesStack);
singleSeries.getPoints().forEach(function(point, index, points) {
var value = point.initialValue && point.initialValue.valueOf();
var argument = point.argument.valueOf();
var stacks = value >= 0 ? stackKeepers.positive : stackKeepers.negative;
var isNotBarSeries = "bar" !== singleSeries.type;
var currentStack;
if (negativesAsZeroes && value < 0) {
stacks = stackKeepers.positive;
value = 0;
point.resetValue()
}
stacks[stackName] = stacks[stackName] || {};
currentStack = stacks[stackName];
if (currentStack[argument]) {
if (isNotBarSeries) {
point.correctValue(currentStack[argument])
}
currentStack[argument] += value
} else {
currentStack[argument] = value;
if (isNotBarSeries) {
point.resetCorrection()
}
}
if (!point.hasValue()) {
var prevPoint = points[index - 1];
if (!hole && prevPoint && prevPoint.hasValue()) {
argument = prevPoint.argument.valueOf();
prevPoint._skipSetRightHole = true;
holesStack.right[argument] = (holesStack.right[argument] || 0) + (prevPoint.value.valueOf() - (isFinite(prevPoint.minValue) ? prevPoint.minValue.valueOf() : 0))
}
hole = true
} else {
if (hole) {
hole = false;
holesStack.left[argument] = (holesStack.left[argument] || 0) + (point.value.valueOf() - (isFinite(point.minValue) ? point.minValue.valueOf() : 0));
point._skipSetLeftHole = true
}
}
})
});
series.forEach(function(singleSeries) {
var holes = singleSeries.holes;
singleSeries.getPoints().forEach(function(point) {
var argument = point.argument.valueOf();
point.resetHoles();
!point._skipSetLeftHole && point.setHole(holes.left[argument] || holesStack.left[argument] && 0, "left");
!point._skipSetRightHole && point.setHole(holes.right[argument] || holesStack.right[argument] && 0, "right");
point._skipSetLeftHole = null;
point._skipSetRightHole = null
})
});
that._stackKeepers = stackKeepers;
series.forEach(function(singleSeries) {
singleSeries.getPoints().forEach(function(point) {
var argument = point.argument.valueOf();
var stackName = singleSeries.getStackName() || singleSeries.getBarOverlapGroup();
var absTotal = getAbsStackSumByArg(stackKeepers, stackName, argument);
var total = getStackSumByArg(stackKeepers, stackName, argument);
point.setPercentValue(absTotal, total, holesStack.left[argument], holesStack.right[argument])
})
})
}
function updateStackedSeriesValues() {
var that = this;
var series = getVisibleSeries(that);
var stack = that._stackKeepers;
var stackKeepers = {
positive: {},
negative: {}
};
_each(series, function(_, singleSeries) {
var minBarSize = singleSeries.getOptions().minBarSize;
var valueAxisTranslator = singleSeries.getValueAxis().getTranslator();
var minShownBusinessValue = minBarSize && valueAxisTranslator.getMinBarSize(minBarSize);
var stackName = singleSeries.getStackName();
_each(singleSeries.getPoints(), function(index, point) {
if (!point.hasValue()) {
return
}
var value = point.initialValue && point.initialValue.valueOf();
var argument = point.argument.valueOf();
var updateValue;
var valueType;
var currentStack;
if (that.fullStacked) {
value = value / getAbsStackSumByArg(stack, stackName, argument) || 0
}
updateValue = valueAxisTranslator.checkMinBarSize(value, minShownBusinessValue, point.value);
valueType = getValueType(updateValue);
currentStack = stackKeepers[valueType][stackName] = stackKeepers[valueType][stackName] || {};
if (currentStack[argument]) {
point.minValue = currentStack[argument];
currentStack[argument] += updateValue
} else {
currentStack[argument] = updateValue
}
point.value = currentStack[argument]
})
});
if (that.fullStacked) {
updateFullStackedSeriesValues(series, stackKeepers)
}
}
function updateFullStackedSeriesValues(series, stackKeepers) {
_each(series, function(_, singleSeries) {
var stackName = singleSeries.getStackName ? singleSeries.getStackName() : "default";
_each(singleSeries.getPoints(), function(index, point) {
var stackSum = getAbsStackSumByArg(stackKeepers, stackName, point.argument.valueOf());
point.value = point.value / stackSum;
if (isNumeric(point.minValue)) {
point.minValue = point.minValue / stackSum
}
})
})
}
function updateBarSeriesValues() {
_each(this.series, function(_, singleSeries) {
var minBarSize = singleSeries.getOptions().minBarSize;
var valueAxisTranslator = singleSeries.getValueAxis().getTranslator();
var minShownBusinessValue = minBarSize && valueAxisTranslator.getMinBarSize(minBarSize);
if (minShownBusinessValue) {
_each(singleSeries.getPoints(), function(index, point) {
if (point.hasValue()) {
point.value = valueAxisTranslator.checkMinBarSize(point.initialValue, minShownBusinessValue)
}
})
}
})
}
function adjustCandlestickSeriesDimensions() {
var series = getVisibleSeries(this);
adjustBarSeriesDimensionsCore(series, {
barWidth: null,
equalBarWidth: true,
barGroupPadding: .3
}, getSeriesStackIndexCallback(isInverted(series)))
}
function adjustBubbleSeriesDimensions() {
var series = getVisibleSeries(this);
if (!series.length) {
return
}
var options = this._options;
var visibleAreaX = series[0].getArgumentAxis().getVisibleArea();
var visibleAreaY = series[0].getValueAxis().getVisibleArea();
var min = _math.min(visibleAreaX[1] - visibleAreaX[0], visibleAreaY[1] - visibleAreaY[0]);
var minBubbleArea = _pow(options.minBubbleSize, 2);
var maxBubbleArea = _pow(min * options.maxBubbleSize, 2);
var equalBubbleSize = (min * options.maxBubbleSize + options.minBubbleSize) / 2;
var minPointSize = 1 / 0;
var maxPointSize = -(1 / 0);
var pointSize;
var bubbleArea;
var sizeProportion;
var sizeDispersion;
var areaDispersion;
_each(series, function(_, seriesItem) {
_each(seriesItem.getPoints(), function(_, point) {
maxPointSize = maxPointSize > point.size ? maxPointSize : point.size;
minPointSize = minPointSize < point.size ? minPointSize : point.size
})
});
sizeDispersion = maxPointSize - minPointSize;
areaDispersion = _abs(maxBubbleArea - minBubbleArea);
_each(series, function(_, seriesItem) {
_each(seriesItem.getPoints(), function(_, point) {
if (maxPointSize === minPointSize) {
pointSize = _round(equalBubbleSize)
} else {
sizeProportion = _abs(point.size - minPointSize) / sizeDispersion;
bubbleArea = areaDispersion * sizeProportion + minBubbleArea;
pointSize = _round(_math.sqrt(bubbleArea))
}
point.correctCoordinates(pointSize)
})
})
}
function SeriesFamily(options) {
var that = this;
that.type = _normalizeEnum(options.type);
that.pane = options.pane;
that.series = [];
that.updateOptions(options);
switch (that.type) {
case "bar":
that.adjustSeriesDimensions = adjustBarSeriesDimensions;
that.updateSeriesValues = updateBarSeriesValues;
that.adjustSeriesValues = adjustStackedSeriesValues;
break;
case "rangebar":
that.adjustSeriesDimensions = adjustBarSeriesDimensions;
break;
case "fullstackedbar":
that.fullStacked = true;
that.adjustSeriesDimensions = adjustBarSeriesDimensions;
that.adjustSeriesValues = adjustStackedSeriesValues;
that.updateSeriesValues = updateStackedSeriesValues;
break;
case "stackedbar":
that.adjustSeriesDimensions = adjustBarSeriesDimensions;
that.adjustSeriesValues = adjustStackedSeriesValues;
that.updateSeriesValues = updateStackedSeriesValues;
break;
case "fullstackedarea":
case "fullstackedline":
case "fullstackedspline":
case "fullstackedsplinearea":
that.fullStacked = true;
that.adjustSeriesValues = adjustStackedSeriesValues;
break;
case "stackedarea":
case "stackedsplinearea":
case "stackedline":
case "stackedspline":
that.adjustSeriesValues = adjustStackedSeriesValues;
break;
case "candlestick":
case "stock":
that.adjustSeriesDimensions = adjustCandlestickSeriesDimensions;
break;
case "bubble":
that.adjustSeriesDimensions = adjustBubbleSeriesDimensions
}
}
exports.SeriesFamily = SeriesFamily;
SeriesFamily.prototype = {
constructor: SeriesFamily,
adjustSeriesDimensions: _noop,
adjustSeriesValues: _noop,
updateSeriesValues: _noop,
updateOptions: function(options) {
this._options = options
},
dispose: function() {
this.series = null
},
add: function(series) {
var type = this.type;
this.series = vizUtils.map(series, function(singleSeries) {
return singleSeries.type === type ? singleSeries : null
})
}
};