feat: floor-covering impact improvement on a mock-up (ISO 16251-1:2014) (#130)
Add the laboratory method for the improvement of impact sound insulation ΔL of
soft, locally-reacting floor coverings (carpet, PVC, linoleum) measured on a
small concrete mock-up via structure-borne acceleration levels, plus the
ISO 717-2 weighted improvement ΔLw it feeds.
- weighted_impact_improvement (insulation.py): ISO 717-2:2020 Clause 5 ΔLw =
78 - Ln,r,w using the heavyweight reference floor of Table 4, reusing the
verified weighted_impact_rating engine
- floor_covering_improvement.py (ISO 16251-1):
- acceleration_level (Formula 1, a0 = 1e-6 m/s²)
- background_corrected_level (Formula 2, three-branch rule with a
limit-of-measurement flag)
- impact_improvement: Formula (2) per position -> difference (3) -> mean over
positions (4); accepts (bands,) or (positions, bands) levels
- improvement_octave_bands (Formula 5)
- FloorCoveringImprovementResult with ΔLw, the > ΔL limit mask and .plot()
- Conformance checks: ISO 717-2 reference-floor rating (78 dB, CI -11) and the
ΔL=0 -> ΔLw=0 identity (109/109). ISO 16251-1 has no worked numeric example
(Annex B is a blank form), so the oracle is the ISO 717-2 reference floor.
- generate_floor_covering_improvement figure (EN/ES × light/dark)
- Building-acoustics guide §7 and API reference rows (EN + ES)
- 20 tests covering all formulas, the per-position ordering and validation
Standards traceability fixes and the target taxonomy (#118)
* docs: traceability fixes and the target taxonomy
Approved conclusions of the standards-traceability report:
Traceability (P1):
- the room-acoustics footer claimed ISO 3382-3:2022 while the code
implements and verifies :2012 - the footer now tells the truth
- CONFORMANCE.md becomes visible: a Reference page on the site (EN/ES)
explains the report and links the generated table (copying 300
auto-generated lines would drift), docs/README.md indexes it, and
why-phonometry links it after its comparison table
- nine citation patches with honest scoping: the ISO 1996-2 facade
claim reworded as measurement context; ECMA-74 out of the
tone-prominence footer (context note added); ISO 9613-1 declared in
surface-scattering with clause delimitation; materials cites the
BS EN ISO 10534:2001 editions the code cites; the EN 12354 typo;
ISO 266 and ISO 5725 added with narrow scope; IEC 61252 designations
unified
- class_limits exported (it was public-but-unimportable), documented in
the API reference and surfaced in filter-banks section 6
Taxonomy (approved target, sidebar moves only - zero URL changes):
- renamed: Signal processing & filters
- new groups: Instrumentation, calibration & compliance; Materials &
surfaces
- Perception & speech splits into Psychoacoustics (+tone-prominence),
Speech & intelligibility, and Hearing & occupational exposure
(+occupational-exposure)
- docs/README.md mirrors the new order; Conformance joins Reference
* docs: terminology polish on the new conformance pages
key differentiator (not 'differential asset'), governing band/frequency
(not 'binding'), pasa/no pasa, expresiones en forma cerrada, 'en la que
se basan las etiquetas nominales', and air-attenuation relations in
both languages (Gemini)
Standards traceability fixes and the target taxonomy (#118)
* docs: traceability fixes and the target taxonomy
Approved conclusions of the standards-traceability report:
Traceability (P1):
- the room-acoustics footer claimed ISO 3382-3:2022 while the code
implements and verifies :2012 - the footer now tells the truth
- CONFORMANCE.md becomes visible: a Reference page on the site (EN/ES)
explains the report and links the generated table (copying 300
auto-generated lines would drift), docs/README.md indexes it, and
why-phonometry links it after its comparison table
- nine citation patches with honest scoping: the ISO 1996-2 facade
claim reworded as measurement context; ECMA-74 out of the
tone-prominence footer (context note added); ISO 9613-1 declared in
surface-scattering with clause delimitation; materials cites the
BS EN ISO 10534:2001 editions the code cites; the EN 12354 typo;
ISO 266 and ISO 5725 added with narrow scope; IEC 61252 designations
unified
- class_limits exported (it was public-but-unimportable), documented in
the API reference and surfaced in filter-banks section 6
Taxonomy (approved target, sidebar moves only - zero URL changes):
- renamed: Signal processing & filters
- new groups: Instrumentation, calibration & compliance; Materials &
surfaces
- Perception & speech splits into Psychoacoustics (+tone-prominence),
Speech & intelligibility, and Hearing & occupational exposure
(+occupational-exposure)
- docs/README.md mirrors the new order; Conformance joins Reference
* docs: terminology polish on the new conformance pages
key differentiator (not 'differential asset'), governing band/frequency
(not 'binding'), pasa/no pasa, expresiones en forma cerrada, 'en la que
se basan las etiquetas nominales', and air-attenuation relations in
both languages (Gemini)