> For the complete documentation index, see [llms.txt](https://help.bioinsight.illumina.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.bioinsight.illumina.com/dragen-5-base/additional-information/previous-dragen-app-pipeline-instructions/ica-analysis-setup/dragen-somatic-whole-genome/dragen-somatic-whole-genome.md).

# DRAGEN Somatic (Whole Genome)

**WARNING**: Deviation from these instructions (including adding additional options) may cause pipeline failure.

1. Select the necessary input files for the run, including Tumor and Normal inputs (.fastq, .fastq.ora, .bam, or .cram files) and a Baseline Systematic Noise Filter BED File.
2. Select a reference genome. 5-base is compatible with any methyl\_cg reference. One recommendation is the Homo sapiens \[1000 Genomes] hg38 v5 Pangenome reference.
   1. A graph reference is recommended for Germline and non-graph is the recommendation for Somatic.<br>

      <figure><img src="https://707781091-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FL2tTN7buOERM9NKPYYlg%2Fuploads%2Fgit-blob-e3090fe639ab902f4093eb70a6b0652ea16f845a%2Fimage%20(2).png?alt=media" alt=""><figcaption></figcaption></figure>
3. To Enable Methylation Aware Algorithms, check the box for Enable 5-Base Methylation-Aware Algorithms.<br>

   <figure><img src="https://707781091-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FL2tTN7buOERM9NKPYYlg%2Fuploads%2Fgit-blob-bd69f43540c6cc1c080a55e5326595425a816a45%2Fimage%20(3).png?alt=media" alt=""><figcaption></figcaption></figure>
4. (Optional, if performing tumor-normal analysis only) Set Enable Germline Variant Calling On Normal Sample to "True".<br>

   <figure><img src="https://707781091-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FL2tTN7buOERM9NKPYYlg%2Fuploads%2Fgit-blob-6594a18905e25a885c9787d0cbbe4c553a42e491%2Fimage%20(90).png?alt=media" alt=""><figcaption></figcaption></figure>
5. For Report Methylation at Variant Positions, select "default".<br>

   <figure><img src="https://707781091-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FL2tTN7buOERM9NKPYYlg%2Fuploads%2Fgit-blob-eaa0bd14de9516a735bff3c1f953245ef3758fdd%2Fimage%20(124).png?alt=media" alt=""><figcaption></figcaption></figure>
6. (Optional) To perform Small Variant Calling:
   1. Set Enable Small Variant Caller to "True"
   2. Set Emit Ref Confidence to "GVCF"
   3. Set Enable VCF File Output to "True".
   4. Set Enable Germline Tagging to "True".

      <figure><img src="https://707781091-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FL2tTN7buOERM9NKPYYlg%2Fuploads%2Fgit-blob-d44fffb699dc1a155711d3a07449ac2702139ddc%2Fimage%20(68).png?alt=media" alt="" width="563"><figcaption></figcaption></figure>
7. (Optional) To perform Copy Number Variant Calling:
   1. Turn on "Enable CNV Calling" and optinally provide additional BED or PoN files.\
      ![](https://707781091-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FL2tTN7buOERM9NKPYYlg%2Fuploads%2Fgit-blob-4645c805b0dcb3e8fa728728c059bb3e0bac9c9e%2Fimage%20\(86\).png?alt=media)
   2. Turn off "Enable Cytogenetics" as this is not supported for 5-base.\
      ![](https://707781091-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FL2tTN7buOERM9NKPYYlg%2Fuploads%2Fgit-blob-dc991ae41383a3d3bcb8319ba933a10cab8ce5c5%2Fimage%20\(91\).png?alt=media)
8. (Optional) To perform Structural Variant Calling:
   1. Set Enable SV Calling to "True"
   2. (Optional) Upload a Custom SV Target BED or Systematic Noise BED<br>

      <figure><img src="https://707781091-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FL2tTN7buOERM9NKPYYlg%2Fuploads%2Fgit-blob-da445824b9c824c1a44c60a9fa36873b93e27853%2Fimage%20(83).png?alt=media" alt=""><figcaption></figcaption></figure>
9. In the UMI Options section:
   1. Set Enable UMI to false.
   2. Click the "X" next to UMI Library Type (screenshot displays the button to click; the box will disappear upon selecting).
   3. Click the "X" next to UMI Aware Variant Calling (screenshot displays the button to click; the box will disappear upon selecting).
   4. Click the "X" next to Minimum Supporting UMI Reads (screenshot displays the button to click; the box will disappear upon selecting).<br>

      <figure><img src="https://707781091-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FL2tTN7buOERM9NKPYYlg%2Fuploads%2Fgit-blob-db515dbfc15717aa5272e440cdb1effc644faa90%2Fimage%20(69).png?alt=media" alt="" width="563"><figcaption></figcaption></figure>
10. In the Variant Annotation Options section:
    1. Set Enable Variant Annotation to true<br>

       <figure><img src="https://707781091-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FL2tTN7buOERM9NKPYYlg%2Fuploads%2Fgit-blob-36564e516fdf37785b827a0466af9b32f4962290%2Fimage%20(70).png?alt=media" alt="" width="563"><figcaption></figcaption></figure>
11. In the Additional Options section:
    1. (Optional) Check "Enable Variant Annotations" to turn on DRAGEN Variant Annotation.
    2. (Optional) If downsampling is required, add `--enable-fractional-down-sampler=true --down-sampler-tumor-subsample=$Fraction` under Additional DRAGEN Commandline Arguments, where $Fraction is a value between 0 and 1 representing the proportion of reads to keep. For tumor-normal analyses, use `--down-sampler-normal-subsample` for the normal sample.
    3. (Optional) If running cfDNA samples, it's recommended to add `--mbias-report-include-overlaps=true` under Additional DRAGEN Commandline Arguments to ensure the M-bias report captures the full R2 read-cycle profile. This is important for cfDNA since the short fragments cause most of R2 to overlap R1 and be excluded from bias statistics by default.
    4. (Optional) Under Additional DRAGEN Commandline Arguments, add `--gc-metrics-enable=true` to enable GC metrics.
12. Start the analysis.


---

# 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://help.bioinsight.illumina.com/dragen-5-base/additional-information/previous-dragen-app-pipeline-instructions/ica-analysis-setup/dragen-somatic-whole-genome/dragen-somatic-whole-genome.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.
