Ir al contenido

emission.sound_power_high_frequency

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.

Sound power levels in the 16 kHz octave band: ISO 9295:2015.

Some machines emit most of what matters above the range the general methods cover: the paper noise of a fast printer, the whine of a switched-mode power supply, the tone of a display. ISO 3741 stops at the 10 kHz one-third octave band and ISO 3744 at the same place, so ISO 9295 adds the octave band centred on 16 kHz, from 11.2 kHz to 22.4 kHz (clause 1), and determines the unweighted sound power level in its three one-third octave bands (12.5, 16 and 20 kHz) or in the narrow bands that hold its discrete tones.

Four methods are specified. Three of them use a reverberation test room with a microphone on a rotating boom, pointing upwards so that the equipment is heard at grazing incidence (clauses 5.4 and 5.5), and one uses a hemi-anechoic room (clause 9).

Mean level. The time-averaged band level over the four orientations of the equipment (), or over three revolutions of the boom (), is the energy mean of Formula (1):

A moving microphone spreads a discrete tone over sidebands. The analyser has to be at least as wide as Formula (2), with the speed of the microphone and the speed of sound; with a narrower FFT the sidebands are summed on an energy basis, Formula (3):

Method with the measured reverberation time (clause 6). Above 10 kHz the room absorption coefficient cannot be taken as small, so the Eyring relation gives it from the measured reverberation time , and the room constant follows from it ( the total room surface, its volume):

The sound power level in each band is then Formula (6):

Method with the calculated air absorption (clause 7). At 10 kHz and above practically all of the absorption of a reverberation room is in the air, so the room constant comes from the air absorption coefficient in nepers per metre, Formula (7), and Formula (6) is applied unchanged:

is Annex A (normative), which is ISO 9613-1 written in nepers rather than decibels and evaluated up to 22.4 kHz, where ISO 9613-1 stops at 10 kHz; air_absorption_np_per_m evaluates it with the library’s ISO 9613-1 implementation. Tables 1 and 2 print it for 18 °C to 27 °C, 40 % to 60 % relative humidity and 10 000 Hz to 22 400 Hz.

Method with a reference sound source (clause 8). The source under test and a calibrated reference source are measured in turn with the same bandwidth. For broadband noise the band level is Formula (8); for discrete tones the reference source is calibrated as a power spectral density, per unit bandwidth, and the noise bandwidth of the constant bandwidth analyser puts it back into the band, Formula (9):

Method with a free field over a reflecting plane (clause 9) is ISO 3744 (sound_power_pressure) with the three one-third octave bands of the 16 kHz octave; beyond a measurement radius of 2 m the surface level takes the absorption correction of Formula (10), with in decibels per metre:

Reference meteorological conditions. Clause 10.1 carries the levels of the reverberation-room methods to 101.325 kPa and 23.0 °C “de acuerdo con la Norma ISO 3741”, which is the reference-quantity correction and the radiation-impedance correction of ISO 3741:2010 clause 9.1.4 for a direct method and alone for the comparison with a reference source, exactly as ISO 3741 Formulae (20) and (21) apply them.

What to determine. Table 3 says which sound power levels a report carries for each type of noise, in the octave bands from 125 Hz to 8 kHz and in the 16 kHz octave: high_frequency_levels_to_determine reads it.

Formulae (4) to (10) carry no worked example in the standard and are pinned in closed form; Tables 1 and 2 are the numeric oracle of Annex A.

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

air_absorption_np_per_m(
frequencies: float | np.floating[Any] | np.integer[Any],
*,
temperature_c: float,
relative_humidity_percent: float,
static_pressure_kpa: float = ...,
) -> float
air_absorption_np_per_m(
frequencies: Sequence[float] | Sequence[np.floating[Any]] | Sequence[np.integer[Any]] | NDArray[np.bool_ | np.integer[Any] | np.floating[Any]],
*,
temperature_c: float,
relative_humidity_percent: float,
static_pressure_kpa: float = ...,
) -> NDArray[np.float64]
air_absorption_np_per_m(
frequencies: NumericArrayLike,
*,
temperature_c: float,
relative_humidity_percent: float,
static_pressure_kpa: float = ...,
) -> float | NDArray[np.float64]

