Support setting 'better' and using it in expectations.

tools/perf_expectations/make_expectations.py

 #!/usr/bin/python
 # Copyright (c) 2011 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.
 
 
 import hashlib
 import math
 import optparse
 import os
@@ skipping 61 matching lines @@
   return text
 
 
 def GetRowData(data, key):
   rowdata = []
   # reva and revb always come first.
   for subkey in ['reva', 'revb']:
     if subkey in data[key]:
       rowdata.append('"%s": %s' % (subkey, data[key][subkey]))
   # Strings, like type, come next.
-  for subkey in ['type']:
+  for subkey in ['type', 'better']:
     if subkey in data[key]:
       rowdata.append('"%s": "%s"' % (subkey, data[key][subkey]))
   # Finally the main numbers come last.
   for subkey in ['improve', 'regress', 'tolerance']:
     if subkey in data[key]:
       rowdata.append('"%s": %s' % (subkey, data[key][subkey]))
   return rowdata
 
 
 def GetRowDigest(rowdata, key):
@@ skipping 60 matching lines @@
   # Fetch graphs.dat for this combination.
   perfkeys = perf.keys()
   # In perf_expectations.json, ignore the 'load' key.
   perfkeys.remove('load')
   perfkeys.sort()
 
   write_new_expectations = False
   for key in perfkeys:
     value = perf[key]
     tolerance = value.get('tolerance', DEFAULT_TOLERANCE)
+    better = value.get('better', None)
 
     # Verify the checksum.
     original_checksum = value.get('sha1', '')
     if 'sha1' in value:
       del value['sha1']
     rowdata = GetRowData(perf, key)
     computed_checksum = GetRowDigest(rowdata, key)
     if original_checksum == computed_checksum:
       OutputMessage('checksum matches, skipping')
       continue
@@ skipping 87 matching lines @@
       regress = (float(trace_values[tracename]['high']) -
                  float(trace_values[reftracename]['low']))
       improve = (float(trace_values[tracename]['low']) -
                  float(trace_values[reftracename]['high']))
     elif value_type == 'absolute':
       # Calculate assuming high absolutes are regressions and low absolutes are
       # improvements.
       regress = float(trace_values[tracename]['high'])
       improve = float(trace_values[tracename]['low'])
 
-    # At this point, regress > improve.  If regress == improve, we adjust
-    # improve so it is just a little less than regress.  I'm picking on improve
-    # so we keep the sizes assumptions in place for now.
-    if regress == improve:
-      improve = float(regress * 0.99)
+    # So far we've assumed better is lower (regress > improve).  If the actual
+    # values for regress and improve are equal, though, and better was not
+    # specified, alert the user so we don't let them create a new file with
+    # ambiguous rules.
+    if better == None and regress == improve:
+      OutputMessage('regress (%s) is equal to improve (%s), and "better" is '
+                    'unspecified, please fix by setting "better": "lower" or '
+                    '"better": "higher" in this perf trace\'s expectation' % (
+                    regress, improve), verbose_message=False)
+      return 1
 
     # If the existing values assume regressions are low deltas relative to
     # improvements, swap our regress and improve.  This value must be a
     # scores-like result.
     if ('regress' in perf[key] and 'improve' in perf[key] and
         perf[key]['regress'] < perf[key]['improve']):
+      assert(better != 'lower')
+      better = 'higher'
       temp = regress
       regress = improve
       improve = temp
-    if regress < improve:
+    else:
+      assert(better != 'higher')
+      better = 'lower'
+
+    if better == 'higher':
       regress = int(math.floor(regress - abs(regress*tolerance)))
       improve = int(math.ceil(improve + abs(improve*tolerance)))
     else:
       improve = int(math.floor(improve - abs(improve*tolerance)))
       regress = int(math.ceil(regress + abs(regress*tolerance)))
 
     # Calculate the new checksum to test if this is the only thing that may have
     # changed.
     checksum_rowdata = GetRowData(perf, key)
     new_checksum = GetRowDigest(checksum_rowdata, key)
@@ skipping 16 matching lines @@
     WriteJson(perf_file, perf, perfkeys)
     print 'done'
   else:
     if options.verbose:
       print ''
     print 'No changes.'
 
 
 if __name__ == '__main__':
   sys.exit(Main(sys.argv))