building.measurement.ratings

Single-number weighted ratings of sound insulation and their spectrum adaptation terms (ISO 717-1 airborne, ISO 717-2 impact).

ISO 717 rates a curve, not a room. Whatever produced the band values (a field measurement to ISO 16283, a laboratory measurement to ISO 10140, a prediction to ISO 12354), both parts of ISO 717 reduce them to a single number by the same reference-curve method: one shift search, one pair of deviation bounds, one rounding rule, run against the airborne reference curve of ISO 717-1 or the impact reference curve of ISO 717-2, whose only structural difference is the sign an unfavourable deviation has. That shared machinery, with the Table 3 reference curves and the Table 4 / Table B.1 spectra it reads, is the subject of this module.

Weighted rating (ISO 717-1). The reference-curve method of Clause 4.4 shifts the reference curve of Table 3 in 1 dB steps towards the measured curve until the sum of unfavourable deviations (measured below the shifted reference) is as large as possible but not more than 32,0 dB for the 16 one-third-octave bands (100 Hz to 3150 Hz) or 10,0 dB for the 5 octave bands (125 Hz to 2000 Hz). The weighted rating (Rw, R'w, Dn,w, DnT,w …) is the shifted reference read at 500 Hz. The spectrum adaptation terms are $C=X_{\mathrm{A}1}-X_{\mathrm{w}}$ and $C_{\mathrm{tr}}=X_{\mathrm{A}2}-X_{\mathrm{w}}$ with $X_{\mathrm{A}j}=-10{\log }_{10}\sum 10^{(L_{ij}-X_i)/10}$ rounded to an integer, using the A-weighted spectra No. 1 (pink noise, C) and No. 2 (urban traffic, Ctr) of Table 4 (Clause 4.5, Formula (1) and (2)). Input levels are reduced to one decimal place before use (Clause 4.4, footnote 1). The reference values, spectra and shifting rule are identical in the 2013 and 2020 editions of ISO 717-1.

Enlarged frequency ranges (ISO 717-1 Annex B; ISO 717-2 A.2.1 NOTE). When measurements cover an enlarged range, additional adaptation terms are stated with the range as a subscript: C50-3150, C50-5000, C100-5000 (and the Ctr counterparts) with the Table B.1 spectra, and CI,50-2500 for impact. weighted_rating_extended and weighted_impact_rating_extended compute them alongside the core rating. Both accept one_decimal=True for the “1/10 dB for the expression of uncertainty” variant of Clauses 4.4/4.5 (reference-curve shift in 0,1 dB steps and one-decimal reductions), which ISO 12999-1:2020 Annex B requires when stating the uncertainty of single-number values.

Weighted impact rating (ISO 717-2). The reference-curve method of Clause 4.3 shifts the Table 3 impact reference curve towards the measured curve until the sum of unfavourable deviations (here where the measurement exceeds the reference, the sign opposite to airborne) is as large as possible but not more than 32,0 dB (16 one-third-octave bands) or 10,0 dB (5 octave bands). The rating (Ln,w, L'n,w, L'nT,w) is the shifted reference read at 500 Hz, reduced by a further 5 dB for octave bands (Clause 4.3.2). The spectrum adaptation term $C_{\mathrm{I}}=L_{\mathrm{n},\mathrm{sum}}-15-L_{\mathrm{n},\mathrm{w}}$ uses the energetic sum Ln,sum over 100 Hz to 2500 Hz (one-third octave) or 125 Hz to 2000 Hz (octave), rounded to an integer (Clause A.2.1, Formulae (A.1) to (A.3)). The Table 3 reference values, the shifting rule and CI are identical in the 2013 and 2020 editions of ISO 717-2 (the 2020 edition only adds Annex D for the rubber-ball heavy/soft impactor, out of scope here).

Improvements rated on a reference element (ISO 717-2:2020 Clauses 5 and 6, ISO 717-1:2020 Annex D). A floor covering and a lining are rated on a standard element rather than on the floor or wall they were measured on, so that the single number describes the product and not the laboratory. The measured improvement is added to (subtracted from) the reference curve of the element, the two curves are rated, and the improvement is the difference of the two ratings: ΔLw on the heavyweight floor and ΔLt,w on the three lightweight floors of Table 4 (IMPACT_REFERENCE_FLOORS), and ΔRw with Δ(Rw + C) and Δ(Rw + Ctr) on the heavy wall, the heavy floor and the lightweight wall of Table E.1 (LINING_REFERENCE_ELEMENTS). Both tables were printed in ISO 10140-5:2010 (Tables C.1 and B.1); its 2021 edition keeps the constructions and refers to ISO 717 for the curves.

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

ExtendedImpactRatingResult(
    rating: float,
    ci: float,
    ci_50_2500: float | None,
    core: ImpactRatingResult,
    band_centers: np.ndarray | None = None,
    measured: np.ndarray | None = None,
)

Weighted impact rating with CI,50-2500 (ISO 717-2:2020 A.2.1 NOTE).

Values are integers unless computed with one_decimal=True.

Attributes

ExtendedImpactRatingResult.plot(
    ax: Axes | None = None,
    *,
    language: str = 'en',
    **kwargs: Any,
) -> Axes

Plot the enlarged-range curve vs the shifted reference (ISO 717-2).

The measured curve is drawn over the full enlarged range, the ISO 717-2 reference curve (after the final shift) over the 16 core bands 100-3150 Hz, with the unfavourable deviations (measurement above the reference) shaded on the core bands and the bands outside the core range marked as the enlarged range; the title carries the impact rating with CI and, when covered, CI,50-2500. Requires matplotlib (pip install phonometry[plot]); returns the Axes.

ExtendedWeightedRatingResult(
    rating: float,
    c: float,
    ctr: float,
    c_50_3150: float | None,
    c_50_5000: float | None,
    c_100_5000: float | None,
    ctr_50_3150: float | None,
    ctr_50_5000: float | None,
    ctr_100_5000: float | None,
    core: WeightedRatingResult,
    band_centers: np.ndarray | None = None,
    measured: np.ndarray | None = None,
)

Weighted rating with the enlarged-range adaptation terms (ISO 717-1 Annex B).

All values are integers unless the result was computed with one_decimal=True (the “1/10 dB for the expression of uncertainty” variant of Clauses 4.4/4.5), in which case they carry one decimal place. An extended term is None when the supplied bands do not cover its frequency range.

Attributes

ExtendedWeightedRatingResult.plot(
    ax: Axes | None = None,
    *,
    language: str = 'en',
    **kwargs: Any,
) -> Axes

Plot the enlarged-range curve vs the shifted reference (Annex B).

The measured curve is drawn over the full enlarged range, the ISO 717-1 reference curve (after the final shift) over the 16 core bands 100-3150 Hz, with the unfavourable deviations shaded on the core bands and the bands outside the core range marked as the enlarged range; the title carries Rw (C; Ctr) and every Annex B adaptation term the input covered. Requires matplotlib (pip install phonometry[plot]); returns the Axes.

impact_improvement_adaptation_term(
    delta_l: Mapping[float, float] | Sequence[float] | np.ndarray,
    *,
    reference_floor: ReferenceFloor = ...,
    one_decimal: Literal[False] = ...,
) -> int

impact_improvement_adaptation_term(
    delta_l: Mapping[float, float] | Sequence[float] | np.ndarray,
    *,
    reference_floor: ReferenceFloor = ...,
    one_decimal: Literal[True],
) -> float

impact_improvement_adaptation_term(
    delta_l: Mapping[float, float] | Sequence[float] | np.ndarray,
    *,
    reference_floor: ReferenceFloor = ...,
    one_decimal: bool = ...,
) -> int | float

Adaptation term CI,Δ or CIΔ,t of a floor covering (ISO 717-2:2020).

$C_{\mathrm{I},\Delta }=C_{\mathrm{I},\mathrm{r},0}-C_{\mathrm{I},\mathrm{r}}$ (Formula (A.4)) on the heavyweight floor, with $C_{\mathrm{I},\mathrm{r},0}=-11$ dB, and $C_{\mathrm{I}\Delta ,\mathrm{t}}=C_{\mathrm{I},\mathrm{t},\mathrm{r},0}-C_{\mathrm{I},\mathrm{t},\mathrm{r}}$ (Formula (A.6)) on a lightweight one, with $C_{\mathrm{I},\mathrm{t},\mathrm{r},0}$ of 0 dB for floors No 1 and No 2 and -3 dB for No 3. CI,r is the ISO 717-2 spectrum adaptation term of the reference floor with the covering under test, $L_{\mathrm{n},\mathrm{r}}=L_{\mathrm{n},\mathrm{r},0}-\Delta L$ (Formula (1)). Together with weighted_impact_improvement it yields the single-number reduction for a flat spectrum, $\Delta L_{\mathrm{lin}}=\Delta L_{\mathrm{w}}+C_{\mathrm{I},\Delta }$ (Formula (A.5), or (A.7) on a lightweight floor). ISO 16251-1 Clause 8 e) and ISO 10140-1:2021 H.5 h) require this term in the statement of results.