Air absorption coefficient in nepers per metre (ISO 9295 Annex A).

Formulae (A.1) to (A.5) of ISO 9295:2015 are the ISO 9613-1:1993 pure-tone attenuation written for the amplitude in nepers per metre, the unit Formula (7) takes, so this is the library’s ISO 9613-1 evaluation without its factor 8.686 (Annex A: “multiplicando el valor de en Np/m por 8,686 para obtener el valor de en dB/m”). The difference from air_attenuation is the range: Annex A evaluates the same formula up to 22.4 kHz, the top of the 16 kHz octave band, so no advisory is raised between 10 kHz and 22.4 kHz, where ISO 9613-1 stops tabulating.

Parameters

Name Description
frequencies Frequency or frequencies f, in hertz.
temperature_c Air temperature, in degrees Celsius. Outside -20 °C to +50 °C emits an AtmosphericAbsorptionWarning.
relative_humidity_percent Relative humidity h_r, in percent.
static_pressure_kpa Static pressure p_s, in kilopascals (default 101.325 kPa, the pressure Tables 1 and 2 are printed at).

Returns: in Np/m, with the shape of frequencies. 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 frequency, a temperature at or below absolute zero, a relative humidity outside [0, 100] % or a non-positive static pressure.
TypeError if frequencies holds a text or a value that is not a real number.
free_field_absorption_correction(
frequencies: float | np.floating[Any] | np.integer[Any],
*,
radius: float,
temperature_c: float,
relative_humidity_percent: float,
static_pressure_kpa: float = ...,
) -> float
free_field_absorption_correction(
frequencies: Sequence[float] | Sequence[np.floating[Any]] | Sequence[np.integer[Any]] | NDArray[np.bool_ | np.integer[Any] | np.floating[Any]],
*,
radius: float,
temperature_c: float,
relative_humidity_percent: float,
static_pressure_kpa: float = ...,
) -> NDArray[np.float64]
free_field_absorption_correction(
frequencies: NumericArrayLike,
*,
radius: float,
temperature_c: float,
relative_humidity_percent: float,
static_pressure_kpa: float = ...,
) -> float | NDArray[np.float64]

Air absorption correction of the free-field method (ISO 9295 Formula (10)).

, with the air absorption in decibels per metre (Annex A times 8.686). Clause 9.8 adds it to the surface sound pressure level of ISO 3744 before the sound power is determined, and only when the measurement radius exceeds 2 m; at 2 m or less the clause asks for no correction and this returns zero. The surface level and the sound power level differ by the constant , so adding to the band levels sound_power_pressure returns is the same thing.

Parameters

Name Description
frequencies Band centre or tone frequencies, in hertz.
radius Radius r of the measurement hemisphere, in metres.
temperature_c Air temperature, in degrees Celsius.
relative_humidity_percent Relative humidity, in percent.
static_pressure_kpa Static pressure, in kilopascals (default 101.325 kPa).

Returns: per frequency, in decibels. 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 radius or the atmospheric inputs air_absorption_np_per_m refuses.
TypeError if radius is not a single number.
high_frequency_levels_to_determine(
*,
noise_125_hz_to_8_khz: Literal['broadband', 'narrowband', 'none'],
noise_16_khz_octave: Literal['none', 'broadband', 'discrete_tone', 'multiple_tones'],
) -> tuple[str, ...]

The sound power levels to determine for a type of noise (ISO 9295 Table 3).

