# marionilab/celloseq architecture

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

## Overview

CELLO-seq Sarlacc processes sequencing data; the manuscript directory holds downstream analysis scripts. The tree shows distinct processing and analysis capabilities, but the available source excerpts do not establish a runtime call sequence between pipeline stages. Accordingly, the graph preserves these stages without inventing their ordering or data handoffs. The adapter module is a substantial pipeline source file, while the two sampled Python scripts implement repeat-analysis tasks.

Main entry points: [`pipeline`](https://github.com/marionilab/celloseq/tree/master/pipeline) (Sarlacc pipeline), [`manuscript`](https://github.com/marionilab/celloseq/tree/master/manuscript) (Manuscript analyses)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_processing["Sequencing processing"]
  node_pipeline["Sarlacc pipeline"]
  node_demultiplex["Demultiplexing<br/>[demultiplex.Rmd]"]
  node_dispatch["Stage dispatchers"]
  node_errorcorrect["Error correction<br/>[errorcorrect.Rmd]"]
  node_grouping["Read grouping<br/>[grouping.Rmd]"]
  node_tuning["Pipeline tuning<br/>[tuning.Rmd]"]
end

subgraph group_readprep["Read preparation"]
  node_adapters["Adapter definitions<br/>[adapters.py]"]
  node_adapterfilter["Adapter filtering"]
  node_adapterqc["Adapter QC"]
  node_readlength["Read-length filtering"]
  node_splitreads["Read splitting<br/>[split_reads.sh]"]
end

subgraph group_alignment["Alignment and counting"]
  node_align["Read alignment"]
  node_dedup["Deduplication<br/>[deduplicate.rmd]"]
end

subgraph group_analysis["Manuscript analysis"]
  node_manuscript["Manuscript analyses"]
  node_repeatclass["Repeat isoform classification"]
  node_teage["TE age calculation"]
  node_singlecell["Single-cell analyses"]
  node_allelic["Allelic analysis"]
  node_longread["Long-read analysis<br/>[SCE_long_read.Rmd]"]
  node_repeatanalysis["Repeat analyses<br/>[SCE_repeats.Rmd]"]
  node_qc["CELLO-seq QC<br/>[Celloseq_QC.Rmd]"]
end

node_researcher(("Researcher"))

node_researcher -->|"processes sequencing data"| node_pipeline
node_researcher -->|"analyzes data"| node_manuscript

click node_pipeline "https://github.com/marionilab/celloseq/tree/master/pipeline"
click node_demultiplex "https://github.com/marionilab/celloseq/blob/master/pipeline/demultiplex.Rmd"
click node_dispatch "https://github.com/marionilab/celloseq/tree/master/pipeline"
click node_errorcorrect "https://github.com/marionilab/celloseq/blob/master/pipeline/errorcorrect.Rmd"
click node_grouping "https://github.com/marionilab/celloseq/blob/master/pipeline/grouping.Rmd"
click node_tuning "https://github.com/marionilab/celloseq/blob/master/pipeline/tuning.Rmd"
click node_adapters "https://github.com/marionilab/celloseq/blob/master/pipeline/adapters.py"
click node_adapterfilter "https://github.com/marionilab/celloseq/blob/master/pipeline/internal_adaptor_filter.Rmd"
click node_adapterqc "https://github.com/marionilab/celloseq/blob/master/pipeline/internal_adaptor_QC.Rmd"
click node_readlength "https://github.com/marionilab/celloseq/blob/master/pipeline/filter_read_lengths.sh"
click node_splitreads "https://github.com/marionilab/celloseq/blob/master/pipeline/split_reads.sh"
click node_align "https://github.com/marionilab/celloseq/blob/master/pipeline/align_reads_minimap.sh"
click node_dedup "https://github.com/marionilab/celloseq/blob/master/pipeline/deduplicate.rmd"
click node_manuscript "https://github.com/marionilab/celloseq/tree/master/manuscript"
click node_repeatclass "https://github.com/marionilab/celloseq/blob/master/manuscript/python_files/classify_repeat_isoform_exact.py"
click node_teage "https://github.com/marionilab/celloseq/blob/master/manuscript/python_files/calculate_TE_JCage.py"
click node_singlecell "https://github.com/marionilab/celloseq/tree/master/manuscript/Rmd_files"
click node_allelic "https://github.com/marionilab/celloseq/tree/master/manuscript/bash_files/allelic"
click node_longread "https://github.com/marionilab/celloseq/blob/master/manuscript/Rmd_files/SCE_long_read.Rmd"
click node_repeatanalysis "https://github.com/marionilab/celloseq/blob/master/manuscript/Rmd_files/SCE_repeats.Rmd"
click node_qc "https://github.com/marionilab/celloseq/blob/master/manuscript/Rmd_files/Celloseq_QC.Rmd"

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_pipeline,node_demultiplex,node_dispatch,node_errorcorrect,node_grouping,node_tuning toneBlue
class node_adapters,node_adapterfilter,node_adapterqc,node_readlength,node_splitreads toneAmber
class node_align,node_dedup toneMint
class node_manuscript,node_repeatclass,node_teage,node_singlecell,node_allelic,node_longread,node_repeatanalysis,node_qc toneRose
class node_researcher toneIndigo
```

## Components

### Sequencing processing

- [Sarlacc pipeline](https://github.com/marionilab/celloseq/tree/master/pipeline): `pipeline`
- [Demultiplexing](https://github.com/marionilab/celloseq/blob/master/pipeline/demultiplex.Rmd): `pipeline/demultiplex.Rmd`
- [Stage dispatchers](https://github.com/marionilab/celloseq/tree/master/pipeline): `pipeline`
- [Error correction](https://github.com/marionilab/celloseq/blob/master/pipeline/errorcorrect.Rmd): `pipeline/errorcorrect.Rmd`
- [Read grouping](https://github.com/marionilab/celloseq/blob/master/pipeline/grouping.Rmd): `pipeline/grouping.Rmd`
- [Pipeline tuning](https://github.com/marionilab/celloseq/blob/master/pipeline/tuning.Rmd): `pipeline/tuning.Rmd`

### Read preparation

- [Adapter definitions](https://github.com/marionilab/celloseq/blob/master/pipeline/adapters.py): `pipeline/adapters.py`
- [Adapter filtering](https://github.com/marionilab/celloseq/blob/master/pipeline/internal_adaptor_filter.Rmd): `pipeline/internal_adaptor_filter.Rmd`
- [Adapter QC](https://github.com/marionilab/celloseq/blob/master/pipeline/internal_adaptor_QC.Rmd): `pipeline/internal_adaptor_QC.Rmd`
- [Read-length filtering](https://github.com/marionilab/celloseq/blob/master/pipeline/filter_read_lengths.sh): `pipeline/filter_read_lengths.sh`
- [Read splitting](https://github.com/marionilab/celloseq/blob/master/pipeline/split_reads.sh): `pipeline/split_reads.sh`

### Alignment and counting

- [Read alignment](https://github.com/marionilab/celloseq/blob/master/pipeline/align_reads_minimap.sh): `pipeline/align_reads_minimap.sh`
- [Deduplication](https://github.com/marionilab/celloseq/blob/master/pipeline/deduplicate.rmd): `pipeline/deduplicate.rmd`

### Manuscript analysis

- [Manuscript analyses](https://github.com/marionilab/celloseq/tree/master/manuscript): `manuscript`
- [Repeat isoform classification](https://github.com/marionilab/celloseq/blob/master/manuscript/python_files/classify_repeat_isoform_exact.py): `manuscript/python_files/classify_repeat_isoform_exact.py`
- [TE age calculation](https://github.com/marionilab/celloseq/blob/master/manuscript/python_files/calculate_TE_JCage.py): `manuscript/python_files/calculate_TE_JCage.py`
- [Single-cell analyses](https://github.com/marionilab/celloseq/tree/master/manuscript/Rmd_files): `manuscript/Rmd_files`
- [Allelic analysis](https://github.com/marionilab/celloseq/tree/master/manuscript/bash_files/allelic): `manuscript/bash_files/allelic`
- [Long-read analysis](https://github.com/marionilab/celloseq/blob/master/manuscript/Rmd_files/SCE_long_read.Rmd): `manuscript/Rmd_files/SCE_long_read.Rmd`
- [Repeat analyses](https://github.com/marionilab/celloseq/blob/master/manuscript/Rmd_files/SCE_repeats.Rmd): `manuscript/Rmd_files/SCE_repeats.Rmd`
- [CELLO-seq QC](https://github.com/marionilab/celloseq/blob/master/manuscript/Rmd_files/Celloseq_QC.Rmd): `manuscript/Rmd_files/Celloseq_QC.Rmd`

### Other components

- **Researcher**

## Connections

- Researcher → Sarlacc pipeline: processes sequencing data (evidence: `README.md`)
- Researcher → Manuscript analyses: analyzes data (evidence: `README.md`)
