Skip to content

emission: sound power in a reverberation room

Every name on this page is published by phonometry.emission: from phonometry import emission, then emission.<name>.

Sound power level of a noise source measured in a reverberation test room: ISO 3741:2010 (precision method, accuracy grade 1).

The source is placed in a hard-walled reverberation room whose reverberant field is sampled by microphones. Two methods are provided.

The direct method derives the sound power from the mean corrected room sound pressure level Lp(ST) and the equivalent absorption area A of the room, with the Sabine absorption area and the speed of sound c in m/s (ISO 3741:2010 clause 9.1.4, Eq. 20):

is the Waterhouse boundary correction (energy stored near the room boundaries); it vanishes as the frequency grows. C1 (Eq. 20, reference-quantity correction) and C2 (radiation-impedance correction) carry the result to the reference meteorological conditions of clause 4 (23.0 C, 101.325 kPa, 50 %), per clause 9.1.4:

The comparison method replaces the absorption-area terms by a reference sound source (RSS) of known sound power LW(RSS) measured at the same positions (ISO 3741:2010 clause 9.1.5, Eq. 21):

Both methods cover the one-third-octave bands from 100 Hz to 10 kHz (clause 8.1). Octave-band, A-weighted and total levels follow ISO 3741 Annex F, which reuses the ISO 3744 Annex E A-weighting band corrections.

A noise burst or a transient emission is described by the sound energy level , pJ (clause 3.18), and clause 9.2 determines it by the same two methods with the single event time-integrated sound pressure level (clause 3.4) in place of the time-averaged : the events at each position are reduced to the level of one event (Eq. 22 or Eq. 23), each position is corrected for its background by (Eq. 25, 26) as in 9.1.2, the positions are energy-averaged (Eq. 27), and the room enters through the same bracket as Eq. (20) or the same reference source as Eq. (21):

For a source steady over the whole interval , clause 3.4 NOTE 1 gives , s, and so . Annex F sums the one-third-octave levels into octave bands (Eq. F.1, F.4) and A-weights them (Eq. F.2, F.5) alike for the two quantities.

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

octave_band_levels(
levels: NumericArrayLike,
*,
frequencies: NumericArrayLike,
) -> OctaveBandLevels

Octave-band levels from one-third-octave band levels (ISO 3741 Annex F).

The level in the -th octave band, for the mid-band frequencies 63 Hz to 8 kHz, is the energy sum of the three one-third-octave bands to of Table F.1 that make it up, for sound power levels (Eq. F.1) and sound energy levels (Eq. F.4) alike:

Every octave the input touches must be supplied whole: Table F.1 numbers the one-third-octave bands from at 50 Hz, so the 63 Hz octave is the 50, 63 and 80 Hz thirds and the 8 kHz octave the 6.3, 8 and 10 kHz thirds, and a band whose triplet is incomplete cannot be summed.

Parameters

Name Description
levels Band levels in decibels, with the bands on the last axis ((NB,), or (..., NB) for several spectra at once).
frequencies The NB nominal one-third-octave mid-band frequencies of levels, in hertz, from 50 Hz to 10 kHz.

Returns: The octave mid-band frequencies, ascending, and the octave-band levels with the octaves on the last axis, as an OctaveBandLevels.

Raises

Exception When
ValueError for a frequency outside Table F.1, a repeated frequency, an octave whose three thirds are not all present, or levels that do not carry one value per frequency.
TypeError if frequencies or levels holds a text or a value that is not a real number.
OctaveBandLevels(
frequencies: NDArray[np.float64],
levels: NDArray[np.float64],
)

Octave-band levels summed from one-third-octave bands (ISO 3741 Annex F).

What octave_band_levels returns: the octave centres and the levels, named, where a (frequencies, levels) tuple used to be unpacked by position.

Attributes

Name Description
frequencies The octave mid-band frequencies, ascending, in Hz.
levels The octave-band levels, in dB, with the octaves on the last axis.
OctaveBandLevels.plot(
ax: Axes | None = None,
*,
language: Literal['en', 'es'] = 'en',
**kwargs: Any,
) -> Axes

Plot the octave-band levels against their octaves.