Table 3 of ISO 9295:2015 pairs the noise of the equipment in the octave bands from 125 Hz to 8 kHz with its noise in the 16 kHz octave band and says what the determination has to give. The answer is a tuple of these identifiers, in the order the table names them:

  • "a_weighted_sound_power_level": the A-weighted sound power level from the octave bands of 125 Hz to 8 kHz, by ISO 3741 or ISO 3744 as appropriate (footnote a lets the one-third-octave and octave band levels of that range be given as well);
  • "one_third_octave_band_levels": the sound power level in each one-third octave band of the 16 kHz octave, by this standard (high_frequency_sound_power or high_frequency_sound_power_comparison);
  • "tone_level_and_frequency": the level and the frequency of the discrete tone in the 16 kHz octave;
  • "tone_levels_within_10_db": the levels and frequencies of every tone in the 16 kHz octave within 10 dB of the highest tonal level, the tones HighFrequencySoundPowerResult.within_10_db_of_max marks.

With no significant noise from 125 Hz to 8 kHz, footnote b notes that the noise lies outside the scope of ISO 3741 and ISO 3744, so only this standard applies and no A-weighted level is asked for.

Parameters

Name Description
noise_125_hz_to_8_khz The noise in the octave bands from 125 Hz to 8 kHz: "broadband" or "narrowband" (one row of the table), or "none" for no significant noise.
noise_16_khz_octave The noise in the 16 kHz octave band: "none", "broadband", "discrete_tone" or "multiple_tones".

Returns: The identifiers of the levels to determine.

Raises

Exception When
ValueError for a noise type the table does not name, or for a combination it has no row for: no significant noise in either range, or broadband noise in the 16 kHz octave with none below it.
TypeError if noise_125_hz_to_8_khz or noise_16_khz_octave is not a text.
high_frequency_sound_power(
pressure_levels: NumericArrayLike,
*,
frequencies: NumericArrayLike,
room_constant: NumericArrayLike,
temperature_c: float = 23.0,
static_pressure_kpa: float = 101.325,
tonal: bool = False,
) -> HighFrequencySoundPowerResult

Sound power level in the 16 kHz octave band, direct method (ISO 9295 Formula (6)).

per band: Formula (6), carried to the reference meteorological conditions by the and of ISO 3741:2010 clause 9.1.4, which clause 10.1 points to. The same formula serves both direct methods; only the room constant differs, from the measured reverberation time (room_constant_from_reverberation_time, clause 6) or from the calculated air absorption (room_constant_from_air_absorption, clause 7).

Parameters

Name Description
pressure_levels per band, in dB re 20 µPa, or an (N, bands) array of the time-averaged levels of the four orientations () or three boom revolutions (), energy-averaged by Formula (1).
frequencies Band centre or tone frequencies, in hertz, one per band. A frequency outside 11.2 kHz to 22.4 kHz emits a SoundPowerWarning.
room_constant Room constant R, in square metres, a scalar or one value per band.
temperature_c Air temperature in the room, in degrees Celsius (default 23.0 °C, the reference temperature).
static_pressure_kpa Static pressure in the room, in kilopascals (default 101.325 kPa, the reference pressure).
tonal True when the bands are the narrow bands of discrete tones (clause 6.5), which changes how the result is drawn and read.

Returns: A HighFrequencySoundPowerResult with method='direct'.

Raises

Exception When
ValueError for non-finite levels, a room constant that is not positive, frequencies that do not match the bands, or a temperature or static pressure ISO 3741 cannot correct from.
TypeError if frequencies, pressure_levels or room_constant holds a text or a value that is not a real number.
high_frequency_sound_power_comparison(
pressure_levels: NumericArrayLike,
*,
frequencies: NumericArrayLike,
reference_pressure_levels: NumericArrayLike,
reference_sound_power_levels: NumericArrayLike | ReferenceSourceCalibration,
noise_bandwidth_hz: float | None = None,
temperature_c: float = 23.0,
static_pressure_kpa: float = 101.325,
) -> HighFrequencySoundPowerResult

Sound power level in the 16 kHz octave band against a reference source (ISO 9295 clause 8).

