# lindenb/gazoduc-nf architecture

> Architecture diagram of the GitHub repository lindenb/gazoduc-nf, 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/lindenb/gazoduc-nf
- Repository: https://github.com/lindenb/gazoduc-nf

## Overview

GAZODUC is a collection of DSL2 Nextflow bioinformatics pipelines, rather than one end-user application. Users run pipelines for tasks such as variant calling, annotation, burden analysis, and rare-disease workflows; reusable subworkflows and tool modules form an internal layer. The README describes Nextflow usage and profiles but not specific workflow-to-module wiring, so the graph avoids asserting those connections. Sampled utilities show additional processing for pedigrees, variant reports, burden analysis, track hubs, and rare-variant analysis.

Main entry points: [`workflows`](https://github.com/lindenb/gazoduc-nf/tree/master/workflows) (Workflow collection)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_workflow_families["Pipeline families"]
  node_workflows["Workflow collection"]
  node_calling["Variant calling"]
  node_annotation["Variant annotation"]
  node_burden["Burden analysis"]
  node_rare_disease["Rare disease"]
end

subgraph group_reusable_layers["Reusable layers"]
  node_subworkflows["Composable subworkflows"]
  node_modules["Tool modules"]
end

subgraph group_variant_utilities["Variant utilities"]
  node_gatk_helper["GATK genotyping<br/>[Minikit4.java]"]
  node_igv_report["IGV reporting<br/>[Minikit.java]"]
  node_trackhub["Track hub output<br/>[Minikit.java]"]
  node_dbsnp_merge["dbSNP merging<br/>[Minikit.java]"]
end

subgraph group_analysis_utilities["Analysis utilities"]
  node_pedigree["Pedigree conversion<br/>[ped.py]"]
  node_burden_helper["Burden grouping<br/>[Minikit.java]"]
  node_rare_variants["Rare variant setup<br/>[Minikit.java]"]
  node_ontology_descendants["Ontology descendants<br/>[Minikit.java]"]
end

node_user(("Pipeline user"))

node_user -->|"runs pipelines"| node_workflows

click node_workflows "https://github.com/lindenb/gazoduc-nf/tree/master/workflows"
click node_calling "https://github.com/lindenb/gazoduc-nf/tree/master/workflows/gatk"
click node_annotation "https://github.com/lindenb/gazoduc-nf/tree/master/workflows/annotation"
click node_burden "https://github.com/lindenb/gazoduc-nf/tree/master/workflows/burden"
click node_rare_disease "https://github.com/lindenb/gazoduc-nf/tree/master/workflows/rare-diseases"
click node_subworkflows "https://github.com/lindenb/gazoduc-nf/tree/master/subworkflows"
click node_modules "https://github.com/lindenb/gazoduc-nf/tree/master/modules"
click node_pedigree "https://github.com/lindenb/gazoduc-nf/blob/master/subworkflows/pedigree/meta2ped/ped.py"
click node_burden_helper "https://github.com/lindenb/gazoduc-nf/blob/master/workflows/burden/burden.2024/Minikit.java"
click node_gatk_helper "https://github.com/lindenb/gazoduc-nf/blob/master/workflows/gatk/gatk.hc.minikit/Minikit4.java"
click node_igv_report "https://github.com/lindenb/gazoduc-nf/blob/master/workflows/igvreports/Minikit.java"
click node_trackhub "https://github.com/lindenb/gazoduc-nf/blob/master/workflows/trackhub/Minikit.java"
click node_rare_variants "https://github.com/lindenb/gazoduc-nf/blob/master/workflows/ultrarares.vm/Minikit.java"
click node_dbsnp_merge "https://github.com/lindenb/gazoduc-nf/blob/master/workflows/xenodbsnp/Minikit.java"
click node_ontology_descendants "https://github.com/lindenb/gazoduc-nf/blob/master/modules/jena/descendants/Minikit.java"

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_workflows,node_calling,node_annotation,node_burden,node_rare_disease,node_user toneBlue
class node_subworkflows,node_modules toneAmber
class node_gatk_helper,node_igv_report,node_trackhub,node_dbsnp_merge toneMint
class node_pedigree,node_burden_helper,node_rare_variants,node_ontology_descendants toneRose
```

## Components

### Pipeline families

- [Workflow collection](https://github.com/lindenb/gazoduc-nf/tree/master/workflows): `workflows`
- [Variant calling](https://github.com/lindenb/gazoduc-nf/tree/master/workflows/gatk): `workflows/gatk`
- [Variant annotation](https://github.com/lindenb/gazoduc-nf/tree/master/workflows/annotation): `workflows/annotation`
- [Burden analysis](https://github.com/lindenb/gazoduc-nf/tree/master/workflows/burden): `workflows/burden`
- [Rare disease](https://github.com/lindenb/gazoduc-nf/tree/master/workflows/rare-diseases): `workflows/rare-diseases`

### Reusable layers

- [Composable subworkflows](https://github.com/lindenb/gazoduc-nf/tree/master/subworkflows): `subworkflows`
- [Tool modules](https://github.com/lindenb/gazoduc-nf/tree/master/modules): `modules`

### Variant utilities

- [GATK genotyping](https://github.com/lindenb/gazoduc-nf/blob/master/workflows/gatk/gatk.hc.minikit/Minikit4.java): `workflows/gatk/gatk.hc.minikit/Minikit4.java`
- [IGV reporting](https://github.com/lindenb/gazoduc-nf/blob/master/workflows/igvreports/Minikit.java): `workflows/igvreports/Minikit.java`
- [Track hub output](https://github.com/lindenb/gazoduc-nf/blob/master/workflows/trackhub/Minikit.java): `workflows/trackhub/Minikit.java`
- [dbSNP merging](https://github.com/lindenb/gazoduc-nf/blob/master/workflows/xenodbsnp/Minikit.java): `workflows/xenodbsnp/Minikit.java`

### Analysis utilities

- [Pedigree conversion](https://github.com/lindenb/gazoduc-nf/blob/master/subworkflows/pedigree/meta2ped/ped.py): `subworkflows/pedigree/meta2ped/ped.py`
- [Burden grouping](https://github.com/lindenb/gazoduc-nf/blob/master/workflows/burden/burden.2024/Minikit.java): `workflows/burden/burden.2024/Minikit.java`
- [Rare variant setup](https://github.com/lindenb/gazoduc-nf/blob/master/workflows/ultrarares.vm/Minikit.java): `workflows/ultrarares.vm/Minikit.java`
- [Ontology descendants](https://github.com/lindenb/gazoduc-nf/blob/master/modules/jena/descendants/Minikit.java): `modules/jena/descendants/Minikit.java`

### Other components

- **Pipeline user**

## Connections

- Pipeline user → Workflow collection: runs pipelines (evidence: `README.md`)
