Replace the ISO 17497-2 diffusion oracle with published-provenance data (#348)
The committed 37-receiver polar arc in tests/reference_data.py is now
generated by the library's own Fraunhofer far-field model for a published
geometry: the N = 7 QRD, 6 periods, 3.6 m wide, 0.2 m deep row of
Cox & D'Antonio, Acoustic Absorbers and Diffusers, 3rd ed., Appendix B
(the commercial N = 7 QRD of Hargreaves, Cox, Lam & D'Antonio, JASA 108(4),
1710-1720, 2000, Table I). The arc is an arithmetic oracle for ISO 17497-2
Formulas (5)/(7): d = 0.1099, flat reference d = 0.0049, d_n = 0.1055,
recomputed exactly from the committed rounded levels.
A new external third-party anchor pins the model's one-third-octave
band-averaged normalised diffusion to the published Appendix B 2D BEM values
for that row at normal incidence in the 200-400 Hz bands (agreement within
0.01, asserted at +/-0.015) in the tests and in four new conformance rows.
Across the full published 100-5000 Hz range the model-vs-BEM mean absolute
deviation is about 0.09, documented everywhere as a low-band anchor.
The previous in-house COMSOL simulation arc and its numbers are removed from
the tests, the conformance report, the surface-scattering guide (EN/ES), the
theory pages and the diffusion_polar figure, which now all use the same
published-geometry prediction.
docs: cite Jiménez metamaterial-acoustics work on the materials reference (#341)
The Materials and Surfaces theory page derives surface diffusion and porous
absorber prediction, yet its references frontmatter listed only Cox & D'Antonio
and Allard & Atalla. Add three open-access works by Jiménez and co-workers that
the page already speaks to: the metadiffuser paper (Jiménez, Cox, Romero-García
and Groby, 2017, Scientific Reports) on the surface-diffusion section, and the
two critical-coupling perfect-absorption papers (Jiménez, Groby, Pagneux and
Romero-García, 2017, Applied Sciences; Jiménez, Romero-García and Groby, 2018,
Acta Acustica) on the material-characterisation section.
Reference the same works from the scattering_diffusion and porous_absorber
module docstrings, and regenerate the committed API reference.
Add the edited volume Acoustic Waves in Periodic Structures, Metamaterials, and
Porous Media (Jiménez, Umnova and Groby, Eds., 2021, Springer) to the
bibliography page as a metamaterials companion to Cox & D'Antonio.
Mirror the frontmatter and bibliography changes in the Spanish pages with
translated notes, keeping authors, titles and DOIs identical.
Align Spanish acoustics terminology to UNE-EN wording in figures (#256)
* fix(es): align Spanish acoustics terminology to UNE-EN wording in figures
I correct three Spanish terms in the figure and diagram generators so they
match the official UNE-EN wording already used by the .plot() string tables:
"reducción sonora" becomes "reducción acústica" (sound reduction index R,
UNE-EN ISO 717-1), "reducción vibracional" becomes "reducción de
vibraciones" (vibration reduction index Kij, UNE-EN ISO 10848), and
"potencia sonora" becomes "potencia acústica" (sound power level LW,
UNE-EN ISO 3740 series).
I regenerate the affected Spanish SVG figures with make graphs so the
committed images match the corrected wording, and update the Spanish guide
prose that describes those figures and the underlying concepts to use the
same terminology, fixing one now-stale anchor link along the way.
* fix(es): catch markup-split terms, escaped-unicode figures and revert an over-application
I catch a few gaps the first pass missed. Two figure title/label strings
in generate_graphs.py store their accents as Python \u escapes rather than
literal characters ("reducción sonora"), so my plain-text sed never
matched them; I correct both and regenerate insulation_rating_es and
insulation_uncertainty_demo_es. I also fix a handful of guide-prose
occurrences the earlier sed missed because bold markup or a line wrap
split the phrase across "potencia **X** sonora" or "reducción\nsonora",
and I repoint one anchor link at the new heading slug.
I also revert an over-application: "potencia sonora estructural" (EN
15657's structure-borne power, a distinct quantity from the airborne
ISO 3740 sound power that "potencia acústica" refers to) got swept up by
the earlier global replace. I restore "sonora" there across the generator,
the figure and the guide prose, and fix a "vibroacústica" word that got
split apart by the revert.
docs: refresh install extras and landing pages to current library scope (#274)
* docs: refresh install extras and landing pages to current library scope
The install docs listed only the plot, perf and full extras; add the report
extra (reportlab + svglib, required for the .report() PDF fiches) and fix the
stale 'both' comment on full in the site getting-started pages (EN/ES),
docs/getting-started.md and the README install line.
Refresh the landing pages, which predated most of the library:
- Site index (EN/ES): hero and cards now describe all fifteen domain
namespaces, the 371 conformance checks across 46 domains and 235 standards,
bilingual .plot() figures and the normative .report() PDF fiches.
- Getting started (EN/ES): note that the metrology core is one of fifteen
domains and link Why phonometry and the conformance report.
- Why phonometry (EN/ES): state the current conformance scale beyond the
metrology-core sample table.
- README: current toolkit description, missing domain highlights (hearing,
materials, vibration, aircraft, underwater, electroacoustics, noise control,
FDTD, fiches), five sound-power routes, G weighting, and twelve to fifteen
namespaces.
- Shorten the junction-transmission page titles (EN/ES) to satisfy the
70-character html-validate limit.
* docs: name all standards bodies on the landing description and tighten the ES card wording
Add ANSI, DIN and ECAC/CEAC to the standards-body enumeration in the site
index description (both languages), keep 'con estado' for the stateful block
processing in the Spanish card, and use the Spanish 'Doc 29/32 de la CEAC'
form already used by the Spanish guides.