tools.skpbench.skpbench.SKPBench Class Reference

Public Member Functions
	get_header (cls, outfile=sys.stdout)
	run_warmup (cls, warmup_time, config)
	__init__ (self, src, config, max_stddev, best_result=None)
	__enter__ (self)
	__exit__ (self, exception_type, exception_value, traceback)
	execute (self, hardware)
	terminate (self)

Public Attributes
	src
	config
	max_stddev
	best_result

Static Public Attributes
list	ARGV = [FLAGS.skpbench, '--verbosity', str(FLAGS.verbosity)]

Protected Member Functions
	_schedule_hardware_poll (self)
	_process_result (self, result)

Protected Attributes
	_queue
	_proc
	_monitor
	_hw_poll_timer

Detailed Description

Definition at line 138 of file skpbench.py.

Constructor & Destructor Documentation

__init__()

tools.skpbench.skpbench.SKPBench.__init__	(		self,
			src,
			config,
			max_stddev,
			best_result = None
	)

Definition at line 207 of file skpbench.py.

  def __init__(self, src, config, max_stddev, best_result=None):
    self.src = src
    self.config = config
    self.max_stddev = max_stddev
    self.best_result = best_result
    self._queue = Queue()
    self._proc = None
    self._monitor = None
    self._hw_poll_timer = None
 

Member Function Documentation

__enter__()

tools.skpbench.skpbench.SKPBench.__enter__

(

self

)

Definition at line 217 of file skpbench.py.

  def __enter__(self):
    return self
 

__exit__()

tools.skpbench.skpbench.SKPBench.__exit__	(		self,
			exception_type,
			exception_value,
			traceback
	)

Definition at line 220 of file skpbench.py.

  def __exit__(self, exception_type, exception_value, traceback):
    if self._proc:
      self.terminate()
    if self._hw_poll_timer:
      self._hw_poll_timer.cancel()
 

_process_result()

tools.skpbench.skpbench.SKPBench._process_result (   self,   result  )

protected

Definition at line 273 of file skpbench.py.

  def _process_result(self, result):
    if not self.best_result or result.stddev <= self.best_result.stddev:
      self.best_result = result
    elif FLAGS.verbosity >= 2:
      print("reusing previous result for %s/%s with lower stddev "
            "(%s%% instead of %s%%)." %
            (result.config, result.bench, self.best_result.stddev,
             result.stddev), file=sys.stderr)
    if self.max_stddev and self.best_result.stddev > self.max_stddev:
      raise StddevException()
 

_schedule_hardware_poll()

tools.skpbench.skpbench.SKPBench._schedule_hardware_poll (   self )

protected

Definition at line 266 of file skpbench.py.

  def _schedule_hardware_poll(self):
    if self._hw_poll_timer:
      self._hw_poll_timer.cancel()
    self._hw_poll_timer = \
      Timer(1, lambda: self._queue.put(Message(Message.POLL_HARDWARE)))
    self._hw_poll_timer.start()
 

execute()

tools.skpbench.skpbench.SKPBench.execute	(		self,
			hardware
	)

Definition at line 226 of file skpbench.py.

  def execute(self, hardware):
    hardware.sanity_check()
    self._schedule_hardware_poll()
 
    commandline = self.ARGV + ['--config', self.config,
                               '--src', self.src,
                               '--suppressHeader', 'true']
    if FLAGS.write_path:
      pngfile = _path.join(FLAGS.write_path, self.config,
                           _path.basename(self.src) + '.png')
      commandline.extend(['--png', pngfile])
    dump_commandline_if_verbose(commandline)
    self._proc = subprocess.Popen(commandline, stdout=subprocess.PIPE,
                                  stderr=subprocess.STDOUT)
    self._monitor = SubprocessMonitor(self._queue, self._proc)
    self._monitor.start()
 
    while True:
      message = self._queue.get()
      if message.message == Message.READLINE:
        result = BenchResult.match(message.value)
        if result:
          hardware.sanity_check()
          self._process_result(result)
        elif hardware.filter_line(message.value):
          print(message.value, file=sys.stderr)
        continue
      if message.message == Message.POLL_HARDWARE:
        hardware.sanity_check()
        self._schedule_hardware_poll()
        continue
      if message.message == Message.EXIT:
        self._monitor.join()
        self._proc.wait()
        if self._proc.returncode != 0:
          raise Exception("skpbench exited with nonzero exit code %i" %
                          self._proc.returncode)
        self._proc = None
        break
 

get_header()

tools.skpbench.skpbench.SKPBench.get_header	(		cls,
			outfile = sys.stdout
	)

Definition at line 183 of file skpbench.py.

  def get_header(cls, outfile=sys.stdout):
    commandline = cls.ARGV + ['--duration', '0']
    dump_commandline_if_verbose(commandline)
    out = subprocess.check_output(commandline, stderr=subprocess.STDOUT, encoding='utf-8')
    return out.rstrip()
 

run_warmup()

tools.skpbench.skpbench.SKPBench.run_warmup	(		cls,
			warmup_time,
			config
	)

Definition at line 190 of file skpbench.py.

  def run_warmup(cls, warmup_time, config):
    if not warmup_time:
      return
    print('running %i second warmup...' % warmup_time, file=sys.stderr)
    commandline = cls.ARGV + ['--duration', str(warmup_time * 1000),
                              '--config', config,
                              '--src', 'warmup']
    dump_commandline_if_verbose(commandline)
    output = subprocess.check_output(commandline, stderr=subprocess.STDOUT, encoding='utf-8')
 
    # validate the warmup run output.
    for line in output.split('\n'):
      match = BenchResult.match(line.rstrip())
      if match and match.bench == 'warmup':
        return
    raise Exception('Invalid warmup output:\n%s' % output)
 

terminate()

tools.skpbench.skpbench.SKPBench.terminate

(

self

)

Definition at line 284 of file skpbench.py.

  def terminate(self):
    if self._proc:
      self._proc.terminate()
      self._monitor.join()
      self._proc.wait()
      self._proc = None
 

Member Data Documentation

_hw_poll_timer

tools.skpbench.skpbench.SKPBench._hw_poll_timer

protected

Definition at line 215 of file skpbench.py.

_monitor

tools.skpbench.skpbench.SKPBench._monitor

protected

Definition at line 214 of file skpbench.py.

_proc

tools.skpbench.skpbench.SKPBench._proc

protected

Definition at line 213 of file skpbench.py.

_queue

tools.skpbench.skpbench.SKPBench._queue

protected

Definition at line 212 of file skpbench.py.

ARGV

list tools.skpbench.skpbench.SKPBench.ARGV = [FLAGS.skpbench, '--verbosity', str(FLAGS.verbosity)]

static

Definition at line 139 of file skpbench.py.

best_result

tools.skpbench.skpbench.SKPBench.best_result

Definition at line 211 of file skpbench.py.

config

tools.skpbench.skpbench.SKPBench.config

Definition at line 209 of file skpbench.py.

max_stddev

tools.skpbench.skpbench.SKPBench.max_stddev

Definition at line 210 of file skpbench.py.

src

tools.skpbench.skpbench.SKPBench.src

Definition at line 208 of file skpbench.py.

---

The documentation for this class was generated from the following file:

• third_party/skia/tools/skpbench/skpbench.py