Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/jolars/eulerr
Area-Proportional Euler and Venn Diagrams with Ellipses
https://github.com/jolars/eulerr
euler-diagram r venn-diagram
Last synced: about 2 months ago
JSON representation
Area-Proportional Euler and Venn Diagrams with Ellipses
- Host: GitHub
- URL: https://github.com/jolars/eulerr
- Owner: jolars
- License: gpl-3.0
- Created: 2016-09-06T06:09:22.000Z (about 8 years ago)
- Default Branch: main
- Last Pushed: 2024-03-28T15:14:52.000Z (6 months ago)
- Last Synced: 2024-07-19T22:27:28.043Z (2 months ago)
- Topics: euler-diagram, r, venn-diagram
- Language: R
- Homepage: https://jolars.github.io/eulerr/
- Size: 67.7 MB
- Stars: 129
- Watchers: 6
- Forks: 18
- Open Issues: 29
-
Metadata Files:
- Readme: README.Rmd
- Funding: .github/FUNDING.yml
- License: LICENSE
Awesome Lists containing this project
README
---
output: github_document
---
```{r, echo = FALSE}
knitr::opts_chunk$set(
collapse = TRUE,
comment = "#>",
fig.path = "man/figures/README-",
dev = "png"
)
```
# eulerr
[](https://github.com/jolars/eulerr/actions)
[](https://app.codecov.io/gh/jolars/eulerr)
[](https://cran.r-project.org/package=eulerr)
**eulerr** generates area-proportional Euler diagrams that display set
relationships (intersections, unions, and disjoints) with circles or ellipses.
[Euler diagrams](https://en.wikipedia.org/wiki/Euler_diagram) 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.
## Installation
### CRAN version
```{r install_cran, eval = FALSE}
install.packages("eulerr")
```
### Development version
```{r install_github, eval = FALSE}
devtools::install_github("jolars/eulerr")
```
### Shiny app
eulerr is also available as a shiny app hosted at
[eulerr.co](https://eulerr.co).
## Usage
```{r specification}
library(eulerr)
# 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,
```{r}
fit$stress
fit$diagError
```
and plot it
```{r plot_method}
plot(fit)
```
Please see [the introductory vignette](https://CRAN.R-project.org/package=eulerr/vignettes/introduction.html)
for a brief introduction or [*eulerr under the hood*](https://CRAN.R-project.org/package=eulerr/vignettes/under-the-hood.html)
for details.
## License
eulerr is open source software, licensed under
[GPL-3](https://github.com/jolars/eulerr/blob/master/LICENSE).
## Versioning
eulerr uses [semantic versioning](https://semver.org).
## Code of conduct
Please note that this project is released with a
[Contributor Code of Conduct](https://github.com/jolars/eulerr/blob/master/CONDUCT.md).
By participating in this project you
agree to abide by its terms.
## Acknowledgements
eulerr would not be possible without Ben Frederickson's work on
[venn.js](http://www.benfrederickson.com) or Leland Wilkinson's
[venneuler](https://cran.r-project.org/package=venneuler).