---
title: Nvidia Parabricks
---

# NVIDIA PARABRICKS

## Introduction

Analyzing genomic data is computationally intensive. Time and cost are significant barriers to using genomics data for precision medicine. The NVIDIA Parabricks Genomics Analysis Toolkit breaks down those barriers, providing GPU-accelerated genomic analysis. Data that once took days to analyze can now be done in under an hour.

## Why Use Nvidia Parabricks?

Parabricks is a software suite for performing secondary analysis of next-generation sequencing (NGS) DNA data. A major benefit of Parabricks is that it is designed to deliver results at blazing fast speeds by utilizing NVIDIA GPU acceleration. Parabricks can analyze whole human genomes in about 45 minutes, compared to about 30 hours for 30x WGS data. The best part is the output results exactly match the commonly used software. So, it's fairly simple to verify the accuracy of the output.

## Installation

The **pbrun** command line utility is used to interact with the Parabricks NGC container. `pbrun` is called from the host to transparently download, provision, and run the NGC Parabricks container. The instructions below will guide you through the setup and usage of `pbrun` on your local system.

### Prepare the installer

To obtain the Parabricks installer, please follow the instructions to obtain a free license for 90 days located on the NVIDIA [Parabricks developer portal](https://www.developer.nvidia.com/nvidia-parabricks). Once you complete the registration, a Parabricks installer package download link will be sent to your registered email. Download the package onto your local system and copy the package to the GPU server using file transfer clients. Use the instructions below to navigate to the directory containing `parabricks_installer.tar.gz`.



```bash


	# tar -xzf parabricks.tar.gz
	# cd parabricks


```


### Install the Parabricks Suite

Execute `installer.py` to install `pbrun` on the host system. The most common installations are shown below. For a complete list of installation options, see the [Parabricks installation guide](https://docs.parabricks.com/installation/local-installation).

### Using Docker

This Parabricks 2.5.0 image contains:
- [`nvidia-container-toolkit`](https://github.com/NVIDIA/nvidia-docker#quickstart)
- [`nvidia-docker2`](https://github.com/NVIDIA/nvidia-docker#upgrading-with-nvidia-docker2-deprecated)
- Parabricks 2.5.0 NGC container image

These are the prerequisite packages for the Parabricks installer.



```bash
sudo ./installer.py --ngc --container docker

```
Verify the installation by checking the pbrun version.

```bash
        pbrun --version
        pbrun: v2.5.0

```

### Install the Parabricks Suite

Execute `installer.py` to install `pbrun` on the host system. The most common installations are shown below. For a complete list of installation options, see the [Parabricks installation guide](https://docs.parabricks.com/installation/local-installation).

### Using Docker

This Parabricks 2.5.0 image contains:
- [`nvidia-container-toolkit`](https://github.com/NVIDIA/nvidia-docker#quickstart)
- [`nvidia-docker2`](https://github.com/NVIDIA/nvidia-docker#upgrading-with-nvidia-docker2-deprecated)
- Parabricks 2.5.0 NGC container image

These are the prerequisite packages for the Parabricks installer.



```bash
        wget https://s3.amazonaws.com/parabricks.sample/parabricks_sample.tar.gz	
        tar xf parabricks_sample.tar.gz
        ls parabricks_sample


```

## Running

From within the directory containing `parabricks_sample`, the `pbrun` command will initiate the Parabricks `fq2bam` application, which will be run from within the NGC Parabricks container downloaded during installation.



```bash
	    pbrun fq2bam \
       --ref parabricks_sample/Ref/Homo_sapiens_assembly38.fasta \
       --in-fq parabricks_sample/Data/sample_1.fq.gz parabricks_sample/Data/sample_2.fq.gz \
       --out-bam output.bam



```


---