Skip to content

emission.vibration_sound_power

Airborne sound power from surface vibration (ISO/TS 7849-1/-2:2009).

The airborne sound power a machine radiates through the structure-borne vibration of its outer surface is estimated from the surface vibratory velocity and a radiation factor epsilon (the radiation efficiency). The radiated power, in watts, is (ISO/TS 7849-1, Equation 6):

with the characteristic impedance of air and the mean-square vibratory velocity averaged over the radiating area . The vibratory velocity is reported as a level, in decibels, re m/s (Equation 3):

so the A-weighted sound power level follows in logarithmic form, in decibels (ISO/TS 7849-1, Equation 12; ISO/TS 7849-2, Equation 15):

where , the normalized characteristic impedance (at 23 degC, 101.3 kPa) and the reference acoustic impedance give the fixed dB term.

The two parts differ only in epsilon:

  • Part 1 (survey) assumes and yields the upper limit L_W,max of the radiated power, needing only and S.
  • Part 2 (engineering) applies a frequency-band radiation factor epsilon_j determined (per ISO 9614) as (Equation 8).

This module feeds the structure-borne source characterisation standards (ISO 9611, EN 15657, EN 12354-5).

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

extraneous_velocity_correction(level_difference: float) -> float

Correction K1A for extraneous vibration (ISO/TS 7849-1, Table 2).

is the difference between the operating and the extraneous vibratory velocity levels. The correction is subtracted from the measured level; per the standard dB gives 0 dB, and dB uses the 3 dB value (the result is then an upper boundary). The level difference is rounded to the nearest integer decibel to index the standard’s table.

Parameters

Name Description
level_difference Level difference , in dB.

Returns: The correction K1A to subtract, in dB.

Raises

Exception When
TypeError if level_difference is not a single number.
mean_velocity_level(
levels: NumericArrayLike,
areas: NumericArrayLike | None = None,
) -> float

Mean vibratory velocity level over the surface (ISO/TS 7849-1, Eq. 10/11).

With uniformly distributed positions (areas is None) this is the energetic average (Equation 10); with per-position partial areas it is the area-weighted average (Equation 11).

Parameters

Name Description
levels Velocity levels L_v,i at the positions, in dB.
areas Partial areas S_i (Equation 11), or None for the uniform energetic average (Equation 10).

Returns: The mean velocity level, in dB.

Raises

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

Constant (float).

NORMALIZED_IMPEDANCE_PA_S_M = 411.0
radiated_sound_power_level(
velocity_level: float | np.floating[Any] | np.integer[Any],
area: float,
*,
radiation_factor: float | np.floating[Any] | np.integer[Any] = ...,
reference_area: float = ...,
normalized_impedance: float = ...,
reference_impedance: float = ...,
) -> float
radiated_sound_power_level(
velocity_level: Sequence[float] | Sequence[np.floating[Any]] | Sequence[np.integer[Any]] | NDArray[np.bool_ | np.integer[Any] | np.floating[Any]],
area: float,
*,
radiation_factor: NumericArrayLike = ...,
reference_area: float = ...,
normalized_impedance: float = ...,
reference_impedance: float = ...,
) -> NDArray[np.float64]
radiated_sound_power_level(
velocity_level: float | np.floating[Any] | np.integer[Any],
area: float,
*,
radiation_factor: Sequence[float] | Sequence[np.floating[Any]] | Sequence[np.integer[Any]] | NDArray[np.bool_ | np.integer[Any] | np.floating[Any]],
reference_area: float = ...,
normalized_impedance: float = ...,
reference_impedance: float = ...,
) -> NDArray[np.float64]
radiated_sound_power_level(
velocity_level: NumericArrayLike,
area: float,
*,
radiation_factor: NumericArrayLike = ...,
reference_area: float = ...,
normalized_impedance: float = ...,
reference_impedance: float = ...,
) -> float | NDArray[np.float64]

Radiated sound power level (ISO/TS 7849-1 Eq. 12, -2 Eq. 15).

With the default radiation_factor = 1 this is the Part 1 upper limit L_W,max; pass a measured epsilon for the Part 2 engineering value.

Parameters

Name Description
velocity_level Mean vibratory velocity level L_v (scalar or array, e.g. per band), in dB re 5e-8 m/s.
area Radiating surface area S, in m^2 (> 0).
radiation_factor Radiation factor epsilon (Default: 1.0).
reference_area Reference area S0 (Default: 1 m^2).
normalized_impedance Z_c,n (Default: 411 N.s/m^3).
reference_impedance Z_c,0 (Default: 400 N.s/m^3).

Returns: The sound power level L_W, in dB re 1 pW. A float when velocity_level and radiation_factor are both numbers, an array when either is a sequence or an array, a zero-dimensional one included.

