# otniel113/jankenpon-cv architecture

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

- Interactive diagram: https://gitdiagram.com/otniel113/jankenpon-cv
- Repository: https://github.com/otniel113/jankenpon-cv

## Overview

##### Project Type and Purpose
- This is a data‐science/image‐classification project implemented as a single Jupyter Notebook (“Jankenpon.ipynb”).
- Purpose: classify rock, paper, scissors images using classic machine learning (no deep learning feature extraction).

##### File Structure Analysis
- Top level:
- Jankenpon.ipynb – contains the entire data pipeline and modeling logic
- README.md – project description, dataset info, feature selection, model details, results

##### Key Architectural Elements
- Data Source (Kaggle dataset of rock/paper/scissors images)
- Data Ingestion & Preprocessing
- Feature Extraction (raw pixel values → 180,000‐dim features)
- Feature Selection (Random Forest feature importance → ~10K features)
- Model Training (Scikit-Learn MLPClassifier)
- Model Evaluation (cross‐validation & test accuracy)
- Notebook Environment (Jupyter) orchestrating the pipeline
- Dependencies: Python, NumPy, pandas, scikit-learn, possibly matplotlib/seaborn

- “Data Source” (external service: Kaggle dataset)
- “Data Loader & Preprocessor”
- “Feature Extractor”
- “Feature Selector”
- “ML Model Trainer”
- “Evaluator & Reporter”
- “Notebook Interface” (overarching container)
Data Source → Loader/Preprocessor → Feature Extractor → Feature Selector → Model Trainer → Evaluator
c. Architectural Patterns & Principles:
- Pipeline pattern: sequential stages for transform → select → train → evaluate
- Separation of concerns: each stage handles a single responsibility
d. Technologies/Frameworks:
- Python ecosystem (NumPy/pandas for data handling, scikit-learn for feature selection and MLP)
- Jupyter Notebook as orchestrator

## Diagram (Mermaid)

```mermaid
flowchart TD
    subgraph "Jupyter Notebook Interface"
        direction TB
        DS["Data Source (Kaggle dataset)"]:::external
        DL["Data Loader & Preprocessor"]:::data
        FE["Feature Extractor"]:::data
        FS["Feature Selector (RF Importance)"]:::feature
        MT["ML Model Trainer (MLPClassifier)"]:::model
        EV["Evaluator & Reporter"]:::model
    end

    PD["Project Description & Data Source Info"]:::doc

    PD --> DS
    DS -->|"images (300×200×3)"| DL
    DL -->|"raw features (180k dims)"| FE
    FE -->|"features"| FS
    FS -->|"selected features (10k dims)"| MT
    MT -->|"trained model & metrics"| EV

    click DS "https://github.com/otniel113/jankenpon-cv/blob/main/Jankenpon.ipynb"
    click DL "https://github.com/otniel113/jankenpon-cv/blob/main/Jankenpon.ipynb"
    click FE "https://github.com/otniel113/jankenpon-cv/blob/main/Jankenpon.ipynb"
    click FS "https://github.com/otniel113/jankenpon-cv/blob/main/Jankenpon.ipynb"
    click MT "https://github.com/otniel113/jankenpon-cv/blob/main/Jankenpon.ipynb"
    click EV "https://github.com/otniel113/jankenpon-cv/blob/main/Jankenpon.ipynb"
    click PD "https://github.com/otniel113/jankenpon-cv/blob/main/README.md"

    classDef data fill:#AEDFF7,stroke:#036,stroke-width:1px
    classDef feature fill:#F7D6A5,stroke:#E07A5F,stroke-width:1px
    classDef model fill:#A5F7A5,stroke:#2F8F2F,stroke-width:1px
    classDef external fill:transparent,stroke:#999,stroke-dasharray:5 5,stroke-width:1px
    classDef doc fill:#EEE,stroke:#999,stroke-width:1px,stroke-dasharray:2 2
```
