eunoia 0.5.0

Area-proportional Euler and Venn diagrams

Eunoia

Python bindings for the Eunoia, a Rust library for fitting area-proportional Euler and Venn diagrams. Sister package to the R package eulerr.

Install

pip install eunoia

Quickstart

import eunoia as eu
import matplotlib.pyplot as plt

# Disjoint (per-region) input is the default.
fit = eu.euler({"A": 10, "B": 5, "A&B": 3})
print(fit)
# EulerFit (2 circles, diag_error=2.776e-17, stress=5.887e-33, loss=5.887e-33)
#                  original      fitted    residual regionError
#   A                    10          10           0           0
#   B                     5           5           0           0
#   A&B                   3           3   8.882e-16   2.776e-17

fit.plot()
plt.show()

euler() also accepts inclusive counts, DataFrames, and NumPy arrays; shape= switches between circles, ellipses, squares, and rectangles; venn() draws topological diagrams; and eunoia.options(...) sets global plotting defaults. See the documentation for the full API.

Documentation

Full documentation, including narrative guides and the API reference, lives at jolars.github.io/eunoia-py.

Ecosystem

This package is the Python member of the Eunoia family. The same Rust core powers bindings in several other languages:

Language	Package	Install
Rust	eunoia (repo)	cargo add eunoia
JavaScript	@jolars/eunoia (repo)	npm install @jolars/eunoia
Julia	Eunoia.jl (repo)	] add Eunoia
R	eulerr (repo)	install.packages("eulerr")

Documentation for the whole family lives at eunoia.bz/docs/; the Rust API reference is at docs.rs/eunoia.

License

MIT