Skip to content

Get started with data science using the JupyterLab Environment for Statistical Analysis using R! Run JupyterLab with R as the default language, pre-configured with essential dependencies and popular packages. Enjoy an isolated workspace for reproducible and collaborative data science workflows.

License

Notifications You must be signed in to change notification settings

SamThilmany/JupyterLab-with-R_Docker-Environment

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

9 Commits
 
 
 
 
 
 
 
 

Repository files navigation

JupyterLab R Environment

A Docker Environment for Statistical Analysis using R in JupyterNotebooks

Version 2.0.1

This project provides a pre-configured Docker image to effortlessly run JupyterLab with R as the default language. The image includes essential dependencies, R installation, and popular packages like tidyverse, ggplot2, dplyr, and BiocManager for seamless data manipulation and analysis. Your notebooks will be stored in the 'notebooks' directory, ensuring organized work. Enjoy a hassle-free, reproducible, and isolated environment for your data science tasks!

Table of Contents

  1. Getting Started
  2. Pre-installed R Packages
  3. Versioning
  4. License

Getting Started

This guide will help you set up a running copy of JupyterLab Environment for Statistical Analysis using R on your machine. The Docker environment provides a seamless and isolated workspace for data science tasks, with R as the default language and popular packages pre-installed. Let's get started!

(back to top)

Prerequisites

Ensure you have the following software installed on your machine. If not, download and install them from the provided official website:

(back to top)

Installation

Step 1: Clone the Repository

Clone this Git repository to your local machine using Git:

cd /Users/your_username/path_to_install

git clone [email protected]:SamThilmany/JupyterLab-with-R--Docker-Environment.git

Step 2: Build the Docker Image

Move into the jupyter_r directory of the cloned project and build the container:

cd /Users/your_username/path_to_install/JupyterLab-with-R--Docker-Environment/jupyter_r

docker compose build

This step will take a few minutes (maybe a few minutes more than you'd like, depending on your connection speed), so make sure you grab a cup of coffee and pass the time by thinking about the big questions of humanity... ☕️

Unfortunately, the process sometimes fails. Occasionally even several times in succession. This is usually due to a weak Internet connection; it is therefore highly advisable to be connected to the Internet via cable. If the process fails, you can simply enter the build command again. All packages that have already been downloaded were cached so that you do not have to start from scratch. If the process aborts several times, check whether packages have been successfully downloaded again in between. This indicates that it is actually due to network problems.

Step 3: Run the Docker Container

Still in the jupyter_r directory, run:

docker compose up -d

Step 4: Access JupyterLab

Open your favourite web browser and enter the following URL into the adress bar:

  • http://127.0.0.1:8888/

Step 5: Start Exploring

Congratulations! You now have a fully functional JupyterLab environment with R as the default language. Start creating new notebooks, analyzing data, and utilizing the power of R and its rich ecosystem of packages.

Additional Notes

  • To stop the JupyterLab session, type Ctrl + C in the terminal where the container is running. Then type docker compose down to stop the Docker container.
  • To start the container again in the future, repeat Step 3.
  • Your notebooks will be saved in the /Users/your_username/path_to_install/JupyterLab-with-R--Docker-Environment/notebooks/ directory on your local machine, enabling easy access and collaboration.

Enjoy your productive data science journey with the JupyterLab Environment for Statistical Analysis using R! If you encounter any issues or have any questions, please feel free to reach out via GitLab Issues. Happy coding!

(back to top)

Pre-installed R Packages

  • IRkernel
  • languageserver
  • devtools
  • tidyverse
  • showtext
  • ggplot2
  • ggfortify
  • ggforce
  • ggtext
  • ggrepel
  • GGally
  • ggVennDiagram
  • eulerr
  • patchwork
  • cowplot
  • metR
  • doParallel
  • combinat
  • disgenet2r (via devtools and GitLab)

Pre-installed Bioconductor Packages

  • fgsea
  • biomaRt
  • enrichplot
  • DOSE
  • limma
  • clusterProfiler
  • AnnotationDbi
  • org.Hs.eg.db
  • rawrr
  • ComplexHeatmap
  • MSstats
  • MSstatsTMT

Versioning

Semantic Versioning is used for versioning. For the versions available, see the Releases.

(back to top)

License

This project is distributed under the Apache License 2.0. See LICENSE for more information.

(back to top)

About

Get started with data science using the JupyterLab Environment for Statistical Analysis using R! Run JupyterLab with R as the default language, pre-configured with essential dependencies and popular packages. Enjoy an isolated workspace for reproducible and collaborative data science workflows.

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published