-
Notifications
You must be signed in to change notification settings - Fork 3
/
Copy pathREADME.Rmd
119 lines (78 loc) · 4.1 KB
/
README.Rmd
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
---
output: github_document
always_allow_html: no
editor_options:
chunk_output_type: console
---
<!-- README.md is generated from README.Rmd. Please edit that file -->
```{r, echo = FALSE}
knitr::opts_chunk$set(
collapse = TRUE,
comment = "#>",
warning = FALSE,
fig.path = "man/figures/README-"
)
```
# parcats <a href='https://erblast.github.io/parcats/'><img src='man/figures/logo.png' align="right" height="139" /></a>
<!-- badges: start -->
[](https://app.codecov.io/gh/erblast/parcats?branch=master)
[](https://CRAN.R-project.org/package=parcats)
[](https://cran.r-project.org/package=parcats)
[](https://cran.r-project.org/package=parcats)
[](https://cran.r-project.org/package=parcats)
[](https://github.com/erblast/parcats/actions)
<!-- badges: end -->
###### Create 'plotly.js' Parallel Categories Diagrams Using this Htmlwidget and 'easyalluvial'
Complex graphical representations of data are best explored using interactive elements.
'parcats' adds interactive graphing capabilities to the 'easyalluvial' package.
The 'plotly.js' parallel categories diagrams offer a good framework for
creating interactive flow graphs that allow manual drag and drop sorting of dimensions
and categories, highlighting single flows and displaying mouse over information. The
'plotly.js' dependency is quite heavy and therefore is outsourced into a separate package.
## Installation
### CRAN
```{r cran, eval = FALSE }
install.packages('parcats')
```
### Development Version
```{r gh-installation, eval = FALSE}
# install.packages("devtools")
devtools::install_github("erblast/parcats")
```
## easyalluvial
`parcats` requires an alluvial plot created with `easyalluvial` to create an interactive parrallel categories diagram.
- [easyalluvial documentation](https://erblast.github.io/easyalluvial/)
- [easyalluvial github page](https://github.com/erblast/easyalluvial)
## Examples
```{r}
suppressPackageStartupMessages(require(tidyverse))
suppressPackageStartupMessages(require(easyalluvial))
suppressPackageStartupMessages(require(parcats))
```
### Shiny Demo
The shiny demo allows you to interactively explore the parameters of `alluvial_wide()` and `parcats()`
```{r eval = FALSE}
parcats_demo()
```
### Live Widget
The Htmlwidgets cannot be embedded in the `README.md` file. Check out the [Live Widget here](https://erblast.github.io/parcats/articles/parcats.html).
### Parcats from alluvial from data in wide format
```{r eval = FALSE}
p <- alluvial_wide(mtcars2, max_variables = 5)
parcats(p, marginal_histograms = TRUE, data_input = mtcars2)
```
### Parcats from model response alluvial
Machine Learning models operate in a multidimensional space and their response is hard to visualise. Model response and partial dependency plots attempt to visualise ML models in a two dimensional space. Using alluvial plots or parrallel categories diagrams we can increase the number of dimensions.
- [Visualise model response with alluvial plots](https://www.datisticsblog.com/2019/04/visualising-model-response-with-easyalluvial/)
Here we see the response of a random forest model if we vary the three variables with the highest importance while keeping all other features at their median/mode value.
```{r eval = FALSE}
df <- select(mtcars2, -ids )
m <- randomForest::randomForest( disp ~ ., df)
imp <- m$importance
dspace <- get_data_space(df, imp, degree = 3)
pred <- predict(m, newdata = dspace)
p <- alluvial_model_response(pred, dspace, imp, degree = 3)
parcats(p, marginal_histograms = TRUE, imp = TRUE, data_input = df)
```
