Removed comma in zoom.html, removed "C,D" in data.js.
[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
129 stepPlot: false
285a6bda
DV
130};
131
132// Various logging levels.
133Dygraph.DEBUG = 1;
134Dygraph.INFO = 2;
135Dygraph.WARNING = 3;
136Dygraph.ERROR = 3;
137
39b0e098
RK
138// Directions for panning and zooming. Use bit operations when combined
139// values are possible.
140Dygraph.HORIZONTAL = 1;
141Dygraph.VERTICAL = 2;
142
5c528fa2
DV
143// Used for initializing annotation CSS rules only once.
144Dygraph.addedAnnotationCSS = false;
145
285a6bda
DV
146Dygraph.prototype.__old_init__ = function(div, file, labels, attrs) {
147 // Labels is no longer a constructor parameter, since it's typically set
148 // directly from the data source. It also conains a name for the x-axis,
149 // which the previous constructor form did not.
150 if (labels != null) {
151 var new_labels = ["Date"];
152 for (var i = 0; i < labels.length; i++) new_labels.push(labels[i]);
fc80a396 153 Dygraph.update(attrs, { 'labels': new_labels });
285a6bda
DV
154 }
155 this.__init__(div, file, attrs);
8e4a6af3
DV
156};
157
6a1aa64f 158/**
285a6bda 159 * Initializes the Dygraph. This creates a new DIV and constructs the PlotKit
6a1aa64f
DV
160 * and interaction &lt;canvas&gt; inside of it. See the constructor for details
161 * on the parameters.
12e4c741 162 * @param {Element} div the Element to render the graph into.
6a1aa64f 163 * @param {String | Function} file Source data
6a1aa64f
DV
164 * @param {Object} attrs Miscellaneous other options
165 * @private
166 */
285a6bda
DV
167Dygraph.prototype.__init__ = function(div, file, attrs) {
168 // Support two-argument constructor
169 if (attrs == null) { attrs = {}; }
170
6a1aa64f 171 // Copy the important bits into the object
32988383 172 // TODO(danvk): most of these should just stay in the attrs_ dictionary.
6a1aa64f 173 this.maindiv_ = div;
6a1aa64f 174 this.file_ = file;
285a6bda 175 this.rollPeriod_ = attrs.rollPeriod || Dygraph.DEFAULT_ROLL_PERIOD;
6a1aa64f 176 this.previousVerticalX_ = -1;
6a1aa64f 177 this.fractions_ = attrs.fractions || false;
6a1aa64f 178 this.dateWindow_ = attrs.dateWindow || null;
8b83c6cc
RK
179 // valueRange and valueWindow are similar, but not the same. valueRange is a
180 // locally-stored copy of the attribute. valueWindow starts off the same as
181 // valueRange but is impacted by zoom or pan effects. valueRange is kept
182 // around to restore the original value back to valueRange.
6a1aa64f 183 this.valueRange_ = attrs.valueRange || null;
8b83c6cc
RK
184 this.valueWindow_ = this.valueRange_;
185
6a1aa64f 186 this.wilsonInterval_ = attrs.wilsonInterval || true;
fe0b7c03 187 this.is_initial_draw_ = true;
5c528fa2 188 this.annotations_ = [];
8e4a6af3 189
f7d6278e
DV
190 // Clear the div. This ensure that, if multiple dygraphs are passed the same
191 // div, then only one will be drawn.
192 div.innerHTML = "";
193
c21d2c2d 194 // If the div isn't already sized then inherit from our attrs or
195 // give it a default size.
285a6bda 196 if (div.style.width == '') {
c21d2c2d 197 div.style.width = attrs.width || Dygraph.DEFAULT_WIDTH + "px";
285a6bda
DV
198 }
199 if (div.style.height == '') {
c21d2c2d 200 div.style.height = attrs.height || Dygraph.DEFAULT_HEIGHT + "px";
32988383 201 }
285a6bda
DV
202 this.width_ = parseInt(div.style.width, 10);
203 this.height_ = parseInt(div.style.height, 10);
c21d2c2d 204 // The div might have been specified as percent of the current window size,
205 // convert that to an appropriate number of pixels.
206 if (div.style.width.indexOf("%") == div.style.width.length - 1) {
c6f45033 207 this.width_ = div.offsetWidth;
c21d2c2d 208 }
209 if (div.style.height.indexOf("%") == div.style.height.length - 1) {
c6f45033 210 this.height_ = div.offsetHeight;
c21d2c2d 211 }
32988383 212
10a6456d
DV
213 if (this.width_ == 0) {
214 this.error("dygraph has zero width. Please specify a width in pixels.");
215 }
216 if (this.height_ == 0) {
217 this.error("dygraph has zero height. Please specify a height in pixels.");
218 }
219
344ba8c0 220 // TODO(danvk): set fillGraph to be part of attrs_ here, not user_attrs_.
43af96e7
NK
221 if (attrs['stackedGraph']) {
222 attrs['fillGraph'] = true;
223 // TODO(nikhilk): Add any other stackedGraph checks here.
224 }
225
285a6bda
DV
226 // Dygraphs has many options, some of which interact with one another.
227 // To keep track of everything, we maintain two sets of options:
228 //
c21d2c2d 229 // this.user_attrs_ only options explicitly set by the user.
285a6bda
DV
230 // this.attrs_ defaults, options derived from user_attrs_, data.
231 //
232 // Options are then accessed this.attr_('attr'), which first looks at
233 // user_attrs_ and then computed attrs_. This way Dygraphs can set intelligent
234 // defaults without overriding behavior that the user specifically asks for.
235 this.user_attrs_ = {};
fc80a396 236 Dygraph.update(this.user_attrs_, attrs);
6a1aa64f 237
285a6bda 238 this.attrs_ = {};
fc80a396 239 Dygraph.update(this.attrs_, Dygraph.DEFAULT_ATTRS);
6a1aa64f 240
16269f6e 241 this.boundaryIds_ = [];
6a1aa64f 242
285a6bda
DV
243 // Make a note of whether labels will be pulled from the CSV file.
244 this.labelsFromCSV_ = (this.attr_("labels") == null);
6a1aa64f 245
5c528fa2
DV
246 Dygraph.addAnnotationRule();
247
6a1aa64f
DV
248 // Create the containing DIV and other interactive elements
249 this.createInterface_();
250
738fc797 251 this.start_();
6a1aa64f
DV
252};
253
227b93cc
DV
254Dygraph.prototype.attr_ = function(name, seriesName) {
255 if (seriesName &&
256 typeof(this.user_attrs_[seriesName]) != 'undefined' &&
257 this.user_attrs_[seriesName] != null &&
258 typeof(this.user_attrs_[seriesName][name]) != 'undefined') {
259 return this.user_attrs_[seriesName][name];
450fe64b 260 } else if (typeof(this.user_attrs_[name]) != 'undefined') {
285a6bda
DV
261 return this.user_attrs_[name];
262 } else if (typeof(this.attrs_[name]) != 'undefined') {
263 return this.attrs_[name];
264 } else {
265 return null;
266 }
267};
268
269// TODO(danvk): any way I can get the line numbers to be this.warn call?
270Dygraph.prototype.log = function(severity, message) {
271 if (typeof(console) != 'undefined') {
272 switch (severity) {
273 case Dygraph.DEBUG:
274 console.debug('dygraphs: ' + message);
275 break;
276 case Dygraph.INFO:
277 console.info('dygraphs: ' + message);
278 break;
279 case Dygraph.WARNING:
280 console.warn('dygraphs: ' + message);
281 break;
282 case Dygraph.ERROR:
283 console.error('dygraphs: ' + message);
284 break;
285 }
286 }
287}
288Dygraph.prototype.info = function(message) {
289 this.log(Dygraph.INFO, message);
290}
291Dygraph.prototype.warn = function(message) {
292 this.log(Dygraph.WARNING, message);
293}
294Dygraph.prototype.error = function(message) {
295 this.log(Dygraph.ERROR, message);
296}
297
6a1aa64f
DV
298/**
299 * Returns the current rolling period, as set by the user or an option.
300 * @return {Number} The number of days in the rolling window
301 */
285a6bda 302Dygraph.prototype.rollPeriod = function() {
6a1aa64f 303 return this.rollPeriod_;
76171648
DV
304};
305
599fb4ad
DV
306/**
307 * Returns the currently-visible x-range. This can be affected by zooming,
308 * panning or a call to updateOptions.
309 * Returns a two-element array: [left, right].
310 * If the Dygraph has dates on the x-axis, these will be millis since epoch.
311 */
312Dygraph.prototype.xAxisRange = function() {
313 if (this.dateWindow_) return this.dateWindow_;
314
315 // The entire chart is visible.
316 var left = this.rawData_[0][0];
317 var right = this.rawData_[this.rawData_.length - 1][0];
318 return [left, right];
319};
320
3230c662
DV
321/**
322 * Returns the currently-visible y-range. This can be affected by zooming,
323 * panning or a call to updateOptions.
324 * Returns a two-element array: [bottom, top].
325 */
326Dygraph.prototype.yAxisRange = function() {
327 return this.displayedYRange_;
328};
329
330/**
331 * Convert from data coordinates to canvas/div X/Y coordinates.
332 * Returns a two-element array: [X, Y]
333 */
334Dygraph.prototype.toDomCoords = function(x, y) {
335 var ret = [null, null];
336 var area = this.plotter_.area;
337 if (x !== null) {
338 var xRange = this.xAxisRange();
339 ret[0] = area.x + (x - xRange[0]) / (xRange[1] - xRange[0]) * area.w;
340 }
341
342 if (y !== null) {
343 var yRange = this.yAxisRange();
891ad846 344 ret[1] = area.y + (yRange[1] - y) / (yRange[1] - yRange[0]) * area.h;
3230c662
DV
345 }
346
347 return ret;
348};
349
56623f3b 350// TODO(danvk): use these functions throughout dygraphs.
3230c662
DV
351/**
352 * Convert from canvas/div coords to data coordinates.
353 * Returns a two-element array: [X, Y]
354 */
355Dygraph.prototype.toDataCoords = function(x, y) {
356 var ret = [null, null];
357 var area = this.plotter_.area;
358 if (x !== null) {
359 var xRange = this.xAxisRange();
360 ret[0] = xRange[0] + (x - area.x) / area.w * (xRange[1] - xRange[0]);
361 }
362
363 if (y !== null) {
364 var yRange = this.yAxisRange();
365 ret[1] = yRange[0] + (area.h - y) / area.h * (yRange[1] - yRange[0]);
366 }
367
368 return ret;
369};
370
e99fde05
DV
371/**
372 * Returns the number of columns (including the independent variable).
373 */
374Dygraph.prototype.numColumns = function() {
375 return this.rawData_[0].length;
376};
377
378/**
379 * Returns the number of rows (excluding any header/label row).
380 */
381Dygraph.prototype.numRows = function() {
382 return this.rawData_.length;
383};
384
385/**
386 * Returns the value in the given row and column. If the row and column exceed
387 * the bounds on the data, returns null. Also returns null if the value is
388 * missing.
389 */
390Dygraph.prototype.getValue = function(row, col) {
391 if (row < 0 || row > this.rawData_.length) return null;
392 if (col < 0 || col > this.rawData_[row].length) return null;
393
394 return this.rawData_[row][col];
395};
396
76171648
DV
397Dygraph.addEvent = function(el, evt, fn) {
398 var normed_fn = function(e) {
399 if (!e) var e = window.event;
400 fn(e);
401 };
402 if (window.addEventListener) { // Mozilla, Netscape, Firefox
403 el.addEventListener(evt, normed_fn, false);
404 } else { // IE
405 el.attachEvent('on' + evt, normed_fn);
406 }
407};
6a1aa64f 408
4c47502d
DV
409Dygraph.clipCanvas_ = function(cnv, clip) {
410 var ctx = cnv.getContext("2d");
411 ctx.beginPath();
412 ctx.rect(clip.left, clip.top, clip.width, clip.height);
413 ctx.clip();
414};
415
6a1aa64f 416/**
285a6bda 417 * Generates interface elements for the Dygraph: a containing div, a div to
6a1aa64f 418 * display the current point, and a textbox to adjust the rolling average
697e70b2 419 * period. Also creates the Renderer/Layout elements.
6a1aa64f
DV
420 * @private
421 */
285a6bda 422Dygraph.prototype.createInterface_ = function() {
6a1aa64f
DV
423 // Create the all-enclosing graph div
424 var enclosing = this.maindiv_;
425
b0c3b730
DV
426 this.graphDiv = document.createElement("div");
427 this.graphDiv.style.width = this.width_ + "px";
428 this.graphDiv.style.height = this.height_ + "px";
429 enclosing.appendChild(this.graphDiv);
430
4c47502d
DV
431 var clip = {
432 top: 0,
433 left: this.attr_("yAxisLabelWidth") + 2 * this.attr_("axisTickSize")
434 };
435 clip.width = this.width_ - clip.left - this.attr_("rightGap");
436 clip.height = this.height_ - this.attr_("axisLabelFontSize")
437 - 2 * this.attr_("axisTickSize");
438 this.clippingArea_ = clip;
439
b0c3b730 440 // Create the canvas for interactive parts of the chart.
f8cfec73 441 this.canvas_ = Dygraph.createCanvas();
b0c3b730
DV
442 this.canvas_.style.position = "absolute";
443 this.canvas_.width = this.width_;
444 this.canvas_.height = this.height_;
f8cfec73
DV
445 this.canvas_.style.width = this.width_ + "px"; // for IE
446 this.canvas_.style.height = this.height_ + "px"; // for IE
b0c3b730
DV
447
448 // ... and for static parts of the chart.
6a1aa64f 449 this.hidden_ = this.createPlotKitCanvas_(this.canvas_);
76171648 450
eb7bf005
EC
451 // The interactive parts of the graph are drawn on top of the chart.
452 this.graphDiv.appendChild(this.hidden_);
453 this.graphDiv.appendChild(this.canvas_);
454 this.mouseEventElement_ = this.canvas_;
455
4c47502d
DV
456 // Make sure we don't overdraw.
457 Dygraph.clipCanvas_(this.hidden_, this.clippingArea_);
458 Dygraph.clipCanvas_(this.canvas_, this.clippingArea_);
459
76171648 460 var dygraph = this;
eb7bf005 461 Dygraph.addEvent(this.mouseEventElement_, 'mousemove', function(e) {
76171648
DV
462 dygraph.mouseMove_(e);
463 });
eb7bf005 464 Dygraph.addEvent(this.mouseEventElement_, 'mouseout', function(e) {
76171648
DV
465 dygraph.mouseOut_(e);
466 });
697e70b2
DV
467
468 // Create the grapher
469 // TODO(danvk): why does the Layout need its own set of options?
470 this.layoutOptions_ = { 'xOriginIsZero': false };
471 Dygraph.update(this.layoutOptions_, this.attrs_);
472 Dygraph.update(this.layoutOptions_, this.user_attrs_);
473 Dygraph.update(this.layoutOptions_, {
474 'errorBars': (this.attr_("errorBars") || this.attr_("customBars")) });
475
476 this.layout_ = new DygraphLayout(this, this.layoutOptions_);
477
478 // TODO(danvk): why does the Renderer need its own set of options?
479 this.renderOptions_ = { colorScheme: this.colors_,
480 strokeColor: null,
481 axisLineWidth: Dygraph.AXIS_LINE_WIDTH };
482 Dygraph.update(this.renderOptions_, this.attrs_);
483 Dygraph.update(this.renderOptions_, this.user_attrs_);
484 this.plotter_ = new DygraphCanvasRenderer(this,
485 this.hidden_, this.layout_,
486 this.renderOptions_);
487
488 this.createStatusMessage_();
489 this.createRollInterface_();
490 this.createDragInterface_();
4cfcc38c
DV
491};
492
493/**
494 * Detach DOM elements in the dygraph and null out all data references.
495 * Calling this when you're done with a dygraph can dramatically reduce memory
496 * usage. See, e.g., the tests/perf.html example.
497 */
498Dygraph.prototype.destroy = function() {
499 var removeRecursive = function(node) {
500 while (node.hasChildNodes()) {
501 removeRecursive(node.firstChild);
502 node.removeChild(node.firstChild);
503 }
504 };
505 removeRecursive(this.maindiv_);
506
507 var nullOut = function(obj) {
508 for (var n in obj) {
509 if (typeof(obj[n]) === 'object') {
510 obj[n] = null;
511 }
512 }
513 };
514
515 // These may not all be necessary, but it can't hurt...
516 nullOut(this.layout_);
517 nullOut(this.plotter_);
518 nullOut(this);
519};
6a1aa64f
DV
520
521/**
522 * Creates the canvas containing the PlotKit graph. Only plotkit ever draws on
285a6bda 523 * this particular canvas. All Dygraph work is done on this.canvas_.
8846615a 524 * @param {Object} canvas The Dygraph canvas over which to overlay the plot
6a1aa64f
DV
525 * @return {Object} The newly-created canvas
526 * @private
527 */
285a6bda 528Dygraph.prototype.createPlotKitCanvas_ = function(canvas) {
f8cfec73 529 var h = Dygraph.createCanvas();
6a1aa64f 530 h.style.position = "absolute";
9ac5e4ae
DV
531 // TODO(danvk): h should be offset from canvas. canvas needs to include
532 // some extra area to make it easier to zoom in on the far left and far
533 // right. h needs to be precisely the plot area, so that clipping occurs.
6a1aa64f
DV
534 h.style.top = canvas.style.top;
535 h.style.left = canvas.style.left;
536 h.width = this.width_;
537 h.height = this.height_;
f8cfec73
DV
538 h.style.width = this.width_ + "px"; // for IE
539 h.style.height = this.height_ + "px"; // for IE
6a1aa64f
DV
540 return h;
541};
542
f474c2a3
DV
543// Taken from MochiKit.Color
544Dygraph.hsvToRGB = function (hue, saturation, value) {
545 var red;
546 var green;
547 var blue;
548 if (saturation === 0) {
549 red = value;
550 green = value;
551 blue = value;
552 } else {
553 var i = Math.floor(hue * 6);
554 var f = (hue * 6) - i;
555 var p = value * (1 - saturation);
556 var q = value * (1 - (saturation * f));
557 var t = value * (1 - (saturation * (1 - f)));
558 switch (i) {
559 case 1: red = q; green = value; blue = p; break;
560 case 2: red = p; green = value; blue = t; break;
561 case 3: red = p; green = q; blue = value; break;
562 case 4: red = t; green = p; blue = value; break;
563 case 5: red = value; green = p; blue = q; break;
564 case 6: // fall through
565 case 0: red = value; green = t; blue = p; break;
566 }
567 }
568 red = Math.floor(255 * red + 0.5);
569 green = Math.floor(255 * green + 0.5);
570 blue = Math.floor(255 * blue + 0.5);
571 return 'rgb(' + red + ',' + green + ',' + blue + ')';
572};
573
574
6a1aa64f
DV
575/**
576 * Generate a set of distinct colors for the data series. This is done with a
577 * color wheel. Saturation/Value are customizable, and the hue is
578 * equally-spaced around the color wheel. If a custom set of colors is
579 * specified, that is used instead.
6a1aa64f
DV
580 * @private
581 */
285a6bda
DV
582Dygraph.prototype.setColors_ = function() {
583 // TODO(danvk): compute this directly into this.attrs_['colorScheme'] and do
584 // away with this.renderOptions_.
585 var num = this.attr_("labels").length - 1;
6a1aa64f 586 this.colors_ = [];
285a6bda
DV
587 var colors = this.attr_('colors');
588 if (!colors) {
589 var sat = this.attr_('colorSaturation') || 1.0;
590 var val = this.attr_('colorValue') || 0.5;
2aa21213 591 var half = Math.ceil(num / 2);
6a1aa64f 592 for (var i = 1; i <= num; i++) {
ec1959eb 593 if (!this.visibility()[i-1]) continue;
43af96e7 594 // alternate colors for high contrast.
2aa21213 595 var idx = i % 2 ? Math.ceil(i / 2) : (half + i / 2);
43af96e7
NK
596 var hue = (1.0 * idx/ (1 + num));
597 this.colors_.push(Dygraph.hsvToRGB(hue, sat, val));
6a1aa64f
DV
598 }
599 } else {
600 for (var i = 0; i < num; i++) {
ec1959eb 601 if (!this.visibility()[i]) continue;
285a6bda 602 var colorStr = colors[i % colors.length];
f474c2a3 603 this.colors_.push(colorStr);
6a1aa64f
DV
604 }
605 }
285a6bda 606
c21d2c2d 607 // TODO(danvk): update this w/r/t/ the new options system.
285a6bda 608 this.renderOptions_.colorScheme = this.colors_;
fc80a396
DV
609 Dygraph.update(this.plotter_.options, this.renderOptions_);
610 Dygraph.update(this.layoutOptions_, this.user_attrs_);
611 Dygraph.update(this.layoutOptions_, this.attrs_);
6a1aa64f
DV
612}
613
43af96e7
NK
614/**
615 * Return the list of colors. This is either the list of colors passed in the
616 * attributes, or the autogenerated list of rgb(r,g,b) strings.
617 * @return {Array<string>} The list of colors.
618 */
619Dygraph.prototype.getColors = function() {
620 return this.colors_;
621};
622
5e60386d
DV
623// The following functions are from quirksmode.org with a modification for Safari from
624// http://blog.firetree.net/2005/07/04/javascript-find-position/
3df0ccf0
DV
625// http://www.quirksmode.org/js/findpos.html
626Dygraph.findPosX = function(obj) {
627 var curleft = 0;
5e60386d 628 if(obj.offsetParent)
50360fd0 629 while(1)
5e60386d 630 {
3df0ccf0 631 curleft += obj.offsetLeft;
5e60386d
DV
632 if(!obj.offsetParent)
633 break;
3df0ccf0
DV
634 obj = obj.offsetParent;
635 }
5e60386d 636 else if(obj.x)
3df0ccf0
DV
637 curleft += obj.x;
638 return curleft;
639};
c21d2c2d 640
3df0ccf0
DV
641Dygraph.findPosY = function(obj) {
642 var curtop = 0;
5e60386d
DV
643 if(obj.offsetParent)
644 while(1)
645 {
3df0ccf0 646 curtop += obj.offsetTop;
5e60386d
DV
647 if(!obj.offsetParent)
648 break;
3df0ccf0
DV
649 obj = obj.offsetParent;
650 }
5e60386d 651 else if(obj.y)
3df0ccf0
DV
652 curtop += obj.y;
653 return curtop;
654};
655
5e60386d 656
71a11a8e 657
6a1aa64f
DV
658/**
659 * Create the div that contains information on the selected point(s)
660 * This goes in the top right of the canvas, unless an external div has already
661 * been specified.
662 * @private
663 */
fedbd797 664Dygraph.prototype.createStatusMessage_ = function() {
665 var userLabelsDiv = this.user_attrs_["labelsDiv"];
666 if (userLabelsDiv && null != userLabelsDiv
667 && (typeof(userLabelsDiv) == "string" || userLabelsDiv instanceof String)) {
668 this.user_attrs_["labelsDiv"] = document.getElementById(userLabelsDiv);
669 }
285a6bda
DV
670 if (!this.attr_("labelsDiv")) {
671 var divWidth = this.attr_('labelsDivWidth');
b0c3b730 672 var messagestyle = {
6a1aa64f
DV
673 "position": "absolute",
674 "fontSize": "14px",
675 "zIndex": 10,
676 "width": divWidth + "px",
677 "top": "0px",
8846615a 678 "left": (this.width_ - divWidth - 2) + "px",
6a1aa64f
DV
679 "background": "white",
680 "textAlign": "left",
b0c3b730 681 "overflow": "hidden"};
fc80a396 682 Dygraph.update(messagestyle, this.attr_('labelsDivStyles'));
b0c3b730
DV
683 var div = document.createElement("div");
684 for (var name in messagestyle) {
85b99f0b
DV
685 if (messagestyle.hasOwnProperty(name)) {
686 div.style[name] = messagestyle[name];
687 }
b0c3b730
DV
688 }
689 this.graphDiv.appendChild(div);
285a6bda 690 this.attrs_.labelsDiv = div;
6a1aa64f
DV
691 }
692};
693
694/**
695 * Create the text box to adjust the averaging period
696 * @return {Object} The newly-created text box
697 * @private
698 */
285a6bda 699Dygraph.prototype.createRollInterface_ = function() {
285a6bda 700 var display = this.attr_('showRoller') ? "block" : "none";
b0c3b730
DV
701 var textAttr = { "position": "absolute",
702 "zIndex": 10,
703 "top": (this.plotter_.area.h - 25) + "px",
704 "left": (this.plotter_.area.x + 1) + "px",
705 "display": display
6a1aa64f 706 };
b0c3b730
DV
707 var roller = document.createElement("input");
708 roller.type = "text";
709 roller.size = "2";
710 roller.value = this.rollPeriod_;
711 for (var name in textAttr) {
85b99f0b
DV
712 if (textAttr.hasOwnProperty(name)) {
713 roller.style[name] = textAttr[name];
714 }
b0c3b730
DV
715 }
716
6a1aa64f 717 var pa = this.graphDiv;
b0c3b730 718 pa.appendChild(roller);
76171648
DV
719 var dygraph = this;
720 roller.onchange = function() { dygraph.adjustRoll(roller.value); };
6a1aa64f 721 return roller;
76171648
DV
722};
723
724// These functions are taken from MochiKit.Signal
725Dygraph.pageX = function(e) {
726 if (e.pageX) {
727 return (!e.pageX || e.pageX < 0) ? 0 : e.pageX;
728 } else {
729 var de = document;
730 var b = document.body;
731 return e.clientX +
732 (de.scrollLeft || b.scrollLeft) -
733 (de.clientLeft || 0);
734 }
735};
736
737Dygraph.pageY = function(e) {
738 if (e.pageY) {
739 return (!e.pageY || e.pageY < 0) ? 0 : e.pageY;
740 } else {
741 var de = document;
742 var b = document.body;
743 return e.clientY +
744 (de.scrollTop || b.scrollTop) -
745 (de.clientTop || 0);
746 }
747};
6a1aa64f
DV
748
749/**
750 * Set up all the mouse handlers needed to capture dragging behavior for zoom
27385109 751 * events.
6a1aa64f
DV
752 * @private
753 */
285a6bda 754Dygraph.prototype.createDragInterface_ = function() {
6a1aa64f
DV
755 var self = this;
756
757 // Tracks whether the mouse is down right now
bce01b0f 758 var isZooming = false;
c776c216 759 var isPanning = false;
6a1aa64f
DV
760 var dragStartX = null;
761 var dragStartY = null;
762 var dragEndX = null;
763 var dragEndY = null;
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
796 var 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
8b83c6cc
RK
923 if (regionWidth >= 10 && regionWidth > regionHeight) {
924 self.doZoomX_(Math.min(dragStartX, dragEndX),
6a1aa64f 925 Math.max(dragStartX, dragEndX));
8b83c6cc
RK
926 } else if (regionHeight >= 10 && regionHeight > regionWidth){
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];
1226 var c = new RGBColor(this.colors_[i%clen]);
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)
1629 * @return {Array.<Object>} Array of {label, value} tuples.
1630 * @public
1631 */
285a6bda 1632Dygraph.numericTicks = function(minV, maxV, self) {
c6336f04
DV
1633 // Basic idea:
1634 // Try labels every 1, 2, 5, 10, 20, 50, 100, etc.
1635 // Calculate the resulting tick spacing (i.e. this.height_ / nTicks).
285a6bda 1636 // The first spacing greater than pixelsPerYLabel is what we use.
ff00d3e2 1637 // TODO(danvk): version that works on a log scale.
f09e46d4
DV
1638 if (self.attr_("labelsKMG2")) {
1639 var mults = [1, 2, 4, 8];
1640 } else {
1641 var mults = [1, 2, 5];
1642 }
c6336f04 1643 var scale, low_val, high_val, nTicks;
285a6bda
DV
1644 // TODO(danvk): make it possible to set this for x- and y-axes independently.
1645 var pixelsPerTick = self.attr_('pixelsPerYLabel');
c6336f04 1646 for (var i = -10; i < 50; i++) {
f09e46d4
DV
1647 if (self.attr_("labelsKMG2")) {
1648 var base_scale = Math.pow(16, i);
1649 } else {
1650 var base_scale = Math.pow(10, i);
1651 }
c6336f04
DV
1652 for (var j = 0; j < mults.length; j++) {
1653 scale = base_scale * mults[j];
c6336f04
DV
1654 low_val = Math.floor(minV / scale) * scale;
1655 high_val = Math.ceil(maxV / scale) * scale;
48a0ac91 1656 nTicks = Math.abs(high_val - low_val) / scale;
285a6bda 1657 var spacing = self.height_ / nTicks;
c6336f04 1658 // wish I could break out of both loops at once...
285a6bda 1659 if (spacing > pixelsPerTick) break;
c6336f04 1660 }
285a6bda 1661 if (spacing > pixelsPerTick) break;
6a1aa64f
DV
1662 }
1663
1664 // Construct labels for the ticks
1665 var ticks = [];
ed11be50
DV
1666 var k;
1667 var k_labels = [];
1668 if (self.attr_("labelsKMB")) {
1669 k = 1000;
1670 k_labels = [ "K", "M", "B", "T" ];
1671 }
1672 if (self.attr_("labelsKMG2")) {
1673 if (k) self.warn("Setting both labelsKMB and labelsKMG2. Pick one!");
1674 k = 1024;
1675 k_labels = [ "k", "M", "G", "T" ];
1676 }
1677
e21e69e2 1678 // Allow reverse y-axis if it's explicitly requested.
be7cdb11 1679 if (low_val > high_val) scale *= -1;
48a0ac91 1680
c6336f04
DV
1681 for (var i = 0; i < nTicks; i++) {
1682 var tickV = low_val + i * scale;
0af6e346 1683 var absTickV = Math.abs(tickV);
029da4b6 1684 var label = Dygraph.round_(tickV, 2);
ed11be50
DV
1685 if (k_labels.length) {
1686 // Round up to an appropriate unit.
1687 var n = k*k*k*k;
1688 for (var j = 3; j >= 0; j--, n /= k) {
1689 if (absTickV >= n) {
029da4b6 1690 label = Dygraph.round_(tickV / n, 1) + k_labels[j];
ed11be50
DV
1691 break;
1692 }
afefbcdb 1693 }
6a1aa64f
DV
1694 }
1695 ticks.push( {label: label, v: tickV} );
1696 }
1697 return ticks;
1698};
1699
1700/**
1701 * Adds appropriate ticks on the y-axis
1702 * @param {Number} minY The minimum Y value in the data set
1703 * @param {Number} maxY The maximum Y value in the data set
1704 * @private
1705 */
285a6bda 1706Dygraph.prototype.addYTicks_ = function(minY, maxY) {
6a1aa64f 1707 // Set the number of ticks so that the labels are human-friendly.
285a6bda
DV
1708 // TODO(danvk): make this an attribute as well.
1709 var ticks = Dygraph.numericTicks(minY, maxY, this);
6a1aa64f
DV
1710 this.layout_.updateOptions( { yAxis: [minY, maxY],
1711 yTicks: ticks } );
1712};
1713
5011e7a1
DV
1714// Computes the range of the data series (including confidence intervals).
1715// series is either [ [x1, y1], [x2, y2], ... ] or
1716// [ [x1, [y1, dev_low, dev_high]], [x2, [y2, dev_low, dev_high]], ...
1717// Returns [low, high]
1718Dygraph.prototype.extremeValues_ = function(series) {
1719 var minY = null, maxY = null;
1720
9922b78b 1721 var bars = this.attr_("errorBars") || this.attr_("customBars");
5011e7a1
DV
1722 if (bars) {
1723 // With custom bars, maxY is the max of the high values.
1724 for (var j = 0; j < series.length; j++) {
1725 var y = series[j][1][0];
1726 if (!y) continue;
1727 var low = y - series[j][1][1];
1728 var high = y + series[j][1][2];
1729 if (low > y) low = y; // this can happen with custom bars,
1730 if (high < y) high = y; // e.g. in tests/custom-bars.html
1731 if (maxY == null || high > maxY) {
1732 maxY = high;
1733 }
1734 if (minY == null || low < minY) {
1735 minY = low;
1736 }
1737 }
1738 } else {
1739 for (var j = 0; j < series.length; j++) {
1740 var y = series[j][1];
d12999d3 1741 if (y === null || isNaN(y)) continue;
5011e7a1
DV
1742 if (maxY == null || y > maxY) {
1743 maxY = y;
1744 }
1745 if (minY == null || y < minY) {
1746 minY = y;
1747 }
1748 }
1749 }
1750
1751 return [minY, maxY];
1752};
1753
6a1aa64f
DV
1754/**
1755 * Update the graph with new data. Data is in the format
1756 * [ [date1, val1, val2, ...], [date2, val1, val2, ...] if errorBars=false
1757 * or, if errorBars=true,
1758 * [ [date1, [val1,stddev1], [val2,stddev2], ...], [date2, ...], ...]
1759 * @param {Array.<Object>} data The data (see above)
1760 * @private
1761 */
285a6bda 1762Dygraph.prototype.drawGraph_ = function(data) {
fe0b7c03
DV
1763 // This is used to set the second parameter to drawCallback, below.
1764 var is_initial_draw = this.is_initial_draw_;
1765 this.is_initial_draw_ = false;
1766
3bd9c228 1767 var minY = null, maxY = null;
6a1aa64f 1768 this.layout_.removeAllDatasets();
285a6bda 1769 this.setColors_();
9317362d 1770 this.attrs_['pointSize'] = 0.5 * this.attr_('highlightCircleSize');
285a6bda 1771
354e15ab
DE
1772 // Loop over the fields (series). Go from the last to the first,
1773 // because if they're stacked that's how we accumulate the values.
43af96e7 1774
354e15ab
DE
1775 var cumulative_y = []; // For stacked series.
1776 var datasets = [];
1777
1778 // Loop over all fields and create datasets
1779 for (var i = data[0].length - 1; i >= 1; i--) {
1cf11047
DV
1780 if (!this.visibility()[i - 1]) continue;
1781
450fe64b
DV
1782 var connectSeparatedPoints = this.attr_('connectSeparatedPoints', i);
1783
6a1aa64f
DV
1784 var series = [];
1785 for (var j = 0; j < data.length; j++) {
4a634fc7 1786 if (data[j][i] != null || !connectSeparatedPoints) {
f032c51d 1787 var date = data[j][0];
563c70ca 1788 series.push([date, data[j][i]]);
f032c51d 1789 }
6a1aa64f
DV
1790 }
1791 series = this.rollingAverage(series, this.rollPeriod_);
1792
1793 // Prune down to the desired range, if necessary (for zooming)
1a26f3fb
DV
1794 // Because there can be lines going to points outside of the visible area,
1795 // we actually prune to visible points, plus one on either side.
9922b78b 1796 var bars = this.attr_("errorBars") || this.attr_("customBars");
6a1aa64f
DV
1797 if (this.dateWindow_) {
1798 var low = this.dateWindow_[0];
1799 var high= this.dateWindow_[1];
1800 var pruned = [];
1a26f3fb
DV
1801 // TODO(danvk): do binary search instead of linear search.
1802 // TODO(danvk): pass firstIdx and lastIdx directly to the renderer.
1803 var firstIdx = null, lastIdx = null;
6a1aa64f 1804 for (var k = 0; k < series.length; k++) {
1a26f3fb
DV
1805 if (series[k][0] >= low && firstIdx === null) {
1806 firstIdx = k;
1807 }
1808 if (series[k][0] <= high) {
1809 lastIdx = k;
6a1aa64f
DV
1810 }
1811 }
1a26f3fb
DV
1812 if (firstIdx === null) firstIdx = 0;
1813 if (firstIdx > 0) firstIdx--;
1814 if (lastIdx === null) lastIdx = series.length - 1;
1815 if (lastIdx < series.length - 1) lastIdx++;
16269f6e 1816 this.boundaryIds_[i-1] = [firstIdx, lastIdx];
1a26f3fb
DV
1817 for (var k = firstIdx; k <= lastIdx; k++) {
1818 pruned.push(series[k]);
6a1aa64f
DV
1819 }
1820 series = pruned;
16269f6e
NAG
1821 } else {
1822 this.boundaryIds_[i-1] = [0, series.length-1];
6a1aa64f
DV
1823 }
1824
648acd28
DV
1825 var extremes = this.extremeValues_(series);
1826 var thisMinY = extremes[0];
1827 var thisMaxY = extremes[1];
61b78cd6
DV
1828 if (minY === null || thisMinY < minY) minY = thisMinY;
1829 if (maxY === null || thisMaxY > maxY) maxY = thisMaxY;
5011e7a1 1830
6a1aa64f 1831 if (bars) {
354e15ab
DE
1832 for (var j=0; j<series.length; j++) {
1833 val = [series[j][0], series[j][1][0], series[j][1][1], series[j][1][2]];
1834 series[j] = val;
1835 }
43af96e7 1836 } else if (this.attr_("stackedGraph")) {
43af96e7
NK
1837 var l = series.length;
1838 var actual_y;
1839 for (var j = 0; j < l; j++) {
354e15ab
DE
1840 // If one data set has a NaN, let all subsequent stacked
1841 // sets inherit the NaN -- only start at 0 for the first set.
1842 var x = series[j][0];
1843 if (cumulative_y[x] === undefined)
1844 cumulative_y[x] = 0;
43af96e7
NK
1845
1846 actual_y = series[j][1];
354e15ab 1847 cumulative_y[x] += actual_y;
43af96e7 1848
354e15ab 1849 series[j] = [x, cumulative_y[x]]
43af96e7 1850
354e15ab
DE
1851 if (!maxY || cumulative_y[x] > maxY)
1852 maxY = cumulative_y[x];
43af96e7 1853 }
6a1aa64f 1854 }
354e15ab
DE
1855
1856 datasets[i] = series;
6a1aa64f
DV
1857 }
1858
354e15ab 1859 for (var i = 1; i < datasets.length; i++) {
4523c1f6 1860 if (!this.visibility()[i - 1]) continue;
354e15ab 1861 this.layout_.addDataset(this.attr_("labels")[i], datasets[i]);
43af96e7
NK
1862 }
1863
6a1aa64f 1864 // Use some heuristics to come up with a good maxY value, unless it's been
8b83c6cc
RK
1865 // set explicitly by the developer or end-user (via drag)
1866 if (this.valueWindow_ != null) {
1867 this.addYTicks_(this.valueWindow_[0], this.valueWindow_[1]);
1868 this.displayedYRange_ = this.valueWindow_;
6a1aa64f 1869 } else {
d053ab5a
DV
1870 // This affects the calculation of span, below.
1871 if (this.attr_("includeZero") && minY > 0) {
1872 minY = 0;
1873 }
1874
6a1aa64f 1875 // Add some padding and round up to an integer to be human-friendly.
3bd9c228 1876 var span = maxY - minY;
93dfacfd
DV
1877 // special case: if we have no sense of scale, use +/-10% of the sole value.
1878 if (span == 0) { span = maxY; }
3bd9c228
DV
1879 var maxAxisY = maxY + 0.1 * span;
1880 var minAxisY = minY - 0.1 * span;
1881
1882 // Try to include zero and make it minAxisY (or maxAxisY) if it makes sense.
ceb009dd
DV
1883 if (minAxisY < 0 && minY >= 0) minAxisY = 0;
1884 if (maxAxisY > 0 && maxY <= 0) maxAxisY = 0;
3bd9c228
DV
1885
1886 if (this.attr_("includeZero")) {
1887 if (maxY < 0) maxAxisY = 0;
1888 if (minY > 0) minAxisY = 0;
1889 }
1890
1891 this.addYTicks_(minAxisY, maxAxisY);
3230c662 1892 this.displayedYRange_ = [minAxisY, maxAxisY];
6a1aa64f
DV
1893 }
1894
1895 this.addXTicks_();
1896
1897 // Tell PlotKit to use this new data and render itself
d033ae1c 1898 this.layout_.updateOptions({dateWindow: this.dateWindow_});
6a1aa64f
DV
1899 this.layout_.evaluateWithError();
1900 this.plotter_.clear();
1901 this.plotter_.render();
f6401bf6
DV
1902 this.canvas_.getContext('2d').clearRect(0, 0, this.canvas_.width,
1903 this.canvas_.height);
599fb4ad
DV
1904
1905 if (this.attr_("drawCallback") !== null) {
fe0b7c03 1906 this.attr_("drawCallback")(this, is_initial_draw);
599fb4ad 1907 }
6a1aa64f
DV
1908};
1909
1910/**
1911 * Calculates the rolling average of a data set.
1912 * If originalData is [label, val], rolls the average of those.
1913 * If originalData is [label, [, it's interpreted as [value, stddev]
1914 * and the roll is returned in the same form, with appropriately reduced
1915 * stddev for each value.
1916 * Note that this is where fractional input (i.e. '5/10') is converted into
1917 * decimal values.
1918 * @param {Array} originalData The data in the appropriate format (see above)
1919 * @param {Number} rollPeriod The number of days over which to average the data
1920 */
285a6bda 1921Dygraph.prototype.rollingAverage = function(originalData, rollPeriod) {
6a1aa64f
DV
1922 if (originalData.length < 2)
1923 return originalData;
1924 var rollPeriod = Math.min(rollPeriod, originalData.length - 1);
1925 var rollingData = [];
285a6bda 1926 var sigma = this.attr_("sigma");
6a1aa64f
DV
1927
1928 if (this.fractions_) {
1929 var num = 0;
1930 var den = 0; // numerator/denominator
1931 var mult = 100.0;
1932 for (var i = 0; i < originalData.length; i++) {
1933 num += originalData[i][1][0];
1934 den += originalData[i][1][1];
1935 if (i - rollPeriod >= 0) {
1936 num -= originalData[i - rollPeriod][1][0];
1937 den -= originalData[i - rollPeriod][1][1];
1938 }
1939
1940 var date = originalData[i][0];
1941 var value = den ? num / den : 0.0;
285a6bda 1942 if (this.attr_("errorBars")) {
6a1aa64f
DV
1943 if (this.wilsonInterval_) {
1944 // For more details on this confidence interval, see:
1945 // http://en.wikipedia.org/wiki/Binomial_confidence_interval
1946 if (den) {
1947 var p = value < 0 ? 0 : value, n = den;
1948 var pm = sigma * Math.sqrt(p*(1-p)/n + sigma*sigma/(4*n*n));
1949 var denom = 1 + sigma * sigma / den;
1950 var low = (p + sigma * sigma / (2 * den) - pm) / denom;
1951 var high = (p + sigma * sigma / (2 * den) + pm) / denom;
1952 rollingData[i] = [date,
1953 [p * mult, (p - low) * mult, (high - p) * mult]];
1954 } else {
1955 rollingData[i] = [date, [0, 0, 0]];
1956 }
1957 } else {
1958 var stddev = den ? sigma * Math.sqrt(value * (1 - value) / den) : 1.0;
1959 rollingData[i] = [date, [mult * value, mult * stddev, mult * stddev]];
1960 }
1961 } else {
1962 rollingData[i] = [date, mult * value];
1963 }
1964 }
9922b78b 1965 } else if (this.attr_("customBars")) {
f6885d6a
DV
1966 var low = 0;
1967 var mid = 0;
1968 var high = 0;
1969 var count = 0;
6a1aa64f
DV
1970 for (var i = 0; i < originalData.length; i++) {
1971 var data = originalData[i][1];
1972 var y = data[1];
1973 rollingData[i] = [originalData[i][0], [y, y - data[0], data[2] - y]];
f6885d6a 1974
8b91c51f 1975 if (y != null && !isNaN(y)) {
49a7d0d5
DV
1976 low += data[0];
1977 mid += y;
1978 high += data[2];
1979 count += 1;
1980 }
f6885d6a
DV
1981 if (i - rollPeriod >= 0) {
1982 var prev = originalData[i - rollPeriod];
8b91c51f 1983 if (prev[1][1] != null && !isNaN(prev[1][1])) {
49a7d0d5
DV
1984 low -= prev[1][0];
1985 mid -= prev[1][1];
1986 high -= prev[1][2];
1987 count -= 1;
1988 }
f6885d6a
DV
1989 }
1990 rollingData[i] = [originalData[i][0], [ 1.0 * mid / count,
1991 1.0 * (mid - low) / count,
1992 1.0 * (high - mid) / count ]];
2769de62 1993 }
6a1aa64f
DV
1994 } else {
1995 // Calculate the rolling average for the first rollPeriod - 1 points where
1996 // there is not enough data to roll over the full number of days
1997 var num_init_points = Math.min(rollPeriod - 1, originalData.length - 2);
285a6bda 1998 if (!this.attr_("errorBars")){
5011e7a1
DV
1999 if (rollPeriod == 1) {
2000 return originalData;
2001 }
2002
2847c1cf 2003 for (var i = 0; i < originalData.length; i++) {
6a1aa64f 2004 var sum = 0;
5011e7a1 2005 var num_ok = 0;
2847c1cf
DV
2006 for (var j = Math.max(0, i - rollPeriod + 1); j < i + 1; j++) {
2007 var y = originalData[j][1];
8b91c51f 2008 if (y == null || isNaN(y)) continue;
5011e7a1 2009 num_ok++;
2847c1cf 2010 sum += originalData[j][1];
6a1aa64f 2011 }
5011e7a1 2012 if (num_ok) {
2847c1cf 2013 rollingData[i] = [originalData[i][0], sum / num_ok];
5011e7a1 2014 } else {
2847c1cf 2015 rollingData[i] = [originalData[i][0], null];
5011e7a1 2016 }
6a1aa64f 2017 }
2847c1cf
DV
2018
2019 } else {
2020 for (var i = 0; i < originalData.length; i++) {
6a1aa64f
DV
2021 var sum = 0;
2022 var variance = 0;
5011e7a1 2023 var num_ok = 0;
2847c1cf 2024 for (var j = Math.max(0, i - rollPeriod + 1); j < i + 1; j++) {
5011e7a1 2025 var y = originalData[j][1][0];
8b91c51f 2026 if (y == null || isNaN(y)) continue;
5011e7a1 2027 num_ok++;
6a1aa64f
DV
2028 sum += originalData[j][1][0];
2029 variance += Math.pow(originalData[j][1][1], 2);
2030 }
5011e7a1
DV
2031 if (num_ok) {
2032 var stddev = Math.sqrt(variance) / num_ok;
2033 rollingData[i] = [originalData[i][0],
2034 [sum / num_ok, sigma * stddev, sigma * stddev]];
2035 } else {
2036 rollingData[i] = [originalData[i][0], [null, null, null]];
2037 }
6a1aa64f
DV
2038 }
2039 }
2040 }
2041
2042 return rollingData;
2043};
2044
2045/**
2046 * Parses a date, returning the number of milliseconds since epoch. This can be
285a6bda
DV
2047 * passed in as an xValueParser in the Dygraph constructor.
2048 * TODO(danvk): enumerate formats that this understands.
6a1aa64f
DV
2049 * @param {String} A date in YYYYMMDD format.
2050 * @return {Number} Milliseconds since epoch.
2051 * @public
2052 */
285a6bda 2053Dygraph.dateParser = function(dateStr, self) {
6a1aa64f 2054 var dateStrSlashed;
285a6bda 2055 var d;
986a5026 2056 if (dateStr.search("-") != -1) { // e.g. '2009-7-12' or '2009-07-12'
6a1aa64f 2057 dateStrSlashed = dateStr.replace("-", "/", "g");
353a0294
DV
2058 while (dateStrSlashed.search("-") != -1) {
2059 dateStrSlashed = dateStrSlashed.replace("-", "/");
2060 }
285a6bda 2061 d = Date.parse(dateStrSlashed);
2769de62 2062 } else if (dateStr.length == 8) { // e.g. '20090712'
285a6bda 2063 // TODO(danvk): remove support for this format. It's confusing.
6a1aa64f
DV
2064 dateStrSlashed = dateStr.substr(0,4) + "/" + dateStr.substr(4,2)
2065 + "/" + dateStr.substr(6,2);
285a6bda 2066 d = Date.parse(dateStrSlashed);
2769de62
DV
2067 } else {
2068 // Any format that Date.parse will accept, e.g. "2009/07/12" or
2069 // "2009/07/12 12:34:56"
285a6bda
DV
2070 d = Date.parse(dateStr);
2071 }
2072
2073 if (!d || isNaN(d)) {
2074 self.error("Couldn't parse " + dateStr + " as a date");
2075 }
2076 return d;
2077};
2078
2079/**
2080 * Detects the type of the str (date or numeric) and sets the various
2081 * formatting attributes in this.attrs_ based on this type.
2082 * @param {String} str An x value.
2083 * @private
2084 */
2085Dygraph.prototype.detectTypeFromString_ = function(str) {
2086 var isDate = false;
2087 if (str.indexOf('-') >= 0 ||
2088 str.indexOf('/') >= 0 ||
2089 isNaN(parseFloat(str))) {
2090 isDate = true;
2091 } else if (str.length == 8 && str > '19700101' && str < '20371231') {
2092 // TODO(danvk): remove support for this format.
2093 isDate = true;
2094 }
2095
2096 if (isDate) {
2097 this.attrs_.xValueFormatter = Dygraph.dateString_;
2098 this.attrs_.xValueParser = Dygraph.dateParser;
2099 this.attrs_.xTicker = Dygraph.dateTicker;
bf640e56 2100 this.attrs_.xAxisLabelFormatter = Dygraph.dateAxisFormatter;
285a6bda
DV
2101 } else {
2102 this.attrs_.xValueFormatter = function(x) { return x; };
2103 this.attrs_.xValueParser = function(x) { return parseFloat(x); };
2104 this.attrs_.xTicker = Dygraph.numericTicks;
bf640e56 2105 this.attrs_.xAxisLabelFormatter = this.attrs_.xValueFormatter;
6a1aa64f 2106 }
6a1aa64f
DV
2107};
2108
2109/**
2110 * Parses a string in a special csv format. We expect a csv file where each
2111 * line is a date point, and the first field in each line is the date string.
2112 * We also expect that all remaining fields represent series.
285a6bda 2113 * if the errorBars attribute is set, then interpret the fields as:
6a1aa64f
DV
2114 * date, series1, stddev1, series2, stddev2, ...
2115 * @param {Array.<Object>} data See above.
2116 * @private
285a6bda
DV
2117 *
2118 * @return Array.<Object> An array with one entry for each row. These entries
2119 * are an array of cells in that row. The first entry is the parsed x-value for
2120 * the row. The second, third, etc. are the y-values. These can take on one of
2121 * three forms, depending on the CSV and constructor parameters:
2122 * 1. numeric value
2123 * 2. [ value, stddev ]
2124 * 3. [ low value, center value, high value ]
6a1aa64f 2125 */
285a6bda 2126Dygraph.prototype.parseCSV_ = function(data) {
6a1aa64f
DV
2127 var ret = [];
2128 var lines = data.split("\n");
3d67f03b
DV
2129
2130 // Use the default delimiter or fall back to a tab if that makes sense.
2131 var delim = this.attr_('delimiter');
2132 if (lines[0].indexOf(delim) == -1 && lines[0].indexOf('\t') >= 0) {
2133 delim = '\t';
2134 }
2135
285a6bda 2136 var start = 0;
6a1aa64f 2137 if (this.labelsFromCSV_) {
285a6bda 2138 start = 1;
3d67f03b 2139 this.attrs_.labels = lines[0].split(delim);
6a1aa64f
DV
2140 }
2141
03b522a4
DV
2142 // Parse the x as a float or return null if it's not a number.
2143 var parseFloatOrNull = function(x) {
41333ec0
DV
2144 var val = parseFloat(x);
2145 return isNaN(val) ? null : val;
03b522a4
DV
2146 };
2147
285a6bda
DV
2148 var xParser;
2149 var defaultParserSet = false; // attempt to auto-detect x value type
2150 var expectedCols = this.attr_("labels").length;
987840a2 2151 var outOfOrder = false;
6a1aa64f
DV
2152 for (var i = start; i < lines.length; i++) {
2153 var line = lines[i];
2154 if (line.length == 0) continue; // skip blank lines
3d67f03b
DV
2155 if (line[0] == '#') continue; // skip comment lines
2156 var inFields = line.split(delim);
285a6bda 2157 if (inFields.length < 2) continue;
6a1aa64f
DV
2158
2159 var fields = [];
285a6bda
DV
2160 if (!defaultParserSet) {
2161 this.detectTypeFromString_(inFields[0]);
2162 xParser = this.attr_("xValueParser");
2163 defaultParserSet = true;
2164 }
2165 fields[0] = xParser(inFields[0], this);
6a1aa64f
DV
2166
2167 // If fractions are expected, parse the numbers as "A/B"
2168 if (this.fractions_) {
2169 for (var j = 1; j < inFields.length; j++) {
2170 // TODO(danvk): figure out an appropriate way to flag parse errors.
2171 var vals = inFields[j].split("/");
03b522a4 2172 fields[j] = [parseFloatOrNull(vals[0]), parseFloatOrNull(vals[1])];
6a1aa64f 2173 }
285a6bda 2174 } else if (this.attr_("errorBars")) {
6a1aa64f
DV
2175 // If there are error bars, values are (value, stddev) pairs
2176 for (var j = 1; j < inFields.length; j += 2)
03b522a4
DV
2177 fields[(j + 1) / 2] = [parseFloatOrNull(inFields[j]),
2178 parseFloatOrNull(inFields[j + 1])];
9922b78b 2179 } else if (this.attr_("customBars")) {
6a1aa64f
DV
2180 // Bars are a low;center;high tuple
2181 for (var j = 1; j < inFields.length; j++) {
2182 var vals = inFields[j].split(";");
03b522a4
DV
2183 fields[j] = [ parseFloatOrNull(vals[0]),
2184 parseFloatOrNull(vals[1]),
2185 parseFloatOrNull(vals[2]) ];
6a1aa64f
DV
2186 }
2187 } else {
2188 // Values are just numbers
285a6bda 2189 for (var j = 1; j < inFields.length; j++) {
03b522a4 2190 fields[j] = parseFloatOrNull(inFields[j]);
285a6bda 2191 }
6a1aa64f 2192 }
987840a2
DV
2193 if (ret.length > 0 && fields[0] < ret[ret.length - 1][0]) {
2194 outOfOrder = true;
2195 }
6a1aa64f 2196 ret.push(fields);
285a6bda
DV
2197
2198 if (fields.length != expectedCols) {
2199 this.error("Number of columns in line " + i + " (" + fields.length +
2200 ") does not agree with number of labels (" + expectedCols +
2201 ") " + line);
2202 }
6a1aa64f 2203 }
987840a2
DV
2204
2205 if (outOfOrder) {
2206 this.warn("CSV is out of order; order it correctly to speed loading.");
2207 ret.sort(function(a,b) { return a[0] - b[0] });
2208 }
2209
6a1aa64f
DV
2210 return ret;
2211};
2212
2213/**
285a6bda
DV
2214 * The user has provided their data as a pre-packaged JS array. If the x values
2215 * are numeric, this is the same as dygraphs' internal format. If the x values
2216 * are dates, we need to convert them from Date objects to ms since epoch.
2217 * @param {Array.<Object>} data
2218 * @return {Array.<Object>} data with numeric x values.
2219 */
2220Dygraph.prototype.parseArray_ = function(data) {
2221 // Peek at the first x value to see if it's numeric.
2222 if (data.length == 0) {
2223 this.error("Can't plot empty data set");
2224 return null;
2225 }
2226 if (data[0].length == 0) {
2227 this.error("Data set cannot contain an empty row");
2228 return null;
2229 }
2230
2231 if (this.attr_("labels") == null) {
2232 this.warn("Using default labels. Set labels explicitly via 'labels' " +
2233 "in the options parameter");
2234 this.attrs_.labels = [ "X" ];
2235 for (var i = 1; i < data[0].length; i++) {
2236 this.attrs_.labels.push("Y" + i);
2237 }
2238 }
2239
2dda3850 2240 if (Dygraph.isDateLike(data[0][0])) {
285a6bda
DV
2241 // Some intelligent defaults for a date x-axis.
2242 this.attrs_.xValueFormatter = Dygraph.dateString_;
bf640e56 2243 this.attrs_.xAxisLabelFormatter = Dygraph.dateAxisFormatter;
285a6bda
DV
2244 this.attrs_.xTicker = Dygraph.dateTicker;
2245
2246 // Assume they're all dates.
e3ab7b40 2247 var parsedData = Dygraph.clone(data);
285a6bda
DV
2248 for (var i = 0; i < data.length; i++) {
2249 if (parsedData[i].length == 0) {
a323ff4a 2250 this.error("Row " + (1 + i) + " of data is empty");
285a6bda
DV
2251 return null;
2252 }
2253 if (parsedData[i][0] == null
3a909ec5
DV
2254 || typeof(parsedData[i][0].getTime) != 'function'
2255 || isNaN(parsedData[i][0].getTime())) {
be96a1f5 2256 this.error("x value in row " + (1 + i) + " is not a Date");
285a6bda
DV
2257 return null;
2258 }
2259 parsedData[i][0] = parsedData[i][0].getTime();
2260 }
2261 return parsedData;
2262 } else {
2263 // Some intelligent defaults for a numeric x-axis.
2264 this.attrs_.xValueFormatter = function(x) { return x; };
2265 this.attrs_.xTicker = Dygraph.numericTicks;
2266 return data;
2267 }
2268};
2269
2270/**
79420a1e
DV
2271 * Parses a DataTable object from gviz.
2272 * The data is expected to have a first column that is either a date or a
2273 * number. All subsequent columns must be numbers. If there is a clear mismatch
2274 * between this.xValueParser_ and the type of the first column, it will be
a685723c 2275 * fixed. Fills out rawData_.
79420a1e
DV
2276 * @param {Array.<Object>} data See above.
2277 * @private
2278 */
285a6bda 2279Dygraph.prototype.parseDataTable_ = function(data) {
79420a1e
DV
2280 var cols = data.getNumberOfColumns();
2281 var rows = data.getNumberOfRows();
2282
d955e223 2283 var indepType = data.getColumnType(0);
4440f6c8 2284 if (indepType == 'date' || indepType == 'datetime') {
285a6bda
DV
2285 this.attrs_.xValueFormatter = Dygraph.dateString_;
2286 this.attrs_.xValueParser = Dygraph.dateParser;
2287 this.attrs_.xTicker = Dygraph.dateTicker;
bf640e56 2288 this.attrs_.xAxisLabelFormatter = Dygraph.dateAxisFormatter;
33127159 2289 } else if (indepType == 'number') {
285a6bda
DV
2290 this.attrs_.xValueFormatter = function(x) { return x; };
2291 this.attrs_.xValueParser = function(x) { return parseFloat(x); };
2292 this.attrs_.xTicker = Dygraph.numericTicks;
bf640e56 2293 this.attrs_.xAxisLabelFormatter = this.attrs_.xValueFormatter;
285a6bda 2294 } else {
987840a2
DV
2295 this.error("only 'date', 'datetime' and 'number' types are supported for " +
2296 "column 1 of DataTable input (Got '" + indepType + "')");
79420a1e
DV
2297 return null;
2298 }
2299
a685723c
DV
2300 // Array of the column indices which contain data (and not annotations).
2301 var colIdx = [];
2302 var annotationCols = {}; // data index -> [annotation cols]
2303 var hasAnnotations = false;
2304 for (var i = 1; i < cols; i++) {
2305 var type = data.getColumnType(i);
2306 if (type == 'number') {
2307 colIdx.push(i);
2308 } else if (type == 'string' && this.attr_('displayAnnotations')) {
2309 // This is OK -- it's an annotation column.
2310 var dataIdx = colIdx[colIdx.length - 1];
2311 if (!annotationCols.hasOwnProperty(dataIdx)) {
2312 annotationCols[dataIdx] = [i];
2313 } else {
2314 annotationCols[dataIdx].push(i);
2315 }
2316 hasAnnotations = true;
2317 } else {
2318 this.error("Only 'number' is supported as a dependent type with Gviz." +
2319 " 'string' is only supported if displayAnnotations is true");
2320 }
2321 }
2322
2323 // Read column labels
2324 // TODO(danvk): add support back for errorBars
2325 var labels = [data.getColumnLabel(0)];
2326 for (var i = 0; i < colIdx.length; i++) {
2327 labels.push(data.getColumnLabel(colIdx[i]));
f9348814 2328 if (this.attr_("errorBars")) i += 1;
a685723c
DV
2329 }
2330 this.attrs_.labels = labels;
2331 cols = labels.length;
2332
79420a1e 2333 var ret = [];
987840a2 2334 var outOfOrder = false;
a685723c 2335 var annotations = [];
79420a1e
DV
2336 for (var i = 0; i < rows; i++) {
2337 var row = [];
debe4434
DV
2338 if (typeof(data.getValue(i, 0)) === 'undefined' ||
2339 data.getValue(i, 0) === null) {
129569a5
FD
2340 this.warn("Ignoring row " + i +
2341 " of DataTable because of undefined or null first column.");
debe4434
DV
2342 continue;
2343 }
2344
c21d2c2d 2345 if (indepType == 'date' || indepType == 'datetime') {
d955e223
DV
2346 row.push(data.getValue(i, 0).getTime());
2347 } else {
2348 row.push(data.getValue(i, 0));
2349 }
3e3f84e4 2350 if (!this.attr_("errorBars")) {
a685723c
DV
2351 for (var j = 0; j < colIdx.length; j++) {
2352 var col = colIdx[j];
2353 row.push(data.getValue(i, col));
2354 if (hasAnnotations &&
2355 annotationCols.hasOwnProperty(col) &&
2356 data.getValue(i, annotationCols[col][0]) != null) {
2357 var ann = {};
2358 ann.series = data.getColumnLabel(col);
2359 ann.xval = row[0];
2360 ann.shortText = String.fromCharCode(65 /* A */ + annotations.length)
2361 ann.text = '';
2362 for (var k = 0; k < annotationCols[col].length; k++) {
2363 if (k) ann.text += "\n";
2364 ann.text += data.getValue(i, annotationCols[col][k]);
2365 }
2366 annotations.push(ann);
2367 }
3e3f84e4
DV
2368 }
2369 } else {
2370 for (var j = 0; j < cols - 1; j++) {
2371 row.push([ data.getValue(i, 1 + 2 * j), data.getValue(i, 2 + 2 * j) ]);
2372 }
79420a1e 2373 }
987840a2
DV
2374 if (ret.length > 0 && row[0] < ret[ret.length - 1][0]) {
2375 outOfOrder = true;
2376 }
243d96e8 2377 ret.push(row);
79420a1e 2378 }
987840a2
DV
2379
2380 if (outOfOrder) {
2381 this.warn("DataTable is out of order; order it correctly to speed loading.");
2382 ret.sort(function(a,b) { return a[0] - b[0] });
2383 }
a685723c
DV
2384 this.rawData_ = ret;
2385
2386 if (annotations.length > 0) {
2387 this.setAnnotations(annotations, true);
2388 }
79420a1e
DV
2389}
2390
24e5350c 2391// These functions are all based on MochiKit.
fc80a396
DV
2392Dygraph.update = function (self, o) {
2393 if (typeof(o) != 'undefined' && o !== null) {
2394 for (var k in o) {
85b99f0b
DV
2395 if (o.hasOwnProperty(k)) {
2396 self[k] = o[k];
2397 }
fc80a396
DV
2398 }
2399 }
2400 return self;
2401};
2402
2dda3850
DV
2403Dygraph.isArrayLike = function (o) {
2404 var typ = typeof(o);
2405 if (
c21d2c2d 2406 (typ != 'object' && !(typ == 'function' &&
2dda3850
DV
2407 typeof(o.item) == 'function')) ||
2408 o === null ||
2409 typeof(o.length) != 'number' ||
2410 o.nodeType === 3
2411 ) {
2412 return false;
2413 }
2414 return true;
2415};
2416
2417Dygraph.isDateLike = function (o) {
2418 if (typeof(o) != "object" || o === null ||
2419 typeof(o.getTime) != 'function') {
2420 return false;
2421 }
2422 return true;
2423};
2424
e3ab7b40
DV
2425Dygraph.clone = function(o) {
2426 // TODO(danvk): figure out how MochiKit's version works
2427 var r = [];
2428 for (var i = 0; i < o.length; i++) {
2429 if (Dygraph.isArrayLike(o[i])) {
2430 r.push(Dygraph.clone(o[i]));
2431 } else {
2432 r.push(o[i]);
2433 }
2434 }
2435 return r;
24e5350c
DV
2436};
2437
2dda3850 2438
79420a1e 2439/**
6a1aa64f
DV
2440 * Get the CSV data. If it's in a function, call that function. If it's in a
2441 * file, do an XMLHttpRequest to get it.
2442 * @private
2443 */
285a6bda 2444Dygraph.prototype.start_ = function() {
6a1aa64f 2445 if (typeof this.file_ == 'function') {
285a6bda 2446 // CSV string. Pretend we got it via XHR.
6a1aa64f 2447 this.loadedEvent_(this.file_());
2dda3850 2448 } else if (Dygraph.isArrayLike(this.file_)) {
285a6bda
DV
2449 this.rawData_ = this.parseArray_(this.file_);
2450 this.drawGraph_(this.rawData_);
79420a1e
DV
2451 } else if (typeof this.file_ == 'object' &&
2452 typeof this.file_.getColumnRange == 'function') {
2453 // must be a DataTable from gviz.
a685723c 2454 this.parseDataTable_(this.file_);
79420a1e 2455 this.drawGraph_(this.rawData_);
285a6bda
DV
2456 } else if (typeof this.file_ == 'string') {
2457 // Heuristic: a newline means it's CSV data. Otherwise it's an URL.
2458 if (this.file_.indexOf('\n') >= 0) {
2459 this.loadedEvent_(this.file_);
2460 } else {
2461 var req = new XMLHttpRequest();
2462 var caller = this;
2463 req.onreadystatechange = function () {
2464 if (req.readyState == 4) {
2465 if (req.status == 200) {
2466 caller.loadedEvent_(req.responseText);
2467 }
6a1aa64f 2468 }
285a6bda 2469 };
6a1aa64f 2470
285a6bda
DV
2471 req.open("GET", this.file_, true);
2472 req.send(null);
2473 }
2474 } else {
2475 this.error("Unknown data format: " + (typeof this.file_));
6a1aa64f
DV
2476 }
2477};
2478
2479/**
2480 * Changes various properties of the graph. These can include:
2481 * <ul>
2482 * <li>file: changes the source data for the graph</li>
2483 * <li>errorBars: changes whether the data contains stddev</li>
2484 * </ul>
2485 * @param {Object} attrs The new properties and values
2486 */
285a6bda
DV
2487Dygraph.prototype.updateOptions = function(attrs) {
2488 // TODO(danvk): this is a mess. Rethink this function.
6a1aa64f
DV
2489 if (attrs.rollPeriod) {
2490 this.rollPeriod_ = attrs.rollPeriod;
2491 }
2492 if (attrs.dateWindow) {
2493 this.dateWindow_ = attrs.dateWindow;
2494 }
2495 if (attrs.valueRange) {
2496 this.valueRange_ = attrs.valueRange;
2497 }
450fe64b
DV
2498
2499 // TODO(danvk): validate per-series options.
46dde5f9
DV
2500 // Supported:
2501 // strokeWidth
2502 // pointSize
2503 // drawPoints
2504 // highlightCircleSize
450fe64b 2505
fc80a396 2506 Dygraph.update(this.user_attrs_, attrs);
87bb7958 2507 Dygraph.update(this.renderOptions_, attrs);
285a6bda
DV
2508
2509 this.labelsFromCSV_ = (this.attr_("labels") == null);
2510
2511 // TODO(danvk): this doesn't match the constructor logic
2512 this.layout_.updateOptions({ 'errorBars': this.attr_("errorBars") });
5e50289f 2513 if (attrs['file']) {
6a1aa64f
DV
2514 this.file_ = attrs['file'];
2515 this.start_();
2516 } else {
2517 this.drawGraph_(this.rawData_);
2518 }
2519};
2520
2521/**
697e70b2
DV
2522 * Resizes the dygraph. If no parameters are specified, resizes to fill the
2523 * containing div (which has presumably changed size since the dygraph was
2524 * instantiated. If the width/height are specified, the div will be resized.
964f30c6
DV
2525 *
2526 * This is far more efficient than destroying and re-instantiating a
2527 * Dygraph, since it doesn't have to reparse the underlying data.
2528 *
697e70b2
DV
2529 * @param {Number} width Width (in pixels)
2530 * @param {Number} height Height (in pixels)
2531 */
2532Dygraph.prototype.resize = function(width, height) {
e8c7ef86
DV
2533 if (this.resize_lock) {
2534 return;
2535 }
2536 this.resize_lock = true;
2537
697e70b2
DV
2538 if ((width === null) != (height === null)) {
2539 this.warn("Dygraph.resize() should be called with zero parameters or " +
2540 "two non-NULL parameters. Pretending it was zero.");
2541 width = height = null;
2542 }
2543
b16e6369 2544 // TODO(danvk): there should be a clear() method.
697e70b2 2545 this.maindiv_.innerHTML = "";
b16e6369
DV
2546 this.attrs_.labelsDiv = null;
2547
697e70b2
DV
2548 if (width) {
2549 this.maindiv_.style.width = width + "px";
2550 this.maindiv_.style.height = height + "px";
2551 this.width_ = width;
2552 this.height_ = height;
2553 } else {
2554 this.width_ = this.maindiv_.offsetWidth;
2555 this.height_ = this.maindiv_.offsetHeight;
2556 }
2557
2558 this.createInterface_();
964f30c6 2559 this.drawGraph_(this.rawData_);
e8c7ef86
DV
2560
2561 this.resize_lock = false;
697e70b2
DV
2562};
2563
2564/**
6a1aa64f
DV
2565 * Adjusts the number of days in the rolling average. Updates the graph to
2566 * reflect the new averaging period.
2567 * @param {Number} length Number of days over which to average the data.
2568 */
285a6bda 2569Dygraph.prototype.adjustRoll = function(length) {
6a1aa64f
DV
2570 this.rollPeriod_ = length;
2571 this.drawGraph_(this.rawData_);
2572};
540d00f1 2573
f8cfec73 2574/**
1cf11047
DV
2575 * Returns a boolean array of visibility statuses.
2576 */
2577Dygraph.prototype.visibility = function() {
2578 // Do lazy-initialization, so that this happens after we know the number of
2579 // data series.
2580 if (!this.attr_("visibility")) {
f38dec01 2581 this.attrs_["visibility"] = [];
1cf11047
DV
2582 }
2583 while (this.attr_("visibility").length < this.rawData_[0].length - 1) {
f38dec01 2584 this.attr_("visibility").push(true);
1cf11047
DV
2585 }
2586 return this.attr_("visibility");
2587};
2588
2589/**
2590 * Changes the visiblity of a series.
2591 */
2592Dygraph.prototype.setVisibility = function(num, value) {
2593 var x = this.visibility();
2594 if (num < 0 && num >= x.length) {
2595 this.warn("invalid series number in setVisibility: " + num);
2596 } else {
2597 x[num] = value;
2598 this.drawGraph_(this.rawData_);
2599 }
2600};
2601
2602/**
5c528fa2
DV
2603 * Update the list of annotations and redraw the chart.
2604 */
a685723c 2605Dygraph.prototype.setAnnotations = function(ann, suppressDraw) {
5c528fa2
DV
2606 this.annotations_ = ann;
2607 this.layout_.setAnnotations(this.annotations_);
a685723c
DV
2608 if (!suppressDraw) {
2609 this.drawGraph_(this.rawData_);
2610 }
5c528fa2
DV
2611};
2612
2613/**
2614 * Return the list of annotations.
2615 */
2616Dygraph.prototype.annotations = function() {
2617 return this.annotations_;
2618};
2619
46dde5f9
DV
2620/**
2621 * Get the index of a series (column) given its name. The first column is the
2622 * x-axis, so the data series start with index 1.
2623 */
2624Dygraph.prototype.indexFromSetName = function(name) {
2625 var labels = this.attr_("labels");
2626 for (var i = 0; i < labels.length; i++) {
2627 if (labels[i] == name) return i;
2628 }
2629 return null;
2630};
2631
5c528fa2
DV
2632Dygraph.addAnnotationRule = function() {
2633 if (Dygraph.addedAnnotationCSS) return;
2634
18a016b1
DV
2635 var mysheet;
2636 if (document.styleSheets.length > 0) {
2637 mysheet = document.styleSheets[0];
2638 } else {
2639 var styleSheetElement = document.createElement("style");
2640 styleSheetElement.type = "text/css";
2641 document.getElementsByTagName("head")[0].appendChild(styleSheetElement);
2642 for(i = 0; i < document.styleSheets.length; i++) {
2643 if (document.styleSheets[i].disabled) continue;
2644 mysheet = document.styleSheets[i];
2645 }
2646 }
2647
5c528fa2
DV
2648 var rule = "border: 1px solid black; " +
2649 "background-color: white; " +
2650 "text-align: center;";
2651 if (mysheet.insertRule) { // Firefox
b39466eb 2652 mysheet.insertRule(".dygraphDefaultAnnotation { " + rule + " }", 0);
5c528fa2
DV
2653 } else if (mysheet.addRule) { // IE
2654 mysheet.addRule(".dygraphDefaultAnnotation", rule);
2655 }
2656
2657 Dygraph.addedAnnotationCSS = true;
2658}
2659
2660/**
f8cfec73
DV
2661 * Create a new canvas element. This is more complex than a simple
2662 * document.createElement("canvas") because of IE and excanvas.
2663 */
2664Dygraph.createCanvas = function() {
2665 var canvas = document.createElement("canvas");
2666
2667 isIE = (/MSIE/.test(navigator.userAgent) && !window.opera);
2668 if (isIE) {
2669 canvas = G_vmlCanvasManager.initElement(canvas);
2670 }
2671
2672 return canvas;
2673};
2674
540d00f1
DV
2675
2676/**
285a6bda 2677 * A wrapper around Dygraph that implements the gviz API.
540d00f1
DV
2678 * @param {Object} container The DOM object the visualization should live in.
2679 */
285a6bda 2680Dygraph.GVizChart = function(container) {
540d00f1
DV
2681 this.container = container;
2682}
2683
285a6bda 2684Dygraph.GVizChart.prototype.draw = function(data, options) {
540d00f1 2685 this.container.innerHTML = '';
285a6bda 2686 this.date_graph = new Dygraph(this.container, data, options);
540d00f1 2687}
285a6bda 2688
239c712d
NAG
2689/**
2690 * Google charts compatible setSelection
50360fd0 2691 * Only row selection is supported, all points in the row will be highlighted
239c712d
NAG
2692 * @param {Array} array of the selected cells
2693 * @public
2694 */
2695Dygraph.GVizChart.prototype.setSelection = function(selection_array) {
2696 var row = false;
2697 if (selection_array.length) {
2698 row = selection_array[0].row;
2699 }
2700 this.date_graph.setSelection(row);
2701}
2702
103b7292
NAG
2703/**
2704 * Google charts compatible getSelection implementation
2705 * @return {Array} array of the selected cells
2706 * @public
2707 */
2708Dygraph.GVizChart.prototype.getSelection = function() {
2709 var selection = [];
50360fd0 2710
103b7292 2711 var row = this.date_graph.getSelection();
50360fd0 2712
103b7292 2713 if (row < 0) return selection;
50360fd0 2714
103b7292
NAG
2715 col = 1;
2716 for (var i in this.date_graph.layout_.datasets) {
2717 selection.push({row: row, column: col});
2718 col++;
2719 }
2720
2721 return selection;
2722}
2723
285a6bda
DV
2724// Older pages may still use this name.
2725DateGraph = Dygraph;