A level array of several spectra draws one curve per spectrum.

Parameters

Name Description
ax Existing axes, or None to create a figure.
language Label language, "en" (default) or "es".
kwargs Forwarded to the level curves.

Returns: The axes.

reverberation_background_correction(
levels: float | np.floating[Any] | np.integer[Any],
background_levels: float | np.floating[Any] | np.integer[Any],
*,
frequencies: float | np.floating[Any] | np.integer[Any],
) -> float
reverberation_background_correction(
levels: Sequence[float] | Sequence[np.floating[Any]] | Sequence[np.integer[Any]] | NDArray[np.bool_ | np.integer[Any] | np.floating[Any]],
background_levels: NumericArrayLike,
*,
frequencies: NumericArrayLike,
) -> NDArray[np.float64]
reverberation_background_correction(
levels: float | np.floating[Any] | np.integer[Any],
background_levels: Sequence[float] | Sequence[np.floating[Any]] | Sequence[np.integer[Any]] | NDArray[np.bool_ | np.integer[Any] | np.floating[Any]],
*,
frequencies: NumericArrayLike,
) -> NDArray[np.float64]
reverberation_background_correction(
levels: float | np.floating[Any] | np.integer[Any],
background_levels: float | np.floating[Any] | np.integer[Any],
*,
frequencies: Sequence[float] | Sequence[np.floating[Any]] | Sequence[np.integer[Any]] | NDArray[np.bool_ | np.integer[Any] | np.floating[Any]],
) -> NDArray[np.float64]
reverberation_background_correction(
levels: NumericArrayLike,
background_levels: NumericArrayLike,
*,
frequencies: NumericArrayLike,
) -> float | NDArray[np.float64]

Background-noise correction , ISO 3741:2010 Equation (14).

, the decibels to take off a band level measured with the background in it. The qualification of clause 9.1.2 is frequency dependent: a margin of 15 dB or more needs no correction at all, and below the lower criterion, 6 dB for the bands at or under 200 Hz and at or over 6.3 kHz and 10 dB between them, the correction is held at the criterion value and the corrected level is an upper bound.

Other standards reach for this one by name rather than repeat it: ISO 11957:1996 asks for a correction “in accordance with ISO 3741” four times over, and phonometry.noise_control.cabin_insulation calls this.

Parameters

Name Description
levels Band levels measured with the background present, in decibels.
background_levels Background levels in the same bands, in decibels.
frequencies Nominal band centre frequencies, in hertz.

Returns: per band, in decibels, to be subtracted from levels. A float when levels, background_levels and frequencies are all numbers, an array when one of them is a sequence or an array, a zero-dimensional one included.

Raises

Exception When
ValueError For inputs that do not match band for band, that are not finite, or a band centre that is not strictly positive.
TypeError if background_levels, frequencies or levels holds a text or a value that is not a real number.
ReverberationSoundEnergyResult(
frequencies: NDArray[np.float64] | None,
sound_energy_level: NDArray[np.float64],
mean_event_level: NDArray[np.float64],
absorption_area: NDArray[np.float64],
waterhouse_correction: NDArray[np.float64],
background_correction: NDArray[np.float64],
c1: float,
c2: float,
speed_of_sound: float,
sound_energy_level_a: float,
method: Literal['direct', 'comparison'],
n_events: int | None,
integration_time: float | None,
)

Result of an ISO 3741:2010 reverberation-room sound energy level determination (clause 9.2).

sound_energy_level is the per-band LJ (Eq. 30 direct method, Eq. 31 comparison method), under reference meteorological conditions as both equations state it. mean_event_level is the mean corrected single event time-integrated level in the room (Eq. 27). absorption_area, waterhouse_correction, c1, c2, speed_of_sound and background_correction are what they are in ReverberationSoundPowerResult, the background correction being the per-band shift of the mean level after each position was corrected by its own K1i (Eq. 25/26). sound_energy_level_a is the A-weighted total LJA (Annex F Eq. F.5), computed only when frequencies are supplied (NaN for several bands without them; equal to LJ for a single band). method is 'direct' or 'comparison'. n_events is the number of single sound emission events the levels were reduced from, or None when the caller supplied the mean single event level of one event; integration_time is the interval of the single event levels, in seconds, or None when no background correction needed it.

