> For the complete documentation index, see [llms.txt](https://help.dragen.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.dragen.illumina.com/dragen-v4.6/product-guides/dragen-v4.6/dragen-recipes/rna-amplicon.md). # RNA Amplicon A DRAGEN recipe, like this one, is a predefined set of analysis parameters and workflow settings tailored to a specific type of genomic analysis. For clarity, some default parameters are explicitly included and annotated with comments. ``` /opt/dragen/$VERSION/bin/dragen #DRAGEN install path --ref-dir $REF_DIR #path to DRAGEN linear hashtable --output-directory $OUTPUT --intermediate-results-dir $PATH #e.g. SSD /staging --output-file-prefix $PREFIX # Inputs --fastq-list $PATH #see 'Input Options' for FQ, BAM or CRAM --fastq-list-sample-id $STRING # Mapper --enable-rna true --annotation-file $GTF #GTF or GFF3 format --enable-map-align true #required for RNA/scRNA --enable-map-align-output true #optionally save the output BAM --enable-sort true #default=true # Amplicon --enable-rna-amplicon true --amplicon-target-bed $PATH --amplicon-enable-imbalance-ratio true #optional for panels that support 3'/5' imbalance-ratio --enable-duplicate-marking false #default=false # RNA Splice Variants --enable-rna-splice-variant true # RNA Gene Fusions --enable-rna-gene-fusion true # Annotation --variant-annotation-data $NIRVANA_PATH --enable-variant-annotation true ``` ## Notes and additional options ### Hashtable For DRAGEN RNA/scRNA runs, it is recommended to use the linear hashtable. See: [Product Files](https://support.illumina.com/sequencing/sequencing_software/dragen-bio-it-platform/product_files.html) ### RNA Amplicon To enable RNA amplicon, set: * `--enable-rna-amplicon true`, and * `--amplicon-target-bed $PATH`. If RNA amplicon mode is enabled and the amplicon bed file already includes the gene name, then it is not required to set the enriched option (rna-target-bed or rna-target-genes), since DRAGEN will read the enriched genes names from the amplicon BED file (fifth column). #### Pillar Specific Amplicon Settings To support the varied designs of amplicon panels and the specific requirements of different analysis types (e.g., SNV, CNV, SV, MSI, RNA fusion, RNA splice variants, and RNA 3'/5' imbalance ratio), panel-specific parameter settings have been integrated into the command-line options. Each supported Pillar panel has a dedicated option, and the details for these RNA panels are listed in the table below: | **Panel Name** | **Short Name** | **Panel Code** | **Sample Type** | **Default variant caller enabled** | **Command Line Options** | | :-----------------------------------: | :----------------------: | :------------: | :-------------: | :-------------------------------------------------------: | :-------------------------------: | | oncoReveal Heme | Heme | P-HFU-01 | RNA | RNA fusion | --amplicon-enable-rna-heme | | oncoReveal Fusion LBx | Fusion LBx | P-LBX-03 | cfRNA | RNA fusion, RNA splice-variant | --amplicon-enable-cfrna-lbxfusion | | oncoReveal Multi-Cancer RNA Fusion v2 | Multi-Cancer with Fusion | SF-V2 | RNA | RNA fusion, RNA splice-variant, RNA 3'/5' imbalance-ratio | --amplicon-enable-rna-multicancer | For more detail on the amplicon pipeline, please refer to [DRAGEN Amplicon Pipeline](/dragen-v4.6/product-guides/dragen-v4.6/dragen-amplicon-pipeline.md) ### Input options DRAGEN input sources include: fastq list, fastq, bam, or cram. For BCL input, first create FASTQs using [BCL conversion](/dragen-v4.6/product-guides/dragen-v4.6/bcl-conversion.md). FQ list Input ``` --fastq-list $PATH --fastq-list-sample-id $STRING ``` FQ Input ``` --fastq-file1 $PATH --fastq-file2 $PATH --RGSM $STRING --RGID $STRING ``` BAM Input ``` --bam-input $PATH ``` CRAM Input ``` --cram-input $PATH ``` ### Mapping and Aligning | Option | Description | | -------------------------------- | -------------------------------------------------------------- | | `--enable-map-align true` | For RNA/scRNA pipelines, map-align should always be turned on. | | `--enable-map-align-output true` | Optionally save the output BAM (default=false). | ### Duplicate Marking | Option | Description | | ---------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `--enable-duplicate-marking false` | The Amplicon Pipeline disables duplicate marking. In amplicon assays, fragments originate from a limited number of unique start and end positions, making conventional duplicate detection inappropriate. | ### RNA Variant Calling | Option | Description | | ----------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `--vc-target-bed $PATH` | Restrict the variants called to a target bed. A bed file specifying the gene-coding regions should be provided to avoid calling erroneous variants in unenriched or noncoding regions due to noisy reads. | ### RNA Splice Variant Calling | Option | Description | | ---------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `--rna-splice-variant-systematic-noise` | Enable systematic noise filtering using the specified BEDPE file to suppress noise and normal splice variant calls. See [Splice Variant Systematic Noise](/dragen-v4.6/product-guides/dragen-v4.6/dragen-rna-pipeline/splice-variant-caller.md#systematic-noise-filtering) for details. | | `--rna-splice-variant-knowns` | File with a list of expected splice junctions, these will be passed | | `--rna-splice-variant-fusion-genes` | List of genes that may contain splice fusions to be passed to the Gene Fusion output | | `--rna-splice-variant-min-score` | Minimum score for a splice variant to be reported (Default=0.5) | | `--rna-splice-variant-min-support-known` | Minimum number of unique reads supporting known and annotated splice variant required to PASS. (Default=2) | | `--rna-splice-variant-min-support-novel` | Minimum number of unique reads supporting novel variant required to PASS. (Default=2) | ### RNA Gene Fusion Calling | Option | Description | | --------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `--rna-gf-systematic-noise` | Enable systematic noise filtering using the specified BEDPE file to suppress noise and normal fusion calls. See [Gene Fusion Systematic Noise](/dragen-v4.6/product-guides/dragen-v4.6/dragen-rna-pipeline/gene-fusion-detection.md#systematic-noise-filtering) for details. | | `--rna-gf-include-biotypes` | Comma-separated list of biotypes to include in gene fusion (all for all biotypes, default=protein\_coding,lncRNA) | | `--rna-gf-min-target-gene-count` | Minimum number of target genes required for a fusion to be reported (Default is 2 for amplicon and 1 otherwise.) | | `--rna-gf-enable-post-filters` | Enable stringent post-filtering of RNA gene fusion candidates by quality flags to reduce false positives (Default=false) | | `--rna-gf-output-fusion-sequence` | Output assembled gene fusion sequence in fusion\_candidates.final file (Default=true) | | `--rna-gf-report-intronic` | Report fusion calls with intronic breakpoints (Default=true) | | `--rna-gf-report-antisense` | Report fusion calls with antisense and intronic breakpoints (Default=false) | | `--rna-gf-report-intergenic` | Report fusion calls with intergenic, antisense and intronic breakpoints (Default=false) | | `--rna-gf-report-read-through` | Report read-through fusion calls (Default=false) | | `--rna-gf-ptd-genes` | File with one gene name per line to call PTD/ITD associated self fusions | | `--rna-gf-min-score` | Minimum score for a gene fusion to be reported (Default=0.5) | ### Annotation For instructions on how to download the Nirvana annotation database, please refer to [Nirvana](/dragen-v4.6/product-guides/dragen-v4.6/nirvana.md) --- # 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 dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter: ``` GET https://help.dragen.illumina.com/dragen-v4.6/product-guides/dragen-v4.6/dragen-recipes/rna-amplicon.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal. 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.