scatterD3 is an HTML R widget for interactive scatter plots visualization.
It is based on the htmlwidgets R package and on
the d3.js javascript library.
Features
Here is a small preview of what you will get :
- The
visual guide gives a list of features and examples.
- The sample shiny app allows to live test the package features and its shiny integration.
Installation
Install latest stable release from CRAN :
install.packages("scatterD3")Or from Github for the latest, bleeding edge, full of bugs version :
devtools::install_github("juba/scatterD3")Usage
Quick example of the scatterD3 function based on the mtcars dataset :
mtcars$names <- rownames(mtcars)
scatterD3(data = mtcars, x = wt, y = mpg, lab = names,
col_var = cyl, symbol_var = am,
xlab = "Weight", ylab = "Mpg", col_lab = "Cylinders",
symbol_lab = "Manual transmission")See the visual guide for a step-by-step guide and details about the different function arguments.
scatterD3 provides a built-in SVG export of the current widget view. As an HTML widget, you can also include it in an Rmarkdown HTML document while keeping its interactive features.
Shiny integration
Like every R HTML widget, shiny integration is straightforward. But as a D3
widget, scatterD3 is updatable : changes in settings or data can be
displayed via smooth transitions instead of a complete chart redraw, which can
provide interesting visual clues.
Furthermore, scatterD3 provides some additional handlers and callback hooks
for a more complete JavaScript interactivity and integration.
The sample scatterD3 shiny app allows you to see the different features described here. You can check its source code on GitHub and the visual guide for a better understanding of the different arguments.
Credits
This package has been made possible by :
- Michael Bostock's incredible d3.js library and documentation
- RStudio's shiny and htmlwidgets packages
- Susie Lu's d3-legend module
- Rob Moore's article on reusable d3.js charts
- Speros Kokenes' d3 lasso plugin
- Evan Wang's d3-labeler plugin