# anschoudary/datai architecture

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

- Interactive diagram: https://gitdiagram.com/anschoudary/datai
- Repository: https://github.com/anschoudary/datai

## Overview

##### Project type and purpose
- This is an open-source Python library (“Datai”) offering data cleaning, visualization, automatic plot generation, sound visualization, and simple animations.
- There is no client/server or GUI layer—users import the `datai` package into their scripts or notebooks to call its APIs.

##### File structure
- Top-level files:
- README.md, setup.py, requirements.txt – package metadata and installation
- index.html + images/ – documentation or example gallery
- Core package directory `datai/` containing six modules:
- `data_cleaning.py` – data inspection and cleaning routines
- `visualization.py` – plot helper functions
- `auto_plot.py` – logic to pick and render appropriate plots automatically
- `sounds.py` (alias `sound_visualization`) – audio waveform/FFT/spectrogram functions
- `utils.py` – shared utilities (validation, safe conversion, summary)

##### README for additional insights
- The README confirms the six functional areas above, lists built-in datasets (Iris, Titanic, etc.), and shows external dependencies: pandas, seaborn, matplotlib, numpy, scipy, librosa (for audio), and matplotlib.animation.

## Diagram (Mermaid)

```mermaid
flowchart TD
    %% Data Sources
    DS["Data Sources: CSV/Excel files\nAudio files\nPandas DataFrames"]:::data
    %% User Application
    UserApp["User Application\n(Jupyter Notebook / Python Script)"]:::user
    %% Project Files
    subgraph "Project Files"
        Setup["setup.py"]:::infra
        Req["requirements.txt"]:::infra
        Readme["README.md"]:::infra
        Index["index.html"]:::infra
        Imgs["images/"]:::infra
    end
    %% Datai Library
    subgraph "Datai Library"
        Entry["__init__.py"]:::datai
        DC["data_cleaning.py"]:::datai
        VIS["visualization.py"]:::datai
        AP["auto_plot.py"]:::datai
        SV["sounds.py"]:::datai
        GIF["gift.py"]:::datai
        UT["utils.py"]:::datai
    end
    %% Infrastructure / Dependencies
    subgraph "Infrastructure"
        Python["Python 3.x"]:::infra
        Pandas["pandas"]:::infra
        NumPy["numpy"]:::infra
        Seaborn["seaborn"]:::infra
        Matplotlib["matplotlib"]:::infra
        SciPy["scipy"]:::infra
        Librosa["librosa"]:::infra
        MatAnim["matplotlib.animation"]:::infra
    end
    %% Outputs
    Outputs["Outputs:\nStatic plots (PNG)\nAnimated GIFs\nConsole summaries"]:::data

    %% Relationships
    DS -->|provides data| UserApp
    UserApp -->|imports| Entry
    UserApp -->|calls API| DC
    UserApp -->|calls API| VIS
    UserApp -->|calls API| AP
    UserApp -->|calls API| SV
    UserApp -->|calls API| GIF

    Entry -->|exposes| DC
    Entry -->|exposes| VIS
    Entry -->|exposes| AP
    Entry -->|exposes| SV
    Entry -->|exposes| GIF
    Entry -->|exposes| UT

    DC -->|uses| UT
    VIS -->|uses| UT
    AP -->|delegates to| VIS
    SV -->|uses| NumPy
    SV -->|uses| SciPy
    SV -->|uses| Librosa
    GIF -->|uses| MatAnim
    VIS -->|uses| Matplotlib
    VIS -->|uses| Seaborn
    DC -->|uses| Pandas
    UT -->|uses| Pandas
    UT -->|uses| NumPy

    OutputChain1(VIS) -->|renders| Outputs
    OutputChain2(SV) -->|renders| Outputs
    OutputChain3(GIF) -->|renders| Outputs

    Setup --> Entry
    Req --> Entry
    Readme --> Entry
    Index --> Entry
    Imgs --> Entry

    %% Click Events
    click DC "https://github.com/anschoudary/datai/blob/main/datai/data_cleaning.py"
    click VIS "https://github.com/anschoudary/datai/blob/main/datai/visualization.py"
    click AP "https://github.com/anschoudary/datai/blob/main/datai/auto_plot.py"
    click SV "https://github.com/anschoudary/datai/blob/main/datai/sounds.py"
    click GIF "https://github.com/anschoudary/datai/blob/main/datai/gift.py"
    click UT "https://github.com/anschoudary/datai/blob/main/datai/utils.py"
    click Entry "https://github.com/anschoudary/datai/blob/main/datai/__init__.py"
    click Setup "https://github.com/anschoudary/datai/blob/main/setup.py"
    click Req "https://github.com/anschoudary/datai/blob/main/requirements.txt"
    click Readme "https://github.com/anschoudary/datai/blob/main/README.md"
    click Index "https://github.com/anschoudary/datai/blob/main/index.html"
    click Imgs "https://github.com/anschoudary/datai/tree/main/images/"

    %% Styles
    classDef datai fill:#AEDFF7,stroke:#03689A,color:#000
    classDef infra fill:#C8E6C9,stroke:#2E7D32,color:#000
    classDef data fill:#FFF9C4,stroke:#F9A825,color:#000
    classDef user fill:#FFECB3,stroke:#FF6F00,color:#000
```
