# blerislab/dnacodec architecture

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

- Interactive diagram: https://gitdiagram.com/blerislab/dnacodec
- Repository: https://github.com/blerislab/dnacodec

## Overview

DNA CODEC is a research workflow for encoding text as obfuscated DNA payloads, analyzing sequencing reads, and assessing fidelity and sampling through figure-generation scripts. The principal documented path runs from text encoding and sequence quality checks through sequencing analysis and consensus; subsampling and passage analyses support evaluation. The README also describes genomic integration as a platform capability, but this repository tree exposes no implementation for it. Relationships below are limited to README-documented workflow; notebook internals were not sampled.

Main entry points: [`Python/DNA_Encode_Obfuscate_V2.ipynb`](https://github.com/blerislab/dnacodec/blob/main/Python/DNA_Encode_Obfuscate_V2.ipynb) (Extended encoding), [`Python/DNA_sequencing_analyze_Illumina.ipynb`](https://github.com/blerislab/dnacodec/blob/main/Python/DNA_sequencing_analyze_Illumina.ipynb) (Illumina analysis), [`Python/DNA_Encode_Obfuscate_V1.ipynb`](https://github.com/blerislab/dnacodec/blob/main/Python/DNA_Encode_Obfuscate_V1.ipynb) (Mask sequences), [`Python/DNA_sequencing_analyze_Nanopore.ipynb`](https://github.com/blerislab/dnacodec/blob/main/Python/DNA_sequencing_analyze_Nanopore.ipynb) (Nanopore alignment)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_encoding["Encoding and obfuscation"]
  node_encode_v1["10-ary encoding"]
  node_encode_v2["Extended encoding"]
  node_obfuscate["Mask sequences"]
  node_shuffle["Position shuffling"]
  node_sequence_qc["Sequence QC"]
end

subgraph group_sequencing["Sequencing analysis"]
  node_illumina["Illumina analysis"]
  node_illumina_consensus["Illumina consensus"]
  node_signature_class["Signature classification"]
  node_nanopore_alignment["Nanopore alignment"]
  node_amplicons["Reference amplicons"]
  node_nanopore_consensus["Nanopore consensus"]
end

subgraph group_sampling["Subsampling"]
  node_subsample["Read subsampling"]
end

subgraph group_figures["Passage and error figures"]
  node_fig5b["Passage ratios<br/>[ratiop1p10.m]"]
  node_fig5c["Passage errors<br/>[errorplots.m]"]
  node_fig5d["Short subsampling"]
  node_fig6d["Extended ratios"]
  node_fig6e["Extended errors"]
  node_figs23["Extended subsampling"]
end

node_text_user(("Text input"))
node_illumina_reads(("Illumina reads"))
node_nanopore_reads(("Nanopore reads"))
node_subsample_user(("Analysis results"))

node_text_user -->|"encodes text"| node_encode_v1
node_text_user -->|"encodes text"| node_encode_v2
node_encode_v1 -->|"generates masks"| node_obfuscate
node_encode_v2 -->|"generates masks"| node_obfuscate
node_encode_v2 -->|"shuffles positions"| node_shuffle
node_obfuscate -->|"checks quality"| node_sequence_qc
node_shuffle -->|"checks quality"| node_sequence_qc
node_illumina_reads -->|"provides reads"| node_illumina
node_illumina -->|"builds consensus"| node_illumina_consensus
node_illumina -->|"classifies payloads"| node_signature_class
node_nanopore_reads -->|"provides reads"| node_nanopore_alignment
node_amplicons -->|"aligns against"| node_nanopore_alignment
node_nanopore_alignment -->|"builds consensus"| node_nanopore_consensus
node_subsample_user -->|"provides results"| node_subsample

click node_encode_v1 "https://github.com/blerislab/dnacodec/blob/main/Python/DNA_Encode_Obfuscate_V1.ipynb"
click node_encode_v2 "https://github.com/blerislab/dnacodec/blob/main/Python/DNA_Encode_Obfuscate_V2.ipynb"
click node_obfuscate "https://github.com/blerislab/dnacodec/blob/main/Python/DNA_Encode_Obfuscate_V1.ipynb"
click node_shuffle "https://github.com/blerislab/dnacodec/blob/main/Python/DNA_Encode_Obfuscate_V2.ipynb"
click node_sequence_qc "https://github.com/blerislab/dnacodec/blob/main/Python/DNA_Encode_Obfuscate_V1.ipynb"
click node_illumina "https://github.com/blerislab/dnacodec/blob/main/Python/DNA_sequencing_analyze_Illumina.ipynb"
click node_illumina_consensus "https://github.com/blerislab/dnacodec/blob/main/Python/DNA_sequencing_analyze_Illumina.ipynb"
click node_signature_class "https://github.com/blerislab/dnacodec/blob/main/Python/DNA_sequencing_analyze_Illumina.ipynb"
click node_nanopore_alignment "https://github.com/blerislab/dnacodec/blob/main/Python/DNA_sequencing_analyze_Nanopore.ipynb"
click node_amplicons "https://github.com/blerislab/dnacodec/tree/main/Python/Reference_amplicons"
click node_nanopore_consensus "https://github.com/blerislab/dnacodec/blob/main/Python/DNA_sequencing_analyze_Nanopore.ipynb"
click node_subsample "https://github.com/blerislab/dnacodec/blob/main/Python/Subsampling_From_Sequencing_Results.ipynb"
click node_fig5b "https://github.com/blerislab/dnacodec/blob/main/MATLAB/Fig5B_passagesratio/ratiop1p10.m"
click node_fig5c "https://github.com/blerislab/dnacodec/blob/main/MATLAB/Fig5C_passageserror/errorplots.m"
click node_fig5d "https://github.com/blerislab/dnacodec/blob/main/MATLAB/Fig5D_subsampling/5D_subsample_illumina.m"
click node_fig6d "https://github.com/blerislab/dnacodec/blob/main/MATLAB/Fig6D_passagesratio_extended/ratiop1p5_extended.m"
click node_fig6e "https://github.com/blerislab/dnacodec/blob/main/MATLAB/Fig6E_passageserror_extended/Errorplots_extended.m"
click node_figs23 "https://github.com/blerislab/dnacodec/blob/main/MATLAB/FigS23_subsampling/S23_subsample_illumina_extended.m"

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_encode_v1,node_encode_v2,node_obfuscate,node_shuffle,node_sequence_qc toneBlue
class node_illumina,node_illumina_consensus,node_signature_class,node_nanopore_alignment,node_amplicons,node_nanopore_consensus toneAmber
class node_subsample toneMint
class node_fig5b,node_fig5c,node_fig5d,node_fig6d,node_fig6e,node_figs23 toneRose
class node_text_user,node_illumina_reads,node_nanopore_reads,node_subsample_user toneIndigo
```

## Components

### Encoding and obfuscation

- [10-ary encoding](https://github.com/blerislab/dnacodec/blob/main/Python/DNA_Encode_Obfuscate_V1.ipynb): `Python/DNA_Encode_Obfuscate_V1.ipynb`
- [Extended encoding](https://github.com/blerislab/dnacodec/blob/main/Python/DNA_Encode_Obfuscate_V2.ipynb): `Python/DNA_Encode_Obfuscate_V2.ipynb`
- [Mask sequences](https://github.com/blerislab/dnacodec/blob/main/Python/DNA_Encode_Obfuscate_V1.ipynb): `Python/DNA_Encode_Obfuscate_V1.ipynb`
- [Position shuffling](https://github.com/blerislab/dnacodec/blob/main/Python/DNA_Encode_Obfuscate_V2.ipynb): `Python/DNA_Encode_Obfuscate_V2.ipynb`
- [Sequence QC](https://github.com/blerislab/dnacodec/blob/main/Python/DNA_Encode_Obfuscate_V1.ipynb): `Python/DNA_Encode_Obfuscate_V1.ipynb`

### Sequencing analysis

- [Illumina analysis](https://github.com/blerislab/dnacodec/blob/main/Python/DNA_sequencing_analyze_Illumina.ipynb): `Python/DNA_sequencing_analyze_Illumina.ipynb`
- [Illumina consensus](https://github.com/blerislab/dnacodec/blob/main/Python/DNA_sequencing_analyze_Illumina.ipynb): `Python/DNA_sequencing_analyze_Illumina.ipynb`
- [Signature classification](https://github.com/blerislab/dnacodec/blob/main/Python/DNA_sequencing_analyze_Illumina.ipynb): `Python/DNA_sequencing_analyze_Illumina.ipynb`
- [Nanopore alignment](https://github.com/blerislab/dnacodec/blob/main/Python/DNA_sequencing_analyze_Nanopore.ipynb): `Python/DNA_sequencing_analyze_Nanopore.ipynb`
- [Reference amplicons](https://github.com/blerislab/dnacodec/tree/main/Python/Reference_amplicons): `Python/Reference_amplicons`
- [Nanopore consensus](https://github.com/blerislab/dnacodec/blob/main/Python/DNA_sequencing_analyze_Nanopore.ipynb): `Python/DNA_sequencing_analyze_Nanopore.ipynb`

### Subsampling

- [Read subsampling](https://github.com/blerislab/dnacodec/blob/main/Python/Subsampling_From_Sequencing_Results.ipynb): `Python/Subsampling_From_Sequencing_Results.ipynb`

### Passage and error figures

- [Passage ratios](https://github.com/blerislab/dnacodec/blob/main/MATLAB/Fig5B_passagesratio/ratiop1p10.m): `MATLAB/Fig5B_passagesratio/ratiop1p10.m`
- [Passage errors](https://github.com/blerislab/dnacodec/blob/main/MATLAB/Fig5C_passageserror/errorplots.m): `MATLAB/Fig5C_passageserror/errorplots.m`
- [Short subsampling](https://github.com/blerislab/dnacodec/blob/main/MATLAB/Fig5D_subsampling/5D_subsample_illumina.m): `MATLAB/Fig5D_subsampling/5D_subsample_illumina.m`
- [Extended ratios](https://github.com/blerislab/dnacodec/blob/main/MATLAB/Fig6D_passagesratio_extended/ratiop1p5_extended.m): `MATLAB/Fig6D_passagesratio_extended/ratiop1p5_extended.m`
- [Extended errors](https://github.com/blerislab/dnacodec/blob/main/MATLAB/Fig6E_passageserror_extended/Errorplots_extended.m): `MATLAB/Fig6E_passageserror_extended/Errorplots_extended.m`
- [Extended subsampling](https://github.com/blerislab/dnacodec/blob/main/MATLAB/FigS23_subsampling/S23_subsample_illumina_extended.m): `MATLAB/FigS23_subsampling/S23_subsample_illumina_extended.m`

### Other components

- **Text input**
- **Illumina reads**
- **Nanopore reads**
- **Analysis results**

## Connections

- Text input → 10-ary encoding: encodes text (evidence: `Readme.md`)
- Text input → Extended encoding: encodes text (evidence: `Readme.md`)
- 10-ary encoding → Mask sequences: generates masks (evidence: `Readme.md`)
- Extended encoding → Mask sequences: generates masks (evidence: `Readme.md`)
- Extended encoding → Position shuffling: shuffles positions (evidence: `Readme.md`)
- Mask sequences → Sequence QC: checks quality (evidence: `Readme.md`)
- Position shuffling → Sequence QC: checks quality (evidence: `Readme.md`)
- Illumina reads → Illumina analysis: provides reads (evidence: `Readme.md`)
- Illumina analysis → Illumina consensus: builds consensus (evidence: `Readme.md`)
- Illumina analysis → Signature classification: classifies payloads (evidence: `Readme.md`)
- Nanopore reads → Nanopore alignment: provides reads (evidence: `Readme.md`)
- Reference amplicons → Nanopore alignment: aligns against (evidence: `Readme.md`)
- Nanopore alignment → Nanopore consensus: builds consensus (evidence: `Readme.md`)
- Analysis results → Read subsampling: provides results (evidence: `Readme.md`)
