# labioinfoufsc/ebscore architecture

> Architecture diagram of the GitHub repository labioinfoufsc/ebscore, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2025-07-17). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/labioinfoufsc/ebscore
- Repository: https://github.com/labioinfoufsc/ebscore

## Overview

##### Project type and purpose
- This is a data-science/ML research pipeline, not a web or microservices system.
- Purpose: ingest epitope data from IEDB/UniProt, preprocess it (via Java and EpiBuilder), train and evaluate a decision-tree model in a Jupyter notebook, and validate Trypanosoma epitopes.

##### File structure
- Top-level files: README.md (project description), epitryp.ipynb (analysis and modeling notebook), LICENSE, .gitignore.
- assets/ folder contains:
- RandomPeptide.java (Java code for generating random peptides)
- experiment.ows (Orange Data Mining workflow file)
- No “frontend” or “backend” folders—this is a single-pipeline project.

##### README for additional insights
- Data sources: IEDB and UniProtKB.
- Preprocessing tools: EpiBuilder and custom Java code in assets.
- Modeling and evaluation: Python libs (pandas, numpy, scikit-learn, seaborn, matplotlib) inside a Colab notebook; Orange workflow for algorithm comparison.

##### Essential architectural elements
- Keep components granular (separate Java preprocessing from Python modeling)
- External dependencies (databases, tools)
- Parallel or alternative paths (Orange vs. notebook evaluation)

## Diagram (Mermaid)

```mermaid
flowchart TB
    subgraph "External Data Sources"
        IEDB["IEDB API"]:::external
        UniProt["UniProtKB"]:::external
    end
    IEDB --> RawStorage
    UniProt --> RawStorage

    RawStorage["Raw Dataset Storage"]:::dataStore

    subgraph "Preprocessing Module"
        RP["RandomPeptide.java"]:::processing
        EB["EpiBuilder"]:::tool
    end

    RawStorage --> RP
    RawStorage --> EB
    RP --> Cleaned["Cleaned Dataset"]:::dataStore
    EB --> Cleaned

    subgraph "Exploratory Analysis"
        OW["Orange Workflow (experiment.ows)"]:::tool
    end
    Cleaned --> OW

    subgraph "Modeling & Evaluation"
        NB["Modeling & Evaluation Notebook"]:::processing
    end
    Cleaned --> NB

    subgraph "Output Artifacts"
        Model["Trained Decision Tree Model"]:::output
        Metrics["Evaluation Metrics & Figures"]:::output
    end
    NB --> Model
    NB --> Metrics
    OW --> Metrics

    subgraph "Project Documentation"
        Readme["README.md"]:::external
        License["LICENSE"]:::external
        Gitignore[".gitignore"]:::external
    end

    click RP "https://github.com/labioinfoufsc/ebscore/blob/main/assets/RandomPeptide.java"
    click OW "https://github.com/labioinfoufsc/ebscore/blob/main/assets/experiment.ows"
    click NB "https://github.com/labioinfoufsc/ebscore/blob/main/epitryp.ipynb"
    click Readme "https://github.com/labioinfoufsc/ebscore/blob/main/README.md"
    click License "https://github.com/labioinfoufsc/ebscore/tree/main/LICENSE"
    click Gitignore "https://github.com/labioinfoufsc/ebscore/blob/main/.gitignore"

    classDef external fill:#D3D3D3,stroke:#000,stroke-width:1px
    classDef dataStore fill:#ADD8E6,stroke:#000,stroke-width:1px
    classDef processing fill:#98FB98,stroke:#000,stroke-width:1px
    classDef tool fill:#FFA500,stroke:#000,stroke-width:1px
    classDef output fill:#FFFF99,stroke:#000,stroke-width:1px
```
