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