# algpy/conceptgcd architecture

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

- Interactive diagram: https://gitdiagram.com/algpy/conceptgcd
- Repository: https://github.com/algpy/conceptgcd

## Overview

##### (minimal) file structure
- data/ (raw, processed)
- src/ (model definitions, training loops, evaluation)
- notebooks/ (exploratory code)
- configs/ (experiment settings)
- scripts/ (job submission, inference scripts)
- tests/ (unit and integration tests)

##### README for additional insights
- The README promises a “concept-driven approach” to class discovery, implying components for concept extraction, embedding, clustering, and open-set evaluation.
- No technologies are named yet, but typical choices might include PyTorch/TensorFlow, Hydra/argparse for configs, MLFlow or TensorBoard for logging, and possibly a CLI or Jupyter interface.

## Diagram (Mermaid)

```mermaid
flowchart TD
    %% Subgraphs for layers
    subgraph "Data Layer"
        direction TB
        RawData(("Raw Data Store")):::data
        Preprocessing["Preprocessing Module"]:::data
    end

    subgraph "Concept Extraction"
        direction TB
        Embedding["Embedding Network"]:::model
        ConceptVec["Concept Vector Generator"]:::model
    end

    subgraph "Discovery Engine"
        direction TB
        Clustering["Clustering Algorithm"]:::model
        Novelty["Novelty Detector"]:::model
    end

    subgraph "Training & Experimentation"
        direction TB
        Trainer["Trainer"]:::model
        ConfigMgr["Configuration Manager"]:::model
    end

    subgraph "Evaluation & Logging"
        direction TB
        Metrics["Metrics Module"]:::log
        Logger["Logger"]:::log
    end

    subgraph "User Interface / API (Future)"
        direction TB
        CLI["CLI / REST API"]:::interface
        Notebook["Notebook Interface"]:::interface
    end

    %% Data flow
    RawData --> Preprocessing
    Preprocessing --> Embedding
    Embedding --> ConceptVec
    ConceptVec --> Clustering
    Clustering --> Novelty
    Novelty --> Trainer
    Trainer --> Metrics
    Metrics --> Logger

    %% Configuration injection
    ConfigMgr -->|injects parameters| Trainer

    %% Interfaces triggering pipeline
    CLI -->|submits job| Trainer
    Notebook -->|explores data| Preprocessing
    Notebook -->|views metrics| Metrics

    %% Styling
    classDef data fill:#ADD8E6,stroke:#000,stroke-width:1px
    classDef model fill:#90EE90,stroke:#000,stroke-width:1px
    classDef log fill:#FFA500,stroke:#000,stroke-width:1px
    classDef interface fill:#DDA0DD,stroke:#000,stroke-width:1px
```
