R-Teaching
Category
Statistics
Program On
Teaching
Version
4.1.2, 4.2.1, 4.3.1
Author / Distributor
Description
R is a language and environment for statistical computing and graphics. It provides a wide variety of statistical (linear and nonlinear modeling, classical statistical tests, time-series analysis, classification, clustering, ...) and graphical techniques.
Running Program
Also refer to Running Jobs on the teaching cluster
R version 4.3.1
R version 4.3.1 is installed in /apps/eb/R/4.3.1-foss-2022a and add-on packages are installed in /apps/eb/R/4.3.1-foss-2022a/lib64/R/library. You can list all files in this dir to see the packages installed with this version of R.
To use this version of R, please first load the module with
module load R/4.3.1-foss-2022a
R version 4.2.1
R version 4.2.1 is installed in /apps/eb/R/4.2.1-foss-2022a and add-on packages are installed in /apps/eb/R/4.2.1-foss-2022a/lib64/R/library. You can list all files in this dir to see the packages installed with this version of R.
To use this version of R, please first load the module with
module load R/4.2.1-foss-2022a
R version 4.1.2
R version 4.1.2 is installed in /apps/eb/R/4.1.2-foss-2021b and add-on packages are installed in /apps/eb/R/4.1.2-foss-2021b/lib64/R/library. You can list all files in this dir to see the packages installed with this version of R.
To use this version of R, please first load the module with
module load R/4.1.2-foss-2021b
Please note that when you load this R module, many other modules will be loaded as R depends on those other libraries and packages.
A number of R packages are provided by other module files. For example, many packages that depend on the JAGS library, such as rjags, are provided by the rjags/4-12-foss-2022a-R-4.3.1 module, which can be loaded with
module load rjags/4-12-foss-2022a-R-4.3.1
How to run R programs with multithreads
Some functions in the R packages are written with OpenMP and can run in parallel using multithreads. The R module files set the variable OMP_NUM_THREADS=1, to specify using only one thread. If you are using a function in an R package that is enabled to run with multithreads, please set the OMP_NUM_THREADS variable to the number of threads you want to use and request the same number of cores for your job. Note that you would need to set this variable after you load the R module, for it to have effect. For example, to use 6 threads, request 6 cores on the same node with
#SBATCH --ntasks=1 #SBATCH --cpus-per-task=6
and set
export OMP_NUM_THREADS=6
You can set OMP_NUM_THREADS to automatically correspond to the number of cores per task requested for the job, by setting it to $SLURM_CPUS_PER_TASK, with
export OMP_NUM_THREADS=$SLURM_CPUS_PER_TASK
A sample job submission to run a multithread job is provided below.
Sample Job Submission Scripts
Here is an example of a shell script, sub.sh, to run a serial R script on the batch queue:
#!/bin/bash #SBATCH --job-name=testRjob #SBATCH --partition=batch #SBATCH --ntasks=1 #SBATCH --mem=10gb #SBATCH --time=08:00:00 #SBATCH --output=%x.%j.out #SBATCH --error=%x.%j.err cd $SLURM_SUBMIT_DIR module load R/4.3.1-foss-2022a R CMD BATCH program.R
where program.R is just a sample program name and needs to be replaced by the name of the program you wish to run. The settings in the header lines, such as the job name, the email address, the number of cores, memory and walltime limit, need to be changed appropriately as well.
Here is an example of a shell script, sub.sh, to run a multithread R script on the batch queue:
#!/bin/bash #SBATCH --job-name=testRjob #SBATCH --partition=batch #SBATCH --ntasks=1 #SBATCH --cpus-per-task=6 #SBATCH --mem=10gb #SBATCH --time=08:00:00 #SBATCH --output=%x.%j.out #SBATCH --error=%x.%j.err cd $SLURM_SUBMIT_DIR module load R/4.3.1-foss-2022a export OMP_NUM_THREADS=$SLURM_CPUS_PER_TASK R CMD BATCH program.R
where program.R is just a sample program name and needs to be replaced by the name of the program you wish to run. The settings in the header lines, such as the job name, the email address, the number of cores, memory and walltime limit, need to be changed appropriately as well.
Here is an example of job submission command:
sbatch ./sub.sh
Documentation
Please see http://www.r-project.org/
Installation
Source code downloaded from https://www.r-project.org/
System
64-bit Linux