Module simulation 

3D acoustic wave simulation module.

Provides:

• Physics parameters with realistic acoustic modeling
• 3D FDTD simulation grid (CPU and GPU backends)
• GPU-accelerated stencil operations
• Actor-based GPU simulation (cell-as-actor paradigm)

Computation Methods

The simulation supports two GPU computation methods:

Stencil Method (Default)

Traditional GPU stencil computation where each thread reads neighbor values from shared memory. Fast and efficient for regular grids.

Actor Method

Novel cell-as-actor paradigm where each spatial cell is an independent actor. Actors communicate via message passing (halo exchange) instead of shared memory. Uses HLC (Hybrid Logical Clocks) for temporal alignment.

use ringkernel_wavesim3d::simulation::{ComputationMethod, SimulationConfig};

let config = SimulationConfig::default()
    .with_computation_method(ComputationMethod::Actor);
let engine = config.build();

Re-exports

pub use grid3d::CellType;

pub use grid3d::GridParams;

pub use grid3d::SimulationGrid3D;

pub use physics::AcousticParams3D;

pub use physics::AtmosphericAbsorption;

pub use physics::Environment;

pub use physics::Medium;

pub use physics::MediumProperties;

pub use physics::MultiBandDamping;

pub use physics::Orientation3D;

pub use physics::Position3D;

Modules

grid3d

3D FDTD simulation grid for acoustic wave propagation.

physics

Realistic 3D acoustic physics simulation parameters.

Structs

SimulationConfig

Configuration for creating a simulation.

SimulationEngine

Simulation engine that manages grid updates and GPU/CPU dispatch.

Enums

ComputationMethod

Computation method for GPU-accelerated simulation.