Skip to main content

Calendar heatmaps from Pandas time series data

Project description

Calplot creates heatmaps from Pandas time series data.

Plot Pandas time series data sampled by day in a heatmap per calendar year, similar to GitHub’s contributions plot, using matplotlib.

Example calendar heatmap

Package calplot is a fork of calmap with the following changes and additions.

  • pandas>=0.18 is now required to install the package. Legacy code for compatibility removed. Fixed a FutureWarning in yearplot.
  • Function calendarplot renamed to calplot.
  • Argument colorbar added for function calplot to display a colorbar to the right of the heatmap if more than one unique values in plot. Defaults to True.
  • Argument dropzero added for function calplot and yearplot to specify whether to not fill a cell with a color for days with a zero value. Defaults to True.
  • Argument figsize added for function calplot. Defaults to a tighter layout automatically adjusted to fit the number of years in plot.
  • Argument suptitle added for function calplot. Defaults to None.
  • Argument yearcolor added for function calplot. Defaults to lightgray (in contrast to whitesmoke, the default value for fillcolor).
  • Default colormap cmap for yearplot (and hence calplot) changed to viridis.


See the documentation.


To install the latest release via PyPI using pip:

pip install calplot


  • Option to add a seperating line between months.
  • Option to plot a rounded value for the day or plot the day of month for each mesh grid cell.
  • Option to change horizontal alignment (for example, to the left) for month labels.
  • Fix figsize for yearplot.

Project details

Download files

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

Files for calplot, version 0.1.2
Filename, size File type Python version Upload date Hashes
Filename, size calplot-0.1.2-py3-none-any.whl (9.8 kB) File type Wheel Python version py3 Upload date Hashes View hashes
Filename, size calplot-0.1.2.tar.gz (7.4 kB) File type Source Python version None Upload date Hashes View hashes

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 DigiCert DigiCert EV certificate StatusPage StatusPage Status page