materials.absorbers.uncertainty
Measurement uncertainty for sound absorption (ISO 12999-2:2020).
Companion of the sound-insulation uncertainty of phonometry.building.measurement.uncertainty
(ISO 12999-1). This part gives the standard uncertainty u of the quantities
produced by a reverberation-room absorption measurement and its ratings:
- the sound absorption coefficient
αsand the equivalent sound absorption areaATmeasured according to ISO 354, in one-third-octave bands (Clause 5, Table 1); - the practical sound absorption coefficient
αpdetermined according to ISO 11654, in octave bands (Clause 6, Table 2); - the single-number weighted sound absorption coefficient
αw(ISO 11654) and single-number ratingDLα,NRD(EN 1793-1) (Clause 7).
The standard uncertainty is estimated by the reproducibility standard deviation
σR (different laboratories) or the repeatability standard deviation σr
(same location, operator and equipment), both derived from inter-laboratory tests
to ISO 5725. Where specimen-specific uncertainty data exist they take precedence
(Clause 4).
Band formulae (Clause 5-6). For the absorption coefficient
(Formula (1)/(4)); for the equivalent area
with (Formula (2));
the repeatability value is (Formula (3)/(5)).
m and n are the frequency-dependent
constants of Table 1 (one-third-octave, 63-5000 Hz) and Table 2 (octave,
250-4000 Hz).
Single numbers (Clause 7). αw:
(Formula (6)), (Formula (7)). DLα,NRD:
(Formula (8)),
(Formula (9)).
Reporting (Clause 8). The expanded uncertainty is
(Formula (10))
with the coverage factor k of Table 3 (Gaussian assumption). The reported
U is rounded to two decimal digits for absorption coefficients and one decimal
digit for the equivalent area and DLα,NRD; the code keeps the exact U and
exposes the rounded view through AbsorptionUncertaintyResult.reported_expanded_uncertainty.
Auto-generated from the source docstrings by
scripts/generate_api_docs.py(make api-docs). Do not edit by hand.
absorption_coverage_factor
Section titled “absorption_coverage_factor”absorption_coverage_factor(coverage: float = 0.95) -> floatThe coverage factor k for a coverage probability (Table 3).
Parameters
| Name | Description |
|---|---|
coverage |
Coverage probability as a fraction; one of 0.68, 0.80, 0.90, 0.95, 0.99, 0.999 (Table 3, Gaussian measurand). |
Raises
| Exception | When |
|---|---|
| ValueError | Coverage probability not tabulated in Table 3. |
| TypeError | if coverage is not a single number. |
AbsorptionUncertaintyResult
Section titled “AbsorptionUncertaintyResult”AbsorptionUncertaintyResult( quantity: Literal['absorption_coefficient', 'equivalent_area', 'practical_coefficient', 'weighted_coefficient', 'single_number_rating'], condition: Literal['reproducibility', 'repeatability'], frequencies: NDArray[np.float64], values: NDArray[np.float64], standard_uncertainty: NDArray[np.float64], coverage_factor: float, expanded_uncertainty: NDArray[np.float64],)Standard and expanded uncertainty of an absorption quantity (ISO 12999-2).
For the single-number quantities (αw, DLα,NRD) it is the frequency
array alone that is empty; the value and the two uncertainty arrays each
hold a single element. That empty frequencies is what marks a
single-number result apart, and what plot refuses on.
Attributes
| Name | Description |
|---|---|
quantity |
"absorption_coefficient", "equivalent_area", "practical_coefficient", "weighted_coefficient" or "single_number_rating". |
condition |
"reproducibility" (σR) or "repeatability" (σr). |
frequencies |
Band centre frequencies, in Hz (empty for single numbers). |
values |
The input quantity per band (one element for single numbers). |
standard_uncertainty |
Standard uncertainty u (σR/σr), one per band. |
coverage_factor |
Coverage factor k (Table 3). |
expanded_uncertainty |
Exact (Formula (10)), one per band. |
AbsorptionUncertaintyResult.lower
Section titled “AbsorptionUncertaintyResult.lower”property
Lower interval bound value − U (exact U).
AbsorptionUncertaintyResult.plot()
Section titled “AbsorptionUncertaintyResult.plot()”AbsorptionUncertaintyResult.plot( ax: Axes | None = None, *, language: Literal['en', 'es'] = 'en', **kwargs: Any,) -> AxesPlot the quantity with its ±U uncertainty ribbon (band quantities).
Requires matplotlib (the [plot] extra); returns the
Axes.
Parameters
| Name | Description |
|---|---|
language |
The language of the labels: "en" or "es". |
AbsorptionUncertaintyResult.reported_expanded_uncertainty
Section titled “AbsorptionUncertaintyResult.reported_expanded_uncertainty”property
U rounded for reporting (Clause 8): two decimals for absorption
coefficients, one decimal for the equivalent area and DLα,NRD.
AbsorptionUncertaintyResult.upper
Section titled “AbsorptionUncertaintyResult.upper”property
Upper interval bound value + U (exact U).
equivalent_area_uncertainty
Section titled “equivalent_area_uncertainty”equivalent_area_uncertainty( area: NumericArrayLike, *, frequencies: NumericArrayLike, condition: Literal['reproducibility', 'repeatability'] = 'reproducibility', coverage: float = 0.95,) -> AbsorptionUncertaintyResultUncertainty of the ISO 354 equivalent sound absorption area AT
(Clause 5).
with (Formula (2)) per one-third-octave band; (Formula (3)).
Parameters
| Name | Description |
|---|---|
area |
Equivalent sound absorption area AT per band, in m². |
frequencies |
One-third-octave midband frequencies in Hz (Table 1), aligned with area. |
condition |
"reproducibility" (default) or "repeatability". |
coverage |
Coverage probability for the coverage factor k (Table 3). |
Raises
| Exception | When |
|---|---|
| ValueError | Mismatched shapes, an untabulated frequency, an unknown condition or an untabulated coverage. |
| TypeError | if condition is not a text, or area or frequencies holds a text or a value that is not a real number. |
practical_coefficient_uncertainty
Section titled “practical_coefficient_uncertainty”practical_coefficient_uncertainty( alpha_p: NumericArrayLike, *, frequencies: NumericArrayLike, condition: Literal['reproducibility', 'repeatability'] = 'reproducibility', coverage: float = 0.95,) -> AbsorptionUncertaintyResultUncertainty of the ISO 11654 practical absorption coefficient αp
(Clause 6).
(Formula (4)) per octave band; (Formula (5)).
Parameters
| Name | Description |
|---|---|
alpha_p |
Practical sound absorption coefficient αp per band. |
frequencies |
Octave midband frequencies in Hz (Table 2, 250-4000), aligned with alpha_p. |
condition |
"reproducibility" (default) or "repeatability". |
coverage |
Coverage probability for the coverage factor k (Table 3). |
Raises
| Exception | When |
|---|---|
| ValueError | Mismatched shapes, an untabulated frequency, an unknown condition or an untabulated coverage. |
| TypeError | if condition is not a text, or alpha_p or frequencies holds a text or a value that is not a real number. |
single_number_rating_uncertainty
Section titled “single_number_rating_uncertainty”single_number_rating_uncertainty( dl_alpha: float, *, condition: Literal['reproducibility', 'repeatability'] = 'reproducibility', coverage: float = 0.95,) -> AbsorptionUncertaintyResultUncertainty of the EN 1793-1 single-number rating DLα,NRD
(Clause 7).
(Formula (8)), (Formula (9)).
Parameters
| Name | Description |
|---|---|
dl_alpha |
Single-number rating DLα,NRD, in dB (non-negative). |
condition |
"reproducibility" (default) or "repeatability". |
coverage |
Coverage probability for the coverage factor k (Table 3). |
Raises
| Exception | When |
|---|---|
| ValueError | Negative dl_alpha, unknown condition or an untabulated coverage. |
| TypeError | if dl_alpha is not a single number, or condition is not a text. |
sound_absorption_coefficient_uncertainty
Section titled “sound_absorption_coefficient_uncertainty”sound_absorption_coefficient_uncertainty( alpha: NumericArrayLike, *, frequencies: NumericArrayLike, condition: Literal['reproducibility', 'repeatability'] = 'reproducibility', coverage: float = 0.95,) -> AbsorptionUncertaintyResultUncertainty of the ISO 354 sound absorption coefficient αs
(Clause 5).
(Formula (1)) per one-third-octave band; (Formula (3)).
Parameters
| Name | Description |
|---|---|
alpha |
Sound absorption coefficient αs per band. |
frequencies |
One-third-octave midband frequencies in Hz (Table 1, 63-5000), aligned with alpha. |
condition |
"reproducibility" (default) or "repeatability". |
coverage |
Coverage probability for the coverage factor k (Table 3). |
Raises
| Exception | When |
|---|---|
| ValueError | Mismatched shapes, an untabulated frequency, an unknown condition or an untabulated coverage. |
| TypeError | if condition is not a text, or alpha or frequencies holds a text or a value that is not a real number. |
weighted_coefficient_uncertainty
Section titled “weighted_coefficient_uncertainty”weighted_coefficient_uncertainty( alpha_w: float = 0.0, *, condition: Literal['reproducibility', 'repeatability'] = 'reproducibility', coverage: float = 0.95,) -> AbsorptionUncertaintyResultUncertainty of the ISO 11654 weighted absorption coefficient αw
(Clause 7).
The standard uncertainty is a constant: (Formula (6)), (Formula (7)), independent of the value.
Parameters
| Name | Description |
|---|---|
alpha_w |
Weighted sound absorption coefficient αw (carried through for the reported interval; does not affect u). |
condition |
"reproducibility" (default) or "repeatability". |
coverage |
Coverage probability for the coverage factor k (Table 3). |
Raises
| Exception | When |
|---|---|
| ValueError | Unknown condition or an untabulated coverage. |
| TypeError | if alpha_w is not a single number, or condition is not a text. |