datascience-r

This image is created from the rocker/verse Docker image and contains popular R packages for data science. It also includes the Civis Python and R API clients.

Installation

Either build the Docker image locally

docker build -t datascience-r .

or download the image from DockerHub

docker pull civisanalytics/datascience-r:latest

The latest tag (Docker's default if you don't specify a tag) will give you the most recently-built version of the datascience-r image. You can replace the tag latest with a version number such as 1.0 to retrieve a reproducible environment.

Usage

To start a Docker container from the datascience-r image and interact with it from a bash prompt, use

docker run -i -t civisanalytics/datascience-r:latest /bin/bash

You can run commands via

docker run civisanalytics/datascience-r:latest Rscript -e "print('Hello World!')"

The image contains environment variables which allow you to find the current version. There are four environment variables defined:

VERSION
VERSION_MAJOR
VERSION_MINOR
VERSION_MICRO

VERSION contains the full version string, e.g. "1.0.3". VERSION_MAJOR, VERSION_MINOR, and VERSION_MICRO each contain a single integer.

Contributing

See CONTRIBUTING for information about contributing to this project.

If you make any changes, be sure to build a container to verify that it successfully completes:

docker build -t datascience-r:test .

and describe any changes in the change log.

For Maintainers

This repo has autobuild enabled. Any PR that is merged to master will be built as the latest tag on Dockerhub. Once you are ready to create a new version, go to the "releases" tab of the repository and click "Draft a new release". Github will prompt you to create a new tag, release title, and release description. The tag should use semantic versioning in the form "vX.X.X"; "major.minor.micro". The title of the release should be the same as the tag. Include a change log in the release description. Once the release is tagged, DockerHub will automatically build three identical containers, with labels "major", "major.minor", and "major.minor.micro".

License

BSD-3

See LICENSE.md for details.