Skip to content

Output Layout

Ali Altintas edited this page Aug 26, 2026 · 6 revisions

Output Layout

results/
├── fastq/{sample}_R{1,2}.fastq.gz                  # only for lane/run-split samples:
│                                                    #   concatenated lanes
├── fastqc/raw/{sample}_R{1,2}_fastqc.zip           # always-on FastQC of the raw input
├── trimming/                                       # only if trimming is enabled:
│   ├── {sample}_val_{1,2}.fq.gz                    #   trimmed reads (paired)
│   ├── {sample}_trimmed.fq.gz                      #   trimmed reads (single-end)
│   ├── {sample}_*_fastqc.html/.zip                 #   FastQC (run inside TrimGalore!)
│   └── {sample}_*_trimming_report.txt              #   TrimGalore! report
├── star_index/                                     # generated STAR genome index
├── star_pass1/{sample}_SJ.out.tab                  # only if star.two_pass: cohort:
│                                                    #   per-sample pass-1 junctions (BAM-less)
├── star_pass1/merged_SJ.out.tab                    #   pooled/filtered novel junctions
├── reference/annotation.{genePred,bed12}           # generated RSeQC gene model (BED12)
├── star/{sample}_Aligned.out.bam                   # unsorted, fed to TEcount
├── star/{sample}_Aligned.sortedByCoord.out.bam(.bai)   # for RSeQC/QC
├── rseqc/{sample}_infer_experiment.txt             # raw RSeQC report
├── rseqc/{sample}_strandedness.txt                 # resolved no/forward/reverse
├── tecount/{sample}.cntTable                       # per-sample gene+TE counts
├── tecount/counts_matrix.tsv                       # feature x samples (if tetranscripts.qc.enabled)
├── tecount/qc/{pca_transform}_counts.tsv           #   QC-view transformed matrix
├── tecount/qc/pca_{pca_transform}_mqc.json         #   sample-QC PCA (custom content)
├── tecount/qc/heatmap_{pca_transform}_mqc.json     #   sample-QC distance heatmap
├── tecount/qc/tecount_assignment_mqc.json          #   gene-vs-TE summary barplot
├── tecount/qc/tecount_te_class_mqc.json            #   TE class composition barplot
├── tetranscripts/{contrast}_*.{txt,R}              # only if "condition" column present
│                                                    #   ({contrast}.cntTable, _DESeq2.R,
│                                                    #   _gene_TE_analysis.txt, _sigdiff_gene_TE.txt)
├── telocal/                                          # only if telocal.enabled (default: true):
│   ├── locInd                                        #   auto-built TElocal index (if locind empty;
│   │                                                 #   removed when outputs.keep_telocal_index: false)
│   ├── {sample}.cntTable.gz                          #   per-sample locus-level TE counts
│   ├── telocal_locations.bed                         #   TE key -> coordinates, BED6
│   ├── counts_matrix.tsv.gz                          #   locus x samples (if telocal.qc.enabled)
│   └── qc/
│       ├── {pca_transform}_counts.tsv.gz             #   QC-view transformed matrix
│       ├── pca_{pca_transform}_mqc.json              #   sample-QC PCA (custom content)
│       ├── heatmap_{pca_transform}_mqc.json          #   sample-QC distance heatmap
│       ├── telocal_assignment_mqc.json               #   gene-vs-TE summary barplot
│       └── telocal_te_class_mqc.json                 #   TE class composition barplot
├── chimera/                                        # always (set chimera.enabled: false to skip):
│   ├── {sample}_junctions.tsv                      #   per-sample annotated junctions
│   ├── {sample}_te_chimeras.tsv                    #   per-sample gene-TE events only
│   ├── all_events.tsv                              #   merged event catalog
│   ├── te_chimeras.tsv                             #   merged gene-TE events only
│   ├── counts_matrix.tsv                           #   events x samples (if write_counts_matrix)
│   ├── qc/{sample}_junction_qc.tsv                 #   per-sample junction summary
│   ├── qc/junction_qc_mqc.json                     #   junction barplot by direction
│   ├── qc/te_chimeras_mqc.json                     #   TE-chimeras barplot (gene<->TE)
│   ├── qc/{pca_transform}_mqc.json                 #   sample-QC PCA (custom content)
│   ├── qc/heatmap_{pca_transform}_mqc.json         #   sample-QC distance heatmap
│   └── igv/{sample}_junctions.bed                  #   IGV track (if write_igv_bed)
├── versions/rnaseq_mqc_versions.yml                # pinned tool versions -> MultiQC
├── qc/multiqc_report.html                          # FastQC + STAR + RSeQC (+ tecounts/telocal/chimera QC + summary barplots) + resource usage
└── pipeline_info/
    ├── benchmarks/<rule>/...                       # per-rule CPU/RSS usage (-> MultiQC)
    ├── benchmark_summary_mqc.json                  # "Resource usage" table (see below)
    └── logs/<rule>/...                             # per-rule stdout/stderr

Everything under input/ (your sample sheet, config, and reference fasta/GTF files) is supplied by you; everything under results/ (the index, gene model, alignments, counts, report, benchmarks, and logs) is generated by the workflow. Per-rule logs mirror the results layout under results/pipeline_info/logs/ (plus results/pipeline_info/logs/config_resolution.log, which records how sjdb_overhang, the decompressed-reference directory, and gzipped reference files were resolved).

Clone this wiki locally