With one_decimal=True both terms keep one decimal place, which gives CI,r,0 = -10,3 dB and CI,t,r,0 of 0,0 and -2,8 dB as A.2.2 and A.2.3 print.

Parameters

Returns: The spectrum adaptation term, in dB: an integer, or a value to one decimal place when one_decimal is set.

Raises

Constant (mapping).

IMPACT_REFERENCE_FLOORS = {'heavyweight': {100.0: 67.0, 125.0: 67.5, 160.0: 68.0, 200.0: 68.5, 250.0: 69.0, 315.0: 69.5, 400.0: 70.0, 500.0: 70.5, 630.0: 71.0, 800.0: 71.5, 1000.0: 72.0, 1250.0: 72.0, 1600.0: 72.0, 2000.0: 72.0, 2500.0: 72.0, 3150.0: 72.0}, 'lightweight_1': {100.0: 78.0, 125.0: 78.0, 160.0: 78.0, 200.0: 78.0, 250.0: 78.0, 315.0: 78.0, 400.0: 76.0, 500.0: 74.0, 630.0: 72.0, 800.0: 69.0, 1000.0: 66.0, 1250.0: 63.0, 1600.0: 60.0, 2000.0: 57.0, 2500.0: 54.0, 3150.0: 51.0}, 'lightweight_2': {100.0: 78.0, 125.0: 78.0, 160.0: 78.0, 200.0: 78.0, 250.0: 78.0, 315.0: 78.0, 400.0: 76.0, 500.0: 74.0, 630.0: 72.0, 800.0: 69.0, 1000.0: 66.0, 1250.0: 63.0, 1600.0: 60.0, 2000.0: 57.0, 2500.0: 54.0, 3150.0: 51.0}, 'lightweight_3': {100.0: 69.0, 125.0: 72.0, 160.0: 75.0, 200.0: 78.0, 250.0: 78.0, 315.0: 78.0, 400.0: 78.0, 500.0: 78.0, 630.0: 78.0, 800.0: 76.0, 1000.0: 74.0, 1250.0: 72.0, 1600.0: 69.0, 2000.0: 66.0, 2500.0: 63.0, 3150.0: 60.0}}

