Contents


The Herper package is a simple toolset to install and manage Conda packages and environments from R.

The Herper package was developed by Matt Paul, Doug Barrows and Thomas Carroll at the Rockefeller University Bioinformatics Resources Center with contributions from Kathryn Rozen-Gagnon.

This Quick start gives a brief intro into getting up and running with Herper. Check the documentation website for more detailed information and use case examples.

0.1 Installation

Use the BiocManager package to download and install the package from our Github repository:

if (!requireNamespace("BiocManager", quietly = TRUE))
    install.packages("BiocManager")
BiocManager::install("Herper")

Once installed, load it into your R session:

library(Herper)

0.2 Install Conda packages with install_CondaTools.

The install_CondaTools() function allows the user to specify required Conda software and the desired environment to install into.

Miniconda is installed as part of the process (by default into the r-reticulate’s default Conda location). If you already have Miniconda installed (or want to control the location of miniconda installation), you can specify the path with the pathToMiniConda parameter.

myMiniconda <- file.path(tempdir(),"Test")
install_CondaTools("salmon==1.3.0", "herper", pathToMiniConda = myMiniconda)

0.3 Install R package dependencies with install_CondaSysReqs.

The install_CondaSysReqs checks the System Requirements for the specified R package, and uses Conda to install this software.

testPkg <- system.file("extdata/HerperTestPkg",package="Herper")
install.packages(testPkg,type = "source",repos = NULL)
condaDir <- file.path(tempdir(),"r-miniconda")
condaPaths <- install_CondaSysReqs("HerperTestPkg", pathToMiniConda = myMiniconda,SysReqsAsJSON=FALSE)
#' system2(file.path(condaPaths$pathToEnvBin,"samtools"),args = "--help")

0.4 Acknowledgements

Thank you to Ji-Dung Luo and Wei Wang for testing/vignette review/critical feedback and Ziwei Liang for their support.

0.5 Session Information

sessionInfo()
## R version 4.3.1 (2023-06-16)
## Platform: x86_64-pc-linux-gnu (64-bit)
## Running under: Ubuntu 22.04.2 LTS
## 
## Matrix products: default
## BLAS:   /home/biocbuild/bbs-3.17-bioc/R/lib/libRblas.so 
## LAPACK: /usr/lib/x86_64-linux-gnu/lapack/liblapack.so.3.10.0
## 
## locale:
##  [1] LC_CTYPE=en_US.UTF-8       LC_NUMERIC=C               LC_TIME=en_GB             
##  [4] LC_COLLATE=C               LC_MONETARY=en_US.UTF-8    LC_MESSAGES=en_US.UTF-8   
##  [7] LC_PAPER=en_US.UTF-8       LC_NAME=C                  LC_ADDRESS=C              
## [10] LC_TELEPHONE=C             LC_MEASUREMENT=en_US.UTF-8 LC_IDENTIFICATION=C       
## 
## time zone: America/New_York
## tzcode source: system (glibc)
## 
## attached base packages:
## [1] stats     graphics  grDevices utils     datasets  methods   base     
## 
## other attached packages:
## [1] Herper_1.10.1    reticulate_1.30  BiocStyle_2.28.0
## 
## loaded via a namespace (and not attached):
##  [1] cli_3.6.1           knitr_1.43          rlang_1.1.1         xfun_0.39          
##  [5] png_0.1-8           jsonlite_1.8.7      rjson_0.2.21        htmltools_0.5.5    
##  [9] sass_0.4.6          rmarkdown_2.23      grid_4.3.1          evaluate_0.21      
## [13] jquerylib_0.1.4     fastmap_1.1.1       yaml_2.3.7          bookdown_0.34      
## [17] BiocManager_1.30.21 compiler_4.3.1      Rcpp_1.0.11         lattice_0.21-8     
## [21] digest_0.6.33       R6_2.5.1            bslib_0.5.0         Matrix_1.6-0       
## [25] tools_4.3.1         withr_2.5.0         cachem_1.0.8