Repository files navigation

eulerr generates area-proportional Euler diagrams that display setrelationships (intersections, unions, and disjoints) with circles orellipses.Euler diagramsare Venn diagrams without the requirement that all set interactions bepresent (whether they are empty or not), which means that, depending oninput,eulerr sometimes produces Venn diagrams and sometimes not.

With three or more sets intersecting, exact Euler diagrams are oftenimpossible. For such caseseulerr attempts to provide a goodapproximation by numerically tuning the parameters of the ellipses orcircles to minimize the error in the resulting diagram. Residuals andgoodness of fit statistics are provided to assess whether the resultingdiagram can be trusted.

install.packages("eulerr")

devtools::install_github("jolars/eulerr")

eulerr is also available as a shiny app hosted ateulerr.co.

library(eulerr)# From Wilkinson 2012fit<- 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 metricsdiagError andstress forthe solution,

fit$stress#> [1] 5.056831e-11fit$diagError#> [1] 1.019054e-06

and plot it

plot(fit)

Please seethe introductoryvignettefor a brief introduction oreulerr under thehoodfor details.

eulerr is open source software, licensed underGPL-3.

eulerr usessemantic versioning.

Please note that this project is released with aContributor Code ofConduct. Byparticipating in this project you agree to abide by its terms.

eulerr would not be possible without Ben Frederickson’s work onvenn.js or Leland Wilkinson’svenneuler.