emission.vibration_sound_power
La referencia de la API se publica en inglés en los dos idiomas: se genera a partir de los docstrings del código, que son su texto original.
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,maxof the radiated power, needing only andS. - Part 2 (engineering) applies a frequency-band radiation factor
epsilon_jdetermined (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
Section titled “extraneous_velocity_correction”extraneous_velocity_correction(level_difference: float) -> floatCorrection 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
Section titled “mean_velocity_level”mean_velocity_level( levels: NumericArrayLike, areas: NumericArrayLike | None = None,) -> floatMean 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. |
NORMALIZED_IMPEDANCE_PA_S_M
Section titled “NORMALIZED_IMPEDANCE_PA_S_M”Constant (float).
NORMALIZED_IMPEDANCE_PA_S_M = 411.0radiated_sound_power_level
Section titled “radiated_sound_power_level”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
Section titled “radiation_factor”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. |
REFERENCE_VELOCITY_M_S
Section titled “REFERENCE_VELOCITY_M_S”Constant (float).
REFERENCE_VELOCITY_M_S = 5e-08sound_power_from_vibration
Section titled “sound_power_from_vibration”sound_power_from_vibration( velocity_level: NumericArrayLike, area: float, *, radiation_factor: NumericArrayLike = 1.0, frequencies: NumericArrayLike | None = None,) -> VibrationSoundPowerResultBundle 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
Section titled “velocity_level”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
Section titled “velocity_level_from_acceleration”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
Section titled “VibrationSoundPowerResult”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()
Section titled “VibrationSoundPowerResult.plot()”VibrationSoundPowerResult.plot( ax: Axes | None = None, *, language: Literal['en', 'es'] = 'en', **kwargs: Any,) -> AxesPlot 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()
Section titled “VibrationSoundPowerResult.report()”VibrationSoundPowerResult.report( path: str | os.PathLike[str], *, metadata: ReportMetadata | None = None, engine: Literal['reportlab'] = 'reportlab', verbose: bool = False, language: Literal['en', 'es'] = 'en',) -> strRender 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).
VibrationSoundPowerResult.total_level
Section titled “VibrationSoundPowerResult.total_level”property
Band-summed sound power level, in dB: .