ImpactImprovementRatingResult(
    delta_lw: int,
    ci_delta: int,
    ci_r: int,
    band_centers: np.ndarray,
    improvement: np.ndarray,
)

The weighted reduction of impact level of a covering, with its terms.

ISO 717-2:2020 rates the reduction of impact sound pressure level $\Delta L$ of a floor covering against the heavyweight reference floor of its Table 4: $\Delta L_{\mathrm{w}}$ from Formulae (1) and (2), and the adaptation terms of Clause A.2.2, where $C_{\mathrm{I},\Delta }=C_{\mathrm{I},\mathrm{r},0}-C_{\mathrm{I},\mathrm{r}}$ (Formula (A.4)) with $C_{\mathrm{I},\mathrm{r},0}=-11$ dB. A data sheet of a covering or a resilient layer prints $\Delta L_{\mathrm{w}}$ and one of the two terms, so both are here.

Attributes

ImpactImprovementRatingResult.plot(
    ax: Axes | None = None,
    *,
    language: str = 'en',
    **kwargs: Any,
) -> Axes

Plot the improvement spectrum with its rating (ISO 717-2).

Requires matplotlib (pip install phonometry[plot]); returns the Axes.

ImpactRatingResult(
    rating: int,
    ci: int,
    unfavourable_sum: float,
    band_centers: np.ndarray | None = None,
    measured: np.ndarray | None = None,
    shifted_reference: np.ndarray | None = None,
    quantity: Literal['impact'] = 'impact',
)

