# Visualize Data in IGV

IGV ([Integrative Genomics Viewer](https://igv.org/)) is an interactive desktop tool for visualizing and exploring genomic data—like BAM/CRAM alignments, variants (VCF), and annotation tracks—so you can quickly inspect regions of interest, assess read support, and validate findings.

DRAGEN Germline analysis for Illumina TruPat Genome generates standard output formats such as BAM/CRAM and VCF files that can be directly loaded into IGV for visualization and review. The key files useful for IGV visualizations are listed below:

* Phased BAM: `<sample_name>/<sample_name>.bam`
  * Index: `<sample_name>/<sample_name>.bam.bai`
* Phased small variant VCF: `<sample_name>/<sample_name>.hard-filtered.gvcf.gz`
  * Index: `<sample_name>/<sample_name>.hard-filtered.gvcf.gz.tbi`
* CNV VCF: `<sample_name>/<sample_name>.cnv.vcf.gz`
  * Index: `<sample_name>/<sample_name>.cnv.vcf.gz.tbi`
* SV VCF: `<sample_name>/<sample_name>.sv.vcf.gz`
  * Index: `<sample_name>/<sample_name>.sv.vcf.gz.tbi`
* Phase block GTF: `<sample_name>/<sample_name>.phase_blocks.gtf.gz`
* MRJD VCF: `<sample_name>/<sample_name>.mrjd.hard-filtered.vcf.gz`
* MRJD phased BAM: `<sample_name>/<sample_name>.mrjd.phased.bam`
* MRJD VCF in haplotype separated format: `<sample_name>/mrjd_supporting_files/<sample_name>.mrjd.<paralog_name>.vcf.gz`
* SAM file containing reference region alignments for MRJD: `<sample_name>/mrjd_supporting_files/<sample_name>.mrjd.reference_region_alignments.sam`

IGV supports both loading data from local files and streaming tracks directly from signed URLs for remote, secure access.

**Option 1 — Download files locally from ICA, then open in IGV.**\
You can download the DRAGEN output files from ICA onto your computer and load them into IGV as local tracks. This can be done either via the [**ICA CLI**](https://help.ica.illumina.com/command-line-interface/cli-datatransfer#download-data) (e.g., using `icav2 projectdata download <file_path>`) or directly from the **ICA web browser UI** by clicking data and download.

<figure><img src="https://2122546113-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCiFAstZpxWHpI6k3vTvF%2Fuploads%2Fgit-blob-8d9da06faa843893e9173b522c4c1d18c505ff58%2FScreenshot%202026-01-21%20at%2011.56.00.png?alt=media" alt=""><figcaption><p>Click [Download] to start downloading from browser</p></figcaption></figure>

Next, click **File → Load from File** to load local files to IGV.

**Option 2 — Stream files directly into IGV using signed URLs.**\
If you prefer not to download large files locally, you can stream tracks straight into IGV using **signed URLs**. Generate signed URLs with:

```
icav2 projectdata downloadurl -o table <file_path>
```

where `file_path` can be found by right-clicking the data, and copy either Path or ID

<figure><img src="https://2122546113-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCiFAstZpxWHpI6k3vTvF%2Fuploads%2Fgit-blob-28e8f041070e799808f1ea7f1b3d3fa2933caf67%2FScreenshot%202026-01-23%20at%2012.19.13.png?alt=media" alt=""><figcaption></figcaption></figure>

Then copy the output URL(s) and paste them into IGV (**File → Load from URL**) to load the tracks remotely.

\
We recommend using the following IGV preference for alignment:

* Group by: HP
* Color by: PS
* Display mode: squished
* Show softclips
* Turn off downsampling

<figure><img src="https://2122546113-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCiFAstZpxWHpI6k3vTvF%2Fuploads%2Fgit-blob-86466a70511d0de55fe3bc0c46f4e6eac042a02f%2Fimage.png?alt=media" alt=""><figcaption><p>Phased VCF, and Haplotagged BAM at TP53 Gene</p></figcaption></figure>

In view above, reads are grouped by haplotype ("HP") and colored by Phase Block ("PS"). The grey reads are unphased, meaning they cannot be confidently assigned to either group.