Running Clara Parabricks on Terra
This guide shows how to run Parabricks on Terra.
Clara Parabricks is an accelerated compute framework that supports applications across the genomics industry, primarily supporting analytical workflows for DNA, RNA, and somatic mutation detection applications. With industry leading compute times, Parabricks rapidly converts a FASTQ file to a VCF using multiple, industry validated variant callers and also includes the ability to QC and annotate those variants. As Parabricks is based upon publicly available tools, results are easy to verify and combine with other publicly available datasets.
More information is available on the Clara Parabricks Product Page.
Detailed installation, usage, and tuning information is available in the Parabricks user guide.
On Terra, there is a Clara Parabricks workspace created by the NVIDIA team which contains preloaded data and workflow configurations. For this tutorial we will start there. This will take us to a catalog of workflows that are available on Terra.
![image_workspace.png](https://docscontent.nvidia.com/dims4/default/d38b9a2/2147483647/strip/true/crop/1919x537+0+0/resize/1440x403!/quality/90/?url=https%3A%2F%2Fk3-prod-nvidia-docs.s3.us-west-2.amazonaws.com%2Fbrightspot%2Fsphinx%2F0000018b-6753-d717-adef-ffffd61b0000%2Fclara%2Fparabricks%2F4.2.0%2F_images%2Fimage_workspace.png)
This workspace is Read Only, so to do anything with it, we must clone it. Click the three dots in the top right corner and select “Clone”. Give the project a name, a billing project, and a location, and select “Clone Workspace”:
We can click back into workspaces and select “clara-parabricks-fq2bam. The page should look like this:
![image_clara_workspace.png](https://docscontent.nvidia.com/dims4/default/4b45851/2147483647/strip/true/crop/1198x581+0+0/resize/1198x581!/quality/90/?url=https%3A%2F%2Fk3-prod-nvidia-docs.s3.us-west-2.amazonaws.com%2Fbrightspot%2Fsphinx%2F0000018b-6753-d717-adef-ffffd61b0000%2Fclara%2Fparabricks%2F4.2.0%2F_images%2Fimage_clara_workspace.png)
Some sample data is already loaded for us, so we can click “Select Data” to pick a sample to run through the fq2bam pipeline. For this tutorial let’s select the first sample.
![image_select_data.png](https://docscontent.nvidia.com/dims4/default/4eb166b/2147483647/strip/true/crop/547x494+0+0/resize/547x494!/quality/90/?url=https%3A%2F%2Fk3-prod-nvidia-docs.s3.us-west-2.amazonaws.com%2Fbrightspot%2Fsphinx%2F0000018b-6753-d717-adef-ffffd61b0000%2Fclara%2Fparabricks%2F4.2.0%2F_images%2Fimage_select_data.png)
This auto-populates the workflow with the appropriate file types to run fq2bam analysis so all we have to do now is select “Run Analysis”. This takes us to a new page where we can monitor the job:
![image_status.png](https://docscontent.nvidia.com/dims4/default/38e653d/2147483647/strip/true/crop/705x256+0+0/resize/705x256!/quality/90/?url=https%3A%2F%2Fk3-prod-nvidia-docs.s3.us-west-2.amazonaws.com%2Fbrightspot%2Fsphinx%2F0000018b-6753-d717-adef-ffffd61b0000%2Fclara%2Fparabricks%2F4.2.0%2F_images%2Fimage_status.png)
It should take a few minutes for the job to be accepted by the queue and a few more minutes for the job to finish. Once the job is finished, we can check that the output files were generated. Let’s click on “Execution directory”.
![image_execution_directory.png](https://docscontent.nvidia.com/dims4/default/db27d8c/2147483647/strip/true/crop/248x203+0+0/resize/248x203!/quality/90/?url=https%3A%2F%2Fk3-prod-nvidia-docs.s3.us-west-2.amazonaws.com%2Fbrightspot%2Fsphinx%2F0000018b-6753-d717-adef-ffffd61b0000%2Fclara%2Fparabricks%2F4.2.0%2F_images%2Fimage_execution_directory.png)
This takes us to the Google Cloud console where we can see the output files generated.
![image_output_files.png](https://docscontent.nvidia.com/dims4/default/dfb22c4/2147483647/strip/true/crop/565x188+0+0/resize/565x188!/quality/90/?url=https%3A%2F%2Fk3-prod-nvidia-docs.s3.us-west-2.amazonaws.com%2Fbrightspot%2Fsphinx%2F0000018b-6753-d717-adef-ffffd61b0000%2Fclara%2Fparabricks%2F4.2.0%2F_images%2Fimage_output_files.png)
Congratulations! We have now run our first Parabricks job using Terra.