Welcome to cantuccio’s documentation!

cantuccio: yet another corner plot library

Cantuccio Logo Documentation Status
PyPI version   MIT License

can·tuc·cio | /kan’tutːʃo/ noun [masculine]

  1. an Italian biscuit from Tuscany.

  2. corner, nook.

cantuccio is a Python library for creating corner plots, automatically handling the layout and size of labels, ticks, and legends. It is designed to be flexible and easy to use, allowing users to create publication-quality corner plots with minimal code. When dealing with large datasets, cantuccio can utilize the KDEpy package for faster KDE estimation.

Visual choices are inspired by many of the existing corner plot libraries, with particular credit to corner, chainconsumer, cornetto, and makecorner.

Installation

You can install cantuccio using pip:

This project is managed by uv. To set up the development environment, install uv if needed:

curl -LsSf https://astral.sh/uv/install.sh | sh

Then, clone the repository and install the package in editable mode:

git clone https://github.com/asantini29/cantuccio
cd cantuccio
uv sync
uv run pip install -e .

Alternatively, you can install the latest version directly from PyPI:

pip install cantuccio

Example

Here is a simple example of how to use cantuccio to create a corner plot:

import numpy as np
import cantuccio as ct
# Generate some random data
data = np.random.randn(1000, 3)
labels = ['x', 'y', 'z']
data_dict = {label: data[:, i] for i, label in enumerate(labels)}
# Create a corner plot
fig, axs = ct.cornerplot(data_dict)
fig.show()

AI Statement

This project made use of generative AI. All the outputs have been reviewed and edited to ensure quality and consistency.

License

This project is licensed under the MIT License - see the LICENSE file for details.

Documentation:

Tutorial: