/scope_plot

Generate plots of from Google Benchmark json files

Primary LanguagePythonApache License 2.0Apache-2.0

ScopePlot

Build Status

Plot Google Benchmark results

Getting Started with ScopePlot

ScopePlot is available on PyPI can be installed with pip

$ python -m pip install scope_plot

To install the latest development version from Github

$ python -m pip install git+git://github.com/c3sr/scope_plot.git

To use a version in a local directory

$ python -m pip install -e ${HOME}/repos/scope_plot

If your current Python installation doesn't have pip available, try get-pip.py

After installing ScopePlot you can use it like any other Python module. Here's a very simple example:

$ python -m scope_plot bar data.json

There are multiple subcommands available

$ python -m scope_plot --help

Usage: __main__.py [OPTIONS] COMMAND [ARGS]...

Options:
  --debug / --no-debug  print debug messages to stderr.
  --include DIRECTORY   Search location for input_file in spec.
  --help                Show this message and exit.

Commands:
  bar   Create a bar graph from BENCHMARK and write...
  deps  Create a Makefile dependence
  spec  Create a figure from a spec file

More information about the subcommands can be accessed with python -m scope_plot COMMAND --help, and also in the documentation: bar, spec, deps.

Prerequisites

You may have to install the following for scope_plot to install matplotlib

sudo apt install python-dev libfreetype6-dev and libpng-dev

API Reference

coming soon...

Support / Report Issues

All support requests and issue reports should be filed on Github as an issue. Make sure to follow the template so your request may be as handled as quickly as possible. Please respect contributors by not using personal contacts for support requests.

Contributing

We happily welcome contributions, please see our guide for Contributors for the best places to start and help.

License

scope_plot is made available under the Apache 2.0 License. For more details, see LICENSE.txt.