Raises

Exception When
ValueError for a non-positive area, reference area or impedance.
TypeError if area, normalized_impedance, reference_area or reference_impedance is not a single number, or radiation_factor or velocity_level holds a text or a value that is not a real number.
radiation_factor(
sound_power: float | np.floating[Any] | np.integer[Any],
area: float,
mean_square_velocity: float | np.floating[Any] | np.integer[Any],
*,
impedance: float = ...,
) -> float
radiation_factor(
sound_power: Sequence[float] | Sequence[np.floating[Any]] | Sequence[np.integer[Any]] | NDArray[np.bool_ | np.integer[Any] | np.floating[Any]],
area: float,
mean_square_velocity: NumericArrayLike,
*,
impedance: float = ...,
) -> NDArray[np.float64]
radiation_factor(
sound_power: float | np.floating[Any] | np.integer[Any],
area: float,
mean_square_velocity: Sequence[float] | Sequence[np.floating[Any]] | Sequence[np.integer[Any]] | NDArray[np.bool_ | np.integer[Any] | np.floating[Any]],
*,
impedance: float = ...,
) -> NDArray[np.float64]
radiation_factor(
sound_power: NumericArrayLike,
area: float,
mean_square_velocity: NumericArrayLike,
*,
impedance: float = ...,
) -> float | NDArray[np.float64]

A-weighted radiation factor epsilon (ISO/TS 7849-1 Eq. 4, -2 Eq. 8).

, the sound-radiation efficiency, from an independently measured radiated power (ISO 9614), the surface area and the mean-square vibratory velocity.

Parameters

Name Description
sound_power Radiated airborne sound power P (scalar or array), in W.
area Radiating surface area S, in m^2 (> 0).
mean_square_velocity Mean-square vibratory velocity , in (m/s)^2.
impedance Characteristic impedance Z_c (Default: 411 N.s/m^3).

Returns: The radiation factor epsilon (dimensionless). A float when sound_power and mean_square_velocity are both numbers, an array when either is a sequence or an array, a zero-dimensional one included.

Raises

Exception When
ValueError for a non-positive area or impedance.
TypeError if area or impedance is not a single number, or mean_square_velocity or sound_power holds a text or a value that is not a real number.

Constant (float).

REFERENCE_VELOCITY_M_S = 5e-08
sound_power_from_vibration(
velocity_level: NumericArrayLike,
area: float,
*,
radiation_factor: NumericArrayLike = 1.0,
frequencies: NumericArrayLike | None = None,
) -> VibrationSoundPowerResult

Bundle a sound-power-from-vibration determination (ISO/TS 7849).

Parameters

Name Description
velocity_level Mean vibratory velocity level L_v (per band), dB.
area Radiating surface area S, in m^2 (> 0).
radiation_factor Radiation factor epsilon (Default: 1.0 -> the Part 1 upper limit); scalar or per band.
frequencies Band centre frequencies, in hertz, or None.

Returns: The VibrationSoundPowerResult.

Raises

Exception When
TypeError if frequencies, radiation_factor or velocity_level holds a text or a value that is not a real number.
velocity_level(
velocity: float | np.floating[Any] | np.integer[Any],
*,
reference: float = ...,
) -> float
velocity_level(
velocity: Sequence[float] | Sequence[np.floating[Any]] | Sequence[np.integer[Any]] | NDArray[np.bool_ | np.integer[Any] | np.floating[Any]],
*,
reference: float = ...,
) -> NDArray[np.float64]
velocity_level(
velocity: NumericArrayLike,
*,
reference: float = ...,
) -> float | NDArray[np.float64]

Vibratory velocity level (ISO/TS 7849-1, Eq. 3).

with v0 the reference velocity.

Parameters

Name Description
velocity R.m.s. vibratory velocity v (scalar or array), in m/s.
reference Reference velocity v0 (Default: 5e-8 m/s).

Returns: The velocity level L_v, in dB re v0. A float for a number, an array for a sequence or an array, a zero-dimensional one included.

Raises

Exception When
ValueError for a non-positive reference.
TypeError if reference is not a single number, or velocity holds a text or a value that is not a real number.
velocity_level_from_acceleration(
peak_acceleration: float | np.floating[Any] | np.integer[Any],
*,
frequency: float | np.floating[Any] | np.integer[Any],
reference: float = ...,
) -> float
velocity_level_from_acceleration(
peak_acceleration: Sequence[float] | Sequence[np.floating[Any]] | Sequence[np.integer[Any]] | NDArray[np.bool_ | np.integer[Any] | np.floating[Any]],
*,
frequency: NumericArrayLike,
reference: float = ...,
) -> NDArray[np.float64]
velocity_level_from_acceleration(
peak_acceleration: float | np.floating[Any] | np.integer[Any],
*,
frequency: Sequence[float] | Sequence[np.floating[Any]] | Sequence[np.integer[Any]] | NDArray[np.bool_ | np.integer[Any] | np.floating[Any]],
reference: float = ...,
) -> NDArray[np.float64]
velocity_level_from_acceleration(
peak_acceleration: NumericArrayLike,
*,
frequency: NumericArrayLike,
reference: float = ...,
) -> float | NDArray[np.float64]

