eulerr generates area-proportional Euler diagrams that display set relationships (intersections, unions, and disjoints) with circles or ellipses. Euler diagrams are Venn diagrams without the requirement that all set interactions be present (whether they are empty or not), which means that, depending on input, eulerr sometimes produces Venn diagrams and sometimes not.
With three or more sets intersecting, exact Euler diagrams are often impossible. For such cases eulerr attempts to provide a good approximation by numerically tuning the parameters of the ellipses or circles to minimize the error in the resulting diagram. Residuals and goodness of fit statistics are provided to assess whether the resulting diagram can be trusted.
Building eulerr from source requires a Rust
toolchain. The minimum supported rustc version is listed in
the SystemRequirements field of DESCRIPTION
(currently rustc >= 1.88.0). If your system Rust is
older than that, install or update via rustup before installing the package from
source. CRAN binary builds do not need a local Rust toolchain.
install.packages("eulerr")devtools::install_github("jolars/eulerr")eulerr is also available as a web app at https://eunoia.bz/app/.
library(eulerr)
set.seed(26)
# From Wilkinson 2012
fit <- euler(
c(
"A" = 4,
"B" = 6,
"C" = 3,
"D" = 2,
"E" = 7,
"F" = 3,
"A&B" = 2,
"A&F" = 2,
"B&C" = 2,
"B&D" = 1,
"B&F" = 2,
"C&D" = 1,
"D&E" = 1,
"E&F" = 1,
"A&B&F" = 1,
"B&C&D" = 1
),
shape = "ellipse"
)We can inspect the goodness-of-fit metrics diagError and stress for the solution,
fit$stress
#> [1] 1.280319e-19
fit$diagError
#> [1] 6.774157e-11and plot it
plot(fit)
Please see the introductory vignette for a brief introduction or eulerr under the hood for details.
eulerr is based on Eunoia, which is a Rust library for fitting and visualizing Euler and Venn diagrams. The pure-Rust core powers bindings in several languages, all backed by the same fitting engine:
| Language | Package | Install |
|---|---|---|
| Python | eunoia
(repo) |
pip install eunoia |
| Julia | Eunoia.jl
(repo) |
] add Eunoia |
| JavaScript | @jolars/eunoia
(repo) |
npm install @jolars/eunoia |
| Rust | eunoia on crates.io (repo) |
cargo add eunoia |
eulerr is open source software, licensed under the MIT license.
eulerr uses semantic versioning.
Please note that this project is released with a Contributor Code of Conduct. By participating in this project you agree to abide by its terms.
eulerr would not be possible without Ben Frederickson’s work on venn.js or Leland Wilkinson’s venneuler.