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 with default edgecolor Example calendar heatmap with edgecolor set to None

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

  • (Since version 0.1.5) Added argument edgecolor for function calplot and yearplot to specify color of seperation lines between months. Defaults to gray. Note that lines can be turned off by setting argument to None without quotes.

  • (Since version 0.1.4) pandas>=1.1 is now required to install the package. Legacy code for compatibility removed. Fixed a FutureWarning in yearplot.

  • (Since version 0.1.2) Added argument dropzero 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.

  • (Since version 0.1.1) Renamed function calendarplot to calplot.

  • (Since version 0.1.1) Added argument colorbar for function calplot to display a colorbar to the right of the heatmap if more than one unique values in plot. Defaults to True.

  • (Since version 0.1.1) Added argument figsize for function calplot. Defaults to a tighter layout automatically adjusted to fit the number of years in plot.

  • (Since version 0.1.1) Added argument suptitle for function calplot. Defaults to None.

  • (Since version 0.1.1) Added argument yearcolor for function calplot. Defaults to lightgray. Note that the default color is in contrast to whitesmoke, which is the default value for fillcolor.

  • (Since version 0.1.1) Added argument monthlabelha for function calplot and yearplot to specify horizontal alignment for month labels. Defaults to center.

  • (Since version 0.1.1) Changed default colormap cmap for function calplot to viridis.


See the documentation.


To install the latest release via PyPI using pip:

pip install calplot


  • Option to plot a rounded value for the day, or to plot the day of month for each mesh grid cell.

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.5.tar.gz (7.9 kB view hashes)

Uploaded Source

Built Distribution

calplot-0.1.5-py3-none-any.whl (10.2 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