/rmeta-example01

Primary LanguageJupyter NotebookBSD 3-Clause "New" or "Revised" LicenseBSD-3-Clause

Specifying an R environment with a runtime.txt file

Jupyter+R: Binder

RStudio: Binder

RShiny: Binder

Binder supports using R and RStudio, with libraries pinned to a specific snapshot on MRAN.

Note: An alternative is to use the holepunch package for R.

Requirements and suggestions

You need to have a runtime.txt file that is formatted like:

r-<YYYY>-<MM>-<DD>

where YYYY-MM-DD is a snapshot at MRAN that will be used for installing libraries. In this line, you can request a specific version of R. To do this list the version between the 'r' and the year, as in r-3.6-2019-09-24. Right now the default version of R is 3.6.

We recommend using https://github.com/binder-examples/r-conda for faster installs than using a install.R

To install R libraries (or packages) you can add an install.R file that specifies one library to install per line.

Both RStudio and IRKernel are installed by default, so you can use either the Jupyter notebook interface or the RStudio interface.

This repository also contains an example of a Shiny app.

URL addresses for RStudio and Shiny environments

The Binder repository can be used to allow anyone to access an RStudio environment containing our code and data right in their web browser. It also allows hosting a Shiny app. For those purposes, we have to append a bit of text to the URL of our Binder repository, which we can find out at mybinder.org when we enter the URL of our original repository from GitHub or Figshare, etc.