YJL

Punchcard is a GitHub-sylte punchcard image generator, it plots a CSV data using Pycairo to render the punchcard graph.

Using the data source from StatCounter¹ about quarterly web browser market shares, from Q3 2008 to Q4 2013, for a chart as below would render a punchcard like the one on the right.

There are two ways to use it, a simple command-line interface and programmically as library.

Its command-line doesn’t really have much flexibility other than setting a chart title. If you want to change fonts, colors, grayscale values, sizes, or set diagonal text, you will need to do it programmically.

The command-line syntax is:

$ python punchcard.py input.csv output.png [title]

And programmically:

punchcard(png_path, row_labels, col_labels, data, **kwds)

You could supply key-value pairs of settings for the chart options. But overall, by default, the output quality and result is very good, you probably don’t need those customizations.

Last time that I’ve made a GitHub-like punchcard graph is for blogging times and this generalized version using D3. But are hours-by-days style, not like this library, which only requires a 2-dimension data.

This Python Punchcard library i written in Python 2 by Michael Fogleman, licensed under the MIT License.