CoolFace
Apppublic

ciaochris/cymatic-ai-frequency-modulator

sourceHugging Faceapache-2.0updated 4mo agoView on Hugging Face
2likes
App README

NeuroSync Cymatics Lab

NeuroSync Cymatics Lab is an educational Gradio app for exploring simulated wave interference, resonance modes, generated audio, spectrograms, and exportable waveform data.

It is not a medical, therapeutic, or nervous-system reset tool. The app visualizes acoustic concepts and synthetic signals for learning, design exploration, and creative experimentation.

Features

  • —Frequency, duration, material, and container-dimension controls.
  • —Low-order resonance-mode calculations for water, air, metal, and biological-tissue approximations.
  • —Simulated cymatic interference pattern image.
  • —Generated audio waveform.
  • —Waveform and spectrogram views.
  • —AI-assisted waveform planning when GROQ_API_KEY is configured.
  • —Deterministic local fallback when Groq is unavailable.
  • —CSV export with metadata and sample-level waveform data.
  • —Input validation for physical ranges and dimensions.

How To Use

  1. 1.Choose a frequency between 20 Hz and 20,000 Hz.
  2. 2.Choose a duration between 1 and 10 seconds.
  3. 3.Select a material model.
  4. 4.Set positive container dimensions.
  5. 5.Click Generate Pattern.
  6. 6.Review the pattern, audio, spectrum, AI/simulation notes, and CSV export.

Configuration

Optional Space secrets:

SecretRequiredPurpose
GROQ_API_KEYNoEnables AI-assisted waveform planning.
GROQ_MODELNoOverrides the default Groq model.
APP_LOG_LEVELNoDefaults to INFO.

Without GROQ_API_KEY, the app still works using deterministic synthesis.

Scientific Scope

This simulator uses simplified acoustic assumptions. Real cymatics depends on plate geometry, boundary conditions, actuator coupling, fluid depth, particle medium, damping, temperature, and measurement setup. Biological tissue is especially complex, so that material option is only an educational approximation.

Do not use this app to diagnose, treat, or claim biological effects.

Development

Run tests:

bash
python -m unittest tests.test_app

The test suite covers import safety, validation, resonance modes, waveform normalization, deterministic fallback generation, output shape, and adaptive Groq model selection.

License

Apache-2.0