Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/mgimond/tukeyedar

An R package of Tukey inspired exploratory data analysis functions
https://github.com/mgimond/tukeyedar

eda hoaglin r resistant-line robust-visualization tukey velleman

Last synced: about 2 months ago
JSON representation

An R package of Tukey inspired exploratory data analysis functions

Awesome Lists containing this project

README

        

---
output: github_document
bibliography: ref.bib
---

```{r, include = FALSE}
knitr::opts_chunk$set(
collapse = TRUE,
comment = "#>",
fig.path = "man/figures/README-",
out.width = "100%"
)
```

# tukeyedar

[![Lifecycle:
experimental](https://img.shields.io/badge/lifecycle-experimental-orange.svg)](https://lifecycle.r-lib.org/articles/stages.html#experimental)
[![R-CMD-check](https://github.com/mgimond/tukeyedar/actions/workflows/R-CMD-check.yaml/badge.svg)](https://github.com/mgimond/tukeyedar/actions/workflows/R-CMD-check.yaml)

The `tukeyedar` package houses data exploration tools. Many functions are inspired by work published by
@eda1977, @understanding_eda1983, @applied_eda1981, and @visdata1993. Note that this package is in beta mode, so use at your own
discretion.

## Installation

You can install the development version of tukeyedar from [GitHub](https://github.com/) with:

```{r eval = FALSE}
# install.packages("devtools")
devtools::install_github("mgimond/tukeyedar")
```

Note that the vignettes will not be automatically generated with the
above command; note too that the vignettes are available on this website
(see next section). If you want a local version of the vignettes, add
the `build_vignettes = TRUE` parameter.

```{r eval = FALSE}
devtools::install_github("mgimond/tukeyedar", build_vignettes = TRUE)
```

If, for some reason the vignettes are not created, you might want to
re-install the package with the `force=TRUE` parameter.

```{r eval = FALSE}
devtools::install_github("mgimond/tukeyedar", build_vignettes = TRUE, force=TRUE)
```

## Vignettes

It’s strongly recommended that you read the vignettes. These can be accessed from this website:

- [A detailed rundown of the resistant line function](https://mgimond.github.io/tukeyedar/articles/RLine.html)
- [The median polish](https://mgimond.github.io/tukeyedar/articles/polish.html)
- [The empirical QQ plot](https://mgimond.github.io/tukeyedar/articles/qq.html)
- [The symmetry QQ plot](https://mgimond.github.io/tukeyedar/articles/symqq.html)

If you chose to have the vignettes locally created when you installed the package, then you can view them locally via `vignette("RLine", package = "tukeyedar")`. If you use a dark themed IDE, the vignettes may not render very well so you might opt to view them in a web browser via the functions `RShowDoc("RLine", package = "tukeyedar")`.

## Using the functions

All functions start with `eda_`. For example, to generate a three point
summary plot of the `mpg` vs. `disp` from the `mtcars` dataset, type:

```{r, fig.height=2.6, fig.width = 3.2, eval=FALSE}
library(tukeyedar)
eda_3pt(mtcars, disp, mpg)
```

Note that most functions are *pipe* friendly. For example, the following works:

```{r eval=FALSE}
# Using R >= 4.1
mtcars |> eda_3pt(disp, mpg)

# Using magrittr (or any of the tidyverse packages)
library(magrittr)
mtcars %>% eda_3pt(disp, mpg)
```

------------------------------------------------------------------------