How sobotka/agx-s2o3 works
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