> For the complete documentation index, see [llms.txt](https://knowledge.illumina.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://knowledge.illumina.com/software/general/software-general-reference_material-list/000007061.md).

# DRAGEN Imputation App on BaseSpace

[Link to BaseSpace Sequence Hub (BSSH) DRAGEN Imputation App](https://www.illumina.com/products/by-type/informatics-products/basespace-sequence-hub/apps/dragen-imputation.html)

[Demo Project on BSSH](https://basespace.illumina.com/s/P7ramXY9BxHc)

DRAGEN v.4.0 extends the capabilities to infer bi-allelic single nucleotide polymorphisms (SNP) variants from low-coverage sequencing samples by packaging the GLIMPSE software (2020, Olivier Delaneau & Simone Rubinacci). The DRAGEN implementation of the GLIMPSE software allows for scalability of variant imputation by adding the following features:

* End-to-end pipeline, where the 3 phases of the GLIMPSE software (Chunk, Phase, and Ligate) get executed by a single command, on one chromosome or multiple chromosomes.
* Software supported acceleration.

**Input parameters**

**App modes**

![](https://761066130-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FGM9W2DuBTgEXv1ClCm8H%2Fuploads%2Fgit-blob-1c70ef1782b082a3a4730c62bd2eb52dc2f10c6d%2Fimage1.png?alt=media)

* DRAGEN Germline Variant Calling + Imputation: starting from FASTQ files.
* Imputation only: starting from variant call format (VCFs).

**Input files:** VCFs ( if using DRAGEN Imputation only) or FASTQs ( If using DRAGEN Germline Variant Calling + Imputation)

![](https://761066130-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FGM9W2DuBTgEXv1ClCm8H%2Fuploads%2Fgit-blob-25eedd1696acf051527dcc2cbc99bd649fe6c128%2Fimage2.png?alt=media)

For VCFs: These VCFs are expected to contain all the variants in the reference panel. Supports up to 100 single-sample VCF or one multi-sample VCF.

The sample(s) to be imputed must have the following format:

* VCF, multi-sample VCF, BCF or multi-sample BCF (zip or unzipped). Genome variant call format (gVCF) is **not** supported.
* Must contain GL (Genotype Likelihoods) or PL (phred-scaled genotype likelihoods) information.

**Reference panel:**

![](https://761066130-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FGM9W2DuBTgEXv1ClCm8H%2Fuploads%2Fgit-blob-b1c94aa85e1f4ec411114592a3d02ac8c147adef%2Fimage3.png?alt=media)

A per-chromosome reference panel in VCF or BCF format that lists all the imputation positions in the targeted regions along with the corresponding haplotypes must be provided.

**Note**: chrY and chrM are not supported on any IRP panel

* IRPv1.2 is an updated version of IRPv1 with a fix in the reference panel header lines. This is an autosomal SNP reference panel containing \~49 million variants. This reference panel is created from the 2504 samples from the 1000 Genomes Project, which have been variant called from the \~50x NYGC data using DRAGEN 3.7.6 against hg38. Singleton SNPs and SNPs observed to be out of HWE have been excluded. For SNPs where more than one alternative allele was observed, only the most frequently observed alternative allele was retained. Variants were phased using SHAPEIT4.
  * **Note**: chrX is not supported in the IRPv1 reference panel.
* IRPv2.0 is a multi-allelic SNPs and INDELs created from the same samples used for IRPv2.1 with INDEL allele frequency >= 0.03. This reference panel containing \~111 million variants.
* IRPv2.1 is a multi-allelic SNPs and INDELs reference panel containing \~126 million variants. This reference panel is created from the 3202 samples from the 1000 Genomes Project, which have been variant called from the \~50x NYGC data using DRAGEN 4.0 against hg38. Chromosome X is included. Variants were phased using DRAGEN Phase.
* This app also supports using a custom reference panel. A custom reference panel .tar or .tar.gz can be uploaded to BaseSpace. Select 'Custom' from the menu, and then use the Custom Reference Panel control to select the custom reference panel. A custom reference panel can be built with the DRAGEN [Population Haplotyping](https://help.connected.illumina.com/dragen/dragen-v4.5/product-guides/dragen-v4.5/dragen-dna-pipeline/population-haplotyping) software.
  * **Note**: If a custom reference panel is provided then PAR and non-PAR regions need to be treated as different chromosomes.

When using a panel supporting chrX, the mixed ploidy option should be selected and sample sex information provided.

![](https://761066130-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FGM9W2DuBTgEXv1ClCm8H%2Fuploads%2Fgit-blob-60eb92aed8c90708d01f28c63495160a998925c3%2Fimage4.png?alt=media)

![](https://761066130-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FGM9W2DuBTgEXv1ClCm8H%2Fuploads%2Fgit-blob-fbc2e377d50cc17ec27cfdb460db191c2ba63726%2Fimage5.png?alt=media)

Reference panel can be downloaded [here](https://support.illumina.com/sequencing/sequencing_software/dragen-bio-it-platform/product_files.html).

Optionally select a custom BED file to use for imputation. Contigs presented in this BED file will be imputed. If not selected, will impute all positions in the reference panel. To upload a new BED file, navigate to a Project and select the "Import" feature or use the BaseSpace CLI to upload.

**Additional settings**

![](https://761066130-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FGM9W2DuBTgEXv1ClCm8H%2Fuploads%2Fgit-blob-522c69664182088a7834525605737446b7136aac%2Fimage6.png?alt=media)

hg38 reference is used by default. Support for a custom reference requires a [Genetic Map](https://help.connected.illumina.com/dragen/dragen-v4.5/product-guides/dragen-v4.5/dragen-dna-pipeline/small-variant-calling/vcf-imputation#genetic-map) to be provided.

![](https://761066130-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FGM9W2DuBTgEXv1ClCm8H%2Fuploads%2Fgit-blob-8ec663ec14a078cd33ab3d08ed7a74fe6c61de78%2Fimage7.png?alt=media)

**Output files (dragen\_imputation folder)**

The VCF imputation tool generates a couple outputs:

* Imputed variant file with concatenated imputed variants: one VCF or msVCF file which contains all the specified regions/chromosomes with name \<prefix>.impute.vcf.gz

Intermediate files:

* Chunk regions to be passed along to the internal phase step with the name \<prefix>.impute.chunk.out.txt.
* Imputed variants per chunks identified: VCF or msVCF file based on the input sample format with the name \<prefix>\_chr\_start-end.impute.phase.vcf.gz.
* A text file with the path to all the \<prefix>\_chr\_start-end.impute.phase.vcf.gz files generated with the name \<prefix>.impute.phase.out.txt

**Known limitations:**

* Support up to 100 samples.
* Input VCF files are expected to be force genotyped for all variants presented in the reference panel.
* Only can impute diploid regions.

\
\
\ <br>

|                                                                                                                                                                                                                                                                                                                                                                 |
| :-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------: |
| *For any feedback or questions regarding this article (Illumina Knowledge Article #7061), contact Illumina Technical Support* [*techsupport@illumina.com*](mailto:techsupport@illumina.com?subject=Question%2FFeedback%20Regarding%20Illumina%20Knowledge%20Article%20#000007061%20-%20Software%20\&body=Dear%20Illumina%20Technical%20Support,%0D%0A%0D%0A)*.* |


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

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

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://knowledge.illumina.com/software/general/software-general-reference_material-list/000007061.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

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.
