aspcol.planewaves

Module for working with plane waves and plane wave models.

The plane wave is defined as $e^{-ik(r-r_c)^T d}$ where r is the position, d is the direction of the plane wave. and r_c is the expansion center (the point around which the directions are calculated).

Using the time-harmonic convention of $exp(-iwt)$, the plane wave is defined as $exp(ikr^T d)$ where d is the plane wave propagation direction [martinMultiple2006]. Therefore the direction provided is the direction from which the plane wave is incoming.

References

[martinScattering2006] P. A. Martin, Multiple scattering: Interaction of time-harmonic waves with N obstacles, vol. 107. in Encyclopedia of mathematics and its applications, vol. 107. Cambridge, UK: Cambridge University Press, 2006.

Functions

apply_measurement(pw_coeffs, dir_func, rng, ...)

Returns the signal that a microphone with directionality given by dir_func would record.

find_matching_plane_wave(plane_wave_data, ...)

Matches a plane wave to the given data

linear_directivity_function(A, d_mic)

Omni directivity is obtained by setting A = 0 Cardoid directivity is obtained by setting A = 1/2 Figure-8 directivity is obtained by setting A = 1

omni_directivity_function()

plane_wave(pos, direction, wave_num[, ...])

The complex response of a plane wave for a specific frequency for a set of positions.

plane_wave_integral(dir_func, pos, ...)

Computes the integral of a function multiplied with a plane wave over a sphere.

shd_coeffs_for_planewave(pw_direction, max_order)

Spherical harmonic coefficients for a plane wave exp(-ikr^T d) where r is the position and d is the direction of the plane wave.