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
Section titled “standing_wave_absorption”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
Section titled “standing_wave_normalized_impedance”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
Section titled “standing_wave_ratio_from_level”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
Section titled “standing_wave_reflection”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
Section titled “standing_wave_reflection_magnitude”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. |