> This page is for version v4.8.0 (default).
> For other versions, use one of these documentation indexes:
> - v4.8.0 (default): https://docs.nvidia.com/clara/parabricks/v4.8.0/llms.txt
> - v4.7.1: https://docs.nvidia.com/clara/parabricks/v4.7.1/llms.txt

> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://docs.nvidia.com/clara/parabricks/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.nvidia.com/clara/parabricks/_mcp/server.

# HaplotypeCaller Tutorial

This tutorial will show you how to run the gold-standard GATK variant caller, HaplotypeCaller, which
takes your aligned output BAM from the FQ2BAM Tutorial, assembles plausible haplotypes from active
regions, and identifies genotype likelihoods according to Bayes’ Rule. The result is a Variant
Call Format (VCF) file of all the variant calls across the genome, including their position in
the genome and the allelic information.

To do this, run the following command:

```text
$ docker run \
     --gpus all \
     --rm \
     --volume $(pwd):/workdir \
     --volume $(pwd):/outputdir \
   nvcr.io/nvidia/clara/clara-parabricks:4.8.0-1 \
   pbrun haplotypecaller \
     --ref /workdir/parabricks_sample/Ref/Homo_sapiens_assembly38.fasta \
     --in-bam /workdir/fq2bam_output.bam \
     --out-variants /outputdir/variants.vcf
```

```text
Please visit https://docs.nvidia.com/clara/#parabricks for detailed documentation

[Parabricks Options Mesg]: haplotypecaller auto-configuration: 2 stream(s)/GPU (default memory mode; min device memory
97887 MiB, num_gpus=1, partition=False; caps mem=5 perf=2)
[PB Info 2026-Oct-06 15:26:10] ------------------------------------------------------------------------------
[PB Info 2026-Oct-06 15:26:10] ||                 Parabricks accelerated Genomics Pipeline                 ||
[PB Info 2026-Oct-06 15:26:10] ||                           Version 4.8.0-1                                ||
[PB Info 2026-Oct-06 15:26:10] ||                         GPU-GATK4 HaplotypeCaller                        ||
[PB Info 2026-Oct-06 15:26:10] ------------------------------------------------------------------------------
[PB Info 2026-Oct-06 15:26:26] 0 /workdir/fq2bam_output.bam/outputdir/variants.vcf
[PB Info 2026-Oct-06 15:26:26] Multi-stream: 1 GPU(s) x 2 stream(s)/GPU = 2 pipeline(s)
[PB Info 2026-Oct-06 15:26:26] GPU 0: one Stage uses ~17402 MB, 79262 MB free; max safe --runStreamsPerGPU on this device is ~5
[PB Info 2026-Oct-06 15:26:26] ProgressMeter -	Current-Locus	Elapsed-Minutes	Regions-Processed	Regions/Minute
[PB Info 2026-Oct-06 15:26:36] chr1:182332801	0.2	825733	4954386
[PB Info 2026-Oct-06 15:26:46] chr2:200568001	0.3	1938702	5816100
[PB Info 2026-Oct-06 15:26:56] chr3:195960001	0.5	2959918	5919836
[PB Info 2026-Oct-06 15:27:06] chr5:84072001	0.7	4176409	6264610
[PB Info 2026-Oct-06 15:27:16] chr6:160032001	0.8	5240335	6288402
[PB Info 2026-Oct-06 15:27:26] chr8:56112001	1.0	6241070	6241067
[PB Info 2026-Oct-06 15:27:36] chr10:30436801	1.2	7229268	6196512
[PB Info 2026-Oct-06 15:27:46] chr12:350401	1.3	8289084	6216811
[PB Info 2026-Oct-06 15:27:56] chr14:23179201	1.5	9337805	6225203
[PB Info 2026-Oct-06 15:28:06] chr17:7900801	1.7	10420271	6252160
[PB Info 2026-Oct-06 15:28:16] chr19:48960001	1.8	11261106	6142421
[PB Info 2026-Oct-06 15:28:26] chrX:155779201	2.0	12490022	6245008
[PB Info 2026-Oct-06 15:28:36] Total time taken: 130.859433
[PB Info 2026-Oct-06 15:28:36] ------------------------------------------------------------------------------
[PB Info 2026-Oct-06 15:28:36] ||        Program:                         GPU-GATK4 HaplotypeCaller        ||
[PB Info 2026-Oct-06 15:28:36] ||        Version:                                           4.8.0-1        ||
[PB Info 2026-Oct-06 15:28:36] ||        Start Time:                       Tue Oct  6 15:26:10 2026        ||
[PB Info 2026-Oct-06 15:28:36] ||        End Time:                         Tue Oct  6 15:28:36 2026        ||
[PB Info 2026-Oct-06 15:28:36] ||        Total Time:                           2 minutes 26 seconds        ||
[PB Info 2026-Oct-06 15:28:36] ------------------------------------------------------------------------------
/usr/local/parabricks/binaries/bin/htvc /workdir/parabricks_sample/Ref/Homo_sapiens_assembly38.fasta /workdir/fq2bam_output.bam 1 -o /outputdir/variants.vcf -nt 5 --runStreamsPerGPU 2
Variant caller done, total time: 2.5 min
```