For broadband noise, Formula (8): , per one-third octave band. For discrete tones, Formula (9) adds , because the reference source is then calibrated per unit bandwidth (clause 8.1) and is the noise bandwidth of the constant bandwidth analyser. Clause 10.1 adds the radiation-impedance correction of ISO 3741, as ISO 3741 Formula (21) does for its own comparison method.

Parameters

Name Description
pressure_levels per band, in dB re 20 µPa, or an (N, bands) array averaged by Formula (1).
frequencies Band centre or tone frequencies, in hertz, one per band.
reference_pressure_levels per band, in dB re 20 µPa, measured with the same bandwidth at the same location (clauses 8.3, 8.4); a 2-D input is averaged by Formula (1) as well.
reference_sound_power_levels of the calibrated reference source, in dB re 1 pW, a scalar or one value per band: per band for broadband noise, per hertz for tones. For broadband noise it may be the ReferenceSourceCalibration of ISO 6926, read in the one-third octave bands at frequencies and carried from the reference conditions to those of the test by its own C2, since clause 10.1 corrects the result as ISO 3741 does.
noise_bandwidth_hz , the noise bandwidth of the analyser, in hertz, which selects Formula (9); None (default) selects Formula (8). Clause 8.5.2 allows 1 Hz for a constant percentage analyser, and holds an FFT to 112 Hz or less: a wider one emits a SoundPowerWarning.
temperature_c Air temperature in the room, in degrees Celsius (default 23.0 °C).
static_pressure_kpa Static pressure in the room, in kilopascals (default 101.325 kPa).

Returns: A HighFrequencySoundPowerResult with method='comparison', tonal set when noise_bandwidth_hz is given.

Raises

Exception When
TypeError for a band calibration given as the reference when noise_bandwidth_hz asks for a tonal comparison, which needs levels, a noise_bandwidth_hz that is not one number, or frequencies that hold a text or a value that is not a number, or pressure_levels or reference_pressure_levels holds a text or a value that is not a real number.
ValueError for non-finite levels, reference levels that do not span the same bands, a non-positive bandwidth, or a temperature or static pressure ISO 3741 cannot correct from.
HighFrequencySoundPowerResult(
frequencies: NDArray[np.float64],
sound_power_level: NDArray[np.float64],
mean_pressure_level: NDArray[np.float64],
room_constant: NDArray[np.float64] | None,
reference_sound_power_level: NDArray[np.float64] | None,
reference_pressure_level: NDArray[np.float64] | None,
noise_bandwidth_hz: float | None,
c1: float,
c2: float,
method: Literal['direct', 'comparison'],
tonal: bool,
)

A sound power determination in the 16 kHz octave band (ISO 9295:2015).

One value per band: a one-third octave band of the 16 kHz octave for broadband noise, or the narrow band of a discrete tone.

Attributes

Name Description
frequencies Band centre or tone frequencies, in hertz.
sound_power_level per band, in dB re 1 pW, at the reference meteorological conditions of clause 10.1 (Formula (6) plus c1 and c2 for the direct method, Formula (8) or (9) plus c2 for the comparison).
mean_pressure_level per band, in dB re 20 µPa, the energy mean of Formula (1) over the orientations or revolutions supplied.
room_constant The room constant R per band, in square metres, for the direct method (Formula (4) or (7)); None for the comparison.
reference_sound_power_level per band, in dB re 1 pW (per hertz for the tonal comparison); None for the direct method.
reference_pressure_level per band, in dB re 20 µPa; None for the direct method.
noise_bandwidth_hz of Formula (9), in hertz, for the tonal comparison; None otherwise.
c1 Reference-quantity correction C1 of ISO 3741, in dB, for the direct method; NaN for the comparison, which does not apply it.
c2 Radiation-impedance correction C2 of ISO 3741, in dB.
method 'direct' (clauses 6 and 7) or 'comparison' (clause 8).
tonal True when the bands are the narrow bands of discrete tones rather than one-third octave bands of broadband noise.
HighFrequencySoundPowerResult.plot(
ax: Axes | None = None,
*,
language: Literal['en', 'es'] = 'en',
**kwargs: Any,
) -> Axes