Velocity level from a sinusoidal acceleration (ISO/TS 7849-1, Eq. 8).

, used to convert a calibration acceleration to the equivalent r.m.s. velocity level.

Parameters

Name Description
peak_acceleration Peak acceleration a_peak (scalar or array), in m/s^2.
frequency Frequency f, in hertz (scalar or array).
reference Reference velocity v0 (Default: 5e-8 m/s).

Returns: The velocity level L_v, in dB re v0. A float when peak_acceleration and frequency are both numbers, an array when either is a sequence or an array, a zero-dimensional one included.

Raises

Exception When
ValueError for a non-positive frequency or reference.
TypeError if reference is not a single number, or frequency or peak_acceleration holds a text or a value that is not a real number.
VibrationSoundPowerResult(
velocity_level: NDArray[np.float64],
sound_power_level: NDArray[np.float64],
radiation_factor: NDArray[np.float64],
area: float,
frequencies: NDArray[np.float64] | None = None,
)

Sound power radiated by surface vibration (ISO/TS 7849).

Attributes

Name Description
frequencies Band centre frequencies, in hertz, or None for a single broadband value.
velocity_level Mean vibratory velocity level L_v per band, in dB.
sound_power_level Radiated sound power level L_W per band, in dB.
radiation_factor Radiation factor epsilon per band.
area Radiating surface area S, in m^2.
VibrationSoundPowerResult.plot(
ax: Axes | None = None,
*,
language: Literal['en', 'es'] = 'en',
**kwargs: Any,
) -> Axes

Plot the radiated sound power level per band.

Requires matplotlib (the [plot] extra); returns the Axes.

Parameters

Name Description
language The language of the labels: "en" or "es".
VibrationSoundPowerResult.report(
path: str | os.PathLike[str],
*,
metadata: ReportMetadata | None = None,
engine: Literal['reportlab'] = 'reportlab',
verbose: bool = False,
language: Literal['en', 'es'] = 'en',
) -> str

Render an ISO/TS 7849 sound-power-from-vibration determination fiche.

Writes a one-page sound-power test sheet: the standard-basis line naming the vibration method (the ISO/TS 7849-1 survey method with a fixed radiation factor when every band uses epsilon = 1, otherwise the ISO/TS 7849-2 engineering method with a determined radiation factor), an optional metadata header (client, machine/source, test environment, instrumentation, climate, date), a per-band table (nominal octave/one-third-octave frequency, the surface vibratory velocity level Lv and the radiated band sound-power level LW), the sound-power spectrum LW(f) with a nominal band axis, the boxed A-weighted sound power level LWA (dB re 1 pW) with the total LW, the radiating area S and the applied method, an optional verdict row against a declared limit, and a measurement-basis strip stating the sound-power relation .

Parameters

Name Description
path Destination path of the PDF file.
metadata Optional ReportMetadata supplying the header (client, specimen the machine/source, test_room the test environment, instrumentation, temperature_c, relative_humidity_percent, pressure, test_date), the footer identity (laboratory, operator, report_id, notes) and, via requirement, a declared A-weighted sound-power limit the fiche checks the result against (lower is better). The radiating area S comes from the result itself.
engine Rendering back end; only "reportlab" is supported.
verbose When True the per-band table adds the radiation factor epsilon column.
language Fiche language: "en" (default) or "es".

Returns: The written path as a str.

Raises

Exception When
ValueError If engine is not "reportlab" or language is unknown.
ImportError If reportlab (or, for the figure, matplotlib) is not installed (the [report] extra).

VibrationSoundPowerResult.sound_power_level_a

Section titled “VibrationSoundPowerResult.sound_power_level_a”

property

A-weighted sound power level L_WA, in dB re 1 pW.

Combines the band levels with the A-weighting band corrections of ISO 3744:2010 Annex E (the standard tabulation reused by the vibration method) when band centre frequencies are known. Without band frequencies the result is an unweighted broadband level that cannot be A-weighted, so L_WA is undefined and nan is returned (the report then boxes the unweighted total L_W instead of an L_WA claim, and no A-weighted verdict is drawn).

property

Band-summed sound power level, in dB: .