# hassi34/vizpool architecture

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

- Interactive diagram: https://gitdiagram.com/hassi34/vizpool
- Repository: https://github.com/hassi34/vizpool

## Overview

##### Project type and purpose
- This is a Python library (distributed via PyPI) for low-code static and interactive data visualization.
- It provides two high-level APIs:
- vizpool.static (modules: common, eda, eval)
- vizpool.interactive (module: interactive.py)
- It relies on underlying plotting engines (e.g., matplotlib/seaborn for static, plotly/bokeh for interactive—imported within the library).

##### File structure
- Top-level:
- CI/CD definitions (.github/workflows/cicd.yml)
- Packaging config (pyproject.toml, setup.py)
- README, LICENSE
- src/vizpool/: the library root
- interactive.py → entry point for interactive visuals
- static/
– common.py → shared helpers/utilities
– eda.py → “Exploratory Data Analysis” static charts
– eval.py → “Evaluation” static charts

##### README for insights
- Confirms two main feature sets: static vs. interactive.
- Mentions Python 3.7+, installation via pip, usage examples.
- Points to external tutorials, PDF docs—indicates extensibility and educational integration.

##### Detailed breakdown
- On the left: “User Environment” (Jupyter, script)
- Below static: common → eda & eval
- Bottom: Packaging files (setup.py/pyproject.toml) feeding into build step

## Diagram (Mermaid)

```mermaid
flowchart TD
    %% User Environment
    subgraph "User Environment"
        UserApp["User Application / Notebook"]:::user
    end

    %% VizPool Package
    subgraph "VizPool Package"
        Init["__init__.py"]:::root
        subgraph "Static Module"
            Common["common.py"]:::static
            EDA["eda.py"]:::static
            Eval["eval.py"]:::static
        end
        subgraph "Interactive Module"
            Interactive["interactive.py"]:::interactive
        end
    end

    %% External Plotting Engines
    subgraph "Plotting Engines"
        Matplotlib["matplotlib / seaborn"]:::external
        Plotly["plotly / bokeh"]:::external
    end

    %% Packaging & Distribution
    subgraph "Packaging & Distribution"
        Pyproject["pyproject.toml"]:::config
        Setup["setup.py"]:::config
        CI["GitHub Actions (cicd.yml)"]:::cicd
        PyPI["PyPI Registry"]:::dist
    end

    %% Repository Metadata
    subgraph "Repository Metadata"
        Readme["README.md"]:::docs
        License["LICENSE"]:::docs
    end

    %% Connections
    UserApp -->|"calls Static API"| EDA
    UserApp -->|"calls Static API"| Eval
    UserApp -->|"calls Interactive API"| Interactive
    EDA -->|"uses Utils"| Common
    Eval -->|"uses Utils"| Common
    EDA -->|"renders with"| Matplotlib
    Eval -->|"renders with"| Matplotlib
    Interactive -->|"renders with"| Plotly
    Init --> Common
    Init --> EDA
    Init --> Eval
    Init --> Interactive
    Pyproject --> CI
    Setup --> CI
    CI -->|"publishes to"| PyPI
    Readme --> CI
    License --> CI

    %% Click Events
    click Common "https://github.com/hassi34/vizpool/blob/main/src/vizpool/static/common.py"
    click EDA "https://github.com/hassi34/vizpool/blob/main/src/vizpool/static/eda.py"
    click Eval "https://github.com/hassi34/vizpool/blob/main/src/vizpool/static/eval.py"
    click Interactive "https://github.com/hassi34/vizpool/blob/main/src/vizpool/interactive.py"
    click Init "https://github.com/hassi34/vizpool/blob/main/src/vizpool/__init__.py"
    click Pyproject "https://github.com/hassi34/vizpool/blob/main/pyproject.toml"
    click Setup "https://github.com/hassi34/vizpool/blob/main/setup.py"
    click CI "https://github.com/hassi34/vizpool/blob/main/.github/workflows/cicd.yml"
    click Readme "https://github.com/hassi34/vizpool/blob/main/README.md"
    click License "https://github.com/hassi34/vizpool/tree/main/LICENSE"

    %% Styles
    classDef user fill:#D6EAF8,stroke:#3498DB,stroke-width:1px
    classDef static fill:#D5F5E3,stroke:#27AE60,stroke-width:1px
    classDef interactive fill:#E8F8F5,stroke:#1ABC9C,stroke-width:1px
    classDef root fill:#FCF3CF,stroke:#F1C40F,stroke-width:1px
    classDef external fill:#FAD7A0,stroke:#D68910,stroke-width:1px
    classDef config fill:#F5B7B1,stroke:#C0392B,stroke-width:1px
    classDef cicd fill:#FDEBD0,stroke:#E67E22,stroke-width:1px
    classDef dist fill:#EBDEF0,stroke:#8E44AD,stroke-width:1px
    classDef docs fill:#F2F3F4,stroke:#7F8C8D,stroke-width:1px
```
