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.

  • Fix colorbar misalignment for plots with different dpi values.

Project details

Download files

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

Source Distribution

calplot-0.1.1.tar.gz (7.4 kB view hashes)

Uploaded Source

Built Distribution

calplot-0.1.1-py3-none-any.whl (9.8 kB view hashes)

Uploaded Python 3

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page