Plot the band levels, with the mean room level they came from.

Broadband bands are drawn as bars over the one-third octave bands; a tonal determination is drawn as one stem per tone on a frequency axis, with the line 10 dB below the highest tone that clause 13 c) reports down to. Requires matplotlib (the [plot] extra); returns the Axes.

Parameters

Name Description
ax Existing axes, or None to create a figure.
language "en" (default) or "es".
kwargs Forwarded to the bar or stem drawing of .

Returns: The axes.

HighFrequencySoundPowerResult.within_10_db_of_max

Section titled “HighFrequencySoundPowerResult.within_10_db_of_max”

property

Bands whose level is within 10 dB of the highest one.

Clause 13 c) and Table 3 ask for the level and the frequency of every tone that lies within 10 dB of the highest tonal level in the band, so for a tonal determination this marks the tones the report has to carry.

min_analyzer_bandwidth(
tone_frequency_hz: float | np.floating[Any] | np.integer[Any],
*,
microphone_speed_m_s: float,
speed_of_sound: float,
) -> float
min_analyzer_bandwidth(
tone_frequency_hz: Sequence[float] | Sequence[np.floating[Any]] | Sequence[np.integer[Any]] | NDArray[np.bool_ | np.integer[Any] | np.floating[Any]],
*,
microphone_speed_m_s: float,
speed_of_sound: float,
) -> NDArray[np.float64]
min_analyzer_bandwidth(
tone_frequency_hz: NumericArrayLike,
*,
microphone_speed_m_s: float,
speed_of_sound: float,
) -> float | NDArray[np.float64]

Narrowest analyser bandwidth that holds a tone seen by a moving microphone.

, ISO 9295:2015 Formula (2). The moving microphone spreads the energy of a discrete tone over sidebands either side of its frequency, and an analyser at least this wide collects the whole tone in one band; a narrower one (an FFT) needs its sidebands summed with tone_level_from_sidebands.

Parameters

Name Description
tone_frequency_hz Centre frequency f of the tone, in hertz.
microphone_speed_m_s Speed v of the microphone along its path, in metres per second.
speed_of_sound Speed of sound c, in metres per second.

Returns: The minimum bandwidth , in hertz. 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 or non-finite input.
TypeError if microphone_speed_m_s or speed_of_sound is not a single number, or tone_frequency_hz holds a text or a value that is not a real number.
room_absorption_coefficient(
reverberation_time: float | np.floating[Any] | np.integer[Any],
*,
volume: float,
surface_area: float,
) -> float
room_absorption_coefficient(
reverberation_time: Sequence[float] | Sequence[np.floating[Any]] | Sequence[np.integer[Any]] | NDArray[np.bool_ | np.integer[Any] | np.floating[Any]],
*,
volume: float,
surface_area: float,
) -> NDArray[np.float64]
room_absorption_coefficient(
reverberation_time: NumericArrayLike,
*,
volume: float,
surface_area: float,
) -> float | NDArray[np.float64]

Room absorption coefficient from the reverberation time (ISO 9295 Formula (5)).

, the Eyring relation solved for the absorption coefficient. Clause 6.1 asks for it rather than the simpler Sabine one because above 10 kHz the room absorption coefficient cannot be taken as small compared with unity. The constant is the 0.16 the formula prints.

Parameters

Name Description
reverberation_time Mean measured reverberation time T per band, in seconds (scalar or one value per band); clause 6.2 averages three or four points of the microphone path.
volume Room volume V, in cubic metres.
surface_area Total room surface S, in square metres.

