Skip to main content
Join the official Python Developers Survey 2018 and win valuable prizes: Start the survey!

pprofile + matplotlib = Python program profiled as an awesome heatmap!

Project description

pypiv pyv Licence Build Status 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 CHANGELOG.rst for more information.

Using pip

pip install py-heat

Directly from the repository

git clone
python pyheat/ 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.

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Filename, size & hash SHA256 hash help File type Python version Upload date
py-heat-0.0.2.tar.gz (6.2 kB) Copy SHA256 hash SHA256 Source None Jun 6, 2017

Supported by

Elastic Elastic Search Pingdom Pingdom Monitoring Google Google BigQuery Sentry Sentry Error logging AWS AWS Cloud computing DataDog DataDog Monitoring Fastly Fastly CDN SignalFx SignalFx Supporter DigiCert DigiCert EV certificate StatusPage StatusPage Status page