Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/juba/scatterD3
R scatter plot htmlwidget based on D3.js
https://github.com/juba/scatterD3
cran d3 d3js htmlwidgets r shiny
Last synced: about 2 months ago
JSON representation
R scatter plot htmlwidget based on D3.js
- Host: GitHub
- URL: https://github.com/juba/scatterD3
- Owner: juba
- Created: 2015-06-09T08:23:20.000Z (over 9 years ago)
- Default Branch: master
- Last Pushed: 2024-03-04T17:27:47.000Z (7 months ago)
- Last Synced: 2024-07-05T02:31:19.376Z (3 months ago)
- Topics: cran, d3, d3js, htmlwidgets, r, shiny
- Language: JavaScript
- Homepage: https://juba.github.io/scatterD3/
- Size: 9.32 MB
- Stars: 158
- Watchers: 11
- Forks: 24
- Open Issues: 3
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
- awesome-shiny-extensions - scatterD3 - R scatterplot htmlwidget based on D3.js. (Visualization / Scatterplot)
- awesome-r-dataviz - scatterD3 - R scatter plot htmlwidget based on D3.js. (Interactive plots / Miscellaneous)
- jimsghstars - juba/scatterD3 - R scatter plot htmlwidget based on D3.js (JavaScript)
README
# ScatterD3
[](https://cran.r-project.org/package=scatterD3)
[](https://github.com/juba/scatterD3/actions?query=workflow%3AR-CMD-check)
`scatterD3` is an HTML R widget for interactive scatter plots visualization.
It is based on the [htmlwidgets](https://www.htmlwidgets.org/) R package and on
the [d3.js](https://d3js.org/) javascript library.
## Features
Here is a small preview of what you will get :
The [visual guide](https://juba.github.io/scatterD3/articles/introduction.html) gives a list of features and examples.
## Installation
Install from CRAN :
```r
install.packages("scatterD3")
```
Or from Github for the latest development version :
```r
remotes::install_github("juba/scatterD3")
```
## Usage
Quick example of the `scatterD3` function based on the `mtcars` dataset :
```r
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](https://juba.github.io/scatterD3/articles/introduction.html) 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](https://www.htmlwidgets.org/), you can also include it in an [Rmarkdown](https://rmarkdown.rstudio.com/) 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.
You can [check the sample scatterD3 shiny app](https://github.com/juba/scatterD3_shiny_app)
and the [visual guide](https://juba.github.io/scatterD3/articles/introduction.html) for
a better understanding of the different arguments.
## Development notes
This package uses [packer](https://github.com/JohnCoene/packer) to manage JavaScript source code and dependencies. If you want to modify it, you'll need a working installation of [Node.js](https://nodejs.org/en/).
After cloning this repository, run the following in a terminal at the project root :
```sh
npm install --production=false
```
Then, if you modify the JavaScript code in `srcjs`, you'll have to run the following command to bundle and update the widget JavaScript code :
```r
packer::bundle_dev()
```
If you want to ship a minimized production version, use :
```r
packer::bundle_prod()
```
## Credits
This package has been made possible by :
- Mike Bostock's incredible [d3.js](https://d3js.org/) library and documentation
- [htmlwidgets](https://www.htmlwidgets.org/) packages
- [John Coene](https://twitter.com/jdatap)'s [packer](https://github.com/JohnCoene/packer) package
- Susie Lu's [d3-legend](https://github.com/susielu/d3-legend) module
- Rob Moore's [article on reusable d3.js charts](https://www.toptal.com/d3-js/towards-reusable-d3-js-charts)
- Speros Kokenes' [d3 lasso](https://github.com/skokenes/D3-Lasso-Plugin) plugin
- Evan Wang's [d3-labeler](https://github.com/tinker10/D3-Labeler) plugin