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