Metadata-Version: 2.4
Name: dayplot
Version: 0.2.2
Summary: Calendar heatmaps with matplotlib
Home-page: https://github.com/JosephBARBIERDARNAL/dayplot
Author: Joseph Barbier
Author-email: Joseph Barbier <joseph.barbierdarnal@gmail.com>
Project-URL: Homepage, https://github.com/JosephBARBIERDARNAL/dayplot
Project-URL: Issues, https://github.com/JosephBARBIERDARNAL/dayplot/issues
Classifier: Programming Language :: Python :: 3
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Classifier: Framework :: Matplotlib
Requires-Python: >=3.9
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: matplotlib
Provides-Extra: data
Requires-Dist: pandas; extra == "data"
Requires-Dist: requests; extra == "data"
Dynamic: author
Dynamic: home-page
Dynamic: license-file

# dayplot

A simple-to-use Python library to build **calendar heatmaps** with ease.

It's built on top of **matplotlib** and leverages it to access high customization possibilities.

<br>

## Quick start

```py
import matplotlib.pyplot as plt

import dayplot as dp
from dayplot.data import load_dataset

df = load_dataset()

fig, ax = plt.subplots(figsize=(15, 6))
dp.calendar(
    dates=df["dates"],
    values=df["values"],
    start_date="2024-01-01",
    end_date="2024-12-31",
    ax=ax,
)
```

![](https://raw.githubusercontent.com/JosephBARBIERDARNAL/dayplot/refs/heads/main/docs/img/quickstart.png)

More examples in the [documentation](https://josephbarbierdarnal.github.io/dayplot/).

[![](https://raw.githubusercontent.com/JosephBARBIERDARNAL/dayplot/refs/heads/main/examples.gif)](https://josephbarbierdarnal.github.io/dayplot/)

<br>

## Installation

```bash
pip install dayplot
```

<br>

## Advanced usage

`dayplot` is designed to fit any matplotlib graph, allowing you to do things like:

![](https://raw.githubusercontent.com/JosephBARBIERDARNAL/dayplot/refs/heads/main/docs/img/advanced/advanced-2.png)

<br>

## Related projects

- [calplot](https://github.com/tomkwok/calplot)
- [july](https://github.com/e-hulten/july)
- [calendarplot](https://github.com/dhowland/calendarplot)

<br><br>
