# amiraynede/lb2-project-group-1 architecture

> Architecture diagram of the GitHub repository amiraynede/lb2-project-group-1, 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/amiraynede/lb2-project-group-1
- Repository: https://github.com/amiraynede/lb2-project-group-1

## Overview

This repository is a reproducible bioinformatics workflow for collecting eukaryotic protein sequences and evaluating signal-peptide classifiers. Its principal path runs from UniProtKB retrieval through redundancy reduction and dataset splitting, then analysis and model evaluation. The graph retains both documented classifier branches and their performance outputs. Several stages are represented by their existing directories because their implementation was not included in the source excerpts; cross-stage links follow the README’s documented workflow rather than inspected calls.

Main entry points: [`02_data_preparation/files/training_sets`](https://github.com/amiraynede/lb2-project-group-1/tree/main/02_data_preparation/files/training_sets) (Training and benchmark data), [`01_data_collection/scripts/00_data_collect.py`](https://github.com/amiraynede/lb2-project-group-1/blob/main/01_data_collection/scripts/00_data_collect.py) (Sequence retrieval), [`06_performance/scripts/fasta_cleaner.py`](https://github.com/amiraynede/lb2-project-group-1/blob/main/06_performance/scripts/fasta_cleaner.py) (FASTA cleaning), [`01_data_collection/output`](https://github.com/amiraynede/lb2-project-group-1/tree/main/01_data_collection/output) (Positive and negative sets)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_collection["Data collection"]
  node_retrieval["Sequence retrieval<br/>[00_data_collect.py]"]
  node_rawsets["Positive and negative sets"]
end

subgraph group_preparation["Dataset preparation"]
  node_clustering["Sequence clustering"]
  node_repids["Representative IDs"]
  node_metadata["Metadata organization"]
  node_folding["Cross-validation sets<br/>[03_dss_script.py]"]
  node_trainingdata["Training and benchmark data"]
end

subgraph group_analysis["Data analysis"]
  node_datasetanalysis["Dataset analysis"]
  node_visualizations["Dataset visualizations"]
end

subgraph group_models["Classification"]
  node_vhtrain["von Heijne training<br/>[06_vonHeijne.ipynb]"]
  node_vhdata["von Heijne training data"]
  node_svmfeatures["SVM feature extraction"]
  node_svmtraining["SVM training<br/>[08_SVM_main.ipynb]"]
end

subgraph group_evaluation["Performance evaluation"]
  node_vhperformance["von Heijne evaluation"]
  node_svmperformance["SVM evaluation"]
  node_benchmark["Benchmark datasets"]
  node_cleaner["FASTA cleaning<br/>[fasta_cleaner.py]"]
end

node_researcher(("Researcher"))
node_uniprot[("UniProtKB")]

node_researcher -->|"initiates"| node_retrieval
node_retrieval -->|"queries"| node_uniprot
node_retrieval -->|"writes datasets"| node_rawsets
node_rawsets -->|"cluster sequences"| node_clustering
node_clustering -->|"extract representatives"| node_repids
node_repids -->|"filter metadata"| node_metadata
node_metadata -->|"organize datasets"| node_folding
node_folding -->|"produce splits"| node_trainingdata
node_trainingdata -->|"analyze sequences"| node_datasetanalysis
node_datasetanalysis -->|"generate plots"| node_visualizations
node_trainingdata -->|"organize training data"| node_vhdata
node_vhdata -->|"train PSWM"| node_vhtrain
node_trainingdata -->|"extract features"| node_svmfeatures
node_svmfeatures -->|"train SVM"| node_svmtraining
node_vhtrain -->|"evaluate classifier"| node_vhperformance
node_svmtraining -->|"evaluate classifier"| node_svmperformance
node_trainingdata -->|"benchmark on"| node_benchmark
node_benchmark -.->|"clean FASTA"| node_cleaner
node_cleaner -.->|"prepare sequences"| node_vhperformance
node_cleaner -.->|"prepare sequences"| node_svmperformance

click node_retrieval "https://github.com/amiraynede/lb2-project-group-1/blob/main/01_data_collection/scripts/00_data_collect.py"
click node_rawsets "https://github.com/amiraynede/lb2-project-group-1/tree/main/01_data_collection/output"
click node_clustering "https://github.com/amiraynede/lb2-project-group-1/tree/main/02_data_preparation/files/cluster_output"
click node_repids "https://github.com/amiraynede/lb2-project-group-1/blob/main/02_data_preparation/scripts/01_extract_rep_ids.py"
click node_metadata "https://github.com/amiraynede/lb2-project-group-1/blob/main/02_data_preparation/scripts/02_organizing_metadata.py"
click node_folding "https://github.com/amiraynede/lb2-project-group-1/blob/main/02_data_preparation/scripts/03_dss_script.py"
click node_trainingdata "https://github.com/amiraynede/lb2-project-group-1/tree/main/02_data_preparation/files/training_sets"
click node_datasetanalysis "https://github.com/amiraynede/lb2-project-group-1/blob/main/03_data_analysis/scripts/04_Data_Analysis.ipynb"
click node_visualizations "https://github.com/amiraynede/lb2-project-group-1/tree/main/03_data_analysis/visualization"
click node_vhtrain "https://github.com/amiraynede/lb2-project-group-1/blob/main/04_vonHeijne/scripts/06_vonHeijne.ipynb"
click node_vhdata "https://github.com/amiraynede/lb2-project-group-1/blob/main/04_vonHeijne/scripts/05_training_df.ipynb"
click node_svmfeatures "https://github.com/amiraynede/lb2-project-group-1/blob/main/05_SVMs/scripts/07_feature_extraction.ipynb"
click node_svmtraining "https://github.com/amiraynede/lb2-project-group-1/blob/main/05_SVMs/scripts/08_SVM_main.ipynb"
click node_vhperformance "https://github.com/amiraynede/lb2-project-group-1/tree/main/06_performance/Von_Heijne"
click node_svmperformance "https://github.com/amiraynede/lb2-project-group-1/tree/main/06_performance/SVMs"
click node_benchmark "https://github.com/amiraynede/lb2-project-group-1/tree/main/06_performance/files"
click node_cleaner "https://github.com/amiraynede/lb2-project-group-1/blob/main/06_performance/scripts/fasta_cleaner.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_retrieval,node_rawsets toneBlue
class node_clustering,node_repids,node_metadata,node_folding,node_trainingdata,node_uniprot toneAmber
class node_datasetanalysis,node_visualizations toneMint
class node_vhtrain,node_vhdata,node_svmfeatures,node_svmtraining toneRose
class node_vhperformance,node_svmperformance,node_benchmark,node_cleaner,node_researcher toneIndigo
```

## Components

### Data collection

- [Sequence retrieval](https://github.com/amiraynede/lb2-project-group-1/blob/main/01_data_collection/scripts/00_data_collect.py): `01_data_collection/scripts/00_data_collect.py`
- [Positive and negative sets](https://github.com/amiraynede/lb2-project-group-1/tree/main/01_data_collection/output): `01_data_collection/output`

### Dataset preparation

- [Sequence clustering](https://github.com/amiraynede/lb2-project-group-1/tree/main/02_data_preparation/files/cluster_output): `02_data_preparation/files/cluster_output`
- [Representative IDs](https://github.com/amiraynede/lb2-project-group-1/blob/main/02_data_preparation/scripts/01_extract_rep_ids.py): `02_data_preparation/scripts/01_extract_rep_ids.py`
- [Metadata organization](https://github.com/amiraynede/lb2-project-group-1/blob/main/02_data_preparation/scripts/02_organizing_metadata.py): `02_data_preparation/scripts/02_organizing_metadata.py`
- [Cross-validation sets](https://github.com/amiraynede/lb2-project-group-1/blob/main/02_data_preparation/scripts/03_dss_script.py): `02_data_preparation/scripts/03_dss_script.py`
- [Training and benchmark data](https://github.com/amiraynede/lb2-project-group-1/tree/main/02_data_preparation/files/training_sets): `02_data_preparation/files/training_sets`

### Data analysis

- [Dataset analysis](https://github.com/amiraynede/lb2-project-group-1/blob/main/03_data_analysis/scripts/04_Data_Analysis.ipynb): `03_data_analysis/scripts/04_Data_Analysis.ipynb`
- [Dataset visualizations](https://github.com/amiraynede/lb2-project-group-1/tree/main/03_data_analysis/visualization): `03_data_analysis/visualization`

### Classification

- [von Heijne training](https://github.com/amiraynede/lb2-project-group-1/blob/main/04_vonHeijne/scripts/06_vonHeijne.ipynb): `04_vonHeijne/scripts/06_vonHeijne.ipynb`
- [von Heijne training data](https://github.com/amiraynede/lb2-project-group-1/blob/main/04_vonHeijne/scripts/05_training_df.ipynb): `04_vonHeijne/scripts/05_training_df.ipynb`
- [SVM feature extraction](https://github.com/amiraynede/lb2-project-group-1/blob/main/05_SVMs/scripts/07_feature_extraction.ipynb): `05_SVMs/scripts/07_feature_extraction.ipynb`
- [SVM training](https://github.com/amiraynede/lb2-project-group-1/blob/main/05_SVMs/scripts/08_SVM_main.ipynb): `05_SVMs/scripts/08_SVM_main.ipynb`

### Performance evaluation

- [von Heijne evaluation](https://github.com/amiraynede/lb2-project-group-1/tree/main/06_performance/Von_Heijne): `06_performance/Von_Heijne`
- [SVM evaluation](https://github.com/amiraynede/lb2-project-group-1/tree/main/06_performance/SVMs): `06_performance/SVMs`
- [Benchmark datasets](https://github.com/amiraynede/lb2-project-group-1/tree/main/06_performance/files): `06_performance/files`
- [FASTA cleaning](https://github.com/amiraynede/lb2-project-group-1/blob/main/06_performance/scripts/fasta_cleaner.py): `06_performance/scripts/fasta_cleaner.py`

### Other components

- **Researcher**
- **UniProtKB**

## Connections

- Researcher → Sequence retrieval: initiates (evidence: `README.md`)
- Sequence retrieval → UniProtKB: queries (evidence: `01_data_collection/scripts/00_data_collect.py`)
- Sequence retrieval → Positive and negative sets: writes datasets (evidence: `01_data_collection/scripts/00_data_collect.py`)
- Positive and negative sets → Sequence clustering: cluster sequences (evidence: `README.md`)
- Sequence clustering → Representative IDs: extract representatives (evidence: `README.md`)
- Representative IDs → Metadata organization: filter metadata (evidence: `README.md`)
- Metadata organization → Cross-validation sets: organize datasets (evidence: `README.md`)
- Cross-validation sets → Training and benchmark data: produce splits (evidence: `README.md`)
- Training and benchmark data → Dataset analysis: analyze sequences (evidence: `README.md`)
- Dataset analysis → Dataset visualizations: generate plots (evidence: `README.md`)
- Training and benchmark data → von Heijne training data: organize training data (evidence: `README.md`)
- von Heijne training data → von Heijne training: train PSWM (evidence: `README.md`)
- Training and benchmark data → SVM feature extraction: extract features (evidence: `README.md`)
- SVM feature extraction → SVM training: train SVM (evidence: `README.md`)
- von Heijne training → von Heijne evaluation: evaluate classifier (evidence: `README.md`)
- SVM training → SVM evaluation: evaluate classifier (evidence: `README.md`)
- Training and benchmark data → Benchmark datasets: benchmark on (evidence: `README.md`)
- Benchmark datasets → FASTA cleaning: clean FASTA
- FASTA cleaning → von Heijne evaluation: prepare sequences
- FASTA cleaning → SVM evaluation: prepare sequences
