Ir al contenido

materials.absorbers.uncertainty

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.

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 αs and the equivalent sound absorption area AT measured according to ISO 354, in one-third-octave bands (Clause 5, Table 1);
  • the practical sound absorption coefficient αp determined according to ISO 11654, in octave bands (Clause 6, Table 2);
  • the single-number weighted sound absorption coefficient αw (ISO 11654) and single-number rating DLα,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(coverage: float = 0.95) -> float

The 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(
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.

property

Lower interval bound value − U (exact U).

AbsorptionUncertaintyResult.plot(
ax: Axes | None = None,
*,
language: Literal['en', 'es'] = 'en',
**kwargs: Any,
) -> Axes

Plot 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.

property

Upper interval bound value + U (exact U).

equivalent_area_uncertainty(
area: NumericArrayLike,
*,
frequencies: NumericArrayLike,
condition: Literal['reproducibility', 'repeatability'] = 'reproducibility',
coverage: float = 0.95,
) -> AbsorptionUncertaintyResult

Uncertainty 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(
alpha_p: NumericArrayLike,
*,
frequencies: NumericArrayLike,
condition: Literal['reproducibility', 'repeatability'] = 'reproducibility',
coverage: float = 0.95,
) -> AbsorptionUncertaintyResult

Uncertainty 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(
dl_alpha: float,
*,
condition: Literal['reproducibility', 'repeatability'] = 'reproducibility',
coverage: float = 0.95,
) -> AbsorptionUncertaintyResult

Uncertainty 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(
alpha: NumericArrayLike,
*,
frequencies: NumericArrayLike,
condition: Literal['reproducibility', 'repeatability'] = 'reproducibility',
coverage: float = 0.95,
) -> AbsorptionUncertaintyResult

Uncertainty 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(
alpha_w: float = 0.0,
*,
condition: Literal['reproducibility', 'repeatability'] = 'reproducibility',
coverage: float = 0.95,
) -> AbsorptionUncertaintyResult

Uncertainty 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.