Single-number weighted impact rating and CI (ISO 717-2).

Attributes

ImpactRatingResult.plot(
    ax: Axes | None = None,
    *,
    language: str = 'en',
    **kwargs: Any,
) -> Axes

Plot the measured curve vs the shifted reference (ISO 717-2).

Unfavourable deviations (measurement above the reference, the sign opposite to airborne) are shaded and Ln,w (CI) annotated. Requires matplotlib (pip install phonometry[plot]); returns the Axes.

ImpactRatingResult.report(
    path: str,
    *,
    metadata: ReportMetadata | None = None,
    engine: str = 'reportlab',
    verbose: bool = False,
    language: str = 'en',
    symbol: str | None = None,
) -> str

Render an ISO 717-2 impact-insulation fiche to a PDF.

Writes a one-page accredited-laboratory report for impact sound: the standard-basis line, an optional metadata header block, the band table beside the measured-versus-shifted-reference plot (the result’s own plot), the boxed Ln,w (CI) result, an optional verdict row and a footer with the fixed disclaimer.

Parameters

Returns: The written path as a str.

Raises

Constant (mapping).

LINING_REFERENCE_ELEMENTS = {'heavy_wall': {50.0: 35.3, 63.0: 37.3, 80.0: 39.4, 100.0: 40.0, 125.0: 40.0, 160.0: 40.0, 200.0: 40.0, 250.0: 41.0, 315.0: 43.5, 400.0: 46.1, 500.0: 48.5, 630.0: 51.0, 800.0: 53.6, 1000.0: 56.0, 1250.0: 58.4, 1600.0: 61.1, 2000.0: 63.6, 2500.0: 65.0, 3150.0: 65.0, 4000.0: 65.0, 5000.0: 65.0}, 'heavy_floor': {50.0: 34.0, 63.0: 36.0, 80.0: 38.1, 100.0: 40.0, 125.0: 40.0, 160.0: 40.0, 200.0: 40.0, 250.0: 40.0, 315.0: 41.8, 400.0: 44.4, 500.0: 46.8, 630.0: 49.3, 800.0: 51.9, 1000.0: 54.4, 1250.0: 56.8, 1600.0: 59.5, 2000.0: 61.9, 2500.0: 64.3, 3150.0: 65.0, 4000.0: 65.0, 5000.0: 65.0}, 'lightweight_wall': {50.0: 21.3, 63.0: 23.3, 80.0: 25.3, 100.0: 27.0, 125.0: 27.0, 160.0: 27.0, 200.0: 27.0, 250.0: 27.0, 315.0: 27.0, 400.0: 27.0, 500.0: 27.0, 630.0: 28.0, 800.0: 30.5, 1000.0: 32.8, 1250.0: 35.1, 1600.0: 37.6, 2000.0: 40.0, 2500.0: 42.3, 3150.0: 44.6, 4000.0: 47.1, 5000.0: 49.4}}

