# jmakings/mixcr-pipeline architecture

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

- Interactive diagram: https://gitdiagram.com/jmakings/mixcr-pipeline
- Repository: https://github.com/jmakings/mixcr-pipeline

## Overview

MiXCR-Pipeline processes paired-end bulk RNA-seq FASTQs to derive TCR clonotypes. The documented legacy workflow concatenates lane reads, runs MiXCR, and extracts additional information from clone files; a separate postanalysis script is documented but currently unused because of MiXCR bugs. The README also identifies a newer Nextflow pipeline, but provides no details of its internal stages, so it is shown separately. No source excerpts were supplied; relationships below are limited to those documented in the README.

Main entry points: [`original_scripts/mixcr_analyze_concat.sh`](https://github.com/jmakings/mixcr-pipeline/blob/main/original_scripts/mixcr_analyze_concat.sh) (MiXCR analysis), [`original_scripts/concat_split_lanes.sh`](https://github.com/jmakings/mixcr-pipeline/blob/main/original_scripts/concat_split_lanes.sh) (Lane concatenation), [`original_scripts/extract_from_clones.sh`](https://github.com/jmakings/mixcr-pipeline/blob/main/original_scripts/extract_from_clones.sh) (Clone information extraction)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_prep["Read preparation"]
  node_concat["Lane concatenation"]
end

subgraph group_analysis["Clonotype analysis"]
  node_mixcr_run["MiXCR analysis"]
  node_clonotypes["Clonotype TSVs"]
  node_clone_extract["Clone information extraction"]
  node_clone_data["CDR3 and V/D/J data"]
  node_postanalysis["Diversity postanalysis"]
end

subgraph group_workflow["Pipeline versions"]
  node_nextflow["Nextflow pipeline<br/>[main.nf]"]
end

node_user(("Pipeline user"))
node_fastqs["Paired-end FASTQs"]

node_user -->|"provides"| node_fastqs
node_fastqs -->|"concatenates lanes"| node_concat
node_concat -->|"feeds merged reads"| node_mixcr_run
node_mixcr_run -->|"exports clonotypes"| node_clonotypes
node_mixcr_run -->|"provides clone files"| node_clone_extract
node_clone_extract -->|"extracts sequences"| node_clone_data

click node_concat "https://github.com/jmakings/mixcr-pipeline/blob/main/original_scripts/concat_split_lanes.sh"
click node_mixcr_run "https://github.com/jmakings/mixcr-pipeline/blob/main/original_scripts/mixcr_analyze_concat.sh"
click node_clone_extract "https://github.com/jmakings/mixcr-pipeline/blob/main/original_scripts/extract_from_clones.sh"
click node_postanalysis "https://github.com/jmakings/mixcr-pipeline/blob/main/original_scripts/mixcr_postanalysis.sh"
click node_nextflow "https://github.com/jmakings/mixcr-pipeline/blob/main/upgraded_nextflow/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_concat,node_user toneBlue
class node_mixcr_run,node_clonotypes,node_clone_extract,node_clone_data,node_postanalysis toneAmber
class node_nextflow toneMint
class node_fastqs toneIndigo
```

## Components

### Read preparation

- [Lane concatenation](https://github.com/jmakings/mixcr-pipeline/blob/main/original_scripts/concat_split_lanes.sh): `original_scripts/concat_split_lanes.sh`

### Clonotype analysis

- [MiXCR analysis](https://github.com/jmakings/mixcr-pipeline/blob/main/original_scripts/mixcr_analyze_concat.sh): `original_scripts/mixcr_analyze_concat.sh`
- **Clonotype TSVs**
- [Clone information extraction](https://github.com/jmakings/mixcr-pipeline/blob/main/original_scripts/extract_from_clones.sh): `original_scripts/extract_from_clones.sh`
- **CDR3 and V/D/J data**
- [Diversity postanalysis](https://github.com/jmakings/mixcr-pipeline/blob/main/original_scripts/mixcr_postanalysis.sh): `original_scripts/mixcr_postanalysis.sh`

### Pipeline versions

- [Nextflow pipeline](https://github.com/jmakings/mixcr-pipeline/blob/main/upgraded_nextflow/main.nf): `upgraded_nextflow/main.nf`

### Other components

- **Pipeline user**
- **Paired-end FASTQs**

## Connections

- Pipeline user → Paired-end FASTQs: provides (evidence: `README.md`)
- Paired-end FASTQs → Lane concatenation: concatenates lanes (evidence: `README.md`)
- Lane concatenation → MiXCR analysis: feeds merged reads (evidence: `README.md`)
- MiXCR analysis → Clonotype TSVs: exports clonotypes (evidence: `README.md`)
- MiXCR analysis → Clone information extraction: provides clone files (evidence: `README.md`)
- Clone information extraction → CDR3 and V/D/J data: extracts sequences (evidence: `README.md`)