Attributes

Name Description
method One of "direct" or "comparison".
ReverberationSoundEnergyResult.plot(
ax: Axes | None = None,
*,
language: Literal['en', 'es'] = 'en',
**kwargs: Any,
) -> Axes

Plot the LJ spectrum with the A-weighted total annotated.

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

Parameters

Name Description
language The language of the labels: "en" or "es".
ReverberationSoundPowerResult(
frequencies: NDArray[np.float64] | None,
sound_power_level: NDArray[np.float64],
mean_pressure_level: NDArray[np.float64],
absorption_area: NDArray[np.float64],
waterhouse_correction: NDArray[np.float64],
background_correction: NDArray[np.float64],
c1: float,
c2: float,
speed_of_sound: float,
sound_power_level_a: float,
method: Literal['direct', 'comparison'],
)

Result of an ISO 3741:2010 reverberation-room sound power determination.

sound_power_level is the per-band LW (Eq. 20 direct method, Eq. 21 comparison method). mean_pressure_level is the mean corrected room level Lp(ST) (Eq. 16). For the direct method absorption_area is the Sabine equivalent absorption area A per band and waterhouse_correction the boundary term ; both are NaN for the comparison method. background_correction is the effective per-band background correction K1: with per-position input each position is corrected by its own K1i (Eq. 14/15) before the energy average (Eq. 16), and the reported value is the resulting per-band shift of the mean level (zero when no background is supplied). c1 and c2 are the reference-quantity and radiation-impedance corrections (c1 is NaN for the comparison method, which uses only c2). speed_of_sound is c at the test temperature. sound_power_level_a is the A-weighted total LWA (Annex F Eq. F.2), computed only when frequencies are supplied (NaN for several bands without them; equal to LW for a single band). method is 'direct' or 'comparison'.

Attributes

Name Description
method One of "direct" or "comparison".
ReverberationSoundPowerResult.plot(
ax: Axes | None = None,
*,
language: Literal['en', 'es'] = 'en',
**kwargs: Any,
) -> Axes

Plot the LW spectrum with the A-weighted total annotated.

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

Parameters

Name Description
language The language of the labels: "en" or "es".
ReverberationSoundPowerResult.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 3741 reverberation-room sound-power determination fiche.

Writes a one-page sound-power test sheet: the standard-basis line naming the reverberation-room method (the direct method using the room equivalent absorption area, or the comparison method using a reference sound source) and the precision accuracy grade (ISO 3741:2010, grade 1), an optional metadata header (client, noise source, test environment, instrumentation, climate, date), a per-band table (nominal octave/ one-third-octave frequency, the mean room sound-pressure level Lp and the 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 and the determination method, an optional verdict row against a declared limit, and a measurement-basis strip stating the correction model (Eq. 20 direct or Eq. 21 comparison), the applied meteorological corrections C1/C2 and the speed of sound.

Parameters

Name Description
path Destination path of the PDF file.
metadata Optional ReportMetadata supplying the header (client, specimen the noise source, test_room the reverberation test room, 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).
engine Rendering back end; only "reportlab" is supported.
verbose When True the per-band table adds the background correction K1 and, for the direct method, the equivalent absorption area A and the Waterhouse boundary correction Cw.
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).
sound_energy_comparison(
levels: NumericArrayLike,
reference_levels: NumericArrayLike,
reference_sound_power_levels: ReferenceSourceCalibration | NumericArrayLike,
*,
frequencies: NumericArrayLike | None = None,
n_events: int | np.integer[Any] | None = None,
background_levels: NumericArrayLike | None = None,
integration_time: float | None = None,
reference_background_levels: NumericArrayLike | None = None,
temperature_c: float = 23.0,
static_pressure_kpa: float = 101.325,
) -> ReverberationSoundEnergyResult

Sound energy level in a reverberation room, comparison method (ISO 3741:2010 clause 9.2.5).

A reference sound source of known per-band sound power reference_sound_power_levels runs steadily at the same microphone positions as the source under test, whose single event levels levels take any of the forms sound_energy_reverberation accepts. The sound energy level in each band follows Eq. (31):

