flot
Version:
## About ##
1,313 lines (1,115 loc) • 104 kB
JavaScript
/* Javascript plotting library for jQuery, version 1.0.3.
Copyright (c) 2007-2014 IOLA and Ole Laursen.
Licensed under the MIT license.
*/
// the actual Flot code
(function($) {
"use strict";
var Canvas = window.Flot.Canvas;
function defaultTickGenerator(axis) {
var ticks = [],
start = $.plot.saturated.saturate($.plot.saturated.floorInBase(axis.min, axis.tickSize)),
i = 0,
v = Number.NaN,
prev;
if (start === -Number.MAX_VALUE) {
ticks.push(start);
start = $.plot.saturated.floorInBase(axis.min + axis.tickSize, axis.tickSize);
}
do {
prev = v;
//v = start + i * axis.tickSize;
v = $.plot.saturated.multiplyAdd(axis.tickSize, i, start);
ticks.push(v);
++i;
} while (v < axis.max && v !== prev);
return ticks;
}
function defaultTickFormatter(value, axis, precision) {
var oldTickDecimals = axis.tickDecimals,
expPosition = ("" + value).indexOf("e");
if (expPosition !== -1) {
return expRepTickFormatter(value, axis, precision);
}
if (precision > 0) {
axis.tickDecimals = precision;
}
var factor = axis.tickDecimals ? Math.pow(10, axis.tickDecimals) : 1,
formatted = "" + Math.round(value * factor) / factor;
// If tickDecimals was specified, ensure that we have exactly that
// much precision; otherwise default to the value's own precision.
if (axis.tickDecimals != null) {
var decimal = formatted.indexOf("."),
decimalPrecision = decimal === -1 ? 0 : formatted.length - decimal - 1;
if (decimalPrecision < axis.tickDecimals) {
var decimals = ("" + factor).substr(1, axis.tickDecimals - decimalPrecision);
formatted = (decimalPrecision ? formatted : formatted + ".") + decimals;
}
}
axis.tickDecimals = oldTickDecimals;
return formatted;
};
function expRepTickFormatter(value, axis, precision) {
var expPosition = ("" + value).indexOf("e"),
exponentValue = parseInt(("" + value).substr(expPosition + 1)),
tenExponent = expPosition !== -1 ? exponentValue : (value > 0 ? Math.floor(Math.log(value) / Math.LN10) : 0),
roundWith = Math.pow(10, tenExponent),
x = value / roundWith;
if (precision) {
var updatedPrecision = recomputePrecision(value, precision);
return (value / roundWith).toFixed(updatedPrecision) + 'e' + tenExponent;
}
if (axis.tickDecimals > 0) {
return x.toFixed(recomputePrecision(value, axis.tickDecimals)) + 'e' + tenExponent;
}
return x.toFixed() + 'e' + tenExponent;
}
function recomputePrecision(num, precision) {
//for numbers close to zero, the precision from flot will be a big number
//while for big numbers, the precision will be negative
var log10Value = Math.log(Math.abs(num)) * Math.LOG10E,
newPrecision = Math.abs(log10Value + precision);
return newPrecision <= 20 ? Math.floor(newPrecision) : 20;
}
///////////////////////////////////////////////////////////////////////////
// The top-level container for the entire plot.
function Plot(placeholder, data_, options_, plugins) {
// data is on the form:
// [ series1, series2 ... ]
// where series is either just the data as [ [x1, y1], [x2, y2], ... ]
// or { data: [ [x1, y1], [x2, y2], ... ], label: "some label", ... }
var series = [],
options = {
// the color theme used for graphs
colors: ["#edc240", "#afd8f8", "#cb4b4b", "#4da74d", "#9440ed"],
xaxis: {
show: null, // null = auto-detect, true = always, false = never
position: "bottom", // or "top"
mode: null, // null or "time"
font: null, // null (derived from CSS in placeholder) or object like { size: 11, lineHeight: 13, style: "italic", weight: "bold", family: "sans-serif", variant: "small-caps" }
color: null, // base color, labels, ticks
tickColor: null, // possibly different color of ticks, e.g. "rgba(0,0,0,0.15)"
transform: null, // null or f: number -> number to transform axis
inverseTransform: null, // if transform is set, this should be the inverse function
min: null, // min. value to show, null means set automatically
max: null, // max. value to show, null means set automatically
autoScaleMargin: null, // margin in % to add if autoScale option is on "loose" mode,
autoScale: "exact", // Available modes: "none", "loose", "exact", "sliding-window"
windowSize: null, // null or number. This is the size of sliding-window.
growOnly: null, // grow only, useful for smoother auto-scale, the scales will grow to accomodate data but won't shrink back.
ticks: null, // either [1, 3] or [[1, "a"], 3] or (fn: axis info -> ticks) or app. number of ticks for auto-ticks
tickFormatter: null, // fn: number -> string
showTickLabels: "major", // "none", "endpoints", "major", "all"
labelWidth: null, // size of tick labels in pixels
labelHeight: null,
reserveSpace: null, // whether to reserve space even if axis isn't shown
tickLength: null, // size in pixels of major tick marks
showMinorTicks: null, // true = show minor tick marks, false = hide minor tick marks
showTicks: null, // true = show tick marks, false = hide all tick marks
gridLines: null, // true = show grid lines, false = hide grid lines
alignTicksWithAxis: null, // axis number or null for no sync
tickDecimals: null, // no. of decimals, null means auto
tickSize: null, // number or [number, "unit"]
minTickSize: null, // number or [number, "unit"]
offset: { below: 0, above: 0 }, // the plot drawing offset. this is calculated by the flot.navigate for each axis
boxPosition: { centerX: 0, centerY: 0 } //position of the axis on the corresponding axis box
},
yaxis: {
autoScaleMargin: 0.02, // margin in % to add if autoScale option is on "loose" mode
autoScale: "loose", // Available modes: "none", "loose", "exact"
growOnly: null, // grow only, useful for smoother auto-scale, the scales will grow to accomodate data but won't shrink back.
position: "left", // or "right"
showTickLabels: "major", // "none", "endpoints", "major", "all"
offset: { below: 0, above: 0 }, // the plot drawing offset. this is calculated by the flot.navigate for each axis
boxPosition: { centerX: 0, centerY: 0 } //position of the axis on the corresponding axis box
},
xaxes: [],
yaxes: [],
series: {
points: {
show: false,
radius: 3,
lineWidth: 2, // in pixels
fill: true,
fillColor: "#ffffff",
symbol: 'circle' // or callback
},
lines: {
// we don't put in show: false so we can see
// whether lines were actively disabled
lineWidth: 1, // in pixels
fill: false,
fillColor: null,
steps: false
// Omit 'zero', so we can later default its value to
// match that of the 'fill' option.
},
bars: {
show: false,
lineWidth: 2, // in pixels
// barWidth: number or [number, absolute]
// when 'absolute' is false, 'number' is relative to the minimum distance between points for the series
// when 'absolute' is true, 'number' is considered to be in units of the x-axis
horizontal: false,
barWidth: 0.8,
fill: true,
fillColor: null,
align: "left", // "left", "right", or "center"
zero: true
},
shadowSize: 3,
highlightColor: null
},
grid: {
show: true,
aboveData: false,
color: "#545454", // primary color used for outline and labels
backgroundColor: null, // null for transparent, else color
borderColor: null, // set if different from the grid color
tickColor: null, // color for the ticks, e.g. "rgba(0,0,0,0.15)"
margin: 0, // distance from the canvas edge to the grid
labelMargin: 5, // in pixels
axisMargin: 8, // in pixels
borderWidth: 1, // in pixels
minBorderMargin: null, // in pixels, null means taken from points radius
markings: null, // array of ranges or fn: axes -> array of ranges
markingsColor: "#f4f4f4",
markingsLineWidth: 2,
// interactive stuff
clickable: false,
hoverable: false,
autoHighlight: true, // highlight in case mouse is near
mouseActiveRadius: 15 // how far the mouse can be away to activate an item
},
interaction: {
redrawOverlayInterval: 1000 / 60 // time between updates, -1 means in same flow
},
hooks: {}
},
surface = null, // the canvas for the plot itself
overlay = null, // canvas for interactive stuff on top of plot
eventHolder = null, // jQuery object that events should be bound to
ctx = null,
octx = null,
xaxes = [],
yaxes = [],
plotOffset = {
left: 0,
right: 0,
top: 0,
bottom: 0
},
plotWidth = 0,
plotHeight = 0,
hooks = {
processOptions: [],
processRawData: [],
processDatapoints: [],
processOffset: [],
setupGrid: [],
adjustSeriesDataRange: [],
setRange: [],
drawBackground: [],
drawSeries: [],
drawAxis: [],
draw: [],
axisReserveSpace: [],
bindEvents: [],
drawOverlay: [],
resize: [],
shutdown: []
},
plot = this;
var eventManager = {};
// interactive features
var redrawTimeout = null;
// public functions
plot.setData = setData;
plot.setupGrid = setupGrid;
plot.draw = draw;
plot.getPlaceholder = function() {
return placeholder;
};
plot.getCanvas = function() {
return surface.element;
};
plot.getSurface = function() {
return surface;
};
plot.getEventHolder = function() {
return eventHolder[0];
};
plot.getPlotOffset = function() {
return plotOffset;
};
plot.width = function() {
return plotWidth;
};
plot.height = function() {
return plotHeight;
};
plot.offset = function() {
var o = eventHolder.offset();
o.left += plotOffset.left;
o.top += plotOffset.top;
return o;
};
plot.getData = function() {
return series;
};
plot.getAxes = function() {
var res = {};
$.each(xaxes.concat(yaxes), function(_, axis) {
if (axis) {
res[axis.direction + (axis.n !== 1 ? axis.n : "") + "axis"] = axis;
}
});
return res;
};
plot.getXAxes = function() {
return xaxes;
};
plot.getYAxes = function() {
return yaxes;
};
plot.c2p = canvasToCartesianAxisCoords;
plot.p2c = cartesianAxisToCanvasCoords;
plot.getOptions = function() {
return options;
};
plot.triggerRedrawOverlay = triggerRedrawOverlay;
plot.pointOffset = function(point) {
return {
left: parseInt(xaxes[axisNumber(point, "x") - 1].p2c(+point.x) + plotOffset.left, 10),
top: parseInt(yaxes[axisNumber(point, "y") - 1].p2c(+point.y) + plotOffset.top, 10)
};
};
plot.shutdown = shutdown;
plot.destroy = function() {
shutdown();
placeholder.removeData("plot").empty();
series = [];
options = null;
surface = null;
overlay = null;
eventHolder = null;
ctx = null;
octx = null;
xaxes = [];
yaxes = [];
hooks = null;
plot = null;
};
plot.resize = function() {
var width = placeholder.width(),
height = placeholder.height();
surface.resize(width, height);
overlay.resize(width, height);
executeHooks(hooks.resize, [width, height]);
};
plot.clearTextCache = function () {
surface.clearCache();
overlay.clearCache();
};
plot.autoScaleAxis = autoScaleAxis;
plot.computeRangeForDataSeries = computeRangeForDataSeries;
plot.adjustSeriesDataRange = adjustSeriesDataRange;
plot.findNearbyItem = findNearbyItem;
plot.findNearbyInterpolationPoint = findNearbyInterpolationPoint;
plot.computeValuePrecision = computeValuePrecision;
plot.computeTickSize = computeTickSize;
plot.addEventHandler = addEventHandler;
// public attributes
plot.hooks = hooks;
// initialize
var MINOR_TICKS_COUNT_CONSTANT = $.plot.uiConstants.MINOR_TICKS_COUNT_CONSTANT;
var TICK_LENGTH_CONSTANT = $.plot.uiConstants.TICK_LENGTH_CONSTANT;
initPlugins(plot);
setupCanvases();
parseOptions(options_);
setData(data_);
setupGrid(true);
draw();
bindEvents();
function executeHooks(hook, args) {
args = [plot].concat(args);
for (var i = 0; i < hook.length; ++i) {
hook[i].apply(this, args);
}
}
function initPlugins() {
// References to key classes, allowing plugins to modify them
var classes = {
Canvas: Canvas
};
for (var i = 0; i < plugins.length; ++i) {
var p = plugins[i];
p.init(plot, classes);
if (p.options) {
$.extend(true, options, p.options);
}
}
}
function parseOptions(opts) {
$.extend(true, options, opts);
// $.extend merges arrays, rather than replacing them. When less
// colors are provided than the size of the default palette, we
// end up with those colors plus the remaining defaults, which is
// not expected behavior; avoid it by replacing them here.
if (opts && opts.colors) {
options.colors = opts.colors;
}
if (options.xaxis.color == null) {
options.xaxis.color = $.color.parse(options.grid.color).scale('a', 0.22).toString();
}
if (options.yaxis.color == null) {
options.yaxis.color = $.color.parse(options.grid.color).scale('a', 0.22).toString();
}
if (options.xaxis.tickColor == null) {
// grid.tickColor for back-compatibility
options.xaxis.tickColor = options.grid.tickColor || options.xaxis.color;
}
if (options.yaxis.tickColor == null) {
// grid.tickColor for back-compatibility
options.yaxis.tickColor = options.grid.tickColor || options.yaxis.color;
}
if (options.grid.borderColor == null) {
options.grid.borderColor = options.grid.color;
}
if (options.grid.tickColor == null) {
options.grid.tickColor = $.color.parse(options.grid.color).scale('a', 0.22).toString();
}
// Fill in defaults for axis options, including any unspecified
// font-spec fields, if a font-spec was provided.
// If no x/y axis options were provided, create one of each anyway,
// since the rest of the code assumes that they exist.
var i, axisOptions, axisCount,
fontSize = placeholder.css("font-size"),
fontSizeDefault = fontSize ? +fontSize.replace("px", "") : 13,
fontDefaults = {
style: placeholder.css("font-style"),
size: Math.round(0.8 * fontSizeDefault),
variant: placeholder.css("font-variant"),
weight: placeholder.css("font-weight"),
family: placeholder.css("font-family")
};
axisCount = options.xaxes.length || 1;
for (i = 0; i < axisCount; ++i) {
axisOptions = options.xaxes[i];
if (axisOptions && !axisOptions.tickColor) {
axisOptions.tickColor = axisOptions.color;
}
axisOptions = $.extend(true, {}, options.xaxis, axisOptions);
options.xaxes[i] = axisOptions;
if (axisOptions.font) {
axisOptions.font = $.extend({}, fontDefaults, axisOptions.font);
if (!axisOptions.font.color) {
axisOptions.font.color = axisOptions.color;
}
if (!axisOptions.font.lineHeight) {
axisOptions.font.lineHeight = Math.round(axisOptions.font.size * 1.15);
}
}
}
axisCount = options.yaxes.length || 1;
for (i = 0; i < axisCount; ++i) {
axisOptions = options.yaxes[i];
if (axisOptions && !axisOptions.tickColor) {
axisOptions.tickColor = axisOptions.color;
}
axisOptions = $.extend(true, {}, options.yaxis, axisOptions);
options.yaxes[i] = axisOptions;
if (axisOptions.font) {
axisOptions.font = $.extend({}, fontDefaults, axisOptions.font);
if (!axisOptions.font.color) {
axisOptions.font.color = axisOptions.color;
}
if (!axisOptions.font.lineHeight) {
axisOptions.font.lineHeight = Math.round(axisOptions.font.size * 1.15);
}
}
}
// save options on axes for future reference
for (i = 0; i < options.xaxes.length; ++i) {
getOrCreateAxis(xaxes, i + 1).options = options.xaxes[i];
}
for (i = 0; i < options.yaxes.length; ++i) {
getOrCreateAxis(yaxes, i + 1).options = options.yaxes[i];
}
//process boxPosition options used for axis.box size
$.each(allAxes(), function(_, axis) {
axis.boxPosition = axis.options.boxPosition || {centerX: 0, centerY: 0};
});
// add hooks from options
for (var n in hooks) {
if (options.hooks[n] && options.hooks[n].length) {
hooks[n] = hooks[n].concat(options.hooks[n]);
}
}
executeHooks(hooks.processOptions, [options]);
}
function setData(d) {
var oldseries = series;
series = parseData(d);
fillInSeriesOptions();
processData(oldseries);
}
function parseData(d) {
var res = [];
for (var i = 0; i < d.length; ++i) {
var s = $.extend(true, {}, options.series);
if (d[i].data != null) {
s.data = d[i].data; // move the data instead of deep-copy
delete d[i].data;
$.extend(true, s, d[i]);
d[i].data = s.data;
} else {
s.data = d[i];
}
res.push(s);
}
return res;
}
function axisNumber(obj, coord) {
var a = obj[coord + "axis"];
if (typeof a === "object") {
// if we got a real axis, extract number
a = a.n;
}
if (typeof a !== "number") {
a = 1; // default to first axis
}
return a;
}
function allAxes() {
// return flat array without annoying null entries
return xaxes.concat(yaxes).filter(function(a) {
return a;
});
}
// canvas to axis for cartesian axes
function canvasToCartesianAxisCoords(pos) {
// return an object with x/y corresponding to all used axes
var res = {},
i, axis;
for (i = 0; i < xaxes.length; ++i) {
axis = xaxes[i];
if (axis && axis.used) {
res["x" + axis.n] = axis.c2p(pos.left);
}
}
for (i = 0; i < yaxes.length; ++i) {
axis = yaxes[i];
if (axis && axis.used) {
res["y" + axis.n] = axis.c2p(pos.top);
}
}
if (res.x1 !== undefined) {
res.x = res.x1;
}
if (res.y1 !== undefined) {
res.y = res.y1;
}
return res;
}
// axis to canvas for cartesian axes
function cartesianAxisToCanvasCoords(pos) {
// get canvas coords from the first pair of x/y found in pos
var res = {},
i, axis, key;
for (i = 0; i < xaxes.length; ++i) {
axis = xaxes[i];
if (axis && axis.used) {
key = "x" + axis.n;
if (pos[key] == null && axis.n === 1) {
key = "x";
}
if (pos[key] != null) {
res.left = axis.p2c(pos[key]);
break;
}
}
}
for (i = 0; i < yaxes.length; ++i) {
axis = yaxes[i];
if (axis && axis.used) {
key = "y" + axis.n;
if (pos[key] == null && axis.n === 1) {
key = "y";
}
if (pos[key] != null) {
res.top = axis.p2c(pos[key]);
break;
}
}
}
return res;
}
function getOrCreateAxis(axes, number) {
if (!axes[number - 1]) {
axes[number - 1] = {
n: number, // save the number for future reference
direction: axes === xaxes ? "x" : "y",
options: $.extend(true, {}, axes === xaxes ? options.xaxis : options.yaxis)
};
}
return axes[number - 1];
}
function fillInSeriesOptions() {
var neededColors = series.length,
maxIndex = -1,
i;
// Subtract the number of series that already have fixed colors or
// color indexes from the number that we still need to generate.
for (i = 0; i < series.length; ++i) {
var sc = series[i].color;
if (sc != null) {
neededColors--;
if (typeof sc === "number" && sc > maxIndex) {
maxIndex = sc;
}
}
}
// If any of the series have fixed color indexes, then we need to
// generate at least as many colors as the highest index.
if (neededColors <= maxIndex) {
neededColors = maxIndex + 1;
}
// Generate all the colors, using first the option colors and then
// variations on those colors once they're exhausted.
var c, colors = [],
colorPool = options.colors,
colorPoolSize = colorPool.length,
variation = 0,
definedColors = Math.max(0, series.length - neededColors);
for (i = 0; i < neededColors; i++) {
c = $.color.parse(colorPool[(definedColors + i) % colorPoolSize] || "#666");
// Each time we exhaust the colors in the pool we adjust
// a scaling factor used to produce more variations on
// those colors. The factor alternates negative/positive
// to produce lighter/darker colors.
// Reset the variation after every few cycles, or else
// it will end up producing only white or black colors.
if (i % colorPoolSize === 0 && i) {
if (variation >= 0) {
if (variation < 0.5) {
variation = -variation - 0.2;
} else variation = 0;
} else variation = -variation;
}
colors[i] = c.scale('rgb', 1 + variation);
}
// Finalize the series options, filling in their colors
var colori = 0,
s;
for (i = 0; i < series.length; ++i) {
s = series[i];
// assign colors
if (s.color == null) {
s.color = colors[colori].toString();
++colori;
} else if (typeof s.color === "number") {
s.color = colors[s.color].toString();
}
// turn on lines automatically in case nothing is set
if (s.lines.show == null) {
var v, show = true;
for (v in s) {
if (s[v] && s[v].show) {
show = false;
break;
}
}
if (show) {
s.lines.show = true;
}
}
// If nothing was provided for lines.zero, default it to match
// lines.fill, since areas by default should extend to zero.
if (s.lines.zero == null) {
s.lines.zero = !!s.lines.fill;
}
// setup axes
s.xaxis = getOrCreateAxis(xaxes, axisNumber(s, "x"));
s.yaxis = getOrCreateAxis(yaxes, axisNumber(s, "y"));
}
}
function processData(prevSeries) {
var topSentry = Number.POSITIVE_INFINITY,
bottomSentry = Number.NEGATIVE_INFINITY,
i, j, k, m,
s, points, ps, val, f, p,
data, format;
function updateAxis(axis, min, max) {
if (min < axis.datamin && min !== -Infinity) {
axis.datamin = min;
}
if (max > axis.datamax && max !== Infinity) {
axis.datamax = max;
}
}
function reusePoints(prevSeries, i) {
if (prevSeries && prevSeries[i] && prevSeries[i].datapoints && prevSeries[i].datapoints.points) {
return prevSeries[i].datapoints.points;
}
return [];
}
$.each(allAxes(), function(_, axis) {
// init axis
if (axis.options.growOnly !== true) {
axis.datamin = topSentry;
axis.datamax = bottomSentry;
} else {
if (axis.datamin === undefined) {
axis.datamin = topSentry;
}
if (axis.datamax === undefined) {
axis.datamax = bottomSentry;
}
}
axis.used = false;
});
for (i = 0; i < series.length; ++i) {
s = series[i];
s.datapoints = {
points: []
};
if (s.datapoints.points.length === 0) {
s.datapoints.points = reusePoints(prevSeries, i);
}
executeHooks(hooks.processRawData, [s, s.data, s.datapoints]);
}
// first pass: clean and copy data
for (i = 0; i < series.length; ++i) {
s = series[i];
data = s.data;
format = s.datapoints.format;
if (!format) {
format = [];
// find out how to copy
format.push({
x: true,
y: false,
number: true,
required: true,
computeRange: s.xaxis.options.autoScale !== 'none',
defaultValue: null
});
format.push({
x: false,
y: true,
number: true,
required: true,
computeRange: s.yaxis.options.autoScale !== 'none',
defaultValue: null
});
if (s.stack || s.bars.show || (s.lines.show && s.lines.fill)) {
var expectedPs = s.datapoints.pointsize != null ? s.datapoints.pointsize : (s.data && s.data[0] && s.data[0].length ? s.data[0].length : 3);
if (expectedPs > 2) {
format.push({
x: false,
y: true,
number: true,
required: false,
computeRange: s.yaxis.options.autoScale !== 'none',
defaultValue: 0
});
}
}
s.datapoints.format = format;
}
s.xaxis.used = s.yaxis.used = true;
if (s.datapoints.pointsize != null) continue; // already filled in
s.datapoints.pointsize = format.length;
ps = s.datapoints.pointsize;
points = s.datapoints.points;
var insertSteps = s.lines.show && s.lines.steps;
for (j = k = 0; j < data.length; ++j, k += ps) {
p = data[j];
var nullify = p == null;
if (!nullify) {
for (m = 0; m < ps; ++m) {
val = p[m];
f = format[m];
if (f) {
if (f.number && val != null) {
val = +val; // convert to number
if (isNaN(val)) {
val = null;
}
}
if (val == null) {
if (f.required) nullify = true;
if (f.defaultValue != null) val = f.defaultValue;
}
}
points[k + m] = val;
}
}
if (nullify) {
for (m = 0; m < ps; ++m) {
val = points[k + m];
if (val != null) {
f = format[m];
// extract min/max info
if (f.computeRange) {
if (f.x) {
updateAxis(s.xaxis, val, val);
}
if (f.y) {
updateAxis(s.yaxis, val, val);
}
}
}
points[k + m] = null;
}
}
}
points.length = k; //trims the internal buffer to the correct length
}
// give the hooks a chance to run
for (i = 0; i < series.length; ++i) {
s = series[i];
executeHooks(hooks.processDatapoints, [s, s.datapoints]);
}
// second pass: find datamax/datamin for auto-scaling
for (i = 0; i < series.length; ++i) {
s = series[i];
format = s.datapoints.format;
if (format.every(function (f) { return !f.computeRange; })) {
continue;
}
var range = plot.adjustSeriesDataRange(s,
plot.computeRangeForDataSeries(s));
executeHooks(hooks.adjustSeriesDataRange, [s, range]);
updateAxis(s.xaxis, range.xmin, range.xmax);
updateAxis(s.yaxis, range.ymin, range.ymax);
}
$.each(allAxes(), function(_, axis) {
if (axis.datamin === topSentry) {
axis.datamin = null;
}
if (axis.datamax === bottomSentry) {
axis.datamax = null;
}
});
}
function setupCanvases() {
// Make sure the placeholder is clear of everything except canvases
// from a previous plot in this container that we'll try to re-use.
placeholder.css("padding", 0) // padding messes up the positioning
.children().filter(function() {
return !$(this).hasClass("flot-overlay") && !$(this).hasClass('flot-base');
}).remove();
if (placeholder.css("position") === 'static') {
placeholder.css("position", "relative"); // for positioning labels and overlay
}
surface = new Canvas("flot-base", placeholder[0]);
overlay = new Canvas("flot-overlay", placeholder[0]); // overlay canvas for interactive features
ctx = surface.context;
octx = overlay.context;
// define which element we're listening for events on
eventHolder = $(overlay.element).unbind();
// If we're re-using a plot object, shut down the old one
var existing = placeholder.data("plot");
if (existing) {
existing.shutdown();
overlay.clear();
}
// save in case we get replotted
placeholder.data("plot", plot);
}
function bindEvents() {
executeHooks(hooks.bindEvents, [eventHolder]);
}
function addEventHandler(event, handler, eventHolder, priority) {
var key = eventHolder + event;
var eventList = eventManager[key] || [];
eventList.push({"event": event, "handler": handler, "eventHolder": eventHolder, "priority": priority});
eventList.sort((a, b) => b.priority - a.priority );
eventList.forEach( eventData => {
eventData.eventHolder.unbind(eventData.event, eventData.handler);
eventData.eventHolder.bind(eventData.event, eventData.handler);
});
eventManager[key] = eventList;
}
function shutdown() {
if (redrawTimeout) {
clearTimeout(redrawTimeout);
}
executeHooks(hooks.shutdown, [eventHolder]);
}
function setTransformationHelpers(axis) {
// set helper functions on the axis, assumes plot area
// has been computed already
function identity(x) {
return x;
}
var s, m, t = axis.options.transform || identity,
it = axis.options.inverseTransform;
// precompute how much the axis is scaling a point
// in canvas space
if (axis.direction === "x") {
if (isFinite(t(axis.max) - t(axis.min))) {
s = axis.scale = plotWidth / Math.abs(t(axis.max) - t(axis.min));
} else {
s = axis.scale = 1 / Math.abs($.plot.saturated.delta(t(axis.min), t(axis.max), plotWidth));
}
m = Math.min(t(axis.max), t(axis.min));
} else {
if (isFinite(t(axis.max) - t(axis.min))) {
s = axis.scale = plotHeight / Math.abs(t(axis.max) - t(axis.min));
} else {
s = axis.scale = 1 / Math.abs($.plot.saturated.delta(t(axis.min), t(axis.max), plotHeight));
}
s = -s;
m = Math.max(t(axis.max), t(axis.min));
}
// data point to canvas coordinate
if (t === identity) {
// slight optimization
axis.p2c = function(p) {
if (isFinite(p - m)) {
return (p - m) * s;
} else {
return (p / 4 - m / 4) * s * 4;
}
};
} else {
axis.p2c = function(p) {
var tp = t(p);
if (isFinite(tp - m)) {
return (tp - m) * s;
} else {
return (tp / 4 - m / 4) * s * 4;
}
};
}
// canvas coordinate to data point
if (!it) {
axis.c2p = function(c) {
return m + c / s;
};
} else {
axis.c2p = function(c) {
return it(m + c / s);
};
}
}
function measureTickLabels(axis) {
var opts = axis.options,
ticks = opts.showTickLabels !== 'none' && axis.ticks ? axis.ticks : [],
showMajorTickLabels = opts.showTickLabels === 'major' || opts.showTickLabels === 'all',
showEndpointsTickLabels = opts.showTickLabels === 'endpoints' || opts.showTickLabels === 'all',
labelWidth = opts.labelWidth || 0,
labelHeight = opts.labelHeight || 0,
legacyStyles = axis.direction + "Axis " + axis.direction + axis.n + "Axis",
layer = "flot-" + axis.direction + "-axis flot-" + axis.direction + axis.n + "-axis " + legacyStyles,
font = opts.font || "flot-tick-label tickLabel";
for (var i = 0; i < ticks.length; ++i) {
var t = ticks[i];
var label = t.label;
if (!t.label ||
(showMajorTickLabels === false && i > 0 && i < ticks.length - 1) ||
(showEndpointsTickLabels === false && (i === 0 || i === ticks.length - 1))) {
continue;
}
if (typeof t.label === 'object') {
label = t.label.name;
}
var info = surface.getTextInfo(layer, label, font);
labelWidth = Math.max(labelWidth, info.width);
labelHeight = Math.max(labelHeight, info.height);
}
axis.labelWidth = opts.labelWidth || labelWidth;
axis.labelHeight = opts.labelHeight || labelHeight;
}
function allocateAxisBoxFirstPhase(axis) {
// find the bounding box of the axis by looking at label
// widths/heights and ticks, make room by diminishing the
// plotOffset; this first phase only looks at one
// dimension per axis, the other dimension depends on the
// other axes so will have to wait
// here reserve additional space
executeHooks(hooks.axisReserveSpace, [axis]);
var lw = axis.labelWidth,
lh = axis.labelHeight,
pos = axis.options.position,
isXAxis = axis.direction === "x",
tickLength = axis.options.tickLength,
showTicks = axis.options.showTicks,
showMinorTicks = axis.options.showMinorTicks,
gridLines = axis.options.gridLines,
axisMargin = options.grid.axisMargin,
padding = options.grid.labelMargin,
innermost = true,
outermost = true,
found = false;
// Determine the axis's position in its direction and on its side
$.each(isXAxis ? xaxes : yaxes, function(i, a) {
if (a && (a.show || a.reserveSpace)) {
if (a === axis) {
found = true;
} else if (a.options.position === pos) {
if (found) {
outermost = false;
} else {
innermost = false;
}
}
}
});
// The outermost axis on each side has no margin
if (outermost) {
axisMargin = 0;
}
// Set the default tickLength if necessary
if (tickLength == null) {
tickLength = TICK_LENGTH_CONSTANT;
}
// By default, major tick marks are visible
if (showTicks == null) {
showTicks = true;
}
// By default, minor tick marks are visible
if (showMinorTicks == null) {
showMinorTicks = true;
}
// By default, grid lines are visible
if (gridLines == null) {
if (innermost) {
gridLines = true;
} else {
gridLines = false;
}
}
if (!isNaN(+tickLength)) {
padding += showTicks ? +tickLength : 0;
}
if (isXAxis) {
lh += padding;
if (pos === "bottom") {
plotOffset.bottom += lh + axisMargin;
axis.box = {
top: surface.height - plotOffset.bottom,
height: lh
};
} else {
axis.box = {
top: plotOffset.top + axisMargin,
height: lh
};
plotOffset.top += lh + axisMargin;
}
} else {
lw += padding;
if (pos === "left") {
axis.box = {
left: plotOffset.left + axisMargin,
width: lw
};
plotOffset.left += lw + axisMargin;
} else {
plotOffset.right += lw + axisMargin;
axis.box = {
left: surface.width - plotOffset.right,
width: lw
};
}
}
// save for future reference
axis.position = pos;
axis.tickLength = tickLength;
axis.showMinorTicks = showMinorTicks;
axis.showTicks = showTicks;
axis.gridLines = gridLines;
axis.box.padding = padding;
axis.innermost = innermost;
}
function allocateAxisBoxSecondPhase(axis) {
// now that all axis boxes have been placed in one
// dimension, we can set the remaining dimension coordinates
if (axis.direction === "x") {
axis.box.left = plotOffset.left - axis.labelWidth / 2;
axis.box.width = surface.width - plotOffset.left - plotOffset.right + axis.labelWidth;
} else {
axis.box.top = plotOffset.top - axis.labelHeight / 2;
axis.box.height = surface.height - plotOffset.bottom - plotOffset.top + axis.labelHeight;
}
}
function adjustLayoutForThingsStickingOut() {
// possibly adjust plot offset to ensure everything stays
// inside the canvas and isn't clipped off
var minMargin = options.grid.minBorderMargin,
i;
// check stuff from the plot (FIXME: this should just read
// a value from the series, otherwise it's impossible to
// customize)
if (minMargin == null) {
minMargin = 0;
for (i = 0; i < series.length; ++i) {
minMargin = Math.max(minMargin, 2 * (series[i].points.radius + series[i].points.lineWidth / 2));
}
}
var a, offset = {},
margins = {
left: minMargin,
right: minMargin,
top: minMargin,
bottom: minMargin
};
// check axis labels, note we don't check the actual
// labels but instead use the overall width/height to not
// jump as much around with replots
$.each(allAxes(), function(_, axis) {
if (axis.reserveSpace && axis.ticks && axis.ticks.length) {
if (axis.direction === "x") {
margins.left = Math.max(margins.left, axis.labelWidth / 2);
margins.right = Math.max(margins.right, axis.labelWidth / 2);
} else {
margins.bottom = Math.max(margins.bottom, axis.labelHeight / 2);
margins.top = Math.max(margins.top, axis.labelHeight / 2);
}
}
});
for (a in margins) {
offset[a] = margins[a] - plotOffset[a];
}
$.each(xaxes.concat(yaxes), function(_, axis) {
alignAxisWithGrid(axis, offset, function (offset) {
return offset > 0;
});
});
plotOffset.left = Math.ceil(Math.max(margins.left, plotOffset.left));
plotOffset.right = Math.ceil(Math.max(margins.right, plotOffset.right));
plotOffset.top = Math.ceil(Math.max(margins.top, plotOffset.top));
plotOffset.bottom = Math.ceil(Math.max(margins.bottom, plotOffset.bottom));
}
function alignAxisWithGrid(axis, offset, isValid) {
if (axis.direction === "x") {
if (axis.position === "bottom" && isValid(offset.bottom)) {
axis.box.top -= Math.ceil(offset.bottom);
}
if (axis.position === "top" && isValid(offset.top)) {
axis.box.top += Math.ceil(offset.top);
}
} else {
if (axis.position === "left" && isValid(offset.left)) {
axis.box.left += Math.ceil(offset.left);
}
if (axis.position === "right" && isValid(offset.right)) {
axis.box.left -= Math.ceil(offset.right);
}
}
}
function setupGrid(autoScale) {
var i, a, axes = allAxes(),
showGrid = options.grid.show;
// Initialize the plot's offset from the edge of the canvas
for (a in plotOffset) {
plotOffset[a] = 0;
}
executeHooks(hooks.processOffset, [plotOffset]);
// If the grid is visible, add its border width to the offset
for (a in plotOffset) {
if (typeof (options.grid.borderWidth) === "o