Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/a-sumo/lattice
Sound Generation via Physics-Inspired Cellular Automata
https://github.com/a-sumo/lattice
Last synced: about 2 months ago
JSON representation
Sound Generation via Physics-Inspired Cellular Automata
- Host: GitHub
- URL: https://github.com/a-sumo/lattice
- Owner: a-sumo
- License: mit
- Created: 2023-10-04T20:41:59.000Z (over 1 year ago)
- Default Branch: main
- Last Pushed: 2023-12-09T06:50:28.000Z (about 1 year ago)
- Last Synced: 2024-10-12T22:26:05.773Z (3 months ago)
- Language: C++
- Homepage:
- Size: 4.08 MB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
"""
# lattice
Sound Generation via Physics-Inspired Cellular Automata
Generating sound through simulations of real-world physics, especially the intricate dynamics of pressure wave propagation, presents computational challenges. For a better grasp on this, consider the following:
- AngeTheGreat's real-time demonstration of physics-based audio: [Real-time Trumpet Simulation [C++/Vulkan]](https://youtu.be/rGNUHigqUBM?t=119).
- Doug James elaborating on the intricacies of physics-based sound generation: [Doug James: Computer-generated sound catches its graphical sibling](https://youtu.be/10zK-3SjTeY?t=479).
To address these challenges, we can beging with an understanding of the capabilities of current hardware (CPUs and GPUs), and identify the kind of physics simulations they can efficiently handle. This is where Cellular automata come into the picture. Defined on a grid and driven by simple, localized rules, they are known to produce intricate dynamics. Given their structure, they can be computed rapidly on contemporary hardware, which makes them a potential tool for simulating real-world physics. A notable example in this context is the [Lattice gas automaton](https://en.wikipedia.org/wiki/Lattice_gas_automaton).
## Technical Overview
The application initializes a 2D automaton grid of specified dimensions, populates it with an initial state, and then continuously computes its subsequent states. The automaton's state serves as a data source for audio streaming via a callback mechanism.
### High-Level Workflow
```mermaid
graph TD;
A[Application Initialization] --> B[2D Automaton Setup];
B --> C[Seed Automaton with Pulse Pattern];
C --> D[Main Loop Execution];
D --> E[Audio Streaming];
E --> F[Real-time Playback];
```
### Detailed Workflow
Diagram
```mermaid
graph TD;
A1[Initialize Application] --> B1[Set up GLFW and Audio Handlers];
B1 --> C1[Initialize 2D Automaton Grid];
C1 --> D1[Seed with Pulse Pattern];
D1 --> E1[Enter Main Loop];
E1 --> F1[Compute Next State in Parallel];
F1 --> G1[Swap Read/Write Buffers];
G1 --> H1[Callback to Stream Audio];
H1 --> I1[Fill Audio Buffer from Automaton State];
I1 --> J1[Playback Audio];
J1 --> E1;
```
## Code Structure
The main constituents and directory structure of the project are:
- **Root Directory**:
- `CMakeLists.txt`: The primary configuration file for CMake.
- `build.sh`: A handy script for project compilation.
- `README.md`: A comprehensive guide and overview (this document).
- **Audio Processing**:
- Resides in the `audio` directory.
- Hosts classes and functionalities tied to audio processing and streaming.
- **Automaton Simulation**:
- Found inside the `src` directory.
- The core simulation logic is encapsulated in `automaton_2d.cpp` and `SimulationWorker.cpp`.
- **Resources and Third-party Libraries**:
- `resources`: A repository for asset files utilized in the simulation.
- `external`: A directory for external headers and libraries.
- `webgpu`: Houses files and configurations related to WebGPU.
## Compilation and Execution
Please consult the provided `build.sh` script for detailed build instructions. The current version is tailored for macOS, but there are plans to extend support to other platforms.
"""