where is the mean corrected single event level of the source under test (Eq. 27), the mean corrected time-averaged level of the reference source (Eq. 17) and C2 the radiation-impedance correction. The room terms and C1 cancel between the two sources exactly as in sound_power_comparison. The source under test is background-corrected as in sound_energy_reverberation (its background compared as an exposure over integration_time); the reference source, being steady, by the time-averaged correction of 9.1.2.

Parameters

Name Description
levels Single event levels of the source under test, in decibels.
reference_levels Mean room SPL per band (1D) or (NM, NB) per-position time-averaged levels of the reference sound source, in decibels.
reference_sound_power_levels Known sound power level LW(RSS) per band, in decibels, under the meteorological conditions of the test (Eq. 31), or 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.
frequencies Band mid-frequencies (Hz) for the K1 criterion and the A-weighted total.
n_events The number of events Ne one measurement encompasses (Eq. 23); None when levels is per event or already the mean of one event.
background_levels Time-averaged background levels for the K1 correction of levels (per position, or a single spectrum).
integration_time The interval T of the single event levels, in seconds; required with background_levels.
reference_background_levels Background levels matching reference_levels.
temperature_c Air temperature theta in the room, in degrees Celsius.
static_pressure_kpa Static pressure ps in the room, in kilopascals.

Returns: ReverberationSoundEnergyResult (method='comparison').

Raises

Exception When
ValueError for a malformed or non-finite level array, a non-physical climate, a background without its integration_time or without frequencies, or mismatched band counts.
TypeError if integration_time is not a single number, or n_events is a flag, a text or an array where a count goes, or frequencies, levels, reference_background_levels or reference_levels holds a text or a value that is not a real number.
sound_energy_reverberation(
levels: NumericArrayLike,
t60: NumericArrayLike,
volume: float,
surface_area: float,
*,
frequencies: NumericArrayLike,
n_events: int | np.integer[Any] | None = None,
background_levels: NumericArrayLike | None = None,
integration_time: float | None = None,
temperature_c: float = 23.0,
static_pressure_kpa: float = 101.325,
) -> ReverberationSoundEnergyResult

Sound energy level in a reverberation room, direct method (ISO 3741:2010 clause 9.2.4).

levels holds the single event time-integrated sound pressure levels measured through a period that encompasses the whole of the event, its decay included (clause 8.5.1; a moving microphone is not permitted for non-repetitive impulsive noise): a 1D per-band spectrum already averaged over the room, a 2D (NM, NB) array of one event’s level at each position, a 3D (Ne, NM, NB) array of the events measured one at a time (reduced by Eq. 22), or a 1D/2D level of one measurement encompassing n_events successive events (reduced by Eq. 23). Each position is corrected for its background by (Eq. 25/26, the frequency-dependent criterion of 9.1.2), the positions are energy-averaged (Eq. 27) and the sound energy level in each band follows Eq. (30):

with every term of the bracket exactly as in sound_power_reverberation (Eq. 20), so the level is stated under the reference meteorological conditions of clause 4. The background is the time-averaged level the standard has measured over the same integration time as the events (clause 9.2.2), and it is compared as its exposure over that , (clause 3.4 NOTE 1), so that the energies Eq. (25) subtracts share one reference; integration_time is therefore required with background_levels.

Parameters

Name Description
levels Single event levels, in decibels, in one of the four forms above.
t60 Reverberation time T60 per band, in seconds (scalar or one value per band).
volume Reverberation-room volume V, in cubic metres.
surface_area Total room surface area S, in square metres.
frequencies One-third-octave band mid-frequencies, Hz (required: the Waterhouse term and the K1 criterion need them).
n_events The number of events Ne one measurement encompasses (Eq. 23); None when levels is per event or already the mean of one event.
background_levels Time-averaged background levels for K1: per-position (NM, NB) (or a single (NB,) spectrum used at every position) with per-position levels, applied per position before the energy average; with 1D levels a single K1 from the averaged spectra approximates the per-position procedure.
integration_time The interval T of the single event levels, in seconds; required with background_levels.
temperature_c Air temperature theta in the room, in degrees Celsius.
static_pressure_kpa Static pressure ps in the room, in kilopascals.

