Create and display "comparison statistics" to compare two statistics

tools/perf/measurements/page_cycler.py

 # Copyright (c) 2012 The Chromium Authors. All rights reserved.
 # Use of this source code is governed by a BSD-style license that can be
 # found in the LICENSE file.
 
 """The page cycler measurement.
 
 This measurement registers a window load handler in which is forces a layout and
 then records the value of performance.now(). This call to now() measures the
 time from navigationStart (immediately after the previous page's beforeunload
 event) until after the layout in the page's load event. In addition, two garbage
@@ skipping 161 matching lines @@
         return self._speedindex_metric.IsFinished(tab)
       util.WaitFor(SpeedIndexIsFinished, 60)
       self._speedindex_metric.Stop(page, tab)
       self._speedindex_metric.AddResults(
           tab, results, chart_name=chart_name_prefix+'speed_index')
 
   def DidRunTest(self, browser, results):
     self._memory_metric.AddSummaryResults(results)
     io.IOMetric().AddSummaryResults(browser, results)
 
+    # Add in comparison stats for cold->warm load improvements
+    results.AddComparison('page_load_time', 'cold_times',
+                          'page_load_time', 'warm_times',
+                          'page_load_times', 'cache_improvements')
+
   def IsRunCold(self, url):
     return (self.ShouldRunCold(url) or
             (self._cold_runs_requested and
              self._has_loaded_page[url] == 0))
 
   def ShouldRunCold(self, url):
     # We do the warm runs first for two reasons.  The first is so we can
     # preserve any initial profile cache for as long as possible.
     # The second is that, if we did cold runs first, we'd have a transition
     # page set during which we wanted the run for each URL to both
     # contribute to the cold data and warm the catch for the following
     # warm run, and clearing the cache before the load of the following
     # URL would eliminate the intended warmup for the previous URL.
     return (self._cold_runs_requested and
             self._has_loaded_page[url] >= self._cold_run_start_index)
 
   def results_are_the_same_on_every_page(self):
     return not self._cold_runs_requested