ProfileEye - browser-based visualization frontend ================================================= ProfileEye is a broswer-based visualization frontend for `gprof2dot `_ and `graphviz `_. The former is a great tool for parsing profiler outputs and building relevant statstics, and the latter contains excellent graph-placement algorithms. Unfortunately, their outputs are static images. Modern Javascript libraries, e.g., `d3.js `_, do a superior job at dynamic information-rich visualizations. ProfileEye combines these three, with the former two serving as a backend, and the latter serving as a frontend. Contents: .. toctree:: :maxdepth: 2 index ============ Requirements ============ This tool requires the following: * `Python `_ * `six `_ * `Graphviz `_ * `gprof2dot `_ * `jinja2 `_ ============ Installation ============ Install the package via pip, as so: .. code-block:: bash $ pip install ProfileEye or, depending on your system's policy on installation, something like so: .. code-block:: bash $ sudo pip install ProfileEye ========== Invocation ========== The invocation is the same as that of gprof2dot, except, at the end, pipe the output through profile_eye and redirect the result to an html file which you can view via a browswer. For example, to use pgprof, run .. code-block:: bash /path/to/your/executable arg1 arg2 gprof path/to/your/executable | gprof2dot | profile_eye > profile_output.html to use the `Python profiler `_, run .. code-block:: bash python -m profile -o output.pstats path/to/your/script arg1 arg2 gprof2dot -f pstats output.pstats | profile_eye --file-colon_line-colon-label-format > profile_output.html .. note:: Note the use of the ``--file-colon_line-colon-label-format`` flag, which tells the script that gprof2dot's output is in the format ::