Returns: ReverberationSoundEnergyResult (method='direct').

Raises

Exception When
ValueError for a malformed or non-finite level array, a non-physical room or climate, a background without its integration_time, or mismatched band counts.
TypeError if integration_time, surface_area or volume is not a single number, or n_events is a flag, a text or an array where a count goes, or frequencies, levels or t60 holds a text or a value that is not a real number.
sound_power_comparison(
levels: NumericArrayLike,
reference_levels: NumericArrayLike,
reference_sound_power_levels: ReferenceSourceCalibration | NumericArrayLike,
*,
frequencies: NumericArrayLike | None = None,
background_levels: NumericArrayLike | None = None,
reference_background_levels: NumericArrayLike | None = None,
temperature_c: float = 23.0,
static_pressure_kpa: float = 101.325,
) -> ReverberationSoundPowerResult

Sound power level in a reverberation room, comparison method (ISO 3741).

A reference sound source of known per-band sound power reference_sound_power_levels is measured at the same microphone positions as the source under test. The sound power level in each band follows Eq. (21):

where Lp(ST) and Lp(RSS) are the mean room levels (Eq. 16/17) of the test source and the reference source and C2 is the radiation-impedance correction. The absorption-area, Waterhouse and C1 terms cancel between the two sources, so the room absorption need not be known.

Parameters

Name Description
levels Mean room SPL per band (1D) or (NM, NB) per-position levels of the source under test, in decibels.
reference_levels Same, for the reference sound source, in decibels.
reference_sound_power_levels Known sound power level LW(RSS) per band, in decibels, under the meteorological conditions of the test (Eq. 21), or 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.
frequencies Band mid-frequencies (Hz) for the A-weighted total; required with a calibration.
background_levels Background levels for the K1 correction of levels (per position, or a single spectrum; applied per position per Eq. 14/15 before the Eq. 16 average when levels is 2D).
reference_background_levels Background levels matching reference_levels.
temperature_c Air temperature theta in the room, in degrees Celsius.
static_pressure_kpa Static pressure ps in the room, in kilopascals.

Returns: ReverberationSoundPowerResult (method='comparison').

Raises

Exception When
TypeError if background_levels, frequencies, levels, reference_background_levels or reference_levels holds a text or a value that is not a real number.
sound_power_reverberation(
levels: NumericArrayLike,
t60: NumericArrayLike,
volume: float,
surface_area: float,
*,
frequencies: NumericArrayLike,
background_levels: NumericArrayLike | None = None,
temperature_c: float = 23.0,
static_pressure_kpa: float = 101.325,
) -> ReverberationSoundPowerResult

Sound power level in a reverberation room, direct method (ISO 3741:2010).

levels is either a 1D per-band spectrum of the mean room sound pressure level or a 2D (NM, NB) array (one row per microphone position, one column per band) that is energy-averaged over positions (Eq. 16). The sound power level in each band follows Eq. (20):

with the Sabine equivalent absorption area and the speed of sound . The Waterhouse term needs the band mid-frequencies, so frequencies is required. C1 and C2 carry the result to the reference meteorological conditions (clause 4).

Parameters

Name Description
levels Mean room SPL per band (1D) or (NM, NB) per-position levels, in decibels.
t60 Reverberation time T60 per band, in seconds (scalar or one value per band).
volume Reverberation-room volume V, in cubic metres.
surface_area Total room surface area S, in square metres.
frequencies One-third-octave (or octave) band mid-frequencies, Hz.
background_levels Background levels for the K1 correction: per-position (NM, NB) (or a single (NB,) spectrum used at every position) with per-position levels, applied per position (Eq. 14/15) before the energy average (Eq. 16). With 1D pre-averaged levels a single K1 from the averaged spectra approximates the per-position procedure of clause 9.1.2.
temperature_c Air temperature theta in the room, in degrees Celsius.
static_pressure_kpa Static pressure ps in the room, in kilopascals.

Returns: ReverberationSoundPowerResult.

Raises

Exception When
TypeError if surface_area or volume is not a single number, or background_levels, frequencies, levels or t60 holds a text or a value that is not a real number.