Struct AcousticParams3D 

pub struct AcousticParams3D {
    pub environment: Environment,
    pub medium: MediumProperties,
    pub cell_size: f32,
    pub time_step: f32,
    pub c_squared: f32,
    pub damping: MultiBandDamping,
    pub simple_damping: f32,
}

Parameters for the 3D acoustic wave simulation.

Uses the FDTD (Finite-Difference Time-Domain) method for solving the 3D wave equation with realistic physics.

Fields

environment: Environment

Environment (temperature, humidity, medium)

medium: MediumProperties

Medium properties derived from environment

cell_size: f32

Cell size (spatial step) in meters (uniform in all dimensions)

time_step: f32

Time step in seconds (computed for numerical stability)

c_squared: f32

Courant number squared (c² = (speed * dt / dx)²)

damping: MultiBandDamping

Multi-band damping coefficients

simple_damping: f32

Simple average damping factor for basic FDTD (0-1)

Implementations

impl AcousticParams3D

pub fn new(environment: Environment, cell_size: f32) -> Self

Create new 3D acoustic parameters from environment settings.

The time step is automatically computed to satisfy the CFL condition for numerical stability in 3D: dt <= dx / (c * sqrt(3))

Arguments

• environment - Environmental conditions (temperature, humidity, medium)
• cell_size - Spatial step size in meters (same for x, y, z)

pub fn for_medium(medium: Medium, cell_size: f32) -> Self

Create parameters for a specific medium at standard conditions.

pub fn set_environment(&mut self, env: Environment)

Update environment and recompute derived parameters.

pub fn set_cell_size(&mut self, size: f32)

Update cell size and recompute parameters.

pub fn courant_number(&self) -> f32

Compute the Courant number (c * dt / dx).

For numerical stability in 3D, this should be <= 1/sqrt(3) ~= 0.577

pub fn is_stable(&self) -> bool

Check if the parameters satisfy the CFL stability condition.

pub fn wavelength(&self, frequency: f32) -> f32

Get the wavelength for a given frequency.

pub fn cells_per_wavelength(&self, frequency: f32) -> f32

Get the number of cells per wavelength for a given frequency.

For accurate simulation, this should be >= 10 (ideally 20+).

pub fn max_accurate_frequency(&self) -> f32

Get recommended maximum frequency for accurate simulation.

Based on the Nyquist-like criterion of ~10 cells per wavelength.

Trait Implementations

impl Clone for AcousticParams3D

fn clone(&self) -> AcousticParams3D

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for AcousticParams3D

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Default for AcousticParams3D

fn default() -> Self

Returns the “default value” for a type.