ringkernel-wavesim3d 0.4.0

3D acoustic wave simulation with realistic physics, binaural audio, and GPU acceleration
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82

[package]
name = "ringkernel-wavesim3d"
version.workspace = true
edition.workspace = true
authors.workspace = true
license.workspace = true
repository.workspace = true
homepage.workspace = true
rust-version.workspace = true
description = "3D acoustic wave simulation with realistic physics, binaural audio, and GPU acceleration"
keywords = ["gpu", "simulation", "wave", "physics", "binaural"]
categories = ["simulation", "graphics", "visualization", "multimedia::audio"]
readme = "README.md"

[dependencies]
ringkernel = { version = "0.4.0", path = "../ringkernel" }
ringkernel-core = { version = "0.4.0", path = "../ringkernel-core" }
ringkernel-derive = { version = "0.4.0", path = "../ringkernel-derive" }
ringkernel-cuda-codegen = { version = "0.4.0", path = "../ringkernel-cuda-codegen", optional = true }
inventory = { workspace = true }

# 3D Rendering
wgpu = { workspace = true }
winit = "0.30"
egui = "0.31"
egui-wgpu = "0.31"
egui-winit = "0.31"
glam = "0.29"  # 3D math (Vec3, Mat4, Quat)
bytemuck = { version = "1.24", features = ["derive"] }
half = "2.4"  # f16 support for volume textures
pollster = "0.3"  # Blocking async runtime for wgpu init

# Async runtime
tokio = { workspace = true }

# Utilities
tracing = { workspace = true }
tracing-subscriber = { workspace = true }

# Parallel processing
rayon = "1.11"

# Random number generation
rand = "0.8"

# Audio processing (hound is always available for file I/O)
hound = "3.5"  # WAV file reading/writing
# Real-time audio (optional, requires system libs)
cpal = { version = "0.15", optional = true }
rustfft = { version = "6.2", optional = true }  # FFT for frequency analysis

# CUDA compute (optional)
ringkernel-cuda = { version = "0.4.0", path = "../ringkernel-cuda", optional = true }
cudarc = { workspace = true, optional = true }

# Code generation (optional)
syn = { workspace = true, optional = true }

[dev-dependencies]
criterion = { workspace = true }

[features]
default = ["cpu"]
cpu = ["ringkernel/cpu"]
cuda = ["ringkernel/cuda", "dep:ringkernel-cuda", "dep:cudarc"]
cuda-codegen = ["cuda", "dep:ringkernel-cuda-codegen", "dep:syn", "ringkernel-derive/cuda-codegen"]
# Cooperative groups for true grid-wide sync (requires nvcc at build time)
cooperative = ["cuda", "ringkernel-cuda/cooperative"]
audio-output = ["dep:cpal", "dep:rustfft"]

[[bin]]
name = "wavesim3d"
path = "src/bin/wavesim3d.rs"

[[bin]]
name = "wavesim3d-benchmark"
path = "src/bin/benchmark.rs"
required-features = ["cuda"]

[[bin]]
name = "interactive-benchmark"
path = "src/bin/interactive_benchmark.rs"