calplot 0.1.6.1

Calendar heatmaps from Pandas time series data

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.

With default configuration:

With arguments edgecolor=None, cmap='YlGn':

With arguments yearcolor=black, cmap='YlGn':

With arguments textformat='{:.0f}', textfiller='-', cmap='YlGn':

With arguments dropzero=False, cmap='YlGn':

With arguments linewidth=0, cmap='YlGn':

Usage

See the documentation.

Code to generate the first example:

import calplot
import numpy as np; np.random.seed(sum(map(ord, 'calplot')))
import pandas as pd
all_days = pd.date_range('1/1/2019', periods=730, freq='D')
days = np.random.choice(all_days, 500)
events = pd.Series(np.random.randn(len(days)), index=days)
calplot.calplot(events)

Installation

To install the latest release via PyPI using pip:

pip install calplot

Changelog

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

Since version 0.1.6 (Dec 2020):

• Added argument textformat for function calplot and yearplot to specify the text format string for grid cell text. Defaults to empty string. Note that text plotting is turned off by setting the argument to empty string.

• Added argument textfiller for function calplot and yearplot to specify the fallback text for grid cell text. Defaults to empty string.

• Added argument textcolor for function calplot and yearplot to specify the text color for grid cell text. Defaults to black.

Since version 0.1.5 (Dec 2020):

• 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 the argument to None without quotes.

Since version 0.1.3 (Aug 2020):

• Removed legacy code for compatibility to fix a FutureWarning in yearplot. Note that pandas>=1.1 is now required to install the package.

Since version 0.1.2 (Jan 2020):

• 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 (Jan 2020):

• Renamed function calendarplot to calplot.

• 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.

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

• Added argument suptitle for function calplot. Defaults to None.

• 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.

• Added argument monthlabelha for function calplot and yearplot to specify horizontal alignment for month labels. Defaults to center.

• Changed default colormap cmap for function calplot to viridis.