Change intended to improve dygraphs rendering of y-values with tiny values (e.g.
[dygraphs.git] / dygraph.js
CommitLineData
6a1aa64f
DV
1// Copyright 2006 Dan Vanderkam (danvdk@gmail.com)
2// All Rights Reserved.
3
4/**
5 * @fileoverview Creates an interactive, zoomable graph based on a CSV file or
285a6bda
DV
6 * string. Dygraph can handle multiple series with or without error bars. The
7 * date/value ranges will be automatically set. Dygraph uses the
6a1aa64f
DV
8 * <canvas> tag, so it only works in FF1.5+.
9 * @author danvdk@gmail.com (Dan Vanderkam)
10
11 Usage:
12 <div id="graphdiv" style="width:800px; height:500px;"></div>
13 <script type="text/javascript">
285a6bda
DV
14 new Dygraph(document.getElementById("graphdiv"),
15 "datafile.csv", // CSV file with headers
16 { }); // options
6a1aa64f
DV
17 </script>
18
19 The CSV file is of the form
20
285a6bda 21 Date,SeriesA,SeriesB,SeriesC
6a1aa64f
DV
22 YYYYMMDD,A1,B1,C1
23 YYYYMMDD,A2,B2,C2
24
6a1aa64f
DV
25 If the 'errorBars' option is set in the constructor, the input should be of
26 the form
27
285a6bda 28 Date,SeriesA,SeriesB,...
6a1aa64f
DV
29 YYYYMMDD,A1,sigmaA1,B1,sigmaB1,...
30 YYYYMMDD,A2,sigmaA2,B2,sigmaB2,...
31
32 If the 'fractions' option is set, the input should be of the form:
33
285a6bda 34 Date,SeriesA,SeriesB,...
6a1aa64f
DV
35 YYYYMMDD,A1/B1,A2/B2,...
36 YYYYMMDD,A1/B1,A2/B2,...
37
38 And error bars will be calculated automatically using a binomial distribution.
39
727439b4 40 For further documentation and examples, see http://dygraphs.com/
6a1aa64f
DV
41
42 */
43
44/**
45 * An interactive, zoomable graph
46 * @param {String | Function} file A file containing CSV data or a function that
47 * returns this data. The expected format for each line is
48 * YYYYMMDD,val1,val2,... or, if attrs.errorBars is set,
49 * YYYYMMDD,val1,stddev1,val2,stddev2,...
6a1aa64f
DV
50 * @param {Object} attrs Various other attributes, e.g. errorBars determines
51 * whether the input data contains error ranges.
52 */
285a6bda
DV
53Dygraph = function(div, data, opts) {
54 if (arguments.length > 0) {
55 if (arguments.length == 4) {
56 // Old versions of dygraphs took in the series labels as a constructor
57 // parameter. This doesn't make sense anymore, but it's easy to continue
58 // to support this usage.
59 this.warn("Using deprecated four-argument dygraph constructor");
60 this.__old_init__(div, data, arguments[2], arguments[3]);
61 } else {
62 this.__init__(div, data, opts);
63 }
64 }
6a1aa64f
DV
65};
66
285a6bda
DV
67Dygraph.NAME = "Dygraph";
68Dygraph.VERSION = "1.2";
69Dygraph.__repr__ = function() {
6a1aa64f
DV
70 return "[" + this.NAME + " " + this.VERSION + "]";
71};
285a6bda 72Dygraph.toString = function() {
6a1aa64f
DV
73 return this.__repr__();
74};
75
76// Various default values
285a6bda
DV
77Dygraph.DEFAULT_ROLL_PERIOD = 1;
78Dygraph.DEFAULT_WIDTH = 480;
79Dygraph.DEFAULT_HEIGHT = 320;
80Dygraph.AXIS_LINE_WIDTH = 0.3;
6a1aa64f 81
8e4a6af3 82// Default attribute values.
285a6bda 83Dygraph.DEFAULT_ATTRS = {
a9fc39ab 84 highlightCircleSize: 3,
8e4a6af3 85 pixelsPerXLabel: 60,
c6336f04 86 pixelsPerYLabel: 30,
285a6bda 87
8e4a6af3
DV
88 labelsDivWidth: 250,
89 labelsDivStyles: {
90 // TODO(danvk): move defaults from createStatusMessage_ here.
285a6bda
DV
91 },
92 labelsSeparateLines: false,
bcd3ebf0 93 labelsShowZeroValues: true,
285a6bda 94 labelsKMB: false,
afefbcdb 95 labelsKMG2: false,
d160cc3b 96 showLabelsOnHighlight: true,
12e4c741 97
3c1d225b
JB
98 yValueFormatter: function(x, opt_numDigits) {
99 return x.toPrecision(opt_numDigits || 2);
100 },
285a6bda
DV
101
102 strokeWidth: 1.0,
8e4a6af3 103
8846615a
DV
104 axisTickSize: 3,
105 axisLabelFontSize: 14,
106 xAxisLabelWidth: 50,
107 yAxisLabelWidth: 50,
bf640e56 108 xAxisLabelFormatter: Dygraph.dateAxisFormatter,
8846615a 109 rightGap: 5,
285a6bda
DV
110
111 showRoller: false,
112 xValueFormatter: Dygraph.dateString_,
113 xValueParser: Dygraph.dateParser,
114 xTicker: Dygraph.dateTicker,
115
3d67f03b
DV
116 delimiter: ',',
117
ff00d3e2 118 logScale: false,
285a6bda
DV
119 sigma: 2.0,
120 errorBars: false,
121 fractions: false,
122 wilsonInterval: true, // only relevant if fractions is true
5954ef32 123 customBars: false,
43af96e7
NK
124 fillGraph: false,
125 fillAlpha: 0.15,
f032c51d 126 connectSeparatedPoints: false,
43af96e7
NK
127
128 stackedGraph: false,
afdc483f
NN
129 hideOverlayOnMouseOut: true,
130
00c281d4
NN
131 stepPlot: false,
132 avoidMinZero: false
285a6bda
DV
133};
134
135// Various logging levels.
136Dygraph.DEBUG = 1;
137Dygraph.INFO = 2;
138Dygraph.WARNING = 3;
139Dygraph.ERROR = 3;
140
39b0e098
RK
141// Directions for panning and zooming. Use bit operations when combined
142// values are possible.
143Dygraph.HORIZONTAL = 1;
144Dygraph.VERTICAL = 2;
145
5c528fa2
DV
146// Used for initializing annotation CSS rules only once.
147Dygraph.addedAnnotationCSS = false;
148
285a6bda
DV
149Dygraph.prototype.__old_init__ = function(div, file, labels, attrs) {
150 // Labels is no longer a constructor parameter, since it's typically set
151 // directly from the data source. It also conains a name for the x-axis,
152 // which the previous constructor form did not.
153 if (labels != null) {
154 var new_labels = ["Date"];
155 for (var i = 0; i < labels.length; i++) new_labels.push(labels[i]);
fc80a396 156 Dygraph.update(attrs, { 'labels': new_labels });
285a6bda
DV
157 }
158 this.__init__(div, file, attrs);
8e4a6af3
DV
159};
160
6a1aa64f 161/**
285a6bda 162 * Initializes the Dygraph. This creates a new DIV and constructs the PlotKit
6a1aa64f
DV
163 * and interaction &lt;canvas&gt; inside of it. See the constructor for details
164 * on the parameters.
12e4c741 165 * @param {Element} div the Element to render the graph into.
6a1aa64f 166 * @param {String | Function} file Source data
6a1aa64f
DV
167 * @param {Object} attrs Miscellaneous other options
168 * @private
169 */
285a6bda 170Dygraph.prototype.__init__ = function(div, file, attrs) {
a2c8fff4
DV
171 // Hack for IE: if we're using excanvas and the document hasn't finished
172 // loading yet (and hence may not have initialized whatever it needs to
173 // initialize), then keep calling this routine periodically until it has.
174 if (/MSIE/.test(navigator.userAgent) && !window.opera &&
175 typeof(G_vmlCanvasManager) != 'undefined' &&
176 document.readyState != 'complete') {
177 var self = this;
178 setTimeout(function() { self.__init__(div, file, attrs) }, 100);
179 }
180
285a6bda
DV
181 // Support two-argument constructor
182 if (attrs == null) { attrs = {}; }
183
6a1aa64f 184 // Copy the important bits into the object
32988383 185 // TODO(danvk): most of these should just stay in the attrs_ dictionary.
6a1aa64f 186 this.maindiv_ = div;
6a1aa64f 187 this.file_ = file;
285a6bda 188 this.rollPeriod_ = attrs.rollPeriod || Dygraph.DEFAULT_ROLL_PERIOD;
6a1aa64f 189 this.previousVerticalX_ = -1;
6a1aa64f 190 this.fractions_ = attrs.fractions || false;
6a1aa64f 191 this.dateWindow_ = attrs.dateWindow || null;
8b83c6cc 192
6a1aa64f 193 this.wilsonInterval_ = attrs.wilsonInterval || true;
fe0b7c03 194 this.is_initial_draw_ = true;
5c528fa2 195 this.annotations_ = [];
3c1d225b 196 this.numDigits_ = 2;
8e4a6af3 197
f7d6278e
DV
198 // Clear the div. This ensure that, if multiple dygraphs are passed the same
199 // div, then only one will be drawn.
200 div.innerHTML = "";
201
c21d2c2d 202 // If the div isn't already sized then inherit from our attrs or
203 // give it a default size.
285a6bda 204 if (div.style.width == '') {
ddd1b11f 205 div.style.width = (attrs.width || Dygraph.DEFAULT_WIDTH) + "px";
285a6bda
DV
206 }
207 if (div.style.height == '') {
ddd1b11f 208 div.style.height = (attrs.height || Dygraph.DEFAULT_HEIGHT) + "px";
32988383 209 }
285a6bda
DV
210 this.width_ = parseInt(div.style.width, 10);
211 this.height_ = parseInt(div.style.height, 10);
c21d2c2d 212 // The div might have been specified as percent of the current window size,
213 // convert that to an appropriate number of pixels.
214 if (div.style.width.indexOf("%") == div.style.width.length - 1) {
c6f45033 215 this.width_ = div.offsetWidth;
c21d2c2d 216 }
217 if (div.style.height.indexOf("%") == div.style.height.length - 1) {
c6f45033 218 this.height_ = div.offsetHeight;
c21d2c2d 219 }
32988383 220
10a6456d
DV
221 if (this.width_ == 0) {
222 this.error("dygraph has zero width. Please specify a width in pixels.");
223 }
224 if (this.height_ == 0) {
225 this.error("dygraph has zero height. Please specify a height in pixels.");
226 }
227
344ba8c0 228 // TODO(danvk): set fillGraph to be part of attrs_ here, not user_attrs_.
43af96e7
NK
229 if (attrs['stackedGraph']) {
230 attrs['fillGraph'] = true;
231 // TODO(nikhilk): Add any other stackedGraph checks here.
232 }
233
285a6bda
DV
234 // Dygraphs has many options, some of which interact with one another.
235 // To keep track of everything, we maintain two sets of options:
236 //
c21d2c2d 237 // this.user_attrs_ only options explicitly set by the user.
285a6bda
DV
238 // this.attrs_ defaults, options derived from user_attrs_, data.
239 //
240 // Options are then accessed this.attr_('attr'), which first looks at
241 // user_attrs_ and then computed attrs_. This way Dygraphs can set intelligent
242 // defaults without overriding behavior that the user specifically asks for.
243 this.user_attrs_ = {};
fc80a396 244 Dygraph.update(this.user_attrs_, attrs);
6a1aa64f 245
285a6bda 246 this.attrs_ = {};
fc80a396 247 Dygraph.update(this.attrs_, Dygraph.DEFAULT_ATTRS);
6a1aa64f 248
16269f6e 249 this.boundaryIds_ = [];
6a1aa64f 250
285a6bda
DV
251 // Make a note of whether labels will be pulled from the CSV file.
252 this.labelsFromCSV_ = (this.attr_("labels") == null);
6a1aa64f
DV
253
254 // Create the containing DIV and other interactive elements
255 this.createInterface_();
256
738fc797 257 this.start_();
6a1aa64f
DV
258};
259
227b93cc
DV
260Dygraph.prototype.attr_ = function(name, seriesName) {
261 if (seriesName &&
262 typeof(this.user_attrs_[seriesName]) != 'undefined' &&
263 this.user_attrs_[seriesName] != null &&
264 typeof(this.user_attrs_[seriesName][name]) != 'undefined') {
265 return this.user_attrs_[seriesName][name];
450fe64b 266 } else if (typeof(this.user_attrs_[name]) != 'undefined') {
285a6bda
DV
267 return this.user_attrs_[name];
268 } else if (typeof(this.attrs_[name]) != 'undefined') {
269 return this.attrs_[name];
270 } else {
271 return null;
272 }
273};
274
275// TODO(danvk): any way I can get the line numbers to be this.warn call?
276Dygraph.prototype.log = function(severity, message) {
277 if (typeof(console) != 'undefined') {
278 switch (severity) {
279 case Dygraph.DEBUG:
280 console.debug('dygraphs: ' + message);
281 break;
282 case Dygraph.INFO:
283 console.info('dygraphs: ' + message);
284 break;
285 case Dygraph.WARNING:
286 console.warn('dygraphs: ' + message);
287 break;
288 case Dygraph.ERROR:
289 console.error('dygraphs: ' + message);
290 break;
291 }
292 }
293}
294Dygraph.prototype.info = function(message) {
295 this.log(Dygraph.INFO, message);
296}
297Dygraph.prototype.warn = function(message) {
298 this.log(Dygraph.WARNING, message);
299}
300Dygraph.prototype.error = function(message) {
301 this.log(Dygraph.ERROR, message);
302}
303
6a1aa64f
DV
304/**
305 * Returns the current rolling period, as set by the user or an option.
3c1d225b 306 * @return {Number} The number of points in the rolling window
6a1aa64f 307 */
285a6bda 308Dygraph.prototype.rollPeriod = function() {
6a1aa64f 309 return this.rollPeriod_;
76171648
DV
310};
311
599fb4ad
DV
312/**
313 * Returns the currently-visible x-range. This can be affected by zooming,
314 * panning or a call to updateOptions.
315 * Returns a two-element array: [left, right].
316 * If the Dygraph has dates on the x-axis, these will be millis since epoch.
317 */
318Dygraph.prototype.xAxisRange = function() {
319 if (this.dateWindow_) return this.dateWindow_;
320
321 // The entire chart is visible.
322 var left = this.rawData_[0][0];
323 var right = this.rawData_[this.rawData_.length - 1][0];
324 return [left, right];
325};
326
3230c662 327/**
d58ae307
DV
328 * Returns the currently-visible y-range for an axis. This can be affected by
329 * zooming, panning or a call to updateOptions. Axis indices are zero-based. If
330 * called with no arguments, returns the range of the first axis.
3230c662
DV
331 * Returns a two-element array: [bottom, top].
332 */
d58ae307 333Dygraph.prototype.yAxisRange = function(idx) {
d63e6799 334 if (typeof(idx) == "undefined") idx = 0;
d58ae307
DV
335 if (idx < 0 || idx >= this.axes_.length) return null;
336 return [ this.axes_[idx].computedValueRange[0],
337 this.axes_[idx].computedValueRange[1] ];
338};
339
340/**
341 * Returns the currently-visible y-ranges for each axis. This can be affected by
342 * zooming, panning, calls to updateOptions, etc.
343 * Returns an array of [bottom, top] pairs, one for each y-axis.
344 */
345Dygraph.prototype.yAxisRanges = function() {
346 var ret = [];
347 for (var i = 0; i < this.axes_.length; i++) {
348 ret.push(this.yAxisRange(i));
349 }
350 return ret;
3230c662
DV
351};
352
d58ae307 353// TODO(danvk): use these functions throughout dygraphs.
3230c662
DV
354/**
355 * Convert from data coordinates to canvas/div X/Y coordinates.
d58ae307
DV
356 * If specified, do this conversion for the coordinate system of a particular
357 * axis. Uses the first axis by default.
3230c662
DV
358 * Returns a two-element array: [X, Y]
359 */
d58ae307 360Dygraph.prototype.toDomCoords = function(x, y, axis) {
3230c662
DV
361 var ret = [null, null];
362 var area = this.plotter_.area;
363 if (x !== null) {
364 var xRange = this.xAxisRange();
365 ret[0] = area.x + (x - xRange[0]) / (xRange[1] - xRange[0]) * area.w;
366 }
367
368 if (y !== null) {
d58ae307 369 var yRange = this.yAxisRange(axis);
891ad846 370 ret[1] = area.y + (yRange[1] - y) / (yRange[1] - yRange[0]) * area.h;
3230c662
DV
371 }
372
373 return ret;
374};
375
376/**
377 * Convert from canvas/div coords to data coordinates.
d58ae307
DV
378 * If specified, do this conversion for the coordinate system of a particular
379 * axis. Uses the first axis by default.
3230c662
DV
380 * Returns a two-element array: [X, Y]
381 */
d58ae307 382Dygraph.prototype.toDataCoords = function(x, y, axis) {
3230c662
DV
383 var ret = [null, null];
384 var area = this.plotter_.area;
385 if (x !== null) {
386 var xRange = this.xAxisRange();
387 ret[0] = xRange[0] + (x - area.x) / area.w * (xRange[1] - xRange[0]);
388 }
389
390 if (y !== null) {
d58ae307 391 var yRange = this.yAxisRange(axis);
3230c662
DV
392 ret[1] = yRange[0] + (area.h - y) / area.h * (yRange[1] - yRange[0]);
393 }
394
395 return ret;
396};
397
e99fde05
DV
398/**
399 * Returns the number of columns (including the independent variable).
400 */
401Dygraph.prototype.numColumns = function() {
402 return this.rawData_[0].length;
403};
404
405/**
406 * Returns the number of rows (excluding any header/label row).
407 */
408Dygraph.prototype.numRows = function() {
409 return this.rawData_.length;
410};
411
412/**
413 * Returns the value in the given row and column. If the row and column exceed
414 * the bounds on the data, returns null. Also returns null if the value is
415 * missing.
416 */
417Dygraph.prototype.getValue = function(row, col) {
418 if (row < 0 || row > this.rawData_.length) return null;
419 if (col < 0 || col > this.rawData_[row].length) return null;
420
421 return this.rawData_[row][col];
422};
423
76171648
DV
424Dygraph.addEvent = function(el, evt, fn) {
425 var normed_fn = function(e) {
426 if (!e) var e = window.event;
427 fn(e);
428 };
429 if (window.addEventListener) { // Mozilla, Netscape, Firefox
430 el.addEventListener(evt, normed_fn, false);
431 } else { // IE
432 el.attachEvent('on' + evt, normed_fn);
433 }
434};
6a1aa64f
DV
435
436/**
285a6bda 437 * Generates interface elements for the Dygraph: a containing div, a div to
6a1aa64f 438 * display the current point, and a textbox to adjust the rolling average
697e70b2 439 * period. Also creates the Renderer/Layout elements.
6a1aa64f
DV
440 * @private
441 */
285a6bda 442Dygraph.prototype.createInterface_ = function() {
6a1aa64f
DV
443 // Create the all-enclosing graph div
444 var enclosing = this.maindiv_;
445
b0c3b730
DV
446 this.graphDiv = document.createElement("div");
447 this.graphDiv.style.width = this.width_ + "px";
448 this.graphDiv.style.height = this.height_ + "px";
449 enclosing.appendChild(this.graphDiv);
450
451 // Create the canvas for interactive parts of the chart.
f8cfec73 452 this.canvas_ = Dygraph.createCanvas();
b0c3b730
DV
453 this.canvas_.style.position = "absolute";
454 this.canvas_.width = this.width_;
455 this.canvas_.height = this.height_;
f8cfec73
DV
456 this.canvas_.style.width = this.width_ + "px"; // for IE
457 this.canvas_.style.height = this.height_ + "px"; // for IE
b0c3b730
DV
458
459 // ... and for static parts of the chart.
6a1aa64f 460 this.hidden_ = this.createPlotKitCanvas_(this.canvas_);
76171648 461
eb7bf005
EC
462 // The interactive parts of the graph are drawn on top of the chart.
463 this.graphDiv.appendChild(this.hidden_);
464 this.graphDiv.appendChild(this.canvas_);
465 this.mouseEventElement_ = this.canvas_;
466
76171648 467 var dygraph = this;
eb7bf005 468 Dygraph.addEvent(this.mouseEventElement_, 'mousemove', function(e) {
76171648
DV
469 dygraph.mouseMove_(e);
470 });
eb7bf005 471 Dygraph.addEvent(this.mouseEventElement_, 'mouseout', function(e) {
76171648
DV
472 dygraph.mouseOut_(e);
473 });
697e70b2
DV
474
475 // Create the grapher
476 // TODO(danvk): why does the Layout need its own set of options?
477 this.layoutOptions_ = { 'xOriginIsZero': false };
478 Dygraph.update(this.layoutOptions_, this.attrs_);
479 Dygraph.update(this.layoutOptions_, this.user_attrs_);
480 Dygraph.update(this.layoutOptions_, {
481 'errorBars': (this.attr_("errorBars") || this.attr_("customBars")) });
482
483 this.layout_ = new DygraphLayout(this, this.layoutOptions_);
484
485 // TODO(danvk): why does the Renderer need its own set of options?
486 this.renderOptions_ = { colorScheme: this.colors_,
487 strokeColor: null,
488 axisLineWidth: Dygraph.AXIS_LINE_WIDTH };
489 Dygraph.update(this.renderOptions_, this.attrs_);
490 Dygraph.update(this.renderOptions_, this.user_attrs_);
697e70b2
DV
491
492 this.createStatusMessage_();
697e70b2 493 this.createDragInterface_();
4cfcc38c
DV
494};
495
496/**
497 * Detach DOM elements in the dygraph and null out all data references.
498 * Calling this when you're done with a dygraph can dramatically reduce memory
499 * usage. See, e.g., the tests/perf.html example.
500 */
501Dygraph.prototype.destroy = function() {
502 var removeRecursive = function(node) {
503 while (node.hasChildNodes()) {
504 removeRecursive(node.firstChild);
505 node.removeChild(node.firstChild);
506 }
507 };
508 removeRecursive(this.maindiv_);
509
510 var nullOut = function(obj) {
511 for (var n in obj) {
512 if (typeof(obj[n]) === 'object') {
513 obj[n] = null;
514 }
515 }
516 };
517
518 // These may not all be necessary, but it can't hurt...
519 nullOut(this.layout_);
520 nullOut(this.plotter_);
521 nullOut(this);
522};
6a1aa64f
DV
523
524/**
525 * Creates the canvas containing the PlotKit graph. Only plotkit ever draws on
285a6bda 526 * this particular canvas. All Dygraph work is done on this.canvas_.
8846615a 527 * @param {Object} canvas The Dygraph canvas over which to overlay the plot
6a1aa64f
DV
528 * @return {Object} The newly-created canvas
529 * @private
530 */
285a6bda 531Dygraph.prototype.createPlotKitCanvas_ = function(canvas) {
f8cfec73 532 var h = Dygraph.createCanvas();
6a1aa64f 533 h.style.position = "absolute";
9ac5e4ae
DV
534 // TODO(danvk): h should be offset from canvas. canvas needs to include
535 // some extra area to make it easier to zoom in on the far left and far
536 // right. h needs to be precisely the plot area, so that clipping occurs.
6a1aa64f
DV
537 h.style.top = canvas.style.top;
538 h.style.left = canvas.style.left;
539 h.width = this.width_;
540 h.height = this.height_;
f8cfec73
DV
541 h.style.width = this.width_ + "px"; // for IE
542 h.style.height = this.height_ + "px"; // for IE
6a1aa64f
DV
543 return h;
544};
545
f474c2a3
DV
546// Taken from MochiKit.Color
547Dygraph.hsvToRGB = function (hue, saturation, value) {
548 var red;
549 var green;
550 var blue;
551 if (saturation === 0) {
552 red = value;
553 green = value;
554 blue = value;
555 } else {
556 var i = Math.floor(hue * 6);
557 var f = (hue * 6) - i;
558 var p = value * (1 - saturation);
559 var q = value * (1 - (saturation * f));
560 var t = value * (1 - (saturation * (1 - f)));
561 switch (i) {
562 case 1: red = q; green = value; blue = p; break;
563 case 2: red = p; green = value; blue = t; break;
564 case 3: red = p; green = q; blue = value; break;
565 case 4: red = t; green = p; blue = value; break;
566 case 5: red = value; green = p; blue = q; break;
567 case 6: // fall through
568 case 0: red = value; green = t; blue = p; break;
569 }
570 }
571 red = Math.floor(255 * red + 0.5);
572 green = Math.floor(255 * green + 0.5);
573 blue = Math.floor(255 * blue + 0.5);
574 return 'rgb(' + red + ',' + green + ',' + blue + ')';
575};
576
577
6a1aa64f
DV
578/**
579 * Generate a set of distinct colors for the data series. This is done with a
580 * color wheel. Saturation/Value are customizable, and the hue is
581 * equally-spaced around the color wheel. If a custom set of colors is
582 * specified, that is used instead.
6a1aa64f
DV
583 * @private
584 */
285a6bda
DV
585Dygraph.prototype.setColors_ = function() {
586 // TODO(danvk): compute this directly into this.attrs_['colorScheme'] and do
587 // away with this.renderOptions_.
588 var num = this.attr_("labels").length - 1;
6a1aa64f 589 this.colors_ = [];
285a6bda
DV
590 var colors = this.attr_('colors');
591 if (!colors) {
592 var sat = this.attr_('colorSaturation') || 1.0;
593 var val = this.attr_('colorValue') || 0.5;
2aa21213 594 var half = Math.ceil(num / 2);
6a1aa64f 595 for (var i = 1; i <= num; i++) {
ec1959eb 596 if (!this.visibility()[i-1]) continue;
43af96e7 597 // alternate colors for high contrast.
2aa21213 598 var idx = i % 2 ? Math.ceil(i / 2) : (half + i / 2);
43af96e7
NK
599 var hue = (1.0 * idx/ (1 + num));
600 this.colors_.push(Dygraph.hsvToRGB(hue, sat, val));
6a1aa64f
DV
601 }
602 } else {
603 for (var i = 0; i < num; i++) {
ec1959eb 604 if (!this.visibility()[i]) continue;
285a6bda 605 var colorStr = colors[i % colors.length];
f474c2a3 606 this.colors_.push(colorStr);
6a1aa64f
DV
607 }
608 }
285a6bda 609
c21d2c2d 610 // TODO(danvk): update this w/r/t/ the new options system.
285a6bda 611 this.renderOptions_.colorScheme = this.colors_;
fc80a396
DV
612 Dygraph.update(this.plotter_.options, this.renderOptions_);
613 Dygraph.update(this.layoutOptions_, this.user_attrs_);
614 Dygraph.update(this.layoutOptions_, this.attrs_);
6a1aa64f
DV
615}
616
43af96e7
NK
617/**
618 * Return the list of colors. This is either the list of colors passed in the
619 * attributes, or the autogenerated list of rgb(r,g,b) strings.
620 * @return {Array<string>} The list of colors.
621 */
622Dygraph.prototype.getColors = function() {
623 return this.colors_;
624};
625
5e60386d
DV
626// The following functions are from quirksmode.org with a modification for Safari from
627// http://blog.firetree.net/2005/07/04/javascript-find-position/
3df0ccf0
DV
628// http://www.quirksmode.org/js/findpos.html
629Dygraph.findPosX = function(obj) {
630 var curleft = 0;
5e60386d 631 if(obj.offsetParent)
50360fd0 632 while(1)
5e60386d 633 {
3df0ccf0 634 curleft += obj.offsetLeft;
5e60386d
DV
635 if(!obj.offsetParent)
636 break;
3df0ccf0
DV
637 obj = obj.offsetParent;
638 }
5e60386d 639 else if(obj.x)
3df0ccf0
DV
640 curleft += obj.x;
641 return curleft;
642};
c21d2c2d 643
3df0ccf0
DV
644Dygraph.findPosY = function(obj) {
645 var curtop = 0;
5e60386d
DV
646 if(obj.offsetParent)
647 while(1)
648 {
3df0ccf0 649 curtop += obj.offsetTop;
5e60386d
DV
650 if(!obj.offsetParent)
651 break;
3df0ccf0
DV
652 obj = obj.offsetParent;
653 }
5e60386d 654 else if(obj.y)
3df0ccf0
DV
655 curtop += obj.y;
656 return curtop;
657};
658
5e60386d 659
71a11a8e 660
6a1aa64f
DV
661/**
662 * Create the div that contains information on the selected point(s)
663 * This goes in the top right of the canvas, unless an external div has already
664 * been specified.
665 * @private
666 */
fedbd797 667Dygraph.prototype.createStatusMessage_ = function() {
668 var userLabelsDiv = this.user_attrs_["labelsDiv"];
669 if (userLabelsDiv && null != userLabelsDiv
670 && (typeof(userLabelsDiv) == "string" || userLabelsDiv instanceof String)) {
671 this.user_attrs_["labelsDiv"] = document.getElementById(userLabelsDiv);
672 }
285a6bda
DV
673 if (!this.attr_("labelsDiv")) {
674 var divWidth = this.attr_('labelsDivWidth');
b0c3b730 675 var messagestyle = {
6a1aa64f
DV
676 "position": "absolute",
677 "fontSize": "14px",
678 "zIndex": 10,
679 "width": divWidth + "px",
680 "top": "0px",
8846615a 681 "left": (this.width_ - divWidth - 2) + "px",
6a1aa64f
DV
682 "background": "white",
683 "textAlign": "left",
b0c3b730 684 "overflow": "hidden"};
fc80a396 685 Dygraph.update(messagestyle, this.attr_('labelsDivStyles'));
b0c3b730
DV
686 var div = document.createElement("div");
687 for (var name in messagestyle) {
85b99f0b
DV
688 if (messagestyle.hasOwnProperty(name)) {
689 div.style[name] = messagestyle[name];
690 }
b0c3b730
DV
691 }
692 this.graphDiv.appendChild(div);
285a6bda 693 this.attrs_.labelsDiv = div;
6a1aa64f
DV
694 }
695};
696
697/**
0abfbd7e
DV
698 * Position the labels div so that its right edge is flush with the right edge
699 * of the charting area.
700 */
701Dygraph.prototype.positionLabelsDiv_ = function() {
702 // Don't touch a user-specified labelsDiv.
703 if (this.user_attrs_.hasOwnProperty("labelsDiv")) return;
704
705 var area = this.plotter_.area;
706 var div = this.attr_("labelsDiv");
8c21adcf 707 div.style.left = area.x + area.w - this.attr_("labelsDivWidth") - 1 + "px";
0abfbd7e
DV
708};
709
710/**
6a1aa64f 711 * Create the text box to adjust the averaging period
6a1aa64f
DV
712 * @private
713 */
285a6bda 714Dygraph.prototype.createRollInterface_ = function() {
8c69de65
DV
715 // Create a roller if one doesn't exist already.
716 if (!this.roller_) {
717 this.roller_ = document.createElement("input");
718 this.roller_.type = "text";
719 this.roller_.style.display = "none";
720 this.graphDiv.appendChild(this.roller_);
721 }
722
723 var display = this.attr_('showRoller') ? 'block' : 'none';
26ca7938 724
b0c3b730
DV
725 var textAttr = { "position": "absolute",
726 "zIndex": 10,
727 "top": (this.plotter_.area.h - 25) + "px",
728 "left": (this.plotter_.area.x + 1) + "px",
729 "display": display
6a1aa64f 730 };
8c69de65
DV
731 this.roller_.size = "2";
732 this.roller_.value = this.rollPeriod_;
b0c3b730 733 for (var name in textAttr) {
85b99f0b 734 if (textAttr.hasOwnProperty(name)) {
8c69de65 735 this.roller_.style[name] = textAttr[name];
85b99f0b 736 }
b0c3b730
DV
737 }
738
76171648 739 var dygraph = this;
8c69de65 740 this.roller_.onchange = function() { dygraph.adjustRoll(dygraph.roller_.value); };
76171648
DV
741};
742
743// These functions are taken from MochiKit.Signal
744Dygraph.pageX = function(e) {
745 if (e.pageX) {
746 return (!e.pageX || e.pageX < 0) ? 0 : e.pageX;
747 } else {
748 var de = document;
749 var b = document.body;
750 return e.clientX +
751 (de.scrollLeft || b.scrollLeft) -
752 (de.clientLeft || 0);
753 }
754};
755
756Dygraph.pageY = function(e) {
757 if (e.pageY) {
758 return (!e.pageY || e.pageY < 0) ? 0 : e.pageY;
759 } else {
760 var de = document;
761 var b = document.body;
762 return e.clientY +
763 (de.scrollTop || b.scrollTop) -
764 (de.clientTop || 0);
765 }
766};
6a1aa64f
DV
767
768/**
769 * Set up all the mouse handlers needed to capture dragging behavior for zoom
27385109 770 * events.
6a1aa64f
DV
771 * @private
772 */
285a6bda 773Dygraph.prototype.createDragInterface_ = function() {
6a1aa64f
DV
774 var self = this;
775
776 // Tracks whether the mouse is down right now
bce01b0f 777 var isZooming = false;
d58ae307
DV
778 var isPanning = false; // is this drag part of a pan?
779 var is2DPan = false; // if so, is that pan 1- or 2-dimensional?
6a1aa64f
DV
780 var dragStartX = null;
781 var dragStartY = null;
782 var dragEndX = null;
783 var dragEndY = null;
eeab5025 784 var dragDirection = null;
6a1aa64f 785 var prevEndX = null;
8b83c6cc
RK
786 var prevEndY = null;
787 var prevDragDirection = null;
e3489f4f 788
d58ae307 789 // TODO(danvk): update this comment
e3489f4f
RK
790 // draggingDate and draggingValue represent the [date,value] point on the
791 // graph at which the mouse was pressed. As the mouse moves while panning,
792 // the viewport must pan so that the mouse position points to
793 // [draggingDate, draggingValue]
bce01b0f 794 var draggingDate = null;
e3489f4f 795
d58ae307 796 // TODO(danvk): update this comment
e3489f4f
RK
797 // The range in second/value units that the viewport encompasses during a
798 // panning operation.
bce01b0f 799 var dateRange = null;
6a1aa64f
DV
800
801 // Utility function to convert page-wide coordinates to canvas coords
67e650dc
DV
802 var px = 0;
803 var py = 0;
76171648 804 var getX = function(e) { return Dygraph.pageX(e) - px };
1e1bf7df 805 var getY = function(e) { return Dygraph.pageY(e) - py };
6a1aa64f
DV
806
807 // Draw zoom rectangles when the mouse is down and the user moves around
eb7bf005 808 Dygraph.addEvent(this.mouseEventElement_, 'mousemove', function(event) {
bce01b0f 809 if (isZooming) {
6a1aa64f
DV
810 dragEndX = getX(event);
811 dragEndY = getY(event);
812
8b83c6cc
RK
813 var xDelta = Math.abs(dragStartX - dragEndX);
814 var yDelta = Math.abs(dragStartY - dragEndY);
8b211dd6
RK
815
816 // drag direction threshold for y axis is twice as large as x axis
eeab5025 817 dragDirection = (xDelta < yDelta / 2) ? Dygraph.VERTICAL : Dygraph.HORIZONTAL;
8b83c6cc
RK
818
819 self.drawZoomRect_(dragDirection, dragStartX, dragEndX, dragStartY, dragEndY,
820 prevDragDirection, prevEndX, prevEndY);
821
6a1aa64f 822 prevEndX = dragEndX;
8b83c6cc
RK
823 prevEndY = dragEndY;
824 prevDragDirection = dragDirection;
bce01b0f
DV
825 } else if (isPanning) {
826 dragEndX = getX(event);
827 dragEndY = getY(event);
828
d58ae307 829 // TODO(danvk): update this comment
bce01b0f 830 // Want to have it so that:
e3489f4f 831 // 1. draggingDate appears at dragEndX, draggingValue appears at dragEndY.
bce01b0f 832 // 2. daterange = (dateWindow_[1] - dateWindow_[0]) is unaltered.
e3489f4f
RK
833 // 3. draggingValue appears at dragEndY.
834 // 4. valueRange is unaltered.
835
836 var minDate = draggingDate - (dragEndX / self.width_) * dateRange;
837 var maxDate = minDate + dateRange;
838 self.dateWindow_ = [minDate, maxDate];
bce01b0f 839
ef0b205b 840
d58ae307
DV
841 // y-axis scaling is automatic unless this is a full 2D pan.
842 if (is2DPan) {
843 // Adjust each axis appropriately.
844 var y_frac = dragEndY / self.height_;
845 for (var i = 0; i < self.axes_.length; i++) {
846 var axis = self.axes_[i];
847 var maxValue = axis.draggingValue + y_frac * axis.dragValueRange;
848 var minValue = maxValue - axis.dragValueRange;
849 axis.valueWindow = [ minValue, maxValue ];
850 }
74f09e22 851 }
bce01b0f 852
26ca7938 853 self.drawGraph_();
6a1aa64f
DV
854 }
855 });
856
857 // Track the beginning of drag events
eb7bf005 858 Dygraph.addEvent(this.mouseEventElement_, 'mousedown', function(event) {
79b3ee42
DV
859 // prevents mouse drags from selecting page text.
860 if (event.preventDefault) {
861 event.preventDefault(); // Firefox, Chrome, etc.
862 } else {
863 event.returnValue = false; // IE
864 event.cancelBubble = true;
865 }
866
3df0ccf0
DV
867 px = Dygraph.findPosX(self.canvas_);
868 py = Dygraph.findPosY(self.canvas_);
6a1aa64f
DV
869 dragStartX = getX(event);
870 dragStartY = getY(event);
bce01b0f 871
2dab69c3 872 if (event.altKey || event.shiftKey) {
e3489f4f 873 // have to be zoomed in to pan.
d58ae307
DV
874 var zoomedY = false;
875 for (var i = 0; i < self.axes_.length; i++) {
876 if (self.axes_[i].valueWindow || self.axes_[i].valueRange) {
877 zoomedY = true;
878 break;
879 }
880 }
881 if (!self.dateWindow_ && !zoomedY) return;
e3489f4f 882
bce01b0f 883 isPanning = true;
e3489f4f
RK
884 var xRange = self.xAxisRange();
885 dateRange = xRange[1] - xRange[0];
d58ae307
DV
886
887 // Record the range of each y-axis at the start of the drag.
888 // If any axis has a valueRange or valueWindow, then we want a 2D pan.
889 is2DPan = false;
890 for (var i = 0; i < self.axes_.length; i++) {
891 var axis = self.axes_[i];
892 var yRange = self.yAxisRange(i);
893 axis.dragValueRange = yRange[1] - yRange[0];
894 var r = self.toDataCoords(null, dragStartY, i);
895 axis.draggingValue = r[1];
896 if (axis.valueWindow || axis.valueRange) is2DPan = true;
897 }
e3489f4f
RK
898
899 // TODO(konigsberg): Switch from all this math to toDataCoords?
900 // Seems to work for the dragging value.
d58ae307 901 draggingDate = (dragStartX / self.width_) * dateRange + xRange[0];
bce01b0f
DV
902 } else {
903 isZooming = true;
904 }
6a1aa64f
DV
905 });
906
907 // If the user releases the mouse button during a drag, but not over the
908 // canvas, then it doesn't count as a zooming action.
76171648 909 Dygraph.addEvent(document, 'mouseup', function(event) {
bce01b0f
DV
910 if (isZooming || isPanning) {
911 isZooming = false;
6a1aa64f
DV
912 dragStartX = null;
913 dragStartY = null;
914 }
bce01b0f
DV
915
916 if (isPanning) {
917 isPanning = false;
918 draggingDate = null;
919 dateRange = null;
d58ae307 920 for (var i = 0; i < self.axes_.length; i++) {
d63e6799
DV
921 delete self.axes_[i].draggingValue;
922 delete self.axes_[i].dragValueRange;
d58ae307 923 }
bce01b0f 924 }
6a1aa64f
DV
925 });
926
927 // Temporarily cancel the dragging event when the mouse leaves the graph
eb7bf005 928 Dygraph.addEvent(this.mouseEventElement_, 'mouseout', function(event) {
bce01b0f 929 if (isZooming) {
6a1aa64f
DV
930 dragEndX = null;
931 dragEndY = null;
932 }
933 });
934
935 // If the mouse is released on the canvas during a drag event, then it's a
936 // zoom. Only do the zoom if it's over a large enough area (>= 10 pixels)
eb7bf005 937 Dygraph.addEvent(this.mouseEventElement_, 'mouseup', function(event) {
bce01b0f
DV
938 if (isZooming) {
939 isZooming = false;
6a1aa64f
DV
940 dragEndX = getX(event);
941 dragEndY = getY(event);
942 var regionWidth = Math.abs(dragEndX - dragStartX);
943 var regionHeight = Math.abs(dragEndY - dragStartY);
944
e2b5f2bc
DV
945 if (regionWidth < 2 && regionHeight < 2 &&
946 self.lastx_ != undefined && self.lastx_ != -1) {
2ad87eaa 947 // TODO(danvk): pass along more info about the points, e.g. 'x'
1e1bf7df 948 if (self.attr_('clickCallback') != null) {
1e1bf7df
DV
949 self.attr_('clickCallback')(event, self.lastx_, self.selPoints_);
950 }
951 if (self.attr_('pointClickCallback')) {
952 // check if the click was on a particular point.
953 var closestIdx = -1;
954 var closestDistance = 0;
955 for (var i = 0; i < self.selPoints_.length; i++) {
956 var p = self.selPoints_[i];
957 var distance = Math.pow(p.canvasx - dragEndX, 2) +
958 Math.pow(p.canvasy - dragEndY, 2);
959 if (closestIdx == -1 || distance < closestDistance) {
960 closestDistance = distance;
961 closestIdx = i;
962 }
963 }
964
965 // Allow any click within two pixels of the dot.
2ad87eaa 966 var radius = self.attr_('highlightCircleSize') + 2;
1e1bf7df
DV
967 if (closestDistance <= 5 * 5) {
968 self.attr_('pointClickCallback')(event, self.selPoints_[closestIdx]);
969 }
970 }
6a1aa64f
DV
971 }
972
eeab5025 973 if (regionWidth >= 10 && dragDirection == Dygraph.HORIZONTAL) {
8b83c6cc 974 self.doZoomX_(Math.min(dragStartX, dragEndX),
6a1aa64f 975 Math.max(dragStartX, dragEndX));
eeab5025 976 } else if (regionHeight >= 10 && dragDirection == Dygraph.VERTICAL){
8b83c6cc
RK
977 self.doZoomY_(Math.min(dragStartY, dragEndY),
978 Math.max(dragStartY, dragEndY));
6a1aa64f
DV
979 } else {
980 self.canvas_.getContext("2d").clearRect(0, 0,
981 self.canvas_.width,
982 self.canvas_.height);
983 }
984
985 dragStartX = null;
986 dragStartY = null;
987 }
bce01b0f
DV
988
989 if (isPanning) {
990 isPanning = false;
d58ae307 991 is2DPan = false;
bce01b0f
DV
992 draggingDate = null;
993 dateRange = null;
e3489f4f 994 valueRange = null;
bce01b0f 995 }
6a1aa64f
DV
996 });
997
998 // Double-clicking zooms back out
eb7bf005 999 Dygraph.addEvent(this.mouseEventElement_, 'dblclick', function(event) {
8b83c6cc
RK
1000 // Disable zooming out if panning.
1001 if (event.altKey || event.shiftKey) return;
1002
1003 self.doUnzoom_();
6a1aa64f
DV
1004 });
1005};
1006
1007/**
1008 * Draw a gray zoom rectangle over the desired area of the canvas. Also clears
1009 * up any previous zoom rectangles that were drawn. This could be optimized to
1010 * avoid extra redrawing, but it's tricky to avoid interactions with the status
1011 * dots.
8b83c6cc 1012 *
39b0e098
RK
1013 * @param {Number} direction the direction of the zoom rectangle. Acceptable
1014 * values are Dygraph.HORIZONTAL and Dygraph.VERTICAL.
6a1aa64f
DV
1015 * @param {Number} startX The X position where the drag started, in canvas
1016 * coordinates.
1017 * @param {Number} endX The current X position of the drag, in canvas coords.
8b83c6cc
RK
1018 * @param {Number} startY The Y position where the drag started, in canvas
1019 * coordinates.
1020 * @param {Number} endY The current Y position of the drag, in canvas coords.
39b0e098 1021 * @param {Number} prevDirection the value of direction on the previous call to
8b83c6cc 1022 * this function. Used to avoid excess redrawing
6a1aa64f
DV
1023 * @param {Number} prevEndX The value of endX on the previous call to this
1024 * function. Used to avoid excess redrawing
8b83c6cc
RK
1025 * @param {Number} prevEndY The value of endY on the previous call to this
1026 * function. Used to avoid excess redrawing
6a1aa64f
DV
1027 * @private
1028 */
8b83c6cc
RK
1029Dygraph.prototype.drawZoomRect_ = function(direction, startX, endX, startY, endY,
1030 prevDirection, prevEndX, prevEndY) {
6a1aa64f
DV
1031 var ctx = this.canvas_.getContext("2d");
1032
1033 // Clean up from the previous rect if necessary
39b0e098 1034 if (prevDirection == Dygraph.HORIZONTAL) {
6a1aa64f
DV
1035 ctx.clearRect(Math.min(startX, prevEndX), 0,
1036 Math.abs(startX - prevEndX), this.height_);
39b0e098 1037 } else if (prevDirection == Dygraph.VERTICAL){
8b83c6cc
RK
1038 ctx.clearRect(0, Math.min(startY, prevEndY),
1039 this.width_, Math.abs(startY - prevEndY));
6a1aa64f
DV
1040 }
1041
1042 // Draw a light-grey rectangle to show the new viewing area
39b0e098 1043 if (direction == Dygraph.HORIZONTAL) {
8b83c6cc
RK
1044 if (endX && startX) {
1045 ctx.fillStyle = "rgba(128,128,128,0.33)";
1046 ctx.fillRect(Math.min(startX, endX), 0,
1047 Math.abs(endX - startX), this.height_);
1048 }
1049 }
39b0e098 1050 if (direction == Dygraph.VERTICAL) {
8b83c6cc
RK
1051 if (endY && startY) {
1052 ctx.fillStyle = "rgba(128,128,128,0.33)";
1053 ctx.fillRect(0, Math.min(startY, endY),
1054 this.width_, Math.abs(endY - startY));
1055 }
6a1aa64f
DV
1056 }
1057};
1058
1059/**
8b83c6cc
RK
1060 * Zoom to something containing [lowX, highX]. These are pixel coordinates in
1061 * the canvas. The exact zoom window may be slightly larger if there are no data
1062 * points near lowX or highX. Don't confuse this function with doZoomXDates,
1063 * which accepts dates that match the raw data. This function redraws the graph.
d58ae307 1064 *
6a1aa64f
DV
1065 * @param {Number} lowX The leftmost pixel value that should be visible.
1066 * @param {Number} highX The rightmost pixel value that should be visible.
1067 * @private
1068 */
8b83c6cc 1069Dygraph.prototype.doZoomX_ = function(lowX, highX) {
6a1aa64f 1070 // Find the earliest and latest dates contained in this canvasx range.
8b83c6cc 1071 // Convert the call to date ranges of the raw data.
56623f3b
DV
1072 var r = this.toDataCoords(lowX, null);
1073 var minDate = r[0];
1074 r = this.toDataCoords(highX, null);
1075 var maxDate = r[0];
8b83c6cc
RK
1076 this.doZoomXDates_(minDate, maxDate);
1077};
6a1aa64f 1078
8b83c6cc
RK
1079/**
1080 * Zoom to something containing [minDate, maxDate] values. Don't confuse this
1081 * method with doZoomX which accepts pixel coordinates. This function redraws
1082 * the graph.
d58ae307 1083 *
8b83c6cc
RK
1084 * @param {Number} minDate The minimum date that should be visible.
1085 * @param {Number} maxDate The maximum date that should be visible.
1086 * @private
1087 */
1088Dygraph.prototype.doZoomXDates_ = function(minDate, maxDate) {
6a1aa64f 1089 this.dateWindow_ = [minDate, maxDate];
26ca7938 1090 this.drawGraph_();
285a6bda 1091 if (this.attr_("zoomCallback")) {
ac139d19 1092 this.attr_("zoomCallback")(minDate, maxDate, this.yAxisRanges());
8b83c6cc
RK
1093 }
1094};
1095
1096/**
1097 * Zoom to something containing [lowY, highY]. These are pixel coordinates in
d58ae307
DV
1098 * the canvas. This function redraws the graph.
1099 *
8b83c6cc
RK
1100 * @param {Number} lowY The topmost pixel value that should be visible.
1101 * @param {Number} highY The lowest pixel value that should be visible.
1102 * @private
1103 */
1104Dygraph.prototype.doZoomY_ = function(lowY, highY) {
d58ae307
DV
1105 // Find the highest and lowest values in pixel range for each axis.
1106 // Note that lowY (in pixels) corresponds to the max Value (in data coords).
1107 // This is because pixels increase as you go down on the screen, whereas data
1108 // coordinates increase as you go up the screen.
1109 var valueRanges = [];
1110 for (var i = 0; i < this.axes_.length; i++) {
1111 var hi = this.toDataCoords(null, lowY, i);
1112 var low = this.toDataCoords(null, highY, i);
1113 this.axes_[i].valueWindow = [low[1], hi[1]];
1114 valueRanges.push([low[1], hi[1]]);
1115 }
8b83c6cc 1116
66c380c4 1117 this.drawGraph_();
8b83c6cc 1118 if (this.attr_("zoomCallback")) {
d58ae307
DV
1119 var xRange = this.xAxisRange();
1120 this.attr_("zoomCallback")(xRange[0], xRange[1], this.yAxisRanges());
8b83c6cc
RK
1121 }
1122};
1123
1124/**
1125 * Reset the zoom to the original view coordinates. This is the same as
1126 * double-clicking on the graph.
d58ae307 1127 *
8b83c6cc
RK
1128 * @private
1129 */
1130Dygraph.prototype.doUnzoom_ = function() {
d58ae307 1131 var dirty = false;
8b83c6cc 1132 if (this.dateWindow_ != null) {
d58ae307 1133 dirty = true;
8b83c6cc
RK
1134 this.dateWindow_ = null;
1135 }
d58ae307
DV
1136
1137 for (var i = 0; i < this.axes_.length; i++) {
1138 if (this.axes_[i].valueWindow != null) {
1139 dirty = true;
1140 delete this.axes_[i].valueWindow;
1141 }
8b83c6cc
RK
1142 }
1143
1144 if (dirty) {
437c0979
RK
1145 // Putting the drawing operation before the callback because it resets
1146 // yAxisRange.
66c380c4 1147 this.drawGraph_();
8b83c6cc
RK
1148 if (this.attr_("zoomCallback")) {
1149 var minDate = this.rawData_[0][0];
1150 var maxDate = this.rawData_[this.rawData_.length - 1][0];
d58ae307 1151 this.attr_("zoomCallback")(minDate, maxDate, this.yAxisRanges());
8b83c6cc 1152 }
67e650dc 1153 }
6a1aa64f
DV
1154};
1155
1156/**
1157 * When the mouse moves in the canvas, display information about a nearby data
1158 * point and draw dots over those points in the data series. This function
1159 * takes care of cleanup of previously-drawn dots.
1160 * @param {Object} event The mousemove event from the browser.
1161 * @private
1162 */
285a6bda 1163Dygraph.prototype.mouseMove_ = function(event) {
eb7bf005 1164 var canvasx = Dygraph.pageX(event) - Dygraph.findPosX(this.mouseEventElement_);
6a1aa64f
DV
1165 var points = this.layout_.points;
1166
1167 var lastx = -1;
1168 var lasty = -1;
1169
1170 // Loop through all the points and find the date nearest to our current
1171 // location.
1172 var minDist = 1e+100;
1173 var idx = -1;
1174 for (var i = 0; i < points.length; i++) {
8a7cc60e
RK
1175 var point = points[i];
1176 if (point == null) continue;
6a1aa64f 1177 var dist = Math.abs(points[i].canvasx - canvasx);
f032c51d 1178 if (dist > minDist) continue;
6a1aa64f
DV
1179 minDist = dist;
1180 idx = i;
1181 }
1182 if (idx >= 0) lastx = points[idx].xval;
1183 // Check that you can really highlight the last day's data
8a7cc60e
RK
1184 var last = points[points.length-1];
1185 if (last != null && canvasx > last.canvasx)
6a1aa64f
DV
1186 lastx = points[points.length-1].xval;
1187
1188 // Extract the points we've selected
b258a3da 1189 this.selPoints_ = [];
50360fd0 1190 var l = points.length;
416b05ad
NK
1191 if (!this.attr_("stackedGraph")) {
1192 for (var i = 0; i < l; i++) {
1193 if (points[i].xval == lastx) {
1194 this.selPoints_.push(points[i]);
1195 }
1196 }
1197 } else {
354e15ab
DE
1198 // Need to 'unstack' points starting from the bottom
1199 var cumulative_sum = 0;
416b05ad
NK
1200 for (var i = l - 1; i >= 0; i--) {
1201 if (points[i].xval == lastx) {
354e15ab 1202 var p = {}; // Clone the point since we modify it
d4139cd8
NK
1203 for (var k in points[i]) {
1204 p[k] = points[i][k];
50360fd0
NK
1205 }
1206 p.yval -= cumulative_sum;
1207 cumulative_sum += p.yval;
d4139cd8 1208 this.selPoints_.push(p);
12e4c741 1209 }
6a1aa64f 1210 }
354e15ab 1211 this.selPoints_.reverse();
6a1aa64f
DV
1212 }
1213
b258a3da 1214 if (this.attr_("highlightCallback")) {
a4c6a67c 1215 var px = this.lastx_;
dd082dda 1216 if (px !== null && lastx != px) {
344ba8c0 1217 // only fire if the selected point has changed.
2ddb1197 1218 this.attr_("highlightCallback")(event, lastx, this.selPoints_, this.idxToRow_(idx));
43af96e7 1219 }
12e4c741 1220 }
43af96e7 1221
239c712d
NAG
1222 // Save last x position for callbacks.
1223 this.lastx_ = lastx;
50360fd0 1224
239c712d
NAG
1225 this.updateSelection_();
1226};
b258a3da 1227
239c712d 1228/**
1903f1e4 1229 * Transforms layout_.points index into data row number.
2ddb1197 1230 * @param int layout_.points index
1903f1e4 1231 * @return int row number, or -1 if none could be found.
2ddb1197
SC
1232 * @private
1233 */
1234Dygraph.prototype.idxToRow_ = function(idx) {
1903f1e4 1235 if (idx < 0) return -1;
2ddb1197 1236
1903f1e4
DV
1237 for (var i in this.layout_.datasets) {
1238 if (idx < this.layout_.datasets[i].length) {
1239 return this.boundaryIds_[0][0]+idx;
1240 }
1241 idx -= this.layout_.datasets[i].length;
1242 }
1243 return -1;
1244};
2ddb1197
SC
1245
1246/**
239c712d
NAG
1247 * Draw dots over the selectied points in the data series. This function
1248 * takes care of cleanup of previously-drawn dots.
1249 * @private
1250 */
1251Dygraph.prototype.updateSelection_ = function() {
6a1aa64f 1252 // Clear the previously drawn vertical, if there is one
6a1aa64f
DV
1253 var ctx = this.canvas_.getContext("2d");
1254 if (this.previousVerticalX_ >= 0) {
46dde5f9
DV
1255 // Determine the maximum highlight circle size.
1256 var maxCircleSize = 0;
227b93cc
DV
1257 var labels = this.attr_('labels');
1258 for (var i = 1; i < labels.length; i++) {
1259 var r = this.attr_('highlightCircleSize', labels[i]);
46dde5f9
DV
1260 if (r > maxCircleSize) maxCircleSize = r;
1261 }
6a1aa64f 1262 var px = this.previousVerticalX_;
46dde5f9
DV
1263 ctx.clearRect(px - maxCircleSize - 1, 0,
1264 2 * maxCircleSize + 2, this.height_);
6a1aa64f
DV
1265 }
1266
584ceeaa
DV
1267 var isOK = function(x) { return x && !isNaN(x); };
1268
d160cc3b 1269 if (this.selPoints_.length > 0) {
b258a3da 1270 var canvasx = this.selPoints_[0].canvasx;
6a1aa64f
DV
1271
1272 // Set the status message to indicate the selected point(s)
239c712d 1273 var replace = this.attr_('xValueFormatter')(this.lastx_, this) + ":";
50360fd0 1274 var fmtFunc = this.attr_('yValueFormatter');
6a1aa64f 1275 var clen = this.colors_.length;
d160cc3b
NK
1276
1277 if (this.attr_('showLabelsOnHighlight')) {
1278 // Set the status message to indicate the selected point(s)
d160cc3b 1279 for (var i = 0; i < this.selPoints_.length; i++) {
129569a5 1280 if (!this.attr_("labelsShowZeroValues") && this.selPoints_[i].yval == 0) continue;
d160cc3b
NK
1281 if (!isOK(this.selPoints_[i].canvasy)) continue;
1282 if (this.attr_("labelsSeparateLines")) {
1283 replace += "<br/>";
1284 }
1285 var point = this.selPoints_[i];
8fb6dc24 1286 var c = new RGBColor(this.plotter_.colors[point.name]);
3c1d225b 1287 var yval = fmtFunc(point.yval, this.numDigits_ + 1); // In tenths.
d160cc3b
NK
1288 replace += " <b><font color='" + c.toHex() + "'>"
1289 + point.name + "</font></b>:"
1290 + yval;
6a1aa64f 1291 }
50360fd0 1292
d160cc3b 1293 this.attr_("labelsDiv").innerHTML = replace;
6a1aa64f 1294 }
6a1aa64f 1295
6a1aa64f 1296 // Draw colored circles over the center of each selected point
43af96e7 1297 ctx.save();
b258a3da 1298 for (var i = 0; i < this.selPoints_.length; i++) {
f032c51d 1299 if (!isOK(this.selPoints_[i].canvasy)) continue;
227b93cc
DV
1300 var circleSize =
1301 this.attr_('highlightCircleSize', this.selPoints_[i].name);
6a1aa64f 1302 ctx.beginPath();
563c70ca 1303 ctx.fillStyle = this.plotter_.colors[this.selPoints_[i].name];
f032c51d 1304 ctx.arc(canvasx, this.selPoints_[i].canvasy, circleSize,
7bf6a9fe 1305 0, 2 * Math.PI, false);
6a1aa64f
DV
1306 ctx.fill();
1307 }
1308 ctx.restore();
1309
1310 this.previousVerticalX_ = canvasx;
1311 }
1312};
1313
1314/**
239c712d
NAG
1315 * Set manually set selected dots, and display information about them
1316 * @param int row number that should by highlighted
1317 * false value clears the selection
1318 * @public
1319 */
1320Dygraph.prototype.setSelection = function(row) {
1321 // Extract the points we've selected
1322 this.selPoints_ = [];
1323 var pos = 0;
50360fd0 1324
239c712d 1325 if (row !== false) {
16269f6e
NAG
1326 row = row-this.boundaryIds_[0][0];
1327 }
50360fd0 1328
16269f6e 1329 if (row !== false && row >= 0) {
239c712d 1330 for (var i in this.layout_.datasets) {
16269f6e 1331 if (row < this.layout_.datasets[i].length) {
38f33a44 1332 var point = this.layout_.points[pos+row];
1333
1334 if (this.attr_("stackedGraph")) {
8c03ba63 1335 point = this.layout_.unstackPointAtIndex(pos+row);
38f33a44 1336 }
1337
1338 this.selPoints_.push(point);
16269f6e 1339 }
239c712d
NAG
1340 pos += this.layout_.datasets[i].length;
1341 }
16269f6e 1342 }
50360fd0 1343
16269f6e 1344 if (this.selPoints_.length) {
239c712d
NAG
1345 this.lastx_ = this.selPoints_[0].xval;
1346 this.updateSelection_();
1347 } else {
1348 this.lastx_ = -1;
1349 this.clearSelection();
1350 }
1351
1352};
1353
1354/**
6a1aa64f
DV
1355 * The mouse has left the canvas. Clear out whatever artifacts remain
1356 * @param {Object} event the mouseout event from the browser.
1357 * @private
1358 */
285a6bda 1359Dygraph.prototype.mouseOut_ = function(event) {
a4c6a67c
AV
1360 if (this.attr_("unhighlightCallback")) {
1361 this.attr_("unhighlightCallback")(event);
1362 }
1363
43af96e7 1364 if (this.attr_("hideOverlayOnMouseOut")) {
239c712d 1365 this.clearSelection();
43af96e7 1366 }
6a1aa64f
DV
1367};
1368
239c712d
NAG
1369/**
1370 * Remove all selection from the canvas
1371 * @public
1372 */
1373Dygraph.prototype.clearSelection = function() {
1374 // Get rid of the overlay data
1375 var ctx = this.canvas_.getContext("2d");
1376 ctx.clearRect(0, 0, this.width_, this.height_);
1377 this.attr_("labelsDiv").innerHTML = "";
1378 this.selPoints_ = [];
1379 this.lastx_ = -1;
1380}
1381
103b7292
NAG
1382/**
1383 * Returns the number of the currently selected row
1384 * @return int row number, of -1 if nothing is selected
1385 * @public
1386 */
1387Dygraph.prototype.getSelection = function() {
1388 if (!this.selPoints_ || this.selPoints_.length < 1) {
1389 return -1;
1390 }
50360fd0 1391
103b7292
NAG
1392 for (var row=0; row<this.layout_.points.length; row++ ) {
1393 if (this.layout_.points[row].x == this.selPoints_[0].x) {
16269f6e 1394 return row + this.boundaryIds_[0][0];
103b7292
NAG
1395 }
1396 }
1397 return -1;
1398}
1399
285a6bda 1400Dygraph.zeropad = function(x) {
32988383
DV
1401 if (x < 10) return "0" + x; else return "" + x;
1402}
1403
6a1aa64f 1404/**
6b8e33dd
DV
1405 * Return a string version of the hours, minutes and seconds portion of a date.
1406 * @param {Number} date The JavaScript date (ms since epoch)
1407 * @return {String} A time of the form "HH:MM:SS"
1408 * @private
1409 */
bf640e56 1410Dygraph.hmsString_ = function(date) {
285a6bda 1411 var zeropad = Dygraph.zeropad;
6b8e33dd
DV
1412 var d = new Date(date);
1413 if (d.getSeconds()) {
1414 return zeropad(d.getHours()) + ":" +
1415 zeropad(d.getMinutes()) + ":" +
1416 zeropad(d.getSeconds());
6b8e33dd 1417 } else {
054531ca 1418 return zeropad(d.getHours()) + ":" + zeropad(d.getMinutes());
6b8e33dd
DV
1419 }
1420}
1421
1422/**
bf640e56
AV
1423 * Convert a JS date to a string appropriate to display on an axis that
1424 * is displaying values at the stated granularity.
1425 * @param {Date} date The date to format
1426 * @param {Number} granularity One of the Dygraph granularity constants
1427 * @return {String} The formatted date
1428 * @private
1429 */
1430Dygraph.dateAxisFormatter = function(date, granularity) {
1431 if (granularity >= Dygraph.MONTHLY) {
1432 return date.strftime('%b %y');
1433 } else {
31eddad3 1434 var frac = date.getHours() * 3600 + date.getMinutes() * 60 + date.getSeconds() + date.getMilliseconds();
bf640e56
AV
1435 if (frac == 0 || granularity >= Dygraph.DAILY) {
1436 return new Date(date.getTime() + 3600*1000).strftime('%d%b');
1437 } else {
1438 return Dygraph.hmsString_(date.getTime());
1439 }
1440 }
1441}
1442
1443/**
6a1aa64f
DV
1444 * Convert a JS date (millis since epoch) to YYYY/MM/DD
1445 * @param {Number} date The JavaScript date (ms since epoch)
1446 * @return {String} A date of the form "YYYY/MM/DD"
1447 * @private
1448 */
285a6bda
DV
1449Dygraph.dateString_ = function(date, self) {
1450 var zeropad = Dygraph.zeropad;
6a1aa64f
DV
1451 var d = new Date(date);
1452
1453 // Get the year:
1454 var year = "" + d.getFullYear();
1455 // Get a 0 padded month string
6b8e33dd 1456 var month = zeropad(d.getMonth() + 1); //months are 0-offset, sigh
6a1aa64f 1457 // Get a 0 padded day string
6b8e33dd 1458 var day = zeropad(d.getDate());
6a1aa64f 1459
6b8e33dd
DV
1460 var ret = "";
1461 var frac = d.getHours() * 3600 + d.getMinutes() * 60 + d.getSeconds();
bf640e56 1462 if (frac) ret = " " + Dygraph.hmsString_(date);
6b8e33dd
DV
1463
1464 return year + "/" + month + "/" + day + ret;
6a1aa64f
DV
1465};
1466
1467/**
6a1aa64f
DV
1468 * Fires when there's data available to be graphed.
1469 * @param {String} data Raw CSV data to be plotted
1470 * @private
1471 */
285a6bda 1472Dygraph.prototype.loadedEvent_ = function(data) {
6a1aa64f 1473 this.rawData_ = this.parseCSV_(data);
26ca7938 1474 this.predraw_();
6a1aa64f
DV
1475};
1476
285a6bda 1477Dygraph.prototype.months = ["Jan", "Feb", "Mar", "Apr", "May", "Jun",
8846615a 1478 "Jul", "Aug", "Sep", "Oct", "Nov", "Dec"];
285a6bda 1479Dygraph.prototype.quarters = ["Jan", "Apr", "Jul", "Oct"];
6a1aa64f
DV
1480
1481/**
1482 * Add ticks on the x-axis representing years, months, quarters, weeks, or days
1483 * @private
1484 */
285a6bda 1485Dygraph.prototype.addXTicks_ = function() {
6a1aa64f
DV
1486 // Determine the correct ticks scale on the x-axis: quarterly, monthly, ...
1487 var startDate, endDate;
1488 if (this.dateWindow_) {
1489 startDate = this.dateWindow_[0];
1490 endDate = this.dateWindow_[1];
1491 } else {
1492 startDate = this.rawData_[0][0];
1493 endDate = this.rawData_[this.rawData_.length - 1][0];
1494 }
1495
3c1d225b
JB
1496 var ret = this.attr_('xTicker')(startDate, endDate, this);
1497 if (ret.ticks !== undefined) { // Used numericTicks()?
1498 this.layout_.updateOptions({xTicks: ret.ticks});
1499 } else { // Used dateTicker() instead.
1500 this.layout_.updateOptions({xTicks: ret});
1501 }
32988383
DV
1502};
1503
1504// Time granularity enumeration
285a6bda 1505Dygraph.SECONDLY = 0;
20a41c17
DV
1506Dygraph.TWO_SECONDLY = 1;
1507Dygraph.FIVE_SECONDLY = 2;
1508Dygraph.TEN_SECONDLY = 3;
1509Dygraph.THIRTY_SECONDLY = 4;
1510Dygraph.MINUTELY = 5;
1511Dygraph.TWO_MINUTELY = 6;
1512Dygraph.FIVE_MINUTELY = 7;
1513Dygraph.TEN_MINUTELY = 8;
1514Dygraph.THIRTY_MINUTELY = 9;
1515Dygraph.HOURLY = 10;
1516Dygraph.TWO_HOURLY = 11;
1517Dygraph.SIX_HOURLY = 12;
1518Dygraph.DAILY = 13;
1519Dygraph.WEEKLY = 14;
1520Dygraph.MONTHLY = 15;
1521Dygraph.QUARTERLY = 16;
1522Dygraph.BIANNUAL = 17;
1523Dygraph.ANNUAL = 18;
1524Dygraph.DECADAL = 19;
1525Dygraph.NUM_GRANULARITIES = 20;
285a6bda
DV
1526
1527Dygraph.SHORT_SPACINGS = [];
1528Dygraph.SHORT_SPACINGS[Dygraph.SECONDLY] = 1000 * 1;
20a41c17
DV
1529Dygraph.SHORT_SPACINGS[Dygraph.TWO_SECONDLY] = 1000 * 2;
1530Dygraph.SHORT_SPACINGS[Dygraph.FIVE_SECONDLY] = 1000 * 5;
285a6bda
DV
1531Dygraph.SHORT_SPACINGS[Dygraph.TEN_SECONDLY] = 1000 * 10;
1532Dygraph.SHORT_SPACINGS[Dygraph.THIRTY_SECONDLY] = 1000 * 30;
1533Dygraph.SHORT_SPACINGS[Dygraph.MINUTELY] = 1000 * 60;
20a41c17
DV
1534Dygraph.SHORT_SPACINGS[Dygraph.TWO_MINUTELY] = 1000 * 60 * 2;
1535Dygraph.SHORT_SPACINGS[Dygraph.FIVE_MINUTELY] = 1000 * 60 * 5;
285a6bda
DV
1536Dygraph.SHORT_SPACINGS[Dygraph.TEN_MINUTELY] = 1000 * 60 * 10;
1537Dygraph.SHORT_SPACINGS[Dygraph.THIRTY_MINUTELY] = 1000 * 60 * 30;
1538Dygraph.SHORT_SPACINGS[Dygraph.HOURLY] = 1000 * 3600;
20a41c17 1539Dygraph.SHORT_SPACINGS[Dygraph.TWO_HOURLY] = 1000 * 3600 * 2;
805d5519 1540Dygraph.SHORT_SPACINGS[Dygraph.SIX_HOURLY] = 1000 * 3600 * 6;
285a6bda
DV
1541Dygraph.SHORT_SPACINGS[Dygraph.DAILY] = 1000 * 86400;
1542Dygraph.SHORT_SPACINGS[Dygraph.WEEKLY] = 1000 * 604800;
32988383
DV
1543
1544// NumXTicks()
1545//
1546// If we used this time granularity, how many ticks would there be?
1547// This is only an approximation, but it's generally good enough.
1548//
285a6bda
DV
1549Dygraph.prototype.NumXTicks = function(start_time, end_time, granularity) {
1550 if (granularity < Dygraph.MONTHLY) {
32988383 1551 // Generate one tick mark for every fixed interval of time.
285a6bda 1552 var spacing = Dygraph.SHORT_SPACINGS[granularity];
32988383
DV
1553 return Math.floor(0.5 + 1.0 * (end_time - start_time) / spacing);
1554 } else {
1555 var year_mod = 1; // e.g. to only print one point every 10 years.
1556 var num_months = 12;
285a6bda
DV
1557 if (granularity == Dygraph.QUARTERLY) num_months = 3;
1558 if (granularity == Dygraph.BIANNUAL) num_months = 2;
1559 if (granularity == Dygraph.ANNUAL) num_months = 1;
1560 if (granularity == Dygraph.DECADAL) { num_months = 1; year_mod = 10; }
32988383
DV
1561
1562 var msInYear = 365.2524 * 24 * 3600 * 1000;
1563 var num_years = 1.0 * (end_time - start_time) / msInYear;
1564 return Math.floor(0.5 + 1.0 * num_years * num_months / year_mod);
1565 }
1566};
1567
1568// GetXAxis()
1569//
1570// Construct an x-axis of nicely-formatted times on meaningful boundaries
1571// (e.g. 'Jan 09' rather than 'Jan 22, 2009').
1572//
1573// Returns an array containing {v: millis, label: label} dictionaries.
1574//
285a6bda 1575Dygraph.prototype.GetXAxis = function(start_time, end_time, granularity) {
bf640e56 1576 var formatter = this.attr_("xAxisLabelFormatter");
32988383 1577 var ticks = [];
285a6bda 1578 if (granularity < Dygraph.MONTHLY) {
32988383 1579 // Generate one tick mark for every fixed interval of time.
285a6bda 1580 var spacing = Dygraph.SHORT_SPACINGS[granularity];
3d29302c 1581 var format = '%d%b'; // e.g. "1Jan"
076c9622
DV
1582
1583 // Find a time less than start_time which occurs on a "nice" time boundary
1584 // for this granularity.
1585 var g = spacing / 1000;
076c9622
DV
1586 var d = new Date(start_time);
1587 if (g <= 60) { // seconds
1588 var x = d.getSeconds(); d.setSeconds(x - x % g);
1589 } else {
1590 d.setSeconds(0);
1591 g /= 60;
1592 if (g <= 60) { // minutes
1593 var x = d.getMinutes(); d.setMinutes(x - x % g);
1594 } else {
1595 d.setMinutes(0);
1596 g /= 60;
1597
1598 if (g <= 24) { // days
1599 var x = d.getHours(); d.setHours(x - x % g);
1600 } else {
1601 d.setHours(0);
1602 g /= 24;
1603
1604 if (g == 7) { // one week
20a41c17 1605 d.setDate(d.getDate() - d.getDay());
076c9622
DV
1606 }
1607 }
1608 }
328bb812 1609 }
076c9622
DV
1610 start_time = d.getTime();
1611
32988383 1612 for (var t = start_time; t <= end_time; t += spacing) {
bf640e56 1613 ticks.push({ v:t, label: formatter(new Date(t), granularity) });
32988383
DV
1614 }
1615 } else {
1616 // Display a tick mark on the first of a set of months of each year.
1617 // Years get a tick mark iff y % year_mod == 0. This is useful for
1618 // displaying a tick mark once every 10 years, say, on long time scales.
1619 var months;
1620 var year_mod = 1; // e.g. to only print one point every 10 years.
1621
285a6bda 1622 if (granularity == Dygraph.MONTHLY) {
32988383 1623 months = [ 0, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12 ];
285a6bda 1624 } else if (granularity == Dygraph.QUARTERLY) {
32988383 1625 months = [ 0, 3, 6, 9 ];
285a6bda 1626 } else if (granularity == Dygraph.BIANNUAL) {
32988383 1627 months = [ 0, 6 ];
285a6bda 1628 } else if (granularity == Dygraph.ANNUAL) {
32988383 1629 months = [ 0 ];
285a6bda 1630 } else if (granularity == Dygraph.DECADAL) {
32988383
DV
1631 months = [ 0 ];
1632 year_mod = 10;
1633 }
1634
1635 var start_year = new Date(start_time).getFullYear();
1636 var end_year = new Date(end_time).getFullYear();
285a6bda 1637 var zeropad = Dygraph.zeropad;
32988383
DV
1638 for (var i = start_year; i <= end_year; i++) {
1639 if (i % year_mod != 0) continue;
1640 for (var j = 0; j < months.length; j++) {
1641 var date_str = i + "/" + zeropad(1 + months[j]) + "/01";
1642 var t = Date.parse(date_str);
1643 if (t < start_time || t > end_time) continue;
bf640e56 1644 ticks.push({ v:t, label: formatter(new Date(t), granularity) });
32988383
DV
1645 }
1646 }
1647 }
1648
1649 return ticks;
1650};
1651
6a1aa64f
DV
1652
1653/**
1654 * Add ticks to the x-axis based on a date range.
1655 * @param {Number} startDate Start of the date window (millis since epoch)
1656 * @param {Number} endDate End of the date window (millis since epoch)
1657 * @return {Array.<Object>} Array of {label, value} tuples.
1658 * @public
1659 */
285a6bda 1660Dygraph.dateTicker = function(startDate, endDate, self) {
32988383 1661 var chosen = -1;
285a6bda
DV
1662 for (var i = 0; i < Dygraph.NUM_GRANULARITIES; i++) {
1663 var num_ticks = self.NumXTicks(startDate, endDate, i);
1664 if (self.width_ / num_ticks >= self.attr_('pixelsPerXLabel')) {
32988383
DV
1665 chosen = i;
1666 break;
2769de62 1667 }
6a1aa64f
DV
1668 }
1669
32988383 1670 if (chosen >= 0) {
285a6bda 1671 return self.GetXAxis(startDate, endDate, chosen);
6a1aa64f 1672 } else {
32988383 1673 // TODO(danvk): signal error.
6a1aa64f 1674 }
6a1aa64f
DV
1675};
1676
1677/**
3c1d225b
JB
1678 * Determine the number of significant figures in a Number up to the specified
1679 * precision. Note that there is no way to determine if a trailing '0' is
1680 * significant or not, so by convention we return 1 for all of the following
1681 * inputs: 1, 1.0, 1.00, 1.000 etc.
1682 * @param {Number} x The input value.
1683 * @param {Number} opt_maxPrecision Optional maximum precision to consider.
1684 * Default and maximum allowed value is 13.
1685 * @return {Number} The number of significant figures which is >= 1.
1686 */
1687Dygraph.significantFigures = function(x, opt_maxPrecision) {
1688 var precision = Math.max(opt_maxPrecision || 13, 13);
1689
1690 // Convert the number to it's exponential notation form and work backwards,
1691 // ignoring the 'e+xx' bit. This may seem like a hack, but doing a loop and
1692 // dividing by 10 leads to roundoff errors. By using toExponential(), we let
1693 // the JavaScript interpreter handle the low level bits of the Number for us.
1694 var s = x.toExponential(precision);
1695 var ePos = s.lastIndexOf('e'); // -1 case handled by return below.
1696
1697 for (var i = ePos - 1; i >= 0; i--) {
1698 if (s[i] == '.') {
1699 // Got to the decimal place. We'll call this 1 digit of precision because
1700 // we can't know for sure how many trailing 0s are significant.
1701 return 1;
1702 } else if (s[i] != '0') {
1703 // Found the first non-zero digit. Return the number of characters
1704 // except for the '.'.
1705 return i; // This is i - 1 + 1 (-1 is for '.', +1 is for 0 based index).
1706 }
1707 }
1708
1709 // Occurs if toExponential() doesn't return a string containing 'e', which
1710 // should never happen.
1711 return 1;
1712};
1713
1714/**
6a1aa64f
DV
1715 * Add ticks when the x axis has numbers on it (instead of dates)
1716 * @param {Number} startDate Start of the date window (millis since epoch)
1717 * @param {Number} endDate End of the date window (millis since epoch)
84fc6aa7 1718 * @param self
f30cf740 1719 * @param {function} attribute accessor function.
6a1aa64f
DV
1720 * @return {Array.<Object>} Array of {label, value} tuples.
1721 * @public
1722 */
0d64e596 1723Dygraph.numericTicks = function(minV, maxV, self, axis_props, vals) {
70c80071
DV
1724 var attr = function(k) {
1725 if (axis_props && axis_props.hasOwnProperty(k)) return axis_props[k];
1726 return self.attr_(k);
1727 };
f09fc545 1728
0d64e596
DV
1729 var ticks = [];
1730 if (vals) {
1731 for (var i = 0; i < vals.length; i++) {
3c1d225b 1732 ticks[i] = {v: vals[i]};
0d64e596 1733 }
f09e46d4 1734 } else {
0d64e596
DV
1735 // Basic idea:
1736 // Try labels every 1, 2, 5, 10, 20, 50, 100, etc.
1737 // Calculate the resulting tick spacing (i.e. this.height_ / nTicks).
1738 // The first spacing greater than pixelsPerYLabel is what we use.
1739 // TODO(danvk): version that works on a log scale.
f09fc545 1740 if (attr("labelsKMG2")) {
0d64e596 1741 var mults = [1, 2, 4, 8];
f09e46d4 1742 } else {
0d64e596 1743 var mults = [1, 2, 5];
f09e46d4 1744 }
0d64e596
DV
1745 var scale, low_val, high_val, nTicks;
1746 // TODO(danvk): make it possible to set this for x- and y-axes independently.
1747 var pixelsPerTick = attr('pixelsPerYLabel');
1748 for (var i = -10; i < 50; i++) {
1749 if (attr("labelsKMG2")) {
1750 var base_scale = Math.pow(16, i);
1751 } else {
1752 var base_scale = Math.pow(10, i);
1753 }
1754 for (var j = 0; j < mults.length; j++) {
1755 scale = base_scale * mults[j];
1756 low_val = Math.floor(minV / scale) * scale;
1757 high_val = Math.ceil(maxV / scale) * scale;
1758 nTicks = Math.abs(high_val - low_val) / scale;
1759 var spacing = self.height_ / nTicks;
1760 // wish I could break out of both loops at once...
1761 if (spacing > pixelsPerTick) break;
1762 }
285a6bda 1763 if (spacing > pixelsPerTick) break;
c6336f04 1764 }
0d64e596
DV
1765
1766 // Construct the set of ticks.
1767 // Allow reverse y-axis if it's explicitly requested.
1768 if (low_val > high_val) scale *= -1;
1769 for (var i = 0; i < nTicks; i++) {
1770 var tickV = low_val + i * scale;
3c1d225b 1771 ticks[i] = {v: tickV};
0d64e596 1772 }
6a1aa64f
DV
1773 }
1774
0d64e596 1775 // Add formatted labels to the ticks.
ed11be50
DV
1776 var k;
1777 var k_labels = [];
f09fc545 1778 if (attr("labelsKMB")) {
ed11be50
DV
1779 k = 1000;
1780 k_labels = [ "K", "M", "B", "T" ];
1781 }
f09fc545 1782 if (attr("labelsKMG2")) {
ed11be50
DV
1783 if (k) self.warn("Setting both labelsKMB and labelsKMG2. Pick one!");
1784 k = 1024;
1785 k_labels = [ "k", "M", "G", "T" ];
1786 }
3c1d225b
JB
1787 var formatter = attr('yAxisLabelFormatter') ?
1788 attr('yAxisLabelFormatter') : attr('yValueFormatter');
1789
1790 // Determine the number of decimal places needed for the labels below by
1791 // taking the maximum number of significant figures for any label. We must
1792 // take the max because we can't tell if trailing 0s are significant.
1793 var numDigits = 0;
1794 for (var i = 0; i < ticks.length; i++) {
1795 var tickV = ticks[i].v;
1796 numDigits = Math.max(Dygraph.significantFigures(tickV), numDigits);
1797 }
ed11be50 1798
0d64e596
DV
1799 for (var i = 0; i < ticks.length; i++) {
1800 var tickV = ticks[i].v;
0af6e346 1801 var absTickV = Math.abs(tickV);
3c1d225b
JB
1802 var label = (formatter !== undefined) ?
1803 formatter(tickV, numDigits) : tickV.toPrecision(numDigits);
1804 if (k_labels.length > 0) {
ed11be50
DV
1805 // Round up to an appropriate unit.
1806 var n = k*k*k*k;
1807 for (var j = 3; j >= 0; j--, n /= k) {
1808 if (absTickV >= n) {
3c1d225b 1809 label = (tickV / n).toPrecision(numDigits) + k_labels[j];
ed11be50
DV
1810 break;
1811 }
afefbcdb 1812 }
6a1aa64f 1813 }
0d64e596 1814 ticks[i].label = label;
6a1aa64f 1815 }
3c1d225b 1816 return {ticks: ticks, numDigits: numDigits};
6a1aa64f
DV
1817};
1818
5011e7a1
DV
1819// Computes the range of the data series (including confidence intervals).
1820// series is either [ [x1, y1], [x2, y2], ... ] or
1821// [ [x1, [y1, dev_low, dev_high]], [x2, [y2, dev_low, dev_high]], ...
1822// Returns [low, high]
1823Dygraph.prototype.extremeValues_ = function(series) {
1824 var minY = null, maxY = null;
1825
9922b78b 1826 var bars = this.attr_("errorBars") || this.attr_("customBars");
5011e7a1
DV
1827 if (bars) {
1828 // With custom bars, maxY is the max of the high values.
1829 for (var j = 0; j < series.length; j++) {
1830 var y = series[j][1][0];
1831 if (!y) continue;
1832 var low = y - series[j][1][1];
1833 var high = y + series[j][1][2];
1834 if (low > y) low = y; // this can happen with custom bars,
1835 if (high < y) high = y; // e.g. in tests/custom-bars.html
1836 if (maxY == null || high > maxY) {
1837 maxY = high;
1838 }
1839 if (minY == null || low < minY) {
1840 minY = low;
1841 }
1842 }
1843 } else {
1844 for (var j = 0; j < series.length; j++) {
1845 var y = series[j][1];
d12999d3 1846 if (y === null || isNaN(y)) continue;
5011e7a1
DV
1847 if (maxY == null || y > maxY) {
1848 maxY = y;
1849 }
1850 if (minY == null || y < minY) {
1851 minY = y;
1852 }
1853 }
1854 }
1855
1856 return [minY, maxY];
1857};
1858
6a1aa64f 1859/**
26ca7938
DV
1860 * This function is called once when the chart's data is changed or the options
1861 * dictionary is updated. It is _not_ called when the user pans or zooms. The
1862 * idea is that values derived from the chart's data can be computed here,
1863 * rather than every time the chart is drawn. This includes things like the
1864 * number of axes, rolling averages, etc.
1865 */
1866Dygraph.prototype.predraw_ = function() {
1867 // TODO(danvk): move more computations out of drawGraph_ and into here.
1868 this.computeYAxes_();
1869
1870 // Create a new plotter.
70c80071 1871 if (this.plotter_) this.plotter_.clear();
26ca7938
DV
1872 this.plotter_ = new DygraphCanvasRenderer(this,
1873 this.hidden_, this.layout_,
1874 this.renderOptions_);
1875
0abfbd7e
DV
1876 // The roller sits in the bottom left corner of the chart. We don't know where
1877 // this will be until the options are available, so it's positioned here.
8c69de65 1878 this.createRollInterface_();
26ca7938 1879
0abfbd7e
DV
1880 // Same thing applies for the labelsDiv. It's right edge should be flush with
1881 // the right edge of the charting area (which may not be the same as the right
1882 // edge of the div, if we have two y-axes.
1883 this.positionLabelsDiv_();
1884
26ca7938
DV
1885 // If the data or options have changed, then we'd better redraw.
1886 this.drawGraph_();
1887};
1888
1889/**
2f5e7e1a 1890=======
26ca7938
DV
1891 * Update the graph with new data. This method is called when the viewing area
1892 * has changed. If the underlying data or options have changed, predraw_ will
1893 * be called before drawGraph_ is called.
6a1aa64f
DV
1894 * @private
1895 */
26ca7938
DV
1896Dygraph.prototype.drawGraph_ = function() {
1897 var data = this.rawData_;
1898
fe0b7c03
DV
1899 // This is used to set the second parameter to drawCallback, below.
1900 var is_initial_draw = this.is_initial_draw_;
1901 this.is_initial_draw_ = false;
1902
3bd9c228 1903 var minY = null, maxY = null;
6a1aa64f 1904 this.layout_.removeAllDatasets();
285a6bda 1905 this.setColors_();
9317362d 1906 this.attrs_['pointSize'] = 0.5 * this.attr_('highlightCircleSize');
285a6bda 1907
354e15ab
DE
1908 // Loop over the fields (series). Go from the last to the first,
1909 // because if they're stacked that's how we accumulate the values.
43af96e7 1910
354e15ab
DE
1911 var cumulative_y = []; // For stacked series.
1912 var datasets = [];
1913
f09fc545
DV
1914 var extremes = {}; // series name -> [low, high]
1915
354e15ab
DE
1916 // Loop over all fields and create datasets
1917 for (var i = data[0].length - 1; i >= 1; i--) {
1cf11047
DV
1918 if (!this.visibility()[i - 1]) continue;
1919
f09fc545 1920 var seriesName = this.attr_("labels")[i];
450fe64b
DV
1921 var connectSeparatedPoints = this.attr_('connectSeparatedPoints', i);
1922
6a1aa64f
DV
1923 var series = [];
1924 for (var j = 0; j < data.length; j++) {
4a634fc7 1925 if (data[j][i] != null || !connectSeparatedPoints) {
f032c51d 1926 var date = data[j][0];
563c70ca 1927 series.push([date, data[j][i]]);
f032c51d 1928 }
6a1aa64f 1929 }
2f5e7e1a
DV
1930
1931 // TODO(danvk): move this into predraw_. It's insane to do it here.
6a1aa64f
DV
1932 series = this.rollingAverage(series, this.rollPeriod_);
1933
1934 // Prune down to the desired range, if necessary (for zooming)
1a26f3fb
DV
1935 // Because there can be lines going to points outside of the visible area,
1936 // we actually prune to visible points, plus one on either side.
9922b78b 1937 var bars = this.attr_("errorBars") || this.attr_("customBars");
6a1aa64f
DV
1938 if (this.dateWindow_) {
1939 var low = this.dateWindow_[0];
1940 var high= this.dateWindow_[1];
1941 var pruned = [];
1a26f3fb
DV
1942 // TODO(danvk): do binary search instead of linear search.
1943 // TODO(danvk): pass firstIdx and lastIdx directly to the renderer.
1944 var firstIdx = null, lastIdx = null;
6a1aa64f 1945 for (var k = 0; k < series.length; k++) {
1a26f3fb
DV
1946 if (series[k][0] >= low && firstIdx === null) {
1947 firstIdx = k;
1948 }
1949 if (series[k][0] <= high) {
1950 lastIdx = k;
6a1aa64f
DV
1951 }
1952 }
1a26f3fb
DV
1953 if (firstIdx === null) firstIdx = 0;
1954 if (firstIdx > 0) firstIdx--;
1955 if (lastIdx === null) lastIdx = series.length - 1;
1956 if (lastIdx < series.length - 1) lastIdx++;
16269f6e 1957 this.boundaryIds_[i-1] = [firstIdx, lastIdx];
1a26f3fb
DV
1958 for (var k = firstIdx; k <= lastIdx; k++) {
1959 pruned.push(series[k]);
6a1aa64f
DV
1960 }
1961 series = pruned;
16269f6e
NAG
1962 } else {
1963 this.boundaryIds_[i-1] = [0, series.length-1];
6a1aa64f
DV
1964 }
1965
f09fc545 1966 var seriesExtremes = this.extremeValues_(series);
5011e7a1 1967
6a1aa64f 1968 if (bars) {
354e15ab
DE
1969 for (var j=0; j<series.length; j++) {
1970 val = [series[j][0], series[j][1][0], series[j][1][1], series[j][1][2]];
1971 series[j] = val;
1972 }
43af96e7 1973 } else if (this.attr_("stackedGraph")) {
43af96e7
NK
1974 var l = series.length;
1975 var actual_y;
1976 for (var j = 0; j < l; j++) {
354e15ab
DE
1977 // If one data set has a NaN, let all subsequent stacked
1978 // sets inherit the NaN -- only start at 0 for the first set.
1979 var x = series[j][0];
41b0f691 1980 if (cumulative_y[x] === undefined) {
354e15ab 1981 cumulative_y[x] = 0;
41b0f691 1982 }
43af96e7
NK
1983
1984 actual_y = series[j][1];
354e15ab 1985 cumulative_y[x] += actual_y;
43af96e7 1986
354e15ab 1987 series[j] = [x, cumulative_y[x]]
43af96e7 1988
41b0f691
DV
1989 if (cumulative_y[x] > seriesExtremes[1]) {
1990 seriesExtremes[1] = cumulative_y[x];
1991 }
1992 if (cumulative_y[x] < seriesExtremes[0]) {
1993 seriesExtremes[0] = cumulative_y[x];
1994 }
43af96e7 1995 }
6a1aa64f 1996 }
41b0f691 1997 extremes[seriesName] = seriesExtremes;
354e15ab
DE
1998
1999 datasets[i] = series;
6a1aa64f
DV
2000 }
2001
354e15ab 2002 for (var i = 1; i < datasets.length; i++) {
4523c1f6 2003 if (!this.visibility()[i - 1]) continue;
354e15ab 2004 this.layout_.addDataset(this.attr_("labels")[i], datasets[i]);
43af96e7
NK
2005 }
2006
3c1d225b
JB
2007 this.computeYAxisRanges_(extremes);
2008 this.layout_.updateOptions( { yAxes: this.axes_,
2009 seriesToAxisMap: this.seriesToAxisMap_
9012dd21 2010 } );
f09fc545 2011
6a1aa64f
DV
2012 this.addXTicks_();
2013
2014 // Tell PlotKit to use this new data and render itself
d033ae1c 2015 this.layout_.updateOptions({dateWindow: this.dateWindow_});
6a1aa64f
DV
2016 this.layout_.evaluateWithError();
2017 this.plotter_.clear();
2018 this.plotter_.render();
f6401bf6 2019 this.canvas_.getContext('2d').clearRect(0, 0, this.canvas_.width,
2f5e7e1a 2020 this.canvas_.height);
599fb4ad
DV
2021
2022 if (this.attr_("drawCallback") !== null) {
fe0b7c03 2023 this.attr_("drawCallback")(this, is_initial_draw);
599fb4ad 2024 }
6a1aa64f
DV
2025};
2026
2027/**
26ca7938
DV
2028 * Determine properties of the y-axes which are independent of the data
2029 * currently being displayed. This includes things like the number of axes and
2030 * the style of the axes. It does not include the range of each axis and its
2031 * tick marks.
2032 * This fills in this.axes_ and this.seriesToAxisMap_.
2033 * axes_ = [ { options } ]
2034 * seriesToAxisMap_ = { seriesName: 0, seriesName2: 1, ... }
2035 * indices are into the axes_ array.
f09fc545 2036 */
26ca7938
DV
2037Dygraph.prototype.computeYAxes_ = function() {
2038 this.axes_ = [{}]; // always have at least one y-axis.
2039 this.seriesToAxisMap_ = {};
2040
2041 // Get a list of series names.
2042 var labels = this.attr_("labels");
1c77a3a1 2043 var series = {};
26ca7938 2044 for (var i = 1; i < labels.length; i++) series[labels[i]] = (i - 1);
f09fc545
DV
2045
2046 // all options which could be applied per-axis:
2047 var axisOptions = [
2048 'includeZero',
2049 'valueRange',
2050 'labelsKMB',
2051 'labelsKMG2',
2052 'pixelsPerYLabel',
2053 'yAxisLabelWidth',
2054 'axisLabelFontSize',
2055 'axisTickSize'
2056 ];
2057
2058 // Copy global axis options over to the first axis.
2059 for (var i = 0; i < axisOptions.length; i++) {
2060 var k = axisOptions[i];
2061 var v = this.attr_(k);
26ca7938 2062 if (v) this.axes_[0][k] = v;
f09fc545
DV
2063 }
2064
2065 // Go through once and add all the axes.
26ca7938
DV
2066 for (var seriesName in series) {
2067 if (!series.hasOwnProperty(seriesName)) continue;
f09fc545
DV
2068 var axis = this.attr_("axis", seriesName);
2069 if (axis == null) {
26ca7938 2070 this.seriesToAxisMap_[seriesName] = 0;
f09fc545
DV
2071 continue;
2072 }
2073 if (typeof(axis) == 'object') {
2074 // Add a new axis, making a copy of its per-axis options.
2075 var opts = {};
26ca7938 2076 Dygraph.update(opts, this.axes_[0]);
f09fc545
DV
2077 Dygraph.update(opts, { valueRange: null }); // shouldn't inherit this.
2078 Dygraph.update(opts, axis);
26ca7938
DV
2079 this.axes_.push(opts);
2080 this.seriesToAxisMap_[seriesName] = this.axes_.length - 1;
f09fc545
DV
2081 }
2082 }
2083
2084 // Go through one more time and assign series to an axis defined by another
2085 // series, e.g. { 'Y1: { axis: {} }, 'Y2': { axis: 'Y1' } }
26ca7938
DV
2086 for (var seriesName in series) {
2087 if (!series.hasOwnProperty(seriesName)) continue;
f09fc545
DV
2088 var axis = this.attr_("axis", seriesName);
2089 if (typeof(axis) == 'string') {
26ca7938 2090 if (!this.seriesToAxisMap_.hasOwnProperty(axis)) {
f09fc545
DV
2091 this.error("Series " + seriesName + " wants to share a y-axis with " +
2092 "series " + axis + ", which does not define its own axis.");
2093 return null;
2094 }
26ca7938
DV
2095 var idx = this.seriesToAxisMap_[axis];
2096 this.seriesToAxisMap_[seriesName] = idx;
f09fc545
DV
2097 }
2098 }
1c77a3a1
DV
2099
2100 // Now we remove series from seriesToAxisMap_ which are not visible. We do
2101 // this last so that hiding the first series doesn't destroy the axis
2102 // properties of the primary axis.
2103 var seriesToAxisFiltered = {};
2104 var vis = this.visibility();
2105 for (var i = 1; i < labels.length; i++) {
2106 var s = labels[i];
2107 if (vis[i - 1]) seriesToAxisFiltered[s] = this.seriesToAxisMap_[s];
2108 }
2109 this.seriesToAxisMap_ = seriesToAxisFiltered;
26ca7938
DV
2110};
2111
2112/**
2113 * Returns the number of y-axes on the chart.
2114 * @return {Number} the number of axes.
2115 */
2116Dygraph.prototype.numAxes = function() {
2117 var last_axis = 0;
2118 for (var series in this.seriesToAxisMap_) {
2119 if (!this.seriesToAxisMap_.hasOwnProperty(series)) continue;
2120 var idx = this.seriesToAxisMap_[series];
2121 if (idx > last_axis) last_axis = idx;
2122 }
2123 return 1 + last_axis;
2124};
2125
2126/**
2127 * Determine the value range and tick marks for each axis.
2128 * @param {Object} extremes A mapping from seriesName -> [low, high]
2129 * This fills in the valueRange and ticks fields in each entry of this.axes_.
2130 */
2131Dygraph.prototype.computeYAxisRanges_ = function(extremes) {
2132 // Build a map from axis number -> [list of series names]
2133 var seriesForAxis = [];
2134 for (var series in this.seriesToAxisMap_) {
2135 if (!this.seriesToAxisMap_.hasOwnProperty(series)) continue;
2136 var idx = this.seriesToAxisMap_[series];
2137 while (seriesForAxis.length <= idx) seriesForAxis.push([]);
2138 seriesForAxis[idx].push(series);
2139 }
f09fc545
DV
2140
2141 // Compute extreme values, a span and tick marks for each axis.
26ca7938
DV
2142 for (var i = 0; i < this.axes_.length; i++) {
2143 var axis = this.axes_[i];
d58ae307
DV
2144 if (axis.valueWindow) {
2145 // This is only set if the user has zoomed on the y-axis. It is never set
2146 // by a user. It takes precedence over axis.valueRange because, if you set
2147 // valueRange, you'd still expect to be able to pan.
2148 axis.computedValueRange = [axis.valueWindow[0], axis.valueWindow[1]];
2149 } else if (axis.valueRange) {
2150 // This is a user-set value range for this axis.
26ca7938
DV
2151 axis.computedValueRange = [axis.valueRange[0], axis.valueRange[1]];
2152 } else {
1c77a3a1 2153 // Calculate the extremes of extremes.
f09fc545
DV
2154 var series = seriesForAxis[i];
2155 var minY = Infinity; // extremes[series[0]][0];
2156 var maxY = -Infinity; // extremes[series[0]][1];
2157 for (var j = 0; j < series.length; j++) {
2158 minY = Math.min(extremes[series[j]][0], minY);
e3b6727e 2159 maxY = Math.max(extremes[series[j]][1], maxY);
f09fc545
DV
2160 }
2161 if (axis.includeZero && minY > 0) minY = 0;
2162
2163 // Add some padding and round up to an integer to be human-friendly.
2164 var span = maxY - minY;
2165 // special case: if we have no sense of scale, use +/-10% of the sole value.
2166 if (span == 0) { span = maxY; }
2167 var maxAxisY = maxY + 0.1 * span;
2168 var minAxisY = minY - 0.1 * span;
2169
2170 // Try to include zero and make it minAxisY (or maxAxisY) if it makes sense.
2f5e7e1a
DV
2171 if (!this.attr_("avoidMinZero")) {
2172 if (minAxisY < 0 && minY >= 0) minAxisY = 0;
2173 if (maxAxisY > 0 && maxY <= 0) maxAxisY = 0;
2174 }
f09fc545
DV
2175
2176 if (this.attr_("includeZero")) {
2177 if (maxY < 0) maxAxisY = 0;
2178 if (minY > 0) minAxisY = 0;
2179 }
2180
26ca7938 2181 axis.computedValueRange = [minAxisY, maxAxisY];
f09fc545
DV
2182 }
2183
0d64e596
DV
2184 // Add ticks. By default, all axes inherit the tick positions of the
2185 // primary axis. However, if an axis is specifically marked as having
2186 // independent ticks, then that is permissible as well.
2187 if (i == 0 || axis.independentTicks) {
3c1d225b 2188 var ret =
0d64e596
DV
2189 Dygraph.numericTicks(axis.computedValueRange[0],
2190 axis.computedValueRange[1],
2191 this,
2192 axis);
3c1d225b
JB
2193 axis.ticks = ret.ticks;
2194 this.numDigits_ = ret.numDigits;
0d64e596
DV
2195 } else {
2196 var p_axis = this.axes_[0];
2197 var p_ticks = p_axis.ticks;
2198 var p_scale = p_axis.computedValueRange[1] - p_axis.computedValueRange[0];
2199 var scale = axis.computedValueRange[1] - axis.computedValueRange[0];
2200 var tick_values = [];
2201 for (var i = 0; i < p_ticks.length; i++) {
2202 var y_frac = (p_ticks[i].v - p_axis.computedValueRange[0]) / p_scale;
2203 var y_val = axis.computedValueRange[0] + y_frac * scale;
2204 tick_values.push(y_val);
2205 }
2206
3c1d225b 2207 var ret =
0d64e596
DV
2208 Dygraph.numericTicks(axis.computedValueRange[0],
2209 axis.computedValueRange[1],
2210 this, axis, tick_values);
3c1d225b
JB
2211 axis.ticks = ret.ticks;
2212 this.numDigits_ = ret.numDigits;
0d64e596 2213 }
f09fc545 2214 }
f09fc545
DV
2215};
2216
2217/**
6a1aa64f
DV
2218 * Calculates the rolling average of a data set.
2219 * If originalData is [label, val], rolls the average of those.
2220 * If originalData is [label, [, it's interpreted as [value, stddev]
2221 * and the roll is returned in the same form, with appropriately reduced
2222 * stddev for each value.
2223 * Note that this is where fractional input (i.e. '5/10') is converted into
2224 * decimal values.
2225 * @param {Array} originalData The data in the appropriate format (see above)
3c1d225b
JB
2226 * @param {Number} rollPeriod The number of points over which to average the
2227 * data
6a1aa64f 2228 */
285a6bda 2229Dygraph.prototype.rollingAverage = function(originalData, rollPeriod) {
6a1aa64f
DV
2230 if (originalData.length < 2)
2231 return originalData;
2232 var rollPeriod = Math.min(rollPeriod, originalData.length - 1);
2233 var rollingData = [];
285a6bda 2234 var sigma = this.attr_("sigma");
6a1aa64f
DV
2235
2236 if (this.fractions_) {
2237 var num = 0;
2238 var den = 0; // numerator/denominator
2239 var mult = 100.0;
2240 for (var i = 0; i < originalData.length; i++) {
2241 num += originalData[i][1][0];
2242 den += originalData[i][1][1];
2243 if (i - rollPeriod >= 0) {
2244 num -= originalData[i - rollPeriod][1][0];
2245 den -= originalData[i - rollPeriod][1][1];
2246 }
2247
2248 var date = originalData[i][0];
2249 var value = den ? num / den : 0.0;
285a6bda 2250 if (this.attr_("errorBars")) {
6a1aa64f
DV
2251 if (this.wilsonInterval_) {
2252 // For more details on this confidence interval, see:
2253 // http://en.wikipedia.org/wiki/Binomial_confidence_interval
2254 if (den) {
2255 var p = value < 0 ? 0 : value, n = den;
2256 var pm = sigma * Math.sqrt(p*(1-p)/n + sigma*sigma/(4*n*n));
2257 var denom = 1 + sigma * sigma / den;
2258 var low = (p + sigma * sigma / (2 * den) - pm) / denom;
2259 var high = (p + sigma * sigma / (2 * den) + pm) / denom;
2260 rollingData[i] = [date,
2261 [p * mult, (p - low) * mult, (high - p) * mult]];
2262 } else {
2263 rollingData[i] = [date, [0, 0, 0]];
2264 }
2265 } else {
2266 var stddev = den ? sigma * Math.sqrt(value * (1 - value) / den) : 1.0;
2267 rollingData[i] = [date, [mult * value, mult * stddev, mult * stddev]];
2268 }
2269 } else {
2270 rollingData[i] = [date, mult * value];
2271 }
2272 }
9922b78b 2273 } else if (this.attr_("customBars")) {
f6885d6a
DV
2274 var low = 0;
2275 var mid = 0;
2276 var high = 0;
2277 var count = 0;
6a1aa64f
DV
2278 for (var i = 0; i < originalData.length; i++) {
2279 var data = originalData[i][1];
2280 var y = data[1];
2281 rollingData[i] = [originalData[i][0], [y, y - data[0], data[2] - y]];
f6885d6a 2282
8b91c51f 2283 if (y != null && !isNaN(y)) {
49a7d0d5
DV
2284 low += data[0];
2285 mid += y;
2286 high += data[2];
2287 count += 1;
2288 }
f6885d6a
DV
2289 if (i - rollPeriod >= 0) {
2290 var prev = originalData[i - rollPeriod];
8b91c51f 2291 if (prev[1][1] != null && !isNaN(prev[1][1])) {
49a7d0d5
DV
2292 low -= prev[1][0];
2293 mid -= prev[1][1];
2294 high -= prev[1][2];
2295 count -= 1;
2296 }
f6885d6a
DV
2297 }
2298 rollingData[i] = [originalData[i][0], [ 1.0 * mid / count,
2299 1.0 * (mid - low) / count,
2300 1.0 * (high - mid) / count ]];
2769de62 2301 }
6a1aa64f
DV
2302 } else {
2303 // Calculate the rolling average for the first rollPeriod - 1 points where
3c1d225b 2304 // there is not enough data to roll over the full number of points
6a1aa64f 2305 var num_init_points = Math.min(rollPeriod - 1, originalData.length - 2);
285a6bda 2306 if (!this.attr_("errorBars")){
5011e7a1
DV
2307 if (rollPeriod == 1) {
2308 return originalData;
2309 }
2310
2847c1cf 2311 for (var i = 0; i < originalData.length; i++) {
6a1aa64f 2312 var sum = 0;
5011e7a1 2313 var num_ok = 0;
2847c1cf
DV
2314 for (var j = Math.max(0, i - rollPeriod + 1); j < i + 1; j++) {
2315 var y = originalData[j][1];
8b91c51f 2316 if (y == null || isNaN(y)) continue;
5011e7a1 2317 num_ok++;
2847c1cf 2318 sum += originalData[j][1];
6a1aa64f 2319 }
5011e7a1 2320 if (num_ok) {
2847c1cf 2321 rollingData[i] = [originalData[i][0], sum / num_ok];
5011e7a1 2322 } else {
2847c1cf 2323 rollingData[i] = [originalData[i][0], null];
5011e7a1 2324 }
6a1aa64f 2325 }
2847c1cf
DV
2326
2327 } else {
2328 for (var i = 0; i < originalData.length; i++) {
6a1aa64f
DV
2329 var sum = 0;
2330 var variance = 0;
5011e7a1 2331 var num_ok = 0;
2847c1cf 2332 for (var j = Math.max(0, i - rollPeriod + 1); j < i + 1; j++) {
5011e7a1 2333 var y = originalData[j][1][0];
8b91c51f 2334 if (y == null || isNaN(y)) continue;
5011e7a1 2335 num_ok++;
6a1aa64f
DV
2336 sum += originalData[j][1][0];
2337 variance += Math.pow(originalData[j][1][1], 2);
2338 }
5011e7a1
DV
2339 if (num_ok) {
2340 var stddev = Math.sqrt(variance) / num_ok;
2341 rollingData[i] = [originalData[i][0],
2342 [sum / num_ok, sigma * stddev, sigma * stddev]];
2343 } else {
2344 rollingData[i] = [originalData[i][0], [null, null, null]];
2345 }
6a1aa64f
DV
2346 }
2347 }
2348 }
2349
2350 return rollingData;
2351};
2352
2353/**
2354 * Parses a date, returning the number of milliseconds since epoch. This can be
285a6bda
DV
2355 * passed in as an xValueParser in the Dygraph constructor.
2356 * TODO(danvk): enumerate formats that this understands.
6a1aa64f
DV
2357 * @param {String} A date in YYYYMMDD format.
2358 * @return {Number} Milliseconds since epoch.
2359 * @public
2360 */
285a6bda 2361Dygraph.dateParser = function(dateStr, self) {
6a1aa64f 2362 var dateStrSlashed;
285a6bda 2363 var d;
986a5026 2364 if (dateStr.search("-") != -1) { // e.g. '2009-7-12' or '2009-07-12'
6a1aa64f 2365 dateStrSlashed = dateStr.replace("-", "/", "g");
353a0294
DV
2366 while (dateStrSlashed.search("-") != -1) {
2367 dateStrSlashed = dateStrSlashed.replace("-", "/");
2368 }
285a6bda 2369 d = Date.parse(dateStrSlashed);
2769de62 2370 } else if (dateStr.length == 8) { // e.g. '20090712'
285a6bda 2371 // TODO(danvk): remove support for this format. It's confusing.
6a1aa64f
DV
2372 dateStrSlashed = dateStr.substr(0,4) + "/" + dateStr.substr(4,2)
2373 + "/" + dateStr.substr(6,2);
285a6bda 2374 d = Date.parse(dateStrSlashed);
2769de62
DV
2375 } else {
2376 // Any format that Date.parse will accept, e.g. "2009/07/12" or
2377 // "2009/07/12 12:34:56"
285a6bda
DV
2378 d = Date.parse(dateStr);
2379 }
2380
2381 if (!d || isNaN(d)) {
2382 self.error("Couldn't parse " + dateStr + " as a date");
2383 }
2384 return d;
2385};
2386
2387/**
2388 * Detects the type of the str (date or numeric) and sets the various
2389 * formatting attributes in this.attrs_ based on this type.
2390 * @param {String} str An x value.
2391 * @private
2392 */
2393Dygraph.prototype.detectTypeFromString_ = function(str) {
2394 var isDate = false;
2395 if (str.indexOf('-') >= 0 ||
2396 str.indexOf('/') >= 0 ||
2397 isNaN(parseFloat(str))) {
2398 isDate = true;
2399 } else if (str.length == 8 && str > '19700101' && str < '20371231') {
2400 // TODO(danvk): remove support for this format.
2401 isDate = true;
2402 }
2403
2404 if (isDate) {
2405 this.attrs_.xValueFormatter = Dygraph.dateString_;
2406 this.attrs_.xValueParser = Dygraph.dateParser;
2407 this.attrs_.xTicker = Dygraph.dateTicker;
bf640e56 2408 this.attrs_.xAxisLabelFormatter = Dygraph.dateAxisFormatter;
285a6bda
DV
2409 } else {
2410 this.attrs_.xValueFormatter = function(x) { return x; };
2411 this.attrs_.xValueParser = function(x) { return parseFloat(x); };
2412 this.attrs_.xTicker = Dygraph.numericTicks;
bf640e56 2413 this.attrs_.xAxisLabelFormatter = this.attrs_.xValueFormatter;
6a1aa64f 2414 }
6a1aa64f
DV
2415};
2416
2417/**
2418 * Parses a string in a special csv format. We expect a csv file where each
2419 * line is a date point, and the first field in each line is the date string.
2420 * We also expect that all remaining fields represent series.
285a6bda 2421 * if the errorBars attribute is set, then interpret the fields as:
6a1aa64f
DV
2422 * date, series1, stddev1, series2, stddev2, ...
2423 * @param {Array.<Object>} data See above.
2424 * @private
285a6bda
DV
2425 *
2426 * @return Array.<Object> An array with one entry for each row. These entries
2427 * are an array of cells in that row. The first entry is the parsed x-value for
2428 * the row. The second, third, etc. are the y-values. These can take on one of
2429 * three forms, depending on the CSV and constructor parameters:
2430 * 1. numeric value
2431 * 2. [ value, stddev ]
2432 * 3. [ low value, center value, high value ]
6a1aa64f 2433 */
285a6bda 2434Dygraph.prototype.parseCSV_ = function(data) {
6a1aa64f
DV
2435 var ret = [];
2436 var lines = data.split("\n");
3d67f03b
DV
2437
2438 // Use the default delimiter or fall back to a tab if that makes sense.
2439 var delim = this.attr_('delimiter');
2440 if (lines[0].indexOf(delim) == -1 && lines[0].indexOf('\t') >= 0) {
2441 delim = '\t';
2442 }
2443
285a6bda 2444 var start = 0;
6a1aa64f 2445 if (this.labelsFromCSV_) {
285a6bda 2446 start = 1;
3d67f03b 2447 this.attrs_.labels = lines[0].split(delim);
6a1aa64f
DV
2448 }
2449
03b522a4
DV
2450 // Parse the x as a float or return null if it's not a number.
2451 var parseFloatOrNull = function(x) {
41333ec0 2452 var val = parseFloat(x);
1f7f664b
DV
2453 // isFinite() returns false for NaN and +/-Infinity.
2454 return isFinite(val) ? val : null;
03b522a4
DV
2455 };
2456
285a6bda
DV
2457 var xParser;
2458 var defaultParserSet = false; // attempt to auto-detect x value type
2459 var expectedCols = this.attr_("labels").length;
987840a2 2460 var outOfOrder = false;
6a1aa64f
DV
2461 for (var i = start; i < lines.length; i++) {
2462 var line = lines[i];
2463 if (line.length == 0) continue; // skip blank lines
3d67f03b
DV
2464 if (line[0] == '#') continue; // skip comment lines
2465 var inFields = line.split(delim);
285a6bda 2466 if (inFields.length < 2) continue;
6a1aa64f
DV
2467
2468 var fields = [];
285a6bda
DV
2469 if (!defaultParserSet) {
2470 this.detectTypeFromString_(inFields[0]);
2471 xParser = this.attr_("xValueParser");
2472 defaultParserSet = true;
2473 }
2474 fields[0] = xParser(inFields[0], this);
6a1aa64f
DV
2475
2476 // If fractions are expected, parse the numbers as "A/B"
2477 if (this.fractions_) {
2478 for (var j = 1; j < inFields.length; j++) {
2479 // TODO(danvk): figure out an appropriate way to flag parse errors.
2480 var vals = inFields[j].split("/");
03b522a4 2481 fields[j] = [parseFloatOrNull(vals[0]), parseFloatOrNull(vals[1])];
6a1aa64f 2482 }
285a6bda 2483 } else if (this.attr_("errorBars")) {
6a1aa64f
DV
2484 // If there are error bars, values are (value, stddev) pairs
2485 for (var j = 1; j < inFields.length; j += 2)
03b522a4
DV
2486 fields[(j + 1) / 2] = [parseFloatOrNull(inFields[j]),
2487 parseFloatOrNull(inFields[j + 1])];
9922b78b 2488 } else if (this.attr_("customBars")) {
6a1aa64f
DV
2489 // Bars are a low;center;high tuple
2490 for (var j = 1; j < inFields.length; j++) {
2491 var vals = inFields[j].split(";");
03b522a4
DV
2492 fields[j] = [ parseFloatOrNull(vals[0]),
2493 parseFloatOrNull(vals[1]),
2494 parseFloatOrNull(vals[2]) ];
6a1aa64f
DV
2495 }
2496 } else {
2497 // Values are just numbers
285a6bda 2498 for (var j = 1; j < inFields.length; j++) {
03b522a4 2499 fields[j] = parseFloatOrNull(inFields[j]);
285a6bda 2500 }
6a1aa64f 2501 }
987840a2
DV
2502 if (ret.length > 0 && fields[0] < ret[ret.length - 1][0]) {
2503 outOfOrder = true;
2504 }
6a1aa64f 2505 ret.push(fields);
285a6bda
DV
2506
2507 if (fields.length != expectedCols) {
2508 this.error("Number of columns in line " + i + " (" + fields.length +
2509 ") does not agree with number of labels (" + expectedCols +
2510 ") " + line);
2511 }
6a1aa64f 2512 }
987840a2
DV
2513
2514 if (outOfOrder) {
2515 this.warn("CSV is out of order; order it correctly to speed loading.");
2516 ret.sort(function(a,b) { return a[0] - b[0] });
2517 }
2518
6a1aa64f
DV
2519 return ret;
2520};
2521
2522/**
285a6bda
DV
2523 * The user has provided their data as a pre-packaged JS array. If the x values
2524 * are numeric, this is the same as dygraphs' internal format. If the x values
2525 * are dates, we need to convert them from Date objects to ms since epoch.
2526 * @param {Array.<Object>} data
2527 * @return {Array.<Object>} data with numeric x values.
2528 */
2529Dygraph.prototype.parseArray_ = function(data) {
2530 // Peek at the first x value to see if it's numeric.
2531 if (data.length == 0) {
2532 this.error("Can't plot empty data set");
2533 return null;
2534 }
2535 if (data[0].length == 0) {
2536 this.error("Data set cannot contain an empty row");
2537 return null;
2538 }
2539
2540 if (this.attr_("labels") == null) {
2541 this.warn("Using default labels. Set labels explicitly via 'labels' " +
2542 "in the options parameter");
2543 this.attrs_.labels = [ "X" ];
2544 for (var i = 1; i < data[0].length; i++) {
2545 this.attrs_.labels.push("Y" + i);
2546 }
2547 }
2548
2dda3850 2549 if (Dygraph.isDateLike(data[0][0])) {
285a6bda
DV
2550 // Some intelligent defaults for a date x-axis.
2551 this.attrs_.xValueFormatter = Dygraph.dateString_;
bf640e56 2552 this.attrs_.xAxisLabelFormatter = Dygraph.dateAxisFormatter;
285a6bda
DV
2553 this.attrs_.xTicker = Dygraph.dateTicker;
2554
2555 // Assume they're all dates.
e3ab7b40 2556 var parsedData = Dygraph.clone(data);
285a6bda
DV
2557 for (var i = 0; i < data.length; i++) {
2558 if (parsedData[i].length == 0) {
a323ff4a 2559 this.error("Row " + (1 + i) + " of data is empty");
285a6bda
DV
2560 return null;
2561 }
2562 if (parsedData[i][0] == null
3a909ec5
DV
2563 || typeof(parsedData[i][0].getTime) != 'function'
2564 || isNaN(parsedData[i][0].getTime())) {
be96a1f5 2565 this.error("x value in row " + (1 + i) + " is not a Date");
285a6bda
DV
2566 return null;
2567 }
2568 parsedData[i][0] = parsedData[i][0].getTime();
2569 }
2570 return parsedData;
2571 } else {
2572 // Some intelligent defaults for a numeric x-axis.
2573 this.attrs_.xValueFormatter = function(x) { return x; };
2574 this.attrs_.xTicker = Dygraph.numericTicks;
2575 return data;
2576 }
2577};
2578
2579/**
79420a1e
DV
2580 * Parses a DataTable object from gviz.
2581 * The data is expected to have a first column that is either a date or a
2582 * number. All subsequent columns must be numbers. If there is a clear mismatch
2583 * between this.xValueParser_ and the type of the first column, it will be
a685723c 2584 * fixed. Fills out rawData_.
79420a1e
DV
2585 * @param {Array.<Object>} data See above.
2586 * @private
2587 */
285a6bda 2588Dygraph.prototype.parseDataTable_ = function(data) {
79420a1e
DV
2589 var cols = data.getNumberOfColumns();
2590 var rows = data.getNumberOfRows();
2591
d955e223 2592 var indepType = data.getColumnType(0);
4440f6c8 2593 if (indepType == 'date' || indepType == 'datetime') {
285a6bda
DV
2594 this.attrs_.xValueFormatter = Dygraph.dateString_;
2595 this.attrs_.xValueParser = Dygraph.dateParser;
2596 this.attrs_.xTicker = Dygraph.dateTicker;
bf640e56 2597 this.attrs_.xAxisLabelFormatter = Dygraph.dateAxisFormatter;
33127159 2598 } else if (indepType == 'number') {
285a6bda
DV
2599 this.attrs_.xValueFormatter = function(x) { return x; };
2600 this.attrs_.xValueParser = function(x) { return parseFloat(x); };
2601 this.attrs_.xTicker = Dygraph.numericTicks;
bf640e56 2602 this.attrs_.xAxisLabelFormatter = this.attrs_.xValueFormatter;
285a6bda 2603 } else {
987840a2
DV
2604 this.error("only 'date', 'datetime' and 'number' types are supported for " +
2605 "column 1 of DataTable input (Got '" + indepType + "')");
79420a1e
DV
2606 return null;
2607 }
2608
a685723c
DV
2609 // Array of the column indices which contain data (and not annotations).
2610 var colIdx = [];
2611 var annotationCols = {}; // data index -> [annotation cols]
2612 var hasAnnotations = false;
2613 for (var i = 1; i < cols; i++) {
2614 var type = data.getColumnType(i);
2615 if (type == 'number') {
2616 colIdx.push(i);
2617 } else if (type == 'string' && this.attr_('displayAnnotations')) {
2618 // This is OK -- it's an annotation column.
2619 var dataIdx = colIdx[colIdx.length - 1];
2620 if (!annotationCols.hasOwnProperty(dataIdx)) {
2621 annotationCols[dataIdx] = [i];
2622 } else {
2623 annotationCols[dataIdx].push(i);
2624 }
2625 hasAnnotations = true;
2626 } else {
2627 this.error("Only 'number' is supported as a dependent type with Gviz." +
2628 " 'string' is only supported if displayAnnotations is true");
2629 }
2630 }
2631
2632 // Read column labels
2633 // TODO(danvk): add support back for errorBars
2634 var labels = [data.getColumnLabel(0)];
2635 for (var i = 0; i < colIdx.length; i++) {
2636 labels.push(data.getColumnLabel(colIdx[i]));
f9348814 2637 if (this.attr_("errorBars")) i += 1;
a685723c
DV
2638 }
2639 this.attrs_.labels = labels;
2640 cols = labels.length;
2641
79420a1e 2642 var ret = [];
987840a2 2643 var outOfOrder = false;
a685723c 2644 var annotations = [];
79420a1e
DV
2645 for (var i = 0; i < rows; i++) {
2646 var row = [];
debe4434
DV
2647 if (typeof(data.getValue(i, 0)) === 'undefined' ||
2648 data.getValue(i, 0) === null) {
129569a5
FD
2649 this.warn("Ignoring row " + i +
2650 " of DataTable because of undefined or null first column.");
debe4434
DV
2651 continue;
2652 }
2653
c21d2c2d 2654 if (indepType == 'date' || indepType == 'datetime') {
d955e223
DV
2655 row.push(data.getValue(i, 0).getTime());
2656 } else {
2657 row.push(data.getValue(i, 0));
2658 }
3e3f84e4 2659 if (!this.attr_("errorBars")) {
a685723c
DV
2660 for (var j = 0; j < colIdx.length; j++) {
2661 var col = colIdx[j];
2662 row.push(data.getValue(i, col));
2663 if (hasAnnotations &&
2664 annotationCols.hasOwnProperty(col) &&
2665 data.getValue(i, annotationCols[col][0]) != null) {
2666 var ann = {};
2667 ann.series = data.getColumnLabel(col);
2668 ann.xval = row[0];
2669 ann.shortText = String.fromCharCode(65 /* A */ + annotations.length)
2670 ann.text = '';
2671 for (var k = 0; k < annotationCols[col].length; k++) {
2672 if (k) ann.text += "\n";
2673 ann.text += data.getValue(i, annotationCols[col][k]);
2674 }
2675 annotations.push(ann);
2676 }
3e3f84e4
DV
2677 }
2678 } else {
2679 for (var j = 0; j < cols - 1; j++) {
2680 row.push([ data.getValue(i, 1 + 2 * j), data.getValue(i, 2 + 2 * j) ]);
2681 }
79420a1e 2682 }
987840a2
DV
2683 if (ret.length > 0 && row[0] < ret[ret.length - 1][0]) {
2684 outOfOrder = true;
2685 }
1f7f664b
DV
2686
2687 // Strip out infinities, which give dygraphs problems later on.
2688 for (var j = 0; j < row.length; j++) {
2689 if (!isFinite(row[j])) row[j] = null;
2690 }
243d96e8 2691 ret.push(row);
79420a1e 2692 }
987840a2
DV
2693
2694 if (outOfOrder) {
2695 this.warn("DataTable is out of order; order it correctly to speed loading.");
2696 ret.sort(function(a,b) { return a[0] - b[0] });
2697 }
a685723c
DV
2698 this.rawData_ = ret;
2699
2700 if (annotations.length > 0) {
2701 this.setAnnotations(annotations, true);
2702 }
79420a1e
DV
2703}
2704
24e5350c 2705// These functions are all based on MochiKit.
fc80a396
DV
2706Dygraph.update = function (self, o) {
2707 if (typeof(o) != 'undefined' && o !== null) {
2708 for (var k in o) {
85b99f0b
DV
2709 if (o.hasOwnProperty(k)) {
2710 self[k] = o[k];
2711 }
fc80a396
DV
2712 }
2713 }
2714 return self;
2715};
2716
2dda3850
DV
2717Dygraph.isArrayLike = function (o) {
2718 var typ = typeof(o);
2719 if (
c21d2c2d 2720 (typ != 'object' && !(typ == 'function' &&
2dda3850
DV
2721 typeof(o.item) == 'function')) ||
2722 o === null ||
2723 typeof(o.length) != 'number' ||
2724 o.nodeType === 3
2725 ) {
2726 return false;
2727 }
2728 return true;
2729};
2730
2731Dygraph.isDateLike = function (o) {
2732 if (typeof(o) != "object" || o === null ||
2733 typeof(o.getTime) != 'function') {
2734 return false;
2735 }
2736 return true;
2737};
2738
e3ab7b40
DV
2739Dygraph.clone = function(o) {
2740 // TODO(danvk): figure out how MochiKit's version works
2741 var r = [];
2742 for (var i = 0; i < o.length; i++) {
2743 if (Dygraph.isArrayLike(o[i])) {
2744 r.push(Dygraph.clone(o[i]));
2745 } else {
2746 r.push(o[i]);
2747 }
2748 }
2749 return r;
24e5350c
DV
2750};
2751
2dda3850 2752
79420a1e 2753/**
6a1aa64f
DV
2754 * Get the CSV data. If it's in a function, call that function. If it's in a
2755 * file, do an XMLHttpRequest to get it.
2756 * @private
2757 */
285a6bda 2758Dygraph.prototype.start_ = function() {
6a1aa64f 2759 if (typeof this.file_ == 'function') {
285a6bda 2760 // CSV string. Pretend we got it via XHR.
6a1aa64f 2761 this.loadedEvent_(this.file_());
2dda3850 2762 } else if (Dygraph.isArrayLike(this.file_)) {
285a6bda 2763 this.rawData_ = this.parseArray_(this.file_);
26ca7938 2764 this.predraw_();
79420a1e
DV
2765 } else if (typeof this.file_ == 'object' &&
2766 typeof this.file_.getColumnRange == 'function') {
2767 // must be a DataTable from gviz.
a685723c 2768 this.parseDataTable_(this.file_);
26ca7938 2769 this.predraw_();
285a6bda
DV
2770 } else if (typeof this.file_ == 'string') {
2771 // Heuristic: a newline means it's CSV data. Otherwise it's an URL.
2772 if (this.file_.indexOf('\n') >= 0) {
2773 this.loadedEvent_(this.file_);
2774 } else {
2775 var req = new XMLHttpRequest();
2776 var caller = this;
2777 req.onreadystatechange = function () {
2778 if (req.readyState == 4) {
2779 if (req.status == 200) {
2780 caller.loadedEvent_(req.responseText);
2781 }
6a1aa64f 2782 }
285a6bda 2783 };
6a1aa64f 2784
285a6bda
DV
2785 req.open("GET", this.file_, true);
2786 req.send(null);
2787 }
2788 } else {
2789 this.error("Unknown data format: " + (typeof this.file_));
6a1aa64f
DV
2790 }
2791};
2792
2793/**
2794 * Changes various properties of the graph. These can include:
2795 * <ul>
2796 * <li>file: changes the source data for the graph</li>
2797 * <li>errorBars: changes whether the data contains stddev</li>
2798 * </ul>
2799 * @param {Object} attrs The new properties and values
2800 */
285a6bda
DV
2801Dygraph.prototype.updateOptions = function(attrs) {
2802 // TODO(danvk): this is a mess. Rethink this function.
c65f2303 2803 if ('rollPeriod' in attrs) {
6a1aa64f
DV
2804 this.rollPeriod_ = attrs.rollPeriod;
2805 }
c65f2303 2806 if ('dateWindow' in attrs) {
6a1aa64f
DV
2807 this.dateWindow_ = attrs.dateWindow;
2808 }
450fe64b
DV
2809
2810 // TODO(danvk): validate per-series options.
46dde5f9
DV
2811 // Supported:
2812 // strokeWidth
2813 // pointSize
2814 // drawPoints
2815 // highlightCircleSize
450fe64b 2816
fc80a396 2817 Dygraph.update(this.user_attrs_, attrs);
87bb7958 2818 Dygraph.update(this.renderOptions_, attrs);
285a6bda
DV
2819
2820 this.labelsFromCSV_ = (this.attr_("labels") == null);
2821
2822 // TODO(danvk): this doesn't match the constructor logic
2823 this.layout_.updateOptions({ 'errorBars': this.attr_("errorBars") });
5e50289f 2824 if (attrs['file']) {
6a1aa64f
DV
2825 this.file_ = attrs['file'];
2826 this.start_();
2827 } else {
26ca7938 2828 this.predraw_();
6a1aa64f
DV
2829 }
2830};
2831
2832/**
697e70b2
DV
2833 * Resizes the dygraph. If no parameters are specified, resizes to fill the
2834 * containing div (which has presumably changed size since the dygraph was
2835 * instantiated. If the width/height are specified, the div will be resized.
964f30c6
DV
2836 *
2837 * This is far more efficient than destroying and re-instantiating a
2838 * Dygraph, since it doesn't have to reparse the underlying data.
2839 *
697e70b2
DV
2840 * @param {Number} width Width (in pixels)
2841 * @param {Number} height Height (in pixels)
2842 */
2843Dygraph.prototype.resize = function(width, height) {
e8c7ef86
DV
2844 if (this.resize_lock) {
2845 return;
2846 }
2847 this.resize_lock = true;
2848
697e70b2
DV
2849 if ((width === null) != (height === null)) {
2850 this.warn("Dygraph.resize() should be called with zero parameters or " +
2851 "two non-NULL parameters. Pretending it was zero.");
2852 width = height = null;
2853 }
2854
b16e6369 2855 // TODO(danvk): there should be a clear() method.
697e70b2 2856 this.maindiv_.innerHTML = "";
b16e6369
DV
2857 this.attrs_.labelsDiv = null;
2858
697e70b2
DV
2859 if (width) {
2860 this.maindiv_.style.width = width + "px";
2861 this.maindiv_.style.height = height + "px";
2862 this.width_ = width;
2863 this.height_ = height;
2864 } else {
2865 this.width_ = this.maindiv_.offsetWidth;
2866 this.height_ = this.maindiv_.offsetHeight;
2867 }
2868
2869 this.createInterface_();
26ca7938 2870 this.predraw_();
e8c7ef86
DV
2871
2872 this.resize_lock = false;
697e70b2
DV
2873};
2874
2875/**
3c1d225b 2876 * Adjusts the number of points in the rolling average. Updates the graph to
6a1aa64f 2877 * reflect the new averaging period.
3c1d225b 2878 * @param {Number} length Number of points over which to average the data.
6a1aa64f 2879 */
285a6bda 2880Dygraph.prototype.adjustRoll = function(length) {
6a1aa64f 2881 this.rollPeriod_ = length;
26ca7938 2882 this.predraw_();
6a1aa64f 2883};
540d00f1 2884
f8cfec73 2885/**
1cf11047
DV
2886 * Returns a boolean array of visibility statuses.
2887 */
2888Dygraph.prototype.visibility = function() {
2889 // Do lazy-initialization, so that this happens after we know the number of
2890 // data series.
2891 if (!this.attr_("visibility")) {
f38dec01 2892 this.attrs_["visibility"] = [];
1cf11047
DV
2893 }
2894 while (this.attr_("visibility").length < this.rawData_[0].length - 1) {
f38dec01 2895 this.attr_("visibility").push(true);
1cf11047
DV
2896 }
2897 return this.attr_("visibility");
2898};
2899
2900/**
2901 * Changes the visiblity of a series.
2902 */
2903Dygraph.prototype.setVisibility = function(num, value) {
2904 var x = this.visibility();
a6c109c1 2905 if (num < 0 || num >= x.length) {
1cf11047
DV
2906 this.warn("invalid series number in setVisibility: " + num);
2907 } else {
2908 x[num] = value;
26ca7938 2909 this.predraw_();
1cf11047
DV
2910 }
2911};
2912
2913/**
5c528fa2
DV
2914 * Update the list of annotations and redraw the chart.
2915 */
a685723c 2916Dygraph.prototype.setAnnotations = function(ann, suppressDraw) {
3c51ab74
DV
2917 // Only add the annotation CSS rule once we know it will be used.
2918 Dygraph.addAnnotationRule();
5c528fa2
DV
2919 this.annotations_ = ann;
2920 this.layout_.setAnnotations(this.annotations_);
a685723c 2921 if (!suppressDraw) {
26ca7938 2922 this.predraw_();
a685723c 2923 }
5c528fa2
DV
2924};
2925
2926/**
2927 * Return the list of annotations.
2928 */
2929Dygraph.prototype.annotations = function() {
2930 return this.annotations_;
2931};
2932
46dde5f9
DV
2933/**
2934 * Get the index of a series (column) given its name. The first column is the
2935 * x-axis, so the data series start with index 1.
2936 */
2937Dygraph.prototype.indexFromSetName = function(name) {
2938 var labels = this.attr_("labels");
2939 for (var i = 0; i < labels.length; i++) {
2940 if (labels[i] == name) return i;
2941 }
2942 return null;
2943};
2944
5c528fa2
DV
2945Dygraph.addAnnotationRule = function() {
2946 if (Dygraph.addedAnnotationCSS) return;
2947
5c528fa2
DV
2948 var rule = "border: 1px solid black; " +
2949 "background-color: white; " +
2950 "text-align: center;";
22186871
DV
2951
2952 var styleSheetElement = document.createElement("style");
2953 styleSheetElement.type = "text/css";
2954 document.getElementsByTagName("head")[0].appendChild(styleSheetElement);
2955
2956 // Find the first style sheet that we can access.
2957 // We may not add a rule to a style sheet from another domain for security
2958 // reasons. This sometimes comes up when using gviz, since the Google gviz JS
2959 // adds its own style sheets from google.com.
2960 for (var i = 0; i < document.styleSheets.length; i++) {
2961 if (document.styleSheets[i].disabled) continue;
2962 var mysheet = document.styleSheets[i];
2963 try {
2964 if (mysheet.insertRule) { // Firefox
2965 var idx = mysheet.cssRules ? mysheet.cssRules.length : 0;
2966 mysheet.insertRule(".dygraphDefaultAnnotation { " + rule + " }", idx);
2967 } else if (mysheet.addRule) { // IE
2968 mysheet.addRule(".dygraphDefaultAnnotation", rule);
2969 }
2970 Dygraph.addedAnnotationCSS = true;
2971 return;
2972 } catch(err) {
2973 // Was likely a security exception.
2974 }
5c528fa2
DV
2975 }
2976
22186871 2977 this.warn("Unable to add default annotation CSS rule; display may be off.");
5c528fa2
DV
2978}
2979
2980/**
f8cfec73
DV
2981 * Create a new canvas element. This is more complex than a simple
2982 * document.createElement("canvas") because of IE and excanvas.
2983 */
2984Dygraph.createCanvas = function() {
2985 var canvas = document.createElement("canvas");
2986
2987 isIE = (/MSIE/.test(navigator.userAgent) && !window.opera);
8b8f2d59 2988 if (isIE && (typeof(G_vmlCanvasManager) != 'undefined')) {
f8cfec73
DV
2989 canvas = G_vmlCanvasManager.initElement(canvas);
2990 }
2991
2992 return canvas;
2993};
2994
540d00f1
DV
2995
2996/**
285a6bda 2997 * A wrapper around Dygraph that implements the gviz API.
540d00f1
DV
2998 * @param {Object} container The DOM object the visualization should live in.
2999 */
285a6bda 3000Dygraph.GVizChart = function(container) {
540d00f1
DV
3001 this.container = container;
3002}
3003
285a6bda 3004Dygraph.GVizChart.prototype.draw = function(data, options) {
c91f4ae8
DV
3005 // Clear out any existing dygraph.
3006 // TODO(danvk): would it make more sense to simply redraw using the current
3007 // date_graph object?
540d00f1 3008 this.container.innerHTML = '';
c91f4ae8
DV
3009 if (typeof(this.date_graph) != 'undefined') {
3010 this.date_graph.destroy();
3011 }
3012
285a6bda 3013 this.date_graph = new Dygraph(this.container, data, options);
540d00f1 3014}
285a6bda 3015
239c712d
NAG
3016/**
3017 * Google charts compatible setSelection
50360fd0 3018 * Only row selection is supported, all points in the row will be highlighted
239c712d
NAG
3019 * @param {Array} array of the selected cells
3020 * @public
3021 */
3022Dygraph.GVizChart.prototype.setSelection = function(selection_array) {
3023 var row = false;
3024 if (selection_array.length) {
3025 row = selection_array[0].row;
3026 }
3027 this.date_graph.setSelection(row);
3028}
3029
103b7292
NAG
3030/**
3031 * Google charts compatible getSelection implementation
3032 * @return {Array} array of the selected cells
3033 * @public
3034 */
3035Dygraph.GVizChart.prototype.getSelection = function() {
3036 var selection = [];
50360fd0 3037
103b7292 3038 var row = this.date_graph.getSelection();
50360fd0 3039
103b7292 3040 if (row < 0) return selection;
50360fd0 3041
103b7292
NAG
3042 col = 1;
3043 for (var i in this.date_graph.layout_.datasets) {
3044 selection.push({row: row, column: col});
3045 col++;
3046 }
3047
3048 return selection;
3049}
3050
285a6bda
DV
3051// Older pages may still use this name.
3052DateGraph = Dygraph;