Science Score: 23.0%
This score indicates how likely this project is to be science-related based on various indicators:
-
○CITATION.cff file
-
✓codemeta.json file
Found codemeta.json file -
○.zenodo.json file
-
○DOI references
-
○Academic publication links
-
✓Committers with academic emails
1 of 14 committers (7.1%) from academic institutions -
○Institutional organization owner
-
○JOSS paper metadata
-
○Scientific vocabulary similarity
Low similarity (16.4%) to scientific vocabulary
Keywords
Keywords from Contributors
Repository
R Interface to D3 Visualizations
Basic Info
- Host: GitHub
- Owner: rstudio
- License: other
- Language: R
- Default Branch: main
- Homepage: https://rstudio.github.io/r2d3
- Size: 15.6 MB
Statistics
- Stars: 523
- Watchers: 37
- Forks: 103
- Open Issues: 40
- Releases: 4
Topics
Metadata Files
README.md
r2d3: R Interface to D3 Visualizations 
The r2d3 package provides a suite of tools for using D3 visualizations with R, including:
Translating R objects into D3 friendly data structures
Rendering D3 scripts within the RStudio Viewer and R Notebooks
Publishing D3 visualizations to the web
Incorporating D3 scripts into R Markdown reports, presentations, and dashboards
Creating interactive D3 applications with Shiny
Distributing D3 based htmlwidgets in R packages
With r2d3, you can bind data from R to D3 visualizations like the ones found on https://github.com/d3/d3/wiki/Gallery, https://bl.ocks.org/, and https://vida.io/explore:
D3 visualizations created with r2d3 work just like R plots within RStudio, R Markdown documents, and Shiny applications.
Getting Started
First, install the package from GitHub as follows:
r
devtools::install_github("rstudio/r2d3")
Next, install the preview release of RStudio v1.2 of RStudio (you need this version of RStudio to take advantage of various integrated tools for authoring D3 scripts with r2d3).
Once you’ve installed the package and the RStudio v1.2 preview release you have the tools required to work with r2d3. Below, we’ll describe basic workflow within RStudio and techniques for including visualizations in R Markdown and Shiny applications.
About D3
Creating data visualizations with r2d3 requires lots of custom SVG graphics programming (similar to creating custom grid graphics in R). It’s therefore a good fit when you need highly custom visualizations that aren’t covered by existing libraries. If on the other hand you are looking for pre-fabricated D3 / JavaScript visualizations, check out the packages created using htmlwidgets, which provide a much higher level interface.
If you are completely new to D3, you may also want to check out the article on Learning D3 before proceeding further.
D3 Scripts
To use r2d3, write a D3 script and then pass R data to it using the
r2d3() function. For example, here’s a simple D3 script that draws a
bar chart (“barchart.js”):
```js // !preview r2d3 data=c(0.3, 0.6, 0.8, 0.95, 0.40, 0.20)
var barHeight = Math.floor(height / data.length);
svg .selectAll("rect") .data(data) .enter() .append("rect") .attr("width", function (d) { return d * width; }) .attr("height", barHeight) .attr("y", function (d, i) { return i * barHeight; }) .attr("fill", "steelblue"); ```
To render the script within R you call the r2d3() function:
r
library(r2d3)
r2d3(data=c(0.3, 0.6, 0.8, 0.95, 0.40, 0.20), script = "barchart.js")
Which results in the following visualization:
D3 Variables
Note that data is provided to the script using the data argument to
the r2d3() function. This data is then automatically made available to
the D3 script. There are a number of other special variables available
within D3 scripts, including:
data- The R data converted to JavaScript.svg- The svg container for the visualizationwidth- The current width of the containerheight- The current height of the containeroptions- Additional options provided by the usertheme- Colors for the current theme
When you are learning D3 or translating D3 examples for use with R it’s important to keep in mind that D3 examples will generally include code to load data, create an SVG or other root element, and establish a width and height for the visualization.
On the other hand with r2d3, these variables are provided automatically so do not need to be created. The reasons these variables are provided automatically are:
So that you can dynamically bind data from R to visualizations; and
So that r2d3 can automatically handle dynamic resizing for your visualization. Most D3 examples have a static size. This if fine for an example but not very robust for including the visualization within a report, dashboard, or application.
D3 Preview
The RStudio v1.2 preview release of RStudio includes support for previewing D3 scripts as you write them. To try this out, create a D3 script using the new file menu:
A simple template for a D3 script (the barchart.js example shown above) is provided by default. You can use the Preview command (Ctrl+Shift+Enter) to render the visualization:
You might wonder where the data comes from for the preview. Note that there is a special comment at the top of the D3 script:
js
// !preview r2d3 data=c(0.3, 0.6, 0.8, 0.95, 0.40, 0.20)
This comment enables you to specify the data (along with any other
arguments to the r2d3() function) to use for the preview.
R Markdown
You can include D3 visualizations in an R Markdown document or R
Notebook. You can do this by calling the r2d3() function from within
an R code chunk:
````
output: html_document
{r}
library(r2d3)
r2d3(data=c(0.3, 0.6, 0.8, 0.95, 0.40, 0.20), script = "barchart.js")
````
You can also include D3 visualization code inline using the d3 R
Markdown engine:
```{r setup}
library(r2d3)
bars <- c(10, 20, 30)
```
```{d3 data=bars, options=list(color = 'orange')}
svg.selectAll('rect')
.data(data)
.enter()
.append('rect')
.attr('width', function(d) { return d * 10; })
.attr('height', '20px')
.attr('y', function(d, i) { return i * 22; })
.attr('fill', options.color);
```
Note that in order to use the d3 engine you need to add
library(r2d3) to the setup chunk (as illustrated above).
Shiny
The renderD3() and d3Output() functions enable you to include D3
visualizations within Shiny applications:
```r library(shiny) library(r2d3)
ui <- fluidPage( inputPanel( sliderInput("bar_max", label = "Max:", min = 0.1, max = 1.0, value = 0.2, step = 0.1) ), d3Output("d3") )
server <- function(input, output) { output$d3 <- renderD3({ r2d3( runif(5, 0, input$bar_max), script = system.file("examples/baranims.js", package = "r2d3") ) }) }
shinyApp(ui = ui, server = server) ```
See the article on Using r2d3 with Shiny to learn more (including how to create custom Shiny inputs that respond to user interaction with D3 visualizations).
Learning More
To learn the basics of D3 and see some examples that might inspire your own work, check out:
Learning D3 - Suggested resources for learning how to create D3 visualizations.
Gallery of Examples - Learn from a wide variety of example D3 visualizations.
For next steps on learning on how to use r2d3, see these articles:
-
- Customize the conversion of R objects to D3-friendly JSON.
-
- Control various aspects of D3 rendering and expose user-level options for your D3 script.
-
- Recommended tools and workflow for developing D3 visualizations.
-
- Publish D3 visualizations as HTML, a static PNG image, or within R Markdown documents and Shiny applications.
Once you are familar with the basics, check out these articles on more advanced topics:
Using r2d3 with Shiny - Deriving insights from data is streamlined when users are able to modify a Shiny input, or click on a D3 visualization, and that action produces new results.
CSS and JavaScript Dependencies
- Incorporating external CSS styles and JavaScript libraries into your visualizations.
Advanced Rendering with Callbacks
- An alternate way to organize D3 scripts that enables you to distinguish between initialization and re-rendering based on new data, as well as handle resizing more dynamically.
Package Development – Create re-usable D3 visualizations by including them in an R package.
Owner
- Name: RStudio
- Login: rstudio
- Kind: organization
- Email: info@rstudio.org
- Location: Boston, MA
- Website: http://rstudio.org
- Repositories: 356
- Profile: https://github.com/rstudio
GitHub Events
Total
- Watch event: 8
Last Year
- Watch event: 8
Committers
Last synced: 9 months ago
Top Committers
| Name | Commits | |
|---|---|---|
| Javier Luraschi | j****i@h****m | 279 |
| jjallaire | jj@r****m | 117 |
| edgararuiz | e****r@r****m | 4 |
| Barret Schloerke | b****t@r****m | 2 |
| Xianying Tan | s****n@1****m | 1 |
| Renata Gerecke | r****e@g****m | 1 |
| Nick Strayer | n****r@r****m | 1 |
| Mike Spaner | m****r@g****m | 1 |
| Michael Condouris | c****r@g****m | 1 |
| Maxim Nazarov | m****v@o****u | 1 |
| Jim Hester | j****r@g****m | 1 |
| Alex Pickering | a****g@g****m | 1 |
| dkjoluju | j****a@l****m | 1 |
| Nick Strayer | n****r@v****u | 1 |
Committer Domains (Top 20 + Academic)
Issues and Pull Requests
Last synced: 7 months ago
All Time
- Total issues: 66
- Total pull requests: 41
- Average time to close issues: about 1 month
- Average time to close pull requests: about 1 month
- Total issue authors: 51
- Total pull request authors: 15
- Average comments per issue: 1.83
- Average comments per pull request: 0.85
- Merged pull requests: 34
- Bot issues: 0
- Bot pull requests: 0
Past Year
- Issues: 1
- Pull requests: 0
- Average time to close issues: N/A
- Average time to close pull requests: N/A
- Issue authors: 1
- Pull request authors: 0
- Average comments per issue: 0.0
- Average comments per pull request: 0
- Merged pull requests: 0
- Bot issues: 0
- Bot pull requests: 0
Top Authors
Issue Authors
- jjallaire (5)
- nstrayer (5)
- hbaniecki (3)
- ABSOD (2)
- feddelegrand7 (2)
- ChrisWoodsSays (2)
- ronblum (2)
- javierluraschi (2)
- asadow (1)
- Harrison8 (1)
- npjc (1)
- nvelden (1)
- mbacou (1)
- mortonanalytics (1)
- AWKruijt (1)
Pull Request Authors
- javierluraschi (19)
- nstrayer (3)
- schloerke (3)
- jjallaire (3)
- edgararuiz-zz (2)
- shrektan (1)
- mnazarov (1)
- rahulchauhan049 (1)
- alexvpickering (1)
- jimhester (1)
- cjyetman (1)
- condour (1)
- rgerecke (1)
- ghost (1)
- mspan (1)
Top Labels
Issue Labels
Pull Request Labels
Packages
- Total packages: 3
-
Total downloads:
- cran 3,676 last-month
- Total docker downloads: 76,481,681
-
Total dependent packages: 13
(may contain duplicates) -
Total dependent repositories: 34
(may contain duplicates) - Total versions: 14
- Total maintainers: 1
proxy.golang.org: github.com/rstudio/r2d3
- Documentation: https://pkg.go.dev/github.com/rstudio/r2d3#section-documentation
-
Latest release: v0.2.3
published about 7 years ago
Rankings
cran.r-project.org: r2d3
Interface to 'D3' Visualizations
- Homepage: https://rstudio.github.io/r2d3/
- Documentation: http://cran.r-project.org/web/packages/r2d3/r2d3.pdf
- License: BSD_3_clause + file LICENSE
-
Latest release: 0.2.6
published almost 4 years ago
Rankings
Maintainers (1)
conda-forge.org: r-r2d3
- Homepage: https://github.com/rstudio/r2d3
- License: BSD-3-Clause
-
Latest release: 0.2.6
published almost 4 years ago
Rankings
Dependencies
- R >= 3.1.2 depends
- htmltools * imports
- htmlwidgets >= 1.2 imports
- jsonlite * imports
- rstudioapi * imports
- R6 * suggests
- knitr * suggests
- rmarkdown * suggests
- shiny * suggests
- shinytest * suggests
- testthat * suggests
- webshot * suggests