# ddw2aigroup2cqupt/grig architecture

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

- Interactive diagram: https://gitdiagram.com/ddw2aigroup2cqupt/grig
- Repository: https://github.com/ddw2aigroup2cqupt/grig

## Overview

##### Project type and purpose
- This is a research‐style machine‐learning library (“GRIG”) that implements a graph‐based image representation algorithm (“Granular‐ball”) and applies it to two standard benchmarks (MNIST and CIFAR‑10).
- Key indicators: top‐level folders MNIST/ and cifar-10/, each containing data archives, loaders, model definitions, and training scripts. README title “Graph‑based Representation for Image based on Granular‐ball.”

##### File structure
- Top level
- LICENSE, README.md (project description)
- MNIST/ (data + nets + main script + readme)
- cifar-10/ (data_loader/, data archives, ParserArgument.py, model.py, train.py, utils.py)
- MNIST module
- data/ (zipped image sets) → uncompress → feed to main_mnist_ceng33.py
- nets/ (Net1.py, Net2.py, Net3.py) → different GNN architectures or network variants
- main_mnist_ceng33.py (entry point for training/eval)
- CIFAR‑10 module
- Data_loader/ (ClassificationBase_dataset.py, transforms.py) → PyTorch‐style dataset & transforms
- ParserArgument.py (CLI argument parsing) → config for model, training hyperparams
- model.py (GNN model definition)
- train.py (training loop)
- utils.py (metrics, logging, checkpoint helpers)
- No external microservices; all components live in one codebase. Follows a pipeline pattern: data → preprocessing/graph‐generation → model → train/evaluate.

##### Insights from README
- Confirms focus on a graph‐based representation algorithm (“Granular‐ball”).

## Diagram (Mermaid)

```mermaid
flowchart TD
    subgraph "MNIST Pipeline"
        MDArchives["MNIST Data Archives"]:::data
        MDScript["main_mnist_ceng33.py"]:::orchestration
        MDArchives --> MDScript
    end

    subgraph "CIFAR-10 Pipeline"
        CDArchives["CIFAR-10 Data Archives"]:::data
        CDLoader["ClassificationBase_dataset"]:::processing
        CTransforms["transforms"]:::processing
        CParser["ParserArgument.py"]:::orchestration
        CDArchives --> CDLoader --> CTransforms
        CParser ---> CTransforms
    end

    GraphGen["Granular-ball Graph Generator"]:::processing

    MDScript --> GraphGen
    CTransforms --> GraphGen

    subgraph "Model Definitions"
        MN1["Net1"]:::model
        MN2["Net2"]:::model
        MN3["Net3"]:::model
        CModel["model.py"]:::model
    end

    GraphGen --> MN1
    GraphGen --> MN2
    GraphGen --> MN3
    GraphGen --> CModel

    subgraph "Training & Evaluation"
        MDTrain["Training & Eval"]:::orchestration
        CTrain["train.py"]:::orchestration
        CUtils["utils.py"]:::orchestration
    end

    MN1 --> MDTrain
    MN2 --> MDTrain
    MN3 --> MDTrain
    CModel --> CTrain
    CTrain --> CUtils

    %% Click Events
    click MDArchives "https://github.com/ddw2aigroup2cqupt/grig/tree/main/MNIST/data/"
    click MDScript "https://github.com/ddw2aigroup2cqupt/grig/blob/main/MNIST/main_mnist_ceng33.py"
    click CDArchives "https://github.com/ddw2aigroup2cqupt/grig/tree/main/cifar-10/data/"
    click CDLoader "https://github.com/ddw2aigroup2cqupt/grig/blob/main/cifar-10/Data_loader/ClassificationBase_dataset.py"
    click CTransforms "https://github.com/ddw2aigroup2cqupt/grig/blob/main/cifar-10/Data_loader/transforms.py"
    click CParser "https://github.com/ddw2aigroup2cqupt/grig/blob/main/cifar-10/ParserArgument.py"
    click MN1 "https://github.com/ddw2aigroup2cqupt/grig/blob/main/MNIST/nets/Net1.py"
    click MN2 "https://github.com/ddw2aigroup2cqupt/grig/blob/main/MNIST/nets/Net2.py"
    click MN3 "https://github.com/ddw2aigroup2cqupt/grig/blob/main/MNIST/nets/Net3.py"
    click CModel "https://github.com/ddw2aigroup2cqupt/grig/blob/main/cifar-10/model.py"
    click CTrain "https://github.com/ddw2aigroup2cqupt/grig/blob/main/cifar-10/train.py"
    click CUtils "https://github.com/ddw2aigroup2cqupt/grig/blob/main/cifar-10/utils.py"

    %% Styles
    classDef data fill:#AED6F1,stroke:#000;
    classDef processing fill:#ABEBC6,stroke:#000;
    classDef model fill:#F5B041,stroke:#000;
    classDef orchestration fill:#D2B4DE,stroke:#000;
```