ReductionImprovementRating(
    basic_element: str,
    delta_rw: float,
    delta_rw_c: float,
    delta_rw_ctr: float,
    delta_rw_c_50_3150: float | None,
    delta_rw_c_50_5000: float | None,
    delta_rw_c_100_5000: float | None,
    delta_rw_ctr_50_3150: float | None,
    delta_rw_ctr_50_5000: float | None,
    delta_rw_ctr_100_5000: float | None,
    without_lining: ExtendedWeightedRatingResult,
    with_lining: ExtendedWeightedRatingResult,
)

Single-number improvement of the sound reduction index by a lining.

The rating of ISO 717-1:2020 Annex D: the measured ΔR is added to the reference curve of a standard basic element, $R_{\mathrm{ref},\mathrm{with}}=R_{\mathrm{ref},\mathrm{without}}+\Delta R$ (Formula (D.3)), both curves are rated, and each improvement is the difference of the two ratings (Formula (D.4)). Every value is an integer unless the rating was computed with one_decimal=True. An enlarged-range term is None when ΔR did not cover its bands.

Attributes

property

The element index of ISO 717-1:2020 D.3: "heavy" or "light".

ReductionImprovementRating.plot(
    ax: Axes | None = None,
    *,
    language: str = 'en',
    **kwargs: Any,
) -> Axes

Plot Rref,without and Rref,with with the improvement ratings.

Draws the reference curve of the basic element and the same curve raised by the measured ΔR, the two curves Annex D rates; the title carries ΔRw, Δ(Rw + C) and Δ(Rw + Ctr) with the element index. Requires matplotlib (pip install phonometry[plot]); returns the Axes.

weighted_impact_improvement(
    delta_l: Mapping[float, float] | Sequence[float] | np.ndarray,
    *,
    reference_floor: ReferenceFloor = ...,
    one_decimal: Literal[False] = ...,
) -> int

weighted_impact_improvement(
    delta_l: Mapping[float, float] | Sequence[float] | np.ndarray,
    *,
    reference_floor: ReferenceFloor = ...,
    one_decimal: Literal[True],
) -> float

weighted_impact_improvement(
    delta_l: Mapping[float, float] | Sequence[float] | np.ndarray,
    *,
    reference_floor: ReferenceFloor = ...,
    one_decimal: bool = ...,
) -> int | float

Weighted reduction of impact level ΔLw or ΔLt,w (ISO 717-2:2020).

Relates a measured improvement spectrum ΔL to a reference floor of Table 4 (IMPACT_REFERENCE_FLOORS): the reference level with the covering is $L_{\mathrm{n},\mathrm{r}}=L_{\mathrm{n},\mathrm{r},0}-\Delta L$ (Formula (1)) and the weighted improvement is $\Delta L_{\mathrm{w}}=L_{\mathrm{n},\mathrm{r},0,\mathrm{w}}-L_{\mathrm{n},\mathrm{r},\mathrm{w}}$ (Formula (2)), both weighted ratings taken with weighted_impact_rating. On the heavyweight floor this is the ΔLw of Clause 5, $78-L_{\mathrm{n},\mathrm{r},\mathrm{w}}$; on a lightweight floor it is the ΔLt,w of Clause 6, which 6.3 computes “as specified in 5.3, substituting the heavy reference floor by a lightweight reference floor” and 6.2 designates ΔLt,1,w, ΔLt,2,w or ΔLt,3,w by floor type.

one_decimal=True rates both curves with the 0,1 dB shift and keeps one decimal place, the form 5.4 prescribes when the uncertainty of ΔLw is stated (its EXAMPLE, ΔLw = 18,9 ± 1,1); Ln,r,0,w is then 77,6 dB for the heavyweight floor, as A.2.2 prints.

Parameters

