# nf-core/metatdenovo architecture

> Architecture diagram of the GitHub repository nf-core/metatdenovo, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-01). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/nf-core/metatdenovo
- Repository: https://github.com/nf-core/metatdenovo

## Overview

nf-core/metatdenovo is a Nextflow pipeline for assembling and annotating metatranscriptomic and metagenomic sequencing data. Users provide a samplesheet and run the pipeline; the documented workflow performs read QC and preprocessing, assembly, ORF calling, gene quantification, functional and taxonomic annotation, and summary reporting. The README documents these capabilities and their order, but no source excerpts were provided, so implementation-level calls and finer orchestration links cannot be verified.

Main entry points: [`workflows/metatdenovo.nf`](https://github.com/nf-core/metatdenovo/blob/master/workflows/metatdenovo.nf) (Metatdenovo workflow), [`main.nf`](https://github.com/nf-core/metatdenovo/blob/master/main.nf) (Nextflow entry), [`modules/nf-core/fastqc/main.nf`](https://github.com/nf-core/metatdenovo/blob/master/modules/nf-core/fastqc/main.nf) (Read QC), [`modules/nf-core/multiqc/main.nf`](https://github.com/nf-core/metatdenovo/blob/master/modules/nf-core/multiqc/main.nf) (QC report)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_entry["Pipeline entry"]
  node_entrypoint["Nextflow entry<br/>[main.nf]"]
  node_workflow["Metatdenovo workflow<br/>[metatdenovo.nf]"]
end

subgraph group_reads["Read preparation"]
  node_fastqc["Read QC<br/>[main.nf]"]
  node_multiqc["QC report<br/>[main.nf]"]
  node_trim["Trim reads<br/>[main.nf]"]
  node_bbduk["Filter reads<br/>[main.nf]"]
  node_bbnorm["Normalize reads<br/>[main.nf]"]
  node_merge["Merge paired reads<br/>[main.nf]"]
end

subgraph group_assembly["Assembly and quantification"]
  node_megahit["MEGAHIT assembly<br/>[main.nf]"]
  node_spades["SPAdes assembly<br/>[main.nf]"]
  node_transdecoder["TransDecoder ORFs<br/>[main.nf]"]
  node_prodigal["Prodigal ORFs<br/>[main.nf]"]
  node_bbmap["Read mapping<br/>[main.nf]"]
  node_featurecounts["Gene counts<br/>[main.nf]"]
end

subgraph group_annotation["Annotation"]
  node_prokka["Prokka annotation<br/>[main.nf]"]
  node_eggnog["eggNOG annotation<br/>[main.nf]"]
  node_kofamscan["KofamScan annotation<br/>[main.nf]"]
  node_hmm["HMM search and ranking<br/>[main.nf]"]
  node_eukulele["EUKulele taxonomy<br/>[main.nf]"]
  node_diamond["DIAMOND taxonomy<br/>[main.nf]"]
end

subgraph group_reporting["Reporting"]
  node_summary["Summary statistics<br/>[main.nf]"]
  node_results["Pipeline results"]
end

node_user(("Pipeline user"))

node_user -->|"runs"| node_entrypoint
node_entrypoint -.->|"launches"| node_workflow
node_workflow -->|"performs QC"| node_fastqc
node_workflow -->|"reports QC"| node_multiqc
node_workflow -->|"trims reads"| node_trim
node_workflow -.->|"optionally filters"| node_bbduk
node_workflow -.->|"optionally normalizes"| node_bbnorm
node_workflow -->|"merges reads"| node_merge
node_workflow -->|"assembles with"| node_megahit
node_workflow -->|"assembles with"| node_spades
node_workflow -->|"calls ORFs with"| node_transdecoder
node_workflow -->|"annotates with"| node_prokka
node_workflow -->|"calls ORFs with"| node_prodigal
node_workflow -->|"maps reads"| node_bbmap
node_workflow -->|"quantifies genes"| node_featurecounts
node_workflow -->|"annotates with"| node_eggnog
node_workflow -->|"annotates with"| node_kofamscan
node_workflow -->|"searches and ranks"| node_hmm
node_workflow -->|"classifies taxonomy"| node_eukulele
node_workflow -->|"classifies taxonomy"| node_diamond
node_workflow -->|"summarizes results"| node_summary
node_workflow -->|"produces"| node_results

click node_entrypoint "https://github.com/nf-core/metatdenovo/blob/master/main.nf"
click node_workflow "https://github.com/nf-core/metatdenovo/blob/master/workflows/metatdenovo.nf"
click node_fastqc "https://github.com/nf-core/metatdenovo/blob/master/modules/nf-core/fastqc/main.nf"
click node_multiqc "https://github.com/nf-core/metatdenovo/blob/master/modules/nf-core/multiqc/main.nf"
click node_trim "https://github.com/nf-core/metatdenovo/blob/master/modules/nf-core/trimgalore/main.nf"
click node_bbduk "https://github.com/nf-core/metatdenovo/blob/master/modules/nf-core/bbmap/bbduk/main.nf"
click node_bbnorm "https://github.com/nf-core/metatdenovo/blob/master/modules/nf-core/bbmap/bbnorm/main.nf"
click node_merge "https://github.com/nf-core/metatdenovo/blob/master/modules/nf-core/seqtk/mergepe/main.nf"
click node_megahit "https://github.com/nf-core/metatdenovo/blob/master/modules/local/megahit/interleaved/main.nf"
click node_spades "https://github.com/nf-core/metatdenovo/blob/master/modules/nf-core/spades/main.nf"
click node_transdecoder "https://github.com/nf-core/metatdenovo/blob/master/modules/local/transdecoder/main.nf"
click node_prokka "https://github.com/nf-core/metatdenovo/blob/master/modules/nf-core/prokka/main.nf"
click node_prodigal "https://github.com/nf-core/metatdenovo/blob/master/modules/nf-core/prodigal/main.nf"
click node_bbmap "https://github.com/nf-core/metatdenovo/blob/master/modules/nf-core/bbmap/align/main.nf"
click node_featurecounts "https://github.com/nf-core/metatdenovo/blob/master/modules/nf-core/subread/featurecounts/main.nf"
click node_eggnog "https://github.com/nf-core/metatdenovo/blob/master/subworkflows/local/eggnog/main.nf"
click node_kofamscan "https://github.com/nf-core/metatdenovo/blob/master/subworkflows/local/kofamscan/main.nf"
click node_hmm "https://github.com/nf-core/metatdenovo/blob/master/subworkflows/local/hmmclassify/main.nf"
click node_eukulele "https://github.com/nf-core/metatdenovo/blob/master/subworkflows/local/eukulele/main.nf"
click node_diamond "https://github.com/nf-core/metatdenovo/blob/master/modules/nf-core/diamond/blastp/main.nf"
click node_summary "https://github.com/nf-core/metatdenovo/blob/master/modules/local/merge/summary/main.nf"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_entrypoint,node_workflow,node_user toneBlue
class node_fastqc,node_multiqc,node_trim,node_bbduk,node_bbnorm,node_merge toneAmber
class node_megahit,node_spades,node_transdecoder,node_prodigal,node_bbmap,node_featurecounts toneMint
class node_prokka,node_eggnog,node_kofamscan,node_hmm,node_eukulele,node_diamond toneRose
class node_summary,node_results toneIndigo
```

## Components

### Pipeline entry

- [Nextflow entry](https://github.com/nf-core/metatdenovo/blob/master/main.nf): `main.nf`
- [Metatdenovo workflow](https://github.com/nf-core/metatdenovo/blob/master/workflows/metatdenovo.nf): `workflows/metatdenovo.nf`

### Read preparation

- [Read QC](https://github.com/nf-core/metatdenovo/blob/master/modules/nf-core/fastqc/main.nf): `modules/nf-core/fastqc/main.nf`
- [QC report](https://github.com/nf-core/metatdenovo/blob/master/modules/nf-core/multiqc/main.nf): `modules/nf-core/multiqc/main.nf`
- [Trim reads](https://github.com/nf-core/metatdenovo/blob/master/modules/nf-core/trimgalore/main.nf): `modules/nf-core/trimgalore/main.nf`
- [Filter reads](https://github.com/nf-core/metatdenovo/blob/master/modules/nf-core/bbmap/bbduk/main.nf): `modules/nf-core/bbmap/bbduk/main.nf`
- [Normalize reads](https://github.com/nf-core/metatdenovo/blob/master/modules/nf-core/bbmap/bbnorm/main.nf): `modules/nf-core/bbmap/bbnorm/main.nf`
- [Merge paired reads](https://github.com/nf-core/metatdenovo/blob/master/modules/nf-core/seqtk/mergepe/main.nf): `modules/nf-core/seqtk/mergepe/main.nf`

### Assembly and quantification

- [MEGAHIT assembly](https://github.com/nf-core/metatdenovo/blob/master/modules/local/megahit/interleaved/main.nf): `modules/local/megahit/interleaved/main.nf`
- [SPAdes assembly](https://github.com/nf-core/metatdenovo/blob/master/modules/nf-core/spades/main.nf): `modules/nf-core/spades/main.nf`
- [TransDecoder ORFs](https://github.com/nf-core/metatdenovo/blob/master/modules/local/transdecoder/main.nf): `modules/local/transdecoder/main.nf`
- [Prodigal ORFs](https://github.com/nf-core/metatdenovo/blob/master/modules/nf-core/prodigal/main.nf): `modules/nf-core/prodigal/main.nf`
- [Read mapping](https://github.com/nf-core/metatdenovo/blob/master/modules/nf-core/bbmap/align/main.nf): `modules/nf-core/bbmap/align/main.nf`
- [Gene counts](https://github.com/nf-core/metatdenovo/blob/master/modules/nf-core/subread/featurecounts/main.nf): `modules/nf-core/subread/featurecounts/main.nf`

### Annotation

- [Prokka annotation](https://github.com/nf-core/metatdenovo/blob/master/modules/nf-core/prokka/main.nf): `modules/nf-core/prokka/main.nf`
- [eggNOG annotation](https://github.com/nf-core/metatdenovo/blob/master/subworkflows/local/eggnog/main.nf): `subworkflows/local/eggnog/main.nf`
- [KofamScan annotation](https://github.com/nf-core/metatdenovo/blob/master/subworkflows/local/kofamscan/main.nf): `subworkflows/local/kofamscan/main.nf`
- [HMM search and ranking](https://github.com/nf-core/metatdenovo/blob/master/subworkflows/local/hmmclassify/main.nf): `subworkflows/local/hmmclassify/main.nf`
- [EUKulele taxonomy](https://github.com/nf-core/metatdenovo/blob/master/subworkflows/local/eukulele/main.nf): `subworkflows/local/eukulele/main.nf`
- [DIAMOND taxonomy](https://github.com/nf-core/metatdenovo/blob/master/modules/nf-core/diamond/blastp/main.nf): `modules/nf-core/diamond/blastp/main.nf`

### Reporting

- [Summary statistics](https://github.com/nf-core/metatdenovo/blob/master/modules/local/merge/summary/main.nf): `modules/local/merge/summary/main.nf`
- **Pipeline results**

### Other components

- **Pipeline user**

## Connections

- Pipeline user → Nextflow entry: runs (evidence: `README.md`)
- Nextflow entry → Metatdenovo workflow: launches
- Metatdenovo workflow → Read QC: performs QC (evidence: `README.md`)
- Metatdenovo workflow → QC report: reports QC (evidence: `README.md`)
- Metatdenovo workflow → Trim reads: trims reads (evidence: `README.md`)
- Metatdenovo workflow → Filter reads: optionally filters (evidence: `README.md`)
- Metatdenovo workflow → Normalize reads: optionally normalizes (evidence: `README.md`)
- Metatdenovo workflow → Merge paired reads: merges reads (evidence: `README.md`)
- Metatdenovo workflow → MEGAHIT assembly: assembles with (evidence: `README.md`)
- Metatdenovo workflow → SPAdes assembly: assembles with (evidence: `README.md`)
- Metatdenovo workflow → TransDecoder ORFs: calls ORFs with (evidence: `README.md`)
- Metatdenovo workflow → Prokka annotation: annotates with (evidence: `README.md`)
- Metatdenovo workflow → Prodigal ORFs: calls ORFs with (evidence: `README.md`)
- Metatdenovo workflow → Read mapping: maps reads (evidence: `README.md`)
- Metatdenovo workflow → Gene counts: quantifies genes (evidence: `README.md`)
- Metatdenovo workflow → eggNOG annotation: annotates with (evidence: `README.md`)
- Metatdenovo workflow → KofamScan annotation: annotates with (evidence: `README.md`)
- Metatdenovo workflow → HMM search and ranking: searches and ranks (evidence: `README.md`)
- Metatdenovo workflow → EUKulele taxonomy: classifies taxonomy (evidence: `README.md`)
- Metatdenovo workflow → DIAMOND taxonomy: classifies taxonomy (evidence: `README.md`)
- Metatdenovo workflow → Summary statistics: summarizes results (evidence: `README.md`)
- Metatdenovo workflow → Pipeline results: produces (evidence: `README.md`)
