Overview
MD5Sum: c66d8f1e95b11ae4c170c572607b8c15
Documentation
Documentation for dragen-transcriptome-pipeline v4.2.4
Dockstore
ICAv2
Tenant: umccr-prod
Bundles Generated
Bundle Name: dragen_transcriptome_pipeline_with_validation_data__4_2_4__20241210230924 / Bundle Version v9_r3__20241210230924
Description
This bundle has been generated by the release of workflows/dragen-transcriptome-pipeline/4.2.4/dragen-transcriptome-pipeline__4.2.4.cwl. The pipeline can be found at https://github.com/umccr/cwl-ica/releases/tag/dragen-transcriptome-pipeline/4.2.4__20241210230924.
Version Description
Bundle version description is currently redundant while we cannot append versions to bundles. Regardless - the bunch version is v9_r3
Bundle ID: 55384505-279d-496b-80c8-8c24fd0e06e3
- Bundle Link
Pipeline Project ID: 5844391a-69db-4b52-86b5-6a0d55c2386f
Pipeline Project Name: pipelines
Pipeline ID: 73e21ce0-60d7-4e3e-b130-88aff78d500d
Pipeline Code: dragen-transcriptome-pipeline__4_2_4__20241210230924
Projects
- development
- staging
Datasets
- dragen_hash_table_hg38_alt_masked_v9_r3_linear_cnv_hla_rna
- hg38_fasta
- arriba_2_4_0
- hg38_v39_gencode_annotation
- wts_validation_fastq__SBJ00480
- wts_validation_fastq__SBJ00028
- wts_validation_fastq__SBJ00061
- wts_validation_fastq__SBJ00188
- wts_validation_fastq__SBJ00199
- wts_validation_fastq__SBJ00236
- wts_validation_fastq__SBJ00238
- wts_multiqc__2023_07_21__4_2_4__Ref_1_Good__SBJ01563
- wts_multiqc__2023_07_21__4_2_4__Ref_2_Good__SBJ01147
- wts_multiqc__2023_07_21__4_2_4__Ref_3_Good__SBJ01620
- wts_multiqc__2023_07_21__4_2_4__Ref_4_Bad__SBJ01286
- wts_multiqc__2023_07_21__4_2_4__Ref_5_Bad__SBJ01673
Bundle Name: dragen_transcriptome_pipeline_prod__4_2_4__20241210230924 / Bundle Version v9_r3__20241210230924
Description
This bundle has been generated by the release of workflows/dragen-transcriptome-pipeline/4.2.4/dragen-transcriptome-pipeline__4.2.4.cwl. The pipeline can be found at https://github.com/umccr/cwl-ica/releases/tag/dragen-transcriptome-pipeline/4.2.4__20241210230924.
Version Description
Bundle version description is currently redundant while we cannot append versions to bundles. Regardless - the bunch version is v9_r3
Bundle ID: 24f3ae95-6a38-4864-89e0-5d71174089c1
- Bundle Link
Pipeline Project ID: 5844391a-69db-4b52-86b5-6a0d55c2386f
Pipeline Project Name: pipelines
Pipeline ID: 73e21ce0-60d7-4e3e-b130-88aff78d500d
Pipeline Code: dragen-transcriptome-pipeline__4_2_4__20241210230924
Projects
- production
Datasets
- dragen_hash_table_hg38_alt_masked_v9_r3_linear_cnv_hla_rna
- hg38_fasta
- arriba_2_4_0
- hg38_v39_gencode_annotation
- wts_multiqc__2023_07_21__4_2_4__Ref_1_Good__SBJ01563
- wts_multiqc__2023_07_21__4_2_4__Ref_2_Good__SBJ01147
- wts_multiqc__2023_07_21__4_2_4__Ref_3_Good__SBJ01620
- wts_multiqc__2023_07_21__4_2_4__Ref_4_Bad__SBJ01286
- wts_multiqc__2023_07_21__4_2_4__Ref_5_Bad__SBJ01673
Visual Overview
Inputs Template
Yaml
Click to expand!
# yaml-language-server: $schema=https://github.com/umccr/cwl-ica/releases/download/dragen-transcriptome-pipeline%2F4.2.4__20241210230924/dragen-transcriptome-pipeline__4.2.4__20241210230924.schema.json
# algorithm (Optional)
# Default value: proportional
# Docs: Counting algorithm:
# uniquely-mapped-reads(default) or proportional.
algorithm: "proportional"
# annotation file (Required)
# Docs: Path to annotation transcript file.
annotation_file:
class: File
location: icav2://project_id/path/to/file
# bam input (Optional)
# Docs: Input a BAM file for WTS analysis
bam_input:
class: File
location: icav2://project_id/path/to/file
# blacklist (Required)
# Docs: File with blacklist range
blacklist:
class: File
location: icav2://project_id/path/to/file
# cl config (Optional)
# Docs: command line config to supply additional config values on the command line.
cl_config: string
# contigs (Optional)
# Docs: Optional - List of interesting contigs
# If not specified, defaults to 1,2,3,4,5,6,7,8,9,10,11,12,13,14,15,16,17,18,19,20,21,22,X,Y
contigs: string
# cytobands (Required)
# Docs: Coordinates of the Giemsa staining bands.
cytobands:
class: File
location: icav2://project_id/path/to/file
# enable duplicate marking (Required)
# Docs: Mark identical alignments as duplicates
enable_duplicate_marking: false
# enable map align (Optional)
# Docs: Enabled by default.
# Set this value to false if using bam_input AND tumor_bam_input
enable_map_align: false
# enable map align output (Required)
# Docs: Do you wish to have the output bam files present
enable_map_align_output: false
# enable rna gene fusion (Optional)
# Docs: Optional - Enable the DRAGEN Gene Fusion module - defaults to true
enable_rna_gene_fusion: false
# enable rna quantification (Optional)
# Docs: Optional - Enable the quantification module - defaults to true
enable_rna_quantification: false
# enable sort (Optional)
# Docs: True by default, only set this to false if using --bam-input as input parameter
enable_sort: false
# fastq list (Optional)
# Docs: CSV file that contains a list of FASTQ files
# to process. read_1 and read_2 components in the CSV file must be presigned urls.
fastq_list:
class: File
location: icav2://project_id/path/to/file
# Row of fastq lists (Optional)
# Docs: The row of fastq lists.
# Each row has the following attributes:
# * RGID
# * RGLB
# * RGSM
# * Lane
# * Read1File
# * Read2File (optional)
fastq_list_rows:
- rgid: string
rglb: string
rgsm: string
lane: string
read_1:
class: File
location: icav2://project_id/path/to/file
read_2:
class: File
location: icav2://project_id/path/to/file
# java mem (Optional)
# Default value: 20G
# Docs: Set desired Java heap memory size
java_mem: "20G"
# license instance id location (Optional)
# Docs: You may wish to place your own in.
# Optional value, default set to /opt/instance-identity
# which is a path inside the dragen container
lic_instance_id_location:
class: File
location: icav2://project_id/path/to/file
# ora reference tar (Optional)
# Docs: Path to ref data tarball
ora_reference_tar:
class: File
location: icav2://project_id/path/to/file
# output file prefix (Required)
# Docs: The prefix given to all output files
output_prefix: string
# protein domains (Required)
# Docs: GFF3 file containing the genomic coordinates of protein domains.
protein_domains:
class: File
location: icav2://project_id/path/to/file
# qc reference samples (Required)
# Docs: Reference samples for multiQC report
qc_reference_samples:
- class: Directory
location: icav2://project_id/path/to/dir/
# read trimming (Optional)
# Docs: To enable trimming filters in hard-trimming mode, set to a comma-separated list of the trimmer tools
# you would like to use. To disable trimming, set to none. During mapping, artifacts are removed from all reads.
# Read trimming is disabled by default.
read_trimmers: string
# reference Fasta (Required)
# Docs: FastA file with genome sequence
reference_fasta:
class: File
location: icav2://project_id/path/to/file
# reference tar (Required)
# Docs: Path to ref data tarball
reference_tar:
class: File
location: icav2://project_id/path/to/file
# soft read trimming (Optional)
# Docs: To enable trimming filters in soft-trimming mode, set to a comma-separated list of the trimmer tools
# you would like to use. To disable soft trimming, set to none. During mapping, reads are aligned as if trimmed,
# and bases are not removed from the reads. Soft-trimming is enabled for the polyg filter by default.
soft_read_trimmers: string
# trim adapter r1 5prime (Optional)
# Docs: Specify the FASTA file that contains adapter sequences to trim from the 5' end of Read 1.
# NB: the sequences should be in reverse order (with respect to their appearance in the FASTQ) but not complemented.
trim_adapter_r1_5prime:
class: File
location: icav2://project_id/path/to/file
# trim adapter read1 (Optional)
# Docs: Specify the FASTA file that contains adapter sequences to trim from the 3' end of Read 1.
trim_adapter_read1:
class: File
location: icav2://project_id/path/to/file
# trim adapter read2 (Optional)
# Docs: Specify the FASTA file that contains adapter sequences to trim from the 3' end of Read 2.
trim_adapter_read2:
class: File
location: icav2://project_id/path/to/file
# trim adapter stringency (Optional)
# Docs: Specify the minimum number of adapter bases required for trimming
trim_adapter_stringency: string
# trim adapter r2 5prime (Optional)
# Docs: Specify the FASTA file that contains adapter sequences to trim from the 5' end of Read 2.
# NB: the sequences should be in reverse order (with respect to their appearance in the FASTQ) but not complemented.
trim_dapter_r2_5prime:
class: File
location: icav2://project_id/path/to/file
# trim r1 3prime (Optional)
# Docs: Specify the minimum number of bases to trim from the 3' end of Read 1 (default: 0).
trim_r1_3prime: string
# trim r1 5prime (Optional)
# Docs: Specify the minimum number of bases to trim from the 5' end of Read 1 (default: 0).
trim_r1_5prime: string
# trim r2 3prime (Optional)
# Docs: Specify the minimum number of bases to trim from the 3' end of Read 2 (default: 0).
trim_r2_3prime: string
# trim r2 5prime (Optional)
# Docs: Specify the minimum number of bases to trim from the 5' end of Read 2 (default: 0).
trim_r2_5prime: string
Json
Click to expand!
{
"algorithm": "proportional",
"annotation_file": {
"class": "File",
"location": "icav2://project_id/path/to/file"
},
"bam_input": {
"class": "File",
"location": "icav2://project_id/path/to/file"
},
"blacklist": {
"class": "File",
"location": "icav2://project_id/path/to/file"
},
"cl_config": "string",
"contigs": "string",
"cytobands": {
"class": "File",
"location": "icav2://project_id/path/to/file"
},
"enable_duplicate_marking": false,
"enable_map_align": false,
"enable_map_align_output": false,
"enable_rna_gene_fusion": false,
"enable_rna_quantification": false,
"enable_sort": false,
"fastq_list": {
"class": "File",
"location": "icav2://project_id/path/to/file"
},
"fastq_list_rows": [
{
"rgid": "string",
"rglb": "string",
"rgsm": "string",
"lane": "string",
"read_1": {
"class": "File",
"location": "icav2://project_id/path/to/file"
},
"read_2": {
"class": "File",
"location": "icav2://project_id/path/to/file"
}
}
],
"java_mem": "20G",
"lic_instance_id_location": {
"class": "File",
"location": "icav2://project_id/path/to/file"
},
"ora_reference_tar": {
"class": "File",
"location": "icav2://project_id/path/to/file"
},
"output_prefix": "string",
"protein_domains": {
"class": "File",
"location": "icav2://project_id/path/to/file"
},
"qc_reference_samples": [
{
"class": "Directory",
"location": "icav2://project_id/path/to/dir/"
}
],
"read_trimmers": "string",
"reference_fasta": {
"class": "File",
"location": "icav2://project_id/path/to/file"
},
"reference_tar": {
"class": "File",
"location": "icav2://project_id/path/to/file"
},
"soft_read_trimmers": "string",
"trim_adapter_r1_5prime": {
"class": "File",
"location": "icav2://project_id/path/to/file"
},
"trim_adapter_read1": {
"class": "File",
"location": "icav2://project_id/path/to/file"
},
"trim_adapter_read2": {
"class": "File",
"location": "icav2://project_id/path/to/file"
},
"trim_adapter_stringency": "string",
"trim_dapter_r2_5prime": {
"class": "File",
"location": "icav2://project_id/path/to/file"
},
"trim_r1_3prime": "string",
"trim_r1_5prime": "string",
"trim_r2_3prime": "string",
"trim_r2_5prime": "string"
}
Outputs Template
Click to expand!
{
"arriba_output_directory": {
"class": "Directory",
"location": "icav2://project_id/path/to/dir/"
},
"dragen_transcriptome_output_directory": {
"class": "Directory",
"location": "icav2://project_id/path/to/dir/"
},
"multiqc_output_directory": {
"class": "Directory",
"location": "icav2://project_id/path/to/dir/"
},
"qualimap_output_directory": {
"class": "Directory",
"location": "icav2://project_id/path/to/dir/"
}
}
Overrides Template
Zipped workflow
Click to expand!
[
"workflow.cwl#dragen-transcriptome-pipeline--4.2.4/arriba_drawing_step",
"workflow.cwl#dragen-transcriptome-pipeline--4.2.4/arriba_fusion_step",
"workflow.cwl#dragen-transcriptome-pipeline--4.2.4/create_arriba_output_directory",
"workflow.cwl#dragen-transcriptome-pipeline--4.2.4/create_dummy_file_step",
"workflow.cwl#dragen-transcriptome-pipeline--4.2.4/dragen_qc_step",
"workflow.cwl#dragen-transcriptome-pipeline--4.2.4/run_dragen_transcriptome_step",
"workflow.cwl#dragen-transcriptome-pipeline--4.2.4/run_qualimap_step"
]
Packed workflow
Click to expand!
[
"#main/arriba_drawing_step",
"#main/arriba_fusion_step",
"#main/create_arriba_output_directory",
"#main/create_dummy_file_step",
"#main/dragen_qc_step",
"#main/run_dragen_transcriptome_step",
"#main/run_qualimap_step"
]
Inputs
Click to expand!
algorithm
ID: algorithm
Optional: True
Type: string
Docs:
Counting algorithm:
uniquely-mapped-reads(default) or proportional.
annotation file
ID: annotation_file
Optional: False
Type: File
Docs:
Path to annotation transcript file.
bam input
ID: bam_input
Optional: True
Type: File
Docs:
Input a BAM file for WTS analysis
blacklist
ID: blacklist
Optional: False
Type: File
Docs:
File with blacklist range
cl config
ID: cl_config
Optional: True
Type: string
Docs:
command line config to supply additional config values on the command line.
contigs
ID: contigs
Optional: True
Type: string
Docs:
Optional - List of interesting contigs
If not specified, defaults to 1,2,3,4,5,6,7,8,9,10,11,12,13,14,15,16,17,18,19,20,21,22,X,Y
cytobands
ID: cytobands
Optional: False
Type: File
Docs:
Coordinates of the Giemsa staining bands.
enable duplicate marking
ID: enable_duplicate_marking
Optional: False
Type: boolean
Docs:
Mark identical alignments as duplicates
enable map align
ID: enable_map_align
Optional: True
Type: boolean
Docs:
Enabled by default.
Set this value to false if using bam_input AND tumor_bam_input
enable map align output
ID: enable_map_align_output
Optional: False
Type: boolean
Docs:
Do you wish to have the output bam files present
enable rna gene fusion
ID: enable_rna_gene_fusion
Optional: True
Type: boolean
Docs:
Optional - Enable the DRAGEN Gene Fusion module - defaults to true
enable rna quantification
ID: enable_rna_quantification
Optional: True
Type: boolean
Docs:
Optional - Enable the quantification module - defaults to true
enable sort
ID: enable_sort
Optional: True
Type: boolean
Docs:
True by default, only set this to false if using --bam-input as input parameter
fastq list
ID: fastq_list
Optional: True
Type: File
Docs:
CSV file that contains a list of FASTQ files
to process. read_1 and read_2 components in the CSV file must be presigned urls.
Row of fastq lists
ID: fastq_list_rows
Optional: True
Type: fastq-list-row[]
Docs:
The row of fastq lists.
Each row has the following attributes:
- RGID
- RGLB
- RGSM
- Lane
- Read1File
- Read2File (optional)
java mem
ID: java_mem
Optional: False
Type: string
Docs:
Set desired Java heap memory size
license instance id location
ID: lic_instance_id_location
Optional: True
Type: ['File', 'string']
Docs:
You may wish to place your own in.
Optional value, default set to /opt/instance-identity
which is a path inside the dragen container
ora reference tar
ID: ora_reference_tar
Optional: True
Type: File
Docs:
Path to ref data tarball
output file prefix
ID: output_prefix
Optional: False
Type: string
Docs:
The prefix given to all output files
protein domains
ID: protein_domains
Optional: False
Type: File
Docs:
GFF3 file containing the genomic coordinates of protein domains.
qc reference samples
ID: qc_reference_samples
Optional: False
Type: .[]
Docs:
Reference samples for multiQC report
read trimming
ID: read_trimmers
Optional: True
Type: string
Docs:
To enable trimming filters in hard-trimming mode, set to a comma-separated list of the trimmer tools
you would like to use. To disable trimming, set to none. During mapping, artifacts are removed from all reads.
Read trimming is disabled by default.
reference Fasta
ID: reference_fasta
Optional: False
Type: File
Docs:
FastA file with genome sequence
reference tar
ID: reference_tar
Optional: False
Type: File
Docs:
Path to ref data tarball
soft read trimming
ID: soft_read_trimmers
Optional: True
Type: string
Docs:
To enable trimming filters in soft-trimming mode, set to a comma-separated list of the trimmer tools
you would like to use. To disable soft trimming, set to none. During mapping, reads are aligned as if trimmed,
and bases are not removed from the reads. Soft-trimming is enabled for the polyg filter by default.
trim adapter r1 5prime
ID: trim_adapter_r1_5prime
Optional: True
Type: File
Docs:
Specify the FASTA file that contains adapter sequences to trim from the 5' end of Read 1.
NB: the sequences should be in reverse order (with respect to their appearance in the FASTQ) but not complemented.
trim adapter read1
ID: trim_adapter_read1
Optional: True
Type: File
Docs:
Specify the FASTA file that contains adapter sequences to trim from the 3' end of Read 1.
trim adapter read2
ID: trim_adapter_read2
Optional: True
Type: File
Docs:
Specify the FASTA file that contains adapter sequences to trim from the 3' end of Read 2.
trim adapter stringency
ID: trim_adapter_stringency
Optional: True
Type: int
Docs:
Specify the minimum number of adapter bases required for trimming
trim adapter r2 5prime
ID: trim_dapter_r2_5prime
Optional: True
Type: File
Docs:
Specify the FASTA file that contains adapter sequences to trim from the 5' end of Read 2.
NB: the sequences should be in reverse order (with respect to their appearance in the FASTQ) but not complemented.
trim r1 3prime
ID: trim_r1_3prime
Optional: True
Type: int
Docs:
Specify the minimum number of bases to trim from the 3' end of Read 1 (default: 0).
trim r1 5prime
ID: trim_r1_5prime
Optional: True
Type: int
Docs:
Specify the minimum number of bases to trim from the 5' end of Read 1 (default: 0).
trim r2 3prime
ID: trim_r2_3prime
Optional: True
Type: int
Docs:
Specify the minimum number of bases to trim from the 3' end of Read 2 (default: 0).
trim r2 5prime
ID: trim_r2_5prime
Optional: True
Type: int
Docs:
Specify the minimum number of bases to trim from the 5' end of Read 2 (default: 0).
Steps
Click to expand!
arriba drawing step
ID: dragen-transcriptome-pipeline--4.2.4/arriba_drawing_step
Step Type: tool
Docs:
Run Arriba drawing script for fusions predicted by previous step.
arriba fusion step
ID: dragen-transcriptome-pipeline--4.2.4/arriba_fusion_step
Step Type: tool
Docs:
Runs Arriba fusion calling on the bam file produced by Dragen.
create arriba output directory
ID: dragen-transcriptome-pipeline--4.2.4/create_arriba_output_directory
Step Type: tool
Docs:
Create an output directory to contain the arriba files
Create dummy file
ID: dragen-transcriptome-pipeline--4.2.4/create_dummy_file_step
Step Type: tool
Docs:
Intermediate step for letting multiqc-interop be placed in stream mode
dragen qc step
ID: dragen-transcriptome-pipeline--4.2.4/dragen_qc_step
Step Type: tool
Docs:
The dragen qc step - this takes in an array of dirs
run dragen transcriptome step
ID: dragen-transcriptome-pipeline--4.2.4/run_dragen_transcriptome_step
Step Type: tool
Docs:
Runs the dragen transcriptome workflow on the FPGA.
Takes in a fastq list and corresponding mount paths from the predefined_mount_paths.
All other options avaiable at the top of the workflow
run qualimap step
ID: dragen-transcriptome-pipeline--4.2.4/run_qualimap_step
Step Type: tool
Docs:
Run qualimap step to generate additional QC metrics
Outputs
Click to expand!
arriba output directory
ID: dragen-transcriptome-pipeline--4.2.4/arriba_output_directory
Optional: False
Output Type: Directory
Docs:
The directory containing output files from arriba
dragen transcriptome output directory
ID: dragen-transcriptome-pipeline--4.2.4/dragen_transcriptome_output_directory
Optional: False
Output Type: Directory
Docs:
The output directory containing all transcriptome output files
multiqc output directory
ID: dragen-transcriptome-pipeline--4.2.4/multiqc_output_directory
Optional: False
Output Type: Directory
Docs:
The output directory for multiqc
dragen transcriptome output directory
ID: dragen-transcriptome-pipeline--4.2.4/qualimap_output_directory
Optional: False
Output Type: Directory
Docs:
The output directory containing all transcriptome output files