pprofile + matplotlib = Python program profiled as an awesome heatmap!
Latest commit d4b7381 Feb 20, 2017 @csurfer committed with vishwas.sharma Updating README file with ozroc pull request changes.



Build Status Licence Coverage Status

Profilers are extremely helpful tools. They help us dig deep into code, find and understand performance bottlenecks. But sometimes we just want to lay back, relax and still get a gist of the hot zones in our code.

A picture is worth a thousand words.

So, instead of presenting the data in tabular form, if presented as a heatmap visualization, it makes comprehending the time distribution in the given program much easier and quicker. That is exactly what is being done here !



  • Simple CLI interface.
  • No complicated setup.
  • Heatmap visualization to view hot zones in code.
  • Ability to export the heatmap as an image file.


NOTE: Installation using pip would correspond to the latest release. Github repo on the other hand contains released features/bug fixes and the unreleased changes. Refer to HISTORY.rst for more information.

Using pip

pip install py-heat

Directly from the repository

git clone https://github.com/csurfer/pyheat.git
python pyheat/setup.py install


As a command

# To view the heatmap.
pyheat <path_to_python_file>
# To output the heatmap as a file.
pyheat <path_to_python_file> --out image_file.png
pyheat --help

As a module

from pyheat import PyHeat
ph = PyHeat(<file_path>)
# To view the heatmap.
# To output the heatmap as a file.


Bug Reports and Feature Requests

Please use issue tracker for reporting bugs or feature requests.


Pull requests are most welcome.