goonj 1.4.3

Goonj — acoustics engine for sound propagation, room simulation, and impulse response generation
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
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104

//! # Goonj
//!
//! **Goonj** (गूँज — Hindi/Urdu for "echo, resonance") — acoustics engine for
//! the AGNOS ecosystem.
//!
//! Provides sound propagation, room simulation, ray-based acoustic tracing,
//! impulse response generation, diffraction, and resonance analysis.
//! Built on [`hisab`] for math.
//!
//! ## Example
//!
//! ```rust
//! use goonj::{propagation, impulse, material::AcousticMaterial};
//!
//! let speed = propagation::speed_of_sound(20.0);
//! assert!((speed - 343.4).abs() < 0.1);
//!
//! let rt60 = impulse::sabine_rt60(500.0, 50.0);
//! assert!(rt60 > 0.0);
//! ```

/// Ambisonics encoding (1st-order B-Format and 3rd-order HOA).
pub mod ambisonics;
/// Room acoustics analysis metrics (C50, C80, D50, EDT, G, ts, LF, IACC, STI).
pub mod analysis;
/// Beam tracing — volumetric sound propagation without sampling artifacts.
pub mod beam;
/// Binaural impulse response generation with HRTF spatialization.
#[cfg(feature = "binaural")]
pub mod binaural;
/// Cross-crate bridges — primitive-value conversions from other AGNOS science crates.
pub mod bridge;
/// Coupled room acoustics — multi-room energy exchange and double-slope decay.
pub mod coupled;
/// Dark Velvet Noise reverb — non-exponential late reverberation from sparse stochastic pulses.
pub mod dark_velvet_noise;
/// Edge diffraction loss and occlusion detection (UTD, BTM).
pub mod diffraction;
/// Stochastic ray tracing (diffuse rain) for late reverberation tails.
pub mod diffuse;
/// Acoustic diffusion equation — energy density PDE solver.
pub mod diffusion;
/// Source directivity patterns (omnidirectional, cardioid, tabulated balloon data).
pub mod directivity;
/// 3D rectilinear Digital Waveguide Mesh — wave-based room acoustics (Smith / Van Duyne).
pub mod dwm;
/// Error types for the goonj crate.
pub mod error;
/// Feedback Delay Network (FDN) for efficient late reverberation synthesis.
pub mod fdn;
/// 2D FDTD modal solver for low-frequency room acoustics (Botteldooren 1995).
pub mod fdtd;
/// Green's Function Parabolic Equation outdoor propagation over terrain.
pub mod gfpe;
/// Hybrid frequency crossover — blending wave-based and geometric results.
pub mod hybrid;
/// Image-source method for exact early specular reflections.
pub mod image_source;
/// Impulse response generation, RT60 estimation, and energy decay curves.
pub mod impulse;
/// Integration APIs for downstream consumers (dhvani, kiran, soorat).
pub mod integration;
/// Acoustic materials with frequency-dependent absorption, scattering, and transmission.
pub mod material;
/// Acoustic metamaterials — engineered structures with frequency-dependent effective parameters.
pub mod metamaterial;
/// ISO 9613-2 outdoor sound propagation methods.
pub mod outdoor;
/// Portal-based sound propagation through openings between rooms.
pub mod portal;
/// Sound propagation: speed of sound, inverse square law, Doppler, atmospheric effects.
pub mod propagation;
/// Acoustic radiosity — energy exchange between surface patches.
pub mod radiosity;
/// Acoustic ray tracing: single-band, multiband, BVH-accelerated.
pub mod ray;
/// Room resonance modes, Schroeder frequency, and modal density.
pub mod resonance;
/// Room geometry, walls, and acceleration structures.
pub mod room;
/// Vector-based scattering for diffuse reflections (cosine-weighted hemisphere sampling).
pub mod scattering;
/// Universal Diffraction Filter Approximation (UDFA) for real-time diffraction.
pub mod udfa;
/// Underwater acoustics — ocean sound speed, seabed reflection, absorption.
#[cfg(feature = "underwater")]
pub mod underwater;
/// Vibroacoustics — structural vibration to acoustic radiation coupling.
pub mod vibroacoustics;
/// WAV file export (16-bit PCM, mono/stereo).
#[cfg(feature = "wav")]
pub mod wav;

/// Tracing subscriber initialization.
#[cfg(feature = "logging")]
pub mod logging;

pub use error::{GoonjError, Result};
pub use impulse::{ImpulseResponse, eyring_rt60, sabine_rt60};
pub use material::AcousticMaterial;
pub use propagation::{doppler_shift, inverse_square_law, speed_of_sound};
pub use ray::{AcousticRay, MultibandRay, RayHit, RayPath};
pub use resonance::{room_mode, schroeder_frequency};
pub use room::{AcceleratedRoom, AcousticRoom, RoomGeometry, Wall};