Returns: The weighted reduction, in dB: an integer, or a value to one decimal place when one_decimal is set.

Raises

weighted_impact_rating(
    values_by_band: Mapping[float, float] | Sequence[float] | np.ndarray,
    bands: str | None = None,
) -> ImpactRatingResult

Single-number weighted impact rating and CI per ISO 717-2.

Applies the reference-curve method of Clause 4.3: the Table 3 impact reference curve is shifted in 1 dB steps towards the measured curve until the sum of unfavourable deviations is as large as possible but not more than 32,0 dB (16 one-third-octave bands, 100 Hz to 3150 Hz) or 10,0 dB (5 octave bands, 125 Hz to 2000 Hz). For impact sound an unfavourable deviation occurs where the measurement exceeds the reference (the sign opposite to ISO 717-1 airborne). The rating is the shifted reference read at 500 Hz; for octave bands it is then reduced by 5 dB (Clause 4.3.2). The spectrum adaptation term CI follows Clause A.2.1. Input values are first reduced to one decimal place (Clause 4.3.1, footnote 1).

The shift search reuses the verified engine of weighted_rating on the negated curves: minimising $\sum \max (0,\text{measured}-(\text{ref}+k))$ over k equals maximising $\sum \max (0,(-\text{ref})+(-k)-(-\text{measured}))$, the airborne problem, so no separate search is duplicated.

Parameters

Returns: ImpactRatingResult with rating, ci and unfavourable_sum.

Raises

weighted_impact_rating_extended(
    values_by_band: Sequence[float] | np.ndarray,
    frequencies: Sequence[float] | np.ndarray | None = None,
    *,
    one_decimal: bool = False,
) -> ExtendedImpactRatingResult

Weighted impact rating with CI,50-2500 (ISO 717-2:2020 A.2.1).

Computes the weighted impact rating from the core one-third-octave bands 100-3150 Hz (Clause 4.3) and, when the input covers 50-2500 Hz, the enlarged-range spectrum adaptation term CI,50-2500 of the A.2.1 NOTE: the energetic sum runs over 50-2500 Hz instead of 100-2500 Hz in Formula (A.1), $C_{\mathrm{I}}=L_{\mathrm{n},\mathrm{sum}}-15-L_{\mathrm{n},\mathrm{w}}$.

With one_decimal=True the reference-curve shift runs in 0,1 dB steps and the sums keep one decimal place (Clauses 4.3.1/4.4; e.g. the reference floor yields $L_{\mathrm{n},\mathrm{r},0,\mathrm{w}}=77.6$ dB and $C_{\mathrm{I},\mathrm{r},0}=-10.3$ dB as printed in A.2.2).

Parameters

Returns: An ExtendedImpactRatingResult.

Raises

weighted_rating(
    values_by_band: Mapping[float, float] | Sequence[float] | np.ndarray,
    bands: str | None = None,
) -> WeightedRatingResult

Single-number weighted rating and C / Ctr per ISO 717-1.

Applies the reference-curve method of Clause 4.4: the Table 3 reference curve is shifted in 1 dB steps towards the measured curve until the sum of unfavourable deviations is as large as possible but not more than 32,0 dB (16 one-third-octave bands, 100 Hz to 3150 Hz) or 10,0 dB (5 octave bands, 125 Hz to 2000 Hz). The rating is the shifted reference read at 500 Hz. The spectrum adaptation terms C and Ctr follow Clause 4.5 with the Table 4 spectra No. 1 and No. 2. Input values are first reduced to one decimal place (Clause 4.4, footnote 1).

Parameters

Returns: WeightedRatingResult with rating, c, ctr and unfavourable_sum.

Raises

weighted_rating_extended(
    values_by_band: Sequence[float] | np.ndarray,
    frequencies: Sequence[float] | np.ndarray | None = None,
    *,
    one_decimal: bool = False,
) -> ExtendedWeightedRatingResult