This run was performed on a local workstation with an NVIDIA RTX PRO 6000 Blackwell Workstation Edition and 128 GB of RAM.
On other hardware, runtimes will differ, as will the settings Parabricks selects automatically based on GPU memory, such as the number of GPU streams shown in the log.

If you get an out-of-memory error make sure your computer has enough RAM, and that large
amounts of memory aren't being used by other programs.

You should now have the following files in your directory:

```text
$ ls -lrt
-rw-r--r-- 1 root    root          4861055062 Oct  6 11:25 fq2bam_output.bam
-rw-r--r-- 1 root    root             3205016 Oct  6 11:25 fq2bam_output.bam.bai
-rw-r--r-- 1 root    root               87692 Oct  6 11:25 fq2bam_output_chrs.txt
-rw-r--r-- 1 root    root            23642115 Oct  6 11:28 variants.vcf
(sample data not shown)
```

The first ten non-header lines of `variants.vcf` should be as follows:

```text
chr1	16378	.	T	C	45.32	.	AC=2;AF=1.00;AN=2;DP=2;ExcessHet=0.0000;FS=0.000;MLEAC=1;MLEAF=0.500;MQ=23.55;QD=22.66;SOR=2.303	GT:AD:DP:GQ:PL	1/1:0,2:2:6:57,6,0
chr1	63268	.	T	C	43.32	.	AC=2;AF=1.00;AN=2;DP=4;ExcessHet=0.0000;FS=0.000;MLEAC=1;MLEAF=0.500;MQ=24.60;QD=21.66;SOR=2.303	GT:AD:DP:GQ:PL	1/1:0,2:2:6:55,6,0
chr1	63516	.	A	G	1202.06	.	AC=2;AF=1.00;AN=2;DP=40;ExcessHet=0.0000;FS=0.000;MLEAC=2;MLEAF=1.00;MQ=26.22;QD=30.05;SOR=1.292	GT:AD:DP:GQ:PL	1/1:0,40:40:99:1216,120,0
chr1	63527	.	T	C	1002.06	.	AC=2;AF=1.00;AN=2;DP=34;ExcessHet=0.0000;FS=0.000;MLEAC=2;MLEAF=1.00;MQ=26.02;QD=30.37;SOR=1.179	GT:AD:DP:GQ:PL	1/1:0,33:33:99:1016,99,0
chr1	131609	.	C	A	83.64	.	AC=1;AF=0.500;AN=2;BaseQRankSum=-0.275;DP=11;ExcessHet=0.0000;FS=0.000;MLEAC=1;MLEAF=0.500;MQ=20.00;MQRankSum=0.000;QD=7.60;ReadPosRankSum=-1.349;SOR=0.551	GT:AD:DP:GQ:PL	0/1:6,5:11:91:91,0,115
chr1	133483	.	G	T	70.64	.	AC=1;AF=0.500;AN=2;BaseQRankSum=-1.534;DP=8;ExcessHet=0.0000;FS=3.332;MLEAC=1;MLEAF=0.500;MQ=26.65;MQRankSum=1.611;QD=8.83;ReadPosRankSum=-0.703;SOR=2.303	GT:AD:DP:GQ:PL	0/1:5,3:8:78:78,0,100
chr1	264627	.	A	G	37.32	.	AC=2;AF=1.00;AN=2;DP=2;ExcessHet=0.0000;FS=0.000;MLEAC=1;MLEAF=0.500;MQ=49.00;QD=18.66;SOR=0.693	GT:AD:DP:GQ:PL	1/1:0,2:2:6:49,6,0
chr1	268012	.	G	A	330.64	.	AC=1;AF=0.500;AN=2;BaseQRankSum=0.636;DP=118;ExcessHet=0.0000;FS=1.639;MLEAC=1;MLEAF=0.500;MQ=39.31;MQRankSum=-6.168;QD=2.85;ReadPosRankSum=-1.358;SOR=0.895	GT:AD:DP:GQ:PL	0/1:93,23:116:99:338,0,3307
chr1	268130	.	G	T	2212.64	.	AC=1;AF=0.500;AN=2;BaseQRankSum=1.436;DP=236;ExcessHet=0.0000;FS=8.558;MLEAC=1;MLEAF=0.500;MQ=44.61;MQRankSum=-12.571;QD=9.66;ReadPosRankSum=1.210;SOR=0.368	GT:AD:DP:GQ:PL	0/1:128,101:229:99:2220,0,4479
chr1	268516	.	C	T	59.64	.	AC=1;AF=0.500;AN=2;BaseQRankSum=1.465;DP=7;ExcessHet=0.0000;FS=3.680;MLEAC=1;MLEAF=0.500;MQ=52.18;MQRankSum=-0.180;QD=8.52;ReadPosRankSum=-0.366;SOR=2.258	GT:AD:DP:GQ:PL	0/1:5,2:7:67:67,0,138
```