Skip to content

materials.absorbers.standing_wave

Standing-wave-ratio method for normal-incidence absorption and impedance.

BS EN ISO 10534-1:2001, the probe-traverse method of the impedance tube: a loudspeaker drives one pure tone at a time, a probe microphone traverses the tube and reads the maximum and minimum sound pressure levels of the standing wave the specimen sets up, and the position of the first pressure minimum fixes the phase. The reflection magnitude, phase, absorption coefficient and normalised impedance follow from those two readings alone (Clause 5, Eqs. (12)-(26)).

That is the whole method, and it is why it is one module: it consumes a standing-wave ratio and a distance, and needs neither a measured transfer function nor the complex wavenumber and air properties every broadband reduction in the tube goes through. The quantities are the same normal-incidence quantities the two-microphone method reports ( is Eq. (9) here and Eq. (18) there), measured one frequency at a time; see impedance_tube.

Auto-generated from the source docstrings by scripts/generate_api_docs.py (make api-docs). Do not edit by hand.

standing_wave_absorption(
swr: float | np.floating[Any] | np.integer[Any],
) -> float
standing_wave_absorption(
swr: Sequence[float] | Sequence[np.floating[Any]] | Sequence[np.integer[Any]] | NDArray[np.bool_ | np.integer[Any] | np.floating[Any]],
) -> NDArray[np.float64]
standing_wave_absorption(
swr: NumericArrayLike,
) -> float | NDArray[np.float64]

Absorption coefficient from the standing-wave ratio (ISO 10534-1).

Combining (Eq. (9)) with (Eq. (14)) gives .

Parameters

Name Description
swr Standing-wave ratio s (>= 1).

Returns: Absorption coefficient alpha in [0, 1]. A float for a number, an array for a sequence or an array, a zero-dimensional one included.

Raises

Exception When
TypeError if swr holds a text or a value that is not a real number.
standing_wave_normalized_impedance(
swr: float | np.floating[Any] | np.integer[Any],
first_min_distance: float | np.floating[Any] | np.integer[Any],
*,
wavelength: float | np.floating[Any] | np.integer[Any],
) -> complex
standing_wave_normalized_impedance(
swr: Sequence[float] | Sequence[np.floating[Any]] | Sequence[np.integer[Any]] | NDArray[np.bool_ | np.integer[Any] | np.floating[Any]],
first_min_distance: NumericArrayLike,
*,
wavelength: NumericArrayLike,
) -> NDArray[np.complex128]
standing_wave_normalized_impedance(
swr: float | np.floating[Any] | np.integer[Any],
first_min_distance: Sequence[float] | Sequence[np.floating[Any]] | Sequence[np.integer[Any]] | NDArray[np.bool_ | np.integer[Any] | np.floating[Any]],
*,
wavelength: NumericArrayLike,
) -> NDArray[np.complex128]
standing_wave_normalized_impedance(
swr: float | np.floating[Any] | np.integer[Any],
first_min_distance: float | np.floating[Any] | np.integer[Any],
*,
wavelength: Sequence[float] | Sequence[np.floating[Any]] | Sequence[np.integer[Any]] | NDArray[np.bool_ | np.integer[Any] | np.floating[Any]],
) -> NDArray[np.complex128]
standing_wave_normalized_impedance(
swr: NumericArrayLike,
first_min_distance: NumericArrayLike,
*,
wavelength: NumericArrayLike,
) -> complex | NDArray[np.complex128]

Normalised impedance from the standing wave (ISO 10534-1, Eqs. (24)-(26)).

, split into real and imaginary parts by Eqs. (25)/(26). With (Eq. (14)) and the phase of Eq. (20) put in for and (Eqs. (22), (23)), the two parts read

which is how they are computed: the same numbers, with no to cancel. That difference keeps only the digits leaves it, and none once rounds to 1, past ; a first minimum a quarter wavelength from the face () then gives exactly.

Parameters

Name Description
swr Standing-wave ratio s (>= 1).
first_min_distance Distance x_min1 to the first minimum, in metres.
wavelength Wavelength lambda0, in metres.

