Getting Started with R / Bioconductor
This guide helps R / Bioconductor users:
- Establish and familiarize themselves with essential Terra account and workspace concepts.
- Use RStudio and Jupyter Notebooks for interactive analysis.
- Execute workflows for large-scale, including use of R / Bioconductor in the workflow, and management of workflows from within R.
The guide indicates how to discover R / Bioconductor workspaces, and how the R / Bioconductor community can contribute to AnVIL and cloud-based computation.
Getting Started with AnVIL - Provides essential information for setting up a Terra account, billing and cost management, use of Terra workspaces, finding and accessing (public as well as protected) consortium-scale data, and running workflows and interactive analyses.
R / Bioconductor with RStudio or Jupyter
The RStudio Runtime - RStudio provides a familiar environment for using R / Bioconductor, with the advantage that RStudio is running on cloud-based resources that allow fast, secure, authenticated data access and easily scalable compute resources.
Access R / Bioconductor through Jupyter notebooks - Jupyter notebooks running an R 'kernel' provide a good way to step collaborators or trainees through an analysis.
Terra / AnVIL concepts for R / Bioconductor users
Where Is My Computer?
The AnVIL runtime provides the physical machinery for computation (e.g., a 4 core CPU with 16 GB of memory) as well as local 'persistent disk' storage. Unlike a traditional computer, the compute and storage components are separate from one another. For instance, storage created with one runtime can be used with another runtime. A runtime and persistent disk belong to a single user, and can be used across workspaces.
Where Is My Data?
Local persistent disks, DATA, and workspace buckets - A persistent disk contains data, scripts, packages, and output created by the user in the course of an analysis. Workspaces bring additional data.
Tabular summaries of workspace data, e.g., descriptions of participants in the study the workspace encapsulates, are presented under the DATA element, while larger data produced during an analysis may be associated with the workspace 'bucket'.
The AnVIL package R / Bioconductor package provides a familiar interface for accessing these resources.
Techniques for effective use of R / Bioconductor
- Fast package installation - Cloud-based R / Bioconductor provides three major advantages during package installation: a pre-configured system supporting most CRAN and Bioconductor packages; fast retrieval of packages from cloud-based repositories; and very fast installation of 'binary' packages that do not require source code compilation. Use the AnVIL::install() function to gain all three benefits.
- Tools for assessing cost - The AnVILBilling package provides R / Bioconductor tools for exploring the cost of AnVIL-based computation. This complements other AnVIL facilities for assessing cost.
- Using best practices for sharing reproducible AnVIL resources - Start by encapsulating your contribution in an R package, with fully documented functions and vignettes for describing use. Manage the source code of your package in Git or other version control system. Then use AnVILPublish to make your package content available as an AnVIL workspace for sharing and cloud-based computation.
- Workflow Inputs, Execution, and Outputs - The AnVIL package provides commands that make working with workflows, especially workflow inputs and outputs, easy for R / Bioconductor users.
- A Bulk RNASeq Differential Expression Workflow.
Producing customized runtimes.
R / Bioconductor resources
- Participate in the R / Bioconductor Community - Ask general questions about using Bioconductor packages on the Bioconductor support forum. Participate in the Bioconductor community slack signup) for more in-depth conversation. Terra / AnVIL provides extensive support through the support feature of the Terra website.
- Public Workspaces.