Returns: per band, in (0, 1). 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 or non-finite time, volume or surface.
TypeError if surface_area or volume is not a single number, or reverberation_time holds a text or a value that is not a real number.
room_constant_from_air_absorption(
frequencies: float | np.floating[Any] | np.integer[Any],
*,
volume: float,
surface_area: float,
temperature_c: float,
relative_humidity_percent: float,
static_pressure_kpa: float = ...,
) -> float
room_constant_from_air_absorption(
frequencies: Sequence[float] | Sequence[np.floating[Any]] | Sequence[np.integer[Any]] | NDArray[np.bool_ | np.integer[Any] | np.floating[Any]],
*,
volume: float,
surface_area: float,
temperature_c: float,
relative_humidity_percent: float,
static_pressure_kpa: float = ...,
) -> NDArray[np.float64]
room_constant_from_air_absorption(
frequencies: NumericArrayLike,
*,
volume: float,
surface_area: float,
temperature_c: float,
relative_humidity_percent: float,
static_pressure_kpa: float = ...,
) -> float | NDArray[np.float64]

Room constant from the calculated air absorption (ISO 9295 Formula (7)).

, the room constant of the method of clause 7, with in nepers per metre from air_absorption_np_per_m (Annex A). The method takes all of the room absorption to be in the air, which clause 7.2 holds at 10 kHz and above; a band below 10 kHz emits a SoundPowerWarning, since the walls are no longer negligible there and the measured reverberation time of room_constant_from_reverberation_time is the method to use.

Parameters

Name Description
frequencies Band centre or tone frequencies, in hertz.
volume Room volume V, in cubic metres.
surface_area Total room surface S, in square metres.
temperature_c Air temperature in the room, in degrees Celsius.
relative_humidity_percent Relative humidity in the room, in percent.
static_pressure_kpa Static pressure in the room, in kilopascals (default 101.325 kPa).

Returns: R per frequency, in square metres. 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 or non-finite volume or surface, for the atmospheric inputs air_absorption_np_per_m refuses, or where : the air alone would then absorb more than the room surface can, and Formula (7) has no finite room constant.
TypeError if surface_area or volume is not a single number, or frequencies holds a text or a value that is not a real number.
room_constant_from_reverberation_time(
reverberation_time: float | np.floating[Any] | np.integer[Any],
*,
volume: float,
surface_area: float,
) -> float
room_constant_from_reverberation_time(
reverberation_time: Sequence[float] | Sequence[np.floating[Any]] | Sequence[np.integer[Any]] | NDArray[np.bool_ | np.integer[Any] | np.floating[Any]],
*,
volume: float,
surface_area: float,
) -> NDArray[np.float64]
room_constant_from_reverberation_time(
reverberation_time: NumericArrayLike,
*,
volume: float,
surface_area: float,
) -> float | NDArray[np.float64]

Room constant from the measured reverberation time (ISO 9295 Formulae (4), (5)).

with from room_absorption_coefficient, the room constant of the method of clause 6. It goes into high_frequency_sound_power as room_constant.

Formula (5) makes , so the two read together are , which is how R is computed: the quotient of Formula (4) divides by nothing once rounds to 1, for a decay short enough that the exponent passes about 37, where R is still a number.

Parameters

Name Description
reverberation_time Mean measured reverberation time T per band, in seconds (scalar or one value per band).
volume Room volume V, in cubic metres.
surface_area Total room surface S, in square metres.

Returns: R per band, in square metres. 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 or non-finite time, volume or surface.
TypeError if surface_area or volume is not a single number, or reverberation_time holds a text or a value that is not a real number.
tone_level_from_sidebands(sideband_levels: NumericArrayLike) -> float

Total level of a tone from its sideband levels (ISO 9295 Formula (3)).

, the energy sum of the bands adjacent to the tone frequency that carry its energy when the analyser is narrower than min_analyzer_bandwidth.

Parameters

Name Description
sideband_levels The sideband levels , in decibels re 20 µPa.

Returns: , in decibels re 20 µPa.

Raises

Exception When
ValueError for an empty or non-finite input.
TypeError if sideband_levels holds a text or a value that is not a real number.