Skip to content
Snippets Groups Projects
dygraph-combined-dev.js 401 KiB
Newer Older
  • Learn to ignore specific revisions
  • Laura Cappelli's avatar
    Laura Cappelli committed
    6001 6002 6003 6004 6005 6006 6007 6008 6009 6010 6011 6012 6013 6014 6015 6016 6017 6018 6019 6020 6021 6022 6023 6024 6025 6026 6027 6028 6029 6030 6031 6032 6033 6034 6035 6036 6037 6038 6039 6040 6041 6042 6043 6044 6045 6046 6047 6048 6049 6050 6051 6052 6053 6054 6055 6056 6057 6058 6059 6060 6061 6062 6063 6064 6065 6066 6067 6068 6069 6070 6071 6072 6073 6074 6075 6076 6077 6078 6079 6080 6081 6082 6083 6084 6085 6086 6087 6088 6089 6090 6091 6092 6093 6094 6095 6096 6097 6098 6099 6100 6101 6102 6103 6104 6105 6106 6107 6108 6109 6110 6111 6112 6113 6114 6115 6116 6117 6118 6119 6120 6121 6122 6123 6124 6125 6126 6127 6128 6129 6130 6131 6132 6133 6134 6135 6136 6137 6138 6139 6140 6141 6142 6143 6144 6145 6146 6147 6148 6149 6150 6151 6152 6153 6154 6155 6156 6157 6158 6159 6160 6161 6162 6163 6164 6165 6166 6167 6168 6169 6170 6171 6172 6173 6174 6175 6176 6177 6178 6179 6180 6181 6182 6183 6184 6185 6186 6187 6188 6189 6190 6191 6192 6193 6194 6195 6196 6197 6198 6199 6200 6201 6202 6203 6204 6205 6206 6207 6208 6209 6210 6211 6212 6213 6214 6215 6216 6217 6218 6219 6220 6221 6222 6223 6224 6225 6226 6227 6228 6229 6230 6231 6232 6233 6234 6235 6236 6237 6238 6239 6240 6241 6242 6243 6244 6245 6246 6247 6248 6249 6250 6251 6252 6253 6254 6255 6256 6257 6258 6259 6260 6261 6262 6263 6264 6265 6266 6267 6268 6269 6270 6271 6272 6273 6274 6275 6276 6277 6278 6279 6280 6281 6282 6283 6284 6285 6286 6287 6288 6289 6290 6291 6292 6293 6294 6295 6296 6297 6298 6299 6300 6301 6302 6303 6304 6305 6306 6307 6308 6309 6310 6311 6312 6313 6314 6315 6316 6317 6318 6319 6320 6321 6322 6323 6324 6325 6326 6327 6328 6329 6330 6331 6332 6333 6334 6335 6336 6337 6338 6339 6340 6341 6342 6343 6344 6345 6346 6347 6348 6349 6350 6351 6352 6353 6354 6355 6356 6357 6358 6359 6360 6361 6362 6363 6364 6365 6366 6367 6368 6369 6370 6371 6372 6373 6374 6375 6376 6377 6378 6379 6380 6381 6382 6383 6384 6385 6386 6387 6388 6389 6390 6391 6392 6393 6394 6395 6396 6397 6398 6399 6400 6401 6402 6403 6404 6405 6406 6407 6408 6409 6410 6411 6412 6413 6414 6415 6416 6417 6418 6419 6420 6421 6422 6423 6424 6425 6426 6427 6428 6429 6430 6431 6432 6433 6434 6435 6436 6437 6438 6439 6440 6441 6442 6443 6444 6445 6446 6447 6448 6449 6450 6451 6452 6453 6454 6455 6456 6457 6458 6459 6460 6461 6462 6463 6464 6465 6466 6467 6468 6469 6470 6471 6472 6473 6474 6475 6476 6477 6478 6479 6480 6481 6482 6483 6484 6485 6486 6487 6488 6489 6490 6491 6492 6493 6494 6495 6496 6497 6498 6499 6500 6501 6502 6503 6504 6505 6506 6507 6508 6509 6510 6511 6512 6513 6514 6515 6516 6517 6518 6519 6520 6521 6522 6523 6524 6525 6526 6527 6528 6529 6530 6531 6532 6533 6534 6535 6536 6537 6538 6539 6540 6541 6542 6543 6544 6545 6546 6547 6548 6549 6550 6551 6552 6553 6554 6555 6556 6557 6558 6559 6560 6561 6562 6563 6564 6565 6566 6567 6568 6569 6570 6571 6572 6573 6574 6575 6576 6577 6578 6579 6580 6581 6582 6583 6584 6585 6586 6587 6588 6589 6590 6591 6592 6593 6594 6595 6596 6597 6598 6599 6600 6601 6602 6603 6604 6605 6606 6607 6608 6609 6610 6611 6612 6613 6614 6615 6616 6617 6618 6619 6620 6621 6622 6623 6624 6625 6626 6627 6628 6629 6630 6631 6632 6633 6634 6635 6636 6637 6638 6639 6640 6641 6642 6643 6644 6645 6646 6647 6648 6649 6650 6651 6652 6653 6654 6655 6656 6657 6658 6659 6660 6661 6662 6663 6664 6665 6666 6667 6668 6669 6670 6671 6672 6673 6674 6675 6676 6677 6678 6679 6680 6681 6682 6683 6684 6685 6686 6687 6688 6689 6690 6691 6692 6693 6694 6695 6696 6697 6698 6699 6700 6701 6702 6703 6704 6705 6706 6707 6708 6709 6710 6711 6712 6713 6714 6715 6716 6717 6718 6719 6720 6721 6722 6723 6724 6725 6726 6727 6728 6729 6730 6731 6732 6733 6734 6735 6736 6737 6738 6739 6740 6741 6742 6743 6744 6745 6746 6747 6748 6749 6750 6751 6752 6753 6754 6755 6756 6757 6758 6759 6760 6761 6762 6763 6764 6765 6766 6767 6768 6769 6770 6771 6772 6773 6774 6775 6776 6777 6778 6779 6780 6781 6782 6783 6784 6785 6786 6787 6788 6789 6790 6791 6792 6793 6794 6795 6796 6797 6798 6799 6800 6801 6802 6803 6804 6805 6806 6807 6808 6809 6810 6811 6812 6813 6814 6815 6816 6817 6818 6819 6820 6821 6822 6823 6824 6825 6826 6827 6828 6829 6830 6831 6832 6833 6834 6835 6836 6837 6838 6839 6840 6841 6842 6843 6844 6845 6846 6847 6848 6849 6850 6851 6852 6853 6854 6855 6856 6857 6858 6859 6860 6861 6862 6863 6864 6865 6866 6867 6868 6869 6870 6871 6872 6873 6874 6875 6876 6877 6878 6879 6880 6881 6882 6883 6884 6885 6886 6887 6888 6889 6890 6891 6892 6893 6894 6895 6896 6897 6898 6899 6900 6901 6902 6903 6904 6905 6906 6907 6908 6909 6910 6911 6912 6913 6914 6915 6916 6917 6918 6919 6920 6921 6922 6923 6924 6925 6926 6927 6928 6929 6930 6931 6932 6933 6934 6935 6936 6937 6938 6939 6940 6941 6942 6943 6944 6945 6946 6947 6948 6949 6950 6951 6952 6953 6954 6955 6956 6957 6958 6959 6960 6961 6962 6963 6964 6965 6966 6967 6968 6969 6970 6971 6972 6973 6974 6975 6976 6977 6978 6979 6980 6981 6982 6983 6984 6985 6986 6987 6988 6989 6990 6991 6992 6993 6994 6995 6996 6997 6998 6999 7000
        if (obj.x) curleft += obj.x;
        if (obj.y) curtop += obj.y;
      }
    
      // This handles the case where the object is inside a scrolled div.
      while (obj && obj != document.body) {
        curleft -= obj.scrollLeft;
        curtop -= obj.scrollTop;
        obj = obj.parentNode;
      }
      return {x: curleft, y: curtop};
    };
    
    /**
     * Returns the x-coordinate of the event in a coordinate system where the
     * top-left corner of the page (not the window) is (0,0).
     * Taken from MochiKit.Signal
     * @param {!Event} e
     * @return {number}
     * @private
     */
    Dygraph.pageX = function(e) {
      if (e.pageX) {
        return (!e.pageX || e.pageX < 0) ? 0 : e.pageX;
      } else {
        var de = document.documentElement;
        var b = document.body;
        return e.clientX +
            (de.scrollLeft || b.scrollLeft) -
            (de.clientLeft || 0);
      }
    };
    
    /**
     * Returns the y-coordinate of the event in a coordinate system where the
     * top-left corner of the page (not the window) is (0,0).
     * Taken from MochiKit.Signal
     * @param {!Event} e
     * @return {number}
     * @private
     */
    Dygraph.pageY = function(e) {
      if (e.pageY) {
        return (!e.pageY || e.pageY < 0) ? 0 : e.pageY;
      } else {
        var de = document.documentElement;
        var b = document.body;
        return e.clientY +
            (de.scrollTop || b.scrollTop) -
            (de.clientTop || 0);
      }
    };
    
    /**
     * Converts page the x-coordinate of the event to pixel x-coordinates on the
     * canvas (i.e. DOM Coords).
     * @param {!Event} e Drag event.
     * @param {!DygraphInteractionContext} context Interaction context object.
     * @return {number} The amount by which the drag has moved to the right.
     */
    Dygraph.dragGetX_ = function(e, context) {
      return Dygraph.pageX(e) - context.px;
    };
    
    /**
     * Converts page the y-coordinate of the event to pixel y-coordinates on the
     * canvas (i.e. DOM Coords).
     * @param {!Event} e Drag event.
     * @param {!DygraphInteractionContext} context Interaction context object.
     * @return {number} The amount by which the drag has moved down.
     */
    Dygraph.dragGetY_ = function(e, context) {
      return Dygraph.pageY(e) - context.py;
    };
    
    /**
     * This returns true unless the parameter is 0, null, undefined or NaN.
     * TODO(danvk): rename this function to something like 'isNonZeroNan'.
     *
     * @param {number} x The number to consider.
     * @return {boolean} Whether the number is zero or NaN.
     * @private
     */
    Dygraph.isOK = function(x) {
      return !!x && !isNaN(x);
    };
    
    /**
     * @param {{x:?number,y:?number,yval:?number}} p The point to consider, valid
     *     points are {x, y} objects
     * @param {boolean=} opt_allowNaNY Treat point with y=NaN as valid
     * @return {boolean} Whether the point has numeric x and y.
     * @private
     */
    Dygraph.isValidPoint = function(p, opt_allowNaNY) {
      if (!p) return false;  // null or undefined object
      if (p.yval === null) return false;  // missing point
      if (p.x === null || p.x === undefined) return false;
      if (p.y === null || p.y === undefined) return false;
      if (isNaN(p.x) || (!opt_allowNaNY && isNaN(p.y))) return false;
      return true;
    };
    
    /**
     * Number formatting function which mimicks the behavior of %g in printf, i.e.
     * either exponential or fixed format (without trailing 0s) is used depending on
     * the length of the generated string.  The advantage of this format is that
     * there is a predictable upper bound on the resulting string length,
     * significant figures are not dropped, and normal numbers are not displayed in
     * exponential notation.
     *
     * NOTE: JavaScript's native toPrecision() is NOT a drop-in replacement for %g.
     * It creates strings which are too long for absolute values between 10^-4 and
     * 10^-6, e.g. '0.00001' instead of '1e-5'. See tests/number-format.html for
     * output examples.
     *
     * @param {number} x The number to format
     * @param {number=} opt_precision The precision to use, default 2.
     * @return {string} A string formatted like %g in printf.  The max generated
     *                  string length should be precision + 6 (e.g 1.123e+300).
     */
    Dygraph.floatFormat = function(x, opt_precision) {
      // Avoid invalid precision values; [1, 21] is the valid range.
      var p = Math.min(Math.max(1, opt_precision || 2), 21);
    
      // This is deceptively simple.  The actual algorithm comes from:
      //
      // Max allowed length = p + 4
      // where 4 comes from 'e+n' and '.'.
      //
      // Length of fixed format = 2 + y + p
      // where 2 comes from '0.' and y = # of leading zeroes.
      //
      // Equating the two and solving for y yields y = 2, or 0.00xxxx which is
      // 1.0e-3.
      //
      // Since the behavior of toPrecision() is identical for larger numbers, we
      // don't have to worry about the other bound.
      //
      // Finally, the argument for toExponential() is the number of trailing digits,
      // so we take off 1 for the value before the '.'.
      return (Math.abs(x) < 1.0e-3 && x !== 0.0) ?
          x.toExponential(p - 1) : x.toPrecision(p);
    };
    
    /**
     * Converts '9' to '09' (useful for dates)
     * @param {number} x
     * @return {string}
     * @private
     */
    Dygraph.zeropad = function(x) {
      if (x < 10) return "0" + x; else return "" + x;
    };
    
    /**
     * Date accessors to get the parts of a calendar date (year, month, 
     * day, hour, minute, second and millisecond) according to local time,
     * and factory method to call the Date constructor with an array of arguments.
     */
    Dygraph.DateAccessorsLocal = {
      getFullYear:     function(d) {return d.getFullYear();},
      getMonth:        function(d) {return d.getMonth();},
      getDate:         function(d) {return d.getDate();},
      getHours:        function(d) {return d.getHours();},
      getMinutes:      function(d) {return d.getMinutes();},
      getSeconds:      function(d) {return d.getSeconds();},
      getMilliseconds: function(d) {return d.getMilliseconds();},
      getDay:          function(d) {return d.getDay();},
      makeDate:        function(y, m, d, hh, mm, ss, ms) {
        return new Date(y, m, d, hh, mm, ss, ms);
      }
    };
    
    /**
     * Date accessors to get the parts of a calendar date (year, month, 
     * day of month, hour, minute, second and millisecond) according to UTC time,
     * and factory method to call the Date constructor with an array of arguments.
     */
    Dygraph.DateAccessorsUTC = {
      getFullYear:     function(d) {return d.getUTCFullYear();},
      getMonth:        function(d) {return d.getUTCMonth();},
      getDate:         function(d) {return d.getUTCDate();},
      getHours:        function(d) {return d.getUTCHours();},
      getMinutes:      function(d) {return d.getUTCMinutes();},
      getSeconds:      function(d) {return d.getUTCSeconds();},
      getMilliseconds: function(d) {return d.getUTCMilliseconds();},
      getDay:          function(d) {return d.getUTCDay();},
      makeDate:        function(y, m, d, hh, mm, ss, ms) {
        return new Date(Date.UTC(y, m, d, hh, mm, ss, ms));
      }
    };
    
    /**
     * Return a string version of the hours, minutes and seconds portion of a date.
     * @param {number} hh The hours (from 0-23)
     * @param {number} mm The minutes (from 0-59)
     * @param {number} ss The seconds (from 0-59)
     * @return {string} A time of the form "HH:MM" or "HH:MM:SS"
     * @private
     */
    Dygraph.hmsString_ = function(hh, mm, ss) {
      var zeropad = Dygraph.zeropad;
      var ret = zeropad(hh) + ":" + zeropad(mm);
      if (ss) {
        ret += ":" + zeropad(ss);
      }
      return ret;
    };
    
    /**
     * Convert a JS date (millis since epoch) to a formatted string.
     * @param {number} time The JavaScript time value (ms since epoch)
     * @param {boolean} utc Wether output UTC or local time
     * @return {string} A date of one of these forms:
     *     "YYYY/MM/DD", "YYYY/MM/DD HH:MM" or "YYYY/MM/DD HH:MM:SS"
     * @private
     */
    Dygraph.dateString_ = function(time, utc) {
      var zeropad = Dygraph.zeropad;
      var accessors = utc ? Dygraph.DateAccessorsUTC : Dygraph.DateAccessorsLocal;
      var date = new Date(time);
      var y = accessors.getFullYear(date);
      var m = accessors.getMonth(date);
      var d = accessors.getDate(date);
      var hh = accessors.getHours(date);
      var mm = accessors.getMinutes(date);
      var ss = accessors.getSeconds(date);
      // Get a year string:
      var year = "" + y;
      // Get a 0 padded month string
      var month = zeropad(m + 1);  //months are 0-offset, sigh
      // Get a 0 padded day string
      var day = zeropad(d);
      var frac = hh * 3600 + mm * 60 + ss;
      var ret = year + "/" + month + "/" + day;
      if (frac) {
        ret += " " + Dygraph.hmsString_(hh, mm, ss);
      }
      return ret;
    };
    
    /**
     * Round a number to the specified number of digits past the decimal point.
     * @param {number} num The number to round
     * @param {number} places The number of decimals to which to round
     * @return {number} The rounded number
     * @private
     */
    Dygraph.round_ = function(num, places) {
      var shift = Math.pow(10, places);
      return Math.round(num * shift)/shift;
    };
    
    /**
     * Implementation of binary search over an array.
     * Currently does not work when val is outside the range of arry's values.
     * @param {number} val the value to search for
     * @param {Array.<number>} arry is the value over which to search
     * @param {number} abs If abs > 0, find the lowest entry greater than val
     *     If abs < 0, find the highest entry less than val.
     *     If abs == 0, find the entry that equals val.
     * @param {number=} low The first index in arry to consider (optional)
     * @param {number=} high The last index in arry to consider (optional)
     * @return {number} Index of the element, or -1 if it isn't found.
     * @private
     */
    Dygraph.binarySearch = function(val, arry, abs, low, high) {
      if (low === null || low === undefined ||
          high === null || high === undefined) {
        low = 0;
        high = arry.length - 1;
      }
      if (low > high) {
        return -1;
      }
      if (abs === null || abs === undefined) {
        abs = 0;
      }
      var validIndex = function(idx) {
        return idx >= 0 && idx < arry.length;
      };
      var mid = parseInt((low + high) / 2, 10);
      var element = arry[mid];
      var idx;
      if (element == val) {
        return mid;
      } else if (element > val) {
        if (abs > 0) {
          // Accept if element > val, but also if prior element < val.
          idx = mid - 1;
          if (validIndex(idx) && arry[idx] < val) {
            return mid;
          }
        }
        return Dygraph.binarySearch(val, arry, abs, low, mid - 1);
      } else if (element < val) {
        if (abs < 0) {
          // Accept if element < val, but also if prior element > val.
          idx = mid + 1;
          if (validIndex(idx) && arry[idx] > val) {
            return mid;
          }
        }
        return Dygraph.binarySearch(val, arry, abs, mid + 1, high);
      }
      return -1;  // can't actually happen, but makes closure compiler happy
    };
    
    /**
     * Parses a date, returning the number of milliseconds since epoch. This can be
     * passed in as an xValueParser in the Dygraph constructor.
     * TODO(danvk): enumerate formats that this understands.
     *
     * @param {string} dateStr A date in a variety of possible string formats.
     * @return {number} Milliseconds since epoch.
     * @private
     */
    Dygraph.dateParser = function(dateStr) {
      var dateStrSlashed;
      var d;
    
      // Let the system try the format first, with one caveat:
      // YYYY-MM-DD[ HH:MM:SS] is interpreted as UTC by a variety of browsers.
      // dygraphs displays dates in local time, so this will result in surprising
      // inconsistencies. But if you specify "T" or "Z" (i.e. YYYY-MM-DDTHH:MM:SS),
      // then you probably know what you're doing, so we'll let you go ahead.
      // Issue: http://code.google.com/p/dygraphs/issues/detail?id=255
      if (dateStr.search("-") == -1 ||
          dateStr.search("T") != -1 || dateStr.search("Z") != -1) {
        d = Dygraph.dateStrToMillis(dateStr);
        if (d && !isNaN(d)) return d;
      }
    
      if (dateStr.search("-") != -1) {  // e.g. '2009-7-12' or '2009-07-12'
        dateStrSlashed = dateStr.replace("-", "/", "g");
        while (dateStrSlashed.search("-") != -1) {
          dateStrSlashed = dateStrSlashed.replace("-", "/");
        }
        d = Dygraph.dateStrToMillis(dateStrSlashed);
      } else if (dateStr.length == 8) {  // e.g. '20090712'
        // TODO(danvk): remove support for this format. It's confusing.
        dateStrSlashed = dateStr.substr(0,4) + "/" + dateStr.substr(4,2) + "/" +
            dateStr.substr(6,2);
        d = Dygraph.dateStrToMillis(dateStrSlashed);
      } else {
        // Any format that Date.parse will accept, e.g. "2009/07/12" or
        // "2009/07/12 12:34:56"
        d = Dygraph.dateStrToMillis(dateStr);
      }
    
      if (!d || isNaN(d)) {
        console.error("Couldn't parse " + dateStr + " as a date");
      }
      return d;
    };
    
    /**
     * This is identical to JavaScript's built-in Date.parse() method, except that
     * it doesn't get replaced with an incompatible method by aggressive JS
     * libraries like MooTools or Joomla.
     * @param {string} str The date string, e.g. "2011/05/06"
     * @return {number} millis since epoch
     * @private
     */
    Dygraph.dateStrToMillis = function(str) {
      return new Date(str).getTime();
    };
    
    // These functions are all based on MochiKit.
    /**
     * Copies all the properties from o to self.
     *
     * @param {!Object} self
     * @param {!Object} o
     * @return {!Object}
     */
    Dygraph.update = function(self, o) {
      if (typeof(o) != 'undefined' && o !== null) {
        for (var k in o) {
          if (o.hasOwnProperty(k)) {
            self[k] = o[k];
          }
        }
      }
      return self;
    };
    
    /**
     * Copies all the properties from o to self.
     *
     * @param {!Object} self
     * @param {!Object} o
     * @return {!Object}
     * @private
     */
    Dygraph.updateDeep = function (self, o) {
      // Taken from http://stackoverflow.com/questions/384286/javascript-isdom-how-do-you-check-if-a-javascript-object-is-a-dom-object
      function isNode(o) {
        return (
          typeof Node === "object" ? o instanceof Node :
          typeof o === "object" && typeof o.nodeType === "number" && typeof o.nodeName==="string"
        );
      }
    
      if (typeof(o) != 'undefined' && o !== null) {
        for (var k in o) {
          if (o.hasOwnProperty(k)) {
            if (o[k] === null) {
              self[k] = null;
            } else if (Dygraph.isArrayLike(o[k])) {
              self[k] = o[k].slice();
            } else if (isNode(o[k])) {
              // DOM objects are shallowly-copied.
              self[k] = o[k];
            } else if (typeof(o[k]) == 'object') {
              if (typeof(self[k]) != 'object' || self[k] === null) {
                self[k] = {};
              }
              Dygraph.updateDeep(self[k], o[k]);
            } else {
              self[k] = o[k];
            }
          }
        }
      }
      return self;
    };
    
    /**
     * @param {*} o
     * @return {boolean}
     * @private
     */
    Dygraph.isArrayLike = function(o) {
      var typ = typeof(o);
      if (
          (typ != 'object' && !(typ == 'function' &&
            typeof(o.item) == 'function')) ||
          o === null ||
          typeof(o.length) != 'number' ||
          o.nodeType === 3
         ) {
        return false;
      }
      return true;
    };
    
    /**
     * @param {Object} o
     * @return {boolean}
     * @private
     */
    Dygraph.isDateLike = function (o) {
      if (typeof(o) != "object" || o === null ||
          typeof(o.getTime) != 'function') {
        return false;
      }
      return true;
    };
    
    /**
     * Note: this only seems to work for arrays.
     * @param {!Array} o
     * @return {!Array}
     * @private
     */
    Dygraph.clone = function(o) {
      // TODO(danvk): figure out how MochiKit's version works
      var r = [];
      for (var i = 0; i < o.length; i++) {
        if (Dygraph.isArrayLike(o[i])) {
          r.push(Dygraph.clone(o[i]));
        } else {
          r.push(o[i]);
        }
      }
      return r;
    };
    
    /**
     * Create a new canvas element. This is more complex than a simple
     * document.createElement("canvas") because of IE and excanvas.
     *
     * @return {!HTMLCanvasElement}
     * @private
     */
    Dygraph.createCanvas = function() {
      var canvas = document.createElement("canvas");
    
      var isIE = (/MSIE/.test(navigator.userAgent) && !window.opera);
      if (isIE && (typeof(G_vmlCanvasManager) != 'undefined')) {
        canvas = G_vmlCanvasManager.initElement(
            /**@type{!HTMLCanvasElement}*/(canvas));
      }
    
      return canvas;
    };
    
    /**
     * Returns the context's pixel ratio, which is the ratio between the device
     * pixel ratio and the backing store ratio. Typically this is 1 for conventional
     * displays, and > 1 for HiDPI displays (such as the Retina MBP).
     * See http://www.html5rocks.com/en/tutorials/canvas/hidpi/ for more details.
     *
     * @param {!CanvasRenderingContext2D} context The canvas's 2d context.
     * @return {number} The ratio of the device pixel ratio and the backing store
     * ratio for the specified context.
     */
    Dygraph.getContextPixelRatio = function(context) {
      try {
        var devicePixelRatio = window.devicePixelRatio;
        var backingStoreRatio = context.webkitBackingStorePixelRatio ||
                                context.mozBackingStorePixelRatio ||
                                context.msBackingStorePixelRatio ||
                                context.oBackingStorePixelRatio ||
                                context.backingStorePixelRatio || 1;
        if (devicePixelRatio !== undefined) {
          return devicePixelRatio / backingStoreRatio;
        } else {
          // At least devicePixelRatio must be defined for this ratio to make sense.
          // We default backingStoreRatio to 1: this does not exist on some browsers
          // (i.e. desktop Chrome).
          return 1;
        }
      } catch (e) {
        return 1;
      }
    };
    
    /**
     * Checks whether the user is on an Android browser.
     * Android does not fully support the <canvas> tag, e.g. w/r/t/ clipping.
     * @return {boolean}
     * @private
     */
    Dygraph.isAndroid = function() {
      return (/Android/).test(navigator.userAgent);
    };
    
    
    /**
     * TODO(danvk): use @template here when it's better supported for classes.
     * @param {!Array} array
     * @param {number} start
     * @param {number} length
     * @param {function(!Array,?):boolean=} predicate
     * @constructor
     */
    Dygraph.Iterator = function(array, start, length, predicate) {
      start = start || 0;
      length = length || array.length;
      this.hasNext = true; // Use to identify if there's another element.
      this.peek = null; // Use for look-ahead
      this.start_ = start;
      this.array_ = array;
      this.predicate_ = predicate;
      this.end_ = Math.min(array.length, start + length);
      this.nextIdx_ = start - 1; // use -1 so initial advance works.
      this.next(); // ignoring result.
    };
    
    /**
     * @return {Object}
     */
    Dygraph.Iterator.prototype.next = function() {
      if (!this.hasNext) {
        return null;
      }
      var obj = this.peek;
    
      var nextIdx = this.nextIdx_ + 1;
      var found = false;
      while (nextIdx < this.end_) {
        if (!this.predicate_ || this.predicate_(this.array_, nextIdx)) {
          this.peek = this.array_[nextIdx];
          found = true;
          break;
        }
        nextIdx++;
      }
      this.nextIdx_ = nextIdx;
      if (!found) {
        this.hasNext = false;
        this.peek = null;
      }
      return obj;
    };
    
    /**
     * Returns a new iterator over array, between indexes start and
     * start + length, and only returns entries that pass the accept function
     *
     * @param {!Array} array the array to iterate over.
     * @param {number} start the first index to iterate over, 0 if absent.
     * @param {number} length the number of elements in the array to iterate over.
     *     This, along with start, defines a slice of the array, and so length
     *     doesn't imply the number of elements in the iterator when accept doesn't
     *     always accept all values. array.length when absent.
     * @param {function(?):boolean=} opt_predicate a function that takes
     *     parameters array and idx, which returns true when the element should be
     *     returned.  If omitted, all elements are accepted.
     * @private
     */
    Dygraph.createIterator = function(array, start, length, opt_predicate) {
      return new Dygraph.Iterator(array, start, length, opt_predicate);
    };
    
    // Shim layer with setTimeout fallback.
    // From: http://paulirish.com/2011/requestanimationframe-for-smart-animating/
    // Should be called with the window context:
    //   Dygraph.requestAnimFrame.call(window, function() {})
    Dygraph.requestAnimFrame = (function() {
      return window.requestAnimationFrame       ||
              window.webkitRequestAnimationFrame ||
              window.mozRequestAnimationFrame    ||
              window.oRequestAnimationFrame      ||
              window.msRequestAnimationFrame     ||
              function (callback) {
                window.setTimeout(callback, 1000 / 60);
              };
    })();
    
    /**
     * Call a function at most maxFrames times at an attempted interval of
     * framePeriodInMillis, then call a cleanup function once. repeatFn is called
     * once immediately, then at most (maxFrames - 1) times asynchronously. If
     * maxFrames==1, then cleanup_fn() is also called synchronously.  This function
     * is used to sequence animation.
     * @param {function(number)} repeatFn Called repeatedly -- takes the frame
     *     number (from 0 to maxFrames-1) as an argument.
     * @param {number} maxFrames The max number of times to call repeatFn
     * @param {number} framePeriodInMillis Max requested time between frames.
     * @param {function()} cleanupFn A function to call after all repeatFn calls.
     * @private
     */
    Dygraph.repeatAndCleanup = function(repeatFn, maxFrames, framePeriodInMillis,
        cleanupFn) {
      var frameNumber = 0;
      var previousFrameNumber;
      var startTime = new Date().getTime();
      repeatFn(frameNumber);
      if (maxFrames == 1) {
        cleanupFn();
        return;
      }
      var maxFrameArg = maxFrames - 1;
    
      (function loop() {
        if (frameNumber >= maxFrames) return;
        Dygraph.requestAnimFrame.call(window, function() {
          // Determine which frame to draw based on the delay so far.  Will skip
          // frames if necessary.
          var currentTime = new Date().getTime();
          var delayInMillis = currentTime - startTime;
          previousFrameNumber = frameNumber;
          frameNumber = Math.floor(delayInMillis / framePeriodInMillis);
          var frameDelta = frameNumber - previousFrameNumber;
          // If we predict that the subsequent repeatFn call will overshoot our
          // total frame target, so our last call will cause a stutter, then jump to
          // the last call immediately.  If we're going to cause a stutter, better
          // to do it faster than slower.
          var predictOvershootStutter = (frameNumber + frameDelta) > maxFrameArg;
          if (predictOvershootStutter || (frameNumber >= maxFrameArg)) {
            repeatFn(maxFrameArg);  // Ensure final call with maxFrameArg.
            cleanupFn();
          } else {
            if (frameDelta !== 0) {  // Don't call repeatFn with duplicate frames.
              repeatFn(frameNumber);
            }
            loop();
          }
        });
      })();
    };
    
    // A whitelist of options that do not change pixel positions.
    var pixelSafeOptions = {
      'annotationClickHandler': true,
      'annotationDblClickHandler': true,
      'annotationMouseOutHandler': true,
      'annotationMouseOverHandler': true,
      'axisLabelColor': true,
      'axisLineColor': true,
      'axisLineWidth': true,
      'clickCallback': true,
      'drawCallback': true,
      'drawHighlightPointCallback': true,
      'drawPoints': true,
      'drawPointCallback': true,
      'drawXGrid': true,
      'drawYGrid': true,
      'fillAlpha': true,
      'gridLineColor': true,
      'gridLineWidth': true,
      'hideOverlayOnMouseOut': true,
      'highlightCallback': true,
      'highlightCircleSize': true,
      'interactionModel': true,
      'isZoomedIgnoreProgrammaticZoom': true,
      'labelsDiv': true,
      'labelsDivStyles': true,
      'labelsDivWidth': true,
      'labelsKMB': true,
      'labelsKMG2': true,
      'labelsSeparateLines': true,
      'labelsShowZeroValues': true,
      'legend': true,
      'panEdgeFraction': true,
      'pixelsPerYLabel': true,
      'pointClickCallback': true,
      'pointSize': true,
      'rangeSelectorPlotFillColor': true,
      'rangeSelectorPlotStrokeColor': true,
      'showLabelsOnHighlight': true,
      'showRoller': true,
      'strokeWidth': true,
      'underlayCallback': true,
      'unhighlightCallback': true,
      'zoomCallback': true
    };
    
    /**
     * This function will scan the option list and determine if they
     * require us to recalculate the pixel positions of each point.
     * TODO: move this into dygraph-options.js
     * @param {!Array.<string>} labels a list of options to check.
     * @param {!Object} attrs
     * @return {boolean} true if the graph needs new points else false.
     * @private
     */
    Dygraph.isPixelChangingOptionList = function(labels, attrs) {
      // Assume that we do not require new points.
      // This will change to true if we actually do need new points.
    
      // Create a dictionary of series names for faster lookup.
      // If there are no labels, then the dictionary stays empty.
      var seriesNamesDictionary = { };
      if (labels) {
        for (var i = 1; i < labels.length; i++) {
          seriesNamesDictionary[labels[i]] = true;
        }
      }
    
      // Scan through a flat (i.e. non-nested) object of options.
      // Returns true/false depending on whether new points are needed.
      var scanFlatOptions = function(options) {
        for (var property in options) {
          if (options.hasOwnProperty(property) &&
              !pixelSafeOptions[property]) {
            return true;
          }
        }
        return false;
      };
    
      // Iterate through the list of updated options.
      for (var property in attrs) {
        if (!attrs.hasOwnProperty(property)) continue;
    
        // Find out of this field is actually a series specific options list.
        if (property == 'highlightSeriesOpts' ||
            (seriesNamesDictionary[property] && !attrs.series)) {
          // This property value is a list of options for this series.
          if (scanFlatOptions(attrs[property])) return true;
        } else if (property == 'series' || property == 'axes') {
          // This is twice-nested options list.
          var perSeries = attrs[property];
          for (var series in perSeries) {
            if (perSeries.hasOwnProperty(series) &&
                scanFlatOptions(perSeries[series])) {
              return true;
            }
          }
        } else {
          // If this was not a series specific option list, check if it's a pixel
          // changing property.
          if (!pixelSafeOptions[property]) return true;
        }
      }
    
      return false;
    };
    
    Dygraph.Circles = {
      DEFAULT : function(g, name, ctx, canvasx, canvasy, color, radius) {
        ctx.beginPath();
        ctx.fillStyle = color;
        ctx.arc(canvasx, canvasy, radius, 0, 2 * Math.PI, false);
        ctx.fill();
      }
      // For more shapes, include extras/shapes.js
    };
    
    /**
     * To create a "drag" interaction, you typically register a mousedown event
     * handler on the element where the drag begins. In that handler, you register a
     * mouseup handler on the window to determine when the mouse is released,
     * wherever that release happens. This works well, except when the user releases
     * the mouse over an off-domain iframe. In that case, the mouseup event is
     * handled by the iframe and never bubbles up to the window handler.
     *
     * To deal with this issue, we cover iframes with high z-index divs to make sure
     * they don't capture mouseup.
     *
     * Usage:
     * element.addEventListener('mousedown', function() {
     *   var tarper = new Dygraph.IFrameTarp();
     *   tarper.cover();
     *   var mouseUpHandler = function() {
     *     ...
     *     window.removeEventListener(mouseUpHandler);
     *     tarper.uncover();
     *   };
     *   window.addEventListener('mouseup', mouseUpHandler);
     * };
     *
     * @constructor
     */
    Dygraph.IFrameTarp = function() {
      /** @type {Array.<!HTMLDivElement>} */
      this.tarps = [];
    };
    
    /**
     * Find all the iframes in the document and cover them with high z-index
     * transparent divs.
     */
    Dygraph.IFrameTarp.prototype.cover = function() {
      var iframes = document.getElementsByTagName("iframe");
      for (var i = 0; i < iframes.length; i++) {
        var iframe = iframes[i];
        var pos = Dygraph.findPos(iframe),
            x = pos.x,
            y = pos.y,
            width = iframe.offsetWidth,
            height = iframe.offsetHeight;
    
        var div = document.createElement("div");
        div.style.position = "absolute";
        div.style.left = x + 'px';
        div.style.top = y + 'px';
        div.style.width = width + 'px';
        div.style.height = height + 'px';
        div.style.zIndex = 999;
        document.body.appendChild(div);
        this.tarps.push(div);
      }
    };
    
    /**
     * Remove all the iframe covers. You should call this in a mouseup handler.
     */
    Dygraph.IFrameTarp.prototype.uncover = function() {
      for (var i = 0; i < this.tarps.length; i++) {
        this.tarps[i].parentNode.removeChild(this.tarps[i]);
      }
      this.tarps = [];
    };
    
    /**
     * Determine whether |data| is delimited by CR, CRLF, LF, LFCR.
     * @param {string} data
     * @return {?string} the delimiter that was detected (or null on failure).
     */
    Dygraph.detectLineDelimiter = function(data) {
      for (var i = 0; i < data.length; i++) {
        var code = data.charAt(i);
        if (code === '\r') {
          // Might actually be "\r\n".
          if (((i + 1) < data.length) && (data.charAt(i + 1) === '\n')) {
            return '\r\n';
          }
          return code;
        }
        if (code === '\n') {
          // Might actually be "\n\r".
          if (((i + 1) < data.length) && (data.charAt(i + 1) === '\r')) {
            return '\n\r';
          }
          return code;
        }
      }
    
      return null;
    };
    
    /**
     * Is one node contained by another?
     * @param {Node} containee The contained node.
     * @param {Node} container The container node.
     * @return {boolean} Whether containee is inside (or equal to) container.
     * @private
     */
    Dygraph.isNodeContainedBy = function(containee, container) {
      if (container === null || containee === null) {
        return false;
      }
      var containeeNode = /** @type {Node} */ (containee);
      while (containeeNode && containeeNode !== container) {
        containeeNode = containeeNode.parentNode;
      }
      return (containeeNode === container);
    };
    
    
    // This masks some numeric issues in older versions of Firefox,
    // where 1.0/Math.pow(10,2) != Math.pow(10,-2).
    /** @type {function(number,number):number} */
    Dygraph.pow = function(base, exp) {
      if (exp < 0) {
        return 1.0 / Math.pow(base, -exp);
      }
      return Math.pow(base, exp);
    };
    
    var RGBA_RE = /^rgba?\((\d{1,3}),\s*(\d{1,3}),\s*(\d{1,3})(?:,\s*([01](?:\.\d+)?))?\)$/;
    
    /**
     * Helper for Dygraph.toRGB_ which parses strings of the form:
     * rgb(123, 45, 67)
     * rgba(123, 45, 67, 0.5)
     * @return parsed {r,g,b,a?} tuple or null.
     */
    function parseRGBA(rgbStr) {
      var bits = RGBA_RE.exec(rgbStr);
      if (!bits) return null;
      var r = parseInt(bits[1], 10),
          g = parseInt(bits[2], 10),
          b = parseInt(bits[3], 10);
      if (bits[4]) {
        return {r: r, g: g, b: b, a: parseFloat(bits[4])};
      } else {
        return {r: r, g: g, b: b};
      }
    }
    
    /**
     * Converts any valid CSS color (hex, rgb(), named color) to an RGB tuple.
     *
     * @param {!string} colorStr Any valid CSS color string.
     * @return {{r:number,g:number,b:number,a:number?}} Parsed RGB tuple.
     * @private
     */
    Dygraph.toRGB_ = function(colorStr) {
      // Strategy: First try to parse colorStr directly. This is fast & avoids DOM
      // manipulation.  If that fails (e.g. for named colors like 'red'), then
      // create a hidden DOM element and parse its computed color.
      var rgb = parseRGBA(colorStr);
      if (rgb) return rgb;
    
      var div = document.createElement('div');
      div.style.backgroundColor = colorStr;
      div.style.visibility = 'hidden';
      document.body.appendChild(div);
      var rgbStr;
      if (window.getComputedStyle) {
        rgbStr = window.getComputedStyle(div, null).backgroundColor;
      } else {
        // IE8
        rgbStr = div.currentStyle.backgroundColor;
      }
      document.body.removeChild(div);
      return parseRGBA(rgbStr);
    };
    
    /**
     * Checks whether the browser supports the &lt;canvas&gt; tag.
     * @param {HTMLCanvasElement=} opt_canvasElement Pass a canvas element as an
     *     optimization if you have one.
     * @return {boolean} Whether the browser supports canvas.
     */
    Dygraph.isCanvasSupported = function(opt_canvasElement) {
      var canvas;
      try {
        canvas = opt_canvasElement || document.createElement("canvas");
        canvas.getContext("2d");
      }
      catch (e) {
        var ie = navigator.appVersion.match(/MSIE (\d\.\d)/);
        var opera = (navigator.userAgent.toLowerCase().indexOf("opera") != -1);
        if ((!ie) || (ie[1] < 6) || (opera))
          return false;
        return true;
      }
      return true;
    };
    
    /**
     * Parses the value as a floating point number. This is like the parseFloat()
     * built-in, but with a few differences:
     * - the empty string is parsed as null, rather than NaN.
     * - if the string cannot be parsed at all, an error is logged.
     * If the string can't be parsed, this method returns null.
     * @param {string} x The string to be parsed
     * @param {number=} opt_line_no The line number from which the string comes.
     * @param {string=} opt_line The text of the line from which the string comes.
     */
    Dygraph.parseFloat_ = function(x, opt_line_no, opt_line) {
      var val = parseFloat(x);