Weighted rating with enlarged-range adaptation terms (ISO 717-1 An. B).

Computes the weighted rating from the core one-third-octave bands 100-3150 Hz (Clause 4.4) and, for every enlarged frequency range covered by the input, the additional spectrum adaptation terms of Annex B (C50-3150, C50-5000, C100-5000 and the Ctr counterparts) with the Table B.1 spectra: $C_j=X_{\mathrm{A}j}-X_{\mathrm{w}}$ where XAj sums over the bands of the enlarged range (Clause 4.5 with Annex B).

With one_decimal=True the reference-curve shift runs in 0,1 dB steps and every reduction keeps one decimal place; the variant Clauses 4.4/4.5 prescribe “for the expression of uncertainty” and ISO 12999-1:2020 Annex B requires for the uncertainty of single-number values.

Parameters

Returns: An ExtendedWeightedRatingResult.

Raises

weighted_reduction_improvement(
    delta_r: Sequence[float] | np.ndarray,
    frequencies: Sequence[float] | np.ndarray | None = None,
    *,
    basic_element: BasicElement = 'heavy_wall',
    one_decimal: bool = False,
) -> ReductionImprovementRating

Weighted improvement of the sound reduction index by a lining (ISO 717-1).

ISO 717-1:2020 Annex D rates a lining on a standard basic element rather than on the wall it was measured on, so that the number describes the lining and not the laboratory: the measured improvement ΔR is added to the reference curve of the element (LINING_REFERENCE_ELEMENTS), $R_{\mathrm{ref},\mathrm{with}}=R_{\mathrm{ref},\mathrm{without}}+\Delta R$ (Formula (D.3)), both curves are rated with weighted_rating_extended, and $\Delta R_{\mathrm{w}}=R_{\mathrm{w},\mathrm{ref},\mathrm{with}}-R_{\mathrm{w},\mathrm{ref},\mathrm{without}}$ (Formula (D.4)). Δ(Rw + C) and Δ(Rw + Ctr) are “calculated in an equivalent way”, as differences of the sums, and so is every enlarged-range term of Annex B whose bands ΔR covers. The rating carries the element index of D.3, ΔRw,heavy or ΔRw,light.

For a basic element that is not one of the three standard ones, D.3 takes the ratings “directly from the single-number ratings for that basic element with and without the tested acoustical lining”, the direct difference ΔRw,direct of Formula (D.2); that needs both measured curves and is what lab_lining_improvement returns beside this rating.

Parameters

Returns: A ReductionImprovementRating.

Raises

WeightedRatingResult(
    rating: int,
    c: int,
    ctr: int,
    unfavourable_sum: float,
    band_centers: np.ndarray | None = None,
    measured: np.ndarray | None = None,
    shifted_reference: np.ndarray | None = None,
    quantity: Literal['airborne'] = 'airborne',
)

Single-number weighted rating and adaptation terms (ISO 717-1).

Attributes

WeightedRatingResult.plot(
    ax: Axes | None = None,
    *,
    language: str = 'en',
    **kwargs: Any,
) -> Axes

Plot the measured curve vs the shifted reference (ISO 717-1).

Unfavourable deviations (reference above measurement) are shaded and Rw (C; Ctr) annotated. Requires matplotlib (pip install phonometry[plot]); returns the Axes.

WeightedRatingResult.report(
    path: str,
    *,
    metadata: ReportMetadata | None = None,
    engine: str = 'reportlab',
    verbose: bool = False,
    language: str = 'en',
    symbol: str | None = None,
) -> str

Render an ISO 717-1 airborne sound-insulation fiche to a PDF.

Writes a one-page accredited-laboratory report: the standard-basis line, an optional metadata header block, the band table beside the measured-versus-shifted-reference plot (the result’s own plot), the boxed Rw (C; Ctr) result, an optional verdict row and a footer with the fixed disclaimer.

Parameters

Returns: The written path as a str.

Raises