# Troubleshooting the analysis

<details>

<summary>Why are the Tumor Mutation Burden (TMB) values not what I expected?</summary>

**Low TMB values**

Variants that do not meet the minimum depth (DP) threshold are excluded from the TMB calculation. The `--vc-callability-tumor-thresh` command line option specifies the threshold value. The default value is 50, and this value assumes at least 100x coverage. If raw coverage is lower than 100x and and tumor purity >= 80%, the threshold value can be decreased to 30, by specifying `--vc-callability-tumor-thresh 30` as an additional argument.

**High TMB values**

DRAGEN outputs both TMB and NonSyn TMB metrics, where [TMB includes all Filtered Variants in the calculation and NonSyn TMB includes Filtered Nonsynonymous Variants](https://help.dragen.illumina.com/product-guide/dragen-v4.4/dragen-dna-pipeline/biomarkers/biomarker-tmb#id-3.-variant-filters). One metric may be more appropriate than the other for a given comparison. For example, Seracare TMB reference samples include only nonsynonymous variants in their TMB metric.

</details>

<details>

<summary>Why do I have too many/too few PASSing somatic variants?</summary>

Somatic variants with a quality score less than the threshold value \[0..30] are marked as filtered in the output vcf. The `--vc-sq-filter-threshold`command line option specifies the threshold value. The default value for Tumor/Normal mode is 17.5. We observed that with this library preparation kit, the threshold needed to be lowered slightly to 15 to achieve high sensitivity. Raise this value to improve specificity at the cost of sensitivity, or lower it to improve sensitivity at the cost of specificity.

</details>

<details>

<summary>Why do some qc-coverage metrics report different values between command line and BSSH?</summary>

There are some rare instances where DRAGEN and BSSH apps have different default settings that might lead to slight difference in coverage calculations. For instance, the BSSH Enrichment App outputs a Aggregate Summary Metrics file that include all reads with MAPQ>=0 in the coverage calculations, while in DRAGEN command-line, MAPQ=0 reads are filtered. To include MAPQ=0 reads in DRAGEN command-line coverage, the flag <kbd>--qc-coverage-filters-1 “mapq<0”</kbd> can be added to the recipe.

</details>

<details>

<summary>Why is the CNV VCF file empty?</summary>

The first thing to check is the coverage of the normal sample. Normal sample counts are added to PON, and if the counts from the normal sample are nearly empty, the GC correction stage will fail. In that case, DRAGEN will output an empty VCF.

</details>


---

# 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-ffpe-dna-prep-with-exome-2.5/additional-information/troubleshooting-the-analysis.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.
