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