# sobotka/agx-s2o3 architecture

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

- Interactive diagram: https://gitdiagram.com/sobotka/agx-s2o3
- Repository: https://github.com/sobotka/agx-s2o3

## Overview

##### File structure
- Top-level files:
- AgX.py            — the main engine: reads parameters, performs matrix operations (additive stimuli, rotations), produces transformed RGB outputs.
- generate_config.py — helper/CLI script for producing JSON or Python-dict configuration templates for AgX.
- README.md         — documents the cognitive rationale, explains “curves are meaningless,” and outlines the two key transformation stages.
- .gitignore        — standard VCS ignore file.

##### Insights from the README
- Two conceptual modules:
a. Additive Stimuli Module (matrix-based channel additive adjustments)
b. Rotation/Insets Module (basis-vector rotation controls)
- Configuration is critical: authors need ergonomic control over rotation and inset parameters.

a. Main components
- CLI Interface (entry point)
- Configuration Generator (generate_config.py)
- Transformation Engine (AgX.py), subdivided into:
– AdditiveStimuliProcessor
– RotationInsetsProcessor
- Output Writer (console/JSON/file)
- External: Python Interpreter, any libraries (e.g., numpy if used)
b. Relationships & data flow
1) User invokes generate_config.py → outputs config.json (or prints config template)
2) User customizes config.json → passes it as argument to AgX.py
3) AgX.py loads config → feeds parameters to
- AdditiveStimuliProcessor → produces intermediate RGB deltas
- RotationInsetsProcessor → applies basis-vector rotations
4) Aggregated output → Output Writer → console or file
c. Architectural patterns & design principles
- Single-process, modular design
- Separation of concerns: config generation vs. actual transformation
d. Key technologies & libraries
- Python 3.x
- Standard library modules (argparse, json)
- Optional: numpy or math for matrix operations

##### Elements
- Blue rectangles for executables/scripts

## Diagram (Mermaid)

```mermaid
flowchart TB
    %% Nodes
    User["User"]:::external
    GenerateConfig["Configuration Generator\n(generate_config.py)"]:::script
    ConfigArt["Config Template\n(config.json)"]:::data
    Engine["Transformation Engine\n(AgX.py)"]:::script

    subgraph "Engine Sub-Modules"
        Add["AdditiveStimuliProcessor"]:::module
        Rot["RotationInsetsProcessor"]:::module
        Out["Output Writer"]:::module
    end

    Output["Transformed Output\n(console/file)"]:::data

    %% Flow
    User -->|"invokes CLI"| GenerateConfig
    GenerateConfig -->|"outputs config.json"| ConfigArt
    ConfigArt -->|"passed as argument"| Engine
    Engine -->|"loads parameters"| Add
    Add -->|"produces RGB deltas"| Rot
    Rot -->|"applies rotations"| Out
    Out -->|"writes result"| Output

    %% Click events
    click GenerateConfig "https://github.com/sobotka/agx-s2o3/blob/main/generate_config.py"
    click Engine "https://github.com/sobotka/agx-s2o3/blob/main/AgX.py"
    click Add "https://github.com/sobotka/agx-s2o3/blob/main/AgX.py"
    click Rot "https://github.com/sobotka/agx-s2o3/blob/main/AgX.py"
    click Out "https://github.com/sobotka/agx-s2o3/blob/main/AgX.py"
    click ConfigArt "https://github.com/sobotka/agx-s2o3/blob/main/README.md"

    %% Styles
    classDef script fill:#81d4fa,stroke:#0288d1,stroke-width:1px
    classDef module fill:#a5d6a7,stroke:#2e7d32,stroke-width:1px
    classDef data fill:#fff59d,stroke:#f9a825,stroke-width:1px
    classDef external fill:#e0e0e0,stroke:#9e9e9e,stroke-width:1px
```
