# imcbioinformatics/dadacore16s architecture

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

- Interactive diagram: https://gitdiagram.com/imcbioinformatics/dadacore16s
- Repository: https://github.com/imcbioinformatics/dadacore16s

## Overview

DADAcore16S is a Snakemake workflow for profiling microbial communities from paired-end amplicon reads. Users provide FASTQ files and a sample manifest; the workflow performs read cleanup and DADA2 denoising, assigns taxonomy through both DADA2 and VSEARCH, and produces merged annotations plus abundance, sequence, read-count, and QC outputs. The README documents the major stages and taxonomy priorities, but the workflow and rule source were not excerpted, so detailed dispatch links are limited to documented relationships.

Main entry points: [`Snakefile`](https://github.com/imcbioinformatics/dadacore16s/blob/main/Snakefile) (Snakemake workflow), [`utils/scripts/dada2/RDPtaxa.R`](https://github.com/imcbioinformatics/dadacore16s/blob/main/utils/scripts/dada2/RDPtaxa.R) (DADA2 taxonomy), [`utils/scripts/vsearch/vsearch.R`](https://github.com/imcbioinformatics/dadacore16s/blob/main/utils/scripts/vsearch/vsearch.R) (VSEARCH matching), [`utils/scripts/dada2/annotation_output_dada2.R`](https://github.com/imcbioinformatics/dadacore16s/blob/main/utils/scripts/dada2/annotation_output_dada2.R) (Taxonomy merge)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_inputs["Inputs and workflow"]
  node_fastq["Paired FASTQ"]
  node_sample_manifest["Sample manifest<br/>[samples.tsv]"]
  node_workflow["Snakemake workflow"]
end

subgraph group_processing["Read processing"]
  node_cutadapt["Primer trimming<br/>[qc_cutadapt.smk]"]
  node_dada_filter["DADA2 filtering<br/>[dada2_filter.R]"]
  node_error_model["Error learning<br/>[learnErrorRates.R]"]
  node_sample_inference["Sample inference<br/>[process_sample.R]"]
  node_chimera["Chimera removal<br/>[removeChimeras.R]"]
  node_asv_sequences["ASV sequences"]
end

subgraph group_taxonomy["Taxonomy assignment"]
  node_dada_taxonomy["DADA2 taxonomy<br/>[RDPtaxa.R]"]
  node_vsearch["VSEARCH matching<br/>[vsearch.R]"]
  node_taxonomy_merge["Taxonomy merge"]
  node_reference_databases[("Reference databases")]
end

subgraph group_results["Reports and outputs"]
  node_qc_report["QC report<br/>[qc_report.smk]"]
  node_read_counts["Read-count summary<br/>[readCount.smk]"]
  node_abundance_table["ASV abundance table<br/>[dada2.smk]"]
  node_taxonomy_tables["Taxonomy tables"]
  node_fasta_output["ASV FASTA"]
end

node_user(("Researcher"))

node_user -->|"provides reads"| node_fastq
node_user -->|"provides samples"| node_sample_manifest
node_fastq -->|"workflow input"| node_workflow
node_sample_manifest -->|"workflow input"| node_workflow
node_workflow -->|"trims reads"| node_cutadapt
node_cutadapt -->|"filtered reads"| node_dada_filter
node_dada_filter -->|"estimates errors"| node_error_model
node_error_model -->|"informs inference"| node_sample_inference
node_sample_inference -->|"inferred sequences"| node_chimera
node_chimera -->|"classifies ASVs"| node_dada_taxonomy
node_workflow -->|"assigns taxonomy"| node_vsearch
node_reference_databases -->|"taxonomy references"| node_dada_taxonomy
node_reference_databases -->|"matching references"| node_vsearch
node_dada_taxonomy -->|"classification results"| node_taxonomy_merge
node_vsearch -->|"matching results"| node_taxonomy_merge
node_taxonomy_merge -->|"writes annotations"| node_taxonomy_tables
node_workflow -->|"generates report"| node_qc_report
node_workflow -->|"summarizes reads"| node_read_counts
node_workflow -->|"produces abundance"| node_abundance_table
node_workflow -->|"generates sequences"| node_asv_sequences
node_asv_sequences -->|"writes FASTA"| node_fasta_output

click node_sample_manifest "https://github.com/imcbioinformatics/dadacore16s/blob/main/example_files/samples.tsv"
click node_workflow "https://github.com/imcbioinformatics/dadacore16s/blob/main/Snakefile"
click node_cutadapt "https://github.com/imcbioinformatics/dadacore16s/blob/main/utils/rules/qc_cutadapt.smk"
click node_dada_filter "https://github.com/imcbioinformatics/dadacore16s/blob/main/utils/scripts/dada2/dada2_filter.R"
click node_error_model "https://github.com/imcbioinformatics/dadacore16s/blob/main/utils/scripts/dada2/learnErrorRates.R"
click node_sample_inference "https://github.com/imcbioinformatics/dadacore16s/blob/main/utils/scripts/dada2/process_sample.R"
click node_chimera "https://github.com/imcbioinformatics/dadacore16s/blob/main/utils/scripts/dada2/removeChimeras.R"
click node_asv_sequences "https://github.com/imcbioinformatics/dadacore16s/blob/main/utils/rules/fasta_generation.smk"
click node_dada_taxonomy "https://github.com/imcbioinformatics/dadacore16s/blob/main/utils/scripts/dada2/RDPtaxa.R"
click node_vsearch "https://github.com/imcbioinformatics/dadacore16s/blob/main/utils/scripts/vsearch/vsearch.R"
click node_taxonomy_merge "https://github.com/imcbioinformatics/dadacore16s/blob/main/utils/scripts/dada2/annotation_output_dada2.R"
click node_reference_databases "https://github.com/imcbioinformatics/dadacore16s/tree/main/utils/databases"
click node_qc_report "https://github.com/imcbioinformatics/dadacore16s/blob/main/utils/rules/qc_report.smk"
click node_read_counts "https://github.com/imcbioinformatics/dadacore16s/blob/main/utils/rules/readCount.smk"
click node_abundance_table "https://github.com/imcbioinformatics/dadacore16s/blob/main/utils/rules/dada2.smk"
click node_taxonomy_tables "https://github.com/imcbioinformatics/dadacore16s/blob/main/utils/rules/annotation_output_dada2.smk"
click node_fasta_output "https://github.com/imcbioinformatics/dadacore16s/blob/main/utils/rules/fasta_generation.smk"

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_fastq,node_sample_manifest,node_workflow toneBlue
class node_cutadapt,node_dada_filter,node_error_model,node_sample_inference,node_chimera,node_asv_sequences toneAmber
class node_dada_taxonomy,node_vsearch,node_taxonomy_merge,node_reference_databases toneMint
class node_qc_report,node_read_counts,node_abundance_table,node_taxonomy_tables,node_fasta_output toneRose
class node_user toneIndigo
```

## Components

### Inputs and workflow

- **Paired FASTQ**
- [Sample manifest](https://github.com/imcbioinformatics/dadacore16s/blob/main/example_files/samples.tsv): `example_files/samples.tsv`
- [Snakemake workflow](https://github.com/imcbioinformatics/dadacore16s/blob/main/Snakefile): `Snakefile`

### Read processing

- [Primer trimming](https://github.com/imcbioinformatics/dadacore16s/blob/main/utils/rules/qc_cutadapt.smk): `utils/rules/qc_cutadapt.smk`
- [DADA2 filtering](https://github.com/imcbioinformatics/dadacore16s/blob/main/utils/scripts/dada2/dada2_filter.R): `utils/scripts/dada2/dada2_filter.R`
- [Error learning](https://github.com/imcbioinformatics/dadacore16s/blob/main/utils/scripts/dada2/learnErrorRates.R): `utils/scripts/dada2/learnErrorRates.R`
- [Sample inference](https://github.com/imcbioinformatics/dadacore16s/blob/main/utils/scripts/dada2/process_sample.R): `utils/scripts/dada2/process_sample.R`
- [Chimera removal](https://github.com/imcbioinformatics/dadacore16s/blob/main/utils/scripts/dada2/removeChimeras.R): `utils/scripts/dada2/removeChimeras.R`
- [ASV sequences](https://github.com/imcbioinformatics/dadacore16s/blob/main/utils/rules/fasta_generation.smk): `utils/rules/fasta_generation.smk`

### Taxonomy assignment

- [DADA2 taxonomy](https://github.com/imcbioinformatics/dadacore16s/blob/main/utils/scripts/dada2/RDPtaxa.R): `utils/scripts/dada2/RDPtaxa.R`
- [VSEARCH matching](https://github.com/imcbioinformatics/dadacore16s/blob/main/utils/scripts/vsearch/vsearch.R): `utils/scripts/vsearch/vsearch.R`
- [Taxonomy merge](https://github.com/imcbioinformatics/dadacore16s/blob/main/utils/scripts/dada2/annotation_output_dada2.R): `utils/scripts/dada2/annotation_output_dada2.R`
- [Reference databases](https://github.com/imcbioinformatics/dadacore16s/tree/main/utils/databases): `utils/databases`

### Reports and outputs

- [QC report](https://github.com/imcbioinformatics/dadacore16s/blob/main/utils/rules/qc_report.smk): `utils/rules/qc_report.smk`
- [Read-count summary](https://github.com/imcbioinformatics/dadacore16s/blob/main/utils/rules/readCount.smk): `utils/rules/readCount.smk`
- [ASV abundance table](https://github.com/imcbioinformatics/dadacore16s/blob/main/utils/rules/dada2.smk): `utils/rules/dada2.smk`
- [Taxonomy tables](https://github.com/imcbioinformatics/dadacore16s/blob/main/utils/rules/annotation_output_dada2.smk): `utils/rules/annotation_output_dada2.smk`
- [ASV FASTA](https://github.com/imcbioinformatics/dadacore16s/blob/main/utils/rules/fasta_generation.smk): `utils/rules/fasta_generation.smk`

### Other components

- **Researcher**

## Connections

- Researcher → Paired FASTQ: provides reads (evidence: `README.md`)
- Researcher → Sample manifest: provides samples (evidence: `README.md`)
- Paired FASTQ → Snakemake workflow: workflow input (evidence: `README.md`)
- Sample manifest → Snakemake workflow: workflow input (evidence: `README.md`)
- Snakemake workflow → Primer trimming: trims reads (evidence: `README.md`)
- Primer trimming → DADA2 filtering: filtered reads (evidence: `README.md`)
- DADA2 filtering → Error learning: estimates errors (evidence: `README.md`)
- Error learning → Sample inference: informs inference (evidence: `README.md`)
- Sample inference → Chimera removal: inferred sequences (evidence: `README.md`)
- Chimera removal → DADA2 taxonomy: classifies ASVs (evidence: `README.md`)
- Snakemake workflow → VSEARCH matching: assigns taxonomy (evidence: `README.md`)
- Reference databases → DADA2 taxonomy: taxonomy references (evidence: `README.md`)
- Reference databases → VSEARCH matching: matching references (evidence: `README.md`)
- DADA2 taxonomy → Taxonomy merge: classification results (evidence: `README.md`)
- VSEARCH matching → Taxonomy merge: matching results (evidence: `README.md`)
- Taxonomy merge → Taxonomy tables: writes annotations (evidence: `README.md`)
- Snakemake workflow → QC report: generates report (evidence: `README.md`)
- Snakemake workflow → Read-count summary: summarizes reads (evidence: `README.md`)
- Snakemake workflow → ASV abundance table: produces abundance (evidence: `README.md`)
- Snakemake workflow → ASV sequences: generates sequences (evidence: `README.md`)
- ASV sequences → ASV FASTA: writes FASTA (evidence: `README.md`)
