# srisarya/orca-seq-processing architecture

> Architecture diagram of the GitHub repository srisarya/orca-seq-processing, 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/srisarya/orca-seq-processing
- Repository: https://github.com/srisarya/orca-seq-processing

## Overview

This repository is a command-line bioinformatics workflow for processing COI and rRNA amplicon reads into cleaned gene sequences, with optional downstream sequence searching and phylogenetic preparation. The principal documented path reorients reads, demultiplexes them, clusters amplicons, removes primers, then extracts rRNA genes or organizes COI sequences. Additional scripts support anchor selection and barcode analyses. Edges reflect the README’s documented workflow and capabilities; source excerpts cover only two auxiliary extractors, so unsampled script-level connections are not inferred.

Main entry points: [`scripts/04_cleaning_primers.sh`](https://github.com/srisarya/orca-seq-processing/blob/main/scripts/04_cleaning_primers.sh) (Primer cleaning), [`scripts/01_pychopper.sh`](https://github.com/srisarya/orca-seq-processing/blob/main/scripts/01_pychopper.sh) (Read reorientation), [`scripts/02_cutadapt_loop.sh`](https://github.com/srisarya/orca-seq-processing/blob/main/scripts/02_cutadapt_loop.sh) (Demultiplex and trim), [`adapters_primers`](https://github.com/srisarya/orca-seq-processing/tree/main/adapters_primers) (Adapter sequences)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_processing["Read processing"]
  node_pychopper["Read reorientation<br/>[01_pychopper.sh]"]
  node_adapter_config["Adapter sequences"]
  node_cutadapt["Demultiplex and trim"]
  node_amplicon_sort["Size and cluster"]
  node_primer_clean["Primer cleaning"]
  node_primer_sequences["Primer sequences"]
end

subgraph group_genes["Gene recovery"]
  node_ribo_extract["rRNA extraction"]
  node_coi_reorganize["COI organization"]
  node_coi_extractor["COI read extractor"]
  node_ribo_extractor["rRNA read extractor"]
end

subgraph group_downstream["Sequence analysis"]
  node_blast["BLAST search<br/>[06_BLASTing.sh]"]
  node_anchors["Anchor retrieval"]
  node_platy_anchors["Platyhelminth anchors"]
  node_taxon_barcodes["Taxon barcode sorting"]
  node_anchor_prep["Anchor preparation"]
end

subgraph group_analysis["R analyses"]
  node_lca_analysis["BLAST LCA"]
  node_metadata["Metadata wrangling"]
  node_visualization["Amplicon visualization"]
  node_index_hopping["Index hopping analysis"]
  node_phylo_filter["Phylogenetic anchor filter"]
  node_barcode_summary["Barcode summary"]
end

node_raw_reads(("Raw reads"))
node_gene_sequences["Gene sequences"]

node_raw_reads -->|"reorients"| node_pychopper
node_adapter_config -->|"configures"| node_pychopper
node_pychopper -->|"passes reads"| node_cutadapt
node_adapter_config -->|"supplies indices"| node_cutadapt
node_cutadapt -->|"passes demultiplexed reads"| node_amplicon_sort
node_amplicon_sort -->|"clusters reads"| node_primer_clean
node_primer_sequences -->|"defines trimming"| node_primer_clean
node_primer_clean -->|"provides cleaned contigs"| node_ribo_extract
node_primer_clean -->|"provides cleaned COIs"| node_coi_reorganize
node_ribo_extract -->|"extracts rRNA"| node_gene_sequences
node_coi_reorganize -->|"organizes COIs"| node_gene_sequences
node_gene_sequences -->|"searches sequences"| node_blast
node_gene_sequences -->|"retrieves anchors"| node_anchors
node_gene_sequences -->|"retrieves anchors"| node_platy_anchors
node_gene_sequences -->|"reorganizes barcodes"| node_taxon_barcodes
node_gene_sequences -->|"prepares contigs"| node_anchor_prep
node_gene_sequences -->|"supports LCA analysis"| node_lca_analysis
node_gene_sequences -->|"supports analysis"| node_metadata
node_gene_sequences -->|"visualizes amplicons"| node_visualization
node_gene_sequences -->|"quantifies index hopping"| node_index_hopping
node_gene_sequences -->|"filters anchors"| node_phylo_filter
node_gene_sequences -->|"summarizes barcodes"| node_barcode_summary

click node_pychopper "https://github.com/srisarya/orca-seq-processing/blob/main/scripts/01_pychopper.sh"
click node_adapter_config "https://github.com/srisarya/orca-seq-processing/tree/main/adapters_primers"
click node_cutadapt "https://github.com/srisarya/orca-seq-processing/blob/main/scripts/02_cutadapt_loop.sh"
click node_amplicon_sort "https://github.com/srisarya/orca-seq-processing/blob/main/scripts/03_amplicon_sorter.sh"
click node_primer_clean "https://github.com/srisarya/orca-seq-processing/blob/main/scripts/04_cleaning_primers.sh"
click node_primer_sequences "https://github.com/srisarya/orca-seq-processing/blob/main/adapters_primers/amplicon_primer_sequences.fa"
click node_ribo_extract "https://github.com/srisarya/orca-seq-processing/blob/main/scripts/05a_barrnap_rRNA_extract.sh"
click node_coi_reorganize "https://github.com/srisarya/orca-seq-processing/blob/main/scripts/05b_reorganise_COIs.sh"
click node_blast "https://github.com/srisarya/orca-seq-processing/blob/main/scripts/06_BLASTing.sh"
click node_anchors "https://github.com/srisarya/orca-seq-processing/blob/main/scripts/07_fetch_anchors_all.sh"
click node_platy_anchors "https://github.com/srisarya/orca-seq-processing/blob/main/scripts/07_fetch_anchors_platyhelminthes_non-neodermata.sh"
click node_taxon_barcodes "https://github.com/srisarya/orca-seq-processing/blob/main/scripts/08_reorganise_barcodes_per_taxon.sh"
click node_anchor_prep "https://github.com/srisarya/orca-seq-processing/blob/main/scripts/09_prep_for_anchor_selection.sh"
click node_lca_analysis "https://github.com/srisarya/orca-seq-processing/blob/main/scripts/R_analysis/BLAST_LCA_amplicons.Rmd"
click node_metadata "https://github.com/srisarya/orca-seq-processing/blob/main/scripts/R_analysis/Metadata_wrangling.Rmd"
click node_visualization "https://github.com/srisarya/orca-seq-processing/blob/main/scripts/R_analysis/Amplicon_visualisation.Rmd"
click node_index_hopping "https://github.com/srisarya/orca-seq-processing/blob/main/scripts/R_analysis/index_hopping_quant.Rmd"
click node_phylo_filter "https://github.com/srisarya/orca-seq-processing/blob/main/scripts/R_analysis/phylo_anchor_filter.Rmd"
click node_barcode_summary "https://github.com/srisarya/orca-seq-processing/blob/main/scripts/R_analysis/barcode_summary_figS2.Rmd"
click node_coi_extractor "https://github.com/srisarya/orca-seq-processing/blob/main/scripts/auxiliary_code/CO1_splitter_maxread_extractor.py"
click node_ribo_extractor "https://github.com/srisarya/orca-seq-processing/blob/main/scripts/auxiliary_code/ribo_maxread_extractor.py"

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_pychopper,node_adapter_config,node_cutadapt,node_amplicon_sort,node_primer_clean,node_primer_sequences toneBlue
class node_ribo_extract,node_coi_reorganize,node_coi_extractor,node_ribo_extractor toneAmber
class node_blast,node_anchors,node_platy_anchors,node_taxon_barcodes,node_anchor_prep toneMint
class node_lca_analysis,node_metadata,node_visualization,node_index_hopping,node_phylo_filter,node_barcode_summary toneRose
class node_raw_reads,node_gene_sequences toneIndigo
```

## Components

### Read processing

- [Read reorientation](https://github.com/srisarya/orca-seq-processing/blob/main/scripts/01_pychopper.sh): `scripts/01_pychopper.sh`
- [Adapter sequences](https://github.com/srisarya/orca-seq-processing/tree/main/adapters_primers): `adapters_primers`
- [Demultiplex and trim](https://github.com/srisarya/orca-seq-processing/blob/main/scripts/02_cutadapt_loop.sh): `scripts/02_cutadapt_loop.sh`
- [Size and cluster](https://github.com/srisarya/orca-seq-processing/blob/main/scripts/03_amplicon_sorter.sh): `scripts/03_amplicon_sorter.sh`
- [Primer cleaning](https://github.com/srisarya/orca-seq-processing/blob/main/scripts/04_cleaning_primers.sh): `scripts/04_cleaning_primers.sh`
- [Primer sequences](https://github.com/srisarya/orca-seq-processing/blob/main/adapters_primers/amplicon_primer_sequences.fa): `adapters_primers/amplicon_primer_sequences.fa`

### Gene recovery

- [rRNA extraction](https://github.com/srisarya/orca-seq-processing/blob/main/scripts/05a_barrnap_rRNA_extract.sh): `scripts/05a_barrnap_rRNA_extract.sh`
- [COI organization](https://github.com/srisarya/orca-seq-processing/blob/main/scripts/05b_reorganise_COIs.sh): `scripts/05b_reorganise_COIs.sh`
- [COI read extractor](https://github.com/srisarya/orca-seq-processing/blob/main/scripts/auxiliary_code/CO1_splitter_maxread_extractor.py): `scripts/auxiliary_code/CO1_splitter_maxread_extractor.py`
- [rRNA read extractor](https://github.com/srisarya/orca-seq-processing/blob/main/scripts/auxiliary_code/ribo_maxread_extractor.py): `scripts/auxiliary_code/ribo_maxread_extractor.py`

### Sequence analysis

- [BLAST search](https://github.com/srisarya/orca-seq-processing/blob/main/scripts/06_BLASTing.sh): `scripts/06_BLASTing.sh`
- [Anchor retrieval](https://github.com/srisarya/orca-seq-processing/blob/main/scripts/07_fetch_anchors_all.sh): `scripts/07_fetch_anchors_all.sh`
- [Platyhelminth anchors](https://github.com/srisarya/orca-seq-processing/blob/main/scripts/07_fetch_anchors_platyhelminthes_non-neodermata.sh): `scripts/07_fetch_anchors_platyhelminthes_non-neodermata.sh`
- [Taxon barcode sorting](https://github.com/srisarya/orca-seq-processing/blob/main/scripts/08_reorganise_barcodes_per_taxon.sh): `scripts/08_reorganise_barcodes_per_taxon.sh`
- [Anchor preparation](https://github.com/srisarya/orca-seq-processing/blob/main/scripts/09_prep_for_anchor_selection.sh): `scripts/09_prep_for_anchor_selection.sh`

### R analyses

- [BLAST LCA](https://github.com/srisarya/orca-seq-processing/blob/main/scripts/R_analysis/BLAST_LCA_amplicons.Rmd): `scripts/R_analysis/BLAST_LCA_amplicons.Rmd`
- [Metadata wrangling](https://github.com/srisarya/orca-seq-processing/blob/main/scripts/R_analysis/Metadata_wrangling.Rmd): `scripts/R_analysis/Metadata_wrangling.Rmd`
- [Amplicon visualization](https://github.com/srisarya/orca-seq-processing/blob/main/scripts/R_analysis/Amplicon_visualisation.Rmd): `scripts/R_analysis/Amplicon_visualisation.Rmd`
- [Index hopping analysis](https://github.com/srisarya/orca-seq-processing/blob/main/scripts/R_analysis/index_hopping_quant.Rmd): `scripts/R_analysis/index_hopping_quant.Rmd`
- [Phylogenetic anchor filter](https://github.com/srisarya/orca-seq-processing/blob/main/scripts/R_analysis/phylo_anchor_filter.Rmd): `scripts/R_analysis/phylo_anchor_filter.Rmd`
- [Barcode summary](https://github.com/srisarya/orca-seq-processing/blob/main/scripts/R_analysis/barcode_summary_figS2.Rmd): `scripts/R_analysis/barcode_summary_figS2.Rmd`

### Other components

- **Raw reads**
- **Gene sequences**

## Connections

- Raw reads → Read reorientation: reorients (evidence: `README.md`)
- Adapter sequences → Read reorientation: configures (evidence: `README.md`)
- Read reorientation → Demultiplex and trim: passes reads (evidence: `README.md`)
- Adapter sequences → Demultiplex and trim: supplies indices (evidence: `README.md`)
- Demultiplex and trim → Size and cluster: passes demultiplexed reads (evidence: `README.md`)
- Size and cluster → Primer cleaning: clusters reads (evidence: `README.md`)
- Primer sequences → Primer cleaning: defines trimming (evidence: `README.md`)
- Primer cleaning → rRNA extraction: provides cleaned contigs (evidence: `README.md`)
- Primer cleaning → COI organization: provides cleaned COIs (evidence: `README.md`)
- rRNA extraction → Gene sequences: extracts rRNA (evidence: `README.md`)
- COI organization → Gene sequences: organizes COIs (evidence: `README.md`)
- Gene sequences → BLAST search: searches sequences (evidence: `README.md`)
- Gene sequences → Anchor retrieval: retrieves anchors (evidence: `README.md`)
- Gene sequences → Platyhelminth anchors: retrieves anchors (evidence: `README.md`)
- Gene sequences → Taxon barcode sorting: reorganizes barcodes (evidence: `README.md`)
- Gene sequences → Anchor preparation: prepares contigs (evidence: `README.md`)
- Gene sequences → BLAST LCA: supports LCA analysis (evidence: `README.md`)
- Gene sequences → Metadata wrangling: supports analysis (evidence: `README.md`)
- Gene sequences → Amplicon visualization: visualizes amplicons (evidence: `README.md`)
- Gene sequences → Index hopping analysis: quantifies index hopping (evidence: `README.md`)
- Gene sequences → Phylogenetic anchor filter: filters anchors (evidence: `README.md`)
- Gene sequences → Barcode summary: summarizes barcodes (evidence: `README.md`)
