# 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.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://help.connected.illumina.com/illumina-trupath-genome/data-visualizations-and-analysis/visualize-data-in-igv.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.