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