Returns: Normalised surface impedance z (complex). A complex when swr, first_min_distance and wavelength are all numbers, an array when one of them is a sequence or an array, a zero-dimensional one included.

Raises

Exception When
TypeError if swr, first_min_distance or wavelength holds a text or a value that is not a real number.
standing_wave_ratio_from_level(
level_difference: float | np.floating[Any] | np.integer[Any],
) -> float
standing_wave_ratio_from_level(
level_difference: Sequence[float] | Sequence[np.floating[Any]] | Sequence[np.integer[Any]] | NDArray[np.bool_ | np.integer[Any] | np.floating[Any]],
) -> NDArray[np.float64]
standing_wave_ratio_from_level(
level_difference: NumericArrayLike,
) -> float | NDArray[np.float64]

Standing-wave ratio from a level difference (ISO 10534-1, Eq. (15)).

with in decibels.

Parameters

Name Description
level_difference Level difference , in dB.

Returns: Standing-wave ratio s (>= 1). A float for a number, an array for a sequence or an array, a zero-dimensional one included.

Raises

Exception When
TypeError if level_difference holds a text or a value that is not a real number.
standing_wave_reflection(
swr: float | np.floating[Any] | np.integer[Any],
first_min_distance: float | np.floating[Any] | np.integer[Any],
*,
wavelength: float | np.floating[Any] | np.integer[Any],
) -> complex
standing_wave_reflection(
swr: Sequence[float] | Sequence[np.floating[Any]] | Sequence[np.integer[Any]] | NDArray[np.bool_ | np.integer[Any] | np.floating[Any]],
first_min_distance: NumericArrayLike,
*,
wavelength: NumericArrayLike,
) -> NDArray[np.complex128]
standing_wave_reflection(
swr: float | np.floating[Any] | np.integer[Any],
first_min_distance: Sequence[float] | Sequence[np.floating[Any]] | Sequence[np.integer[Any]] | NDArray[np.bool_ | np.integer[Any] | np.floating[Any]],
*,
wavelength: NumericArrayLike,
) -> NDArray[np.complex128]
standing_wave_reflection(
swr: float | np.floating[Any] | np.integer[Any],
first_min_distance: float | np.floating[Any] | np.integer[Any],
*,
wavelength: Sequence[float] | Sequence[np.floating[Any]] | Sequence[np.integer[Any]] | NDArray[np.bool_ | np.integer[Any] | np.floating[Any]],
) -> NDArray[np.complex128]
standing_wave_reflection(
swr: NumericArrayLike,
first_min_distance: NumericArrayLike,
*,
wavelength: NumericArrayLike,
) -> complex | NDArray[np.complex128]

Complex reflection factor from the standing wave (ISO 10534-1, Eqs. (17)-(23)).

with (Eq. (14)) and the phase at the first pressure minimum (Eq. (20)).

Parameters

Name Description
swr Standing-wave ratio s (>= 1).
first_min_distance Distance x_min1 from the reference plane to the first pressure minimum (toward the source), in metres.
wavelength Wavelength lambda0, in metres (Eq. (27)).

Returns: Complex reflection factor r. A complex when swr, first_min_distance and wavelength are all numbers, an array when one of them is a sequence or an array, a zero-dimensional one included.

Raises

Exception When
TypeError if first_min_distance or wavelength holds a text or a value that is not a real number.
standing_wave_reflection_magnitude(
swr: float | np.floating[Any] | np.integer[Any],
) -> float
standing_wave_reflection_magnitude(
swr: Sequence[float] | Sequence[np.floating[Any]] | Sequence[np.integer[Any]] | NDArray[np.bool_ | np.integer[Any] | np.floating[Any]],
) -> NDArray[np.float64]
standing_wave_reflection_magnitude(
swr: NumericArrayLike,
) -> float | NDArray[np.float64]

Reflection magnitude from the standing-wave ratio (ISO 10534-1, Eq. (14)).

.

Parameters

Name Description
swr Standing-wave ratio s (>= 1).

Returns: Reflection magnitude |r| in [0, 1]. A float for a number, an array for a sequence or an array, a zero-dimensional one included.

Raises

Exception When
TypeError if swr holds a text or a value that is not a real number.