Spanish docs: UNE terminology, decimal commas, localized snippets and theory figures (#365)
* Normalize Spanish docs prose to UNE acoustic terminology
Sweep the Spanish pages for the non-UNE forms "presion sonora",
"potencia sonora" and "intensidad sonora" and normalize the prose to
the wording used by the official Spanish editions of the standards:
"presion acustica" (UNE-EN ISO 16283-2:2016, UNE-EN ISO 10052:2005,
UNE-EN ISO 3746:2011, UNE-ISO 226:2013), "potencia acustica"
(UNE-EN ISO 3746:2011, UNE-EN ISO 4871:2010, UNE-EN ISO 9614-1:2010),
"intensidad acustica" (UNE-EN 61043:1999, UNE-EN ISO 9614-1:2010) and
"nivel de presion acustica de impactos" (UNE-EN ISO 12354-2:2018,
UNE-EN ISO 717-2:2013). 92 replacements across 32 pages, prose only:
code snippets keep the labels they share with the generated figures.
Rename the intensity guide to "Intensidad acustica (p-p)" and the
structure-borne power guide to "Potencia acustica estructural de
equipos (EN 15657)", updating every cross-link text and the theory
anchor intensidad-sonora-iec-61043 accordingly. The API sidebar group
label becomes "Potencia acustica e intensidad" via api_taxonomy.py
with the generated sidebar regenerated.
* Use decimal commas in Spanish docs prose quantities
Sweep every Spanish page for decimal points leaking into prose numbers
and switch them to the comma the locale convention calls for: the
rotorcraft validation prose (fourteen tolerances such as 0,08 dB(A) and
0,5 s), the insulation-prediction worked example (53,6 dB / 53,8 dB),
the tone-audibility Annex E tone (137,3 Hz), the Mackenzie check value
(1550,744 m/s), the EPNL, loudness and absorption fiche descriptions
(98,3 EPNdB; 8,2 sonos and 70,4 fonios; 0,60 y 0,55), the junction
constants table and the third-octave band-edge table in the signal
analysis theory page. Code snippets, inline code, math, clause numbers
and quoted source text keep their points.
* Pass language="es" in Spanish figure-reproduction snippets
The <details> blocks under each localized figure in the Spanish guides
are meant to reproduce the _es variant shown on the page, but 82 of the
one-line result .plot() calls omitted the language="es" argument and
would render English axis labels instead. Add the argument across 33
guides, matching the pattern the intensity field-indicators snippet
already used. The three lab-insulation results whose plot() does not
take a language argument (lab airborne, lab impact and the
element-normalized intensity difference) are left as they were.
* Extend the UNE terminology sweep to sound absorption
Normalize "absorción sonora" to "absorción acústica" across the
Spanish pages (36 occurrences in 14 pages, including the EN 12354-6
guide title and the theory headings), the wording of UNE-EN ISO
3746:2011 and of the equivalent absorption area in UNE-EN ISO
10140-3:2011, UNE-EN ISO 12354-2:2018 and UNE-EN ISO 16283-2:2016, and
the same term the accredited report strings already use. Also restore
the accent in the theory index anchor to the renamed intensity heading,
since heading slugs keep accented characters.
* Theory pages: illustrate each section family with existing result figures
The seven theory pages carried no figures at all. Embed sixteen of the
existing generated figures (light and dark variants, Spanish variants on
the Spanish mirrors) where the concept matches the prose: weighting
curves, time integration and the p-p intensity estimator in the signal
analysis page; equal-loudness contours, the specific-loudness pattern
and the hearing-threshold panels in perception; NC/RC rating, the
Schroeder decay and the ISO 717-1 shifted reference in rooms and
buildings; the Lden profile, ISO 9613-1 absorption and the three sound
power routes in environment and transport; the scattering coefficient
and ISO 11654 rating in materials and surfaces; and the Wk weighting and
the resonator mobility triplet in vibration. Each embed reuses the alt
text of the guide that owns the figure and adds a one-line caption.
Also give the wave-simulation section hub the reading-order paragraph
its siblings already have, linking the closed-form pages the FDTD solver
cross-checks, in both languages.
* Address review findings from the Spanish locale sweeps
Second pass fixes flagged by review: five terminology occurrences the
line-based sweep missed because the noun and adjective were split by a
line wrap or emphasis markup (sound-power, rotorcraft-noise and two
section hubs); six Spanish pages that still embedded the English figure
variant although the _es variant exists (junction-transmission,
aircraft-noise airport contour, miso-coherence,
objective-intelligibility, psychoacoustic-annoyance twice); and 19 more
language="es" arguments on figure-reproduction plot calls the first
pass missed, chained-call receivers such as room.noise_criterion(spl)
.plot() and the axes-creating first call of the two-profile
atmospheric-refraction snippet among them. The lab-insulation plot
wrappers forward keyword arguments to the rating plot, so the three
calls excluded earlier now take the argument too. All Spanish python
fences re-checked to compile and EN/ES parity re-verified.
* Carry the UNE terminology into the generated-asset Spanish strings
Apply the same evidence-based decisions to every Spanish string source
that feeds generated assets: the translation tables of
generate_graphs.py and generate_diagrams.py, the _STRINGS tables of the
plot modules and the report i18n values. 35 strings change: "presión
acústica" (UNE-EN ISO 16283-2:2016, 10052:2005, 3746:2011),
"potencia acústica" (UNE-EN ISO 3746:2011, 4871:2010, 9614-1:2010),
"intensidad acústica" (UNE-EN 61043:1999, 9614-1:2010), "absorción
acústica" (UNE-EN ISO 3746:2011) and "nivel de presión acústica de
impactos" (UNE-EN ISO 12354-2:2018). Strings the UNE editions keep are
untouched: "emisión sonora", "exposición sonora", "campo sonoro",
"fuente sonora". Only Spanish values change; the English keys stay.
The two plot-i18n test assertions that pin the axis label follow, and
the eight Spanish doc fences that deliberately mirrored the old figure
labels now mirror the new ones.
* Regenerate the Spanish figure variants with the UNE terminology
make graphs after the string-source change: 48 files, all of them _es
or _es_dark variants (24 figure/diagram pairs), picking up "presión
acústica", "potencia acústica", "intensidad acústica", "absorción
acústica" and "nivel de presión acústica de impactos" in titles and
axis labels. The English variants are untouched. The committed example
fiches need no regeneration: every example in generate_reports.py
renders in English, so no changed Spanish report string reaches them.
* Align the intensity-fiche Spanish assertions with the UNE terminology
Spanish docs: UNE terminology, decimal commas, localized snippets and theory figures (#365)
* Normalize Spanish docs prose to UNE acoustic terminology
Sweep the Spanish pages for the non-UNE forms "presion sonora",
"potencia sonora" and "intensidad sonora" and normalize the prose to
the wording used by the official Spanish editions of the standards:
"presion acustica" (UNE-EN ISO 16283-2:2016, UNE-EN ISO 10052:2005,
UNE-EN ISO 3746:2011, UNE-ISO 226:2013), "potencia acustica"
(UNE-EN ISO 3746:2011, UNE-EN ISO 4871:2010, UNE-EN ISO 9614-1:2010),
"intensidad acustica" (UNE-EN 61043:1999, UNE-EN ISO 9614-1:2010) and
"nivel de presion acustica de impactos" (UNE-EN ISO 12354-2:2018,
UNE-EN ISO 717-2:2013). 92 replacements across 32 pages, prose only:
code snippets keep the labels they share with the generated figures.
Rename the intensity guide to "Intensidad acustica (p-p)" and the
structure-borne power guide to "Potencia acustica estructural de
equipos (EN 15657)", updating every cross-link text and the theory
anchor intensidad-sonora-iec-61043 accordingly. The API sidebar group
label becomes "Potencia acustica e intensidad" via api_taxonomy.py
with the generated sidebar regenerated.
* Use decimal commas in Spanish docs prose quantities
Sweep every Spanish page for decimal points leaking into prose numbers
and switch them to the comma the locale convention calls for: the
rotorcraft validation prose (fourteen tolerances such as 0,08 dB(A) and
0,5 s), the insulation-prediction worked example (53,6 dB / 53,8 dB),
the tone-audibility Annex E tone (137,3 Hz), the Mackenzie check value
(1550,744 m/s), the EPNL, loudness and absorption fiche descriptions
(98,3 EPNdB; 8,2 sonos and 70,4 fonios; 0,60 y 0,55), the junction
constants table and the third-octave band-edge table in the signal
analysis theory page. Code snippets, inline code, math, clause numbers
and quoted source text keep their points.
* Pass language="es" in Spanish figure-reproduction snippets
The <details> blocks under each localized figure in the Spanish guides
are meant to reproduce the _es variant shown on the page, but 82 of the
one-line result .plot() calls omitted the language="es" argument and
would render English axis labels instead. Add the argument across 33
guides, matching the pattern the intensity field-indicators snippet
already used. The three lab-insulation results whose plot() does not
take a language argument (lab airborne, lab impact and the
element-normalized intensity difference) are left as they were.
* Extend the UNE terminology sweep to sound absorption
Normalize "absorción sonora" to "absorción acústica" across the
Spanish pages (36 occurrences in 14 pages, including the EN 12354-6
guide title and the theory headings), the wording of UNE-EN ISO
3746:2011 and of the equivalent absorption area in UNE-EN ISO
10140-3:2011, UNE-EN ISO 12354-2:2018 and UNE-EN ISO 16283-2:2016, and
the same term the accredited report strings already use. Also restore
the accent in the theory index anchor to the renamed intensity heading,
since heading slugs keep accented characters.
* Theory pages: illustrate each section family with existing result figures
The seven theory pages carried no figures at all. Embed sixteen of the
existing generated figures (light and dark variants, Spanish variants on
the Spanish mirrors) where the concept matches the prose: weighting
curves, time integration and the p-p intensity estimator in the signal
analysis page; equal-loudness contours, the specific-loudness pattern
and the hearing-threshold panels in perception; NC/RC rating, the
Schroeder decay and the ISO 717-1 shifted reference in rooms and
buildings; the Lden profile, ISO 9613-1 absorption and the three sound
power routes in environment and transport; the scattering coefficient
and ISO 11654 rating in materials and surfaces; and the Wk weighting and
the resonator mobility triplet in vibration. Each embed reuses the alt
text of the guide that owns the figure and adds a one-line caption.
Also give the wave-simulation section hub the reading-order paragraph
its siblings already have, linking the closed-form pages the FDTD solver
cross-checks, in both languages.
* Address review findings from the Spanish locale sweeps
Second pass fixes flagged by review: five terminology occurrences the
line-based sweep missed because the noun and adjective were split by a
line wrap or emphasis markup (sound-power, rotorcraft-noise and two
section hubs); six Spanish pages that still embedded the English figure
variant although the _es variant exists (junction-transmission,
aircraft-noise airport contour, miso-coherence,
objective-intelligibility, psychoacoustic-annoyance twice); and 19 more
language="es" arguments on figure-reproduction plot calls the first
pass missed, chained-call receivers such as room.noise_criterion(spl)
.plot() and the axes-creating first call of the two-profile
atmospheric-refraction snippet among them. The lab-insulation plot
wrappers forward keyword arguments to the rating plot, so the three
calls excluded earlier now take the argument too. All Spanish python
fences re-checked to compile and EN/ES parity re-verified.
* Carry the UNE terminology into the generated-asset Spanish strings
Apply the same evidence-based decisions to every Spanish string source
that feeds generated assets: the translation tables of
generate_graphs.py and generate_diagrams.py, the _STRINGS tables of the
plot modules and the report i18n values. 35 strings change: "presión
acústica" (UNE-EN ISO 16283-2:2016, 10052:2005, 3746:2011),
"potencia acústica" (UNE-EN ISO 3746:2011, 4871:2010, 9614-1:2010),
"intensidad acústica" (UNE-EN 61043:1999, 9614-1:2010), "absorción
acústica" (UNE-EN ISO 3746:2011) and "nivel de presión acústica de
impactos" (UNE-EN ISO 12354-2:2018). Strings the UNE editions keep are
untouched: "emisión sonora", "exposición sonora", "campo sonoro",
"fuente sonora". Only Spanish values change; the English keys stay.
The two plot-i18n test assertions that pin the axis label follow, and
the eight Spanish doc fences that deliberately mirrored the old figure
labels now mirror the new ones.
* Regenerate the Spanish figure variants with the UNE terminology
make graphs after the string-source change: 48 files, all of them _es
or _es_dark variants (24 figure/diagram pairs), picking up "presión
acústica", "potencia acústica", "intensidad acústica", "absorción
acústica" and "nivel de presión acústica de impactos" in titles and
axis labels. The English variants are untouched. The committed example
fiches need no regeneration: every example in generate_reports.py
renders in English, so no changed Spanish report string reaches them.
* Align the intensity-fiche Spanish assertions with the UNE terminology
Spanish docs: UNE terminology, decimal commas, localized snippets and theory figures (#365)
* Normalize Spanish docs prose to UNE acoustic terminology
Sweep the Spanish pages for the non-UNE forms "presion sonora",
"potencia sonora" and "intensidad sonora" and normalize the prose to
the wording used by the official Spanish editions of the standards:
"presion acustica" (UNE-EN ISO 16283-2:2016, UNE-EN ISO 10052:2005,
UNE-EN ISO 3746:2011, UNE-ISO 226:2013), "potencia acustica"
(UNE-EN ISO 3746:2011, UNE-EN ISO 4871:2010, UNE-EN ISO 9614-1:2010),
"intensidad acustica" (UNE-EN 61043:1999, UNE-EN ISO 9614-1:2010) and
"nivel de presion acustica de impactos" (UNE-EN ISO 12354-2:2018,
UNE-EN ISO 717-2:2013). 92 replacements across 32 pages, prose only:
code snippets keep the labels they share with the generated figures.
Rename the intensity guide to "Intensidad acustica (p-p)" and the
structure-borne power guide to "Potencia acustica estructural de
equipos (EN 15657)", updating every cross-link text and the theory
anchor intensidad-sonora-iec-61043 accordingly. The API sidebar group
label becomes "Potencia acustica e intensidad" via api_taxonomy.py
with the generated sidebar regenerated.
* Use decimal commas in Spanish docs prose quantities
Sweep every Spanish page for decimal points leaking into prose numbers
and switch them to the comma the locale convention calls for: the
rotorcraft validation prose (fourteen tolerances such as 0,08 dB(A) and
0,5 s), the insulation-prediction worked example (53,6 dB / 53,8 dB),
the tone-audibility Annex E tone (137,3 Hz), the Mackenzie check value
(1550,744 m/s), the EPNL, loudness and absorption fiche descriptions
(98,3 EPNdB; 8,2 sonos and 70,4 fonios; 0,60 y 0,55), the junction
constants table and the third-octave band-edge table in the signal
analysis theory page. Code snippets, inline code, math, clause numbers
and quoted source text keep their points.
* Pass language="es" in Spanish figure-reproduction snippets
The <details> blocks under each localized figure in the Spanish guides
are meant to reproduce the _es variant shown on the page, but 82 of the
one-line result .plot() calls omitted the language="es" argument and
would render English axis labels instead. Add the argument across 33
guides, matching the pattern the intensity field-indicators snippet
already used. The three lab-insulation results whose plot() does not
take a language argument (lab airborne, lab impact and the
element-normalized intensity difference) are left as they were.
* Extend the UNE terminology sweep to sound absorption
Normalize "absorción sonora" to "absorción acústica" across the
Spanish pages (36 occurrences in 14 pages, including the EN 12354-6
guide title and the theory headings), the wording of UNE-EN ISO
3746:2011 and of the equivalent absorption area in UNE-EN ISO
10140-3:2011, UNE-EN ISO 12354-2:2018 and UNE-EN ISO 16283-2:2016, and
the same term the accredited report strings already use. Also restore
the accent in the theory index anchor to the renamed intensity heading,
since heading slugs keep accented characters.
* Theory pages: illustrate each section family with existing result figures
The seven theory pages carried no figures at all. Embed sixteen of the
existing generated figures (light and dark variants, Spanish variants on
the Spanish mirrors) where the concept matches the prose: weighting
curves, time integration and the p-p intensity estimator in the signal
analysis page; equal-loudness contours, the specific-loudness pattern
and the hearing-threshold panels in perception; NC/RC rating, the
Schroeder decay and the ISO 717-1 shifted reference in rooms and
buildings; the Lden profile, ISO 9613-1 absorption and the three sound
power routes in environment and transport; the scattering coefficient
and ISO 11654 rating in materials and surfaces; and the Wk weighting and
the resonator mobility triplet in vibration. Each embed reuses the alt
text of the guide that owns the figure and adds a one-line caption.
Also give the wave-simulation section hub the reading-order paragraph
its siblings already have, linking the closed-form pages the FDTD solver
cross-checks, in both languages.
* Address review findings from the Spanish locale sweeps
Second pass fixes flagged by review: five terminology occurrences the
line-based sweep missed because the noun and adjective were split by a
line wrap or emphasis markup (sound-power, rotorcraft-noise and two
section hubs); six Spanish pages that still embedded the English figure
variant although the _es variant exists (junction-transmission,
aircraft-noise airport contour, miso-coherence,
objective-intelligibility, psychoacoustic-annoyance twice); and 19 more
language="es" arguments on figure-reproduction plot calls the first
pass missed, chained-call receivers such as room.noise_criterion(spl)
.plot() and the axes-creating first call of the two-profile
atmospheric-refraction snippet among them. The lab-insulation plot
wrappers forward keyword arguments to the rating plot, so the three
calls excluded earlier now take the argument too. All Spanish python
fences re-checked to compile and EN/ES parity re-verified.
* Carry the UNE terminology into the generated-asset Spanish strings
Apply the same evidence-based decisions to every Spanish string source
that feeds generated assets: the translation tables of
generate_graphs.py and generate_diagrams.py, the _STRINGS tables of the
plot modules and the report i18n values. 35 strings change: "presión
acústica" (UNE-EN ISO 16283-2:2016, 10052:2005, 3746:2011),
"potencia acústica" (UNE-EN ISO 3746:2011, 4871:2010, 9614-1:2010),
"intensidad acústica" (UNE-EN 61043:1999, 9614-1:2010), "absorción
acústica" (UNE-EN ISO 3746:2011) and "nivel de presión acústica de
impactos" (UNE-EN ISO 12354-2:2018). Strings the UNE editions keep are
untouched: "emisión sonora", "exposición sonora", "campo sonoro",
"fuente sonora". Only Spanish values change; the English keys stay.
The two plot-i18n test assertions that pin the axis label follow, and
the eight Spanish doc fences that deliberately mirrored the old figure
labels now mirror the new ones.
* Regenerate the Spanish figure variants with the UNE terminology
make graphs after the string-source change: 48 files, all of them _es
or _es_dark variants (24 figure/diagram pairs), picking up "presión
acústica", "potencia acústica", "intensidad acústica", "absorción
acústica" and "nivel de presión acústica de impactos" in titles and
axis labels. The English variants are untouched. The committed example
fiches need no regeneration: every example in generate_reports.py
renders in English, so no changed Spanish report string reaches them.
* Align the intensity-fiche Spanish assertions with the UNE terminology
Spanish docs: UNE terminology, decimal commas, localized snippets and theory figures (#365)
* Normalize Spanish docs prose to UNE acoustic terminology
Sweep the Spanish pages for the non-UNE forms "presion sonora",
"potencia sonora" and "intensidad sonora" and normalize the prose to
the wording used by the official Spanish editions of the standards:
"presion acustica" (UNE-EN ISO 16283-2:2016, UNE-EN ISO 10052:2005,
UNE-EN ISO 3746:2011, UNE-ISO 226:2013), "potencia acustica"
(UNE-EN ISO 3746:2011, UNE-EN ISO 4871:2010, UNE-EN ISO 9614-1:2010),
"intensidad acustica" (UNE-EN 61043:1999, UNE-EN ISO 9614-1:2010) and
"nivel de presion acustica de impactos" (UNE-EN ISO 12354-2:2018,
UNE-EN ISO 717-2:2013). 92 replacements across 32 pages, prose only:
code snippets keep the labels they share with the generated figures.
Rename the intensity guide to "Intensidad acustica (p-p)" and the
structure-borne power guide to "Potencia acustica estructural de
equipos (EN 15657)", updating every cross-link text and the theory
anchor intensidad-sonora-iec-61043 accordingly. The API sidebar group
label becomes "Potencia acustica e intensidad" via api_taxonomy.py
with the generated sidebar regenerated.
* Use decimal commas in Spanish docs prose quantities
Sweep every Spanish page for decimal points leaking into prose numbers
and switch them to the comma the locale convention calls for: the
rotorcraft validation prose (fourteen tolerances such as 0,08 dB(A) and
0,5 s), the insulation-prediction worked example (53,6 dB / 53,8 dB),
the tone-audibility Annex E tone (137,3 Hz), the Mackenzie check value
(1550,744 m/s), the EPNL, loudness and absorption fiche descriptions
(98,3 EPNdB; 8,2 sonos and 70,4 fonios; 0,60 y 0,55), the junction
constants table and the third-octave band-edge table in the signal
analysis theory page. Code snippets, inline code, math, clause numbers
and quoted source text keep their points.
* Pass language="es" in Spanish figure-reproduction snippets
The <details> blocks under each localized figure in the Spanish guides
are meant to reproduce the _es variant shown on the page, but 82 of the
one-line result .plot() calls omitted the language="es" argument and
would render English axis labels instead. Add the argument across 33
guides, matching the pattern the intensity field-indicators snippet
already used. The three lab-insulation results whose plot() does not
take a language argument (lab airborne, lab impact and the
element-normalized intensity difference) are left as they were.
* Extend the UNE terminology sweep to sound absorption
Normalize "absorción sonora" to "absorción acústica" across the
Spanish pages (36 occurrences in 14 pages, including the EN 12354-6
guide title and the theory headings), the wording of UNE-EN ISO
3746:2011 and of the equivalent absorption area in UNE-EN ISO
10140-3:2011, UNE-EN ISO 12354-2:2018 and UNE-EN ISO 16283-2:2016, and
the same term the accredited report strings already use. Also restore
the accent in the theory index anchor to the renamed intensity heading,
since heading slugs keep accented characters.
* Theory pages: illustrate each section family with existing result figures
The seven theory pages carried no figures at all. Embed sixteen of the
existing generated figures (light and dark variants, Spanish variants on
the Spanish mirrors) where the concept matches the prose: weighting
curves, time integration and the p-p intensity estimator in the signal
analysis page; equal-loudness contours, the specific-loudness pattern
and the hearing-threshold panels in perception; NC/RC rating, the
Schroeder decay and the ISO 717-1 shifted reference in rooms and
buildings; the Lden profile, ISO 9613-1 absorption and the three sound
power routes in environment and transport; the scattering coefficient
and ISO 11654 rating in materials and surfaces; and the Wk weighting and
the resonator mobility triplet in vibration. Each embed reuses the alt
text of the guide that owns the figure and adds a one-line caption.
Also give the wave-simulation section hub the reading-order paragraph
its siblings already have, linking the closed-form pages the FDTD solver
cross-checks, in both languages.
* Address review findings from the Spanish locale sweeps
Second pass fixes flagged by review: five terminology occurrences the
line-based sweep missed because the noun and adjective were split by a
line wrap or emphasis markup (sound-power, rotorcraft-noise and two
section hubs); six Spanish pages that still embedded the English figure
variant although the _es variant exists (junction-transmission,
aircraft-noise airport contour, miso-coherence,
objective-intelligibility, psychoacoustic-annoyance twice); and 19 more
language="es" arguments on figure-reproduction plot calls the first
pass missed, chained-call receivers such as room.noise_criterion(spl)
.plot() and the axes-creating first call of the two-profile
atmospheric-refraction snippet among them. The lab-insulation plot
wrappers forward keyword arguments to the rating plot, so the three
calls excluded earlier now take the argument too. All Spanish python
fences re-checked to compile and EN/ES parity re-verified.
* Carry the UNE terminology into the generated-asset Spanish strings
Apply the same evidence-based decisions to every Spanish string source
that feeds generated assets: the translation tables of
generate_graphs.py and generate_diagrams.py, the _STRINGS tables of the
plot modules and the report i18n values. 35 strings change: "presión
acústica" (UNE-EN ISO 16283-2:2016, 10052:2005, 3746:2011),
"potencia acústica" (UNE-EN ISO 3746:2011, 4871:2010, 9614-1:2010),
"intensidad acústica" (UNE-EN 61043:1999, 9614-1:2010), "absorción
acústica" (UNE-EN ISO 3746:2011) and "nivel de presión acústica de
impactos" (UNE-EN ISO 12354-2:2018). Strings the UNE editions keep are
untouched: "emisión sonora", "exposición sonora", "campo sonoro",
"fuente sonora". Only Spanish values change; the English keys stay.
The two plot-i18n test assertions that pin the axis label follow, and
the eight Spanish doc fences that deliberately mirrored the old figure
labels now mirror the new ones.
* Regenerate the Spanish figure variants with the UNE terminology
make graphs after the string-source change: 48 files, all of them _es
or _es_dark variants (24 figure/diagram pairs), picking up "presión
acústica", "potencia acústica", "intensidad acústica", "absorción
acústica" and "nivel de presión acústica de impactos" in titles and
axis labels. The English variants are untouched. The committed example
fiches need no regeneration: every example in generate_reports.py
renders in English, so no changed Spanish report string reaches them.
* Align the intensity-fiche Spanish assertions with the UNE terminology
Spanish docs: UNE terminology, decimal commas, localized snippets and theory figures (#365)
* Normalize Spanish docs prose to UNE acoustic terminology
Sweep the Spanish pages for the non-UNE forms "presion sonora",
"potencia sonora" and "intensidad sonora" and normalize the prose to
the wording used by the official Spanish editions of the standards:
"presion acustica" (UNE-EN ISO 16283-2:2016, UNE-EN ISO 10052:2005,
UNE-EN ISO 3746:2011, UNE-ISO 226:2013), "potencia acustica"
(UNE-EN ISO 3746:2011, UNE-EN ISO 4871:2010, UNE-EN ISO 9614-1:2010),
"intensidad acustica" (UNE-EN 61043:1999, UNE-EN ISO 9614-1:2010) and
"nivel de presion acustica de impactos" (UNE-EN ISO 12354-2:2018,
UNE-EN ISO 717-2:2013). 92 replacements across 32 pages, prose only:
code snippets keep the labels they share with the generated figures.
Rename the intensity guide to "Intensidad acustica (p-p)" and the
structure-borne power guide to "Potencia acustica estructural de
equipos (EN 15657)", updating every cross-link text and the theory
anchor intensidad-sonora-iec-61043 accordingly. The API sidebar group
label becomes "Potencia acustica e intensidad" via api_taxonomy.py
with the generated sidebar regenerated.
* Use decimal commas in Spanish docs prose quantities
Sweep every Spanish page for decimal points leaking into prose numbers
and switch them to the comma the locale convention calls for: the
rotorcraft validation prose (fourteen tolerances such as 0,08 dB(A) and
0,5 s), the insulation-prediction worked example (53,6 dB / 53,8 dB),
the tone-audibility Annex E tone (137,3 Hz), the Mackenzie check value
(1550,744 m/s), the EPNL, loudness and absorption fiche descriptions
(98,3 EPNdB; 8,2 sonos and 70,4 fonios; 0,60 y 0,55), the junction
constants table and the third-octave band-edge table in the signal
analysis theory page. Code snippets, inline code, math, clause numbers
and quoted source text keep their points.
* Pass language="es" in Spanish figure-reproduction snippets
The <details> blocks under each localized figure in the Spanish guides
are meant to reproduce the _es variant shown on the page, but 82 of the
one-line result .plot() calls omitted the language="es" argument and
would render English axis labels instead. Add the argument across 33
guides, matching the pattern the intensity field-indicators snippet
already used. The three lab-insulation results whose plot() does not
take a language argument (lab airborne, lab impact and the
element-normalized intensity difference) are left as they were.
* Extend the UNE terminology sweep to sound absorption
Normalize "absorción sonora" to "absorción acústica" across the
Spanish pages (36 occurrences in 14 pages, including the EN 12354-6
guide title and the theory headings), the wording of UNE-EN ISO
3746:2011 and of the equivalent absorption area in UNE-EN ISO
10140-3:2011, UNE-EN ISO 12354-2:2018 and UNE-EN ISO 16283-2:2016, and
the same term the accredited report strings already use. Also restore
the accent in the theory index anchor to the renamed intensity heading,
since heading slugs keep accented characters.
* Theory pages: illustrate each section family with existing result figures
The seven theory pages carried no figures at all. Embed sixteen of the
existing generated figures (light and dark variants, Spanish variants on
the Spanish mirrors) where the concept matches the prose: weighting
curves, time integration and the p-p intensity estimator in the signal
analysis page; equal-loudness contours, the specific-loudness pattern
and the hearing-threshold panels in perception; NC/RC rating, the
Schroeder decay and the ISO 717-1 shifted reference in rooms and
buildings; the Lden profile, ISO 9613-1 absorption and the three sound
power routes in environment and transport; the scattering coefficient
and ISO 11654 rating in materials and surfaces; and the Wk weighting and
the resonator mobility triplet in vibration. Each embed reuses the alt
text of the guide that owns the figure and adds a one-line caption.
Also give the wave-simulation section hub the reading-order paragraph
its siblings already have, linking the closed-form pages the FDTD solver
cross-checks, in both languages.
* Address review findings from the Spanish locale sweeps
Second pass fixes flagged by review: five terminology occurrences the
line-based sweep missed because the noun and adjective were split by a
line wrap or emphasis markup (sound-power, rotorcraft-noise and two
section hubs); six Spanish pages that still embedded the English figure
variant although the _es variant exists (junction-transmission,
aircraft-noise airport contour, miso-coherence,
objective-intelligibility, psychoacoustic-annoyance twice); and 19 more
language="es" arguments on figure-reproduction plot calls the first
pass missed, chained-call receivers such as room.noise_criterion(spl)
.plot() and the axes-creating first call of the two-profile
atmospheric-refraction snippet among them. The lab-insulation plot
wrappers forward keyword arguments to the rating plot, so the three
calls excluded earlier now take the argument too. All Spanish python
fences re-checked to compile and EN/ES parity re-verified.
* Carry the UNE terminology into the generated-asset Spanish strings
Apply the same evidence-based decisions to every Spanish string source
that feeds generated assets: the translation tables of
generate_graphs.py and generate_diagrams.py, the _STRINGS tables of the
plot modules and the report i18n values. 35 strings change: "presión
acústica" (UNE-EN ISO 16283-2:2016, 10052:2005, 3746:2011),
"potencia acústica" (UNE-EN ISO 3746:2011, 4871:2010, 9614-1:2010),
"intensidad acústica" (UNE-EN 61043:1999, 9614-1:2010), "absorción
acústica" (UNE-EN ISO 3746:2011) and "nivel de presión acústica de
impactos" (UNE-EN ISO 12354-2:2018). Strings the UNE editions keep are
untouched: "emisión sonora", "exposición sonora", "campo sonoro",
"fuente sonora". Only Spanish values change; the English keys stay.
The two plot-i18n test assertions that pin the axis label follow, and
the eight Spanish doc fences that deliberately mirrored the old figure
labels now mirror the new ones.
* Regenerate the Spanish figure variants with the UNE terminology
make graphs after the string-source change: 48 files, all of them _es
or _es_dark variants (24 figure/diagram pairs), picking up "presión
acústica", "potencia acústica", "intensidad acústica", "absorción
acústica" and "nivel de presión acústica de impactos" in titles and
axis labels. The English variants are untouched. The committed example
fiches need no regeneration: every example in generate_reports.py
renders in English, so no changed Spanish report string reaches them.
* Align the intensity-fiche Spanish assertions with the UNE terminology
Perception, hearing and speech guides: result figures and when-to-use prose (#361)
* Perception, hearing and speech guides: result figures and when-to-use prose
Add ToneAssessment.plot(), which draws an ECMA-418-1 tone against the
prominence criterion of its own method (recovered from criterion_db) over the
whole range of interest, with the deciding margin marked, and a
view="levels" option on ToneAudibilityResult.plot() that exposes the
level-versus-frequency view the ISO 1996-2 fiche already embedded.
Add eleven single-concept figures to the perception, hearing and speech
guides, each a realistic result drawn by its own .plot(): the tone prominence
verdict, the ISO/PAS 20065 tone levels, the ISO/PAS 1996-3 onset detection,
the ISO 532-2 specific loudness, the ECMA-418-2 specific tonality, the
specific fluctuation strength, the SII band audibility under a hearing loss,
the ISO 7029 fractile band, the ISO 1999 NIPTS audiogram, the STOI per-band
correlation and the IEC 60268-16 per-band MTI. Every figure is embedded in
the English guide, the Spanish mirror and the docs mirror with the dual
snippet block, and every plottable snippet on those pages now names its
.plot().
Prose: the tone-prominence guide gains a comparison of the four tonality
assessments the library implements and when each applies, the
hearing-threshold guide explains how the ISO 7029 fractiles feed the ISO 1999
age component and gains a See-also section, and the objective-intelligibility
guide gains the "which measure, and when" section that existed only in the
docs mirror, extended with the STOI/ESTOI, STI and SII choice.
Also label the STOI band axis at whole-hertz resolution and let the shaded
critical band of the tone-audibility levels plot follow the figure
background, so it reads on the white report page and on dark figures alike.
* Correct two figure alt texts against the plotted values
The ISO 7029 fractile figure describes the median and the 90 % fractile with
the values it actually draws (10 to 50 dB and 22 to 74 dB), and the
ECMA-418-2 specific tonality peak is at 9 Bark_HMS.
Perception, hearing and speech guides: result figures and when-to-use prose (#361)
* Perception, hearing and speech guides: result figures and when-to-use prose
Add ToneAssessment.plot(), which draws an ECMA-418-1 tone against the
prominence criterion of its own method (recovered from criterion_db) over the
whole range of interest, with the deciding margin marked, and a
view="levels" option on ToneAudibilityResult.plot() that exposes the
level-versus-frequency view the ISO 1996-2 fiche already embedded.
Add eleven single-concept figures to the perception, hearing and speech
guides, each a realistic result drawn by its own .plot(): the tone prominence
verdict, the ISO/PAS 20065 tone levels, the ISO/PAS 1996-3 onset detection,
the ISO 532-2 specific loudness, the ECMA-418-2 specific tonality, the
specific fluctuation strength, the SII band audibility under a hearing loss,
the ISO 7029 fractile band, the ISO 1999 NIPTS audiogram, the STOI per-band
correlation and the IEC 60268-16 per-band MTI. Every figure is embedded in
the English guide, the Spanish mirror and the docs mirror with the dual
snippet block, and every plottable snippet on those pages now names its
.plot().
Prose: the tone-prominence guide gains a comparison of the four tonality
assessments the library implements and when each applies, the
hearing-threshold guide explains how the ISO 7029 fractiles feed the ISO 1999
age component and gains a See-also section, and the objective-intelligibility
guide gains the "which measure, and when" section that existed only in the
docs mirror, extended with the STOI/ESTOI, STI and SII choice.
Also label the STOI band axis at whole-hertz resolution and let the shaded
critical band of the tone-audibility levels plot follow the figure
background, so it reads on the white report page and on dark figures alike.
* Correct two figure alt texts against the plotted values
The ISO 7029 fractile figure describes the median and the 90 % fractile with
the values it actually draws (10 to 50 dB and 22 to 74 dB), and the
ECMA-418-2 specific tonality peak is at 9 Bark_HMS.
Perception, hearing and speech guides: result figures and when-to-use prose (#361)
* Perception, hearing and speech guides: result figures and when-to-use prose
Add ToneAssessment.plot(), which draws an ECMA-418-1 tone against the
prominence criterion of its own method (recovered from criterion_db) over the
whole range of interest, with the deciding margin marked, and a
view="levels" option on ToneAudibilityResult.plot() that exposes the
level-versus-frequency view the ISO 1996-2 fiche already embedded.
Add eleven single-concept figures to the perception, hearing and speech
guides, each a realistic result drawn by its own .plot(): the tone prominence
verdict, the ISO/PAS 20065 tone levels, the ISO/PAS 1996-3 onset detection,
the ISO 532-2 specific loudness, the ECMA-418-2 specific tonality, the
specific fluctuation strength, the SII band audibility under a hearing loss,
the ISO 7029 fractile band, the ISO 1999 NIPTS audiogram, the STOI per-band
correlation and the IEC 60268-16 per-band MTI. Every figure is embedded in
the English guide, the Spanish mirror and the docs mirror with the dual
snippet block, and every plottable snippet on those pages now names its
.plot().
Prose: the tone-prominence guide gains a comparison of the four tonality
assessments the library implements and when each applies, the
hearing-threshold guide explains how the ISO 7029 fractiles feed the ISO 1999
age component and gains a See-also section, and the objective-intelligibility
guide gains the "which measure, and when" section that existed only in the
docs mirror, extended with the STOI/ESTOI, STI and SII choice.
Also label the STOI band axis at whole-hertz resolution and let the shaded
critical band of the tone-audibility levels plot follow the figure
background, so it reads on the white report page and on dark figures alike.
* Correct two figure alt texts against the plotted values
The ISO 7029 fractile figure describes the median and the 90 % fractile with
the values it actually draws (10 to 50 dB and 22 to 74 dB), and the
ECMA-418-2 specific tonality peak is at 9 Bark_HMS.
Perception, hearing and speech guides: result figures and when-to-use prose (#361)
* Perception, hearing and speech guides: result figures and when-to-use prose
Add ToneAssessment.plot(), which draws an ECMA-418-1 tone against the
prominence criterion of its own method (recovered from criterion_db) over the
whole range of interest, with the deciding margin marked, and a
view="levels" option on ToneAudibilityResult.plot() that exposes the
level-versus-frequency view the ISO 1996-2 fiche already embedded.
Add eleven single-concept figures to the perception, hearing and speech
guides, each a realistic result drawn by its own .plot(): the tone prominence
verdict, the ISO/PAS 20065 tone levels, the ISO/PAS 1996-3 onset detection,
the ISO 532-2 specific loudness, the ECMA-418-2 specific tonality, the
specific fluctuation strength, the SII band audibility under a hearing loss,
the ISO 7029 fractile band, the ISO 1999 NIPTS audiogram, the STOI per-band
correlation and the IEC 60268-16 per-band MTI. Every figure is embedded in
the English guide, the Spanish mirror and the docs mirror with the dual
snippet block, and every plottable snippet on those pages now names its
.plot().
Prose: the tone-prominence guide gains a comparison of the four tonality
assessments the library implements and when each applies, the
hearing-threshold guide explains how the ISO 7029 fractiles feed the ISO 1999
age component and gains a See-also section, and the objective-intelligibility
guide gains the "which measure, and when" section that existed only in the
docs mirror, extended with the STOI/ESTOI, STI and SII choice.
Also label the STOI band axis at whole-hertz resolution and let the shaded
critical band of the tone-audibility levels plot follow the figure
background, so it reads on the white report page and on dark figures alike.
* Correct two figure alt texts against the plotted values
The ISO 7029 fractile figure describes the median and the 90 % fractile with
the values it actually draws (10 to 50 dB and 22 to 74 dB), and the
ECMA-418-2 specific tonality peak is at 9 Bark_HMS.
docs: 300 dpi animations, tuned VP9 encoding, parallel rendering and audit fixes (#192)
* Render documentation animations at 300 DPI with a parallel pipeline
Raise the animation resolution from 800x450 to 2400x1350 (300 DPI, same
8x4.5 figure) so the clips stay crisp on high-density displays, and tune
the VP9 WebM encode (-tune-content screen -row-mt 1 -deadline good
-cpu-used 4) to roughly halve the encode time at the same file size. The
GitHub GIF fallback stays at 640 px.
Add a spawned process-pool renderer for the clips (one grouped task per
clip so each FDTD field is simulated once and reused across its four
language/theme variants), mirroring the figure runner and wired to the
existing --jobs flag; --anim single-clip re-renders and --jobs 1 stay
sequential.
Fold in a set of on-canvas readability fixes: Spanish decimal commas in
the FDTD time readouts, time and phase-caption labels repositioned clear
of tick labels and legends, a legible dark pill behind the ducting
channel-axis label, a mathtext L_W subscript in the two-rooms readout,
and the onset magnifier kept fully inside its panel.
* Re-render the documentation animations at 2400x1350
Regenerate every clip (WebM x four language/theme variants, EN GIF and
poster stills) at the new 300 DPI resolution with the tuned VP9 encode,
and refresh the posters at the matching intrinsic size.
* Link the high-resolution WebM under each docs GIF and resize site embeds
Add a one-line link to the high-resolution WebM of each clip beneath every
animation GIF in the GitHub-facing guides, and update the site <video>
embeds (EN + ES) to the new 2400x1350 intrinsic size. The GIF dimensions
are unchanged.
* docs: clamp the onset magnifier against the left panel edge
docs: 300 dpi animations, tuned VP9 encoding, parallel rendering and audit fixes (#192)
* Render documentation animations at 300 DPI with a parallel pipeline
Raise the animation resolution from 800x450 to 2400x1350 (300 DPI, same
8x4.5 figure) so the clips stay crisp on high-density displays, and tune
the VP9 WebM encode (-tune-content screen -row-mt 1 -deadline good
-cpu-used 4) to roughly halve the encode time at the same file size. The
GitHub GIF fallback stays at 640 px.
Add a spawned process-pool renderer for the clips (one grouped task per
clip so each FDTD field is simulated once and reused across its four
language/theme variants), mirroring the figure runner and wired to the
existing --jobs flag; --anim single-clip re-renders and --jobs 1 stay
sequential.
Fold in a set of on-canvas readability fixes: Spanish decimal commas in
the FDTD time readouts, time and phase-caption labels repositioned clear
of tick labels and legends, a legible dark pill behind the ducting
channel-axis label, a mathtext L_W subscript in the two-rooms readout,
and the onset magnifier kept fully inside its panel.
* Re-render the documentation animations at 2400x1350
Regenerate every clip (WebM x four language/theme variants, EN GIF and
poster stills) at the new 300 DPI resolution with the tuned VP9 encode,
and refresh the posters at the matching intrinsic size.
* Link the high-resolution WebM under each docs GIF and resize site embeds
Add a one-line link to the high-resolution WebM of each clip beneath every
animation GIF in the GitHub-facing guides, and update the site <video>
embeds (EN + ES) to the new 2400x1350 intrinsic size. The GIF dimensions
are unchanged.
* docs: clamp the onset magnifier against the left panel edge
docs: 300 dpi animations, tuned VP9 encoding, parallel rendering and audit fixes (#192)
* Render documentation animations at 300 DPI with a parallel pipeline
Raise the animation resolution from 800x450 to 2400x1350 (300 DPI, same
8x4.5 figure) so the clips stay crisp on high-density displays, and tune
the VP9 WebM encode (-tune-content screen -row-mt 1 -deadline good
-cpu-used 4) to roughly halve the encode time at the same file size. The
GitHub GIF fallback stays at 640 px.
Add a spawned process-pool renderer for the clips (one grouped task per
clip so each FDTD field is simulated once and reused across its four
language/theme variants), mirroring the figure runner and wired to the
existing --jobs flag; --anim single-clip re-renders and --jobs 1 stay
sequential.
Fold in a set of on-canvas readability fixes: Spanish decimal commas in
the FDTD time readouts, time and phase-caption labels repositioned clear
of tick labels and legends, a legible dark pill behind the ducting
channel-axis label, a mathtext L_W subscript in the two-rooms readout,
and the onset magnifier kept fully inside its panel.
* Re-render the documentation animations at 2400x1350
Regenerate every clip (WebM x four language/theme variants, EN GIF and
poster stills) at the new 300 DPI resolution with the tuned VP9 encode,
and refresh the posters at the matching intrinsic size.
* Link the high-resolution WebM under each docs GIF and resize site embeds
Add a one-line link to the high-resolution WebM of each clip beneath every
animation GIF in the GitHub-facing guides, and update the site <video>
embeds (EN + ES) to the new 2400x1350 intrinsic size. The GIF dimensions
are unchanged.
* docs: clamp the onset magnifier against the left panel edge
docs: 300 dpi animations, tuned VP9 encoding, parallel rendering and audit fixes (#192)
* Render documentation animations at 300 DPI with a parallel pipeline
Raise the animation resolution from 800x450 to 2400x1350 (300 DPI, same
8x4.5 figure) so the clips stay crisp on high-density displays, and tune
the VP9 WebM encode (-tune-content screen -row-mt 1 -deadline good
-cpu-used 4) to roughly halve the encode time at the same file size. The
GitHub GIF fallback stays at 640 px.
Add a spawned process-pool renderer for the clips (one grouped task per
clip so each FDTD field is simulated once and reused across its four
language/theme variants), mirroring the figure runner and wired to the
existing --jobs flag; --anim single-clip re-renders and --jobs 1 stay
sequential.
Fold in a set of on-canvas readability fixes: Spanish decimal commas in
the FDTD time readouts, time and phase-caption labels repositioned clear
of tick labels and legends, a legible dark pill behind the ducting
channel-axis label, a mathtext L_W subscript in the two-rooms readout,
and the onset magnifier kept fully inside its panel.
* Re-render the documentation animations at 2400x1350
Regenerate every clip (WebM x four language/theme variants, EN GIF and
poster stills) at the new 300 DPI resolution with the tuned VP9 encode,
and refresh the posters at the matching intrinsic size.
* Link the high-resolution WebM under each docs GIF and resize site embeds
Add a one-line link to the high-resolution WebM of each clip beneath every
animation GIF in the GitHub-facing guides, and update the site <video>
embeds (EN + ES) to the new 2400x1350 intrinsic size. The GIF dimensions
are unchanged.
* docs: clamp the onset magnifier against the left panel edge
docs: 300 dpi animations, tuned VP9 encoding, parallel rendering and audit fixes (#192)
* Render documentation animations at 300 DPI with a parallel pipeline
Raise the animation resolution from 800x450 to 2400x1350 (300 DPI, same
8x4.5 figure) so the clips stay crisp on high-density displays, and tune
the VP9 WebM encode (-tune-content screen -row-mt 1 -deadline good
-cpu-used 4) to roughly halve the encode time at the same file size. The
GitHub GIF fallback stays at 640 px.
Add a spawned process-pool renderer for the clips (one grouped task per
clip so each FDTD field is simulated once and reused across its four
language/theme variants), mirroring the figure runner and wired to the
existing --jobs flag; --anim single-clip re-renders and --jobs 1 stay
sequential.
Fold in a set of on-canvas readability fixes: Spanish decimal commas in
the FDTD time readouts, time and phase-caption labels repositioned clear
of tick labels and legends, a legible dark pill behind the ducting
channel-axis label, a mathtext L_W subscript in the two-rooms readout,
and the onset magnifier kept fully inside its panel.
* Re-render the documentation animations at 2400x1350
Regenerate every clip (WebM x four language/theme variants, EN GIF and
poster stills) at the new 300 DPI resolution with the tuned VP9 encode,
and refresh the posters at the matching intrinsic size.
* Link the high-resolution WebM under each docs GIF and resize site embeds
Add a one-line link to the high-resolution WebM of each clip beneath every
animation GIF in the GitHub-facing guides, and update the site <video>
embeds (EN + ES) to the new 2400x1350 intrinsic size. The GIF dimensions
are unchanged.
* docs: clamp the onset magnifier against the left panel edge
docs: 300 dpi animations, tuned VP9 encoding, parallel rendering and audit fixes (#192)
* Render documentation animations at 300 DPI with a parallel pipeline
Raise the animation resolution from 800x450 to 2400x1350 (300 DPI, same
8x4.5 figure) so the clips stay crisp on high-density displays, and tune
the VP9 WebM encode (-tune-content screen -row-mt 1 -deadline good
-cpu-used 4) to roughly halve the encode time at the same file size. The
GitHub GIF fallback stays at 640 px.
Add a spawned process-pool renderer for the clips (one grouped task per
clip so each FDTD field is simulated once and reused across its four
language/theme variants), mirroring the figure runner and wired to the
existing --jobs flag; --anim single-clip re-renders and --jobs 1 stay
sequential.
Fold in a set of on-canvas readability fixes: Spanish decimal commas in
the FDTD time readouts, time and phase-caption labels repositioned clear
of tick labels and legends, a legible dark pill behind the ducting
channel-axis label, a mathtext L_W subscript in the two-rooms readout,
and the onset magnifier kept fully inside its panel.
* Re-render the documentation animations at 2400x1350
Regenerate every clip (WebM x four language/theme variants, EN GIF and
poster stills) at the new 300 DPI resolution with the tuned VP9 encode,
and refresh the posters at the matching intrinsic size.
* Link the high-resolution WebM under each docs GIF and resize site embeds
Add a one-line link to the high-resolution WebM of each clip beneath every
animation GIF in the GitHub-facing guides, and update the site <video>
embeds (EN + ES) to the new 2400x1350 intrinsic size. The GIF dimensions
are unchanged.
* docs: clamp the onset magnifier against the left panel edge
docs: 300 dpi animations, tuned VP9 encoding, parallel rendering and audit fixes (#192)
* Render documentation animations at 300 DPI with a parallel pipeline
Raise the animation resolution from 800x450 to 2400x1350 (300 DPI, same
8x4.5 figure) so the clips stay crisp on high-density displays, and tune
the VP9 WebM encode (-tune-content screen -row-mt 1 -deadline good
-cpu-used 4) to roughly halve the encode time at the same file size. The
GitHub GIF fallback stays at 640 px.
Add a spawned process-pool renderer for the clips (one grouped task per
clip so each FDTD field is simulated once and reused across its four
language/theme variants), mirroring the figure runner and wired to the
existing --jobs flag; --anim single-clip re-renders and --jobs 1 stay
sequential.
Fold in a set of on-canvas readability fixes: Spanish decimal commas in
the FDTD time readouts, time and phase-caption labels repositioned clear
of tick labels and legends, a legible dark pill behind the ducting
channel-axis label, a mathtext L_W subscript in the two-rooms readout,
and the onset magnifier kept fully inside its panel.
* Re-render the documentation animations at 2400x1350
Regenerate every clip (WebM x four language/theme variants, EN GIF and
poster stills) at the new 300 DPI resolution with the tuned VP9 encode,
and refresh the posters at the matching intrinsic size.
* Link the high-resolution WebM under each docs GIF and resize site embeds
Add a one-line link to the high-resolution WebM of each clip beneath every
animation GIF in the GitHub-facing guides, and update the site <video>
embeds (EN + ES) to the new 2400x1350 intrinsic size. The GIF dimensions
are unchanged.
* docs: clamp the onset magnifier against the left panel edge
docs: 300 dpi animations, tuned VP9 encoding, parallel rendering and audit fixes (#192)
* Render documentation animations at 300 DPI with a parallel pipeline
Raise the animation resolution from 800x450 to 2400x1350 (300 DPI, same
8x4.5 figure) so the clips stay crisp on high-density displays, and tune
the VP9 WebM encode (-tune-content screen -row-mt 1 -deadline good
-cpu-used 4) to roughly halve the encode time at the same file size. The
GitHub GIF fallback stays at 640 px.
Add a spawned process-pool renderer for the clips (one grouped task per
clip so each FDTD field is simulated once and reused across its four
language/theme variants), mirroring the figure runner and wired to the
existing --jobs flag; --anim single-clip re-renders and --jobs 1 stay
sequential.
Fold in a set of on-canvas readability fixes: Spanish decimal commas in
the FDTD time readouts, time and phase-caption labels repositioned clear
of tick labels and legends, a legible dark pill behind the ducting
channel-axis label, a mathtext L_W subscript in the two-rooms readout,
and the onset magnifier kept fully inside its panel.
* Re-render the documentation animations at 2400x1350
Regenerate every clip (WebM x four language/theme variants, EN GIF and
poster stills) at the new 300 DPI resolution with the tuned VP9 encode,
and refresh the posters at the matching intrinsic size.
* Link the high-resolution WebM under each docs GIF and resize site embeds
Add a one-line link to the high-resolution WebM of each clip beneath every
animation GIF in the GitHub-facing guides, and update the site <video>
embeds (EN + ES) to the new 2400x1350 intrinsic size. The GIF dimensions
are unchanged.
* docs: clamp the onset magnifier against the left panel edge
docs: 300 dpi animations, tuned VP9 encoding, parallel rendering and audit fixes (#192)
* Render documentation animations at 300 DPI with a parallel pipeline
Raise the animation resolution from 800x450 to 2400x1350 (300 DPI, same
8x4.5 figure) so the clips stay crisp on high-density displays, and tune
the VP9 WebM encode (-tune-content screen -row-mt 1 -deadline good
-cpu-used 4) to roughly halve the encode time at the same file size. The
GitHub GIF fallback stays at 640 px.
Add a spawned process-pool renderer for the clips (one grouped task per
clip so each FDTD field is simulated once and reused across its four
language/theme variants), mirroring the figure runner and wired to the
existing --jobs flag; --anim single-clip re-renders and --jobs 1 stay
sequential.
Fold in a set of on-canvas readability fixes: Spanish decimal commas in
the FDTD time readouts, time and phase-caption labels repositioned clear
of tick labels and legends, a legible dark pill behind the ducting
channel-axis label, a mathtext L_W subscript in the two-rooms readout,
and the onset magnifier kept fully inside its panel.
* Re-render the documentation animations at 2400x1350
Regenerate every clip (WebM x four language/theme variants, EN GIF and
poster stills) at the new 300 DPI resolution with the tuned VP9 encode,
and refresh the posters at the matching intrinsic size.
* Link the high-resolution WebM under each docs GIF and resize site embeds
Add a one-line link to the high-resolution WebM of each clip beneath every
animation GIF in the GitHub-facing guides, and update the site <video>
embeds (EN + ES) to the new 2400x1350 intrinsic size. The GIF dimensions
are unchanged.
* docs: clamp the onset magnifier against the left panel edge
docs: 300 dpi animations, tuned VP9 encoding, parallel rendering and audit fixes (#192)
* Render documentation animations at 300 DPI with a parallel pipeline
Raise the animation resolution from 800x450 to 2400x1350 (300 DPI, same
8x4.5 figure) so the clips stay crisp on high-density displays, and tune
the VP9 WebM encode (-tune-content screen -row-mt 1 -deadline good
-cpu-used 4) to roughly halve the encode time at the same file size. The
GitHub GIF fallback stays at 640 px.
Add a spawned process-pool renderer for the clips (one grouped task per
clip so each FDTD field is simulated once and reused across its four
language/theme variants), mirroring the figure runner and wired to the
existing --jobs flag; --anim single-clip re-renders and --jobs 1 stay
sequential.
Fold in a set of on-canvas readability fixes: Spanish decimal commas in
the FDTD time readouts, time and phase-caption labels repositioned clear
of tick labels and legends, a legible dark pill behind the ducting
channel-axis label, a mathtext L_W subscript in the two-rooms readout,
and the onset magnifier kept fully inside its panel.
* Re-render the documentation animations at 2400x1350
Regenerate every clip (WebM x four language/theme variants, EN GIF and
poster stills) at the new 300 DPI resolution with the tuned VP9 encode,
and refresh the posters at the matching intrinsic size.
* Link the high-resolution WebM under each docs GIF and resize site embeds
Add a one-line link to the high-resolution WebM of each clip beneath every
animation GIF in the GitHub-facing guides, and update the site <video>
embeds (EN + ES) to the new 2400x1350 intrinsic size. The GIF dimensions
are unchanged.
* docs: clamp the onset magnifier against the left panel edge
docs: 300 dpi animations, tuned VP9 encoding, parallel rendering and audit fixes (#192)
* Render documentation animations at 300 DPI with a parallel pipeline
Raise the animation resolution from 800x450 to 2400x1350 (300 DPI, same
8x4.5 figure) so the clips stay crisp on high-density displays, and tune
the VP9 WebM encode (-tune-content screen -row-mt 1 -deadline good
-cpu-used 4) to roughly halve the encode time at the same file size. The
GitHub GIF fallback stays at 640 px.
Add a spawned process-pool renderer for the clips (one grouped task per
clip so each FDTD field is simulated once and reused across its four
language/theme variants), mirroring the figure runner and wired to the
existing --jobs flag; --anim single-clip re-renders and --jobs 1 stay
sequential.
Fold in a set of on-canvas readability fixes: Spanish decimal commas in
the FDTD time readouts, time and phase-caption labels repositioned clear
of tick labels and legends, a legible dark pill behind the ducting
channel-axis label, a mathtext L_W subscript in the two-rooms readout,
and the onset magnifier kept fully inside its panel.
* Re-render the documentation animations at 2400x1350
Regenerate every clip (WebM x four language/theme variants, EN GIF and
poster stills) at the new 300 DPI resolution with the tuned VP9 encode,
and refresh the posters at the matching intrinsic size.
* Link the high-resolution WebM under each docs GIF and resize site embeds
Add a one-line link to the high-resolution WebM of each clip beneath every
animation GIF in the GitHub-facing guides, and update the site <video>
embeds (EN + ES) to the new 2400x1350 intrinsic size. The GIF dimensions
are unchanged.
* docs: clamp the onset magnifier against the left panel edge
docs: 300 dpi animations, tuned VP9 encoding, parallel rendering and audit fixes (#192)
* Render documentation animations at 300 DPI with a parallel pipeline
Raise the animation resolution from 800x450 to 2400x1350 (300 DPI, same
8x4.5 figure) so the clips stay crisp on high-density displays, and tune
the VP9 WebM encode (-tune-content screen -row-mt 1 -deadline good
-cpu-used 4) to roughly halve the encode time at the same file size. The
GitHub GIF fallback stays at 640 px.
Add a spawned process-pool renderer for the clips (one grouped task per
clip so each FDTD field is simulated once and reused across its four
language/theme variants), mirroring the figure runner and wired to the
existing --jobs flag; --anim single-clip re-renders and --jobs 1 stay
sequential.
Fold in a set of on-canvas readability fixes: Spanish decimal commas in
the FDTD time readouts, time and phase-caption labels repositioned clear
of tick labels and legends, a legible dark pill behind the ducting
channel-axis label, a mathtext L_W subscript in the two-rooms readout,
and the onset magnifier kept fully inside its panel.
* Re-render the documentation animations at 2400x1350
Regenerate every clip (WebM x four language/theme variants, EN GIF and
poster stills) at the new 300 DPI resolution with the tuned VP9 encode,
and refresh the posters at the matching intrinsic size.
* Link the high-resolution WebM under each docs GIF and resize site embeds
Add a one-line link to the high-resolution WebM of each clip beneath every
animation GIF in the GitHub-facing guides, and update the site <video>
embeds (EN + ES) to the new 2400x1350 intrinsic size. The GIF dimensions
are unchanged.
* docs: clamp the onset magnifier against the left panel edge
docs: 300 dpi animations, tuned VP9 encoding, parallel rendering and audit fixes (#192)
* Render documentation animations at 300 DPI with a parallel pipeline
Raise the animation resolution from 800x450 to 2400x1350 (300 DPI, same
8x4.5 figure) so the clips stay crisp on high-density displays, and tune
the VP9 WebM encode (-tune-content screen -row-mt 1 -deadline good
-cpu-used 4) to roughly halve the encode time at the same file size. The
GitHub GIF fallback stays at 640 px.
Add a spawned process-pool renderer for the clips (one grouped task per
clip so each FDTD field is simulated once and reused across its four
language/theme variants), mirroring the figure runner and wired to the
existing --jobs flag; --anim single-clip re-renders and --jobs 1 stay
sequential.
Fold in a set of on-canvas readability fixes: Spanish decimal commas in
the FDTD time readouts, time and phase-caption labels repositioned clear
of tick labels and legends, a legible dark pill behind the ducting
channel-axis label, a mathtext L_W subscript in the two-rooms readout,
and the onset magnifier kept fully inside its panel.
* Re-render the documentation animations at 2400x1350
Regenerate every clip (WebM x four language/theme variants, EN GIF and
poster stills) at the new 300 DPI resolution with the tuned VP9 encode,
and refresh the posters at the matching intrinsic size.
* Link the high-resolution WebM under each docs GIF and resize site embeds
Add a one-line link to the high-resolution WebM of each clip beneath every
animation GIF in the GitHub-facing guides, and update the site <video>
embeds (EN + ES) to the new 2400x1350 intrinsic size. The GIF dimensions
are unchanged.
* docs: clamp the onset magnifier against the left panel edge
docs: 300 dpi animations, tuned VP9 encoding, parallel rendering and audit fixes (#192)
* Render documentation animations at 300 DPI with a parallel pipeline
Raise the animation resolution from 800x450 to 2400x1350 (300 DPI, same
8x4.5 figure) so the clips stay crisp on high-density displays, and tune
the VP9 WebM encode (-tune-content screen -row-mt 1 -deadline good
-cpu-used 4) to roughly halve the encode time at the same file size. The
GitHub GIF fallback stays at 640 px.
Add a spawned process-pool renderer for the clips (one grouped task per
clip so each FDTD field is simulated once and reused across its four
language/theme variants), mirroring the figure runner and wired to the
existing --jobs flag; --anim single-clip re-renders and --jobs 1 stay
sequential.
Fold in a set of on-canvas readability fixes: Spanish decimal commas in
the FDTD time readouts, time and phase-caption labels repositioned clear
of tick labels and legends, a legible dark pill behind the ducting
channel-axis label, a mathtext L_W subscript in the two-rooms readout,
and the onset magnifier kept fully inside its panel.
* Re-render the documentation animations at 2400x1350
Regenerate every clip (WebM x four language/theme variants, EN GIF and
poster stills) at the new 300 DPI resolution with the tuned VP9 encode,
and refresh the posters at the matching intrinsic size.
* Link the high-resolution WebM under each docs GIF and resize site embeds
Add a one-line link to the high-resolution WebM of each clip beneath every
animation GIF in the GitHub-facing guides, and update the site <video>
embeds (EN + ES) to the new 2400x1350 intrinsic size. The GIF dimensions
are unchanged.
* docs: clamp the onset magnifier against the left panel edge
docs: 300 dpi animations, tuned VP9 encoding, parallel rendering and audit fixes (#192)
* Render documentation animations at 300 DPI with a parallel pipeline
Raise the animation resolution from 800x450 to 2400x1350 (300 DPI, same
8x4.5 figure) so the clips stay crisp on high-density displays, and tune
the VP9 WebM encode (-tune-content screen -row-mt 1 -deadline good
-cpu-used 4) to roughly halve the encode time at the same file size. The
GitHub GIF fallback stays at 640 px.
Add a spawned process-pool renderer for the clips (one grouped task per
clip so each FDTD field is simulated once and reused across its four
language/theme variants), mirroring the figure runner and wired to the
existing --jobs flag; --anim single-clip re-renders and --jobs 1 stay
sequential.
Fold in a set of on-canvas readability fixes: Spanish decimal commas in
the FDTD time readouts, time and phase-caption labels repositioned clear
of tick labels and legends, a legible dark pill behind the ducting
channel-axis label, a mathtext L_W subscript in the two-rooms readout,
and the onset magnifier kept fully inside its panel.
* Re-render the documentation animations at 2400x1350
Regenerate every clip (WebM x four language/theme variants, EN GIF and
poster stills) at the new 300 DPI resolution with the tuned VP9 encode,
and refresh the posters at the matching intrinsic size.
* Link the high-resolution WebM under each docs GIF and resize site embeds
Add a one-line link to the high-resolution WebM of each clip beneath every
animation GIF in the GitHub-facing guides, and update the site <video>
embeds (EN + ES) to the new 2400x1350 intrinsic size. The GIF dimensions
are unchanged.
* docs: clamp the onset magnifier against the left panel edge
docs: 300 dpi animations, tuned VP9 encoding, parallel rendering and audit fixes (#192)
* Render documentation animations at 300 DPI with a parallel pipeline
Raise the animation resolution from 800x450 to 2400x1350 (300 DPI, same
8x4.5 figure) so the clips stay crisp on high-density displays, and tune
the VP9 WebM encode (-tune-content screen -row-mt 1 -deadline good
-cpu-used 4) to roughly halve the encode time at the same file size. The
GitHub GIF fallback stays at 640 px.
Add a spawned process-pool renderer for the clips (one grouped task per
clip so each FDTD field is simulated once and reused across its four
language/theme variants), mirroring the figure runner and wired to the
existing --jobs flag; --anim single-clip re-renders and --jobs 1 stay
sequential.
Fold in a set of on-canvas readability fixes: Spanish decimal commas in
the FDTD time readouts, time and phase-caption labels repositioned clear
of tick labels and legends, a legible dark pill behind the ducting
channel-axis label, a mathtext L_W subscript in the two-rooms readout,
and the onset magnifier kept fully inside its panel.
* Re-render the documentation animations at 2400x1350
Regenerate every clip (WebM x four language/theme variants, EN GIF and
poster stills) at the new 300 DPI resolution with the tuned VP9 encode,
and refresh the posters at the matching intrinsic size.
* Link the high-resolution WebM under each docs GIF and resize site embeds
Add a one-line link to the high-resolution WebM of each clip beneath every
animation GIF in the GitHub-facing guides, and update the site <video>
embeds (EN + ES) to the new 2400x1350 intrinsic size. The GIF dimensions
are unchanged.
* docs: clamp the onset magnifier against the left panel edge
docs: 300 dpi animations, tuned VP9 encoding, parallel rendering and audit fixes (#192)
* Render documentation animations at 300 DPI with a parallel pipeline
Raise the animation resolution from 800x450 to 2400x1350 (300 DPI, same
8x4.5 figure) so the clips stay crisp on high-density displays, and tune
the VP9 WebM encode (-tune-content screen -row-mt 1 -deadline good
-cpu-used 4) to roughly halve the encode time at the same file size. The
GitHub GIF fallback stays at 640 px.
Add a spawned process-pool renderer for the clips (one grouped task per
clip so each FDTD field is simulated once and reused across its four
language/theme variants), mirroring the figure runner and wired to the
existing --jobs flag; --anim single-clip re-renders and --jobs 1 stay
sequential.
Fold in a set of on-canvas readability fixes: Spanish decimal commas in
the FDTD time readouts, time and phase-caption labels repositioned clear
of tick labels and legends, a legible dark pill behind the ducting
channel-axis label, a mathtext L_W subscript in the two-rooms readout,
and the onset magnifier kept fully inside its panel.
* Re-render the documentation animations at 2400x1350
Regenerate every clip (WebM x four language/theme variants, EN GIF and
poster stills) at the new 300 DPI resolution with the tuned VP9 encode,
and refresh the posters at the matching intrinsic size.
* Link the high-resolution WebM under each docs GIF and resize site embeds
Add a one-line link to the high-resolution WebM of each clip beneath every
animation GIF in the GitHub-facing guides, and update the site <video>
embeds (EN + ES) to the new 2400x1350 intrinsic size. The GIF dimensions
are unchanged.
* docs: clamp the onset magnifier against the left panel edge
docs: 300 dpi animations, tuned VP9 encoding, parallel rendering and audit fixes (#192)
* Render documentation animations at 300 DPI with a parallel pipeline
Raise the animation resolution from 800x450 to 2400x1350 (300 DPI, same
8x4.5 figure) so the clips stay crisp on high-density displays, and tune
the VP9 WebM encode (-tune-content screen -row-mt 1 -deadline good
-cpu-used 4) to roughly halve the encode time at the same file size. The
GitHub GIF fallback stays at 640 px.
Add a spawned process-pool renderer for the clips (one grouped task per
clip so each FDTD field is simulated once and reused across its four
language/theme variants), mirroring the figure runner and wired to the
existing --jobs flag; --anim single-clip re-renders and --jobs 1 stay
sequential.
Fold in a set of on-canvas readability fixes: Spanish decimal commas in
the FDTD time readouts, time and phase-caption labels repositioned clear
of tick labels and legends, a legible dark pill behind the ducting
channel-axis label, a mathtext L_W subscript in the two-rooms readout,
and the onset magnifier kept fully inside its panel.
* Re-render the documentation animations at 2400x1350
Regenerate every clip (WebM x four language/theme variants, EN GIF and
poster stills) at the new 300 DPI resolution with the tuned VP9 encode,
and refresh the posters at the matching intrinsic size.
* Link the high-resolution WebM under each docs GIF and resize site embeds
Add a one-line link to the high-resolution WebM of each clip beneath every
animation GIF in the GitHub-facing guides, and update the site <video>
embeds (EN + ES) to the new 2400x1350 intrinsic size. The GIF dimensions
are unchanged.
* docs: clamp the onset magnifier against the left panel edge
docs: 300 dpi animations, tuned VP9 encoding, parallel rendering and audit fixes (#192)
* Render documentation animations at 300 DPI with a parallel pipeline
Raise the animation resolution from 800x450 to 2400x1350 (300 DPI, same
8x4.5 figure) so the clips stay crisp on high-density displays, and tune
the VP9 WebM encode (-tune-content screen -row-mt 1 -deadline good
-cpu-used 4) to roughly halve the encode time at the same file size. The
GitHub GIF fallback stays at 640 px.
Add a spawned process-pool renderer for the clips (one grouped task per
clip so each FDTD field is simulated once and reused across its four
language/theme variants), mirroring the figure runner and wired to the
existing --jobs flag; --anim single-clip re-renders and --jobs 1 stay
sequential.
Fold in a set of on-canvas readability fixes: Spanish decimal commas in
the FDTD time readouts, time and phase-caption labels repositioned clear
of tick labels and legends, a legible dark pill behind the ducting
channel-axis label, a mathtext L_W subscript in the two-rooms readout,
and the onset magnifier kept fully inside its panel.
* Re-render the documentation animations at 2400x1350
Regenerate every clip (WebM x four language/theme variants, EN GIF and
poster stills) at the new 300 DPI resolution with the tuned VP9 encode,
and refresh the posters at the matching intrinsic size.
* Link the high-resolution WebM under each docs GIF and resize site embeds
Add a one-line link to the high-resolution WebM of each clip beneath every
animation GIF in the GitHub-facing guides, and update the site <video>
embeds (EN + ES) to the new 2400x1350 intrinsic size. The GIF dimensions
are unchanged.
* docs: clamp the onset magnifier against the left panel edge
docs: 300 dpi animations, tuned VP9 encoding, parallel rendering and audit fixes (#192)
* Render documentation animations at 300 DPI with a parallel pipeline
Raise the animation resolution from 800x450 to 2400x1350 (300 DPI, same
8x4.5 figure) so the clips stay crisp on high-density displays, and tune
the VP9 WebM encode (-tune-content screen -row-mt 1 -deadline good
-cpu-used 4) to roughly halve the encode time at the same file size. The
GitHub GIF fallback stays at 640 px.
Add a spawned process-pool renderer for the clips (one grouped task per
clip so each FDTD field is simulated once and reused across its four
language/theme variants), mirroring the figure runner and wired to the
existing --jobs flag; --anim single-clip re-renders and --jobs 1 stay
sequential.
Fold in a set of on-canvas readability fixes: Spanish decimal commas in
the FDTD time readouts, time and phase-caption labels repositioned clear
of tick labels and legends, a legible dark pill behind the ducting
channel-axis label, a mathtext L_W subscript in the two-rooms readout,
and the onset magnifier kept fully inside its panel.
* Re-render the documentation animations at 2400x1350
Regenerate every clip (WebM x four language/theme variants, EN GIF and
poster stills) at the new 300 DPI resolution with the tuned VP9 encode,
and refresh the posters at the matching intrinsic size.
* Link the high-resolution WebM under each docs GIF and resize site embeds
Add a one-line link to the high-resolution WebM of each clip beneath every
animation GIF in the GitHub-facing guides, and update the site <video>
embeds (EN + ES) to the new 2400x1350 intrinsic size. The GIF dimensions
are unchanged.
* docs: clamp the onset magnifier against the left panel edge
docs: 300 dpi animations, tuned VP9 encoding, parallel rendering and audit fixes (#192)
* Render documentation animations at 300 DPI with a parallel pipeline
Raise the animation resolution from 800x450 to 2400x1350 (300 DPI, same
8x4.5 figure) so the clips stay crisp on high-density displays, and tune
the VP9 WebM encode (-tune-content screen -row-mt 1 -deadline good
-cpu-used 4) to roughly halve the encode time at the same file size. The
GitHub GIF fallback stays at 640 px.
Add a spawned process-pool renderer for the clips (one grouped task per
clip so each FDTD field is simulated once and reused across its four
language/theme variants), mirroring the figure runner and wired to the
existing --jobs flag; --anim single-clip re-renders and --jobs 1 stay
sequential.
Fold in a set of on-canvas readability fixes: Spanish decimal commas in
the FDTD time readouts, time and phase-caption labels repositioned clear
of tick labels and legends, a legible dark pill behind the ducting
channel-axis label, a mathtext L_W subscript in the two-rooms readout,
and the onset magnifier kept fully inside its panel.
* Re-render the documentation animations at 2400x1350
Regenerate every clip (WebM x four language/theme variants, EN GIF and
poster stills) at the new 300 DPI resolution with the tuned VP9 encode,
and refresh the posters at the matching intrinsic size.
* Link the high-resolution WebM under each docs GIF and resize site embeds
Add a one-line link to the high-resolution WebM of each clip beneath every
animation GIF in the GitHub-facing guides, and update the site <video>
embeds (EN + ES) to the new 2400x1350 intrinsic size. The GIF dimensions
are unchanged.
* docs: clamp the onset magnifier against the left panel edge
docs: 300 dpi animations, tuned VP9 encoding, parallel rendering and audit fixes (#192)
* Render documentation animations at 300 DPI with a parallel pipeline
Raise the animation resolution from 800x450 to 2400x1350 (300 DPI, same
8x4.5 figure) so the clips stay crisp on high-density displays, and tune
the VP9 WebM encode (-tune-content screen -row-mt 1 -deadline good
-cpu-used 4) to roughly halve the encode time at the same file size. The
GitHub GIF fallback stays at 640 px.
Add a spawned process-pool renderer for the clips (one grouped task per
clip so each FDTD field is simulated once and reused across its four
language/theme variants), mirroring the figure runner and wired to the
existing --jobs flag; --anim single-clip re-renders and --jobs 1 stay
sequential.
Fold in a set of on-canvas readability fixes: Spanish decimal commas in
the FDTD time readouts, time and phase-caption labels repositioned clear
of tick labels and legends, a legible dark pill behind the ducting
channel-axis label, a mathtext L_W subscript in the two-rooms readout,
and the onset magnifier kept fully inside its panel.
* Re-render the documentation animations at 2400x1350
Regenerate every clip (WebM x four language/theme variants, EN GIF and
poster stills) at the new 300 DPI resolution with the tuned VP9 encode,
and refresh the posters at the matching intrinsic size.
* Link the high-resolution WebM under each docs GIF and resize site embeds
Add a one-line link to the high-resolution WebM of each clip beneath every
animation GIF in the GitHub-facing guides, and update the site <video>
embeds (EN + ES) to the new 2400x1350 intrinsic size. The GIF dimensions
are unchanged.
* docs: clamp the onset magnifier against the left panel edge
docs: 300 dpi animations, tuned VP9 encoding, parallel rendering and audit fixes (#192)
* Render documentation animations at 300 DPI with a parallel pipeline
Raise the animation resolution from 800x450 to 2400x1350 (300 DPI, same
8x4.5 figure) so the clips stay crisp on high-density displays, and tune
the VP9 WebM encode (-tune-content screen -row-mt 1 -deadline good
-cpu-used 4) to roughly halve the encode time at the same file size. The
GitHub GIF fallback stays at 640 px.
Add a spawned process-pool renderer for the clips (one grouped task per
clip so each FDTD field is simulated once and reused across its four
language/theme variants), mirroring the figure runner and wired to the
existing --jobs flag; --anim single-clip re-renders and --jobs 1 stay
sequential.
Fold in a set of on-canvas readability fixes: Spanish decimal commas in
the FDTD time readouts, time and phase-caption labels repositioned clear
of tick labels and legends, a legible dark pill behind the ducting
channel-axis label, a mathtext L_W subscript in the two-rooms readout,
and the onset magnifier kept fully inside its panel.
* Re-render the documentation animations at 2400x1350
Regenerate every clip (WebM x four language/theme variants, EN GIF and
poster stills) at the new 300 DPI resolution with the tuned VP9 encode,
and refresh the posters at the matching intrinsic size.
* Link the high-resolution WebM under each docs GIF and resize site embeds
Add a one-line link to the high-resolution WebM of each clip beneath every
animation GIF in the GitHub-facing guides, and update the site <video>
embeds (EN + ES) to the new 2400x1350 intrinsic size. The GIF dimensions
are unchanged.
* docs: clamp the onset magnifier against the left panel edge
docs: 300 dpi animations, tuned VP9 encoding, parallel rendering and audit fixes (#192)
* Render documentation animations at 300 DPI with a parallel pipeline
Raise the animation resolution from 800x450 to 2400x1350 (300 DPI, same
8x4.5 figure) so the clips stay crisp on high-density displays, and tune
the VP9 WebM encode (-tune-content screen -row-mt 1 -deadline good
-cpu-used 4) to roughly halve the encode time at the same file size. The
GitHub GIF fallback stays at 640 px.
Add a spawned process-pool renderer for the clips (one grouped task per
clip so each FDTD field is simulated once and reused across its four
language/theme variants), mirroring the figure runner and wired to the
existing --jobs flag; --anim single-clip re-renders and --jobs 1 stay
sequential.
Fold in a set of on-canvas readability fixes: Spanish decimal commas in
the FDTD time readouts, time and phase-caption labels repositioned clear
of tick labels and legends, a legible dark pill behind the ducting
channel-axis label, a mathtext L_W subscript in the two-rooms readout,
and the onset magnifier kept fully inside its panel.
* Re-render the documentation animations at 2400x1350
Regenerate every clip (WebM x four language/theme variants, EN GIF and
poster stills) at the new 300 DPI resolution with the tuned VP9 encode,
and refresh the posters at the matching intrinsic size.
* Link the high-resolution WebM under each docs GIF and resize site embeds
Add a one-line link to the high-resolution WebM of each clip beneath every
animation GIF in the GitHub-facing guides, and update the site <video>
embeds (EN + ES) to the new 2400x1350 intrinsic size. The GIF dimensions
are unchanged.
* docs: clamp the onset magnifier against the left panel edge
docs: 300 dpi animations, tuned VP9 encoding, parallel rendering and audit fixes (#192)
* Render documentation animations at 300 DPI with a parallel pipeline
Raise the animation resolution from 800x450 to 2400x1350 (300 DPI, same
8x4.5 figure) so the clips stay crisp on high-density displays, and tune
the VP9 WebM encode (-tune-content screen -row-mt 1 -deadline good
-cpu-used 4) to roughly halve the encode time at the same file size. The
GitHub GIF fallback stays at 640 px.
Add a spawned process-pool renderer for the clips (one grouped task per
clip so each FDTD field is simulated once and reused across its four
language/theme variants), mirroring the figure runner and wired to the
existing --jobs flag; --anim single-clip re-renders and --jobs 1 stay
sequential.
Fold in a set of on-canvas readability fixes: Spanish decimal commas in
the FDTD time readouts, time and phase-caption labels repositioned clear
of tick labels and legends, a legible dark pill behind the ducting
channel-axis label, a mathtext L_W subscript in the two-rooms readout,
and the onset magnifier kept fully inside its panel.
* Re-render the documentation animations at 2400x1350
Regenerate every clip (WebM x four language/theme variants, EN GIF and
poster stills) at the new 300 DPI resolution with the tuned VP9 encode,
and refresh the posters at the matching intrinsic size.
* Link the high-resolution WebM under each docs GIF and resize site embeds
Add a one-line link to the high-resolution WebM of each clip beneath every
animation GIF in the GitHub-facing guides, and update the site <video>
embeds (EN + ES) to the new 2400x1350 intrinsic size. The GIF dimensions
are unchanged.
* docs: clamp the onset magnifier against the left panel edge
docs: 300 dpi animations, tuned VP9 encoding, parallel rendering and audit fixes (#192)
* Render documentation animations at 300 DPI with a parallel pipeline
Raise the animation resolution from 800x450 to 2400x1350 (300 DPI, same
8x4.5 figure) so the clips stay crisp on high-density displays, and tune
the VP9 WebM encode (-tune-content screen -row-mt 1 -deadline good
-cpu-used 4) to roughly halve the encode time at the same file size. The
GitHub GIF fallback stays at 640 px.
Add a spawned process-pool renderer for the clips (one grouped task per
clip so each FDTD field is simulated once and reused across its four
language/theme variants), mirroring the figure runner and wired to the
existing --jobs flag; --anim single-clip re-renders and --jobs 1 stay
sequential.
Fold in a set of on-canvas readability fixes: Spanish decimal commas in
the FDTD time readouts, time and phase-caption labels repositioned clear
of tick labels and legends, a legible dark pill behind the ducting
channel-axis label, a mathtext L_W subscript in the two-rooms readout,
and the onset magnifier kept fully inside its panel.
* Re-render the documentation animations at 2400x1350
Regenerate every clip (WebM x four language/theme variants, EN GIF and
poster stills) at the new 300 DPI resolution with the tuned VP9 encode,
and refresh the posters at the matching intrinsic size.
* Link the high-resolution WebM under each docs GIF and resize site embeds
Add a one-line link to the high-resolution WebM of each clip beneath every
animation GIF in the GitHub-facing guides, and update the site <video>
embeds (EN + ES) to the new 2400x1350 intrinsic size. The GIF dimensions
are unchanged.
* docs: clamp the onset magnifier against the left panel edge
docs: 300 dpi animations, tuned VP9 encoding, parallel rendering and audit fixes (#192)
* Render documentation animations at 300 DPI with a parallel pipeline
Raise the animation resolution from 800x450 to 2400x1350 (300 DPI, same
8x4.5 figure) so the clips stay crisp on high-density displays, and tune
the VP9 WebM encode (-tune-content screen -row-mt 1 -deadline good
-cpu-used 4) to roughly halve the encode time at the same file size. The
GitHub GIF fallback stays at 640 px.
Add a spawned process-pool renderer for the clips (one grouped task per
clip so each FDTD field is simulated once and reused across its four
language/theme variants), mirroring the figure runner and wired to the
existing --jobs flag; --anim single-clip re-renders and --jobs 1 stay
sequential.
Fold in a set of on-canvas readability fixes: Spanish decimal commas in
the FDTD time readouts, time and phase-caption labels repositioned clear
of tick labels and legends, a legible dark pill behind the ducting
channel-axis label, a mathtext L_W subscript in the two-rooms readout,
and the onset magnifier kept fully inside its panel.
* Re-render the documentation animations at 2400x1350
Regenerate every clip (WebM x four language/theme variants, EN GIF and
poster stills) at the new 300 DPI resolution with the tuned VP9 encode,
and refresh the posters at the matching intrinsic size.
* Link the high-resolution WebM under each docs GIF and resize site embeds
Add a one-line link to the high-resolution WebM of each clip beneath every
animation GIF in the GitHub-facing guides, and update the site <video>
embeds (EN + ES) to the new 2400x1350 intrinsic size. The GIF dimensions
are unchanged.
* docs: clamp the onset magnifier against the left panel edge
docs: 300 dpi animations, tuned VP9 encoding, parallel rendering and audit fixes (#192)
* Render documentation animations at 300 DPI with a parallel pipeline
Raise the animation resolution from 800x450 to 2400x1350 (300 DPI, same
8x4.5 figure) so the clips stay crisp on high-density displays, and tune
the VP9 WebM encode (-tune-content screen -row-mt 1 -deadline good
-cpu-used 4) to roughly halve the encode time at the same file size. The
GitHub GIF fallback stays at 640 px.
Add a spawned process-pool renderer for the clips (one grouped task per
clip so each FDTD field is simulated once and reused across its four
language/theme variants), mirroring the figure runner and wired to the
existing --jobs flag; --anim single-clip re-renders and --jobs 1 stay
sequential.
Fold in a set of on-canvas readability fixes: Spanish decimal commas in
the FDTD time readouts, time and phase-caption labels repositioned clear
of tick labels and legends, a legible dark pill behind the ducting
channel-axis label, a mathtext L_W subscript in the two-rooms readout,
and the onset magnifier kept fully inside its panel.
* Re-render the documentation animations at 2400x1350
Regenerate every clip (WebM x four language/theme variants, EN GIF and
poster stills) at the new 300 DPI resolution with the tuned VP9 encode,
and refresh the posters at the matching intrinsic size.
* Link the high-resolution WebM under each docs GIF and resize site embeds
Add a one-line link to the high-resolution WebM of each clip beneath every
animation GIF in the GitHub-facing guides, and update the site <video>
embeds (EN + ES) to the new 2400x1350 intrinsic size. The GIF dimensions
are unchanged.
* docs: clamp the onset magnifier against the left panel edge
docs: 300 dpi animations, tuned VP9 encoding, parallel rendering and audit fixes (#192)
* Render documentation animations at 300 DPI with a parallel pipeline
Raise the animation resolution from 800x450 to 2400x1350 (300 DPI, same
8x4.5 figure) so the clips stay crisp on high-density displays, and tune
the VP9 WebM encode (-tune-content screen -row-mt 1 -deadline good
-cpu-used 4) to roughly halve the encode time at the same file size. The
GitHub GIF fallback stays at 640 px.
Add a spawned process-pool renderer for the clips (one grouped task per
clip so each FDTD field is simulated once and reused across its four
language/theme variants), mirroring the figure runner and wired to the
existing --jobs flag; --anim single-clip re-renders and --jobs 1 stay
sequential.
Fold in a set of on-canvas readability fixes: Spanish decimal commas in
the FDTD time readouts, time and phase-caption labels repositioned clear
of tick labels and legends, a legible dark pill behind the ducting
channel-axis label, a mathtext L_W subscript in the two-rooms readout,
and the onset magnifier kept fully inside its panel.
* Re-render the documentation animations at 2400x1350
Regenerate every clip (WebM x four language/theme variants, EN GIF and
poster stills) at the new 300 DPI resolution with the tuned VP9 encode,
and refresh the posters at the matching intrinsic size.
* Link the high-resolution WebM under each docs GIF and resize site embeds
Add a one-line link to the high-resolution WebM of each clip beneath every
animation GIF in the GitHub-facing guides, and update the site <video>
embeds (EN + ES) to the new 2400x1350 intrinsic size. The GIF dimensions
are unchanged.
* docs: clamp the onset magnifier against the left panel edge
docs: 300 dpi animations, tuned VP9 encoding, parallel rendering and audit fixes (#192)
* Render documentation animations at 300 DPI with a parallel pipeline
Raise the animation resolution from 800x450 to 2400x1350 (300 DPI, same
8x4.5 figure) so the clips stay crisp on high-density displays, and tune
the VP9 WebM encode (-tune-content screen -row-mt 1 -deadline good
-cpu-used 4) to roughly halve the encode time at the same file size. The
GitHub GIF fallback stays at 640 px.
Add a spawned process-pool renderer for the clips (one grouped task per
clip so each FDTD field is simulated once and reused across its four
language/theme variants), mirroring the figure runner and wired to the
existing --jobs flag; --anim single-clip re-renders and --jobs 1 stay
sequential.
Fold in a set of on-canvas readability fixes: Spanish decimal commas in
the FDTD time readouts, time and phase-caption labels repositioned clear
of tick labels and legends, a legible dark pill behind the ducting
channel-axis label, a mathtext L_W subscript in the two-rooms readout,
and the onset magnifier kept fully inside its panel.
* Re-render the documentation animations at 2400x1350
Regenerate every clip (WebM x four language/theme variants, EN GIF and
poster stills) at the new 300 DPI resolution with the tuned VP9 encode,
and refresh the posters at the matching intrinsic size.
* Link the high-resolution WebM under each docs GIF and resize site embeds
Add a one-line link to the high-resolution WebM of each clip beneath every
animation GIF in the GitHub-facing guides, and update the site <video>
embeds (EN + ES) to the new 2400x1350 intrinsic size. The GIF dimensions
are unchanged.
* docs: clamp the onset magnifier against the left panel edge
docs: 300 dpi animations, tuned VP9 encoding, parallel rendering and audit fixes (#192)
* Render documentation animations at 300 DPI with a parallel pipeline
Raise the animation resolution from 800x450 to 2400x1350 (300 DPI, same
8x4.5 figure) so the clips stay crisp on high-density displays, and tune
the VP9 WebM encode (-tune-content screen -row-mt 1 -deadline good
-cpu-used 4) to roughly halve the encode time at the same file size. The
GitHub GIF fallback stays at 640 px.
Add a spawned process-pool renderer for the clips (one grouped task per
clip so each FDTD field is simulated once and reused across its four
language/theme variants), mirroring the figure runner and wired to the
existing --jobs flag; --anim single-clip re-renders and --jobs 1 stay
sequential.
Fold in a set of on-canvas readability fixes: Spanish decimal commas in
the FDTD time readouts, time and phase-caption labels repositioned clear
of tick labels and legends, a legible dark pill behind the ducting
channel-axis label, a mathtext L_W subscript in the two-rooms readout,
and the onset magnifier kept fully inside its panel.
* Re-render the documentation animations at 2400x1350
Regenerate every clip (WebM x four language/theme variants, EN GIF and
poster stills) at the new 300 DPI resolution with the tuned VP9 encode,
and refresh the posters at the matching intrinsic size.
* Link the high-resolution WebM under each docs GIF and resize site embeds
Add a one-line link to the high-resolution WebM of each clip beneath every
animation GIF in the GitHub-facing guides, and update the site <video>
embeds (EN + ES) to the new 2400x1350 intrinsic size. The GIF dimensions
are unchanged.
* docs: clamp the onset magnifier against the left panel edge
docs: 300 dpi animations, tuned VP9 encoding, parallel rendering and audit fixes (#192)
* Render documentation animations at 300 DPI with a parallel pipeline
Raise the animation resolution from 800x450 to 2400x1350 (300 DPI, same
8x4.5 figure) so the clips stay crisp on high-density displays, and tune
the VP9 WebM encode (-tune-content screen -row-mt 1 -deadline good
-cpu-used 4) to roughly halve the encode time at the same file size. The
GitHub GIF fallback stays at 640 px.
Add a spawned process-pool renderer for the clips (one grouped task per
clip so each FDTD field is simulated once and reused across its four
language/theme variants), mirroring the figure runner and wired to the
existing --jobs flag; --anim single-clip re-renders and --jobs 1 stay
sequential.
Fold in a set of on-canvas readability fixes: Spanish decimal commas in
the FDTD time readouts, time and phase-caption labels repositioned clear
of tick labels and legends, a legible dark pill behind the ducting
channel-axis label, a mathtext L_W subscript in the two-rooms readout,
and the onset magnifier kept fully inside its panel.
* Re-render the documentation animations at 2400x1350
Regenerate every clip (WebM x four language/theme variants, EN GIF and
poster stills) at the new 300 DPI resolution with the tuned VP9 encode,
and refresh the posters at the matching intrinsic size.
* Link the high-resolution WebM under each docs GIF and resize site embeds
Add a one-line link to the high-resolution WebM of each clip beneath every
animation GIF in the GitHub-facing guides, and update the site <video>
embeds (EN + ES) to the new 2400x1350 intrinsic size. The GIF dimensions
are unchanged.
* docs: clamp the onset magnifier against the left panel edge
docs: 300 dpi animations, tuned VP9 encoding, parallel rendering and audit fixes (#192)
* Render documentation animations at 300 DPI with a parallel pipeline
Raise the animation resolution from 800x450 to 2400x1350 (300 DPI, same
8x4.5 figure) so the clips stay crisp on high-density displays, and tune
the VP9 WebM encode (-tune-content screen -row-mt 1 -deadline good
-cpu-used 4) to roughly halve the encode time at the same file size. The
GitHub GIF fallback stays at 640 px.
Add a spawned process-pool renderer for the clips (one grouped task per
clip so each FDTD field is simulated once and reused across its four
language/theme variants), mirroring the figure runner and wired to the
existing --jobs flag; --anim single-clip re-renders and --jobs 1 stay
sequential.
Fold in a set of on-canvas readability fixes: Spanish decimal commas in
the FDTD time readouts, time and phase-caption labels repositioned clear
of tick labels and legends, a legible dark pill behind the ducting
channel-axis label, a mathtext L_W subscript in the two-rooms readout,
and the onset magnifier kept fully inside its panel.
* Re-render the documentation animations at 2400x1350
Regenerate every clip (WebM x four language/theme variants, EN GIF and
poster stills) at the new 300 DPI resolution with the tuned VP9 encode,
and refresh the posters at the matching intrinsic size.
* Link the high-resolution WebM under each docs GIF and resize site embeds
Add a one-line link to the high-resolution WebM of each clip beneath every
animation GIF in the GitHub-facing guides, and update the site <video>
embeds (EN + ES) to the new 2400x1350 intrinsic size. The GIF dimensions
are unchanged.
* docs: clamp the onset magnifier against the left panel edge
docs: 300 dpi animations, tuned VP9 encoding, parallel rendering and audit fixes (#192)
* Render documentation animations at 300 DPI with a parallel pipeline
Raise the animation resolution from 800x450 to 2400x1350 (300 DPI, same
8x4.5 figure) so the clips stay crisp on high-density displays, and tune
the VP9 WebM encode (-tune-content screen -row-mt 1 -deadline good
-cpu-used 4) to roughly halve the encode time at the same file size. The
GitHub GIF fallback stays at 640 px.
Add a spawned process-pool renderer for the clips (one grouped task per
clip so each FDTD field is simulated once and reused across its four
language/theme variants), mirroring the figure runner and wired to the
existing --jobs flag; --anim single-clip re-renders and --jobs 1 stay
sequential.
Fold in a set of on-canvas readability fixes: Spanish decimal commas in
the FDTD time readouts, time and phase-caption labels repositioned clear
of tick labels and legends, a legible dark pill behind the ducting
channel-axis label, a mathtext L_W subscript in the two-rooms readout,
and the onset magnifier kept fully inside its panel.
* Re-render the documentation animations at 2400x1350
Regenerate every clip (WebM x four language/theme variants, EN GIF and
poster stills) at the new 300 DPI resolution with the tuned VP9 encode,
and refresh the posters at the matching intrinsic size.
* Link the high-resolution WebM under each docs GIF and resize site embeds
Add a one-line link to the high-resolution WebM of each clip beneath every
animation GIF in the GitHub-facing guides, and update the site <video>
embeds (EN + ES) to the new 2400x1350 intrinsic size. The GIF dimensions
are unchanged.
* docs: clamp the onset magnifier against the left panel edge
docs: 300 dpi animations, tuned VP9 encoding, parallel rendering and audit fixes (#192)
* Render documentation animations at 300 DPI with a parallel pipeline
Raise the animation resolution from 800x450 to 2400x1350 (300 DPI, same
8x4.5 figure) so the clips stay crisp on high-density displays, and tune
the VP9 WebM encode (-tune-content screen -row-mt 1 -deadline good
-cpu-used 4) to roughly halve the encode time at the same file size. The
GitHub GIF fallback stays at 640 px.
Add a spawned process-pool renderer for the clips (one grouped task per
clip so each FDTD field is simulated once and reused across its four
language/theme variants), mirroring the figure runner and wired to the
existing --jobs flag; --anim single-clip re-renders and --jobs 1 stay
sequential.
Fold in a set of on-canvas readability fixes: Spanish decimal commas in
the FDTD time readouts, time and phase-caption labels repositioned clear
of tick labels and legends, a legible dark pill behind the ducting
channel-axis label, a mathtext L_W subscript in the two-rooms readout,
and the onset magnifier kept fully inside its panel.
* Re-render the documentation animations at 2400x1350
Regenerate every clip (WebM x four language/theme variants, EN GIF and
poster stills) at the new 300 DPI resolution with the tuned VP9 encode,
and refresh the posters at the matching intrinsic size.
* Link the high-resolution WebM under each docs GIF and resize site embeds
Add a one-line link to the high-resolution WebM of each clip beneath every
animation GIF in the GitHub-facing guides, and update the site <video>
embeds (EN + ES) to the new 2400x1350 intrinsic size. The GIF dimensions
are unchanged.
* docs: clamp the onset magnifier against the left panel edge
docs: 300 dpi animations, tuned VP9 encoding, parallel rendering and audit fixes (#192)
* Render documentation animations at 300 DPI with a parallel pipeline
Raise the animation resolution from 800x450 to 2400x1350 (300 DPI, same
8x4.5 figure) so the clips stay crisp on high-density displays, and tune
the VP9 WebM encode (-tune-content screen -row-mt 1 -deadline good
-cpu-used 4) to roughly halve the encode time at the same file size. The
GitHub GIF fallback stays at 640 px.
Add a spawned process-pool renderer for the clips (one grouped task per
clip so each FDTD field is simulated once and reused across its four
language/theme variants), mirroring the figure runner and wired to the
existing --jobs flag; --anim single-clip re-renders and --jobs 1 stay
sequential.
Fold in a set of on-canvas readability fixes: Spanish decimal commas in
the FDTD time readouts, time and phase-caption labels repositioned clear
of tick labels and legends, a legible dark pill behind the ducting
channel-axis label, a mathtext L_W subscript in the two-rooms readout,
and the onset magnifier kept fully inside its panel.
* Re-render the documentation animations at 2400x1350
Regenerate every clip (WebM x four language/theme variants, EN GIF and
poster stills) at the new 300 DPI resolution with the tuned VP9 encode,
and refresh the posters at the matching intrinsic size.
* Link the high-resolution WebM under each docs GIF and resize site embeds
Add a one-line link to the high-resolution WebM of each clip beneath every
animation GIF in the GitHub-facing guides, and update the site <video>
embeds (EN + ES) to the new 2400x1350 intrinsic size. The GIF dimensions
are unchanged.
* docs: clamp the onset magnifier against the left panel edge
docs: 300 dpi animations, tuned VP9 encoding, parallel rendering and audit fixes (#192)
* Render documentation animations at 300 DPI with a parallel pipeline
Raise the animation resolution from 800x450 to 2400x1350 (300 DPI, same
8x4.5 figure) so the clips stay crisp on high-density displays, and tune
the VP9 WebM encode (-tune-content screen -row-mt 1 -deadline good
-cpu-used 4) to roughly halve the encode time at the same file size. The
GitHub GIF fallback stays at 640 px.
Add a spawned process-pool renderer for the clips (one grouped task per
clip so each FDTD field is simulated once and reused across its four
language/theme variants), mirroring the figure runner and wired to the
existing --jobs flag; --anim single-clip re-renders and --jobs 1 stay
sequential.
Fold in a set of on-canvas readability fixes: Spanish decimal commas in
the FDTD time readouts, time and phase-caption labels repositioned clear
of tick labels and legends, a legible dark pill behind the ducting
channel-axis label, a mathtext L_W subscript in the two-rooms readout,
and the onset magnifier kept fully inside its panel.
* Re-render the documentation animations at 2400x1350
Regenerate every clip (WebM x four language/theme variants, EN GIF and
poster stills) at the new 300 DPI resolution with the tuned VP9 encode,
and refresh the posters at the matching intrinsic size.
* Link the high-resolution WebM under each docs GIF and resize site embeds
Add a one-line link to the high-resolution WebM of each clip beneath every
animation GIF in the GitHub-facing guides, and update the site <video>
embeds (EN + ES) to the new 2400x1350 intrinsic size. The GIF dimensions
are unchanged.
* docs: clamp the onset magnifier against the left panel edge
docs: 300 dpi animations, tuned VP9 encoding, parallel rendering and audit fixes (#192)
* Render documentation animations at 300 DPI with a parallel pipeline
Raise the animation resolution from 800x450 to 2400x1350 (300 DPI, same
8x4.5 figure) so the clips stay crisp on high-density displays, and tune
the VP9 WebM encode (-tune-content screen -row-mt 1 -deadline good
-cpu-used 4) to roughly halve the encode time at the same file size. The
GitHub GIF fallback stays at 640 px.
Add a spawned process-pool renderer for the clips (one grouped task per
clip so each FDTD field is simulated once and reused across its four
language/theme variants), mirroring the figure runner and wired to the
existing --jobs flag; --anim single-clip re-renders and --jobs 1 stay
sequential.
Fold in a set of on-canvas readability fixes: Spanish decimal commas in
the FDTD time readouts, time and phase-caption labels repositioned clear
of tick labels and legends, a legible dark pill behind the ducting
channel-axis label, a mathtext L_W subscript in the two-rooms readout,
and the onset magnifier kept fully inside its panel.
* Re-render the documentation animations at 2400x1350
Regenerate every clip (WebM x four language/theme variants, EN GIF and
poster stills) at the new 300 DPI resolution with the tuned VP9 encode,
and refresh the posters at the matching intrinsic size.
* Link the high-resolution WebM under each docs GIF and resize site embeds
Add a one-line link to the high-resolution WebM of each clip beneath every
animation GIF in the GitHub-facing guides, and update the site <video>
embeds (EN + ES) to the new 2400x1350 intrinsic size. The GIF dimensions
are unchanged.
* docs: clamp the onset magnifier against the left panel edge
docs: 300 dpi animations, tuned VP9 encoding, parallel rendering and audit fixes (#192)
* Render documentation animations at 300 DPI with a parallel pipeline
Raise the animation resolution from 800x450 to 2400x1350 (300 DPI, same
8x4.5 figure) so the clips stay crisp on high-density displays, and tune
the VP9 WebM encode (-tune-content screen -row-mt 1 -deadline good
-cpu-used 4) to roughly halve the encode time at the same file size. The
GitHub GIF fallback stays at 640 px.
Add a spawned process-pool renderer for the clips (one grouped task per
clip so each FDTD field is simulated once and reused across its four
language/theme variants), mirroring the figure runner and wired to the
existing --jobs flag; --anim single-clip re-renders and --jobs 1 stay
sequential.
Fold in a set of on-canvas readability fixes: Spanish decimal commas in
the FDTD time readouts, time and phase-caption labels repositioned clear
of tick labels and legends, a legible dark pill behind the ducting
channel-axis label, a mathtext L_W subscript in the two-rooms readout,
and the onset magnifier kept fully inside its panel.
* Re-render the documentation animations at 2400x1350
Regenerate every clip (WebM x four language/theme variants, EN GIF and
poster stills) at the new 300 DPI resolution with the tuned VP9 encode,
and refresh the posters at the matching intrinsic size.
* Link the high-resolution WebM under each docs GIF and resize site embeds
Add a one-line link to the high-resolution WebM of each clip beneath every
animation GIF in the GitHub-facing guides, and update the site <video>
embeds (EN + ES) to the new 2400x1350 intrinsic size. The GIF dimensions
are unchanged.
* docs: clamp the onset magnifier against the left panel edge
docs: 300 dpi animations, tuned VP9 encoding, parallel rendering and audit fixes (#192)
* Render documentation animations at 300 DPI with a parallel pipeline
Raise the animation resolution from 800x450 to 2400x1350 (300 DPI, same
8x4.5 figure) so the clips stay crisp on high-density displays, and tune
the VP9 WebM encode (-tune-content screen -row-mt 1 -deadline good
-cpu-used 4) to roughly halve the encode time at the same file size. The
GitHub GIF fallback stays at 640 px.
Add a spawned process-pool renderer for the clips (one grouped task per
clip so each FDTD field is simulated once and reused across its four
language/theme variants), mirroring the figure runner and wired to the
existing --jobs flag; --anim single-clip re-renders and --jobs 1 stay
sequential.
Fold in a set of on-canvas readability fixes: Spanish decimal commas in
the FDTD time readouts, time and phase-caption labels repositioned clear
of tick labels and legends, a legible dark pill behind the ducting
channel-axis label, a mathtext L_W subscript in the two-rooms readout,
and the onset magnifier kept fully inside its panel.
* Re-render the documentation animations at 2400x1350
Regenerate every clip (WebM x four language/theme variants, EN GIF and
poster stills) at the new 300 DPI resolution with the tuned VP9 encode,
and refresh the posters at the matching intrinsic size.
* Link the high-resolution WebM under each docs GIF and resize site embeds
Add a one-line link to the high-resolution WebM of each clip beneath every
animation GIF in the GitHub-facing guides, and update the site <video>
embeds (EN + ES) to the new 2400x1350 intrinsic size. The GIF dimensions
are unchanged.
* docs: clamp the onset magnifier against the left panel edge
docs: 300 dpi animations, tuned VP9 encoding, parallel rendering and audit fixes (#192)
* Render documentation animations at 300 DPI with a parallel pipeline
Raise the animation resolution from 800x450 to 2400x1350 (300 DPI, same
8x4.5 figure) so the clips stay crisp on high-density displays, and tune
the VP9 WebM encode (-tune-content screen -row-mt 1 -deadline good
-cpu-used 4) to roughly halve the encode time at the same file size. The
GitHub GIF fallback stays at 640 px.
Add a spawned process-pool renderer for the clips (one grouped task per
clip so each FDTD field is simulated once and reused across its four
language/theme variants), mirroring the figure runner and wired to the
existing --jobs flag; --anim single-clip re-renders and --jobs 1 stay
sequential.
Fold in a set of on-canvas readability fixes: Spanish decimal commas in
the FDTD time readouts, time and phase-caption labels repositioned clear
of tick labels and legends, a legible dark pill behind the ducting
channel-axis label, a mathtext L_W subscript in the two-rooms readout,
and the onset magnifier kept fully inside its panel.
* Re-render the documentation animations at 2400x1350
Regenerate every clip (WebM x four language/theme variants, EN GIF and
poster stills) at the new 300 DPI resolution with the tuned VP9 encode,
and refresh the posters at the matching intrinsic size.
* Link the high-resolution WebM under each docs GIF and resize site embeds
Add a one-line link to the high-resolution WebM of each clip beneath every
animation GIF in the GitHub-facing guides, and update the site <video>
embeds (EN + ES) to the new 2400x1350 intrinsic size. The GIF dimensions
are unchanged.
* docs: clamp the onset magnifier against the left panel edge
docs: 300 dpi animations, tuned VP9 encoding, parallel rendering and audit fixes (#192)
* Render documentation animations at 300 DPI with a parallel pipeline
Raise the animation resolution from 800x450 to 2400x1350 (300 DPI, same
8x4.5 figure) so the clips stay crisp on high-density displays, and tune
the VP9 WebM encode (-tune-content screen -row-mt 1 -deadline good
-cpu-used 4) to roughly halve the encode time at the same file size. The
GitHub GIF fallback stays at 640 px.
Add a spawned process-pool renderer for the clips (one grouped task per
clip so each FDTD field is simulated once and reused across its four
language/theme variants), mirroring the figure runner and wired to the
existing --jobs flag; --anim single-clip re-renders and --jobs 1 stay
sequential.
Fold in a set of on-canvas readability fixes: Spanish decimal commas in
the FDTD time readouts, time and phase-caption labels repositioned clear
of tick labels and legends, a legible dark pill behind the ducting
channel-axis label, a mathtext L_W subscript in the two-rooms readout,
and the onset magnifier kept fully inside its panel.
* Re-render the documentation animations at 2400x1350
Regenerate every clip (WebM x four language/theme variants, EN GIF and
poster stills) at the new 300 DPI resolution with the tuned VP9 encode,
and refresh the posters at the matching intrinsic size.
* Link the high-resolution WebM under each docs GIF and resize site embeds
Add a one-line link to the high-resolution WebM of each clip beneath every
animation GIF in the GitHub-facing guides, and update the site <video>
embeds (EN + ES) to the new 2400x1350 intrinsic size. The GIF dimensions
are unchanged.
* docs: clamp the onset magnifier against the left panel edge
docs: 300 dpi animations, tuned VP9 encoding, parallel rendering and audit fixes (#192)
* Render documentation animations at 300 DPI with a parallel pipeline
Raise the animation resolution from 800x450 to 2400x1350 (300 DPI, same
8x4.5 figure) so the clips stay crisp on high-density displays, and tune
the VP9 WebM encode (-tune-content screen -row-mt 1 -deadline good
-cpu-used 4) to roughly halve the encode time at the same file size. The
GitHub GIF fallback stays at 640 px.
Add a spawned process-pool renderer for the clips (one grouped task per
clip so each FDTD field is simulated once and reused across its four
language/theme variants), mirroring the figure runner and wired to the
existing --jobs flag; --anim single-clip re-renders and --jobs 1 stay
sequential.
Fold in a set of on-canvas readability fixes: Spanish decimal commas in
the FDTD time readouts, time and phase-caption labels repositioned clear
of tick labels and legends, a legible dark pill behind the ducting
channel-axis label, a mathtext L_W subscript in the two-rooms readout,
and the onset magnifier kept fully inside its panel.
* Re-render the documentation animations at 2400x1350
Regenerate every clip (WebM x four language/theme variants, EN GIF and
poster stills) at the new 300 DPI resolution with the tuned VP9 encode,
and refresh the posters at the matching intrinsic size.
* Link the high-resolution WebM under each docs GIF and resize site embeds
Add a one-line link to the high-resolution WebM of each clip beneath every
animation GIF in the GitHub-facing guides, and update the site <video>
embeds (EN + ES) to the new 2400x1350 intrinsic size. The GIF dimensions
are unchanged.
* docs: clamp the onset magnifier against the left panel edge
docs: 300 dpi animations, tuned VP9 encoding, parallel rendering and audit fixes (#192)
* Render documentation animations at 300 DPI with a parallel pipeline
Raise the animation resolution from 800x450 to 2400x1350 (300 DPI, same
8x4.5 figure) so the clips stay crisp on high-density displays, and tune
the VP9 WebM encode (-tune-content screen -row-mt 1 -deadline good
-cpu-used 4) to roughly halve the encode time at the same file size. The
GitHub GIF fallback stays at 640 px.
Add a spawned process-pool renderer for the clips (one grouped task per
clip so each FDTD field is simulated once and reused across its four
language/theme variants), mirroring the figure runner and wired to the
existing --jobs flag; --anim single-clip re-renders and --jobs 1 stay
sequential.
Fold in a set of on-canvas readability fixes: Spanish decimal commas in
the FDTD time readouts, time and phase-caption labels repositioned clear
of tick labels and legends, a legible dark pill behind the ducting
channel-axis label, a mathtext L_W subscript in the two-rooms readout,
and the onset magnifier kept fully inside its panel.
* Re-render the documentation animations at 2400x1350
Regenerate every clip (WebM x four language/theme variants, EN GIF and
poster stills) at the new 300 DPI resolution with the tuned VP9 encode,
and refresh the posters at the matching intrinsic size.
* Link the high-resolution WebM under each docs GIF and resize site embeds
Add a one-line link to the high-resolution WebM of each clip beneath every
animation GIF in the GitHub-facing guides, and update the site <video>
embeds (EN + ES) to the new 2400x1350 intrinsic size. The GIF dimensions
are unchanged.
* docs: clamp the onset magnifier against the left panel edge
docs: 300 dpi animations, tuned VP9 encoding, parallel rendering and audit fixes (#192)
* Render documentation animations at 300 DPI with a parallel pipeline
Raise the animation resolution from 800x450 to 2400x1350 (300 DPI, same
8x4.5 figure) so the clips stay crisp on high-density displays, and tune
the VP9 WebM encode (-tune-content screen -row-mt 1 -deadline good
-cpu-used 4) to roughly halve the encode time at the same file size. The
GitHub GIF fallback stays at 640 px.
Add a spawned process-pool renderer for the clips (one grouped task per
clip so each FDTD field is simulated once and reused across its four
language/theme variants), mirroring the figure runner and wired to the
existing --jobs flag; --anim single-clip re-renders and --jobs 1 stay
sequential.
Fold in a set of on-canvas readability fixes: Spanish decimal commas in
the FDTD time readouts, time and phase-caption labels repositioned clear
of tick labels and legends, a legible dark pill behind the ducting
channel-axis label, a mathtext L_W subscript in the two-rooms readout,
and the onset magnifier kept fully inside its panel.
* Re-render the documentation animations at 2400x1350
Regenerate every clip (WebM x four language/theme variants, EN GIF and
poster stills) at the new 300 DPI resolution with the tuned VP9 encode,
and refresh the posters at the matching intrinsic size.
* Link the high-resolution WebM under each docs GIF and resize site embeds
Add a one-line link to the high-resolution WebM of each clip beneath every
animation GIF in the GitHub-facing guides, and update the site <video>
embeds (EN + ES) to the new 2400x1350 intrinsic size. The GIF dimensions
are unchanged.
* docs: clamp the onset magnifier against the left panel edge
docs: 300 dpi animations, tuned VP9 encoding, parallel rendering and audit fixes (#192)
* Render documentation animations at 300 DPI with a parallel pipeline
Raise the animation resolution from 800x450 to 2400x1350 (300 DPI, same
8x4.5 figure) so the clips stay crisp on high-density displays, and tune
the VP9 WebM encode (-tune-content screen -row-mt 1 -deadline good
-cpu-used 4) to roughly halve the encode time at the same file size. The
GitHub GIF fallback stays at 640 px.
Add a spawned process-pool renderer for the clips (one grouped task per
clip so each FDTD field is simulated once and reused across its four
language/theme variants), mirroring the figure runner and wired to the
existing --jobs flag; --anim single-clip re-renders and --jobs 1 stay
sequential.
Fold in a set of on-canvas readability fixes: Spanish decimal commas in
the FDTD time readouts, time and phase-caption labels repositioned clear
of tick labels and legends, a legible dark pill behind the ducting
channel-axis label, a mathtext L_W subscript in the two-rooms readout,
and the onset magnifier kept fully inside its panel.
* Re-render the documentation animations at 2400x1350
Regenerate every clip (WebM x four language/theme variants, EN GIF and
poster stills) at the new 300 DPI resolution with the tuned VP9 encode,
and refresh the posters at the matching intrinsic size.
* Link the high-resolution WebM under each docs GIF and resize site embeds
Add a one-line link to the high-resolution WebM of each clip beneath every
animation GIF in the GitHub-facing guides, and update the site <video>
embeds (EN + ES) to the new 2400x1350 intrinsic size. The GIF dimensions
are unchanged.
* docs: clamp the onset magnifier against the left panel edge
docs: 300 dpi animations, tuned VP9 encoding, parallel rendering and audit fixes (#192)
* Render documentation animations at 300 DPI with a parallel pipeline
Raise the animation resolution from 800x450 to 2400x1350 (300 DPI, same
8x4.5 figure) so the clips stay crisp on high-density displays, and tune
the VP9 WebM encode (-tune-content screen -row-mt 1 -deadline good
-cpu-used 4) to roughly halve the encode time at the same file size. The
GitHub GIF fallback stays at 640 px.
Add a spawned process-pool renderer for the clips (one grouped task per
clip so each FDTD field is simulated once and reused across its four
language/theme variants), mirroring the figure runner and wired to the
existing --jobs flag; --anim single-clip re-renders and --jobs 1 stay
sequential.
Fold in a set of on-canvas readability fixes: Spanish decimal commas in
the FDTD time readouts, time and phase-caption labels repositioned clear
of tick labels and legends, a legible dark pill behind the ducting
channel-axis label, a mathtext L_W subscript in the two-rooms readout,
and the onset magnifier kept fully inside its panel.
* Re-render the documentation animations at 2400x1350
Regenerate every clip (WebM x four language/theme variants, EN GIF and
poster stills) at the new 300 DPI resolution with the tuned VP9 encode,
and refresh the posters at the matching intrinsic size.
* Link the high-resolution WebM under each docs GIF and resize site embeds
Add a one-line link to the high-resolution WebM of each clip beneath every
animation GIF in the GitHub-facing guides, and update the site <video>
embeds (EN + ES) to the new 2400x1350 intrinsic size. The GIF dimensions
are unchanged.
* docs: clamp the onset magnifier against the left panel edge
docs: 300 dpi animations, tuned VP9 encoding, parallel rendering and audit fixes (#192)
* Render documentation animations at 300 DPI with a parallel pipeline
Raise the animation resolution from 800x450 to 2400x1350 (300 DPI, same
8x4.5 figure) so the clips stay crisp on high-density displays, and tune
the VP9 WebM encode (-tune-content screen -row-mt 1 -deadline good
-cpu-used 4) to roughly halve the encode time at the same file size. The
GitHub GIF fallback stays at 640 px.
Add a spawned process-pool renderer for the clips (one grouped task per
clip so each FDTD field is simulated once and reused across its four
language/theme variants), mirroring the figure runner and wired to the
existing --jobs flag; --anim single-clip re-renders and --jobs 1 stay
sequential.
Fold in a set of on-canvas readability fixes: Spanish decimal commas in
the FDTD time readouts, time and phase-caption labels repositioned clear
of tick labels and legends, a legible dark pill behind the ducting
channel-axis label, a mathtext L_W subscript in the two-rooms readout,
and the onset magnifier kept fully inside its panel.
* Re-render the documentation animations at 2400x1350
Regenerate every clip (WebM x four language/theme variants, EN GIF and
poster stills) at the new 300 DPI resolution with the tuned VP9 encode,
and refresh the posters at the matching intrinsic size.
* Link the high-resolution WebM under each docs GIF and resize site embeds
Add a one-line link to the high-resolution WebM of each clip beneath every
animation GIF in the GitHub-facing guides, and update the site <video>
embeds (EN + ES) to the new 2400x1350 intrinsic size. The GIF dimensions
are unchanged.
* docs: clamp the onset magnifier against the left panel edge
docs: 300 dpi animations, tuned VP9 encoding, parallel rendering and audit fixes (#192)
* Render documentation animations at 300 DPI with a parallel pipeline
Raise the animation resolution from 800x450 to 2400x1350 (300 DPI, same
8x4.5 figure) so the clips stay crisp on high-density displays, and tune
the VP9 WebM encode (-tune-content screen -row-mt 1 -deadline good
-cpu-used 4) to roughly halve the encode time at the same file size. The
GitHub GIF fallback stays at 640 px.
Add a spawned process-pool renderer for the clips (one grouped task per
clip so each FDTD field is simulated once and reused across its four
language/theme variants), mirroring the figure runner and wired to the
existing --jobs flag; --anim single-clip re-renders and --jobs 1 stay
sequential.
Fold in a set of on-canvas readability fixes: Spanish decimal commas in
the FDTD time readouts, time and phase-caption labels repositioned clear
of tick labels and legends, a legible dark pill behind the ducting
channel-axis label, a mathtext L_W subscript in the two-rooms readout,
and the onset magnifier kept fully inside its panel.
* Re-render the documentation animations at 2400x1350
Regenerate every clip (WebM x four language/theme variants, EN GIF and
poster stills) at the new 300 DPI resolution with the tuned VP9 encode,
and refresh the posters at the matching intrinsic size.
* Link the high-resolution WebM under each docs GIF and resize site embeds
Add a one-line link to the high-resolution WebM of each clip beneath every
animation GIF in the GitHub-facing guides, and update the site <video>
embeds (EN + ES) to the new 2400x1350 intrinsic size. The GIF dimensions
are unchanged.
* docs: clamp the onset magnifier against the left panel edge
docs: 300 dpi animations, tuned VP9 encoding, parallel rendering and audit fixes (#192)
* Render documentation animations at 300 DPI with a parallel pipeline
Raise the animation resolution from 800x450 to 2400x1350 (300 DPI, same
8x4.5 figure) so the clips stay crisp on high-density displays, and tune
the VP9 WebM encode (-tune-content screen -row-mt 1 -deadline good
-cpu-used 4) to roughly halve the encode time at the same file size. The
GitHub GIF fallback stays at 640 px.
Add a spawned process-pool renderer for the clips (one grouped task per
clip so each FDTD field is simulated once and reused across its four
language/theme variants), mirroring the figure runner and wired to the
existing --jobs flag; --anim single-clip re-renders and --jobs 1 stay
sequential.
Fold in a set of on-canvas readability fixes: Spanish decimal commas in
the FDTD time readouts, time and phase-caption labels repositioned clear
of tick labels and legends, a legible dark pill behind the ducting
channel-axis label, a mathtext L_W subscript in the two-rooms readout,
and the onset magnifier kept fully inside its panel.
* Re-render the documentation animations at 2400x1350
Regenerate every clip (WebM x four language/theme variants, EN GIF and
poster stills) at the new 300 DPI resolution with the tuned VP9 encode,
and refresh the posters at the matching intrinsic size.
* Link the high-resolution WebM under each docs GIF and resize site embeds
Add a one-line link to the high-resolution WebM of each clip beneath every
animation GIF in the GitHub-facing guides, and update the site <video>
embeds (EN + ES) to the new 2400x1350 intrinsic size. The GIF dimensions
are unchanged.
* docs: clamp the onset magnifier against the left panel edge
docs: 300 dpi animations, tuned VP9 encoding, parallel rendering and audit fixes (#192)
* Render documentation animations at 300 DPI with a parallel pipeline
Raise the animation resolution from 800x450 to 2400x1350 (300 DPI, same
8x4.5 figure) so the clips stay crisp on high-density displays, and tune
the VP9 WebM encode (-tune-content screen -row-mt 1 -deadline good
-cpu-used 4) to roughly halve the encode time at the same file size. The
GitHub GIF fallback stays at 640 px.
Add a spawned process-pool renderer for the clips (one grouped task per
clip so each FDTD field is simulated once and reused across its four
language/theme variants), mirroring the figure runner and wired to the
existing --jobs flag; --anim single-clip re-renders and --jobs 1 stay
sequential.
Fold in a set of on-canvas readability fixes: Spanish decimal commas in
the FDTD time readouts, time and phase-caption labels repositioned clear
of tick labels and legends, a legible dark pill behind the ducting
channel-axis label, a mathtext L_W subscript in the two-rooms readout,
and the onset magnifier kept fully inside its panel.
* Re-render the documentation animations at 2400x1350
Regenerate every clip (WebM x four language/theme variants, EN GIF and
poster stills) at the new 300 DPI resolution with the tuned VP9 encode,
and refresh the posters at the matching intrinsic size.
* Link the high-resolution WebM under each docs GIF and resize site embeds
Add a one-line link to the high-resolution WebM of each clip beneath every
animation GIF in the GitHub-facing guides, and update the site <video>
embeds (EN + ES) to the new 2400x1350 intrinsic size. The GIF dimensions
are unchanged.
* docs: clamp the onset magnifier against the left panel edge
docs: 300 dpi animations, tuned VP9 encoding, parallel rendering and audit fixes (#192)
* Render documentation animations at 300 DPI with a parallel pipeline
Raise the animation resolution from 800x450 to 2400x1350 (300 DPI, same
8x4.5 figure) so the clips stay crisp on high-density displays, and tune
the VP9 WebM encode (-tune-content screen -row-mt 1 -deadline good
-cpu-used 4) to roughly halve the encode time at the same file size. The
GitHub GIF fallback stays at 640 px.
Add a spawned process-pool renderer for the clips (one grouped task per
clip so each FDTD field is simulated once and reused across its four
language/theme variants), mirroring the figure runner and wired to the
existing --jobs flag; --anim single-clip re-renders and --jobs 1 stay
sequential.
Fold in a set of on-canvas readability fixes: Spanish decimal commas in
the FDTD time readouts, time and phase-caption labels repositioned clear
of tick labels and legends, a legible dark pill behind the ducting
channel-axis label, a mathtext L_W subscript in the two-rooms readout,
and the onset magnifier kept fully inside its panel.
* Re-render the documentation animations at 2400x1350
Regenerate every clip (WebM x four language/theme variants, EN GIF and
poster stills) at the new 300 DPI resolution with the tuned VP9 encode,
and refresh the posters at the matching intrinsic size.
* Link the high-resolution WebM under each docs GIF and resize site embeds
Add a one-line link to the high-resolution WebM of each clip beneath every
animation GIF in the GitHub-facing guides, and update the site <video>
embeds (EN + ES) to the new 2400x1350 intrinsic size. The GIF dimensions
are unchanged.
* docs: clamp the onset magnifier against the left panel edge
docs: 300 dpi animations, tuned VP9 encoding, parallel rendering and audit fixes (#192)
* Render documentation animations at 300 DPI with a parallel pipeline
Raise the animation resolution from 800x450 to 2400x1350 (300 DPI, same
8x4.5 figure) so the clips stay crisp on high-density displays, and tune
the VP9 WebM encode (-tune-content screen -row-mt 1 -deadline good
-cpu-used 4) to roughly halve the encode time at the same file size. The
GitHub GIF fallback stays at 640 px.
Add a spawned process-pool renderer for the clips (one grouped task per
clip so each FDTD field is simulated once and reused across its four
language/theme variants), mirroring the figure runner and wired to the
existing --jobs flag; --anim single-clip re-renders and --jobs 1 stay
sequential.
Fold in a set of on-canvas readability fixes: Spanish decimal commas in
the FDTD time readouts, time and phase-caption labels repositioned clear
of tick labels and legends, a legible dark pill behind the ducting
channel-axis label, a mathtext L_W subscript in the two-rooms readout,
and the onset magnifier kept fully inside its panel.
* Re-render the documentation animations at 2400x1350
Regenerate every clip (WebM x four language/theme variants, EN GIF and
poster stills) at the new 300 DPI resolution with the tuned VP9 encode,
and refresh the posters at the matching intrinsic size.
* Link the high-resolution WebM under each docs GIF and resize site embeds
Add a one-line link to the high-resolution WebM of each clip beneath every
animation GIF in the GitHub-facing guides, and update the site <video>
embeds (EN + ES) to the new 2400x1350 intrinsic size. The GIF dimensions
are unchanged.
* docs: clamp the onset magnifier against the left panel edge
docs: 300 dpi animations, tuned VP9 encoding, parallel rendering and audit fixes (#192)
* Render documentation animations at 300 DPI with a parallel pipeline
Raise the animation resolution from 800x450 to 2400x1350 (300 DPI, same
8x4.5 figure) so the clips stay crisp on high-density displays, and tune
the VP9 WebM encode (-tune-content screen -row-mt 1 -deadline good
-cpu-used 4) to roughly halve the encode time at the same file size. The
GitHub GIF fallback stays at 640 px.
Add a spawned process-pool renderer for the clips (one grouped task per
clip so each FDTD field is simulated once and reused across its four
language/theme variants), mirroring the figure runner and wired to the
existing --jobs flag; --anim single-clip re-renders and --jobs 1 stay
sequential.
Fold in a set of on-canvas readability fixes: Spanish decimal commas in
the FDTD time readouts, time and phase-caption labels repositioned clear
of tick labels and legends, a legible dark pill behind the ducting
channel-axis label, a mathtext L_W subscript in the two-rooms readout,
and the onset magnifier kept fully inside its panel.
* Re-render the documentation animations at 2400x1350
Regenerate every clip (WebM x four language/theme variants, EN GIF and
poster stills) at the new 300 DPI resolution with the tuned VP9 encode,
and refresh the posters at the matching intrinsic size.
* Link the high-resolution WebM under each docs GIF and resize site embeds
Add a one-line link to the high-resolution WebM of each clip beneath every
animation GIF in the GitHub-facing guides, and update the site <video>
embeds (EN + ES) to the new 2400x1350 intrinsic size. The GIF dimensions
are unchanged.
* docs: clamp the onset magnifier against the left panel edge
docs: 300 dpi animations, tuned VP9 encoding, parallel rendering and audit fixes (#192)
* Render documentation animations at 300 DPI with a parallel pipeline
Raise the animation resolution from 800x450 to 2400x1350 (300 DPI, same
8x4.5 figure) so the clips stay crisp on high-density displays, and tune
the VP9 WebM encode (-tune-content screen -row-mt 1 -deadline good
-cpu-used 4) to roughly halve the encode time at the same file size. The
GitHub GIF fallback stays at 640 px.
Add a spawned process-pool renderer for the clips (one grouped task per
clip so each FDTD field is simulated once and reused across its four
language/theme variants), mirroring the figure runner and wired to the
existing --jobs flag; --anim single-clip re-renders and --jobs 1 stay
sequential.
Fold in a set of on-canvas readability fixes: Spanish decimal commas in
the FDTD time readouts, time and phase-caption labels repositioned clear
of tick labels and legends, a legible dark pill behind the ducting
channel-axis label, a mathtext L_W subscript in the two-rooms readout,
and the onset magnifier kept fully inside its panel.
* Re-render the documentation animations at 2400x1350
Regenerate every clip (WebM x four language/theme variants, EN GIF and
poster stills) at the new 300 DPI resolution with the tuned VP9 encode,
and refresh the posters at the matching intrinsic size.
* Link the high-resolution WebM under each docs GIF and resize site embeds
Add a one-line link to the high-resolution WebM of each clip beneath every
animation GIF in the GitHub-facing guides, and update the site <video>
embeds (EN + ES) to the new 2400x1350 intrinsic size. The GIF dimensions
are unchanged.
* docs: clamp the onset magnifier against the left panel edge
docs: 300 dpi animations, tuned VP9 encoding, parallel rendering and audit fixes (#192)
* Render documentation animations at 300 DPI with a parallel pipeline
Raise the animation resolution from 800x450 to 2400x1350 (300 DPI, same
8x4.5 figure) so the clips stay crisp on high-density displays, and tune
the VP9 WebM encode (-tune-content screen -row-mt 1 -deadline good
-cpu-used 4) to roughly halve the encode time at the same file size. The
GitHub GIF fallback stays at 640 px.
Add a spawned process-pool renderer for the clips (one grouped task per
clip so each FDTD field is simulated once and reused across its four
language/theme variants), mirroring the figure runner and wired to the
existing --jobs flag; --anim single-clip re-renders and --jobs 1 stay
sequential.
Fold in a set of on-canvas readability fixes: Spanish decimal commas in
the FDTD time readouts, time and phase-caption labels repositioned clear
of tick labels and legends, a legible dark pill behind the ducting
channel-axis label, a mathtext L_W subscript in the two-rooms readout,
and the onset magnifier kept fully inside its panel.
* Re-render the documentation animations at 2400x1350
Regenerate every clip (WebM x four language/theme variants, EN GIF and
poster stills) at the new 300 DPI resolution with the tuned VP9 encode,
and refresh the posters at the matching intrinsic size.
* Link the high-resolution WebM under each docs GIF and resize site embeds
Add a one-line link to the high-resolution WebM of each clip beneath every
animation GIF in the GitHub-facing guides, and update the site <video>
embeds (EN + ES) to the new 2400x1350 intrinsic size. The GIF dimensions
are unchanged.
* docs: clamp the onset magnifier against the left panel edge
docs: 300 dpi animations, tuned VP9 encoding, parallel rendering and audit fixes (#192)
* Render documentation animations at 300 DPI with a parallel pipeline
Raise the animation resolution from 800x450 to 2400x1350 (300 DPI, same
8x4.5 figure) so the clips stay crisp on high-density displays, and tune
the VP9 WebM encode (-tune-content screen -row-mt 1 -deadline good
-cpu-used 4) to roughly halve the encode time at the same file size. The
GitHub GIF fallback stays at 640 px.
Add a spawned process-pool renderer for the clips (one grouped task per
clip so each FDTD field is simulated once and reused across its four
language/theme variants), mirroring the figure runner and wired to the
existing --jobs flag; --anim single-clip re-renders and --jobs 1 stay
sequential.
Fold in a set of on-canvas readability fixes: Spanish decimal commas in
the FDTD time readouts, time and phase-caption labels repositioned clear
of tick labels and legends, a legible dark pill behind the ducting
channel-axis label, a mathtext L_W subscript in the two-rooms readout,
and the onset magnifier kept fully inside its panel.
* Re-render the documentation animations at 2400x1350
Regenerate every clip (WebM x four language/theme variants, EN GIF and
poster stills) at the new 300 DPI resolution with the tuned VP9 encode,
and refresh the posters at the matching intrinsic size.
* Link the high-resolution WebM under each docs GIF and resize site embeds
Add a one-line link to the high-resolution WebM of each clip beneath every
animation GIF in the GitHub-facing guides, and update the site <video>
embeds (EN + ES) to the new 2400x1350 intrinsic size. The GIF dimensions
are unchanged.
* docs: clamp the onset magnifier against the left panel edge
docs: 300 dpi animations, tuned VP9 encoding, parallel rendering and audit fixes (#192)
* Render documentation animations at 300 DPI with a parallel pipeline
Raise the animation resolution from 800x450 to 2400x1350 (300 DPI, same
8x4.5 figure) so the clips stay crisp on high-density displays, and tune
the VP9 WebM encode (-tune-content screen -row-mt 1 -deadline good
-cpu-used 4) to roughly halve the encode time at the same file size. The
GitHub GIF fallback stays at 640 px.
Add a spawned process-pool renderer for the clips (one grouped task per
clip so each FDTD field is simulated once and reused across its four
language/theme variants), mirroring the figure runner and wired to the
existing --jobs flag; --anim single-clip re-renders and --jobs 1 stay
sequential.
Fold in a set of on-canvas readability fixes: Spanish decimal commas in
the FDTD time readouts, time and phase-caption labels repositioned clear
of tick labels and legends, a legible dark pill behind the ducting
channel-axis label, a mathtext L_W subscript in the two-rooms readout,
and the onset magnifier kept fully inside its panel.
* Re-render the documentation animations at 2400x1350
Regenerate every clip (WebM x four language/theme variants, EN GIF and
poster stills) at the new 300 DPI resolution with the tuned VP9 encode,
and refresh the posters at the matching intrinsic size.
* Link the high-resolution WebM under each docs GIF and resize site embeds
Add a one-line link to the high-resolution WebM of each clip beneath every
animation GIF in the GitHub-facing guides, and update the site <video>
embeds (EN + ES) to the new 2400x1350 intrinsic size. The GIF dimensions
are unchanged.
* docs: clamp the onset magnifier against the left panel edge
docs: 300 dpi animations, tuned VP9 encoding, parallel rendering and audit fixes (#192)
* Render documentation animations at 300 DPI with a parallel pipeline
Raise the animation resolution from 800x450 to 2400x1350 (300 DPI, same
8x4.5 figure) so the clips stay crisp on high-density displays, and tune
the VP9 WebM encode (-tune-content screen -row-mt 1 -deadline good
-cpu-used 4) to roughly halve the encode time at the same file size. The
GitHub GIF fallback stays at 640 px.
Add a spawned process-pool renderer for the clips (one grouped task per
clip so each FDTD field is simulated once and reused across its four
language/theme variants), mirroring the figure runner and wired to the
existing --jobs flag; --anim single-clip re-renders and --jobs 1 stay
sequential.
Fold in a set of on-canvas readability fixes: Spanish decimal commas in
the FDTD time readouts, time and phase-caption labels repositioned clear
of tick labels and legends, a legible dark pill behind the ducting
channel-axis label, a mathtext L_W subscript in the two-rooms readout,
and the onset magnifier kept fully inside its panel.
* Re-render the documentation animations at 2400x1350
Regenerate every clip (WebM x four language/theme variants, EN GIF and
poster stills) at the new 300 DPI resolution with the tuned VP9 encode,
and refresh the posters at the matching intrinsic size.
* Link the high-resolution WebM under each docs GIF and resize site embeds
Add a one-line link to the high-resolution WebM of each clip beneath every
animation GIF in the GitHub-facing guides, and update the site <video>
embeds (EN + ES) to the new 2400x1350 intrinsic size. The GIF dimensions
are unchanged.
* docs: clamp the onset magnifier against the left panel edge
docs: 300 dpi animations, tuned VP9 encoding, parallel rendering and audit fixes (#192)
* Render documentation animations at 300 DPI with a parallel pipeline
Raise the animation resolution from 800x450 to 2400x1350 (300 DPI, same
8x4.5 figure) so the clips stay crisp on high-density displays, and tune
the VP9 WebM encode (-tune-content screen -row-mt 1 -deadline good
-cpu-used 4) to roughly halve the encode time at the same file size. The
GitHub GIF fallback stays at 640 px.
Add a spawned process-pool renderer for the clips (one grouped task per
clip so each FDTD field is simulated once and reused across its four
language/theme variants), mirroring the figure runner and wired to the
existing --jobs flag; --anim single-clip re-renders and --jobs 1 stay
sequential.
Fold in a set of on-canvas readability fixes: Spanish decimal commas in
the FDTD time readouts, time and phase-caption labels repositioned clear
of tick labels and legends, a legible dark pill behind the ducting
channel-axis label, a mathtext L_W subscript in the two-rooms readout,
and the onset magnifier kept fully inside its panel.
* Re-render the documentation animations at 2400x1350
Regenerate every clip (WebM x four language/theme variants, EN GIF and
poster stills) at the new 300 DPI resolution with the tuned VP9 encode,
and refresh the posters at the matching intrinsic size.
* Link the high-resolution WebM under each docs GIF and resize site embeds
Add a one-line link to the high-resolution WebM of each clip beneath every
animation GIF in the GitHub-facing guides, and update the site <video>
embeds (EN + ES) to the new 2400x1350 intrinsic size. The GIF dimensions
are unchanged.
* docs: clamp the onset magnifier against the left panel edge
docs: 300 dpi animations, tuned VP9 encoding, parallel rendering and audit fixes (#192)
* Render documentation animations at 300 DPI with a parallel pipeline
Raise the animation resolution from 800x450 to 2400x1350 (300 DPI, same
8x4.5 figure) so the clips stay crisp on high-density displays, and tune
the VP9 WebM encode (-tune-content screen -row-mt 1 -deadline good
-cpu-used 4) to roughly halve the encode time at the same file size. The
GitHub GIF fallback stays at 640 px.
Add a spawned process-pool renderer for the clips (one grouped task per
clip so each FDTD field is simulated once and reused across its four
language/theme variants), mirroring the figure runner and wired to the
existing --jobs flag; --anim single-clip re-renders and --jobs 1 stay
sequential.
Fold in a set of on-canvas readability fixes: Spanish decimal commas in
the FDTD time readouts, time and phase-caption labels repositioned clear
of tick labels and legends, a legible dark pill behind the ducting
channel-axis label, a mathtext L_W subscript in the two-rooms readout,
and the onset magnifier kept fully inside its panel.
* Re-render the documentation animations at 2400x1350
Regenerate every clip (WebM x four language/theme variants, EN GIF and
poster stills) at the new 300 DPI resolution with the tuned VP9 encode,
and refresh the posters at the matching intrinsic size.
* Link the high-resolution WebM under each docs GIF and resize site embeds
Add a one-line link to the high-resolution WebM of each clip beneath every
animation GIF in the GitHub-facing guides, and update the site <video>
embeds (EN + ES) to the new 2400x1350 intrinsic size. The GIF dimensions
are unchanged.
* docs: clamp the onset magnifier against the left panel edge
docs: 300 dpi animations, tuned VP9 encoding, parallel rendering and audit fixes (#192)
* Render documentation animations at 300 DPI with a parallel pipeline
Raise the animation resolution from 800x450 to 2400x1350 (300 DPI, same
8x4.5 figure) so the clips stay crisp on high-density displays, and tune
the VP9 WebM encode (-tune-content screen -row-mt 1 -deadline good
-cpu-used 4) to roughly halve the encode time at the same file size. The
GitHub GIF fallback stays at 640 px.
Add a spawned process-pool renderer for the clips (one grouped task per
clip so each FDTD field is simulated once and reused across its four
language/theme variants), mirroring the figure runner and wired to the
existing --jobs flag; --anim single-clip re-renders and --jobs 1 stay
sequential.
Fold in a set of on-canvas readability fixes: Spanish decimal commas in
the FDTD time readouts, time and phase-caption labels repositioned clear
of tick labels and legends, a legible dark pill behind the ducting
channel-axis label, a mathtext L_W subscript in the two-rooms readout,
and the onset magnifier kept fully inside its panel.
* Re-render the documentation animations at 2400x1350
Regenerate every clip (WebM x four language/theme variants, EN GIF and
poster stills) at the new 300 DPI resolution with the tuned VP9 encode,
and refresh the posters at the matching intrinsic size.
* Link the high-resolution WebM under each docs GIF and resize site embeds
Add a one-line link to the high-resolution WebM of each clip beneath every
animation GIF in the GitHub-facing guides, and update the site <video>
embeds (EN + ES) to the new 2400x1350 intrinsic size. The GIF dimensions
are unchanged.
* docs: clamp the onset magnifier against the left panel edge
docs: 300 dpi animations, tuned VP9 encoding, parallel rendering and audit fixes (#192)
* Render documentation animations at 300 DPI with a parallel pipeline
Raise the animation resolution from 800x450 to 2400x1350 (300 DPI, same
8x4.5 figure) so the clips stay crisp on high-density displays, and tune
the VP9 WebM encode (-tune-content screen -row-mt 1 -deadline good
-cpu-used 4) to roughly halve the encode time at the same file size. The
GitHub GIF fallback stays at 640 px.
Add a spawned process-pool renderer for the clips (one grouped task per
clip so each FDTD field is simulated once and reused across its four
language/theme variants), mirroring the figure runner and wired to the
existing --jobs flag; --anim single-clip re-renders and --jobs 1 stay
sequential.
Fold in a set of on-canvas readability fixes: Spanish decimal commas in
the FDTD time readouts, time and phase-caption labels repositioned clear
of tick labels and legends, a legible dark pill behind the ducting
channel-axis label, a mathtext L_W subscript in the two-rooms readout,
and the onset magnifier kept fully inside its panel.
* Re-render the documentation animations at 2400x1350
Regenerate every clip (WebM x four language/theme variants, EN GIF and
poster stills) at the new 300 DPI resolution with the tuned VP9 encode,
and refresh the posters at the matching intrinsic size.
* Link the high-resolution WebM under each docs GIF and resize site embeds
Add a one-line link to the high-resolution WebM of each clip beneath every
animation GIF in the GitHub-facing guides, and update the site <video>
embeds (EN + ES) to the new 2400x1350 intrinsic size. The GIF dimensions
are unchanged.
* docs: clamp the onset magnifier against the left panel edge
docs: 300 dpi animations, tuned VP9 encoding, parallel rendering and audit fixes (#192)
* Render documentation animations at 300 DPI with a parallel pipeline
Raise the animation resolution from 800x450 to 2400x1350 (300 DPI, same
8x4.5 figure) so the clips stay crisp on high-density displays, and tune
the VP9 WebM encode (-tune-content screen -row-mt 1 -deadline good
-cpu-used 4) to roughly halve the encode time at the same file size. The
GitHub GIF fallback stays at 640 px.
Add a spawned process-pool renderer for the clips (one grouped task per
clip so each FDTD field is simulated once and reused across its four
language/theme variants), mirroring the figure runner and wired to the
existing --jobs flag; --anim single-clip re-renders and --jobs 1 stay
sequential.
Fold in a set of on-canvas readability fixes: Spanish decimal commas in
the FDTD time readouts, time and phase-caption labels repositioned clear
of tick labels and legends, a legible dark pill behind the ducting
channel-axis label, a mathtext L_W subscript in the two-rooms readout,
and the onset magnifier kept fully inside its panel.
* Re-render the documentation animations at 2400x1350
Regenerate every clip (WebM x four language/theme variants, EN GIF and
poster stills) at the new 300 DPI resolution with the tuned VP9 encode,
and refresh the posters at the matching intrinsic size.
* Link the high-resolution WebM under each docs GIF and resize site embeds
Add a one-line link to the high-resolution WebM of each clip beneath every
animation GIF in the GitHub-facing guides, and update the site <video>
embeds (EN + ES) to the new 2400x1350 intrinsic size. The GIF dimensions
are unchanged.
* docs: clamp the onset magnifier against the left panel edge
docs: 300 dpi animations, tuned VP9 encoding, parallel rendering and audit fixes (#192)
* Render documentation animations at 300 DPI with a parallel pipeline
Raise the animation resolution from 800x450 to 2400x1350 (300 DPI, same
8x4.5 figure) so the clips stay crisp on high-density displays, and tune
the VP9 WebM encode (-tune-content screen -row-mt 1 -deadline good
-cpu-used 4) to roughly halve the encode time at the same file size. The
GitHub GIF fallback stays at 640 px.
Add a spawned process-pool renderer for the clips (one grouped task per
clip so each FDTD field is simulated once and reused across its four
language/theme variants), mirroring the figure runner and wired to the
existing --jobs flag; --anim single-clip re-renders and --jobs 1 stay
sequential.
Fold in a set of on-canvas readability fixes: Spanish decimal commas in
the FDTD time readouts, time and phase-caption labels repositioned clear
of tick labels and legends, a legible dark pill behind the ducting
channel-axis label, a mathtext L_W subscript in the two-rooms readout,
and the onset magnifier kept fully inside its panel.
* Re-render the documentation animations at 2400x1350
Regenerate every clip (WebM x four language/theme variants, EN GIF and
poster stills) at the new 300 DPI resolution with the tuned VP9 encode,
and refresh the posters at the matching intrinsic size.
* Link the high-resolution WebM under each docs GIF and resize site embeds
Add a one-line link to the high-resolution WebM of each clip beneath every
animation GIF in the GitHub-facing guides, and update the site <video>
embeds (EN + ES) to the new 2400x1350 intrinsic size. The GIF dimensions
are unchanged.
* docs: clamp the onset magnifier against the left panel edge
docs: 300 dpi animations, tuned VP9 encoding, parallel rendering and audit fixes (#192)
* Render documentation animations at 300 DPI with a parallel pipeline
Raise the animation resolution from 800x450 to 2400x1350 (300 DPI, same
8x4.5 figure) so the clips stay crisp on high-density displays, and tune
the VP9 WebM encode (-tune-content screen -row-mt 1 -deadline good
-cpu-used 4) to roughly halve the encode time at the same file size. The
GitHub GIF fallback stays at 640 px.
Add a spawned process-pool renderer for the clips (one grouped task per
clip so each FDTD field is simulated once and reused across its four
language/theme variants), mirroring the figure runner and wired to the
existing --jobs flag; --anim single-clip re-renders and --jobs 1 stay
sequential.
Fold in a set of on-canvas readability fixes: Spanish decimal commas in
the FDTD time readouts, time and phase-caption labels repositioned clear
of tick labels and legends, a legible dark pill behind the ducting
channel-axis label, a mathtext L_W subscript in the two-rooms readout,
and the onset magnifier kept fully inside its panel.
* Re-render the documentation animations at 2400x1350
Regenerate every clip (WebM x four language/theme variants, EN GIF and
poster stills) at the new 300 DPI resolution with the tuned VP9 encode,
and refresh the posters at the matching intrinsic size.
* Link the high-resolution WebM under each docs GIF and resize site embeds
Add a one-line link to the high-resolution WebM of each clip beneath every
animation GIF in the GitHub-facing guides, and update the site <video>
embeds (EN + ES) to the new 2400x1350 intrinsic size. The GIF dimensions
are unchanged.
* docs: clamp the onset magnifier against the left panel edge
docs: 300 dpi animations, tuned VP9 encoding, parallel rendering and audit fixes (#192)
* Render documentation animations at 300 DPI with a parallel pipeline
Raise the animation resolution from 800x450 to 2400x1350 (300 DPI, same
8x4.5 figure) so the clips stay crisp on high-density displays, and tune
the VP9 WebM encode (-tune-content screen -row-mt 1 -deadline good
-cpu-used 4) to roughly halve the encode time at the same file size. The
GitHub GIF fallback stays at 640 px.
Add a spawned process-pool renderer for the clips (one grouped task per
clip so each FDTD field is simulated once and reused across its four
language/theme variants), mirroring the figure runner and wired to the
existing --jobs flag; --anim single-clip re-renders and --jobs 1 stay
sequential.
Fold in a set of on-canvas readability fixes: Spanish decimal commas in
the FDTD time readouts, time and phase-caption labels repositioned clear
of tick labels and legends, a legible dark pill behind the ducting
channel-axis label, a mathtext L_W subscript in the two-rooms readout,
and the onset magnifier kept fully inside its panel.
* Re-render the documentation animations at 2400x1350
Regenerate every clip (WebM x four language/theme variants, EN GIF and
poster stills) at the new 300 DPI resolution with the tuned VP9 encode,
and refresh the posters at the matching intrinsic size.
* Link the high-resolution WebM under each docs GIF and resize site embeds
Add a one-line link to the high-resolution WebM of each clip beneath every
animation GIF in the GitHub-facing guides, and update the site <video>
embeds (EN + ES) to the new 2400x1350 intrinsic size. The GIF dimensions
are unchanged.
* docs: clamp the onset magnifier against the left panel edge
docs: 300 dpi animations, tuned VP9 encoding, parallel rendering and audit fixes (#192)
* Render documentation animations at 300 DPI with a parallel pipeline
Raise the animation resolution from 800x450 to 2400x1350 (300 DPI, same
8x4.5 figure) so the clips stay crisp on high-density displays, and tune
the VP9 WebM encode (-tune-content screen -row-mt 1 -deadline good
-cpu-used 4) to roughly halve the encode time at the same file size. The
GitHub GIF fallback stays at 640 px.
Add a spawned process-pool renderer for the clips (one grouped task per
clip so each FDTD field is simulated once and reused across its four
language/theme variants), mirroring the figure runner and wired to the
existing --jobs flag; --anim single-clip re-renders and --jobs 1 stay
sequential.
Fold in a set of on-canvas readability fixes: Spanish decimal commas in
the FDTD time readouts, time and phase-caption labels repositioned clear
of tick labels and legends, a legible dark pill behind the ducting
channel-axis label, a mathtext L_W subscript in the two-rooms readout,
and the onset magnifier kept fully inside its panel.
* Re-render the documentation animations at 2400x1350
Regenerate every clip (WebM x four language/theme variants, EN GIF and
poster stills) at the new 300 DPI resolution with the tuned VP9 encode,
and refresh the posters at the matching intrinsic size.
* Link the high-resolution WebM under each docs GIF and resize site embeds
Add a one-line link to the high-resolution WebM of each clip beneath every
animation GIF in the GitHub-facing guides, and update the site <video>
embeds (EN + ES) to the new 2400x1350 intrinsic size. The GIF dimensions
are unchanged.
* docs: clamp the onset magnifier against the left panel edge
docs: 300 dpi animations, tuned VP9 encoding, parallel rendering and audit fixes (#192)
* Render documentation animations at 300 DPI with a parallel pipeline
Raise the animation resolution from 800x450 to 2400x1350 (300 DPI, same
8x4.5 figure) so the clips stay crisp on high-density displays, and tune
the VP9 WebM encode (-tune-content screen -row-mt 1 -deadline good
-cpu-used 4) to roughly halve the encode time at the same file size. The
GitHub GIF fallback stays at 640 px.
Add a spawned process-pool renderer for the clips (one grouped task per
clip so each FDTD field is simulated once and reused across its four
language/theme variants), mirroring the figure runner and wired to the
existing --jobs flag; --anim single-clip re-renders and --jobs 1 stay
sequential.
Fold in a set of on-canvas readability fixes: Spanish decimal commas in
the FDTD time readouts, time and phase-caption labels repositioned clear
of tick labels and legends, a legible dark pill behind the ducting
channel-axis label, a mathtext L_W subscript in the two-rooms readout,
and the onset magnifier kept fully inside its panel.
* Re-render the documentation animations at 2400x1350
Regenerate every clip (WebM x four language/theme variants, EN GIF and
poster stills) at the new 300 DPI resolution with the tuned VP9 encode,
and refresh the posters at the matching intrinsic size.
* Link the high-resolution WebM under each docs GIF and resize site embeds
Add a one-line link to the high-resolution WebM of each clip beneath every
animation GIF in the GitHub-facing guides, and update the site <video>
embeds (EN + ES) to the new 2400x1350 intrinsic size. The GIF dimensions
are unchanged.
* docs: clamp the onset magnifier against the left panel edge
docs: 300 dpi animations, tuned VP9 encoding, parallel rendering and audit fixes (#192)
* Render documentation animations at 300 DPI with a parallel pipeline
Raise the animation resolution from 800x450 to 2400x1350 (300 DPI, same
8x4.5 figure) so the clips stay crisp on high-density displays, and tune
the VP9 WebM encode (-tune-content screen -row-mt 1 -deadline good
-cpu-used 4) to roughly halve the encode time at the same file size. The
GitHub GIF fallback stays at 640 px.
Add a spawned process-pool renderer for the clips (one grouped task per
clip so each FDTD field is simulated once and reused across its four
language/theme variants), mirroring the figure runner and wired to the
existing --jobs flag; --anim single-clip re-renders and --jobs 1 stay
sequential.
Fold in a set of on-canvas readability fixes: Spanish decimal commas in
the FDTD time readouts, time and phase-caption labels repositioned clear
of tick labels and legends, a legible dark pill behind the ducting
channel-axis label, a mathtext L_W subscript in the two-rooms readout,
and the onset magnifier kept fully inside its panel.
* Re-render the documentation animations at 2400x1350
Regenerate every clip (WebM x four language/theme variants, EN GIF and
poster stills) at the new 300 DPI resolution with the tuned VP9 encode,
and refresh the posters at the matching intrinsic size.
* Link the high-resolution WebM under each docs GIF and resize site embeds
Add a one-line link to the high-resolution WebM of each clip beneath every
animation GIF in the GitHub-facing guides, and update the site <video>
embeds (EN + ES) to the new 2400x1350 intrinsic size. The GIF dimensions
are unchanged.
* docs: clamp the onset magnifier against the left panel edge
docs: 300 dpi animations, tuned VP9 encoding, parallel rendering and audit fixes (#192)
* Render documentation animations at 300 DPI with a parallel pipeline
Raise the animation resolution from 800x450 to 2400x1350 (300 DPI, same
8x4.5 figure) so the clips stay crisp on high-density displays, and tune
the VP9 WebM encode (-tune-content screen -row-mt 1 -deadline good
-cpu-used 4) to roughly halve the encode time at the same file size. The
GitHub GIF fallback stays at 640 px.
Add a spawned process-pool renderer for the clips (one grouped task per
clip so each FDTD field is simulated once and reused across its four
language/theme variants), mirroring the figure runner and wired to the
existing --jobs flag; --anim single-clip re-renders and --jobs 1 stay
sequential.
Fold in a set of on-canvas readability fixes: Spanish decimal commas in
the FDTD time readouts, time and phase-caption labels repositioned clear
of tick labels and legends, a legible dark pill behind the ducting
channel-axis label, a mathtext L_W subscript in the two-rooms readout,
and the onset magnifier kept fully inside its panel.
* Re-render the documentation animations at 2400x1350
Regenerate every clip (WebM x four language/theme variants, EN GIF and
poster stills) at the new 300 DPI resolution with the tuned VP9 encode,
and refresh the posters at the matching intrinsic size.
* Link the high-resolution WebM under each docs GIF and resize site embeds
Add a one-line link to the high-resolution WebM of each clip beneath every
animation GIF in the GitHub-facing guides, and update the site <video>
embeds (EN + ES) to the new 2400x1350 intrinsic size. The GIF dimensions
are unchanged.
* docs: clamp the onset magnifier against the left panel edge
docs: 300 dpi animations, tuned VP9 encoding, parallel rendering and audit fixes (#192)
* Render documentation animations at 300 DPI with a parallel pipeline
Raise the animation resolution from 800x450 to 2400x1350 (300 DPI, same
8x4.5 figure) so the clips stay crisp on high-density displays, and tune
the VP9 WebM encode (-tune-content screen -row-mt 1 -deadline good
-cpu-used 4) to roughly halve the encode time at the same file size. The
GitHub GIF fallback stays at 640 px.
Add a spawned process-pool renderer for the clips (one grouped task per
clip so each FDTD field is simulated once and reused across its four
language/theme variants), mirroring the figure runner and wired to the
existing --jobs flag; --anim single-clip re-renders and --jobs 1 stay
sequential.
Fold in a set of on-canvas readability fixes: Spanish decimal commas in
the FDTD time readouts, time and phase-caption labels repositioned clear
of tick labels and legends, a legible dark pill behind the ducting
channel-axis label, a mathtext L_W subscript in the two-rooms readout,
and the onset magnifier kept fully inside its panel.
* Re-render the documentation animations at 2400x1350
Regenerate every clip (WebM x four language/theme variants, EN GIF and
poster stills) at the new 300 DPI resolution with the tuned VP9 encode,
and refresh the posters at the matching intrinsic size.
* Link the high-resolution WebM under each docs GIF and resize site embeds
Add a one-line link to the high-resolution WebM of each clip beneath every
animation GIF in the GitHub-facing guides, and update the site <video>
embeds (EN + ES) to the new 2400x1350 intrinsic size. The GIF dimensions
are unchanged.
* docs: clamp the onset magnifier against the left panel edge
docs: 300 dpi animations, tuned VP9 encoding, parallel rendering and audit fixes (#192)
* Render documentation animations at 300 DPI with a parallel pipeline
Raise the animation resolution from 800x450 to 2400x1350 (300 DPI, same
8x4.5 figure) so the clips stay crisp on high-density displays, and tune
the VP9 WebM encode (-tune-content screen -row-mt 1 -deadline good
-cpu-used 4) to roughly halve the encode time at the same file size. The
GitHub GIF fallback stays at 640 px.
Add a spawned process-pool renderer for the clips (one grouped task per
clip so each FDTD field is simulated once and reused across its four
language/theme variants), mirroring the figure runner and wired to the
existing --jobs flag; --anim single-clip re-renders and --jobs 1 stay
sequential.
Fold in a set of on-canvas readability fixes: Spanish decimal commas in
the FDTD time readouts, time and phase-caption labels repositioned clear
of tick labels and legends, a legible dark pill behind the ducting
channel-axis label, a mathtext L_W subscript in the two-rooms readout,
and the onset magnifier kept fully inside its panel.
* Re-render the documentation animations at 2400x1350
Regenerate every clip (WebM x four language/theme variants, EN GIF and
poster stills) at the new 300 DPI resolution with the tuned VP9 encode,
and refresh the posters at the matching intrinsic size.
* Link the high-resolution WebM under each docs GIF and resize site embeds
Add a one-line link to the high-resolution WebM of each clip beneath every
animation GIF in the GitHub-facing guides, and update the site <video>
embeds (EN + ES) to the new 2400x1350 intrinsic size. The GIF dimensions
are unchanged.
* docs: clamp the onset magnifier against the left panel edge
docs: 300 dpi animations, tuned VP9 encoding, parallel rendering and audit fixes (#192)
* Render documentation animations at 300 DPI with a parallel pipeline
Raise the animation resolution from 800x450 to 2400x1350 (300 DPI, same
8x4.5 figure) so the clips stay crisp on high-density displays, and tune
the VP9 WebM encode (-tune-content screen -row-mt 1 -deadline good
-cpu-used 4) to roughly halve the encode time at the same file size. The
GitHub GIF fallback stays at 640 px.
Add a spawned process-pool renderer for the clips (one grouped task per
clip so each FDTD field is simulated once and reused across its four
language/theme variants), mirroring the figure runner and wired to the
existing --jobs flag; --anim single-clip re-renders and --jobs 1 stay
sequential.
Fold in a set of on-canvas readability fixes: Spanish decimal commas in
the FDTD time readouts, time and phase-caption labels repositioned clear
of tick labels and legends, a legible dark pill behind the ducting
channel-axis label, a mathtext L_W subscript in the two-rooms readout,
and the onset magnifier kept fully inside its panel.
* Re-render the documentation animations at 2400x1350
Regenerate every clip (WebM x four language/theme variants, EN GIF and
poster stills) at the new 300 DPI resolution with the tuned VP9 encode,
and refresh the posters at the matching intrinsic size.
* Link the high-resolution WebM under each docs GIF and resize site embeds
Add a one-line link to the high-resolution WebM of each clip beneath every
animation GIF in the GitHub-facing guides, and update the site <video>
embeds (EN + ES) to the new 2400x1350 intrinsic size. The GIF dimensions
are unchanged.
* docs: clamp the onset magnifier against the left panel edge
docs: 300 dpi animations, tuned VP9 encoding, parallel rendering and audit fixes (#192)
* Render documentation animations at 300 DPI with a parallel pipeline
Raise the animation resolution from 800x450 to 2400x1350 (300 DPI, same
8x4.5 figure) so the clips stay crisp on high-density displays, and tune
the VP9 WebM encode (-tune-content screen -row-mt 1 -deadline good
-cpu-used 4) to roughly halve the encode time at the same file size. The
GitHub GIF fallback stays at 640 px.
Add a spawned process-pool renderer for the clips (one grouped task per
clip so each FDTD field is simulated once and reused across its four
language/theme variants), mirroring the figure runner and wired to the
existing --jobs flag; --anim single-clip re-renders and --jobs 1 stay
sequential.
Fold in a set of on-canvas readability fixes: Spanish decimal commas in
the FDTD time readouts, time and phase-caption labels repositioned clear
of tick labels and legends, a legible dark pill behind the ducting
channel-axis label, a mathtext L_W subscript in the two-rooms readout,
and the onset magnifier kept fully inside its panel.
* Re-render the documentation animations at 2400x1350
Regenerate every clip (WebM x four language/theme variants, EN GIF and
poster stills) at the new 300 DPI resolution with the tuned VP9 encode,
and refresh the posters at the matching intrinsic size.
* Link the high-resolution WebM under each docs GIF and resize site embeds
Add a one-line link to the high-resolution WebM of each clip beneath every
animation GIF in the GitHub-facing guides, and update the site <video>
embeds (EN + ES) to the new 2400x1350 intrinsic size. The GIF dimensions
are unchanged.
* docs: clamp the onset magnifier against the left panel edge
docs: 300 dpi animations, tuned VP9 encoding, parallel rendering and audit fixes (#192)
* Render documentation animations at 300 DPI with a parallel pipeline
Raise the animation resolution from 800x450 to 2400x1350 (300 DPI, same
8x4.5 figure) so the clips stay crisp on high-density displays, and tune
the VP9 WebM encode (-tune-content screen -row-mt 1 -deadline good
-cpu-used 4) to roughly halve the encode time at the same file size. The
GitHub GIF fallback stays at 640 px.
Add a spawned process-pool renderer for the clips (one grouped task per
clip so each FDTD field is simulated once and reused across its four
language/theme variants), mirroring the figure runner and wired to the
existing --jobs flag; --anim single-clip re-renders and --jobs 1 stay
sequential.
Fold in a set of on-canvas readability fixes: Spanish decimal commas in
the FDTD time readouts, time and phase-caption labels repositioned clear
of tick labels and legends, a legible dark pill behind the ducting
channel-axis label, a mathtext L_W subscript in the two-rooms readout,
and the onset magnifier kept fully inside its panel.
* Re-render the documentation animations at 2400x1350
Regenerate every clip (WebM x four language/theme variants, EN GIF and
poster stills) at the new 300 DPI resolution with the tuned VP9 encode,
and refresh the posters at the matching intrinsic size.
* Link the high-resolution WebM under each docs GIF and resize site embeds
Add a one-line link to the high-resolution WebM of each clip beneath every
animation GIF in the GitHub-facing guides, and update the site <video>
embeds (EN + ES) to the new 2400x1350 intrinsic size. The GIF dimensions
are unchanged.
* docs: clamp the onset magnifier against the left panel edge
docs: 300 dpi animations, tuned VP9 encoding, parallel rendering and audit fixes (#192)
* Render documentation animations at 300 DPI with a parallel pipeline
Raise the animation resolution from 800x450 to 2400x1350 (300 DPI, same
8x4.5 figure) so the clips stay crisp on high-density displays, and tune
the VP9 WebM encode (-tune-content screen -row-mt 1 -deadline good
-cpu-used 4) to roughly halve the encode time at the same file size. The
GitHub GIF fallback stays at 640 px.
Add a spawned process-pool renderer for the clips (one grouped task per
clip so each FDTD field is simulated once and reused across its four
language/theme variants), mirroring the figure runner and wired to the
existing --jobs flag; --anim single-clip re-renders and --jobs 1 stay
sequential.
Fold in a set of on-canvas readability fixes: Spanish decimal commas in
the FDTD time readouts, time and phase-caption labels repositioned clear
of tick labels and legends, a legible dark pill behind the ducting
channel-axis label, a mathtext L_W subscript in the two-rooms readout,
and the onset magnifier kept fully inside its panel.
* Re-render the documentation animations at 2400x1350
Regenerate every clip (WebM x four language/theme variants, EN GIF and
poster stills) at the new 300 DPI resolution with the tuned VP9 encode,
and refresh the posters at the matching intrinsic size.
* Link the high-resolution WebM under each docs GIF and resize site embeds
Add a one-line link to the high-resolution WebM of each clip beneath every
animation GIF in the GitHub-facing guides, and update the site <video>
embeds (EN + ES) to the new 2400x1350 intrinsic size. The GIF dimensions
are unchanged.
* docs: clamp the onset magnifier against the left panel edge
docs: 300 dpi animations, tuned VP9 encoding, parallel rendering and audit fixes (#192)
* Render documentation animations at 300 DPI with a parallel pipeline
Raise the animation resolution from 800x450 to 2400x1350 (300 DPI, same
8x4.5 figure) so the clips stay crisp on high-density displays, and tune
the VP9 WebM encode (-tune-content screen -row-mt 1 -deadline good
-cpu-used 4) to roughly halve the encode time at the same file size. The
GitHub GIF fallback stays at 640 px.
Add a spawned process-pool renderer for the clips (one grouped task per
clip so each FDTD field is simulated once and reused across its four
language/theme variants), mirroring the figure runner and wired to the
existing --jobs flag; --anim single-clip re-renders and --jobs 1 stay
sequential.
Fold in a set of on-canvas readability fixes: Spanish decimal commas in
the FDTD time readouts, time and phase-caption labels repositioned clear
of tick labels and legends, a legible dark pill behind the ducting
channel-axis label, a mathtext L_W subscript in the two-rooms readout,
and the onset magnifier kept fully inside its panel.
* Re-render the documentation animations at 2400x1350
Regenerate every clip (WebM x four language/theme variants, EN GIF and
poster stills) at the new 300 DPI resolution with the tuned VP9 encode,
and refresh the posters at the matching intrinsic size.
* Link the high-resolution WebM under each docs GIF and resize site embeds
Add a one-line link to the high-resolution WebM of each clip beneath every
animation GIF in the GitHub-facing guides, and update the site <video>
embeds (EN + ES) to the new 2400x1350 intrinsic size. The GIF dimensions
are unchanged.
* docs: clamp the onset magnifier against the left panel edge
docs: 300 dpi animations, tuned VP9 encoding, parallel rendering and audit fixes (#192)
* Render documentation animations at 300 DPI with a parallel pipeline
Raise the animation resolution from 800x450 to 2400x1350 (300 DPI, same
8x4.5 figure) so the clips stay crisp on high-density displays, and tune
the VP9 WebM encode (-tune-content screen -row-mt 1 -deadline good
-cpu-used 4) to roughly halve the encode time at the same file size. The
GitHub GIF fallback stays at 640 px.
Add a spawned process-pool renderer for the clips (one grouped task per
clip so each FDTD field is simulated once and reused across its four
language/theme variants), mirroring the figure runner and wired to the
existing --jobs flag; --anim single-clip re-renders and --jobs 1 stay
sequential.
Fold in a set of on-canvas readability fixes: Spanish decimal commas in
the FDTD time readouts, time and phase-caption labels repositioned clear
of tick labels and legends, a legible dark pill behind the ducting
channel-axis label, a mathtext L_W subscript in the two-rooms readout,
and the onset magnifier kept fully inside its panel.
* Re-render the documentation animations at 2400x1350
Regenerate every clip (WebM x four language/theme variants, EN GIF and
poster stills) at the new 300 DPI resolution with the tuned VP9 encode,
and refresh the posters at the matching intrinsic size.
* Link the high-resolution WebM under each docs GIF and resize site embeds
Add a one-line link to the high-resolution WebM of each clip beneath every
animation GIF in the GitHub-facing guides, and update the site <video>
embeds (EN + ES) to the new 2400x1350 intrinsic size. The GIF dimensions
are unchanged.
* docs: clamp the onset magnifier against the left panel edge
docs: 300 dpi animations, tuned VP9 encoding, parallel rendering and audit fixes (#192)
* Render documentation animations at 300 DPI with a parallel pipeline
Raise the animation resolution from 800x450 to 2400x1350 (300 DPI, same
8x4.5 figure) so the clips stay crisp on high-density displays, and tune
the VP9 WebM encode (-tune-content screen -row-mt 1 -deadline good
-cpu-used 4) to roughly halve the encode time at the same file size. The
GitHub GIF fallback stays at 640 px.
Add a spawned process-pool renderer for the clips (one grouped task per
clip so each FDTD field is simulated once and reused across its four
language/theme variants), mirroring the figure runner and wired to the
existing --jobs flag; --anim single-clip re-renders and --jobs 1 stay
sequential.
Fold in a set of on-canvas readability fixes: Spanish decimal commas in
the FDTD time readouts, time and phase-caption labels repositioned clear
of tick labels and legends, a legible dark pill behind the ducting
channel-axis label, a mathtext L_W subscript in the two-rooms readout,
and the onset magnifier kept fully inside its panel.
* Re-render the documentation animations at 2400x1350
Regenerate every clip (WebM x four language/theme variants, EN GIF and
poster stills) at the new 300 DPI resolution with the tuned VP9 encode,
and refresh the posters at the matching intrinsic size.
* Link the high-resolution WebM under each docs GIF and resize site embeds
Add a one-line link to the high-resolution WebM of each clip beneath every
animation GIF in the GitHub-facing guides, and update the site <video>
embeds (EN + ES) to the new 2400x1350 intrinsic size. The GIF dimensions
are unchanged.
* docs: clamp the onset magnifier against the left panel edge
docs: 300 dpi animations, tuned VP9 encoding, parallel rendering and audit fixes (#192)
* Render documentation animations at 300 DPI with a parallel pipeline
Raise the animation resolution from 800x450 to 2400x1350 (300 DPI, same
8x4.5 figure) so the clips stay crisp on high-density displays, and tune
the VP9 WebM encode (-tune-content screen -row-mt 1 -deadline good
-cpu-used 4) to roughly halve the encode time at the same file size. The
GitHub GIF fallback stays at 640 px.
Add a spawned process-pool renderer for the clips (one grouped task per
clip so each FDTD field is simulated once and reused across its four
language/theme variants), mirroring the figure runner and wired to the
existing --jobs flag; --anim single-clip re-renders and --jobs 1 stay
sequential.
Fold in a set of on-canvas readability fixes: Spanish decimal commas in
the FDTD time readouts, time and phase-caption labels repositioned clear
of tick labels and legends, a legible dark pill behind the ducting
channel-axis label, a mathtext L_W subscript in the two-rooms readout,
and the onset magnifier kept fully inside its panel.
* Re-render the documentation animations at 2400x1350
Regenerate every clip (WebM x four language/theme variants, EN GIF and
poster stills) at the new 300 DPI resolution with the tuned VP9 encode,
and refresh the posters at the matching intrinsic size.
* Link the high-resolution WebM under each docs GIF and resize site embeds
Add a one-line link to the high-resolution WebM of each clip beneath every
animation GIF in the GitHub-facing guides, and update the site <video>
embeds (EN + ES) to the new 2400x1350 intrinsic size. The GIF dimensions
are unchanged.
* docs: clamp the onset magnifier against the left panel edge
docs: 300 dpi animations, tuned VP9 encoding, parallel rendering and audit fixes (#192)
* Render documentation animations at 300 DPI with a parallel pipeline
Raise the animation resolution from 800x450 to 2400x1350 (300 DPI, same
8x4.5 figure) so the clips stay crisp on high-density displays, and tune
the VP9 WebM encode (-tune-content screen -row-mt 1 -deadline good
-cpu-used 4) to roughly halve the encode time at the same file size. The
GitHub GIF fallback stays at 640 px.
Add a spawned process-pool renderer for the clips (one grouped task per
clip so each FDTD field is simulated once and reused across its four
language/theme variants), mirroring the figure runner and wired to the
existing --jobs flag; --anim single-clip re-renders and --jobs 1 stay
sequential.
Fold in a set of on-canvas readability fixes: Spanish decimal commas in
the FDTD time readouts, time and phase-caption labels repositioned clear
of tick labels and legends, a legible dark pill behind the ducting
channel-axis label, a mathtext L_W subscript in the two-rooms readout,
and the onset magnifier kept fully inside its panel.
* Re-render the documentation animations at 2400x1350
Regenerate every clip (WebM x four language/theme variants, EN GIF and
poster stills) at the new 300 DPI resolution with the tuned VP9 encode,
and refresh the posters at the matching intrinsic size.
* Link the high-resolution WebM under each docs GIF and resize site embeds
Add a one-line link to the high-resolution WebM of each clip beneath every
animation GIF in the GitHub-facing guides, and update the site <video>
embeds (EN + ES) to the new 2400x1350 intrinsic size. The GIF dimensions
are unchanged.
* docs: clamp the onset magnifier against the left panel edge
docs: 300 dpi animations, tuned VP9 encoding, parallel rendering and audit fixes (#192)
* Render documentation animations at 300 DPI with a parallel pipeline
Raise the animation resolution from 800x450 to 2400x1350 (300 DPI, same
8x4.5 figure) so the clips stay crisp on high-density displays, and tune
the VP9 WebM encode (-tune-content screen -row-mt 1 -deadline good
-cpu-used 4) to roughly halve the encode time at the same file size. The
GitHub GIF fallback stays at 640 px.
Add a spawned process-pool renderer for the clips (one grouped task per
clip so each FDTD field is simulated once and reused across its four
language/theme variants), mirroring the figure runner and wired to the
existing --jobs flag; --anim single-clip re-renders and --jobs 1 stay
sequential.
Fold in a set of on-canvas readability fixes: Spanish decimal commas in
the FDTD time readouts, time and phase-caption labels repositioned clear
of tick labels and legends, a legible dark pill behind the ducting
channel-axis label, a mathtext L_W subscript in the two-rooms readout,
and the onset magnifier kept fully inside its panel.
* Re-render the documentation animations at 2400x1350
Regenerate every clip (WebM x four language/theme variants, EN GIF and
poster stills) at the new 300 DPI resolution with the tuned VP9 encode,
and refresh the posters at the matching intrinsic size.
* Link the high-resolution WebM under each docs GIF and resize site embeds
Add a one-line link to the high-resolution WebM of each clip beneath every
animation GIF in the GitHub-facing guides, and update the site <video>
embeds (EN + ES) to the new 2400x1350 intrinsic size. The GIF dimensions
are unchanged.
* docs: clamp the onset magnifier against the left panel edge
docs: 300 dpi animations, tuned VP9 encoding, parallel rendering and audit fixes (#192)
* Render documentation animations at 300 DPI with a parallel pipeline
Raise the animation resolution from 800x450 to 2400x1350 (300 DPI, same
8x4.5 figure) so the clips stay crisp on high-density displays, and tune
the VP9 WebM encode (-tune-content screen -row-mt 1 -deadline good
-cpu-used 4) to roughly halve the encode time at the same file size. The
GitHub GIF fallback stays at 640 px.
Add a spawned process-pool renderer for the clips (one grouped task per
clip so each FDTD field is simulated once and reused across its four
language/theme variants), mirroring the figure runner and wired to the
existing --jobs flag; --anim single-clip re-renders and --jobs 1 stay
sequential.
Fold in a set of on-canvas readability fixes: Spanish decimal commas in
the FDTD time readouts, time and phase-caption labels repositioned clear
of tick labels and legends, a legible dark pill behind the ducting
channel-axis label, a mathtext L_W subscript in the two-rooms readout,
and the onset magnifier kept fully inside its panel.
* Re-render the documentation animations at 2400x1350
Regenerate every clip (WebM x four language/theme variants, EN GIF and
poster stills) at the new 300 DPI resolution with the tuned VP9 encode,
and refresh the posters at the matching intrinsic size.
* Link the high-resolution WebM under each docs GIF and resize site embeds
Add a one-line link to the high-resolution WebM of each clip beneath every
animation GIF in the GitHub-facing guides, and update the site <video>
embeds (EN + ES) to the new 2400x1350 intrinsic size. The GIF dimensions
are unchanged.
* docs: clamp the onset magnifier against the left panel edge
docs: 300 dpi animations, tuned VP9 encoding, parallel rendering and audit fixes (#192)
* Render documentation animations at 300 DPI with a parallel pipeline
Raise the animation resolution from 800x450 to 2400x1350 (300 DPI, same
8x4.5 figure) so the clips stay crisp on high-density displays, and tune
the VP9 WebM encode (-tune-content screen -row-mt 1 -deadline good
-cpu-used 4) to roughly halve the encode time at the same file size. The
GitHub GIF fallback stays at 640 px.
Add a spawned process-pool renderer for the clips (one grouped task per
clip so each FDTD field is simulated once and reused across its four
language/theme variants), mirroring the figure runner and wired to the
existing --jobs flag; --anim single-clip re-renders and --jobs 1 stay
sequential.
Fold in a set of on-canvas readability fixes: Spanish decimal commas in
the FDTD time readouts, time and phase-caption labels repositioned clear
of tick labels and legends, a legible dark pill behind the ducting
channel-axis label, a mathtext L_W subscript in the two-rooms readout,
and the onset magnifier kept fully inside its panel.
* Re-render the documentation animations at 2400x1350
Regenerate every clip (WebM x four language/theme variants, EN GIF and
poster stills) at the new 300 DPI resolution with the tuned VP9 encode,
and refresh the posters at the matching intrinsic size.
* Link the high-resolution WebM under each docs GIF and resize site embeds
Add a one-line link to the high-resolution WebM of each clip beneath every
animation GIF in the GitHub-facing guides, and update the site <video>
embeds (EN + ES) to the new 2400x1350 intrinsic size. The GIF dimensions
are unchanged.
* docs: clamp the onset magnifier against the left panel edge
docs: 300 dpi animations, tuned VP9 encoding, parallel rendering and audit fixes (#192)
* Render documentation animations at 300 DPI with a parallel pipeline
Raise the animation resolution from 800x450 to 2400x1350 (300 DPI, same
8x4.5 figure) so the clips stay crisp on high-density displays, and tune
the VP9 WebM encode (-tune-content screen -row-mt 1 -deadline good
-cpu-used 4) to roughly halve the encode time at the same file size. The
GitHub GIF fallback stays at 640 px.
Add a spawned process-pool renderer for the clips (one grouped task per
clip so each FDTD field is simulated once and reused across its four
language/theme variants), mirroring the figure runner and wired to the
existing --jobs flag; --anim single-clip re-renders and --jobs 1 stay
sequential.
Fold in a set of on-canvas readability fixes: Spanish decimal commas in
the FDTD time readouts, time and phase-caption labels repositioned clear
of tick labels and legends, a legible dark pill behind the ducting
channel-axis label, a mathtext L_W subscript in the two-rooms readout,
and the onset magnifier kept fully inside its panel.
* Re-render the documentation animations at 2400x1350
Regenerate every clip (WebM x four language/theme variants, EN GIF and
poster stills) at the new 300 DPI resolution with the tuned VP9 encode,
and refresh the posters at the matching intrinsic size.
* Link the high-resolution WebM under each docs GIF and resize site embeds
Add a one-line link to the high-resolution WebM of each clip beneath every
animation GIF in the GitHub-facing guides, and update the site <video>
embeds (EN + ES) to the new 2400x1350 intrinsic size. The GIF dimensions
are unchanged.
* docs: clamp the onset magnifier against the left panel edge
docs: 300 dpi animations, tuned VP9 encoding, parallel rendering and audit fixes (#192)
* Render documentation animations at 300 DPI with a parallel pipeline
Raise the animation resolution from 800x450 to 2400x1350 (300 DPI, same
8x4.5 figure) so the clips stay crisp on high-density displays, and tune
the VP9 WebM encode (-tune-content screen -row-mt 1 -deadline good
-cpu-used 4) to roughly halve the encode time at the same file size. The
GitHub GIF fallback stays at 640 px.
Add a spawned process-pool renderer for the clips (one grouped task per
clip so each FDTD field is simulated once and reused across its four
language/theme variants), mirroring the figure runner and wired to the
existing --jobs flag; --anim single-clip re-renders and --jobs 1 stay
sequential.
Fold in a set of on-canvas readability fixes: Spanish decimal commas in
the FDTD time readouts, time and phase-caption labels repositioned clear
of tick labels and legends, a legible dark pill behind the ducting
channel-axis label, a mathtext L_W subscript in the two-rooms readout,
and the onset magnifier kept fully inside its panel.
* Re-render the documentation animations at 2400x1350
Regenerate every clip (WebM x four language/theme variants, EN GIF and
poster stills) at the new 300 DPI resolution with the tuned VP9 encode,
and refresh the posters at the matching intrinsic size.
* Link the high-resolution WebM under each docs GIF and resize site embeds
Add a one-line link to the high-resolution WebM of each clip beneath every
animation GIF in the GitHub-facing guides, and update the site <video>
embeds (EN + ES) to the new 2400x1350 intrinsic size. The GIF dimensions
are unchanged.
* docs: clamp the onset magnifier against the left panel edge
docs: 300 dpi animations, tuned VP9 encoding, parallel rendering and audit fixes (#192)
* Render documentation animations at 300 DPI with a parallel pipeline
Raise the animation resolution from 800x450 to 2400x1350 (300 DPI, same
8x4.5 figure) so the clips stay crisp on high-density displays, and tune
the VP9 WebM encode (-tune-content screen -row-mt 1 -deadline good
-cpu-used 4) to roughly halve the encode time at the same file size. The
GitHub GIF fallback stays at 640 px.
Add a spawned process-pool renderer for the clips (one grouped task per
clip so each FDTD field is simulated once and reused across its four
language/theme variants), mirroring the figure runner and wired to the
existing --jobs flag; --anim single-clip re-renders and --jobs 1 stay
sequential.
Fold in a set of on-canvas readability fixes: Spanish decimal commas in
the FDTD time readouts, time and phase-caption labels repositioned clear
of tick labels and legends, a legible dark pill behind the ducting
channel-axis label, a mathtext L_W subscript in the two-rooms readout,
and the onset magnifier kept fully inside its panel.
* Re-render the documentation animations at 2400x1350
Regenerate every clip (WebM x four language/theme variants, EN GIF and
poster stills) at the new 300 DPI resolution with the tuned VP9 encode,
and refresh the posters at the matching intrinsic size.
* Link the high-resolution WebM under each docs GIF and resize site embeds
Add a one-line link to the high-resolution WebM of each clip beneath every
animation GIF in the GitHub-facing guides, and update the site <video>
embeds (EN + ES) to the new 2400x1350 intrinsic size. The GIF dimensions
are unchanged.
* docs: clamp the onset magnifier against the left panel edge
docs: 300 dpi animations, tuned VP9 encoding, parallel rendering and audit fixes (#192)
* Render documentation animations at 300 DPI with a parallel pipeline
Raise the animation resolution from 800x450 to 2400x1350 (300 DPI, same
8x4.5 figure) so the clips stay crisp on high-density displays, and tune
the VP9 WebM encode (-tune-content screen -row-mt 1 -deadline good
-cpu-used 4) to roughly halve the encode time at the same file size. The
GitHub GIF fallback stays at 640 px.
Add a spawned process-pool renderer for the clips (one grouped task per
clip so each FDTD field is simulated once and reused across its four
language/theme variants), mirroring the figure runner and wired to the
existing --jobs flag; --anim single-clip re-renders and --jobs 1 stay
sequential.
Fold in a set of on-canvas readability fixes: Spanish decimal commas in
the FDTD time readouts, time and phase-caption labels repositioned clear
of tick labels and legends, a legible dark pill behind the ducting
channel-axis label, a mathtext L_W subscript in the two-rooms readout,
and the onset magnifier kept fully inside its panel.
* Re-render the documentation animations at 2400x1350
Regenerate every clip (WebM x four language/theme variants, EN GIF and
poster stills) at the new 300 DPI resolution with the tuned VP9 encode,
and refresh the posters at the matching intrinsic size.
* Link the high-resolution WebM under each docs GIF and resize site embeds
Add a one-line link to the high-resolution WebM of each clip beneath every
animation GIF in the GitHub-facing guides, and update the site <video>
embeds (EN + ES) to the new 2400x1350 intrinsic size. The GIF dimensions
are unchanged.
* docs: clamp the onset magnifier against the left panel edge
docs: 300 dpi animations, tuned VP9 encoding, parallel rendering and audit fixes (#192)
* Render documentation animations at 300 DPI with a parallel pipeline
Raise the animation resolution from 800x450 to 2400x1350 (300 DPI, same
8x4.5 figure) so the clips stay crisp on high-density displays, and tune
the VP9 WebM encode (-tune-content screen -row-mt 1 -deadline good
-cpu-used 4) to roughly halve the encode time at the same file size. The
GitHub GIF fallback stays at 640 px.
Add a spawned process-pool renderer for the clips (one grouped task per
clip so each FDTD field is simulated once and reused across its four
language/theme variants), mirroring the figure runner and wired to the
existing --jobs flag; --anim single-clip re-renders and --jobs 1 stay
sequential.
Fold in a set of on-canvas readability fixes: Spanish decimal commas in
the FDTD time readouts, time and phase-caption labels repositioned clear
of tick labels and legends, a legible dark pill behind the ducting
channel-axis label, a mathtext L_W subscript in the two-rooms readout,
and the onset magnifier kept fully inside its panel.
* Re-render the documentation animations at 2400x1350
Regenerate every clip (WebM x four language/theme variants, EN GIF and
poster stills) at the new 300 DPI resolution with the tuned VP9 encode,
and refresh the posters at the matching intrinsic size.
* Link the high-resolution WebM under each docs GIF and resize site embeds
Add a one-line link to the high-resolution WebM of each clip beneath every
animation GIF in the GitHub-facing guides, and update the site <video>
embeds (EN + ES) to the new 2400x1350 intrinsic size. The GIF dimensions
are unchanged.
* docs: clamp the onset magnifier against the left panel edge
docs: 300 dpi animations, tuned VP9 encoding, parallel rendering and audit fixes (#192)
* Render documentation animations at 300 DPI with a parallel pipeline
Raise the animation resolution from 800x450 to 2400x1350 (300 DPI, same
8x4.5 figure) so the clips stay crisp on high-density displays, and tune
the VP9 WebM encode (-tune-content screen -row-mt 1 -deadline good
-cpu-used 4) to roughly halve the encode time at the same file size. The
GitHub GIF fallback stays at 640 px.
Add a spawned process-pool renderer for the clips (one grouped task per
clip so each FDTD field is simulated once and reused across its four
language/theme variants), mirroring the figure runner and wired to the
existing --jobs flag; --anim single-clip re-renders and --jobs 1 stay
sequential.
Fold in a set of on-canvas readability fixes: Spanish decimal commas in
the FDTD time readouts, time and phase-caption labels repositioned clear
of tick labels and legends, a legible dark pill behind the ducting
channel-axis label, a mathtext L_W subscript in the two-rooms readout,
and the onset magnifier kept fully inside its panel.
* Re-render the documentation animations at 2400x1350
Regenerate every clip (WebM x four language/theme variants, EN GIF and
poster stills) at the new 300 DPI resolution with the tuned VP9 encode,
and refresh the posters at the matching intrinsic size.
* Link the high-resolution WebM under each docs GIF and resize site embeds
Add a one-line link to the high-resolution WebM of each clip beneath every
animation GIF in the GitHub-facing guides, and update the site <video>
embeds (EN + ES) to the new 2400x1350 intrinsic size. The GIF dimensions
are unchanged.
* docs: clamp the onset magnifier against the left panel edge
docs: 300 dpi animations, tuned VP9 encoding, parallel rendering and audit fixes (#192)
* Render documentation animations at 300 DPI with a parallel pipeline
Raise the animation resolution from 800x450 to 2400x1350 (300 DPI, same
8x4.5 figure) so the clips stay crisp on high-density displays, and tune
the VP9 WebM encode (-tune-content screen -row-mt 1 -deadline good
-cpu-used 4) to roughly halve the encode time at the same file size. The
GitHub GIF fallback stays at 640 px.
Add a spawned process-pool renderer for the clips (one grouped task per
clip so each FDTD field is simulated once and reused across its four
language/theme variants), mirroring the figure runner and wired to the
existing --jobs flag; --anim single-clip re-renders and --jobs 1 stay
sequential.
Fold in a set of on-canvas readability fixes: Spanish decimal commas in
the FDTD time readouts, time and phase-caption labels repositioned clear
of tick labels and legends, a legible dark pill behind the ducting
channel-axis label, a mathtext L_W subscript in the two-rooms readout,
and the onset magnifier kept fully inside its panel.
* Re-render the documentation animations at 2400x1350
Regenerate every clip (WebM x four language/theme variants, EN GIF and
poster stills) at the new 300 DPI resolution with the tuned VP9 encode,
and refresh the posters at the matching intrinsic size.
* Link the high-resolution WebM under each docs GIF and resize site embeds
Add a one-line link to the high-resolution WebM of each clip beneath every
animation GIF in the GitHub-facing guides, and update the site <video>
embeds (EN + ES) to the new 2400x1350 intrinsic size. The GIF dimensions
are unchanged.
* docs: clamp the onset magnifier against the left panel edge
docs: 300 dpi animations, tuned VP9 encoding, parallel rendering and audit fixes (#192)
* Render documentation animations at 300 DPI with a parallel pipeline
Raise the animation resolution from 800x450 to 2400x1350 (300 DPI, same
8x4.5 figure) so the clips stay crisp on high-density displays, and tune
the VP9 WebM encode (-tune-content screen -row-mt 1 -deadline good
-cpu-used 4) to roughly halve the encode time at the same file size. The
GitHub GIF fallback stays at 640 px.
Add a spawned process-pool renderer for the clips (one grouped task per
clip so each FDTD field is simulated once and reused across its four
language/theme variants), mirroring the figure runner and wired to the
existing --jobs flag; --anim single-clip re-renders and --jobs 1 stay
sequential.
Fold in a set of on-canvas readability fixes: Spanish decimal commas in
the FDTD time readouts, time and phase-caption labels repositioned clear
of tick labels and legends, a legible dark pill behind the ducting
channel-axis label, a mathtext L_W subscript in the two-rooms readout,
and the onset magnifier kept fully inside its panel.
* Re-render the documentation animations at 2400x1350
Regenerate every clip (WebM x four language/theme variants, EN GIF and
poster stills) at the new 300 DPI resolution with the tuned VP9 encode,
and refresh the posters at the matching intrinsic size.
* Link the high-resolution WebM under each docs GIF and resize site embeds
Add a one-line link to the high-resolution WebM of each clip beneath every
animation GIF in the GitHub-facing guides, and update the site <video>
embeds (EN + ES) to the new 2400x1350 intrinsic size. The GIF dimensions
are unchanged.
* docs: clamp the onset magnifier against the left panel edge
docs: 300 dpi animations, tuned VP9 encoding, parallel rendering and audit fixes (#192)
* Render documentation animations at 300 DPI with a parallel pipeline
Raise the animation resolution from 800x450 to 2400x1350 (300 DPI, same
8x4.5 figure) so the clips stay crisp on high-density displays, and tune
the VP9 WebM encode (-tune-content screen -row-mt 1 -deadline good
-cpu-used 4) to roughly halve the encode time at the same file size. The
GitHub GIF fallback stays at 640 px.
Add a spawned process-pool renderer for the clips (one grouped task per
clip so each FDTD field is simulated once and reused across its four
language/theme variants), mirroring the figure runner and wired to the
existing --jobs flag; --anim single-clip re-renders and --jobs 1 stay
sequential.
Fold in a set of on-canvas readability fixes: Spanish decimal commas in
the FDTD time readouts, time and phase-caption labels repositioned clear
of tick labels and legends, a legible dark pill behind the ducting
channel-axis label, a mathtext L_W subscript in the two-rooms readout,
and the onset magnifier kept fully inside its panel.
* Re-render the documentation animations at 2400x1350
Regenerate every clip (WebM x four language/theme variants, EN GIF and
poster stills) at the new 300 DPI resolution with the tuned VP9 encode,
and refresh the posters at the matching intrinsic size.
* Link the high-resolution WebM under each docs GIF and resize site embeds
Add a one-line link to the high-resolution WebM of each clip beneath every
animation GIF in the GitHub-facing guides, and update the site <video>
embeds (EN + ES) to the new 2400x1350 intrinsic size. The GIF dimensions
are unchanged.
* docs: clamp the onset magnifier against the left panel edge
docs: 300 dpi animations, tuned VP9 encoding, parallel rendering and audit fixes (#192)
* Render documentation animations at 300 DPI with a parallel pipeline
Raise the animation resolution from 800x450 to 2400x1350 (300 DPI, same
8x4.5 figure) so the clips stay crisp on high-density displays, and tune
the VP9 WebM encode (-tune-content screen -row-mt 1 -deadline good
-cpu-used 4) to roughly halve the encode time at the same file size. The
GitHub GIF fallback stays at 640 px.
Add a spawned process-pool renderer for the clips (one grouped task per
clip so each FDTD field is simulated once and reused across its four
language/theme variants), mirroring the figure runner and wired to the
existing --jobs flag; --anim single-clip re-renders and --jobs 1 stay
sequential.
Fold in a set of on-canvas readability fixes: Spanish decimal commas in
the FDTD time readouts, time and phase-caption labels repositioned clear
of tick labels and legends, a legible dark pill behind the ducting
channel-axis label, a mathtext L_W subscript in the two-rooms readout,
and the onset magnifier kept fully inside its panel.
* Re-render the documentation animations at 2400x1350
Regenerate every clip (WebM x four language/theme variants, EN GIF and
poster stills) at the new 300 DPI resolution with the tuned VP9 encode,
and refresh the posters at the matching intrinsic size.
* Link the high-resolution WebM under each docs GIF and resize site embeds
Add a one-line link to the high-resolution WebM of each clip beneath every
animation GIF in the GitHub-facing guides, and update the site <video>
embeds (EN + ES) to the new 2400x1350 intrinsic size. The GIF dimensions
are unchanged.
* docs: clamp the onset magnifier against the left panel edge
docs: 300 dpi animations, tuned VP9 encoding, parallel rendering and audit fixes (#192)
* Render documentation animations at 300 DPI with a parallel pipeline
Raise the animation resolution from 800x450 to 2400x1350 (300 DPI, same
8x4.5 figure) so the clips stay crisp on high-density displays, and tune
the VP9 WebM encode (-tune-content screen -row-mt 1 -deadline good
-cpu-used 4) to roughly halve the encode time at the same file size. The
GitHub GIF fallback stays at 640 px.
Add a spawned process-pool renderer for the clips (one grouped task per
clip so each FDTD field is simulated once and reused across its four
language/theme variants), mirroring the figure runner and wired to the
existing --jobs flag; --anim single-clip re-renders and --jobs 1 stay
sequential.
Fold in a set of on-canvas readability fixes: Spanish decimal commas in
the FDTD time readouts, time and phase-caption labels repositioned clear
of tick labels and legends, a legible dark pill behind the ducting
channel-axis label, a mathtext L_W subscript in the two-rooms readout,
and the onset magnifier kept fully inside its panel.
* Re-render the documentation animations at 2400x1350
Regenerate every clip (WebM x four language/theme variants, EN GIF and
poster stills) at the new 300 DPI resolution with the tuned VP9 encode,
and refresh the posters at the matching intrinsic size.
* Link the high-resolution WebM under each docs GIF and resize site embeds
Add a one-line link to the high-resolution WebM of each clip beneath every
animation GIF in the GitHub-facing guides, and update the site <video>
embeds (EN + ES) to the new 2400x1350 intrinsic size. The GIF dimensions
are unchanged.
* docs: clamp the onset magnifier against the left panel edge
docs: 300 dpi animations, tuned VP9 encoding, parallel rendering and audit fixes (#192)
* Render documentation animations at 300 DPI with a parallel pipeline
Raise the animation resolution from 800x450 to 2400x1350 (300 DPI, same
8x4.5 figure) so the clips stay crisp on high-density displays, and tune
the VP9 WebM encode (-tune-content screen -row-mt 1 -deadline good
-cpu-used 4) to roughly halve the encode time at the same file size. The
GitHub GIF fallback stays at 640 px.
Add a spawned process-pool renderer for the clips (one grouped task per
clip so each FDTD field is simulated once and reused across its four
language/theme variants), mirroring the figure runner and wired to the
existing --jobs flag; --anim single-clip re-renders and --jobs 1 stay
sequential.
Fold in a set of on-canvas readability fixes: Spanish decimal commas in
the FDTD time readouts, time and phase-caption labels repositioned clear
of tick labels and legends, a legible dark pill behind the ducting
channel-axis label, a mathtext L_W subscript in the two-rooms readout,
and the onset magnifier kept fully inside its panel.
* Re-render the documentation animations at 2400x1350
Regenerate every clip (WebM x four language/theme variants, EN GIF and
poster stills) at the new 300 DPI resolution with the tuned VP9 encode,
and refresh the posters at the matching intrinsic size.
* Link the high-resolution WebM under each docs GIF and resize site embeds
Add a one-line link to the high-resolution WebM of each clip beneath every
animation GIF in the GitHub-facing guides, and update the site <video>
embeds (EN + ES) to the new 2400x1350 intrinsic size. The GIF dimensions
are unchanged.
* docs: clamp the onset magnifier against the left panel edge
docs: 300 dpi animations, tuned VP9 encoding, parallel rendering and audit fixes (#192)
* Render documentation animations at 300 DPI with a parallel pipeline
Raise the animation resolution from 800x450 to 2400x1350 (300 DPI, same
8x4.5 figure) so the clips stay crisp on high-density displays, and tune
the VP9 WebM encode (-tune-content screen -row-mt 1 -deadline good
-cpu-used 4) to roughly halve the encode time at the same file size. The
GitHub GIF fallback stays at 640 px.
Add a spawned process-pool renderer for the clips (one grouped task per
clip so each FDTD field is simulated once and reused across its four
language/theme variants), mirroring the figure runner and wired to the
existing --jobs flag; --anim single-clip re-renders and --jobs 1 stay
sequential.
Fold in a set of on-canvas readability fixes: Spanish decimal commas in
the FDTD time readouts, time and phase-caption labels repositioned clear
of tick labels and legends, a legible dark pill behind the ducting
channel-axis label, a mathtext L_W subscript in the two-rooms readout,
and the onset magnifier kept fully inside its panel.
* Re-render the documentation animations at 2400x1350
Regenerate every clip (WebM x four language/theme variants, EN GIF and
poster stills) at the new 300 DPI resolution with the tuned VP9 encode,
and refresh the posters at the matching intrinsic size.
* Link the high-resolution WebM under each docs GIF and resize site embeds
Add a one-line link to the high-resolution WebM of each clip beneath every
animation GIF in the GitHub-facing guides, and update the site <video>
embeds (EN + ES) to the new 2400x1350 intrinsic size. The GIF dimensions
are unchanged.
* docs: clamp the onset magnifier against the left panel edge
docs: 300 dpi animations, tuned VP9 encoding, parallel rendering and audit fixes (#192)
* Render documentation animations at 300 DPI with a parallel pipeline
Raise the animation resolution from 800x450 to 2400x1350 (300 DPI, same
8x4.5 figure) so the clips stay crisp on high-density displays, and tune
the VP9 WebM encode (-tune-content screen -row-mt 1 -deadline good
-cpu-used 4) to roughly halve the encode time at the same file size. The
GitHub GIF fallback stays at 640 px.
Add a spawned process-pool renderer for the clips (one grouped task per
clip so each FDTD field is simulated once and reused across its four
language/theme variants), mirroring the figure runner and wired to the
existing --jobs flag; --anim single-clip re-renders and --jobs 1 stay
sequential.
Fold in a set of on-canvas readability fixes: Spanish decimal commas in
the FDTD time readouts, time and phase-caption labels repositioned clear
of tick labels and legends, a legible dark pill behind the ducting
channel-axis label, a mathtext L_W subscript in the two-rooms readout,
and the onset magnifier kept fully inside its panel.
* Re-render the documentation animations at 2400x1350
Regenerate every clip (WebM x four language/theme variants, EN GIF and
poster stills) at the new 300 DPI resolution with the tuned VP9 encode,
and refresh the posters at the matching intrinsic size.
* Link the high-resolution WebM under each docs GIF and resize site embeds
Add a one-line link to the high-resolution WebM of each clip beneath every
animation GIF in the GitHub-facing guides, and update the site <video>
embeds (EN + ES) to the new 2400x1350 intrinsic size. The GIF dimensions
are unchanged.
* docs: clamp the onset magnifier against the left panel edge
docs: 300 dpi animations, tuned VP9 encoding, parallel rendering and audit fixes (#192)
* Render documentation animations at 300 DPI with a parallel pipeline
Raise the animation resolution from 800x450 to 2400x1350 (300 DPI, same
8x4.5 figure) so the clips stay crisp on high-density displays, and tune
the VP9 WebM encode (-tune-content screen -row-mt 1 -deadline good
-cpu-used 4) to roughly halve the encode time at the same file size. The
GitHub GIF fallback stays at 640 px.
Add a spawned process-pool renderer for the clips (one grouped task per
clip so each FDTD field is simulated once and reused across its four
language/theme variants), mirroring the figure runner and wired to the
existing --jobs flag; --anim single-clip re-renders and --jobs 1 stay
sequential.
Fold in a set of on-canvas readability fixes: Spanish decimal commas in
the FDTD time readouts, time and phase-caption labels repositioned clear
of tick labels and legends, a legible dark pill behind the ducting
channel-axis label, a mathtext L_W subscript in the two-rooms readout,
and the onset magnifier kept fully inside its panel.
* Re-render the documentation animations at 2400x1350
Regenerate every clip (WebM x four language/theme variants, EN GIF and
poster stills) at the new 300 DPI resolution with the tuned VP9 encode,
and refresh the posters at the matching intrinsic size.
* Link the high-resolution WebM under each docs GIF and resize site embeds
Add a one-line link to the high-resolution WebM of each clip beneath every
animation GIF in the GitHub-facing guides, and update the site <video>
embeds (EN + ES) to the new 2400x1350 intrinsic size. The GIF dimensions
are unchanged.
* docs: clamp the onset magnifier against the left panel edge
docs: 300 dpi animations, tuned VP9 encoding, parallel rendering and audit fixes (#192)
* Render documentation animations at 300 DPI with a parallel pipeline
Raise the animation resolution from 800x450 to 2400x1350 (300 DPI, same
8x4.5 figure) so the clips stay crisp on high-density displays, and tune
the VP9 WebM encode (-tune-content screen -row-mt 1 -deadline good
-cpu-used 4) to roughly halve the encode time at the same file size. The
GitHub GIF fallback stays at 640 px.
Add a spawned process-pool renderer for the clips (one grouped task per
clip so each FDTD field is simulated once and reused across its four
language/theme variants), mirroring the figure runner and wired to the
existing --jobs flag; --anim single-clip re-renders and --jobs 1 stay
sequential.
Fold in a set of on-canvas readability fixes: Spanish decimal commas in
the FDTD time readouts, time and phase-caption labels repositioned clear
of tick labels and legends, a legible dark pill behind the ducting
channel-axis label, a mathtext L_W subscript in the two-rooms readout,
and the onset magnifier kept fully inside its panel.
* Re-render the documentation animations at 2400x1350
Regenerate every clip (WebM x four language/theme variants, EN GIF and
poster stills) at the new 300 DPI resolution with the tuned VP9 encode,
and refresh the posters at the matching intrinsic size.
* Link the high-resolution WebM under each docs GIF and resize site embeds
Add a one-line link to the high-resolution WebM of each clip beneath every
animation GIF in the GitHub-facing guides, and update the site <video>
embeds (EN + ES) to the new 2400x1350 intrinsic size. The GIF dimensions
are unchanged.
* docs: clamp the onset magnifier against the left panel edge
docs: 300 dpi animations, tuned VP9 encoding, parallel rendering and audit fixes (#192)
* Render documentation animations at 300 DPI with a parallel pipeline
Raise the animation resolution from 800x450 to 2400x1350 (300 DPI, same
8x4.5 figure) so the clips stay crisp on high-density displays, and tune
the VP9 WebM encode (-tune-content screen -row-mt 1 -deadline good
-cpu-used 4) to roughly halve the encode time at the same file size. The
GitHub GIF fallback stays at 640 px.
Add a spawned process-pool renderer for the clips (one grouped task per
clip so each FDTD field is simulated once and reused across its four
language/theme variants), mirroring the figure runner and wired to the
existing --jobs flag; --anim single-clip re-renders and --jobs 1 stay
sequential.
Fold in a set of on-canvas readability fixes: Spanish decimal commas in
the FDTD time readouts, time and phase-caption labels repositioned clear
of tick labels and legends, a legible dark pill behind the ducting
channel-axis label, a mathtext L_W subscript in the two-rooms readout,
and the onset magnifier kept fully inside its panel.
* Re-render the documentation animations at 2400x1350
Regenerate every clip (WebM x four language/theme variants, EN GIF and
poster stills) at the new 300 DPI resolution with the tuned VP9 encode,
and refresh the posters at the matching intrinsic size.
* Link the high-resolution WebM under each docs GIF and resize site embeds
Add a one-line link to the high-resolution WebM of each clip beneath every
animation GIF in the GitHub-facing guides, and update the site <video>
embeds (EN + ES) to the new 2400x1350 intrinsic size. The GIF dimensions
are unchanged.
* docs: clamp the onset magnifier against the left panel edge
docs: 300 dpi animations, tuned VP9 encoding, parallel rendering and audit fixes (#192)
* Render documentation animations at 300 DPI with a parallel pipeline
Raise the animation resolution from 800x450 to 2400x1350 (300 DPI, same
8x4.5 figure) so the clips stay crisp on high-density displays, and tune
the VP9 WebM encode (-tune-content screen -row-mt 1 -deadline good
-cpu-used 4) to roughly halve the encode time at the same file size. The
GitHub GIF fallback stays at 640 px.
Add a spawned process-pool renderer for the clips (one grouped task per
clip so each FDTD field is simulated once and reused across its four
language/theme variants), mirroring the figure runner and wired to the
existing --jobs flag; --anim single-clip re-renders and --jobs 1 stay
sequential.
Fold in a set of on-canvas readability fixes: Spanish decimal commas in
the FDTD time readouts, time and phase-caption labels repositioned clear
of tick labels and legends, a legible dark pill behind the ducting
channel-axis label, a mathtext L_W subscript in the two-rooms readout,
and the onset magnifier kept fully inside its panel.
* Re-render the documentation animations at 2400x1350
Regenerate every clip (WebM x four language/theme variants, EN GIF and
poster stills) at the new 300 DPI resolution with the tuned VP9 encode,
and refresh the posters at the matching intrinsic size.
* Link the high-resolution WebM under each docs GIF and resize site embeds
Add a one-line link to the high-resolution WebM of each clip beneath every
animation GIF in the GitHub-facing guides, and update the site <video>
embeds (EN + ES) to the new 2400x1350 intrinsic size. The GIF dimensions
are unchanged.
* docs: clamp the onset magnifier against the left panel edge
docs: 300 dpi animations, tuned VP9 encoding, parallel rendering and audit fixes (#192)
* Render documentation animations at 300 DPI with a parallel pipeline
Raise the animation resolution from 800x450 to 2400x1350 (300 DPI, same
8x4.5 figure) so the clips stay crisp on high-density displays, and tune
the VP9 WebM encode (-tune-content screen -row-mt 1 -deadline good
-cpu-used 4) to roughly halve the encode time at the same file size. The
GitHub GIF fallback stays at 640 px.
Add a spawned process-pool renderer for the clips (one grouped task per
clip so each FDTD field is simulated once and reused across its four
language/theme variants), mirroring the figure runner and wired to the
existing --jobs flag; --anim single-clip re-renders and --jobs 1 stay
sequential.
Fold in a set of on-canvas readability fixes: Spanish decimal commas in
the FDTD time readouts, time and phase-caption labels repositioned clear
of tick labels and legends, a legible dark pill behind the ducting
channel-axis label, a mathtext L_W subscript in the two-rooms readout,
and the onset magnifier kept fully inside its panel.
* Re-render the documentation animations at 2400x1350
Regenerate every clip (WebM x four language/theme variants, EN GIF and
poster stills) at the new 300 DPI resolution with the tuned VP9 encode,
and refresh the posters at the matching intrinsic size.
* Link the high-resolution WebM under each docs GIF and resize site embeds
Add a one-line link to the high-resolution WebM of each clip beneath every
animation GIF in the GitHub-facing guides, and update the site <video>
embeds (EN + ES) to the new 2400x1350 intrinsic size. The GIF dimensions
are unchanged.
* docs: clamp the onset magnifier against the left panel edge
docs: 300 dpi animations, tuned VP9 encoding, parallel rendering and audit fixes (#192)
* Render documentation animations at 300 DPI with a parallel pipeline
Raise the animation resolution from 800x450 to 2400x1350 (300 DPI, same
8x4.5 figure) so the clips stay crisp on high-density displays, and tune
the VP9 WebM encode (-tune-content screen -row-mt 1 -deadline good
-cpu-used 4) to roughly halve the encode time at the same file size. The
GitHub GIF fallback stays at 640 px.
Add a spawned process-pool renderer for the clips (one grouped task per
clip so each FDTD field is simulated once and reused across its four
language/theme variants), mirroring the figure runner and wired to the
existing --jobs flag; --anim single-clip re-renders and --jobs 1 stay
sequential.
Fold in a set of on-canvas readability fixes: Spanish decimal commas in
the FDTD time readouts, time and phase-caption labels repositioned clear
of tick labels and legends, a legible dark pill behind the ducting
channel-axis label, a mathtext L_W subscript in the two-rooms readout,
and the onset magnifier kept fully inside its panel.
* Re-render the documentation animations at 2400x1350
Regenerate every clip (WebM x four language/theme variants, EN GIF and
poster stills) at the new 300 DPI resolution with the tuned VP9 encode,
and refresh the posters at the matching intrinsic size.
* Link the high-resolution WebM under each docs GIF and resize site embeds
Add a one-line link to the high-resolution WebM of each clip beneath every
animation GIF in the GitHub-facing guides, and update the site <video>
embeds (EN + ES) to the new 2400x1350 intrinsic size. The GIF dimensions
are unchanged.
* docs: clamp the onset magnifier against the left panel edge
docs: 300 dpi animations, tuned VP9 encoding, parallel rendering and audit fixes (#192)
* Render documentation animations at 300 DPI with a parallel pipeline
Raise the animation resolution from 800x450 to 2400x1350 (300 DPI, same
8x4.5 figure) so the clips stay crisp on high-density displays, and tune
the VP9 WebM encode (-tune-content screen -row-mt 1 -deadline good
-cpu-used 4) to roughly halve the encode time at the same file size. The
GitHub GIF fallback stays at 640 px.
Add a spawned process-pool renderer for the clips (one grouped task per
clip so each FDTD field is simulated once and reused across its four
language/theme variants), mirroring the figure runner and wired to the
existing --jobs flag; --anim single-clip re-renders and --jobs 1 stay
sequential.
Fold in a set of on-canvas readability fixes: Spanish decimal commas in
the FDTD time readouts, time and phase-caption labels repositioned clear
of tick labels and legends, a legible dark pill behind the ducting
channel-axis label, a mathtext L_W subscript in the two-rooms readout,
and the onset magnifier kept fully inside its panel.
* Re-render the documentation animations at 2400x1350
Regenerate every clip (WebM x four language/theme variants, EN GIF and
poster stills) at the new 300 DPI resolution with the tuned VP9 encode,
and refresh the posters at the matching intrinsic size.
* Link the high-resolution WebM under each docs GIF and resize site embeds
Add a one-line link to the high-resolution WebM of each clip beneath every
animation GIF in the GitHub-facing guides, and update the site <video>
embeds (EN + ES) to the new 2400x1350 intrinsic size. The GIF dimensions
are unchanged.
* docs: clamp the onset magnifier against the left panel edge
docs: 300 dpi animations, tuned VP9 encoding, parallel rendering and audit fixes (#192)
* Render documentation animations at 300 DPI with a parallel pipeline
Raise the animation resolution from 800x450 to 2400x1350 (300 DPI, same
8x4.5 figure) so the clips stay crisp on high-density displays, and tune
the VP9 WebM encode (-tune-content screen -row-mt 1 -deadline good
-cpu-used 4) to roughly halve the encode time at the same file size. The
GitHub GIF fallback stays at 640 px.
Add a spawned process-pool renderer for the clips (one grouped task per
clip so each FDTD field is simulated once and reused across its four
language/theme variants), mirroring the figure runner and wired to the
existing --jobs flag; --anim single-clip re-renders and --jobs 1 stay
sequential.
Fold in a set of on-canvas readability fixes: Spanish decimal commas in
the FDTD time readouts, time and phase-caption labels repositioned clear
of tick labels and legends, a legible dark pill behind the ducting
channel-axis label, a mathtext L_W subscript in the two-rooms readout,
and the onset magnifier kept fully inside its panel.
* Re-render the documentation animations at 2400x1350
Regenerate every clip (WebM x four language/theme variants, EN GIF and
poster stills) at the new 300 DPI resolution with the tuned VP9 encode,
and refresh the posters at the matching intrinsic size.
* Link the high-resolution WebM under each docs GIF and resize site embeds
Add a one-line link to the high-resolution WebM of each clip beneath every
animation GIF in the GitHub-facing guides, and update the site <video>
embeds (EN + ES) to the new 2400x1350 intrinsic size. The GIF dimensions
are unchanged.
* docs: clamp the onset magnifier against the left panel edge
docs: 300 dpi animations, tuned VP9 encoding, parallel rendering and audit fixes (#192)
* Render documentation animations at 300 DPI with a parallel pipeline
Raise the animation resolution from 800x450 to 2400x1350 (300 DPI, same
8x4.5 figure) so the clips stay crisp on high-density displays, and tune
the VP9 WebM encode (-tune-content screen -row-mt 1 -deadline good
-cpu-used 4) to roughly halve the encode time at the same file size. The
GitHub GIF fallback stays at 640 px.
Add a spawned process-pool renderer for the clips (one grouped task per
clip so each FDTD field is simulated once and reused across its four
language/theme variants), mirroring the figure runner and wired to the
existing --jobs flag; --anim single-clip re-renders and --jobs 1 stay
sequential.
Fold in a set of on-canvas readability fixes: Spanish decimal commas in
the FDTD time readouts, time and phase-caption labels repositioned clear
of tick labels and legends, a legible dark pill behind the ducting
channel-axis label, a mathtext L_W subscript in the two-rooms readout,
and the onset magnifier kept fully inside its panel.
* Re-render the documentation animations at 2400x1350
Regenerate every clip (WebM x four language/theme variants, EN GIF and
poster stills) at the new 300 DPI resolution with the tuned VP9 encode,
and refresh the posters at the matching intrinsic size.
* Link the high-resolution WebM under each docs GIF and resize site embeds
Add a one-line link to the high-resolution WebM of each clip beneath every
animation GIF in the GitHub-facing guides, and update the site <video>
embeds (EN + ES) to the new 2400x1350 intrinsic size. The GIF dimensions
are unchanged.
* docs: clamp the onset magnifier against the left panel edge
docs: 300 dpi animations, tuned VP9 encoding, parallel rendering and audit fixes (#192)
* Render documentation animations at 300 DPI with a parallel pipeline
Raise the animation resolution from 800x450 to 2400x1350 (300 DPI, same
8x4.5 figure) so the clips stay crisp on high-density displays, and tune
the VP9 WebM encode (-tune-content screen -row-mt 1 -deadline good
-cpu-used 4) to roughly halve the encode time at the same file size. The
GitHub GIF fallback stays at 640 px.
Add a spawned process-pool renderer for the clips (one grouped task per
clip so each FDTD field is simulated once and reused across its four
language/theme variants), mirroring the figure runner and wired to the
existing --jobs flag; --anim single-clip re-renders and --jobs 1 stay
sequential.
Fold in a set of on-canvas readability fixes: Spanish decimal commas in
the FDTD time readouts, time and phase-caption labels repositioned clear
of tick labels and legends, a legible dark pill behind the ducting
channel-axis label, a mathtext L_W subscript in the two-rooms readout,
and the onset magnifier kept fully inside its panel.
* Re-render the documentation animations at 2400x1350
Regenerate every clip (WebM x four language/theme variants, EN GIF and
poster stills) at the new 300 DPI resolution with the tuned VP9 encode,
and refresh the posters at the matching intrinsic size.
* Link the high-resolution WebM under each docs GIF and resize site embeds
Add a one-line link to the high-resolution WebM of each clip beneath every
animation GIF in the GitHub-facing guides, and update the site <video>
embeds (EN + ES) to the new 2400x1350 intrinsic size. The GIF dimensions
are unchanged.
* docs: clamp the onset magnifier against the left panel edge
docs: 300 dpi animations, tuned VP9 encoding, parallel rendering and audit fixes (#192)
* Render documentation animations at 300 DPI with a parallel pipeline
Raise the animation resolution from 800x450 to 2400x1350 (300 DPI, same
8x4.5 figure) so the clips stay crisp on high-density displays, and tune
the VP9 WebM encode (-tune-content screen -row-mt 1 -deadline good
-cpu-used 4) to roughly halve the encode time at the same file size. The
GitHub GIF fallback stays at 640 px.
Add a spawned process-pool renderer for the clips (one grouped task per
clip so each FDTD field is simulated once and reused across its four
language/theme variants), mirroring the figure runner and wired to the
existing --jobs flag; --anim single-clip re-renders and --jobs 1 stay
sequential.
Fold in a set of on-canvas readability fixes: Spanish decimal commas in
the FDTD time readouts, time and phase-caption labels repositioned clear
of tick labels and legends, a legible dark pill behind the ducting
channel-axis label, a mathtext L_W subscript in the two-rooms readout,
and the onset magnifier kept fully inside its panel.
* Re-render the documentation animations at 2400x1350
Regenerate every clip (WebM x four language/theme variants, EN GIF and
poster stills) at the new 300 DPI resolution with the tuned VP9 encode,
and refresh the posters at the matching intrinsic size.
* Link the high-resolution WebM under each docs GIF and resize site embeds
Add a one-line link to the high-resolution WebM of each clip beneath every
animation GIF in the GitHub-facing guides, and update the site <video>
embeds (EN + ES) to the new 2400x1350 intrinsic size. The GIF dimensions
are unchanged.
* docs: clamp the onset magnifier against the left panel edge
docs: 300 dpi animations, tuned VP9 encoding, parallel rendering and audit fixes (#192)
* Render documentation animations at 300 DPI with a parallel pipeline
Raise the animation resolution from 800x450 to 2400x1350 (300 DPI, same
8x4.5 figure) so the clips stay crisp on high-density displays, and tune
the VP9 WebM encode (-tune-content screen -row-mt 1 -deadline good
-cpu-used 4) to roughly halve the encode time at the same file size. The
GitHub GIF fallback stays at 640 px.
Add a spawned process-pool renderer for the clips (one grouped task per
clip so each FDTD field is simulated once and reused across its four
language/theme variants), mirroring the figure runner and wired to the
existing --jobs flag; --anim single-clip re-renders and --jobs 1 stay
sequential.
Fold in a set of on-canvas readability fixes: Spanish decimal commas in
the FDTD time readouts, time and phase-caption labels repositioned clear
of tick labels and legends, a legible dark pill behind the ducting
channel-axis label, a mathtext L_W subscript in the two-rooms readout,
and the onset magnifier kept fully inside its panel.
* Re-render the documentation animations at 2400x1350
Regenerate every clip (WebM x four language/theme variants, EN GIF and
poster stills) at the new 300 DPI resolution with the tuned VP9 encode,
and refresh the posters at the matching intrinsic size.
* Link the high-resolution WebM under each docs GIF and resize site embeds
Add a one-line link to the high-resolution WebM of each clip beneath every
animation GIF in the GitHub-facing guides, and update the site <video>
embeds (EN + ES) to the new 2400x1350 intrinsic size. The GIF dimensions
are unchanged.
* docs: clamp the onset magnifier against the left panel edge
docs: 300 dpi animations, tuned VP9 encoding, parallel rendering and audit fixes (#192)
* Render documentation animations at 300 DPI with a parallel pipeline
Raise the animation resolution from 800x450 to 2400x1350 (300 DPI, same
8x4.5 figure) so the clips stay crisp on high-density displays, and tune
the VP9 WebM encode (-tune-content screen -row-mt 1 -deadline good
-cpu-used 4) to roughly halve the encode time at the same file size. The
GitHub GIF fallback stays at 640 px.
Add a spawned process-pool renderer for the clips (one grouped task per
clip so each FDTD field is simulated once and reused across its four
language/theme variants), mirroring the figure runner and wired to the
existing --jobs flag; --anim single-clip re-renders and --jobs 1 stay
sequential.
Fold in a set of on-canvas readability fixes: Spanish decimal commas in
the FDTD time readouts, time and phase-caption labels repositioned clear
of tick labels and legends, a legible dark pill behind the ducting
channel-axis label, a mathtext L_W subscript in the two-rooms readout,
and the onset magnifier kept fully inside its panel.
* Re-render the documentation animations at 2400x1350
Regenerate every clip (WebM x four language/theme variants, EN GIF and
poster stills) at the new 300 DPI resolution with the tuned VP9 encode,
and refresh the posters at the matching intrinsic size.
* Link the high-resolution WebM under each docs GIF and resize site embeds
Add a one-line link to the high-resolution WebM of each clip beneath every
animation GIF in the GitHub-facing guides, and update the site <video>
embeds (EN + ES) to the new 2400x1350 intrinsic size. The GIF dimensions
are unchanged.
* docs: clamp the onset magnifier against the left panel edge
docs: 300 dpi animations, tuned VP9 encoding, parallel rendering and audit fixes (#192)
* Render documentation animations at 300 DPI with a parallel pipeline
Raise the animation resolution from 800x450 to 2400x1350 (300 DPI, same
8x4.5 figure) so the clips stay crisp on high-density displays, and tune
the VP9 WebM encode (-tune-content screen -row-mt 1 -deadline good
-cpu-used 4) to roughly halve the encode time at the same file size. The
GitHub GIF fallback stays at 640 px.
Add a spawned process-pool renderer for the clips (one grouped task per
clip so each FDTD field is simulated once and reused across its four
language/theme variants), mirroring the figure runner and wired to the
existing --jobs flag; --anim single-clip re-renders and --jobs 1 stay
sequential.
Fold in a set of on-canvas readability fixes: Spanish decimal commas in
the FDTD time readouts, time and phase-caption labels repositioned clear
of tick labels and legends, a legible dark pill behind the ducting
channel-axis label, a mathtext L_W subscript in the two-rooms readout,
and the onset magnifier kept fully inside its panel.
* Re-render the documentation animations at 2400x1350
Regenerate every clip (WebM x four language/theme variants, EN GIF and
poster stills) at the new 300 DPI resolution with the tuned VP9 encode,
and refresh the posters at the matching intrinsic size.
* Link the high-resolution WebM under each docs GIF and resize site embeds
Add a one-line link to the high-resolution WebM of each clip beneath every
animation GIF in the GitHub-facing guides, and update the site <video>
embeds (EN + ES) to the new 2400x1350 intrinsic size. The GIF dimensions
are unchanged.
* docs: clamp the onset magnifier against the left panel edge
docs: 300 dpi animations, tuned VP9 encoding, parallel rendering and audit fixes (#192)
* Render documentation animations at 300 DPI with a parallel pipeline
Raise the animation resolution from 800x450 to 2400x1350 (300 DPI, same
8x4.5 figure) so the clips stay crisp on high-density displays, and tune
the VP9 WebM encode (-tune-content screen -row-mt 1 -deadline good
-cpu-used 4) to roughly halve the encode time at the same file size. The
GitHub GIF fallback stays at 640 px.
Add a spawned process-pool renderer for the clips (one grouped task per
clip so each FDTD field is simulated once and reused across its four
language/theme variants), mirroring the figure runner and wired to the
existing --jobs flag; --anim single-clip re-renders and --jobs 1 stay
sequential.
Fold in a set of on-canvas readability fixes: Spanish decimal commas in
the FDTD time readouts, time and phase-caption labels repositioned clear
of tick labels and legends, a legible dark pill behind the ducting
channel-axis label, a mathtext L_W subscript in the two-rooms readout,
and the onset magnifier kept fully inside its panel.
* Re-render the documentation animations at 2400x1350
Regenerate every clip (WebM x four language/theme variants, EN GIF and
poster stills) at the new 300 DPI resolution with the tuned VP9 encode,
and refresh the posters at the matching intrinsic size.
* Link the high-resolution WebM under each docs GIF and resize site embeds
Add a one-line link to the high-resolution WebM of each clip beneath every
animation GIF in the GitHub-facing guides, and update the site <video>
embeds (EN + ES) to the new 2400x1350 intrinsic size. The GIF dimensions
are unchanged.
* docs: clamp the onset magnifier against the left panel edge
docs: 300 dpi animations, tuned VP9 encoding, parallel rendering and audit fixes (#192)
* Render documentation animations at 300 DPI with a parallel pipeline
Raise the animation resolution from 800x450 to 2400x1350 (300 DPI, same
8x4.5 figure) so the clips stay crisp on high-density displays, and tune
the VP9 WebM encode (-tune-content screen -row-mt 1 -deadline good
-cpu-used 4) to roughly halve the encode time at the same file size. The
GitHub GIF fallback stays at 640 px.
Add a spawned process-pool renderer for the clips (one grouped task per
clip so each FDTD field is simulated once and reused across its four
language/theme variants), mirroring the figure runner and wired to the
existing --jobs flag; --anim single-clip re-renders and --jobs 1 stay
sequential.
Fold in a set of on-canvas readability fixes: Spanish decimal commas in
the FDTD time readouts, time and phase-caption labels repositioned clear
of tick labels and legends, a legible dark pill behind the ducting
channel-axis label, a mathtext L_W subscript in the two-rooms readout,
and the onset magnifier kept fully inside its panel.
* Re-render the documentation animations at 2400x1350
Regenerate every clip (WebM x four language/theme variants, EN GIF and
poster stills) at the new 300 DPI resolution with the tuned VP9 encode,
and refresh the posters at the matching intrinsic size.
* Link the high-resolution WebM under each docs GIF and resize site embeds
Add a one-line link to the high-resolution WebM of each clip beneath every
animation GIF in the GitHub-facing guides, and update the site <video>
embeds (EN + ES) to the new 2400x1350 intrinsic size. The GIF dimensions
are unchanged.
* docs: clamp the onset magnifier against the left panel edge
docs: 300 dpi animations, tuned VP9 encoding, parallel rendering and audit fixes (#192)
* Render documentation animations at 300 DPI with a parallel pipeline
Raise the animation resolution from 800x450 to 2400x1350 (300 DPI, same
8x4.5 figure) so the clips stay crisp on high-density displays, and tune
the VP9 WebM encode (-tune-content screen -row-mt 1 -deadline good
-cpu-used 4) to roughly halve the encode time at the same file size. The
GitHub GIF fallback stays at 640 px.
Add a spawned process-pool renderer for the clips (one grouped task per
clip so each FDTD field is simulated once and reused across its four
language/theme variants), mirroring the figure runner and wired to the
existing --jobs flag; --anim single-clip re-renders and --jobs 1 stay
sequential.
Fold in a set of on-canvas readability fixes: Spanish decimal commas in
the FDTD time readouts, time and phase-caption labels repositioned clear
of tick labels and legends, a legible dark pill behind the ducting
channel-axis label, a mathtext L_W subscript in the two-rooms readout,
and the onset magnifier kept fully inside its panel.
* Re-render the documentation animations at 2400x1350
Regenerate every clip (WebM x four language/theme variants, EN GIF and
poster stills) at the new 300 DPI resolution with the tuned VP9 encode,
and refresh the posters at the matching intrinsic size.
* Link the high-resolution WebM under each docs GIF and resize site embeds
Add a one-line link to the high-resolution WebM of each clip beneath every
animation GIF in the GitHub-facing guides, and update the site <video>
embeds (EN + ES) to the new 2400x1350 intrinsic size. The GIF dimensions
are unchanged.
* docs: clamp the onset magnifier against the left panel edge
docs: 300 dpi animations, tuned VP9 encoding, parallel rendering and audit fixes (#192)
* Render documentation animations at 300 DPI with a parallel pipeline
Raise the animation resolution from 800x450 to 2400x1350 (300 DPI, same
8x4.5 figure) so the clips stay crisp on high-density displays, and tune
the VP9 WebM encode (-tune-content screen -row-mt 1 -deadline good
-cpu-used 4) to roughly halve the encode time at the same file size. The
GitHub GIF fallback stays at 640 px.
Add a spawned process-pool renderer for the clips (one grouped task per
clip so each FDTD field is simulated once and reused across its four
language/theme variants), mirroring the figure runner and wired to the
existing --jobs flag; --anim single-clip re-renders and --jobs 1 stay
sequential.
Fold in a set of on-canvas readability fixes: Spanish decimal commas in
the FDTD time readouts, time and phase-caption labels repositioned clear
of tick labels and legends, a legible dark pill behind the ducting
channel-axis label, a mathtext L_W subscript in the two-rooms readout,
and the onset magnifier kept fully inside its panel.
* Re-render the documentation animations at 2400x1350
Regenerate every clip (WebM x four language/theme variants, EN GIF and
poster stills) at the new 300 DPI resolution with the tuned VP9 encode,
and refresh the posters at the matching intrinsic size.
* Link the high-resolution WebM under each docs GIF and resize site embeds
Add a one-line link to the high-resolution WebM of each clip beneath every
animation GIF in the GitHub-facing guides, and update the site <video>
embeds (EN + ES) to the new 2400x1350 intrinsic size. The GIF dimensions
are unchanged.
* docs: clamp the onset magnifier against the left panel edge
docs: 300 dpi animations, tuned VP9 encoding, parallel rendering and audit fixes (#192)
* Render documentation animations at 300 DPI with a parallel pipeline
Raise the animation resolution from 800x450 to 2400x1350 (300 DPI, same
8x4.5 figure) so the clips stay crisp on high-density displays, and tune
the VP9 WebM encode (-tune-content screen -row-mt 1 -deadline good
-cpu-used 4) to roughly halve the encode time at the same file size. The
GitHub GIF fallback stays at 640 px.
Add a spawned process-pool renderer for the clips (one grouped task per
clip so each FDTD field is simulated once and reused across its four
language/theme variants), mirroring the figure runner and wired to the
existing --jobs flag; --anim single-clip re-renders and --jobs 1 stay
sequential.
Fold in a set of on-canvas readability fixes: Spanish decimal commas in
the FDTD time readouts, time and phase-caption labels repositioned clear
of tick labels and legends, a legible dark pill behind the ducting
channel-axis label, a mathtext L_W subscript in the two-rooms readout,
and the onset magnifier kept fully inside its panel.
* Re-render the documentation animations at 2400x1350
Regenerate every clip (WebM x four language/theme variants, EN GIF and
poster stills) at the new 300 DPI resolution with the tuned VP9 encode,
and refresh the posters at the matching intrinsic size.
* Link the high-resolution WebM under each docs GIF and resize site embeds
Add a one-line link to the high-resolution WebM of each clip beneath every
animation GIF in the GitHub-facing guides, and update the site <video>
embeds (EN + ES) to the new 2400x1350 intrinsic size. The GIF dimensions
are unchanged.
* docs: clamp the onset magnifier against the left panel edge
docs: 300 dpi animations, tuned VP9 encoding, parallel rendering and audit fixes (#192)
* Render documentation animations at 300 DPI with a parallel pipeline
Raise the animation resolution from 800x450 to 2400x1350 (300 DPI, same
8x4.5 figure) so the clips stay crisp on high-density displays, and tune
the VP9 WebM encode (-tune-content screen -row-mt 1 -deadline good
-cpu-used 4) to roughly halve the encode time at the same file size. The
GitHub GIF fallback stays at 640 px.
Add a spawned process-pool renderer for the clips (one grouped task per
clip so each FDTD field is simulated once and reused across its four
language/theme variants), mirroring the figure runner and wired to the
existing --jobs flag; --anim single-clip re-renders and --jobs 1 stay
sequential.
Fold in a set of on-canvas readability fixes: Spanish decimal commas in
the FDTD time readouts, time and phase-caption labels repositioned clear
of tick labels and legends, a legible dark pill behind the ducting
channel-axis label, a mathtext L_W subscript in the two-rooms readout,
and the onset magnifier kept fully inside its panel.
* Re-render the documentation animations at 2400x1350
Regenerate every clip (WebM x four language/theme variants, EN GIF and
poster stills) at the new 300 DPI resolution with the tuned VP9 encode,
and refresh the posters at the matching intrinsic size.
* Link the high-resolution WebM under each docs GIF and resize site embeds
Add a one-line link to the high-resolution WebM of each clip beneath every
animation GIF in the GitHub-facing guides, and update the site <video>
embeds (EN + ES) to the new 2400x1350 intrinsic size. The GIF dimensions
are unchanged.
* docs: clamp the onset magnifier against the left panel edge
docs: 300 dpi animations, tuned VP9 encoding, parallel rendering and audit fixes (#192)
* Render documentation animations at 300 DPI with a parallel pipeline
Raise the animation resolution from 800x450 to 2400x1350 (300 DPI, same
8x4.5 figure) so the clips stay crisp on high-density displays, and tune
the VP9 WebM encode (-tune-content screen -row-mt 1 -deadline good
-cpu-used 4) to roughly halve the encode time at the same file size. The
GitHub GIF fallback stays at 640 px.
Add a spawned process-pool renderer for the clips (one grouped task per
clip so each FDTD field is simulated once and reused across its four
language/theme variants), mirroring the figure runner and wired to the
existing --jobs flag; --anim single-clip re-renders and --jobs 1 stay
sequential.
Fold in a set of on-canvas readability fixes: Spanish decimal commas in
the FDTD time readouts, time and phase-caption labels repositioned clear
of tick labels and legends, a legible dark pill behind the ducting
channel-axis label, a mathtext L_W subscript in the two-rooms readout,
and the onset magnifier kept fully inside its panel.
* Re-render the documentation animations at 2400x1350
Regenerate every clip (WebM x four language/theme variants, EN GIF and
poster stills) at the new 300 DPI resolution with the tuned VP9 encode,
and refresh the posters at the matching intrinsic size.
* Link the high-resolution WebM under each docs GIF and resize site embeds
Add a one-line link to the high-resolution WebM of each clip beneath every
animation GIF in the GitHub-facing guides, and update the site <video>
embeds (EN + ES) to the new 2400x1350 intrinsic size. The GIF dimensions
are unchanged.
* docs: clamp the onset magnifier against the left panel edge
docs: 300 dpi animations, tuned VP9 encoding, parallel rendering and audit fixes (#192)
* Render documentation animations at 300 DPI with a parallel pipeline
Raise the animation resolution from 800x450 to 2400x1350 (300 DPI, same
8x4.5 figure) so the clips stay crisp on high-density displays, and tune
the VP9 WebM encode (-tune-content screen -row-mt 1 -deadline good
-cpu-used 4) to roughly halve the encode time at the same file size. The
GitHub GIF fallback stays at 640 px.
Add a spawned process-pool renderer for the clips (one grouped task per
clip so each FDTD field is simulated once and reused across its four
language/theme variants), mirroring the figure runner and wired to the
existing --jobs flag; --anim single-clip re-renders and --jobs 1 stay
sequential.
Fold in a set of on-canvas readability fixes: Spanish decimal commas in
the FDTD time readouts, time and phase-caption labels repositioned clear
of tick labels and legends, a legible dark pill behind the ducting
channel-axis label, a mathtext L_W subscript in the two-rooms readout,
and the onset magnifier kept fully inside its panel.
* Re-render the documentation animations at 2400x1350
Regenerate every clip (WebM x four language/theme variants, EN GIF and
poster stills) at the new 300 DPI resolution with the tuned VP9 encode,
and refresh the posters at the matching intrinsic size.
* Link the high-resolution WebM under each docs GIF and resize site embeds
Add a one-line link to the high-resolution WebM of each clip beneath every
animation GIF in the GitHub-facing guides, and update the site <video>
embeds (EN + ES) to the new 2400x1350 intrinsic size. The GIF dimensions
are unchanged.
* docs: clamp the onset magnifier against the left panel edge
docs: 300 dpi animations, tuned VP9 encoding, parallel rendering and audit fixes (#192)
* Render documentation animations at 300 DPI with a parallel pipeline
Raise the animation resolution from 800x450 to 2400x1350 (300 DPI, same
8x4.5 figure) so the clips stay crisp on high-density displays, and tune
the VP9 WebM encode (-tune-content screen -row-mt 1 -deadline good
-cpu-used 4) to roughly halve the encode time at the same file size. The
GitHub GIF fallback stays at 640 px.
Add a spawned process-pool renderer for the clips (one grouped task per
clip so each FDTD field is simulated once and reused across its four
language/theme variants), mirroring the figure runner and wired to the
existing --jobs flag; --anim single-clip re-renders and --jobs 1 stay
sequential.
Fold in a set of on-canvas readability fixes: Spanish decimal commas in
the FDTD time readouts, time and phase-caption labels repositioned clear
of tick labels and legends, a legible dark pill behind the ducting
channel-axis label, a mathtext L_W subscript in the two-rooms readout,
and the onset magnifier kept fully inside its panel.
* Re-render the documentation animations at 2400x1350
Regenerate every clip (WebM x four language/theme variants, EN GIF and
poster stills) at the new 300 DPI resolution with the tuned VP9 encode,
and refresh the posters at the matching intrinsic size.
* Link the high-resolution WebM under each docs GIF and resize site embeds
Add a one-line link to the high-resolution WebM of each clip beneath every
animation GIF in the GitHub-facing guides, and update the site <video>
embeds (EN + ES) to the new 2400x1350 intrinsic size. The GIF dimensions
are unchanged.
* docs: clamp the onset magnifier against the left panel edge
docs: 300 dpi animations, tuned VP9 encoding, parallel rendering and audit fixes (#192)
* Render documentation animations at 300 DPI with a parallel pipeline
Raise the animation resolution from 800x450 to 2400x1350 (300 DPI, same
8x4.5 figure) so the clips stay crisp on high-density displays, and tune
the VP9 WebM encode (-tune-content screen -row-mt 1 -deadline good
-cpu-used 4) to roughly halve the encode time at the same file size. The
GitHub GIF fallback stays at 640 px.
Add a spawned process-pool renderer for the clips (one grouped task per
clip so each FDTD field is simulated once and reused across its four
language/theme variants), mirroring the figure runner and wired to the
existing --jobs flag; --anim single-clip re-renders and --jobs 1 stay
sequential.
Fold in a set of on-canvas readability fixes: Spanish decimal commas in
the FDTD time readouts, time and phase-caption labels repositioned clear
of tick labels and legends, a legible dark pill behind the ducting
channel-axis label, a mathtext L_W subscript in the two-rooms readout,
and the onset magnifier kept fully inside its panel.
* Re-render the documentation animations at 2400x1350
Regenerate every clip (WebM x four language/theme variants, EN GIF and
poster stills) at the new 300 DPI resolution with the tuned VP9 encode,
and refresh the posters at the matching intrinsic size.
* Link the high-resolution WebM under each docs GIF and resize site embeds
Add a one-line link to the high-resolution WebM of each clip beneath every
animation GIF in the GitHub-facing guides, and update the site <video>
embeds (EN + ES) to the new 2400x1350 intrinsic size. The GIF dimensions
are unchanged.
* docs: clamp the onset magnifier against the left panel edge
docs: 300 dpi animations, tuned VP9 encoding, parallel rendering and audit fixes (#192)
* Render documentation animations at 300 DPI with a parallel pipeline
Raise the animation resolution from 800x450 to 2400x1350 (300 DPI, same
8x4.5 figure) so the clips stay crisp on high-density displays, and tune
the VP9 WebM encode (-tune-content screen -row-mt 1 -deadline good
-cpu-used 4) to roughly halve the encode time at the same file size. The
GitHub GIF fallback stays at 640 px.
Add a spawned process-pool renderer for the clips (one grouped task per
clip so each FDTD field is simulated once and reused across its four
language/theme variants), mirroring the figure runner and wired to the
existing --jobs flag; --anim single-clip re-renders and --jobs 1 stay
sequential.
Fold in a set of on-canvas readability fixes: Spanish decimal commas in
the FDTD time readouts, time and phase-caption labels repositioned clear
of tick labels and legends, a legible dark pill behind the ducting
channel-axis label, a mathtext L_W subscript in the two-rooms readout,
and the onset magnifier kept fully inside its panel.
* Re-render the documentation animations at 2400x1350
Regenerate every clip (WebM x four language/theme variants, EN GIF and
poster stills) at the new 300 DPI resolution with the tuned VP9 encode,
and refresh the posters at the matching intrinsic size.
* Link the high-resolution WebM under each docs GIF and resize site embeds
Add a one-line link to the high-resolution WebM of each clip beneath every
animation GIF in the GitHub-facing guides, and update the site <video>
embeds (EN + ES) to the new 2400x1350 intrinsic size. The GIF dimensions
are unchanged.
* docs: clamp the onset magnifier against the left panel edge
docs: 300 dpi animations, tuned VP9 encoding, parallel rendering and audit fixes (#192)
* Render documentation animations at 300 DPI with a parallel pipeline
Raise the animation resolution from 800x450 to 2400x1350 (300 DPI, same
8x4.5 figure) so the clips stay crisp on high-density displays, and tune
the VP9 WebM encode (-tune-content screen -row-mt 1 -deadline good
-cpu-used 4) to roughly halve the encode time at the same file size. The
GitHub GIF fallback stays at 640 px.
Add a spawned process-pool renderer for the clips (one grouped task per
clip so each FDTD field is simulated once and reused across its four
language/theme variants), mirroring the figure runner and wired to the
existing --jobs flag; --anim single-clip re-renders and --jobs 1 stay
sequential.
Fold in a set of on-canvas readability fixes: Spanish decimal commas in
the FDTD time readouts, time and phase-caption labels repositioned clear
of tick labels and legends, a legible dark pill behind the ducting
channel-axis label, a mathtext L_W subscript in the two-rooms readout,
and the onset magnifier kept fully inside its panel.
* Re-render the documentation animations at 2400x1350
Regenerate every clip (WebM x four language/theme variants, EN GIF and
poster stills) at the new 300 DPI resolution with the tuned VP9 encode,
and refresh the posters at the matching intrinsic size.
* Link the high-resolution WebM under each docs GIF and resize site embeds
Add a one-line link to the high-resolution WebM of each clip beneath every
animation GIF in the GitHub-facing guides, and update the site <video>
embeds (EN + ES) to the new 2400x1350 intrinsic size. The GIF dimensions
are unchanged.
* docs: clamp the onset magnifier against the left panel edge
docs: 300 dpi animations, tuned VP9 encoding, parallel rendering and audit fixes (#192)
* Render documentation animations at 300 DPI with a parallel pipeline
Raise the animation resolution from 800x450 to 2400x1350 (300 DPI, same
8x4.5 figure) so the clips stay crisp on high-density displays, and tune
the VP9 WebM encode (-tune-content screen -row-mt 1 -deadline good
-cpu-used 4) to roughly halve the encode time at the same file size. The
GitHub GIF fallback stays at 640 px.
Add a spawned process-pool renderer for the clips (one grouped task per
clip so each FDTD field is simulated once and reused across its four
language/theme variants), mirroring the figure runner and wired to the
existing --jobs flag; --anim single-clip re-renders and --jobs 1 stay
sequential.
Fold in a set of on-canvas readability fixes: Spanish decimal commas in
the FDTD time readouts, time and phase-caption labels repositioned clear
of tick labels and legends, a legible dark pill behind the ducting
channel-axis label, a mathtext L_W subscript in the two-rooms readout,
and the onset magnifier kept fully inside its panel.
* Re-render the documentation animations at 2400x1350
Regenerate every clip (WebM x four language/theme variants, EN GIF and
poster stills) at the new 300 DPI resolution with the tuned VP9 encode,
and refresh the posters at the matching intrinsic size.
* Link the high-resolution WebM under each docs GIF and resize site embeds
Add a one-line link to the high-resolution WebM of each clip beneath every
animation GIF in the GitHub-facing guides, and update the site <video>
embeds (EN + ES) to the new 2400x1350 intrinsic size. The GIF dimensions
are unchanged.
* docs: clamp the onset magnifier against the left panel edge
docs: 300 dpi animations, tuned VP9 encoding, parallel rendering and audit fixes (#192)
* Render documentation animations at 300 DPI with a parallel pipeline
Raise the animation resolution from 800x450 to 2400x1350 (300 DPI, same
8x4.5 figure) so the clips stay crisp on high-density displays, and tune
the VP9 WebM encode (-tune-content screen -row-mt 1 -deadline good
-cpu-used 4) to roughly halve the encode time at the same file size. The
GitHub GIF fallback stays at 640 px.
Add a spawned process-pool renderer for the clips (one grouped task per
clip so each FDTD field is simulated once and reused across its four
language/theme variants), mirroring the figure runner and wired to the
existing --jobs flag; --anim single-clip re-renders and --jobs 1 stay
sequential.
Fold in a set of on-canvas readability fixes: Spanish decimal commas in
the FDTD time readouts, time and phase-caption labels repositioned clear
of tick labels and legends, a legible dark pill behind the ducting
channel-axis label, a mathtext L_W subscript in the two-rooms readout,
and the onset magnifier kept fully inside its panel.
* Re-render the documentation animations at 2400x1350
Regenerate every clip (WebM x four language/theme variants, EN GIF and
poster stills) at the new 300 DPI resolution with the tuned VP9 encode,
and refresh the posters at the matching intrinsic size.
* Link the high-resolution WebM under each docs GIF and resize site embeds
Add a one-line link to the high-resolution WebM of each clip beneath every
animation GIF in the GitHub-facing guides, and update the site <video>
embeds (EN + ES) to the new 2400x1350 intrinsic size. The GIF dimensions
are unchanged.
* docs: clamp the onset magnifier against the left panel edge
docs: 300 dpi animations, tuned VP9 encoding, parallel rendering and audit fixes (#192)
* Render documentation animations at 300 DPI with a parallel pipeline
Raise the animation resolution from 800x450 to 2400x1350 (300 DPI, same
8x4.5 figure) so the clips stay crisp on high-density displays, and tune
the VP9 WebM encode (-tune-content screen -row-mt 1 -deadline good
-cpu-used 4) to roughly halve the encode time at the same file size. The
GitHub GIF fallback stays at 640 px.
Add a spawned process-pool renderer for the clips (one grouped task per
clip so each FDTD field is simulated once and reused across its four
language/theme variants), mirroring the figure runner and wired to the
existing --jobs flag; --anim single-clip re-renders and --jobs 1 stay
sequential.
Fold in a set of on-canvas readability fixes: Spanish decimal commas in
the FDTD time readouts, time and phase-caption labels repositioned clear
of tick labels and legends, a legible dark pill behind the ducting
channel-axis label, a mathtext L_W subscript in the two-rooms readout,
and the onset magnifier kept fully inside its panel.
* Re-render the documentation animations at 2400x1350
Regenerate every clip (WebM x four language/theme variants, EN GIF and
poster stills) at the new 300 DPI resolution with the tuned VP9 encode,
and refresh the posters at the matching intrinsic size.
* Link the high-resolution WebM under each docs GIF and resize site embeds
Add a one-line link to the high-resolution WebM of each clip beneath every
animation GIF in the GitHub-facing guides, and update the site <video>
embeds (EN + ES) to the new 2400x1350 intrinsic size. The GIF dimensions
are unchanged.
* docs: clamp the onset magnifier against the left panel edge
docs: 300 dpi animations, tuned VP9 encoding, parallel rendering and audit fixes (#192)
* Render documentation animations at 300 DPI with a parallel pipeline
Raise the animation resolution from 800x450 to 2400x1350 (300 DPI, same
8x4.5 figure) so the clips stay crisp on high-density displays, and tune
the VP9 WebM encode (-tune-content screen -row-mt 1 -deadline good
-cpu-used 4) to roughly halve the encode time at the same file size. The
GitHub GIF fallback stays at 640 px.
Add a spawned process-pool renderer for the clips (one grouped task per
clip so each FDTD field is simulated once and reused across its four
language/theme variants), mirroring the figure runner and wired to the
existing --jobs flag; --anim single-clip re-renders and --jobs 1 stay
sequential.
Fold in a set of on-canvas readability fixes: Spanish decimal commas in
the FDTD time readouts, time and phase-caption labels repositioned clear
of tick labels and legends, a legible dark pill behind the ducting
channel-axis label, a mathtext L_W subscript in the two-rooms readout,
and the onset magnifier kept fully inside its panel.
* Re-render the documentation animations at 2400x1350
Regenerate every clip (WebM x four language/theme variants, EN GIF and
poster stills) at the new 300 DPI resolution with the tuned VP9 encode,
and refresh the posters at the matching intrinsic size.
* Link the high-resolution WebM under each docs GIF and resize site embeds
Add a one-line link to the high-resolution WebM of each clip beneath every
animation GIF in the GitHub-facing guides, and update the site <video>
embeds (EN + ES) to the new 2400x1350 intrinsic size. The GIF dimensions
are unchanged.
* docs: clamp the onset magnifier against the left panel edge
docs: 300 dpi animations, tuned VP9 encoding, parallel rendering and audit fixes (#192)
* Render documentation animations at 300 DPI with a parallel pipeline
Raise the animation resolution from 800x450 to 2400x1350 (300 DPI, same
8x4.5 figure) so the clips stay crisp on high-density displays, and tune
the VP9 WebM encode (-tune-content screen -row-mt 1 -deadline good
-cpu-used 4) to roughly halve the encode time at the same file size. The
GitHub GIF fallback stays at 640 px.
Add a spawned process-pool renderer for the clips (one grouped task per
clip so each FDTD field is simulated once and reused across its four
language/theme variants), mirroring the figure runner and wired to the
existing --jobs flag; --anim single-clip re-renders and --jobs 1 stay
sequential.
Fold in a set of on-canvas readability fixes: Spanish decimal commas in
the FDTD time readouts, time and phase-caption labels repositioned clear
of tick labels and legends, a legible dark pill behind the ducting
channel-axis label, a mathtext L_W subscript in the two-rooms readout,
and the onset magnifier kept fully inside its panel.
* Re-render the documentation animations at 2400x1350
Regenerate every clip (WebM x four language/theme variants, EN GIF and
poster stills) at the new 300 DPI resolution with the tuned VP9 encode,
and refresh the posters at the matching intrinsic size.
* Link the high-resolution WebM under each docs GIF and resize site embeds
Add a one-line link to the high-resolution WebM of each clip beneath every
animation GIF in the GitHub-facing guides, and update the site <video>
embeds (EN + ES) to the new 2400x1350 intrinsic size. The GIF dimensions
are unchanged.
* docs: clamp the onset magnifier against the left panel edge
docs: 300 dpi animations, tuned VP9 encoding, parallel rendering and audit fixes (#192)
* Render documentation animations at 300 DPI with a parallel pipeline
Raise the animation resolution from 800x450 to 2400x1350 (300 DPI, same
8x4.5 figure) so the clips stay crisp on high-density displays, and tune
the VP9 WebM encode (-tune-content screen -row-mt 1 -deadline good
-cpu-used 4) to roughly halve the encode time at the same file size. The
GitHub GIF fallback stays at 640 px.
Add a spawned process-pool renderer for the clips (one grouped task per
clip so each FDTD field is simulated once and reused across its four
language/theme variants), mirroring the figure runner and wired to the
existing --jobs flag; --anim single-clip re-renders and --jobs 1 stay
sequential.
Fold in a set of on-canvas readability fixes: Spanish decimal commas in
the FDTD time readouts, time and phase-caption labels repositioned clear
of tick labels and legends, a legible dark pill behind the ducting
channel-axis label, a mathtext L_W subscript in the two-rooms readout,
and the onset magnifier kept fully inside its panel.
* Re-render the documentation animations at 2400x1350
Regenerate every clip (WebM x four language/theme variants, EN GIF and
poster stills) at the new 300 DPI resolution with the tuned VP9 encode,
and refresh the posters at the matching intrinsic size.
* Link the high-resolution WebM under each docs GIF and resize site embeds
Add a one-line link to the high-resolution WebM of each clip beneath every
animation GIF in the GitHub-facing guides, and update the site <video>
embeds (EN + ES) to the new 2400x1350 intrinsic size. The GIF dimensions
are unchanged.
* docs: clamp the onset magnifier against the left panel edge
docs: 300 dpi animations, tuned VP9 encoding, parallel rendering and audit fixes (#192)
* Render documentation animations at 300 DPI with a parallel pipeline
Raise the animation resolution from 800x450 to 2400x1350 (300 DPI, same
8x4.5 figure) so the clips stay crisp on high-density displays, and tune
the VP9 WebM encode (-tune-content screen -row-mt 1 -deadline good
-cpu-used 4) to roughly halve the encode time at the same file size. The
GitHub GIF fallback stays at 640 px.
Add a spawned process-pool renderer for the clips (one grouped task per
clip so each FDTD field is simulated once and reused across its four
language/theme variants), mirroring the figure runner and wired to the
existing --jobs flag; --anim single-clip re-renders and --jobs 1 stay
sequential.
Fold in a set of on-canvas readability fixes: Spanish decimal commas in
the FDTD time readouts, time and phase-caption labels repositioned clear
of tick labels and legends, a legible dark pill behind the ducting
channel-axis label, a mathtext L_W subscript in the two-rooms readout,
and the onset magnifier kept fully inside its panel.
* Re-render the documentation animations at 2400x1350
Regenerate every clip (WebM x four language/theme variants, EN GIF and
poster stills) at the new 300 DPI resolution with the tuned VP9 encode,
and refresh the posters at the matching intrinsic size.
* Link the high-resolution WebM under each docs GIF and resize site embeds
Add a one-line link to the high-resolution WebM of each clip beneath every
animation GIF in the GitHub-facing guides, and update the site <video>
embeds (EN + ES) to the new 2400x1350 intrinsic size. The GIF dimensions
are unchanged.
* docs: clamp the onset magnifier against the left panel edge
docs: 300 dpi animations, tuned VP9 encoding, parallel rendering and audit fixes (#192)
* Render documentation animations at 300 DPI with a parallel pipeline
Raise the animation resolution from 800x450 to 2400x1350 (300 DPI, same
8x4.5 figure) so the clips stay crisp on high-density displays, and tune
the VP9 WebM encode (-tune-content screen -row-mt 1 -deadline good
-cpu-used 4) to roughly halve the encode time at the same file size. The
GitHub GIF fallback stays at 640 px.
Add a spawned process-pool renderer for the clips (one grouped task per
clip so each FDTD field is simulated once and reused across its four
language/theme variants), mirroring the figure runner and wired to the
existing --jobs flag; --anim single-clip re-renders and --jobs 1 stay
sequential.
Fold in a set of on-canvas readability fixes: Spanish decimal commas in
the FDTD time readouts, time and phase-caption labels repositioned clear
of tick labels and legends, a legible dark pill behind the ducting
channel-axis label, a mathtext L_W subscript in the two-rooms readout,
and the onset magnifier kept fully inside its panel.
* Re-render the documentation animations at 2400x1350
Regenerate every clip (WebM x four language/theme variants, EN GIF and
poster stills) at the new 300 DPI resolution with the tuned VP9 encode,
and refresh the posters at the matching intrinsic size.
* Link the high-resolution WebM under each docs GIF and resize site embeds
Add a one-line link to the high-resolution WebM of each clip beneath every
animation GIF in the GitHub-facing guides, and update the site <video>
embeds (EN + ES) to the new 2400x1350 intrinsic size. The GIF dimensions
are unchanged.
* docs: clamp the onset magnifier against the left panel edge
docs: 300 dpi animations, tuned VP9 encoding, parallel rendering and audit fixes (#192)
* Render documentation animations at 300 DPI with a parallel pipeline
Raise the animation resolution from 800x450 to 2400x1350 (300 DPI, same
8x4.5 figure) so the clips stay crisp on high-density displays, and tune
the VP9 WebM encode (-tune-content screen -row-mt 1 -deadline good
-cpu-used 4) to roughly halve the encode time at the same file size. The
GitHub GIF fallback stays at 640 px.
Add a spawned process-pool renderer for the clips (one grouped task per
clip so each FDTD field is simulated once and reused across its four
language/theme variants), mirroring the figure runner and wired to the
existing --jobs flag; --anim single-clip re-renders and --jobs 1 stay
sequential.
Fold in a set of on-canvas readability fixes: Spanish decimal commas in
the FDTD time readouts, time and phase-caption labels repositioned clear
of tick labels and legends, a legible dark pill behind the ducting
channel-axis label, a mathtext L_W subscript in the two-rooms readout,
and the onset magnifier kept fully inside its panel.
* Re-render the documentation animations at 2400x1350
Regenerate every clip (WebM x four language/theme variants, EN GIF and
poster stills) at the new 300 DPI resolution with the tuned VP9 encode,
and refresh the posters at the matching intrinsic size.
* Link the high-resolution WebM under each docs GIF and resize site embeds
Add a one-line link to the high-resolution WebM of each clip beneath every
animation GIF in the GitHub-facing guides, and update the site <video>
embeds (EN + ES) to the new 2400x1350 intrinsic size. The GIF dimensions
are unchanged.
* docs: clamp the onset magnifier against the left panel edge
docs: 300 dpi animations, tuned VP9 encoding, parallel rendering and audit fixes (#192)
* Render documentation animations at 300 DPI with a parallel pipeline
Raise the animation resolution from 800x450 to 2400x1350 (300 DPI, same
8x4.5 figure) so the clips stay crisp on high-density displays, and tune
the VP9 WebM encode (-tune-content screen -row-mt 1 -deadline good
-cpu-used 4) to roughly halve the encode time at the same file size. The
GitHub GIF fallback stays at 640 px.
Add a spawned process-pool renderer for the clips (one grouped task per
clip so each FDTD field is simulated once and reused across its four
language/theme variants), mirroring the figure runner and wired to the
existing --jobs flag; --anim single-clip re-renders and --jobs 1 stay
sequential.
Fold in a set of on-canvas readability fixes: Spanish decimal commas in
the FDTD time readouts, time and phase-caption labels repositioned clear
of tick labels and legends, a legible dark pill behind the ducting
channel-axis label, a mathtext L_W subscript in the two-rooms readout,
and the onset magnifier kept fully inside its panel.
* Re-render the documentation animations at 2400x1350
Regenerate every clip (WebM x four language/theme variants, EN GIF and
poster stills) at the new 300 DPI resolution with the tuned VP9 encode,
and refresh the posters at the matching intrinsic size.
* Link the high-resolution WebM under each docs GIF and resize site embeds
Add a one-line link to the high-resolution WebM of each clip beneath every
animation GIF in the GitHub-facing guides, and update the site <video>
embeds (EN + ES) to the new 2400x1350 intrinsic size. The GIF dimensions
are unchanged.
* docs: clamp the onset magnifier against the left panel edge
docs: 300 dpi animations, tuned VP9 encoding, parallel rendering and audit fixes (#192)
* Render documentation animations at 300 DPI with a parallel pipeline
Raise the animation resolution from 800x450 to 2400x1350 (300 DPI, same
8x4.5 figure) so the clips stay crisp on high-density displays, and tune
the VP9 WebM encode (-tune-content screen -row-mt 1 -deadline good
-cpu-used 4) to roughly halve the encode time at the same file size. The
GitHub GIF fallback stays at 640 px.
Add a spawned process-pool renderer for the clips (one grouped task per
clip so each FDTD field is simulated once and reused across its four
language/theme variants), mirroring the figure runner and wired to the
existing --jobs flag; --anim single-clip re-renders and --jobs 1 stay
sequential.
Fold in a set of on-canvas readability fixes: Spanish decimal commas in
the FDTD time readouts, time and phase-caption labels repositioned clear
of tick labels and legends, a legible dark pill behind the ducting
channel-axis label, a mathtext L_W subscript in the two-rooms readout,
and the onset magnifier kept fully inside its panel.
* Re-render the documentation animations at 2400x1350
Regenerate every clip (WebM x four language/theme variants, EN GIF and
poster stills) at the new 300 DPI resolution with the tuned VP9 encode,
and refresh the posters at the matching intrinsic size.
* Link the high-resolution WebM under each docs GIF and resize site embeds
Add a one-line link to the high-resolution WebM of each clip beneath every
animation GIF in the GitHub-facing guides, and update the site <video>
embeds (EN + ES) to the new 2400x1350 intrinsic size. The GIF dimensions
are unchanged.
* docs: clamp the onset magnifier against the left panel edge
docs: 300 dpi animations, tuned VP9 encoding, parallel rendering and audit fixes (#192)
* Render documentation animations at 300 DPI with a parallel pipeline
Raise the animation resolution from 800x450 to 2400x1350 (300 DPI, same
8x4.5 figure) so the clips stay crisp on high-density displays, and tune
the VP9 WebM encode (-tune-content screen -row-mt 1 -deadline good
-cpu-used 4) to roughly halve the encode time at the same file size. The
GitHub GIF fallback stays at 640 px.
Add a spawned process-pool renderer for the clips (one grouped task per
clip so each FDTD field is simulated once and reused across its four
language/theme variants), mirroring the figure runner and wired to the
existing --jobs flag; --anim single-clip re-renders and --jobs 1 stay
sequential.
Fold in a set of on-canvas readability fixes: Spanish decimal commas in
the FDTD time readouts, time and phase-caption labels repositioned clear
of tick labels and legends, a legible dark pill behind the ducting
channel-axis label, a mathtext L_W subscript in the two-rooms readout,
and the onset magnifier kept fully inside its panel.
* Re-render the documentation animations at 2400x1350
Regenerate every clip (WebM x four language/theme variants, EN GIF and
poster stills) at the new 300 DPI resolution with the tuned VP9 encode,
and refresh the posters at the matching intrinsic size.
* Link the high-resolution WebM under each docs GIF and resize site embeds
Add a one-line link to the high-resolution WebM of each clip beneath every
animation GIF in the GitHub-facing guides, and update the site <video>
embeds (EN + ES) to the new 2400x1350 intrinsic size. The GIF dimensions
are unchanged.
* docs: clamp the onset magnifier against the left panel edge
docs: 300 dpi animations, tuned VP9 encoding, parallel rendering and audit fixes (#192)
* Render documentation animations at 300 DPI with a parallel pipeline
Raise the animation resolution from 800x450 to 2400x1350 (300 DPI, same
8x4.5 figure) so the clips stay crisp on high-density displays, and tune
the VP9 WebM encode (-tune-content screen -row-mt 1 -deadline good
-cpu-used 4) to roughly halve the encode time at the same file size. The
GitHub GIF fallback stays at 640 px.
Add a spawned process-pool renderer for the clips (one grouped task per
clip so each FDTD field is simulated once and reused across its four
language/theme variants), mirroring the figure runner and wired to the
existing --jobs flag; --anim single-clip re-renders and --jobs 1 stay
sequential.
Fold in a set of on-canvas readability fixes: Spanish decimal commas in
the FDTD time readouts, time and phase-caption labels repositioned clear
of tick labels and legends, a legible dark pill behind the ducting
channel-axis label, a mathtext L_W subscript in the two-rooms readout,
and the onset magnifier kept fully inside its panel.
* Re-render the documentation animations at 2400x1350
Regenerate every clip (WebM x four language/theme variants, EN GIF and
poster stills) at the new 300 DPI resolution with the tuned VP9 encode,
and refresh the posters at the matching intrinsic size.
* Link the high-resolution WebM under each docs GIF and resize site embeds
Add a one-line link to the high-resolution WebM of each clip beneath every
animation GIF in the GitHub-facing guides, and update the site <video>
embeds (EN + ES) to the new 2400x1350 intrinsic size. The GIF dimensions
are unchanged.
* docs: clamp the onset magnifier against the left panel edge
docs: 300 dpi animations, tuned VP9 encoding, parallel rendering and audit fixes (#192)
* Render documentation animations at 300 DPI with a parallel pipeline
Raise the animation resolution from 800x450 to 2400x1350 (300 DPI, same
8x4.5 figure) so the clips stay crisp on high-density displays, and tune
the VP9 WebM encode (-tune-content screen -row-mt 1 -deadline good
-cpu-used 4) to roughly halve the encode time at the same file size. The
GitHub GIF fallback stays at 640 px.
Add a spawned process-pool renderer for the clips (one grouped task per
clip so each FDTD field is simulated once and reused across its four
language/theme variants), mirroring the figure runner and wired to the
existing --jobs flag; --anim single-clip re-renders and --jobs 1 stay
sequential.
Fold in a set of on-canvas readability fixes: Spanish decimal commas in
the FDTD time readouts, time and phase-caption labels repositioned clear
of tick labels and legends, a legible dark pill behind the ducting
channel-axis label, a mathtext L_W subscript in the two-rooms readout,
and the onset magnifier kept fully inside its panel.
* Re-render the documentation animations at 2400x1350
Regenerate every clip (WebM x four language/theme variants, EN GIF and
poster stills) at the new 300 DPI resolution with the tuned VP9 encode,
and refresh the posters at the matching intrinsic size.
* Link the high-resolution WebM under each docs GIF and resize site embeds
Add a one-line link to the high-resolution WebM of each clip beneath every
animation GIF in the GitHub-facing guides, and update the site <video>
embeds (EN + ES) to the new 2400x1350 intrinsic size. The GIF dimensions
are unchanged.
* docs: clamp the onset magnifier against the left panel edge
docs: 300 dpi animations, tuned VP9 encoding, parallel rendering and audit fixes (#192)
* Render documentation animations at 300 DPI with a parallel pipeline
Raise the animation resolution from 800x450 to 2400x1350 (300 DPI, same
8x4.5 figure) so the clips stay crisp on high-density displays, and tune
the VP9 WebM encode (-tune-content screen -row-mt 1 -deadline good
-cpu-used 4) to roughly halve the encode time at the same file size. The
GitHub GIF fallback stays at 640 px.
Add a spawned process-pool renderer for the clips (one grouped task per
clip so each FDTD field is simulated once and reused across its four
language/theme variants), mirroring the figure runner and wired to the
existing --jobs flag; --anim single-clip re-renders and --jobs 1 stay
sequential.
Fold in a set of on-canvas readability fixes: Spanish decimal commas in
the FDTD time readouts, time and phase-caption labels repositioned clear
of tick labels and legends, a legible dark pill behind the ducting
channel-axis label, a mathtext L_W subscript in the two-rooms readout,
and the onset magnifier kept fully inside its panel.
* Re-render the documentation animations at 2400x1350
Regenerate every clip (WebM x four language/theme variants, EN GIF and
poster stills) at the new 300 DPI resolution with the tuned VP9 encode,
and refresh the posters at the matching intrinsic size.
* Link the high-resolution WebM under each docs GIF and resize site embeds
Add a one-line link to the high-resolution WebM of each clip beneath every
animation GIF in the GitHub-facing guides, and update the site <video>
embeds (EN + ES) to the new 2400x1350 intrinsic size. The GIF dimensions
are unchanged.
* docs: clamp the onset magnifier against the left panel edge
docs: 300 dpi animations, tuned VP9 encoding, parallel rendering and audit fixes (#192)
* Render documentation animations at 300 DPI with a parallel pipeline
Raise the animation resolution from 800x450 to 2400x1350 (300 DPI, same
8x4.5 figure) so the clips stay crisp on high-density displays, and tune
the VP9 WebM encode (-tune-content screen -row-mt 1 -deadline good
-cpu-used 4) to roughly halve the encode time at the same file size. The
GitHub GIF fallback stays at 640 px.
Add a spawned process-pool renderer for the clips (one grouped task per
clip so each FDTD field is simulated once and reused across its four
language/theme variants), mirroring the figure runner and wired to the
existing --jobs flag; --anim single-clip re-renders and --jobs 1 stay
sequential.
Fold in a set of on-canvas readability fixes: Spanish decimal commas in
the FDTD time readouts, time and phase-caption labels repositioned clear
of tick labels and legends, a legible dark pill behind the ducting
channel-axis label, a mathtext L_W subscript in the two-rooms readout,
and the onset magnifier kept fully inside its panel.
* Re-render the documentation animations at 2400x1350
Regenerate every clip (WebM x four language/theme variants, EN GIF and
poster stills) at the new 300 DPI resolution with the tuned VP9 encode,
and refresh the posters at the matching intrinsic size.
* Link the high-resolution WebM under each docs GIF and resize site embeds
Add a one-line link to the high-resolution WebM of each clip beneath every
animation GIF in the GitHub-facing guides, and update the site <video>
embeds (EN + ES) to the new 2400x1350 intrinsic size. The GIF dimensions
are unchanged.
* docs: clamp the onset magnifier against the left panel edge
docs: 300 dpi animations, tuned VP9 encoding, parallel rendering and audit fixes (#192)
* Render documentation animations at 300 DPI with a parallel pipeline
Raise the animation resolution from 800x450 to 2400x1350 (300 DPI, same
8x4.5 figure) so the clips stay crisp on high-density displays, and tune
the VP9 WebM encode (-tune-content screen -row-mt 1 -deadline good
-cpu-used 4) to roughly halve the encode time at the same file size. The
GitHub GIF fallback stays at 640 px.
Add a spawned process-pool renderer for the clips (one grouped task per
clip so each FDTD field is simulated once and reused across its four
language/theme variants), mirroring the figure runner and wired to the
existing --jobs flag; --anim single-clip re-renders and --jobs 1 stay
sequential.
Fold in a set of on-canvas readability fixes: Spanish decimal commas in
the FDTD time readouts, time and phase-caption labels repositioned clear
of tick labels and legends, a legible dark pill behind the ducting
channel-axis label, a mathtext L_W subscript in the two-rooms readout,
and the onset magnifier kept fully inside its panel.
* Re-render the documentation animations at 2400x1350
Regenerate every clip (WebM x four language/theme variants, EN GIF and
poster stills) at the new 300 DPI resolution with the tuned VP9 encode,
and refresh the posters at the matching intrinsic size.
* Link the high-resolution WebM under each docs GIF and resize site embeds
Add a one-line link to the high-resolution WebM of each clip beneath every
animation GIF in the GitHub-facing guides, and update the site <video>
embeds (EN + ES) to the new 2400x1350 intrinsic size. The GIF dimensions
are unchanged.
* docs: clamp the onset magnifier against the left panel edge
docs: 300 dpi animations, tuned VP9 encoding, parallel rendering and audit fixes (#192)
* Render documentation animations at 300 DPI with a parallel pipeline
Raise the animation resolution from 800x450 to 2400x1350 (300 DPI, same
8x4.5 figure) so the clips stay crisp on high-density displays, and tune
the VP9 WebM encode (-tune-content screen -row-mt 1 -deadline good
-cpu-used 4) to roughly halve the encode time at the same file size. The
GitHub GIF fallback stays at 640 px.
Add a spawned process-pool renderer for the clips (one grouped task per
clip so each FDTD field is simulated once and reused across its four
language/theme variants), mirroring the figure runner and wired to the
existing --jobs flag; --anim single-clip re-renders and --jobs 1 stay
sequential.
Fold in a set of on-canvas readability fixes: Spanish decimal commas in
the FDTD time readouts, time and phase-caption labels repositioned clear
of tick labels and legends, a legible dark pill behind the ducting
channel-axis label, a mathtext L_W subscript in the two-rooms readout,
and the onset magnifier kept fully inside its panel.
* Re-render the documentation animations at 2400x1350
Regenerate every clip (WebM x four language/theme variants, EN GIF and
poster stills) at the new 300 DPI resolution with the tuned VP9 encode,
and refresh the posters at the matching intrinsic size.
* Link the high-resolution WebM under each docs GIF and resize site embeds
Add a one-line link to the high-resolution WebM of each clip beneath every
animation GIF in the GitHub-facing guides, and update the site <video>
embeds (EN + ES) to the new 2400x1350 intrinsic size. The GIF dimensions
are unchanged.
* docs: clamp the onset magnifier against the left panel edge
docs: 300 dpi animations, tuned VP9 encoding, parallel rendering and audit fixes (#192)
* Render documentation animations at 300 DPI with a parallel pipeline
Raise the animation resolution from 800x450 to 2400x1350 (300 DPI, same
8x4.5 figure) so the clips stay crisp on high-density displays, and tune
the VP9 WebM encode (-tune-content screen -row-mt 1 -deadline good
-cpu-used 4) to roughly halve the encode time at the same file size. The
GitHub GIF fallback stays at 640 px.
Add a spawned process-pool renderer for the clips (one grouped task per
clip so each FDTD field is simulated once and reused across its four
language/theme variants), mirroring the figure runner and wired to the
existing --jobs flag; --anim single-clip re-renders and --jobs 1 stay
sequential.
Fold in a set of on-canvas readability fixes: Spanish decimal commas in
the FDTD time readouts, time and phase-caption labels repositioned clear
of tick labels and legends, a legible dark pill behind the ducting
channel-axis label, a mathtext L_W subscript in the two-rooms readout,
and the onset magnifier kept fully inside its panel.
* Re-render the documentation animations at 2400x1350
Regenerate every clip (WebM x four language/theme variants, EN GIF and
poster stills) at the new 300 DPI resolution with the tuned VP9 encode,
and refresh the posters at the matching intrinsic size.
* Link the high-resolution WebM under each docs GIF and resize site embeds
Add a one-line link to the high-resolution WebM of each clip beneath every
animation GIF in the GitHub-facing guides, and update the site <video>
embeds (EN + ES) to the new 2400x1350 intrinsic size. The GIF dimensions
are unchanged.
* docs: clamp the onset magnifier against the left panel edge
docs: 300 dpi animations, tuned VP9 encoding, parallel rendering and audit fixes (#192)
* Render documentation animations at 300 DPI with a parallel pipeline
Raise the animation resolution from 800x450 to 2400x1350 (300 DPI, same
8x4.5 figure) so the clips stay crisp on high-density displays, and tune
the VP9 WebM encode (-tune-content screen -row-mt 1 -deadline good
-cpu-used 4) to roughly halve the encode time at the same file size. The
GitHub GIF fallback stays at 640 px.
Add a spawned process-pool renderer for the clips (one grouped task per
clip so each FDTD field is simulated once and reused across its four
language/theme variants), mirroring the figure runner and wired to the
existing --jobs flag; --anim single-clip re-renders and --jobs 1 stay
sequential.
Fold in a set of on-canvas readability fixes: Spanish decimal commas in
the FDTD time readouts, time and phase-caption labels repositioned clear
of tick labels and legends, a legible dark pill behind the ducting
channel-axis label, a mathtext L_W subscript in the two-rooms readout,
and the onset magnifier kept fully inside its panel.
* Re-render the documentation animations at 2400x1350
Regenerate every clip (WebM x four language/theme variants, EN GIF and
poster stills) at the new 300 DPI resolution with the tuned VP9 encode,
and refresh the posters at the matching intrinsic size.
* Link the high-resolution WebM under each docs GIF and resize site embeds
Add a one-line link to the high-resolution WebM of each clip beneath every
animation GIF in the GitHub-facing guides, and update the site <video>
embeds (EN + ES) to the new 2400x1350 intrinsic size. The GIF dimensions
are unchanged.
* docs: clamp the onset magnifier against the left panel edge
docs: 300 dpi animations, tuned VP9 encoding, parallel rendering and audit fixes (#192)
* Render documentation animations at 300 DPI with a parallel pipeline
Raise the animation resolution from 800x450 to 2400x1350 (300 DPI, same
8x4.5 figure) so the clips stay crisp on high-density displays, and tune
the VP9 WebM encode (-tune-content screen -row-mt 1 -deadline good
-cpu-used 4) to roughly halve the encode time at the same file size. The
GitHub GIF fallback stays at 640 px.
Add a spawned process-pool renderer for the clips (one grouped task per
clip so each FDTD field is simulated once and reused across its four
language/theme variants), mirroring the figure runner and wired to the
existing --jobs flag; --anim single-clip re-renders and --jobs 1 stay
sequential.
Fold in a set of on-canvas readability fixes: Spanish decimal commas in
the FDTD time readouts, time and phase-caption labels repositioned clear
of tick labels and legends, a legible dark pill behind the ducting
channel-axis label, a mathtext L_W subscript in the two-rooms readout,
and the onset magnifier kept fully inside its panel.
* Re-render the documentation animations at 2400x1350
Regenerate every clip (WebM x four language/theme variants, EN GIF and
poster stills) at the new 300 DPI resolution with the tuned VP9 encode,
and refresh the posters at the matching intrinsic size.
* Link the high-resolution WebM under each docs GIF and resize site embeds
Add a one-line link to the high-resolution WebM of each clip beneath every
animation GIF in the GitHub-facing guides, and update the site <video>
embeds (EN + ES) to the new 2400x1350 intrinsic size. The GIF dimensions
are unchanged.
* docs: clamp the onset magnifier against the left panel edge
docs: 300 dpi animations, tuned VP9 encoding, parallel rendering and audit fixes (#192)
* Render documentation animations at 300 DPI with a parallel pipeline
Raise the animation resolution from 800x450 to 2400x1350 (300 DPI, same
8x4.5 figure) so the clips stay crisp on high-density displays, and tune
the VP9 WebM encode (-tune-content screen -row-mt 1 -deadline good
-cpu-used 4) to roughly halve the encode time at the same file size. The
GitHub GIF fallback stays at 640 px.
Add a spawned process-pool renderer for the clips (one grouped task per
clip so each FDTD field is simulated once and reused across its four
language/theme variants), mirroring the figure runner and wired to the
existing --jobs flag; --anim single-clip re-renders and --jobs 1 stay
sequential.
Fold in a set of on-canvas readability fixes: Spanish decimal commas in
the FDTD time readouts, time and phase-caption labels repositioned clear
of tick labels and legends, a legible dark pill behind the ducting
channel-axis label, a mathtext L_W subscript in the two-rooms readout,
and the onset magnifier kept fully inside its panel.
* Re-render the documentation animations at 2400x1350
Regenerate every clip (WebM x four language/theme variants, EN GIF and
poster stills) at the new 300 DPI resolution with the tuned VP9 encode,
and refresh the posters at the matching intrinsic size.
* Link the high-resolution WebM under each docs GIF and resize site embeds
Add a one-line link to the high-resolution WebM of each clip beneath every
animation GIF in the GitHub-facing guides, and update the site <video>
embeds (EN + ES) to the new 2400x1350 intrinsic size. The GIF dimensions
are unchanged.
* docs: clamp the onset magnifier against the left panel edge
docs: 300 dpi animations, tuned VP9 encoding, parallel rendering and audit fixes (#192)
* Render documentation animations at 300 DPI with a parallel pipeline
Raise the animation resolution from 800x450 to 2400x1350 (300 DPI, same
8x4.5 figure) so the clips stay crisp on high-density displays, and tune
the VP9 WebM encode (-tune-content screen -row-mt 1 -deadline good
-cpu-used 4) to roughly halve the encode time at the same file size. The
GitHub GIF fallback stays at 640 px.
Add a spawned process-pool renderer for the clips (one grouped task per
clip so each FDTD field is simulated once and reused across its four
language/theme variants), mirroring the figure runner and wired to the
existing --jobs flag; --anim single-clip re-renders and --jobs 1 stay
sequential.
Fold in a set of on-canvas readability fixes: Spanish decimal commas in
the FDTD time readouts, time and phase-caption labels repositioned clear
of tick labels and legends, a legible dark pill behind the ducting
channel-axis label, a mathtext L_W subscript in the two-rooms readout,
and the onset magnifier kept fully inside its panel.
* Re-render the documentation animations at 2400x1350
Regenerate every clip (WebM x four language/theme variants, EN GIF and
poster stills) at the new 300 DPI resolution with the tuned VP9 encode,
and refresh the posters at the matching intrinsic size.
* Link the high-resolution WebM under each docs GIF and resize site embeds
Add a one-line link to the high-resolution WebM of each clip beneath every
animation GIF in the GitHub-facing guides, and update the site <video>
embeds (EN + ES) to the new 2400x1350 intrinsic size. The GIF dimensions
are unchanged.
* docs: clamp the onset magnifier against the left panel edge
docs: 300 dpi animations, tuned VP9 encoding, parallel rendering and audit fixes (#192)
* Render documentation animations at 300 DPI with a parallel pipeline
Raise the animation resolution from 800x450 to 2400x1350 (300 DPI, same
8x4.5 figure) so the clips stay crisp on high-density displays, and tune
the VP9 WebM encode (-tune-content screen -row-mt 1 -deadline good
-cpu-used 4) to roughly halve the encode time at the same file size. The
GitHub GIF fallback stays at 640 px.
Add a spawned process-pool renderer for the clips (one grouped task per
clip so each FDTD field is simulated once and reused across its four
language/theme variants), mirroring the figure runner and wired to the
existing --jobs flag; --anim single-clip re-renders and --jobs 1 stay
sequential.
Fold in a set of on-canvas readability fixes: Spanish decimal commas in
the FDTD time readouts, time and phase-caption labels repositioned clear
of tick labels and legends, a legible dark pill behind the ducting
channel-axis label, a mathtext L_W subscript in the two-rooms readout,
and the onset magnifier kept fully inside its panel.
* Re-render the documentation animations at 2400x1350
Regenerate every clip (WebM x four language/theme variants, EN GIF and
poster stills) at the new 300 DPI resolution with the tuned VP9 encode,
and refresh the posters at the matching intrinsic size.
* Link the high-resolution WebM under each docs GIF and resize site embeds
Add a one-line link to the high-resolution WebM of each clip beneath every
animation GIF in the GitHub-facing guides, and update the site <video>
embeds (EN + ES) to the new 2400x1350 intrinsic size. The GIF dimensions
are unchanged.
* docs: clamp the onset magnifier against the left panel edge
docs: 300 dpi animations, tuned VP9 encoding, parallel rendering and audit fixes (#192)
* Render documentation animations at 300 DPI with a parallel pipeline
Raise the animation resolution from 800x450 to 2400x1350 (300 DPI, same
8x4.5 figure) so the clips stay crisp on high-density displays, and tune
the VP9 WebM encode (-tune-content screen -row-mt 1 -deadline good
-cpu-used 4) to roughly halve the encode time at the same file size. The
GitHub GIF fallback stays at 640 px.
Add a spawned process-pool renderer for the clips (one grouped task per
clip so each FDTD field is simulated once and reused across its four
language/theme variants), mirroring the figure runner and wired to the
existing --jobs flag; --anim single-clip re-renders and --jobs 1 stay
sequential.
Fold in a set of on-canvas readability fixes: Spanish decimal commas in
the FDTD time readouts, time and phase-caption labels repositioned clear
of tick labels and legends, a legible dark pill behind the ducting
channel-axis label, a mathtext L_W subscript in the two-rooms readout,
and the onset magnifier kept fully inside its panel.
* Re-render the documentation animations at 2400x1350
Regenerate every clip (WebM x four language/theme variants, EN GIF and
poster stills) at the new 300 DPI resolution with the tuned VP9 encode,
and refresh the posters at the matching intrinsic size.
* Link the high-resolution WebM under each docs GIF and resize site embeds
Add a one-line link to the high-resolution WebM of each clip beneath every
animation GIF in the GitHub-facing guides, and update the site <video>
embeds (EN + ES) to the new 2400x1350 intrinsic size. The GIF dimensions
are unchanged.
* docs: clamp the onset magnifier against the left panel edge
docs: 300 dpi animations, tuned VP9 encoding, parallel rendering and audit fixes (#192)
* Render documentation animations at 300 DPI with a parallel pipeline
Raise the animation resolution from 800x450 to 2400x1350 (300 DPI, same
8x4.5 figure) so the clips stay crisp on high-density displays, and tune
the VP9 WebM encode (-tune-content screen -row-mt 1 -deadline good
-cpu-used 4) to roughly halve the encode time at the same file size. The
GitHub GIF fallback stays at 640 px.
Add a spawned process-pool renderer for the clips (one grouped task per
clip so each FDTD field is simulated once and reused across its four
language/theme variants), mirroring the figure runner and wired to the
existing --jobs flag; --anim single-clip re-renders and --jobs 1 stay
sequential.
Fold in a set of on-canvas readability fixes: Spanish decimal commas in
the FDTD time readouts, time and phase-caption labels repositioned clear
of tick labels and legends, a legible dark pill behind the ducting
channel-axis label, a mathtext L_W subscript in the two-rooms readout,
and the onset magnifier kept fully inside its panel.
* Re-render the documentation animations at 2400x1350
Regenerate every clip (WebM x four language/theme variants, EN GIF and
poster stills) at the new 300 DPI resolution with the tuned VP9 encode,
and refresh the posters at the matching intrinsic size.
* Link the high-resolution WebM under each docs GIF and resize site embeds
Add a one-line link to the high-resolution WebM of each clip beneath every
animation GIF in the GitHub-facing guides, and update the site <video>
embeds (EN + ES) to the new 2400x1350 intrinsic size. The GIF dimensions
are unchanged.
* docs: clamp the onset magnifier against the left panel edge
docs: 300 dpi animations, tuned VP9 encoding, parallel rendering and audit fixes (#192)
* Render documentation animations at 300 DPI with a parallel pipeline
Raise the animation resolution from 800x450 to 2400x1350 (300 DPI, same
8x4.5 figure) so the clips stay crisp on high-density displays, and tune
the VP9 WebM encode (-tune-content screen -row-mt 1 -deadline good
-cpu-used 4) to roughly halve the encode time at the same file size. The
GitHub GIF fallback stays at 640 px.
Add a spawned process-pool renderer for the clips (one grouped task per
clip so each FDTD field is simulated once and reused across its four
language/theme variants), mirroring the figure runner and wired to the
existing --jobs flag; --anim single-clip re-renders and --jobs 1 stay
sequential.
Fold in a set of on-canvas readability fixes: Spanish decimal commas in
the FDTD time readouts, time and phase-caption labels repositioned clear
of tick labels and legends, a legible dark pill behind the ducting
channel-axis label, a mathtext L_W subscript in the two-rooms readout,
and the onset magnifier kept fully inside its panel.
* Re-render the documentation animations at 2400x1350
Regenerate every clip (WebM x four language/theme variants, EN GIF and
poster stills) at the new 300 DPI resolution with the tuned VP9 encode,
and refresh the posters at the matching intrinsic size.
* Link the high-resolution WebM under each docs GIF and resize site embeds
Add a one-line link to the high-resolution WebM of each clip beneath every
animation GIF in the GitHub-facing guides, and update the site <video>
embeds (EN + ES) to the new 2400x1350 intrinsic size. The GIF dimensions
are unchanged.
* docs: clamp the onset magnifier against the left panel edge
docs: 300 dpi animations, tuned VP9 encoding, parallel rendering and audit fixes (#192)
* Render documentation animations at 300 DPI with a parallel pipeline
Raise the animation resolution from 800x450 to 2400x1350 (300 DPI, same
8x4.5 figure) so the clips stay crisp on high-density displays, and tune
the VP9 WebM encode (-tune-content screen -row-mt 1 -deadline good
-cpu-used 4) to roughly halve the encode time at the same file size. The
GitHub GIF fallback stays at 640 px.
Add a spawned process-pool renderer for the clips (one grouped task per
clip so each FDTD field is simulated once and reused across its four
language/theme variants), mirroring the figure runner and wired to the
existing --jobs flag; --anim single-clip re-renders and --jobs 1 stay
sequential.
Fold in a set of on-canvas readability fixes: Spanish decimal commas in
the FDTD time readouts, time and phase-caption labels repositioned clear
of tick labels and legends, a legible dark pill behind the ducting
channel-axis label, a mathtext L_W subscript in the two-rooms readout,
and the onset magnifier kept fully inside its panel.
* Re-render the documentation animations at 2400x1350
Regenerate every clip (WebM x four language/theme variants, EN GIF and
poster stills) at the new 300 DPI resolution with the tuned VP9 encode,
and refresh the posters at the matching intrinsic size.
* Link the high-resolution WebM under each docs GIF and resize site embeds
Add a one-line link to the high-resolution WebM of each clip beneath every
animation GIF in the GitHub-facing guides, and update the site <video>
embeds (EN + ES) to the new 2400x1350 intrinsic size. The GIF dimensions
are unchanged.
* docs: clamp the onset magnifier against the left panel edge
docs: 300 dpi animations, tuned VP9 encoding, parallel rendering and audit fixes (#192)
* Render documentation animations at 300 DPI with a parallel pipeline
Raise the animation resolution from 800x450 to 2400x1350 (300 DPI, same
8x4.5 figure) so the clips stay crisp on high-density displays, and tune
the VP9 WebM encode (-tune-content screen -row-mt 1 -deadline good
-cpu-used 4) to roughly halve the encode time at the same file size. The
GitHub GIF fallback stays at 640 px.
Add a spawned process-pool renderer for the clips (one grouped task per
clip so each FDTD field is simulated once and reused across its four
language/theme variants), mirroring the figure runner and wired to the
existing --jobs flag; --anim single-clip re-renders and --jobs 1 stay
sequential.
Fold in a set of on-canvas readability fixes: Spanish decimal commas in
the FDTD time readouts, time and phase-caption labels repositioned clear
of tick labels and legends, a legible dark pill behind the ducting
channel-axis label, a mathtext L_W subscript in the two-rooms readout,
and the onset magnifier kept fully inside its panel.
* Re-render the documentation animations at 2400x1350
Regenerate every clip (WebM x four language/theme variants, EN GIF and
poster stills) at the new 300 DPI resolution with the tuned VP9 encode,
and refresh the posters at the matching intrinsic size.
* Link the high-resolution WebM under each docs GIF and resize site embeds
Add a one-line link to the high-resolution WebM of each clip beneath every
animation GIF in the GitHub-facing guides, and update the site <video>
embeds (EN + ES) to the new 2400x1350 intrinsic size. The GIF dimensions
are unchanged.
* docs: clamp the onset magnifier against the left panel edge
docs: 300 dpi animations, tuned VP9 encoding, parallel rendering and audit fixes (#192)
* Render documentation animations at 300 DPI with a parallel pipeline
Raise the animation resolution from 800x450 to 2400x1350 (300 DPI, same
8x4.5 figure) so the clips stay crisp on high-density displays, and tune
the VP9 WebM encode (-tune-content screen -row-mt 1 -deadline good
-cpu-used 4) to roughly halve the encode time at the same file size. The
GitHub GIF fallback stays at 640 px.
Add a spawned process-pool renderer for the clips (one grouped task per
clip so each FDTD field is simulated once and reused across its four
language/theme variants), mirroring the figure runner and wired to the
existing --jobs flag; --anim single-clip re-renders and --jobs 1 stay
sequential.
Fold in a set of on-canvas readability fixes: Spanish decimal commas in
the FDTD time readouts, time and phase-caption labels repositioned clear
of tick labels and legends, a legible dark pill behind the ducting
channel-axis label, a mathtext L_W subscript in the two-rooms readout,
and the onset magnifier kept fully inside its panel.
* Re-render the documentation animations at 2400x1350
Regenerate every clip (WebM x four language/theme variants, EN GIF and
poster stills) at the new 300 DPI resolution with the tuned VP9 encode,
and refresh the posters at the matching intrinsic size.
* Link the high-resolution WebM under each docs GIF and resize site embeds
Add a one-line link to the high-resolution WebM of each clip beneath every
animation GIF in the GitHub-facing guides, and update the site <video>
embeds (EN + ES) to the new 2400x1350 intrinsic size. The GIF dimensions
are unchanged.
* docs: clamp the onset magnifier against the left panel edge
docs: 300 dpi animations, tuned VP9 encoding, parallel rendering and audit fixes (#192)
* Render documentation animations at 300 DPI with a parallel pipeline
Raise the animation resolution from 800x450 to 2400x1350 (300 DPI, same
8x4.5 figure) so the clips stay crisp on high-density displays, and tune
the VP9 WebM encode (-tune-content screen -row-mt 1 -deadline good
-cpu-used 4) to roughly halve the encode time at the same file size. The
GitHub GIF fallback stays at 640 px.
Add a spawned process-pool renderer for the clips (one grouped task per
clip so each FDTD field is simulated once and reused across its four
language/theme variants), mirroring the figure runner and wired to the
existing --jobs flag; --anim single-clip re-renders and --jobs 1 stay
sequential.
Fold in a set of on-canvas readability fixes: Spanish decimal commas in
the FDTD time readouts, time and phase-caption labels repositioned clear
of tick labels and legends, a legible dark pill behind the ducting
channel-axis label, a mathtext L_W subscript in the two-rooms readout,
and the onset magnifier kept fully inside its panel.
* Re-render the documentation animations at 2400x1350
Regenerate every clip (WebM x four language/theme variants, EN GIF and
poster stills) at the new 300 DPI resolution with the tuned VP9 encode,
and refresh the posters at the matching intrinsic size.
* Link the high-resolution WebM under each docs GIF and resize site embeds
Add a one-line link to the high-resolution WebM of each clip beneath every
animation GIF in the GitHub-facing guides, and update the site <video>
embeds (EN + ES) to the new 2400x1350 intrinsic size. The GIF dimensions
are unchanged.
* docs: clamp the onset magnifier against the left panel edge
docs: 300 dpi animations, tuned VP9 encoding, parallel rendering and audit fixes (#192)
* Render documentation animations at 300 DPI with a parallel pipeline
Raise the animation resolution from 800x450 to 2400x1350 (300 DPI, same
8x4.5 figure) so the clips stay crisp on high-density displays, and tune
the VP9 WebM encode (-tune-content screen -row-mt 1 -deadline good
-cpu-used 4) to roughly halve the encode time at the same file size. The
GitHub GIF fallback stays at 640 px.
Add a spawned process-pool renderer for the clips (one grouped task per
clip so each FDTD field is simulated once and reused across its four
language/theme variants), mirroring the figure runner and wired to the
existing --jobs flag; --anim single-clip re-renders and --jobs 1 stay
sequential.
Fold in a set of on-canvas readability fixes: Spanish decimal commas in
the FDTD time readouts, time and phase-caption labels repositioned clear
of tick labels and legends, a legible dark pill behind the ducting
channel-axis label, a mathtext L_W subscript in the two-rooms readout,
and the onset magnifier kept fully inside its panel.
* Re-render the documentation animations at 2400x1350
Regenerate every clip (WebM x four language/theme variants, EN GIF and
poster stills) at the new 300 DPI resolution with the tuned VP9 encode,
and refresh the posters at the matching intrinsic size.
* Link the high-resolution WebM under each docs GIF and resize site embeds
Add a one-line link to the high-resolution WebM of each clip beneath every
animation GIF in the GitHub-facing guides, and update the site <video>
embeds (EN + ES) to the new 2400x1350 intrinsic size. The GIF dimensions
are unchanged.
* docs: clamp the onset magnifier against the left panel edge
docs: 300 dpi animations, tuned VP9 encoding, parallel rendering and audit fixes (#192)
* Render documentation animations at 300 DPI with a parallel pipeline
Raise the animation resolution from 800x450 to 2400x1350 (300 DPI, same
8x4.5 figure) so the clips stay crisp on high-density displays, and tune
the VP9 WebM encode (-tune-content screen -row-mt 1 -deadline good
-cpu-used 4) to roughly halve the encode time at the same file size. The
GitHub GIF fallback stays at 640 px.
Add a spawned process-pool renderer for the clips (one grouped task per
clip so each FDTD field is simulated once and reused across its four
language/theme variants), mirroring the figure runner and wired to the
existing --jobs flag; --anim single-clip re-renders and --jobs 1 stay
sequential.
Fold in a set of on-canvas readability fixes: Spanish decimal commas in
the FDTD time readouts, time and phase-caption labels repositioned clear
of tick labels and legends, a legible dark pill behind the ducting
channel-axis label, a mathtext L_W subscript in the two-rooms readout,
and the onset magnifier kept fully inside its panel.
* Re-render the documentation animations at 2400x1350
Regenerate every clip (WebM x four language/theme variants, EN GIF and
poster stills) at the new 300 DPI resolution with the tuned VP9 encode,
and refresh the posters at the matching intrinsic size.
* Link the high-resolution WebM under each docs GIF and resize site embeds
Add a one-line link to the high-resolution WebM of each clip beneath every
animation GIF in the GitHub-facing guides, and update the site <video>
embeds (EN + ES) to the new 2400x1350 intrinsic size. The GIF dimensions
are unchanged.
* docs: clamp the onset magnifier against the left panel edge
docs: 300 dpi animations, tuned VP9 encoding, parallel rendering and audit fixes (#192)
* Render documentation animations at 300 DPI with a parallel pipeline
Raise the animation resolution from 800x450 to 2400x1350 (300 DPI, same
8x4.5 figure) so the clips stay crisp on high-density displays, and tune
the VP9 WebM encode (-tune-content screen -row-mt 1 -deadline good
-cpu-used 4) to roughly halve the encode time at the same file size. The
GitHub GIF fallback stays at 640 px.
Add a spawned process-pool renderer for the clips (one grouped task per
clip so each FDTD field is simulated once and reused across its four
language/theme variants), mirroring the figure runner and wired to the
existing --jobs flag; --anim single-clip re-renders and --jobs 1 stay
sequential.
Fold in a set of on-canvas readability fixes: Spanish decimal commas in
the FDTD time readouts, time and phase-caption labels repositioned clear
of tick labels and legends, a legible dark pill behind the ducting
channel-axis label, a mathtext L_W subscript in the two-rooms readout,
and the onset magnifier kept fully inside its panel.
* Re-render the documentation animations at 2400x1350
Regenerate every clip (WebM x four language/theme variants, EN GIF and
poster stills) at the new 300 DPI resolution with the tuned VP9 encode,
and refresh the posters at the matching intrinsic size.
* Link the high-resolution WebM under each docs GIF and resize site embeds
Add a one-line link to the high-resolution WebM of each clip beneath every
animation GIF in the GitHub-facing guides, and update the site <video>
embeds (EN + ES) to the new 2400x1350 intrinsic size. The GIF dimensions
are unchanged.
* docs: clamp the onset magnifier against the left panel edge
docs: 300 dpi animations, tuned VP9 encoding, parallel rendering and audit fixes (#192)
* Render documentation animations at 300 DPI with a parallel pipeline
Raise the animation resolution from 800x450 to 2400x1350 (300 DPI, same
8x4.5 figure) so the clips stay crisp on high-density displays, and tune
the VP9 WebM encode (-tune-content screen -row-mt 1 -deadline good
-cpu-used 4) to roughly halve the encode time at the same file size. The
GitHub GIF fallback stays at 640 px.
Add a spawned process-pool renderer for the clips (one grouped task per
clip so each FDTD field is simulated once and reused across its four
language/theme variants), mirroring the figure runner and wired to the
existing --jobs flag; --anim single-clip re-renders and --jobs 1 stay
sequential.
Fold in a set of on-canvas readability fixes: Spanish decimal commas in
the FDTD time readouts, time and phase-caption labels repositioned clear
of tick labels and legends, a legible dark pill behind the ducting
channel-axis label, a mathtext L_W subscript in the two-rooms readout,
and the onset magnifier kept fully inside its panel.
* Re-render the documentation animations at 2400x1350
Regenerate every clip (WebM x four language/theme variants, EN GIF and
poster stills) at the new 300 DPI resolution with the tuned VP9 encode,
and refresh the posters at the matching intrinsic size.
* Link the high-resolution WebM under each docs GIF and resize site embeds
Add a one-line link to the high-resolution WebM of each clip beneath every
animation GIF in the GitHub-facing guides, and update the site <video>
embeds (EN + ES) to the new 2400x1350 intrinsic size. The GIF dimensions
are unchanged.
* docs: clamp the onset magnifier against the left panel edge
Environment and underwater guides: figures, model-selection prose and mirror sync (#362)
* Add atmospheric-refraction and barrier insertion-loss documentation figures
Four new deterministic figures in the four language/theme variants:
the log-linear effective sound-speed profiles (downward vs upward
refraction), the downward-refraction ray fan, the GFPE relative level
versus range at the receiver height for three atmospheres, and the
Kurze-Anderson / exact half-plane / coherent-ground barrier
insertion-loss comparison on the guide geometry.
* Environment and underwater guides: figures embedded, model-selection prose, mirror sync
Embed the new figures with reproducible code blocks in the
atmospheric-refraction and ground-and-barriers pages (EN, ES and the
docs mirrors) and add the missing .plot() one-liners next to every
plottable snippet, including the outdoor-propagation usage and report
examples.
Prose: a when-does-refraction-matter introduction for the
atmospheric-refraction guide (Attenborough & Van Renterghem 2021,
Ch. 11); a Choosing-a-model section for the underwater-propagation
guide covering the validity ranges of the UNESCO / Del Grosso /
Mackenzie sound-speed equations and the Francois-Garrison /
Ainslie-McColm / Thorp absorption models, spreading-law guidance, the
ray / normal-mode / parabolic-equation selection table after Jensen
et al. (2011, Ch. 1) and a worked passive-sonar budget; and, for the
underwater-acoustics guide, the ISO 17208-1 measurement discipline
(CPA distance, +/-30 degree data window, four runs, averaging chain)
and the ISO 18406 regulatory context (scope, the 750 m reference
position) behind the closed forms.
Mirror sync: the outdoor-propagation docs mirror gains the missing
Prediction reports section, the ground-barriers and
atmospheric-refraction docs mirrors gain the figure code blocks, and
the ES mirrors are updated with equivalent text (decimal commas fixed
in three stray values). ISO 18405 added to the underwater-propagation
references; llms-full.txt regenerated.
* Fix the porous-absorbers link in the ground-barriers docs mirror and a stray comment label
* Regenerate llms-full.txt after the docs link fix
* Address review notes: shadow boundary in PE snippets, solver wording, Fresnel decades, barrier legend
The atmospheric_pe_range figure snippets now draw the closed-form
shadow-zone boundary they show; the underwater solver table describes
normal_modes as a finite-difference modal sum and the PE as marching
the range-independent profile all three solvers assume; the barrier
comparison claim is corrected to two decades of Fresnel number; and
the 5 dB grazing line is relabelled as the Kurze-Anderson limit in the
figure (regenerated, all four variants), the snippets and the alt
texts. llms-full.txt regenerated.
Environment and underwater guides: figures, model-selection prose and mirror sync (#362)
* Add atmospheric-refraction and barrier insertion-loss documentation figures
Four new deterministic figures in the four language/theme variants:
the log-linear effective sound-speed profiles (downward vs upward
refraction), the downward-refraction ray fan, the GFPE relative level
versus range at the receiver height for three atmospheres, and the
Kurze-Anderson / exact half-plane / coherent-ground barrier
insertion-loss comparison on the guide geometry.
* Environment and underwater guides: figures embedded, model-selection prose, mirror sync
Embed the new figures with reproducible code blocks in the
atmospheric-refraction and ground-and-barriers pages (EN, ES and the
docs mirrors) and add the missing .plot() one-liners next to every
plottable snippet, including the outdoor-propagation usage and report
examples.
Prose: a when-does-refraction-matter introduction for the
atmospheric-refraction guide (Attenborough & Van Renterghem 2021,
Ch. 11); a Choosing-a-model section for the underwater-propagation
guide covering the validity ranges of the UNESCO / Del Grosso /
Mackenzie sound-speed equations and the Francois-Garrison /
Ainslie-McColm / Thorp absorption models, spreading-law guidance, the
ray / normal-mode / parabolic-equation selection table after Jensen
et al. (2011, Ch. 1) and a worked passive-sonar budget; and, for the
underwater-acoustics guide, the ISO 17208-1 measurement discipline
(CPA distance, +/-30 degree data window, four runs, averaging chain)
and the ISO 18406 regulatory context (scope, the 750 m reference
position) behind the closed forms.
Mirror sync: the outdoor-propagation docs mirror gains the missing
Prediction reports section, the ground-barriers and
atmospheric-refraction docs mirrors gain the figure code blocks, and
the ES mirrors are updated with equivalent text (decimal commas fixed
in three stray values). ISO 18405 added to the underwater-propagation
references; llms-full.txt regenerated.
* Fix the porous-absorbers link in the ground-barriers docs mirror and a stray comment label
* Regenerate llms-full.txt after the docs link fix
* Address review notes: shadow boundary in PE snippets, solver wording, Fresnel decades, barrier legend
The atmospheric_pe_range figure snippets now draw the closed-form
shadow-zone boundary they show; the underwater solver table describes
normal_modes as a finite-difference modal sum and the PE as marching
the range-independent profile all three solvers assume; the barrier
comparison claim is corrected to two decades of Fresnel number; and
the 5 dB grazing line is relabelled as the Kurze-Anderson limit in the
figure (regenerated, all four variants), the snippets and the alt
texts. llms-full.txt regenerated.
Environment and underwater guides: figures, model-selection prose and mirror sync (#362)
* Add atmospheric-refraction and barrier insertion-loss documentation figures
Four new deterministic figures in the four language/theme variants:
the log-linear effective sound-speed profiles (downward vs upward
refraction), the downward-refraction ray fan, the GFPE relative level
versus range at the receiver height for three atmospheres, and the
Kurze-Anderson / exact half-plane / coherent-ground barrier
insertion-loss comparison on the guide geometry.
* Environment and underwater guides: figures embedded, model-selection prose, mirror sync
Embed the new figures with reproducible code blocks in the
atmospheric-refraction and ground-and-barriers pages (EN, ES and the
docs mirrors) and add the missing .plot() one-liners next to every
plottable snippet, including the outdoor-propagation usage and report
examples.
Prose: a when-does-refraction-matter introduction for the
atmospheric-refraction guide (Attenborough & Van Renterghem 2021,
Ch. 11); a Choosing-a-model section for the underwater-propagation
guide covering the validity ranges of the UNESCO / Del Grosso /
Mackenzie sound-speed equations and the Francois-Garrison /
Ainslie-McColm / Thorp absorption models, spreading-law guidance, the
ray / normal-mode / parabolic-equation selection table after Jensen
et al. (2011, Ch. 1) and a worked passive-sonar budget; and, for the
underwater-acoustics guide, the ISO 17208-1 measurement discipline
(CPA distance, +/-30 degree data window, four runs, averaging chain)
and the ISO 18406 regulatory context (scope, the 750 m reference
position) behind the closed forms.
Mirror sync: the outdoor-propagation docs mirror gains the missing
Prediction reports section, the ground-barriers and
atmospheric-refraction docs mirrors gain the figure code blocks, and
the ES mirrors are updated with equivalent text (decimal commas fixed
in three stray values). ISO 18405 added to the underwater-propagation
references; llms-full.txt regenerated.
* Fix the porous-absorbers link in the ground-barriers docs mirror and a stray comment label
* Regenerate llms-full.txt after the docs link fix
* Address review notes: shadow boundary in PE snippets, solver wording, Fresnel decades, barrier legend
The atmospheric_pe_range figure snippets now draw the closed-form
shadow-zone boundary they show; the underwater solver table describes
normal_modes as a finite-difference modal sum and the PE as marching
the range-independent profile all three solvers assume; the barrier
comparison claim is corrected to two decades of Fresnel number; and
the 5 dB grazing line is relabelled as the Kurze-Anderson limit in the
figure (regenerated, all four variants), the snippets and the alt
texts. llms-full.txt regenerated.
Environment and underwater guides: figures, model-selection prose and mirror sync (#362)
* Add atmospheric-refraction and barrier insertion-loss documentation figures
Four new deterministic figures in the four language/theme variants:
the log-linear effective sound-speed profiles (downward vs upward
refraction), the downward-refraction ray fan, the GFPE relative level
versus range at the receiver height for three atmospheres, and the
Kurze-Anderson / exact half-plane / coherent-ground barrier
insertion-loss comparison on the guide geometry.
* Environment and underwater guides: figures embedded, model-selection prose, mirror sync
Embed the new figures with reproducible code blocks in the
atmospheric-refraction and ground-and-barriers pages (EN, ES and the
docs mirrors) and add the missing .plot() one-liners next to every
plottable snippet, including the outdoor-propagation usage and report
examples.
Prose: a when-does-refraction-matter introduction for the
atmospheric-refraction guide (Attenborough & Van Renterghem 2021,
Ch. 11); a Choosing-a-model section for the underwater-propagation
guide covering the validity ranges of the UNESCO / Del Grosso /
Mackenzie sound-speed equations and the Francois-Garrison /
Ainslie-McColm / Thorp absorption models, spreading-law guidance, the
ray / normal-mode / parabolic-equation selection table after Jensen
et al. (2011, Ch. 1) and a worked passive-sonar budget; and, for the
underwater-acoustics guide, the ISO 17208-1 measurement discipline
(CPA distance, +/-30 degree data window, four runs, averaging chain)
and the ISO 18406 regulatory context (scope, the 750 m reference
position) behind the closed forms.
Mirror sync: the outdoor-propagation docs mirror gains the missing
Prediction reports section, the ground-barriers and
atmospheric-refraction docs mirrors gain the figure code blocks, and
the ES mirrors are updated with equivalent text (decimal commas fixed
in three stray values). ISO 18405 added to the underwater-propagation
references; llms-full.txt regenerated.
* Fix the porous-absorbers link in the ground-barriers docs mirror and a stray comment label
* Regenerate llms-full.txt after the docs link fix
* Address review notes: shadow boundary in PE snippets, solver wording, Fresnel decades, barrier legend
The atmospheric_pe_range figure snippets now draw the closed-form
shadow-zone boundary they show; the underwater solver table describes
normal_modes as a finite-difference modal sum and the PE as marching
the range-independent profile all three solvers assume; the barrier
comparison claim is corrected to two decades of Fresnel number; and
the 5 dB grazing line is relabelled as the Kurze-Anderson limit in the
figure (regenerated, all four variants), the snippets and the alt
texts. llms-full.txt regenerated.
Environment and underwater guides: figures, model-selection prose and mirror sync (#362)
* Add atmospheric-refraction and barrier insertion-loss documentation figures
Four new deterministic figures in the four language/theme variants:
the log-linear effective sound-speed profiles (downward vs upward
refraction), the downward-refraction ray fan, the GFPE relative level
versus range at the receiver height for three atmospheres, and the
Kurze-Anderson / exact half-plane / coherent-ground barrier
insertion-loss comparison on the guide geometry.
* Environment and underwater guides: figures embedded, model-selection prose, mirror sync
Embed the new figures with reproducible code blocks in the
atmospheric-refraction and ground-and-barriers pages (EN, ES and the
docs mirrors) and add the missing .plot() one-liners next to every
plottable snippet, including the outdoor-propagation usage and report
examples.
Prose: a when-does-refraction-matter introduction for the
atmospheric-refraction guide (Attenborough & Van Renterghem 2021,
Ch. 11); a Choosing-a-model section for the underwater-propagation
guide covering the validity ranges of the UNESCO / Del Grosso /
Mackenzie sound-speed equations and the Francois-Garrison /
Ainslie-McColm / Thorp absorption models, spreading-law guidance, the
ray / normal-mode / parabolic-equation selection table after Jensen
et al. (2011, Ch. 1) and a worked passive-sonar budget; and, for the
underwater-acoustics guide, the ISO 17208-1 measurement discipline
(CPA distance, +/-30 degree data window, four runs, averaging chain)
and the ISO 18406 regulatory context (scope, the 750 m reference
position) behind the closed forms.
Mirror sync: the outdoor-propagation docs mirror gains the missing
Prediction reports section, the ground-barriers and
atmospheric-refraction docs mirrors gain the figure code blocks, and
the ES mirrors are updated with equivalent text (decimal commas fixed
in three stray values). ISO 18405 added to the underwater-propagation
references; llms-full.txt regenerated.
* Fix the porous-absorbers link in the ground-barriers docs mirror and a stray comment label
* Regenerate llms-full.txt after the docs link fix
* Address review notes: shadow boundary in PE snippets, solver wording, Fresnel decades, barrier legend
The atmospheric_pe_range figure snippets now draw the closed-form
shadow-zone boundary they show; the underwater solver table describes
normal_modes as a finite-difference modal sum and the PE as marching
the range-independent profile all three solvers assume; the barrier
comparison claim is corrected to two decades of Fresnel number; and
the 5 dB grazing line is relabelled as the Kurze-Anderson limit in the
figure (regenerated, all four variants), the snippets and the alt
texts. llms-full.txt regenerated.
Environment and underwater guides: figures, model-selection prose and mirror sync (#362)
* Add atmospheric-refraction and barrier insertion-loss documentation figures
Four new deterministic figures in the four language/theme variants:
the log-linear effective sound-speed profiles (downward vs upward
refraction), the downward-refraction ray fan, the GFPE relative level
versus range at the receiver height for three atmospheres, and the
Kurze-Anderson / exact half-plane / coherent-ground barrier
insertion-loss comparison on the guide geometry.
* Environment and underwater guides: figures embedded, model-selection prose, mirror sync
Embed the new figures with reproducible code blocks in the
atmospheric-refraction and ground-and-barriers pages (EN, ES and the
docs mirrors) and add the missing .plot() one-liners next to every
plottable snippet, including the outdoor-propagation usage and report
examples.
Prose: a when-does-refraction-matter introduction for the
atmospheric-refraction guide (Attenborough & Van Renterghem 2021,
Ch. 11); a Choosing-a-model section for the underwater-propagation
guide covering the validity ranges of the UNESCO / Del Grosso /
Mackenzie sound-speed equations and the Francois-Garrison /
Ainslie-McColm / Thorp absorption models, spreading-law guidance, the
ray / normal-mode / parabolic-equation selection table after Jensen
et al. (2011, Ch. 1) and a worked passive-sonar budget; and, for the
underwater-acoustics guide, the ISO 17208-1 measurement discipline
(CPA distance, +/-30 degree data window, four runs, averaging chain)
and the ISO 18406 regulatory context (scope, the 750 m reference
position) behind the closed forms.
Mirror sync: the outdoor-propagation docs mirror gains the missing
Prediction reports section, the ground-barriers and
atmospheric-refraction docs mirrors gain the figure code blocks, and
the ES mirrors are updated with equivalent text (decimal commas fixed
in three stray values). ISO 18405 added to the underwater-propagation
references; llms-full.txt regenerated.
* Fix the porous-absorbers link in the ground-barriers docs mirror and a stray comment label
* Regenerate llms-full.txt after the docs link fix
* Address review notes: shadow boundary in PE snippets, solver wording, Fresnel decades, barrier legend
The atmospheric_pe_range figure snippets now draw the closed-form
shadow-zone boundary they show; the underwater solver table describes
normal_modes as a finite-difference modal sum and the PE as marching
the range-independent profile all three solvers assume; the barrier
comparison claim is corrected to two decades of Fresnel number; and
the 5 dB grazing line is relabelled as the Kurze-Anderson limit in the
figure (regenerated, all four variants), the snippets and the alt
texts. llms-full.txt regenerated.
Environment and underwater guides: figures, model-selection prose and mirror sync (#362)
* Add atmospheric-refraction and barrier insertion-loss documentation figures
Four new deterministic figures in the four language/theme variants:
the log-linear effective sound-speed profiles (downward vs upward
refraction), the downward-refraction ray fan, the GFPE relative level
versus range at the receiver height for three atmospheres, and the
Kurze-Anderson / exact half-plane / coherent-ground barrier
insertion-loss comparison on the guide geometry.
* Environment and underwater guides: figures embedded, model-selection prose, mirror sync
Embed the new figures with reproducible code blocks in the
atmospheric-refraction and ground-and-barriers pages (EN, ES and the
docs mirrors) and add the missing .plot() one-liners next to every
plottable snippet, including the outdoor-propagation usage and report
examples.
Prose: a when-does-refraction-matter introduction for the
atmospheric-refraction guide (Attenborough & Van Renterghem 2021,
Ch. 11); a Choosing-a-model section for the underwater-propagation
guide covering the validity ranges of the UNESCO / Del Grosso /
Mackenzie sound-speed equations and the Francois-Garrison /
Ainslie-McColm / Thorp absorption models, spreading-law guidance, the
ray / normal-mode / parabolic-equation selection table after Jensen
et al. (2011, Ch. 1) and a worked passive-sonar budget; and, for the
underwater-acoustics guide, the ISO 17208-1 measurement discipline
(CPA distance, +/-30 degree data window, four runs, averaging chain)
and the ISO 18406 regulatory context (scope, the 750 m reference
position) behind the closed forms.
Mirror sync: the outdoor-propagation docs mirror gains the missing
Prediction reports section, the ground-barriers and
atmospheric-refraction docs mirrors gain the figure code blocks, and
the ES mirrors are updated with equivalent text (decimal commas fixed
in three stray values). ISO 18405 added to the underwater-propagation
references; llms-full.txt regenerated.
* Fix the porous-absorbers link in the ground-barriers docs mirror and a stray comment label
* Regenerate llms-full.txt after the docs link fix
* Address review notes: shadow boundary in PE snippets, solver wording, Fresnel decades, barrier legend
The atmospheric_pe_range figure snippets now draw the closed-form
shadow-zone boundary they show; the underwater solver table describes
normal_modes as a finite-difference modal sum and the PE as marching
the range-independent profile all three solvers assume; the barrier
comparison claim is corrected to two decades of Fresnel number; and
the 5 dB grazing line is relabelled as the Kurze-Anderson limit in the
figure (regenerated, all four variants), the snippets and the alt
texts. llms-full.txt regenerated.
Environment and underwater guides: figures, model-selection prose and mirror sync (#362)
* Add atmospheric-refraction and barrier insertion-loss documentation figures
Four new deterministic figures in the four language/theme variants:
the log-linear effective sound-speed profiles (downward vs upward
refraction), the downward-refraction ray fan, the GFPE relative level
versus range at the receiver height for three atmospheres, and the
Kurze-Anderson / exact half-plane / coherent-ground barrier
insertion-loss comparison on the guide geometry.
* Environment and underwater guides: figures embedded, model-selection prose, mirror sync
Embed the new figures with reproducible code blocks in the
atmospheric-refraction and ground-and-barriers pages (EN, ES and the
docs mirrors) and add the missing .plot() one-liners next to every
plottable snippet, including the outdoor-propagation usage and report
examples.
Prose: a when-does-refraction-matter introduction for the
atmospheric-refraction guide (Attenborough & Van Renterghem 2021,
Ch. 11); a Choosing-a-model section for the underwater-propagation
guide covering the validity ranges of the UNESCO / Del Grosso /
Mackenzie sound-speed equations and the Francois-Garrison /
Ainslie-McColm / Thorp absorption models, spreading-law guidance, the
ray / normal-mode / parabolic-equation selection table after Jensen
et al. (2011, Ch. 1) and a worked passive-sonar budget; and, for the
underwater-acoustics guide, the ISO 17208-1 measurement discipline
(CPA distance, +/-30 degree data window, four runs, averaging chain)
and the ISO 18406 regulatory context (scope, the 750 m reference
position) behind the closed forms.
Mirror sync: the outdoor-propagation docs mirror gains the missing
Prediction reports section, the ground-barriers and
atmospheric-refraction docs mirrors gain the figure code blocks, and
the ES mirrors are updated with equivalent text (decimal commas fixed
in three stray values). ISO 18405 added to the underwater-propagation
references; llms-full.txt regenerated.
* Fix the porous-absorbers link in the ground-barriers docs mirror and a stray comment label
* Regenerate llms-full.txt after the docs link fix
* Address review notes: shadow boundary in PE snippets, solver wording, Fresnel decades, barrier legend
The atmospheric_pe_range figure snippets now draw the closed-form
shadow-zone boundary they show; the underwater solver table describes
normal_modes as a finite-difference modal sum and the PE as marching
the range-independent profile all three solvers assume; the barrier
comparison claim is corrected to two decades of Fresnel number; and
the 5 dB grazing line is relabelled as the Kurze-Anderson limit in the
figure (regenerated, all four variants), the snippets and the alt
texts. llms-full.txt regenerated.
Environment and underwater guides: figures, model-selection prose and mirror sync (#362)
* Add atmospheric-refraction and barrier insertion-loss documentation figures
Four new deterministic figures in the four language/theme variants:
the log-linear effective sound-speed profiles (downward vs upward
refraction), the downward-refraction ray fan, the GFPE relative level
versus range at the receiver height for three atmospheres, and the
Kurze-Anderson / exact half-plane / coherent-ground barrier
insertion-loss comparison on the guide geometry.
* Environment and underwater guides: figures embedded, model-selection prose, mirror sync
Embed the new figures with reproducible code blocks in the
atmospheric-refraction and ground-and-barriers pages (EN, ES and the
docs mirrors) and add the missing .plot() one-liners next to every
plottable snippet, including the outdoor-propagation usage and report
examples.
Prose: a when-does-refraction-matter introduction for the
atmospheric-refraction guide (Attenborough & Van Renterghem 2021,
Ch. 11); a Choosing-a-model section for the underwater-propagation
guide covering the validity ranges of the UNESCO / Del Grosso /
Mackenzie sound-speed equations and the Francois-Garrison /
Ainslie-McColm / Thorp absorption models, spreading-law guidance, the
ray / normal-mode / parabolic-equation selection table after Jensen
et al. (2011, Ch. 1) and a worked passive-sonar budget; and, for the
underwater-acoustics guide, the ISO 17208-1 measurement discipline
(CPA distance, +/-30 degree data window, four runs, averaging chain)
and the ISO 18406 regulatory context (scope, the 750 m reference
position) behind the closed forms.
Mirror sync: the outdoor-propagation docs mirror gains the missing
Prediction reports section, the ground-barriers and
atmospheric-refraction docs mirrors gain the figure code blocks, and
the ES mirrors are updated with equivalent text (decimal commas fixed
in three stray values). ISO 18405 added to the underwater-propagation
references; llms-full.txt regenerated.
* Fix the porous-absorbers link in the ground-barriers docs mirror and a stray comment label
* Regenerate llms-full.txt after the docs link fix
* Address review notes: shadow boundary in PE snippets, solver wording, Fresnel decades, barrier legend
The atmospheric_pe_range figure snippets now draw the closed-form
shadow-zone boundary they show; the underwater solver table describes
normal_modes as a finite-difference modal sum and the PE as marching
the range-independent profile all three solvers assume; the barrier
comparison claim is corrected to two decades of Fresnel number; and
the 5 dB grazing line is relabelled as the Kurze-Anderson limit in the
figure (regenerated, all four variants), the snippets and the alt
texts. llms-full.txt regenerated.
Environment and underwater guides: figures, model-selection prose and mirror sync (#362)
* Add atmospheric-refraction and barrier insertion-loss documentation figures
Four new deterministic figures in the four language/theme variants:
the log-linear effective sound-speed profiles (downward vs upward
refraction), the downward-refraction ray fan, the GFPE relative level
versus range at the receiver height for three atmospheres, and the
Kurze-Anderson / exact half-plane / coherent-ground barrier
insertion-loss comparison on the guide geometry.
* Environment and underwater guides: figures embedded, model-selection prose, mirror sync
Embed the new figures with reproducible code blocks in the
atmospheric-refraction and ground-and-barriers pages (EN, ES and the
docs mirrors) and add the missing .plot() one-liners next to every
plottable snippet, including the outdoor-propagation usage and report
examples.
Prose: a when-does-refraction-matter introduction for the
atmospheric-refraction guide (Attenborough & Van Renterghem 2021,
Ch. 11); a Choosing-a-model section for the underwater-propagation
guide covering the validity ranges of the UNESCO / Del Grosso /
Mackenzie sound-speed equations and the Francois-Garrison /
Ainslie-McColm / Thorp absorption models, spreading-law guidance, the
ray / normal-mode / parabolic-equation selection table after Jensen
et al. (2011, Ch. 1) and a worked passive-sonar budget; and, for the
underwater-acoustics guide, the ISO 17208-1 measurement discipline
(CPA distance, +/-30 degree data window, four runs, averaging chain)
and the ISO 18406 regulatory context (scope, the 750 m reference
position) behind the closed forms.
Mirror sync: the outdoor-propagation docs mirror gains the missing
Prediction reports section, the ground-barriers and
atmospheric-refraction docs mirrors gain the figure code blocks, and
the ES mirrors are updated with equivalent text (decimal commas fixed
in three stray values). ISO 18405 added to the underwater-propagation
references; llms-full.txt regenerated.
* Fix the porous-absorbers link in the ground-barriers docs mirror and a stray comment label
* Regenerate llms-full.txt after the docs link fix
* Address review notes: shadow boundary in PE snippets, solver wording, Fresnel decades, barrier legend
The atmospheric_pe_range figure snippets now draw the closed-form
shadow-zone boundary they show; the underwater solver table describes
normal_modes as a finite-difference modal sum and the PE as marching
the range-independent profile all three solvers assume; the barrier
comparison claim is corrected to two decades of Fresnel number; and
the 5 dB grazing line is relabelled as the Kurze-Anderson limit in the
figure (regenerated, all four variants), the snippets and the alt
texts. llms-full.txt regenerated.
Environment and underwater guides: figures, model-selection prose and mirror sync (#362)
* Add atmospheric-refraction and barrier insertion-loss documentation figures
Four new deterministic figures in the four language/theme variants:
the log-linear effective sound-speed profiles (downward vs upward
refraction), the downward-refraction ray fan, the GFPE relative level
versus range at the receiver height for three atmospheres, and the
Kurze-Anderson / exact half-plane / coherent-ground barrier
insertion-loss comparison on the guide geometry.
* Environment and underwater guides: figures embedded, model-selection prose, mirror sync
Embed the new figures with reproducible code blocks in the
atmospheric-refraction and ground-and-barriers pages (EN, ES and the
docs mirrors) and add the missing .plot() one-liners next to every
plottable snippet, including the outdoor-propagation usage and report
examples.
Prose: a when-does-refraction-matter introduction for the
atmospheric-refraction guide (Attenborough & Van Renterghem 2021,
Ch. 11); a Choosing-a-model section for the underwater-propagation
guide covering the validity ranges of the UNESCO / Del Grosso /
Mackenzie sound-speed equations and the Francois-Garrison /
Ainslie-McColm / Thorp absorption models, spreading-law guidance, the
ray / normal-mode / parabolic-equation selection table after Jensen
et al. (2011, Ch. 1) and a worked passive-sonar budget; and, for the
underwater-acoustics guide, the ISO 17208-1 measurement discipline
(CPA distance, +/-30 degree data window, four runs, averaging chain)
and the ISO 18406 regulatory context (scope, the 750 m reference
position) behind the closed forms.
Mirror sync: the outdoor-propagation docs mirror gains the missing
Prediction reports section, the ground-barriers and
atmospheric-refraction docs mirrors gain the figure code blocks, and
the ES mirrors are updated with equivalent text (decimal commas fixed
in three stray values). ISO 18405 added to the underwater-propagation
references; llms-full.txt regenerated.
* Fix the porous-absorbers link in the ground-barriers docs mirror and a stray comment label
* Regenerate llms-full.txt after the docs link fix
* Address review notes: shadow boundary in PE snippets, solver wording, Fresnel decades, barrier legend
The atmospheric_pe_range figure snippets now draw the closed-form
shadow-zone boundary they show; the underwater solver table describes
normal_modes as a finite-difference modal sum and the PE as marching
the range-independent profile all three solvers assume; the barrier
comparison claim is corrected to two decades of Fresnel number; and
the 5 dB grazing line is relabelled as the Kurze-Anderson limit in the
figure (regenerated, all four variants), the snippets and the alt
texts. llms-full.txt regenerated.
Environment and underwater guides: figures, model-selection prose and mirror sync (#362)
* Add atmospheric-refraction and barrier insertion-loss documentation figures
Four new deterministic figures in the four language/theme variants:
the log-linear effective sound-speed profiles (downward vs upward
refraction), the downward-refraction ray fan, the GFPE relative level
versus range at the receiver height for three atmospheres, and the
Kurze-Anderson / exact half-plane / coherent-ground barrier
insertion-loss comparison on the guide geometry.
* Environment and underwater guides: figures embedded, model-selection prose, mirror sync
Embed the new figures with reproducible code blocks in the
atmospheric-refraction and ground-and-barriers pages (EN, ES and the
docs mirrors) and add the missing .plot() one-liners next to every
plottable snippet, including the outdoor-propagation usage and report
examples.
Prose: a when-does-refraction-matter introduction for the
atmospheric-refraction guide (Attenborough & Van Renterghem 2021,
Ch. 11); a Choosing-a-model section for the underwater-propagation
guide covering the validity ranges of the UNESCO / Del Grosso /
Mackenzie sound-speed equations and the Francois-Garrison /
Ainslie-McColm / Thorp absorption models, spreading-law guidance, the
ray / normal-mode / parabolic-equation selection table after Jensen
et al. (2011, Ch. 1) and a worked passive-sonar budget; and, for the
underwater-acoustics guide, the ISO 17208-1 measurement discipline
(CPA distance, +/-30 degree data window, four runs, averaging chain)
and the ISO 18406 regulatory context (scope, the 750 m reference
position) behind the closed forms.
Mirror sync: the outdoor-propagation docs mirror gains the missing
Prediction reports section, the ground-barriers and
atmospheric-refraction docs mirrors gain the figure code blocks, and
the ES mirrors are updated with equivalent text (decimal commas fixed
in three stray values). ISO 18405 added to the underwater-propagation
references; llms-full.txt regenerated.
* Fix the porous-absorbers link in the ground-barriers docs mirror and a stray comment label
* Regenerate llms-full.txt after the docs link fix
* Address review notes: shadow boundary in PE snippets, solver wording, Fresnel decades, barrier legend
The atmospheric_pe_range figure snippets now draw the closed-form
shadow-zone boundary they show; the underwater solver table describes
normal_modes as a finite-difference modal sum and the PE as marching
the range-independent profile all three solvers assume; the barrier
comparison claim is corrected to two decades of Fresnel number; and
the 5 dB grazing line is relabelled as the Kurze-Anderson limit in the
figure (regenerated, all four variants), the snippets and the alt
texts. llms-full.txt regenerated.
Environment and underwater guides: figures, model-selection prose and mirror sync (#362)
* Add atmospheric-refraction and barrier insertion-loss documentation figures
Four new deterministic figures in the four language/theme variants:
the log-linear effective sound-speed profiles (downward vs upward
refraction), the downward-refraction ray fan, the GFPE relative level
versus range at the receiver height for three atmospheres, and the
Kurze-Anderson / exact half-plane / coherent-ground barrier
insertion-loss comparison on the guide geometry.
* Environment and underwater guides: figures embedded, model-selection prose, mirror sync
Embed the new figures with reproducible code blocks in the
atmospheric-refraction and ground-and-barriers pages (EN, ES and the
docs mirrors) and add the missing .plot() one-liners next to every
plottable snippet, including the outdoor-propagation usage and report
examples.
Prose: a when-does-refraction-matter introduction for the
atmospheric-refraction guide (Attenborough & Van Renterghem 2021,
Ch. 11); a Choosing-a-model section for the underwater-propagation
guide covering the validity ranges of the UNESCO / Del Grosso /
Mackenzie sound-speed equations and the Francois-Garrison /
Ainslie-McColm / Thorp absorption models, spreading-law guidance, the
ray / normal-mode / parabolic-equation selection table after Jensen
et al. (2011, Ch. 1) and a worked passive-sonar budget; and, for the
underwater-acoustics guide, the ISO 17208-1 measurement discipline
(CPA distance, +/-30 degree data window, four runs, averaging chain)
and the ISO 18406 regulatory context (scope, the 750 m reference
position) behind the closed forms.
Mirror sync: the outdoor-propagation docs mirror gains the missing
Prediction reports section, the ground-barriers and
atmospheric-refraction docs mirrors gain the figure code blocks, and
the ES mirrors are updated with equivalent text (decimal commas fixed
in three stray values). ISO 18405 added to the underwater-propagation
references; llms-full.txt regenerated.
* Fix the porous-absorbers link in the ground-barriers docs mirror and a stray comment label
* Regenerate llms-full.txt after the docs link fix
* Address review notes: shadow boundary in PE snippets, solver wording, Fresnel decades, barrier legend
The atmospheric_pe_range figure snippets now draw the closed-form
shadow-zone boundary they show; the underwater solver table describes
normal_modes as a finite-difference modal sum and the PE as marching
the range-independent profile all three solvers assume; the barrier
comparison claim is corrected to two decades of Fresnel number; and
the 5 dB grazing line is relabelled as the Kurze-Anderson limit in the
figure (regenerated, all four variants), the snippets and the alt
texts. llms-full.txt regenerated.
Environment and underwater guides: figures, model-selection prose and mirror sync (#362)
* Add atmospheric-refraction and barrier insertion-loss documentation figures
Four new deterministic figures in the four language/theme variants:
the log-linear effective sound-speed profiles (downward vs upward
refraction), the downward-refraction ray fan, the GFPE relative level
versus range at the receiver height for three atmospheres, and the
Kurze-Anderson / exact half-plane / coherent-ground barrier
insertion-loss comparison on the guide geometry.
* Environment and underwater guides: figures embedded, model-selection prose, mirror sync
Embed the new figures with reproducible code blocks in the
atmospheric-refraction and ground-and-barriers pages (EN, ES and the
docs mirrors) and add the missing .plot() one-liners next to every
plottable snippet, including the outdoor-propagation usage and report
examples.
Prose: a when-does-refraction-matter introduction for the
atmospheric-refraction guide (Attenborough & Van Renterghem 2021,
Ch. 11); a Choosing-a-model section for the underwater-propagation
guide covering the validity ranges of the UNESCO / Del Grosso /
Mackenzie sound-speed equations and the Francois-Garrison /
Ainslie-McColm / Thorp absorption models, spreading-law guidance, the
ray / normal-mode / parabolic-equation selection table after Jensen
et al. (2011, Ch. 1) and a worked passive-sonar budget; and, for the
underwater-acoustics guide, the ISO 17208-1 measurement discipline
(CPA distance, +/-30 degree data window, four runs, averaging chain)
and the ISO 18406 regulatory context (scope, the 750 m reference
position) behind the closed forms.
Mirror sync: the outdoor-propagation docs mirror gains the missing
Prediction reports section, the ground-barriers and
atmospheric-refraction docs mirrors gain the figure code blocks, and
the ES mirrors are updated with equivalent text (decimal commas fixed
in three stray values). ISO 18405 added to the underwater-propagation
references; llms-full.txt regenerated.
* Fix the porous-absorbers link in the ground-barriers docs mirror and a stray comment label
* Regenerate llms-full.txt after the docs link fix
* Address review notes: shadow boundary in PE snippets, solver wording, Fresnel decades, barrier legend
The atmospheric_pe_range figure snippets now draw the closed-form
shadow-zone boundary they show; the underwater solver table describes
normal_modes as a finite-difference modal sum and the PE as marching
the range-independent profile all three solvers assume; the barrier
comparison claim is corrected to two decades of Fresnel number; and
the 5 dB grazing line is relabelled as the Kurze-Anderson limit in the
figure (regenerated, all four variants), the snippets and the alt
texts. llms-full.txt regenerated.
Environment and underwater guides: figures, model-selection prose and mirror sync (#362)
* Add atmospheric-refraction and barrier insertion-loss documentation figures
Four new deterministic figures in the four language/theme variants:
the log-linear effective sound-speed profiles (downward vs upward
refraction), the downward-refraction ray fan, the GFPE relative level
versus range at the receiver height for three atmospheres, and the
Kurze-Anderson / exact half-plane / coherent-ground barrier
insertion-loss comparison on the guide geometry.
* Environment and underwater guides: figures embedded, model-selection prose, mirror sync
Embed the new figures with reproducible code blocks in the
atmospheric-refraction and ground-and-barriers pages (EN, ES and the
docs mirrors) and add the missing .plot() one-liners next to every
plottable snippet, including the outdoor-propagation usage and report
examples.
Prose: a when-does-refraction-matter introduction for the
atmospheric-refraction guide (Attenborough & Van Renterghem 2021,
Ch. 11); a Choosing-a-model section for the underwater-propagation
guide covering the validity ranges of the UNESCO / Del Grosso /
Mackenzie sound-speed equations and the Francois-Garrison /
Ainslie-McColm / Thorp absorption models, spreading-law guidance, the
ray / normal-mode / parabolic-equation selection table after Jensen
et al. (2011, Ch. 1) and a worked passive-sonar budget; and, for the
underwater-acoustics guide, the ISO 17208-1 measurement discipline
(CPA distance, +/-30 degree data window, four runs, averaging chain)
and the ISO 18406 regulatory context (scope, the 750 m reference
position) behind the closed forms.
Mirror sync: the outdoor-propagation docs mirror gains the missing
Prediction reports section, the ground-barriers and
atmospheric-refraction docs mirrors gain the figure code blocks, and
the ES mirrors are updated with equivalent text (decimal commas fixed
in three stray values). ISO 18405 added to the underwater-propagation
references; llms-full.txt regenerated.
* Fix the porous-absorbers link in the ground-barriers docs mirror and a stray comment label
* Regenerate llms-full.txt after the docs link fix
* Address review notes: shadow boundary in PE snippets, solver wording, Fresnel decades, barrier legend
The atmospheric_pe_range figure snippets now draw the closed-form
shadow-zone boundary they show; the underwater solver table describes
normal_modes as a finite-difference modal sum and the PE as marching
the range-independent profile all three solvers assume; the barrier
comparison claim is corrected to two decades of Fresnel number; and
the 5 dB grazing line is relabelled as the Kurze-Anderson limit in the
figure (regenerated, all four variants), the snippets and the alt
texts. llms-full.txt regenerated.
Environment and underwater guides: figures, model-selection prose and mirror sync (#362)
* Add atmospheric-refraction and barrier insertion-loss documentation figures
Four new deterministic figures in the four language/theme variants:
the log-linear effective sound-speed profiles (downward vs upward
refraction), the downward-refraction ray fan, the GFPE relative level
versus range at the receiver height for three atmospheres, and the
Kurze-Anderson / exact half-plane / coherent-ground barrier
insertion-loss comparison on the guide geometry.
* Environment and underwater guides: figures embedded, model-selection prose, mirror sync
Embed the new figures with reproducible code blocks in the
atmospheric-refraction and ground-and-barriers pages (EN, ES and the
docs mirrors) and add the missing .plot() one-liners next to every
plottable snippet, including the outdoor-propagation usage and report
examples.
Prose: a when-does-refraction-matter introduction for the
atmospheric-refraction guide (Attenborough & Van Renterghem 2021,
Ch. 11); a Choosing-a-model section for the underwater-propagation
guide covering the validity ranges of the UNESCO / Del Grosso /
Mackenzie sound-speed equations and the Francois-Garrison /
Ainslie-McColm / Thorp absorption models, spreading-law guidance, the
ray / normal-mode / parabolic-equation selection table after Jensen
et al. (2011, Ch. 1) and a worked passive-sonar budget; and, for the
underwater-acoustics guide, the ISO 17208-1 measurement discipline
(CPA distance, +/-30 degree data window, four runs, averaging chain)
and the ISO 18406 regulatory context (scope, the 750 m reference
position) behind the closed forms.
Mirror sync: the outdoor-propagation docs mirror gains the missing
Prediction reports section, the ground-barriers and
atmospheric-refraction docs mirrors gain the figure code blocks, and
the ES mirrors are updated with equivalent text (decimal commas fixed
in three stray values). ISO 18405 added to the underwater-propagation
references; llms-full.txt regenerated.
* Fix the porous-absorbers link in the ground-barriers docs mirror and a stray comment label
* Regenerate llms-full.txt after the docs link fix
* Address review notes: shadow boundary in PE snippets, solver wording, Fresnel decades, barrier legend
The atmospheric_pe_range figure snippets now draw the closed-form
shadow-zone boundary they show; the underwater solver table describes
normal_modes as a finite-difference modal sum and the PE as marching
the range-independent profile all three solvers assume; the barrier
comparison claim is corrected to two decades of Fresnel number; and
the 5 dB grazing line is relabelled as the Kurze-Anderson limit in the
figure (regenerated, all four variants), the snippets and the alt
texts. llms-full.txt regenerated.
Spanish docs: UNE terminology, decimal commas, localized snippets and theory figures (#365)
* Normalize Spanish docs prose to UNE acoustic terminology
Sweep the Spanish pages for the non-UNE forms "presion sonora",
"potencia sonora" and "intensidad sonora" and normalize the prose to
the wording used by the official Spanish editions of the standards:
"presion acustica" (UNE-EN ISO 16283-2:2016, UNE-EN ISO 10052:2005,
UNE-EN ISO 3746:2011, UNE-ISO 226:2013), "potencia acustica"
(UNE-EN ISO 3746:2011, UNE-EN ISO 4871:2010, UNE-EN ISO 9614-1:2010),
"intensidad acustica" (UNE-EN 61043:1999, UNE-EN ISO 9614-1:2010) and
"nivel de presion acustica de impactos" (UNE-EN ISO 12354-2:2018,
UNE-EN ISO 717-2:2013). 92 replacements across 32 pages, prose only:
code snippets keep the labels they share with the generated figures.
Rename the intensity guide to "Intensidad acustica (p-p)" and the
structure-borne power guide to "Potencia acustica estructural de
equipos (EN 15657)", updating every cross-link text and the theory
anchor intensidad-sonora-iec-61043 accordingly. The API sidebar group
label becomes "Potencia acustica e intensidad" via api_taxonomy.py
with the generated sidebar regenerated.
* Use decimal commas in Spanish docs prose quantities
Sweep every Spanish page for decimal points leaking into prose numbers
and switch them to the comma the locale convention calls for: the
rotorcraft validation prose (fourteen tolerances such as 0,08 dB(A) and
0,5 s), the insulation-prediction worked example (53,6 dB / 53,8 dB),
the tone-audibility Annex E tone (137,3 Hz), the Mackenzie check value
(1550,744 m/s), the EPNL, loudness and absorption fiche descriptions
(98,3 EPNdB; 8,2 sonos and 70,4 fonios; 0,60 y 0,55), the junction
constants table and the third-octave band-edge table in the signal
analysis theory page. Code snippets, inline code, math, clause numbers
and quoted source text keep their points.
* Pass language="es" in Spanish figure-reproduction snippets
The <details> blocks under each localized figure in the Spanish guides
are meant to reproduce the _es variant shown on the page, but 82 of the
one-line result .plot() calls omitted the language="es" argument and
would render English axis labels instead. Add the argument across 33
guides, matching the pattern the intensity field-indicators snippet
already used. The three lab-insulation results whose plot() does not
take a language argument (lab airborne, lab impact and the
element-normalized intensity difference) are left as they were.
* Extend the UNE terminology sweep to sound absorption
Normalize "absorción sonora" to "absorción acústica" across the
Spanish pages (36 occurrences in 14 pages, including the EN 12354-6
guide title and the theory headings), the wording of UNE-EN ISO
3746:2011 and of the equivalent absorption area in UNE-EN ISO
10140-3:2011, UNE-EN ISO 12354-2:2018 and UNE-EN ISO 16283-2:2016, and
the same term the accredited report strings already use. Also restore
the accent in the theory index anchor to the renamed intensity heading,
since heading slugs keep accented characters.
* Theory pages: illustrate each section family with existing result figures
The seven theory pages carried no figures at all. Embed sixteen of the
existing generated figures (light and dark variants, Spanish variants on
the Spanish mirrors) where the concept matches the prose: weighting
curves, time integration and the p-p intensity estimator in the signal
analysis page; equal-loudness contours, the specific-loudness pattern
and the hearing-threshold panels in perception; NC/RC rating, the
Schroeder decay and the ISO 717-1 shifted reference in rooms and
buildings; the Lden profile, ISO 9613-1 absorption and the three sound
power routes in environment and transport; the scattering coefficient
and ISO 11654 rating in materials and surfaces; and the Wk weighting and
the resonator mobility triplet in vibration. Each embed reuses the alt
text of the guide that owns the figure and adds a one-line caption.
Also give the wave-simulation section hub the reading-order paragraph
its siblings already have, linking the closed-form pages the FDTD solver
cross-checks, in both languages.
* Address review findings from the Spanish locale sweeps
Second pass fixes flagged by review: five terminology occurrences the
line-based sweep missed because the noun and adjective were split by a
line wrap or emphasis markup (sound-power, rotorcraft-noise and two
section hubs); six Spanish pages that still embedded the English figure
variant although the _es variant exists (junction-transmission,
aircraft-noise airport contour, miso-coherence,
objective-intelligibility, psychoacoustic-annoyance twice); and 19 more
language="es" arguments on figure-reproduction plot calls the first
pass missed, chained-call receivers such as room.noise_criterion(spl)
.plot() and the axes-creating first call of the two-profile
atmospheric-refraction snippet among them. The lab-insulation plot
wrappers forward keyword arguments to the rating plot, so the three
calls excluded earlier now take the argument too. All Spanish python
fences re-checked to compile and EN/ES parity re-verified.
* Carry the UNE terminology into the generated-asset Spanish strings
Apply the same evidence-based decisions to every Spanish string source
that feeds generated assets: the translation tables of
generate_graphs.py and generate_diagrams.py, the _STRINGS tables of the
plot modules and the report i18n values. 35 strings change: "presión
acústica" (UNE-EN ISO 16283-2:2016, 10052:2005, 3746:2011),
"potencia acústica" (UNE-EN ISO 3746:2011, 4871:2010, 9614-1:2010),
"intensidad acústica" (UNE-EN 61043:1999, 9614-1:2010), "absorción
acústica" (UNE-EN ISO 3746:2011) and "nivel de presión acústica de
impactos" (UNE-EN ISO 12354-2:2018). Strings the UNE editions keep are
untouched: "emisión sonora", "exposición sonora", "campo sonoro",
"fuente sonora". Only Spanish values change; the English keys stay.
The two plot-i18n test assertions that pin the axis label follow, and
the eight Spanish doc fences that deliberately mirrored the old figure
labels now mirror the new ones.
* Regenerate the Spanish figure variants with the UNE terminology
make graphs after the string-source change: 48 files, all of them _es
or _es_dark variants (24 figure/diagram pairs), picking up "presión
acústica", "potencia acústica", "intensidad acústica", "absorción
acústica" and "nivel de presión acústica de impactos" in titles and
axis labels. The English variants are untouched. The committed example
fiches need no regeneration: every example in generate_reports.py
renders in English, so no changed Spanish report string reaches them.
* Align the intensity-fiche Spanish assertions with the UNE terminology
Spanish docs: UNE terminology, decimal commas, localized snippets and theory figures (#365)
* Normalize Spanish docs prose to UNE acoustic terminology
Sweep the Spanish pages for the non-UNE forms "presion sonora",
"potencia sonora" and "intensidad sonora" and normalize the prose to
the wording used by the official Spanish editions of the standards:
"presion acustica" (UNE-EN ISO 16283-2:2016, UNE-EN ISO 10052:2005,
UNE-EN ISO 3746:2011, UNE-ISO 226:2013), "potencia acustica"
(UNE-EN ISO 3746:2011, UNE-EN ISO 4871:2010, UNE-EN ISO 9614-1:2010),
"intensidad acustica" (UNE-EN 61043:1999, UNE-EN ISO 9614-1:2010) and
"nivel de presion acustica de impactos" (UNE-EN ISO 12354-2:2018,
UNE-EN ISO 717-2:2013). 92 replacements across 32 pages, prose only:
code snippets keep the labels they share with the generated figures.
Rename the intensity guide to "Intensidad acustica (p-p)" and the
structure-borne power guide to "Potencia acustica estructural de
equipos (EN 15657)", updating every cross-link text and the theory
anchor intensidad-sonora-iec-61043 accordingly. The API sidebar group
label becomes "Potencia acustica e intensidad" via api_taxonomy.py
with the generated sidebar regenerated.
* Use decimal commas in Spanish docs prose quantities
Sweep every Spanish page for decimal points leaking into prose numbers
and switch them to the comma the locale convention calls for: the
rotorcraft validation prose (fourteen tolerances such as 0,08 dB(A) and
0,5 s), the insulation-prediction worked example (53,6 dB / 53,8 dB),
the tone-audibility Annex E tone (137,3 Hz), the Mackenzie check value
(1550,744 m/s), the EPNL, loudness and absorption fiche descriptions
(98,3 EPNdB; 8,2 sonos and 70,4 fonios; 0,60 y 0,55), the junction
constants table and the third-octave band-edge table in the signal
analysis theory page. Code snippets, inline code, math, clause numbers
and quoted source text keep their points.
* Pass language="es" in Spanish figure-reproduction snippets
The <details> blocks under each localized figure in the Spanish guides
are meant to reproduce the _es variant shown on the page, but 82 of the
one-line result .plot() calls omitted the language="es" argument and
would render English axis labels instead. Add the argument across 33
guides, matching the pattern the intensity field-indicators snippet
already used. The three lab-insulation results whose plot() does not
take a language argument (lab airborne, lab impact and the
element-normalized intensity difference) are left as they were.
* Extend the UNE terminology sweep to sound absorption
Normalize "absorción sonora" to "absorción acústica" across the
Spanish pages (36 occurrences in 14 pages, including the EN 12354-6
guide title and the theory headings), the wording of UNE-EN ISO
3746:2011 and of the equivalent absorption area in UNE-EN ISO
10140-3:2011, UNE-EN ISO 12354-2:2018 and UNE-EN ISO 16283-2:2016, and
the same term the accredited report strings already use. Also restore
the accent in the theory index anchor to the renamed intensity heading,
since heading slugs keep accented characters.
* Theory pages: illustrate each section family with existing result figures
The seven theory pages carried no figures at all. Embed sixteen of the
existing generated figures (light and dark variants, Spanish variants on
the Spanish mirrors) where the concept matches the prose: weighting
curves, time integration and the p-p intensity estimator in the signal
analysis page; equal-loudness contours, the specific-loudness pattern
and the hearing-threshold panels in perception; NC/RC rating, the
Schroeder decay and the ISO 717-1 shifted reference in rooms and
buildings; the Lden profile, ISO 9613-1 absorption and the three sound
power routes in environment and transport; the scattering coefficient
and ISO 11654 rating in materials and surfaces; and the Wk weighting and
the resonator mobility triplet in vibration. Each embed reuses the alt
text of the guide that owns the figure and adds a one-line caption.
Also give the wave-simulation section hub the reading-order paragraph
its siblings already have, linking the closed-form pages the FDTD solver
cross-checks, in both languages.
* Address review findings from the Spanish locale sweeps
Second pass fixes flagged by review: five terminology occurrences the
line-based sweep missed because the noun and adjective were split by a
line wrap or emphasis markup (sound-power, rotorcraft-noise and two
section hubs); six Spanish pages that still embedded the English figure
variant although the _es variant exists (junction-transmission,
aircraft-noise airport contour, miso-coherence,
objective-intelligibility, psychoacoustic-annoyance twice); and 19 more
language="es" arguments on figure-reproduction plot calls the first
pass missed, chained-call receivers such as room.noise_criterion(spl)
.plot() and the axes-creating first call of the two-profile
atmospheric-refraction snippet among them. The lab-insulation plot
wrappers forward keyword arguments to the rating plot, so the three
calls excluded earlier now take the argument too. All Spanish python
fences re-checked to compile and EN/ES parity re-verified.
* Carry the UNE terminology into the generated-asset Spanish strings
Apply the same evidence-based decisions to every Spanish string source
that feeds generated assets: the translation tables of
generate_graphs.py and generate_diagrams.py, the _STRINGS tables of the
plot modules and the report i18n values. 35 strings change: "presión
acústica" (UNE-EN ISO 16283-2:2016, 10052:2005, 3746:2011),
"potencia acústica" (UNE-EN ISO 3746:2011, 4871:2010, 9614-1:2010),
"intensidad acústica" (UNE-EN 61043:1999, 9614-1:2010), "absorción
acústica" (UNE-EN ISO 3746:2011) and "nivel de presión acústica de
impactos" (UNE-EN ISO 12354-2:2018). Strings the UNE editions keep are
untouched: "emisión sonora", "exposición sonora", "campo sonoro",
"fuente sonora". Only Spanish values change; the English keys stay.
The two plot-i18n test assertions that pin the axis label follow, and
the eight Spanish doc fences that deliberately mirrored the old figure
labels now mirror the new ones.
* Regenerate the Spanish figure variants with the UNE terminology
make graphs after the string-source change: 48 files, all of them _es
or _es_dark variants (24 figure/diagram pairs), picking up "presión
acústica", "potencia acústica", "intensidad acústica", "absorción
acústica" and "nivel de presión acústica de impactos" in titles and
axis labels. The English variants are untouched. The committed example
fiches need no regeneration: every example in generate_reports.py
renders in English, so no changed Spanish report string reaches them.
* Align the intensity-fiche Spanish assertions with the UNE terminology
Correct DSP estimator edge cases: TSA time axis, echo detection, EQ validation (#356)
* Report the true 1/fs time axis from time_synchronous_average
The averaged samples sit on the 1/fs sampling grid (each block is aligned
back to it by the band-limited fractional delay before averaging), but the
result reported a time axis with T/M spacing. For a non-integer number of
samples per period the two grids drift apart across the period: with
100.37 samples per period the noiseless recovery error read against the
reported axis was 9.3e-2, versus 2.8e-6 on the true m/fs grid.
Return times = arange(M)/fs, document that the M samples cover the period
only approximately when fs*T is not an integer (McFadden 1987 revised
model: a block average on the sampling grid, no angular resampling), and
assert the non-integer-period tests on the true grid, with a regression
test pinning the 100.37-sample case on both grids. Also soften the comb
response [0, 1] claim (float cancellation beside a tooth can exceed 1 by
a few 1e-9) and mark the ~14 dB N = 32 figure as derived from Eq. 8
rather than printed in the paper.
* Detect inverting echoes and off-sample delays in echo_detection
echo_detection picked the maximum of the signed power cepstrum, so an
inverting reflection (a < 0), whose first rahmonic is a itself and hence
negative, was silently missed: with a = -0.4 at 313 samples the true
rahmonic c[313] = -0.42 was ignored and an unrelated 4739-sample peak
returned. Peak-pick on |cepstrum| within the searched band instead and
report the signed cepstrum value at the peak as the reflection
coefficient (the Mercator series ln(1 + a e^{-j theta}) holds for either
sign of a).
Also refine the reported delay by three-point parabolic interpolation of
|cepstrum| through the peak, so an off-sample delay (e.g. 313.5 samples)
is estimated to a fraction of a sample, and document the bin-splitting
caveat: at off-sample delays the peak-sample coefficient underestimates
|a| (about 65 % of it midway between bins). One-line convention note
distinguishing Milner's IDFT(ln|X|^2) power cepstrum from Bogert's
squared original. Tests cover a < 0 (exact impulse-echo closed form and
a noise source) and the interpolated half-sample delay.
* Validate parametric-EQ sections at the numerical extremes
Three validation gaps in the RBJ cookbook designer:
- A wide 'bw' at an f0 near Nyquist drives the w0/sin(w0) warping factor
into math.sinh overflow, escaping as a raw OverflowError; slightly less
extreme pairs produced a large but finite alpha whose rounded a2 landed
exactly at -1.0: poles on the unit circle designed silently. Wrap the
sinh with an informative ValueError and check the realized coefficients
against the stability triangle (|a2| < 1, |a1| < 1 + a2) after
normalization.
- A shelf slope beyond the gain-dependent bound (A + 1/A)/(A + 1/A - 2)
makes the cookbook's alpha complex and surfaced as a bare 'math domain
error'. Validate the bound at section construction with the limit in
the message (any slope is fine at 0 dB, where A = 1).
- Non-finite f0/gain_db/q/bw/slope passed validation silently (NaN
compares false against every bound) and produced NaN/inf coefficient
rows. Require finiteness explicitly.
Tests cover all three paths plus extreme-but-valid sections that must
keep designing stably.
* Scope the envelope-spectrum amplitude claim and add the band-pass front end
The docstring promised that a sinusoidal modulation 'reads out as a line
at its exact amplitude'; that holds only when the modulation frequency
falls on an analysis bin. Off-bin lines read low by the taper's
scalloping loss (about 1.42 dB, ~15 %, for the default Hann midway
between bins), like any single-record amplitude spectrum. State the
on-bin condition on the closed forms and the caveat in the module,
function and result docstrings, pinned by a midway-between-bins test.
Also add the optional band=(low, high) pre-filter to envelope_spectrum:
a zero-phase 4th-order Butterworth band-pass ahead of the detector, the
band-pass front end of Bendat & Piersol Figure 13.11 and the classical
bearing-envelope chain (isolate the excited resonance band, then
envelope it). The band travels with the result; a test shows it
recovering the exact modulation line under a strong out-of-band
interferer that swamps the raw envelope.
* Warn when a tone burst cannot close on the tone's zero crossing
IEC 60268-1 Clause A2.1 asks for an integral number of full periods, but
the gate closes after round(fs*cycles/frequency) samples: sample-exact
only when f and fs are commensurate. For 10 cycles of 997 Hz at 48 kHz
the burst spans 481.44 samples, gated at 481, and the waveform carries a
residual step at the gate edge. Document the condition and emit a
PhonometryWarning quantifying the realized residual (bounded by
amplitude*sin(pi*f/fs)) for incommensurate pairs; commensurate bursts
stay silent.
Also tighten the resampler's 'equiripple-bounded' wording: the Kaiser
window method bounds both bands by the same delta = 10^(-A/20), but its
ripple decays away from the band edges, unlike a true equiripple design.
* Document estimator conventions verified against their sources
Documentation and comment corrections, no behavior changes:
- random_data: keep the reverse-arrangement acceptance bounds on the
normal approximation deliberately and say why: B&P Table A.6 itself
follows it, and no percentage-point convention on the exact Mahonian
distribution reproduces the published entries (N = 40 and N = 100 at
a = 0.975 pin it down), so exact bounds would disagree with the table
users check against. The p-value stays exact; the one-count boundary
disagreement is now documented on TrendTestResult.
- time_frequency: the spectrogram energy-recovery statement was wrong as
written; integrating 'density' columns over frequency and summing over
time recovers the record energy only after multiplying by the hop
duration, up to the taper roll-off at the record edges (verified
0.988 vs 1 for Hann at 75 % overlap on white noise).
- spectra: note that the adaptive multitaper sigma^2 is mean(x^2) with no
mean removal (consistent with the documented no-detrending
calibration), and mark the 'P&W Eq. 369a' citation as pending
verification against the book.
- compliance + tests/reference_data: transcription note for the bare
'+3' at 20 Hz, Type 2, in ANSI S1.4-1983 Table V (read as upper-only;
+/-3 plausible; either way the verdict cannot change, the realized
deviation is -0.05 dB).
- room_ir: the Mueller & Massarani 'below 4 dB' crest-factor figure
assumes their slight magnitude smoothing, which shaped_sweep_signal
does not implement; measured sweeps here sit at 4.2-4.3 dB.
* Translate EQ section labels, complete the bibliography and changelog
- The per-section legend labels of the parametric-EQ plot printed the raw
English filter-type names in Spanish figures; route them through the
plot string table (peaking -> campana, shelves, band-pass, notch,
all-pass; lowpass/highpass were already translated for the lifter
plot). English output stays byte-identical.
- docs/references.md: add the Harris 1978 window paper and IEC
60268-1:1985, both cited by guide pages but missing from the collected
bibliography; link the IEC entry (and the one in test-signals.md) to
the IEC webstore page.
- Changelog entries for the DSP fixes; regenerate the API reference,
llms-full.txt and the cepstrum_echo figures (the detected-echo marker
moved by the sub-sample delay interpolation); the conformance report is
unchanged (419/419).
* Propagate the echo and envelope semantics to the site guides
Review follow-ups:
- The EN and ES site guides (cepstrum-echoes.mdx) still described the
old echo reading and the unqualified 'exact amplitude' claim; bring
them in step with docs/cepstrum-echoes.md: |cepstrum| peak-picking,
signed coefficient, interpolated delay, bin-splitting caveat, the
on-bin/scalloping condition and the new band= front end (the docs page
gains the same envelope-section text).
- State in the changelog and the result docstring that delay is no
longer exactly delay_samples/fs when the interpolated offset is
nonzero (delay_samples remains the whole-sample index the coefficient
is read at), and merge the duplicated Unreleased headings.
- Clearer stability message (poles 'do not lie strictly inside the unit
circle', full-precision coefficients) and an informative short-record
error for the envelope band-pass pre-filter instead of scipy's padlen
message.
- Sharper tone-burst warning test (asserts the quantified span and
residual) and a tighter interpolated-delay tolerance.
* Address review notes: cepstrum terminology, band-pass claims, edge validation
- Guides (docs and site, EN and ES): call the signed quantity what it is,
Milner's cepstrum of the log-power spectrum, and spell out that
Bogert's original 1963 power cepstrum squares once more and is
non-negative, so the signed rahmonics are the library's documented
convention; qualify the band-pass front end (out-of-band content is
strongly attenuated, not eliminated: finite Butterworth rejection and
small zero-phase edge transients).
- cepstrum: render reflection_coefficient as inline code in the
delay_samples docstring so the generated API page stops linking the
unrelated underwater seabed function.
- envelope: validate that 'band' is exactly two numeric edges before
indexing (a one-item tuple raised IndexError, extra entries were
ignored); the validated edges now travel to the result.
- equalizer: reject finite but unrepresentable gains through a shared
_gain_amplitude helper (10^(gain_db/40) overflowing, or underflowing
to zero and then dividing by zero in the designers); document the 0 dB
exception to the shelf-slope bound on the slope field.
- tone_burst: validate the repetition configuration before emitting the
incommensurate-frequency warning, so invalid setups raise even under
a warnings-as-errors filter.
- comb_filter_response: reject phase products that overflow to infinity
(sin(inf) returned NaN instead of the documented bounded response).
Tests for every new rejection path; API reference and llms regenerated.
* Test the representable gain amplitude as a positive finite bound
* Scope the first-rahmonic height claim to the source-free identity
Correct DSP estimator edge cases: TSA time axis, echo detection, EQ validation (#356)
* Report the true 1/fs time axis from time_synchronous_average
The averaged samples sit on the 1/fs sampling grid (each block is aligned
back to it by the band-limited fractional delay before averaging), but the
result reported a time axis with T/M spacing. For a non-integer number of
samples per period the two grids drift apart across the period: with
100.37 samples per period the noiseless recovery error read against the
reported axis was 9.3e-2, versus 2.8e-6 on the true m/fs grid.
Return times = arange(M)/fs, document that the M samples cover the period
only approximately when fs*T is not an integer (McFadden 1987 revised
model: a block average on the sampling grid, no angular resampling), and
assert the non-integer-period tests on the true grid, with a regression
test pinning the 100.37-sample case on both grids. Also soften the comb
response [0, 1] claim (float cancellation beside a tooth can exceed 1 by
a few 1e-9) and mark the ~14 dB N = 32 figure as derived from Eq. 8
rather than printed in the paper.
* Detect inverting echoes and off-sample delays in echo_detection
echo_detection picked the maximum of the signed power cepstrum, so an
inverting reflection (a < 0), whose first rahmonic is a itself and hence
negative, was silently missed: with a = -0.4 at 313 samples the true
rahmonic c[313] = -0.42 was ignored and an unrelated 4739-sample peak
returned. Peak-pick on |cepstrum| within the searched band instead and
report the signed cepstrum value at the peak as the reflection
coefficient (the Mercator series ln(1 + a e^{-j theta}) holds for either
sign of a).
Also refine the reported delay by three-point parabolic interpolation of
|cepstrum| through the peak, so an off-sample delay (e.g. 313.5 samples)
is estimated to a fraction of a sample, and document the bin-splitting
caveat: at off-sample delays the peak-sample coefficient underestimates
|a| (about 65 % of it midway between bins). One-line convention note
distinguishing Milner's IDFT(ln|X|^2) power cepstrum from Bogert's
squared original. Tests cover a < 0 (exact impulse-echo closed form and
a noise source) and the interpolated half-sample delay.
* Validate parametric-EQ sections at the numerical extremes
Three validation gaps in the RBJ cookbook designer:
- A wide 'bw' at an f0 near Nyquist drives the w0/sin(w0) warping factor
into math.sinh overflow, escaping as a raw OverflowError; slightly less
extreme pairs produced a large but finite alpha whose rounded a2 landed
exactly at -1.0: poles on the unit circle designed silently. Wrap the
sinh with an informative ValueError and check the realized coefficients
against the stability triangle (|a2| < 1, |a1| < 1 + a2) after
normalization.
- A shelf slope beyond the gain-dependent bound (A + 1/A)/(A + 1/A - 2)
makes the cookbook's alpha complex and surfaced as a bare 'math domain
error'. Validate the bound at section construction with the limit in
the message (any slope is fine at 0 dB, where A = 1).
- Non-finite f0/gain_db/q/bw/slope passed validation silently (NaN
compares false against every bound) and produced NaN/inf coefficient
rows. Require finiteness explicitly.
Tests cover all three paths plus extreme-but-valid sections that must
keep designing stably.
* Scope the envelope-spectrum amplitude claim and add the band-pass front end
The docstring promised that a sinusoidal modulation 'reads out as a line
at its exact amplitude'; that holds only when the modulation frequency
falls on an analysis bin. Off-bin lines read low by the taper's
scalloping loss (about 1.42 dB, ~15 %, for the default Hann midway
between bins), like any single-record amplitude spectrum. State the
on-bin condition on the closed forms and the caveat in the module,
function and result docstrings, pinned by a midway-between-bins test.
Also add the optional band=(low, high) pre-filter to envelope_spectrum:
a zero-phase 4th-order Butterworth band-pass ahead of the detector, the
band-pass front end of Bendat & Piersol Figure 13.11 and the classical
bearing-envelope chain (isolate the excited resonance band, then
envelope it). The band travels with the result; a test shows it
recovering the exact modulation line under a strong out-of-band
interferer that swamps the raw envelope.
* Warn when a tone burst cannot close on the tone's zero crossing
IEC 60268-1 Clause A2.1 asks for an integral number of full periods, but
the gate closes after round(fs*cycles/frequency) samples: sample-exact
only when f and fs are commensurate. For 10 cycles of 997 Hz at 48 kHz
the burst spans 481.44 samples, gated at 481, and the waveform carries a
residual step at the gate edge. Document the condition and emit a
PhonometryWarning quantifying the realized residual (bounded by
amplitude*sin(pi*f/fs)) for incommensurate pairs; commensurate bursts
stay silent.
Also tighten the resampler's 'equiripple-bounded' wording: the Kaiser
window method bounds both bands by the same delta = 10^(-A/20), but its
ripple decays away from the band edges, unlike a true equiripple design.
* Document estimator conventions verified against their sources
Documentation and comment corrections, no behavior changes:
- random_data: keep the reverse-arrangement acceptance bounds on the
normal approximation deliberately and say why: B&P Table A.6 itself
follows it, and no percentage-point convention on the exact Mahonian
distribution reproduces the published entries (N = 40 and N = 100 at
a = 0.975 pin it down), so exact bounds would disagree with the table
users check against. The p-value stays exact; the one-count boundary
disagreement is now documented on TrendTestResult.
- time_frequency: the spectrogram energy-recovery statement was wrong as
written; integrating 'density' columns over frequency and summing over
time recovers the record energy only after multiplying by the hop
duration, up to the taper roll-off at the record edges (verified
0.988 vs 1 for Hann at 75 % overlap on white noise).
- spectra: note that the adaptive multitaper sigma^2 is mean(x^2) with no
mean removal (consistent with the documented no-detrending
calibration), and mark the 'P&W Eq. 369a' citation as pending
verification against the book.
- compliance + tests/reference_data: transcription note for the bare
'+3' at 20 Hz, Type 2, in ANSI S1.4-1983 Table V (read as upper-only;
+/-3 plausible; either way the verdict cannot change, the realized
deviation is -0.05 dB).
- room_ir: the Mueller & Massarani 'below 4 dB' crest-factor figure
assumes their slight magnitude smoothing, which shaped_sweep_signal
does not implement; measured sweeps here sit at 4.2-4.3 dB.
* Translate EQ section labels, complete the bibliography and changelog
- The per-section legend labels of the parametric-EQ plot printed the raw
English filter-type names in Spanish figures; route them through the
plot string table (peaking -> campana, shelves, band-pass, notch,
all-pass; lowpass/highpass were already translated for the lifter
plot). English output stays byte-identical.
- docs/references.md: add the Harris 1978 window paper and IEC
60268-1:1985, both cited by guide pages but missing from the collected
bibliography; link the IEC entry (and the one in test-signals.md) to
the IEC webstore page.
- Changelog entries for the DSP fixes; regenerate the API reference,
llms-full.txt and the cepstrum_echo figures (the detected-echo marker
moved by the sub-sample delay interpolation); the conformance report is
unchanged (419/419).
* Propagate the echo and envelope semantics to the site guides
Review follow-ups:
- The EN and ES site guides (cepstrum-echoes.mdx) still described the
old echo reading and the unqualified 'exact amplitude' claim; bring
them in step with docs/cepstrum-echoes.md: |cepstrum| peak-picking,
signed coefficient, interpolated delay, bin-splitting caveat, the
on-bin/scalloping condition and the new band= front end (the docs page
gains the same envelope-section text).
- State in the changelog and the result docstring that delay is no
longer exactly delay_samples/fs when the interpolated offset is
nonzero (delay_samples remains the whole-sample index the coefficient
is read at), and merge the duplicated Unreleased headings.
- Clearer stability message (poles 'do not lie strictly inside the unit
circle', full-precision coefficients) and an informative short-record
error for the envelope band-pass pre-filter instead of scipy's padlen
message.
- Sharper tone-burst warning test (asserts the quantified span and
residual) and a tighter interpolated-delay tolerance.
* Address review notes: cepstrum terminology, band-pass claims, edge validation
- Guides (docs and site, EN and ES): call the signed quantity what it is,
Milner's cepstrum of the log-power spectrum, and spell out that
Bogert's original 1963 power cepstrum squares once more and is
non-negative, so the signed rahmonics are the library's documented
convention; qualify the band-pass front end (out-of-band content is
strongly attenuated, not eliminated: finite Butterworth rejection and
small zero-phase edge transients).
- cepstrum: render reflection_coefficient as inline code in the
delay_samples docstring so the generated API page stops linking the
unrelated underwater seabed function.
- envelope: validate that 'band' is exactly two numeric edges before
indexing (a one-item tuple raised IndexError, extra entries were
ignored); the validated edges now travel to the result.
- equalizer: reject finite but unrepresentable gains through a shared
_gain_amplitude helper (10^(gain_db/40) overflowing, or underflowing
to zero and then dividing by zero in the designers); document the 0 dB
exception to the shelf-slope bound on the slope field.
- tone_burst: validate the repetition configuration before emitting the
incommensurate-frequency warning, so invalid setups raise even under
a warnings-as-errors filter.
- comb_filter_response: reject phase products that overflow to infinity
(sin(inf) returned NaN instead of the documented bounded response).
Tests for every new rejection path; API reference and llms regenerated.
* Test the representable gain amplitude as a positive finite bound
* Scope the first-rahmonic height claim to the source-free identity
Correct DSP estimator edge cases: TSA time axis, echo detection, EQ validation (#356)
* Report the true 1/fs time axis from time_synchronous_average
The averaged samples sit on the 1/fs sampling grid (each block is aligned
back to it by the band-limited fractional delay before averaging), but the
result reported a time axis with T/M spacing. For a non-integer number of
samples per period the two grids drift apart across the period: with
100.37 samples per period the noiseless recovery error read against the
reported axis was 9.3e-2, versus 2.8e-6 on the true m/fs grid.
Return times = arange(M)/fs, document that the M samples cover the period
only approximately when fs*T is not an integer (McFadden 1987 revised
model: a block average on the sampling grid, no angular resampling), and
assert the non-integer-period tests on the true grid, with a regression
test pinning the 100.37-sample case on both grids. Also soften the comb
response [0, 1] claim (float cancellation beside a tooth can exceed 1 by
a few 1e-9) and mark the ~14 dB N = 32 figure as derived from Eq. 8
rather than printed in the paper.
* Detect inverting echoes and off-sample delays in echo_detection
echo_detection picked the maximum of the signed power cepstrum, so an
inverting reflection (a < 0), whose first rahmonic is a itself and hence
negative, was silently missed: with a = -0.4 at 313 samples the true
rahmonic c[313] = -0.42 was ignored and an unrelated 4739-sample peak
returned. Peak-pick on |cepstrum| within the searched band instead and
report the signed cepstrum value at the peak as the reflection
coefficient (the Mercator series ln(1 + a e^{-j theta}) holds for either
sign of a).
Also refine the reported delay by three-point parabolic interpolation of
|cepstrum| through the peak, so an off-sample delay (e.g. 313.5 samples)
is estimated to a fraction of a sample, and document the bin-splitting
caveat: at off-sample delays the peak-sample coefficient underestimates
|a| (about 65 % of it midway between bins). One-line convention note
distinguishing Milner's IDFT(ln|X|^2) power cepstrum from Bogert's
squared original. Tests cover a < 0 (exact impulse-echo closed form and
a noise source) and the interpolated half-sample delay.
* Validate parametric-EQ sections at the numerical extremes
Three validation gaps in the RBJ cookbook designer:
- A wide 'bw' at an f0 near Nyquist drives the w0/sin(w0) warping factor
into math.sinh overflow, escaping as a raw OverflowError; slightly less
extreme pairs produced a large but finite alpha whose rounded a2 landed
exactly at -1.0: poles on the unit circle designed silently. Wrap the
sinh with an informative ValueError and check the realized coefficients
against the stability triangle (|a2| < 1, |a1| < 1 + a2) after
normalization.
- A shelf slope beyond the gain-dependent bound (A + 1/A)/(A + 1/A - 2)
makes the cookbook's alpha complex and surfaced as a bare 'math domain
error'. Validate the bound at section construction with the limit in
the message (any slope is fine at 0 dB, where A = 1).
- Non-finite f0/gain_db/q/bw/slope passed validation silently (NaN
compares false against every bound) and produced NaN/inf coefficient
rows. Require finiteness explicitly.
Tests cover all three paths plus extreme-but-valid sections that must
keep designing stably.
* Scope the envelope-spectrum amplitude claim and add the band-pass front end
The docstring promised that a sinusoidal modulation 'reads out as a line
at its exact amplitude'; that holds only when the modulation frequency
falls on an analysis bin. Off-bin lines read low by the taper's
scalloping loss (about 1.42 dB, ~15 %, for the default Hann midway
between bins), like any single-record amplitude spectrum. State the
on-bin condition on the closed forms and the caveat in the module,
function and result docstrings, pinned by a midway-between-bins test.
Also add the optional band=(low, high) pre-filter to envelope_spectrum:
a zero-phase 4th-order Butterworth band-pass ahead of the detector, the
band-pass front end of Bendat & Piersol Figure 13.11 and the classical
bearing-envelope chain (isolate the excited resonance band, then
envelope it). The band travels with the result; a test shows it
recovering the exact modulation line under a strong out-of-band
interferer that swamps the raw envelope.
* Warn when a tone burst cannot close on the tone's zero crossing
IEC 60268-1 Clause A2.1 asks for an integral number of full periods, but
the gate closes after round(fs*cycles/frequency) samples: sample-exact
only when f and fs are commensurate. For 10 cycles of 997 Hz at 48 kHz
the burst spans 481.44 samples, gated at 481, and the waveform carries a
residual step at the gate edge. Document the condition and emit a
PhonometryWarning quantifying the realized residual (bounded by
amplitude*sin(pi*f/fs)) for incommensurate pairs; commensurate bursts
stay silent.
Also tighten the resampler's 'equiripple-bounded' wording: the Kaiser
window method bounds both bands by the same delta = 10^(-A/20), but its
ripple decays away from the band edges, unlike a true equiripple design.
* Document estimator conventions verified against their sources
Documentation and comment corrections, no behavior changes:
- random_data: keep the reverse-arrangement acceptance bounds on the
normal approximation deliberately and say why: B&P Table A.6 itself
follows it, and no percentage-point convention on the exact Mahonian
distribution reproduces the published entries (N = 40 and N = 100 at
a = 0.975 pin it down), so exact bounds would disagree with the table
users check against. The p-value stays exact; the one-count boundary
disagreement is now documented on TrendTestResult.
- time_frequency: the spectrogram energy-recovery statement was wrong as
written; integrating 'density' columns over frequency and summing over
time recovers the record energy only after multiplying by the hop
duration, up to the taper roll-off at the record edges (verified
0.988 vs 1 for Hann at 75 % overlap on white noise).
- spectra: note that the adaptive multitaper sigma^2 is mean(x^2) with no
mean removal (consistent with the documented no-detrending
calibration), and mark the 'P&W Eq. 369a' citation as pending
verification against the book.
- compliance + tests/reference_data: transcription note for the bare
'+3' at 20 Hz, Type 2, in ANSI S1.4-1983 Table V (read as upper-only;
+/-3 plausible; either way the verdict cannot change, the realized
deviation is -0.05 dB).
- room_ir: the Mueller & Massarani 'below 4 dB' crest-factor figure
assumes their slight magnitude smoothing, which shaped_sweep_signal
does not implement; measured sweeps here sit at 4.2-4.3 dB.
* Translate EQ section labels, complete the bibliography and changelog
- The per-section legend labels of the parametric-EQ plot printed the raw
English filter-type names in Spanish figures; route them through the
plot string table (peaking -> campana, shelves, band-pass, notch,
all-pass; lowpass/highpass were already translated for the lifter
plot). English output stays byte-identical.
- docs/references.md: add the Harris 1978 window paper and IEC
60268-1:1985, both cited by guide pages but missing from the collected
bibliography; link the IEC entry (and the one in test-signals.md) to
the IEC webstore page.
- Changelog entries for the DSP fixes; regenerate the API reference,
llms-full.txt and the cepstrum_echo figures (the detected-echo marker
moved by the sub-sample delay interpolation); the conformance report is
unchanged (419/419).
* Propagate the echo and envelope semantics to the site guides
Review follow-ups:
- The EN and ES site guides (cepstrum-echoes.mdx) still described the
old echo reading and the unqualified 'exact amplitude' claim; bring
them in step with docs/cepstrum-echoes.md: |cepstrum| peak-picking,
signed coefficient, interpolated delay, bin-splitting caveat, the
on-bin/scalloping condition and the new band= front end (the docs page
gains the same envelope-section text).
- State in the changelog and the result docstring that delay is no
longer exactly delay_samples/fs when the interpolated offset is
nonzero (delay_samples remains the whole-sample index the coefficient
is read at), and merge the duplicated Unreleased headings.
- Clearer stability message (poles 'do not lie strictly inside the unit
circle', full-precision coefficients) and an informative short-record
error for the envelope band-pass pre-filter instead of scipy's padlen
message.
- Sharper tone-burst warning test (asserts the quantified span and
residual) and a tighter interpolated-delay tolerance.
* Address review notes: cepstrum terminology, band-pass claims, edge validation
- Guides (docs and site, EN and ES): call the signed quantity what it is,
Milner's cepstrum of the log-power spectrum, and spell out that
Bogert's original 1963 power cepstrum squares once more and is
non-negative, so the signed rahmonics are the library's documented
convention; qualify the band-pass front end (out-of-band content is
strongly attenuated, not eliminated: finite Butterworth rejection and
small zero-phase edge transients).
- cepstrum: render reflection_coefficient as inline code in the
delay_samples docstring so the generated API page stops linking the
unrelated underwater seabed function.
- envelope: validate that 'band' is exactly two numeric edges before
indexing (a one-item tuple raised IndexError, extra entries were
ignored); the validated edges now travel to the result.
- equalizer: reject finite but unrepresentable gains through a shared
_gain_amplitude helper (10^(gain_db/40) overflowing, or underflowing
to zero and then dividing by zero in the designers); document the 0 dB
exception to the shelf-slope bound on the slope field.
- tone_burst: validate the repetition configuration before emitting the
incommensurate-frequency warning, so invalid setups raise even under
a warnings-as-errors filter.
- comb_filter_response: reject phase products that overflow to infinity
(sin(inf) returned NaN instead of the documented bounded response).
Tests for every new rejection path; API reference and llms regenerated.
* Test the representable gain amplitude as a positive finite bound
* Scope the first-rahmonic height claim to the source-free identity
Correct DSP estimator edge cases: TSA time axis, echo detection, EQ validation (#356)
* Report the true 1/fs time axis from time_synchronous_average
The averaged samples sit on the 1/fs sampling grid (each block is aligned
back to it by the band-limited fractional delay before averaging), but the
result reported a time axis with T/M spacing. For a non-integer number of
samples per period the two grids drift apart across the period: with
100.37 samples per period the noiseless recovery error read against the
reported axis was 9.3e-2, versus 2.8e-6 on the true m/fs grid.
Return times = arange(M)/fs, document that the M samples cover the period
only approximately when fs*T is not an integer (McFadden 1987 revised
model: a block average on the sampling grid, no angular resampling), and
assert the non-integer-period tests on the true grid, with a regression
test pinning the 100.37-sample case on both grids. Also soften the comb
response [0, 1] claim (float cancellation beside a tooth can exceed 1 by
a few 1e-9) and mark the ~14 dB N = 32 figure as derived from Eq. 8
rather than printed in the paper.
* Detect inverting echoes and off-sample delays in echo_detection
echo_detection picked the maximum of the signed power cepstrum, so an
inverting reflection (a < 0), whose first rahmonic is a itself and hence
negative, was silently missed: with a = -0.4 at 313 samples the true
rahmonic c[313] = -0.42 was ignored and an unrelated 4739-sample peak
returned. Peak-pick on |cepstrum| within the searched band instead and
report the signed cepstrum value at the peak as the reflection
coefficient (the Mercator series ln(1 + a e^{-j theta}) holds for either
sign of a).
Also refine the reported delay by three-point parabolic interpolation of
|cepstrum| through the peak, so an off-sample delay (e.g. 313.5 samples)
is estimated to a fraction of a sample, and document the bin-splitting
caveat: at off-sample delays the peak-sample coefficient underestimates
|a| (about 65 % of it midway between bins). One-line convention note
distinguishing Milner's IDFT(ln|X|^2) power cepstrum from Bogert's
squared original. Tests cover a < 0 (exact impulse-echo closed form and
a noise source) and the interpolated half-sample delay.
* Validate parametric-EQ sections at the numerical extremes
Three validation gaps in the RBJ cookbook designer:
- A wide 'bw' at an f0 near Nyquist drives the w0/sin(w0) warping factor
into math.sinh overflow, escaping as a raw OverflowError; slightly less
extreme pairs produced a large but finite alpha whose rounded a2 landed
exactly at -1.0: poles on the unit circle designed silently. Wrap the
sinh with an informative ValueError and check the realized coefficients
against the stability triangle (|a2| < 1, |a1| < 1 + a2) after
normalization.
- A shelf slope beyond the gain-dependent bound (A + 1/A)/(A + 1/A - 2)
makes the cookbook's alpha complex and surfaced as a bare 'math domain
error'. Validate the bound at section construction with the limit in
the message (any slope is fine at 0 dB, where A = 1).
- Non-finite f0/gain_db/q/bw/slope passed validation silently (NaN
compares false against every bound) and produced NaN/inf coefficient
rows. Require finiteness explicitly.
Tests cover all three paths plus extreme-but-valid sections that must
keep designing stably.
* Scope the envelope-spectrum amplitude claim and add the band-pass front end
The docstring promised that a sinusoidal modulation 'reads out as a line
at its exact amplitude'; that holds only when the modulation frequency
falls on an analysis bin. Off-bin lines read low by the taper's
scalloping loss (about 1.42 dB, ~15 %, for the default Hann midway
between bins), like any single-record amplitude spectrum. State the
on-bin condition on the closed forms and the caveat in the module,
function and result docstrings, pinned by a midway-between-bins test.
Also add the optional band=(low, high) pre-filter to envelope_spectrum:
a zero-phase 4th-order Butterworth band-pass ahead of the detector, the
band-pass front end of Bendat & Piersol Figure 13.11 and the classical
bearing-envelope chain (isolate the excited resonance band, then
envelope it). The band travels with the result; a test shows it
recovering the exact modulation line under a strong out-of-band
interferer that swamps the raw envelope.
* Warn when a tone burst cannot close on the tone's zero crossing
IEC 60268-1 Clause A2.1 asks for an integral number of full periods, but
the gate closes after round(fs*cycles/frequency) samples: sample-exact
only when f and fs are commensurate. For 10 cycles of 997 Hz at 48 kHz
the burst spans 481.44 samples, gated at 481, and the waveform carries a
residual step at the gate edge. Document the condition and emit a
PhonometryWarning quantifying the realized residual (bounded by
amplitude*sin(pi*f/fs)) for incommensurate pairs; commensurate bursts
stay silent.
Also tighten the resampler's 'equiripple-bounded' wording: the Kaiser
window method bounds both bands by the same delta = 10^(-A/20), but its
ripple decays away from the band edges, unlike a true equiripple design.
* Document estimator conventions verified against their sources
Documentation and comment corrections, no behavior changes:
- random_data: keep the reverse-arrangement acceptance bounds on the
normal approximation deliberately and say why: B&P Table A.6 itself
follows it, and no percentage-point convention on the exact Mahonian
distribution reproduces the published entries (N = 40 and N = 100 at
a = 0.975 pin it down), so exact bounds would disagree with the table
users check against. The p-value stays exact; the one-count boundary
disagreement is now documented on TrendTestResult.
- time_frequency: the spectrogram energy-recovery statement was wrong as
written; integrating 'density' columns over frequency and summing over
time recovers the record energy only after multiplying by the hop
duration, up to the taper roll-off at the record edges (verified
0.988 vs 1 for Hann at 75 % overlap on white noise).
- spectra: note that the adaptive multitaper sigma^2 is mean(x^2) with no
mean removal (consistent with the documented no-detrending
calibration), and mark the 'P&W Eq. 369a' citation as pending
verification against the book.
- compliance + tests/reference_data: transcription note for the bare
'+3' at 20 Hz, Type 2, in ANSI S1.4-1983 Table V (read as upper-only;
+/-3 plausible; either way the verdict cannot change, the realized
deviation is -0.05 dB).
- room_ir: the Mueller & Massarani 'below 4 dB' crest-factor figure
assumes their slight magnitude smoothing, which shaped_sweep_signal
does not implement; measured sweeps here sit at 4.2-4.3 dB.
* Translate EQ section labels, complete the bibliography and changelog
- The per-section legend labels of the parametric-EQ plot printed the raw
English filter-type names in Spanish figures; route them through the
plot string table (peaking -> campana, shelves, band-pass, notch,
all-pass; lowpass/highpass were already translated for the lifter
plot). English output stays byte-identical.
- docs/references.md: add the Harris 1978 window paper and IEC
60268-1:1985, both cited by guide pages but missing from the collected
bibliography; link the IEC entry (and the one in test-signals.md) to
the IEC webstore page.
- Changelog entries for the DSP fixes; regenerate the API reference,
llms-full.txt and the cepstrum_echo figures (the detected-echo marker
moved by the sub-sample delay interpolation); the conformance report is
unchanged (419/419).
* Propagate the echo and envelope semantics to the site guides
Review follow-ups:
- The EN and ES site guides (cepstrum-echoes.mdx) still described the
old echo reading and the unqualified 'exact amplitude' claim; bring
them in step with docs/cepstrum-echoes.md: |cepstrum| peak-picking,
signed coefficient, interpolated delay, bin-splitting caveat, the
on-bin/scalloping condition and the new band= front end (the docs page
gains the same envelope-section text).
- State in the changelog and the result docstring that delay is no
longer exactly delay_samples/fs when the interpolated offset is
nonzero (delay_samples remains the whole-sample index the coefficient
is read at), and merge the duplicated Unreleased headings.
- Clearer stability message (poles 'do not lie strictly inside the unit
circle', full-precision coefficients) and an informative short-record
error for the envelope band-pass pre-filter instead of scipy's padlen
message.
- Sharper tone-burst warning test (asserts the quantified span and
residual) and a tighter interpolated-delay tolerance.
* Address review notes: cepstrum terminology, band-pass claims, edge validation
- Guides (docs and site, EN and ES): call the signed quantity what it is,
Milner's cepstrum of the log-power spectrum, and spell out that
Bogert's original 1963 power cepstrum squares once more and is
non-negative, so the signed rahmonics are the library's documented
convention; qualify the band-pass front end (out-of-band content is
strongly attenuated, not eliminated: finite Butterworth rejection and
small zero-phase edge transients).
- cepstrum: render reflection_coefficient as inline code in the
delay_samples docstring so the generated API page stops linking the
unrelated underwater seabed function.
- envelope: validate that 'band' is exactly two numeric edges before
indexing (a one-item tuple raised IndexError, extra entries were
ignored); the validated edges now travel to the result.
- equalizer: reject finite but unrepresentable gains through a shared
_gain_amplitude helper (10^(gain_db/40) overflowing, or underflowing
to zero and then dividing by zero in the designers); document the 0 dB
exception to the shelf-slope bound on the slope field.
- tone_burst: validate the repetition configuration before emitting the
incommensurate-frequency warning, so invalid setups raise even under
a warnings-as-errors filter.
- comb_filter_response: reject phase products that overflow to infinity
(sin(inf) returned NaN instead of the documented bounded response).
Tests for every new rejection path; API reference and llms regenerated.
* Test the representable gain amplitude as a positive finite bound
* Scope the first-rahmonic height claim to the source-free identity
Core metrology guides: result figures, ResampledSignalResult.plot() and real introductions (#364)
* Add ResampledSignalResult.plot(): the delivered anti-alias filter against its design spec
* Rewrite the multichannel guide intro: concrete use cases, per-channel guarantees, Bendat & Piersol citations
* Give the levels page a real introduction: descriptor families, when-to-use guidance and survey references
* Time weighting: framing intro with detector history, ANSI S1.4/Bies references and sibling links
* Calibration: proper introduction (SPL vs dBFS choice, workflow framing) with Bies reference and sibling links
* Add eleven core-metrology figures: resampling spec, cepstrum variants, liftering, correlation, IR alignment, Hilbert envelope, cross-spectra, Golay recovery, TSA noise law, runs test
* Test signals: anti-alias figure with dual snippet, res.plot() mention, See also, docs mirror sync
* Cepstrum guide: variants and liftering figures with dual snippets, complex-cepstrum plot mention
* Correlation guide: normalization, IR-alignment and Hilbert-envelope figures with dual snippets
* Spectral analysis: cross-spectral density and coherent-output-SNR figures with dual snippets
* System measurement: Golay exact-recovery figure and plot mentions for the inversion workflow
* Synchronous averaging: sqrt(N) figure, diagnostics-tool guidance, See also, recording naming
* Data qualification: runs-test figure with dual snippet and peak-statistics plot mention
* MISO coherence: conditioning-order snippet, practical pitfalls and See also across the three trees
* Time-frequency: Harris window reference and See also across the three trees
* GUM uncertainty: map the domain pages that consume the clause-5 machinery, expand See also
* Filter banks: compliance plot mentions and recording naming in the crossover snippet
* Changelog entry for the core-metrology documentation figures and prose
* Regenerate llms-full.txt for the core-metrology documentation
* Drop the duplicated phase-axis translation key
Core metrology guides: result figures, ResampledSignalResult.plot() and real introductions (#364)
* Add ResampledSignalResult.plot(): the delivered anti-alias filter against its design spec
* Rewrite the multichannel guide intro: concrete use cases, per-channel guarantees, Bendat & Piersol citations
* Give the levels page a real introduction: descriptor families, when-to-use guidance and survey references
* Time weighting: framing intro with detector history, ANSI S1.4/Bies references and sibling links
* Calibration: proper introduction (SPL vs dBFS choice, workflow framing) with Bies reference and sibling links
* Add eleven core-metrology figures: resampling spec, cepstrum variants, liftering, correlation, IR alignment, Hilbert envelope, cross-spectra, Golay recovery, TSA noise law, runs test
* Test signals: anti-alias figure with dual snippet, res.plot() mention, See also, docs mirror sync
* Cepstrum guide: variants and liftering figures with dual snippets, complex-cepstrum plot mention
* Correlation guide: normalization, IR-alignment and Hilbert-envelope figures with dual snippets
* Spectral analysis: cross-spectral density and coherent-output-SNR figures with dual snippets
* System measurement: Golay exact-recovery figure and plot mentions for the inversion workflow
* Synchronous averaging: sqrt(N) figure, diagnostics-tool guidance, See also, recording naming
* Data qualification: runs-test figure with dual snippet and peak-statistics plot mention
* MISO coherence: conditioning-order snippet, practical pitfalls and See also across the three trees
* Time-frequency: Harris window reference and See also across the three trees
* GUM uncertainty: map the domain pages that consume the clause-5 machinery, expand See also
* Filter banks: compliance plot mentions and recording naming in the crossover snippet
* Changelog entry for the core-metrology documentation figures and prose
* Regenerate llms-full.txt for the core-metrology documentation
* Drop the duplicated phase-axis translation key
Core metrology guides: result figures, ResampledSignalResult.plot() and real introductions (#364)
* Add ResampledSignalResult.plot(): the delivered anti-alias filter against its design spec
* Rewrite the multichannel guide intro: concrete use cases, per-channel guarantees, Bendat & Piersol citations
* Give the levels page a real introduction: descriptor families, when-to-use guidance and survey references
* Time weighting: framing intro with detector history, ANSI S1.4/Bies references and sibling links
* Calibration: proper introduction (SPL vs dBFS choice, workflow framing) with Bies reference and sibling links
* Add eleven core-metrology figures: resampling spec, cepstrum variants, liftering, correlation, IR alignment, Hilbert envelope, cross-spectra, Golay recovery, TSA noise law, runs test
* Test signals: anti-alias figure with dual snippet, res.plot() mention, See also, docs mirror sync
* Cepstrum guide: variants and liftering figures with dual snippets, complex-cepstrum plot mention
* Correlation guide: normalization, IR-alignment and Hilbert-envelope figures with dual snippets
* Spectral analysis: cross-spectral density and coherent-output-SNR figures with dual snippets
* System measurement: Golay exact-recovery figure and plot mentions for the inversion workflow
* Synchronous averaging: sqrt(N) figure, diagnostics-tool guidance, See also, recording naming
* Data qualification: runs-test figure with dual snippet and peak-statistics plot mention
* MISO coherence: conditioning-order snippet, practical pitfalls and See also across the three trees
* Time-frequency: Harris window reference and See also across the three trees
* GUM uncertainty: map the domain pages that consume the clause-5 machinery, expand See also
* Filter banks: compliance plot mentions and recording naming in the crossover snippet
* Changelog entry for the core-metrology documentation figures and prose
* Regenerate llms-full.txt for the core-metrology documentation
* Drop the duplicated phase-axis translation key
Core metrology guides: result figures, ResampledSignalResult.plot() and real introductions (#364)
* Add ResampledSignalResult.plot(): the delivered anti-alias filter against its design spec
* Rewrite the multichannel guide intro: concrete use cases, per-channel guarantees, Bendat & Piersol citations
* Give the levels page a real introduction: descriptor families, when-to-use guidance and survey references
* Time weighting: framing intro with detector history, ANSI S1.4/Bies references and sibling links
* Calibration: proper introduction (SPL vs dBFS choice, workflow framing) with Bies reference and sibling links
* Add eleven core-metrology figures: resampling spec, cepstrum variants, liftering, correlation, IR alignment, Hilbert envelope, cross-spectra, Golay recovery, TSA noise law, runs test
* Test signals: anti-alias figure with dual snippet, res.plot() mention, See also, docs mirror sync
* Cepstrum guide: variants and liftering figures with dual snippets, complex-cepstrum plot mention
* Correlation guide: normalization, IR-alignment and Hilbert-envelope figures with dual snippets
* Spectral analysis: cross-spectral density and coherent-output-SNR figures with dual snippets
* System measurement: Golay exact-recovery figure and plot mentions for the inversion workflow
* Synchronous averaging: sqrt(N) figure, diagnostics-tool guidance, See also, recording naming
* Data qualification: runs-test figure with dual snippet and peak-statistics plot mention
* MISO coherence: conditioning-order snippet, practical pitfalls and See also across the three trees
* Time-frequency: Harris window reference and See also across the three trees
* GUM uncertainty: map the domain pages that consume the clause-5 machinery, expand See also
* Filter banks: compliance plot mentions and recording naming in the crossover snippet
* Changelog entry for the core-metrology documentation figures and prose
* Regenerate llms-full.txt for the core-metrology documentation
* Drop the duplicated phase-axis translation key
Core metrology guides: result figures, ResampledSignalResult.plot() and real introductions (#364)
* Add ResampledSignalResult.plot(): the delivered anti-alias filter against its design spec
* Rewrite the multichannel guide intro: concrete use cases, per-channel guarantees, Bendat & Piersol citations
* Give the levels page a real introduction: descriptor families, when-to-use guidance and survey references
* Time weighting: framing intro with detector history, ANSI S1.4/Bies references and sibling links
* Calibration: proper introduction (SPL vs dBFS choice, workflow framing) with Bies reference and sibling links
* Add eleven core-metrology figures: resampling spec, cepstrum variants, liftering, correlation, IR alignment, Hilbert envelope, cross-spectra, Golay recovery, TSA noise law, runs test
* Test signals: anti-alias figure with dual snippet, res.plot() mention, See also, docs mirror sync
* Cepstrum guide: variants and liftering figures with dual snippets, complex-cepstrum plot mention
* Correlation guide: normalization, IR-alignment and Hilbert-envelope figures with dual snippets
* Spectral analysis: cross-spectral density and coherent-output-SNR figures with dual snippets
* System measurement: Golay exact-recovery figure and plot mentions for the inversion workflow
* Synchronous averaging: sqrt(N) figure, diagnostics-tool guidance, See also, recording naming
* Data qualification: runs-test figure with dual snippet and peak-statistics plot mention
* MISO coherence: conditioning-order snippet, practical pitfalls and See also across the three trees
* Time-frequency: Harris window reference and See also across the three trees
* GUM uncertainty: map the domain pages that consume the clause-5 machinery, expand See also
* Filter banks: compliance plot mentions and recording naming in the crossover snippet
* Changelog entry for the core-metrology documentation figures and prose
* Regenerate llms-full.txt for the core-metrology documentation
* Drop the duplicated phase-axis translation key
Core metrology guides: result figures, ResampledSignalResult.plot() and real introductions (#364)
* Add ResampledSignalResult.plot(): the delivered anti-alias filter against its design spec
* Rewrite the multichannel guide intro: concrete use cases, per-channel guarantees, Bendat & Piersol citations
* Give the levels page a real introduction: descriptor families, when-to-use guidance and survey references
* Time weighting: framing intro with detector history, ANSI S1.4/Bies references and sibling links
* Calibration: proper introduction (SPL vs dBFS choice, workflow framing) with Bies reference and sibling links
* Add eleven core-metrology figures: resampling spec, cepstrum variants, liftering, correlation, IR alignment, Hilbert envelope, cross-spectra, Golay recovery, TSA noise law, runs test
* Test signals: anti-alias figure with dual snippet, res.plot() mention, See also, docs mirror sync
* Cepstrum guide: variants and liftering figures with dual snippets, complex-cepstrum plot mention
* Correlation guide: normalization, IR-alignment and Hilbert-envelope figures with dual snippets
* Spectral analysis: cross-spectral density and coherent-output-SNR figures with dual snippets
* System measurement: Golay exact-recovery figure and plot mentions for the inversion workflow
* Synchronous averaging: sqrt(N) figure, diagnostics-tool guidance, See also, recording naming
* Data qualification: runs-test figure with dual snippet and peak-statistics plot mention
* MISO coherence: conditioning-order snippet, practical pitfalls and See also across the three trees
* Time-frequency: Harris window reference and See also across the three trees
* GUM uncertainty: map the domain pages that consume the clause-5 machinery, expand See also
* Filter banks: compliance plot mentions and recording naming in the crossover snippet
* Changelog entry for the core-metrology documentation figures and prose
* Regenerate llms-full.txt for the core-metrology documentation
* Drop the duplicated phase-axis translation key
Core metrology guides: result figures, ResampledSignalResult.plot() and real introductions (#364)
* Add ResampledSignalResult.plot(): the delivered anti-alias filter against its design spec
* Rewrite the multichannel guide intro: concrete use cases, per-channel guarantees, Bendat & Piersol citations
* Give the levels page a real introduction: descriptor families, when-to-use guidance and survey references
* Time weighting: framing intro with detector history, ANSI S1.4/Bies references and sibling links
* Calibration: proper introduction (SPL vs dBFS choice, workflow framing) with Bies reference and sibling links
* Add eleven core-metrology figures: resampling spec, cepstrum variants, liftering, correlation, IR alignment, Hilbert envelope, cross-spectra, Golay recovery, TSA noise law, runs test
* Test signals: anti-alias figure with dual snippet, res.plot() mention, See also, docs mirror sync
* Cepstrum guide: variants and liftering figures with dual snippets, complex-cepstrum plot mention
* Correlation guide: normalization, IR-alignment and Hilbert-envelope figures with dual snippets
* Spectral analysis: cross-spectral density and coherent-output-SNR figures with dual snippets
* System measurement: Golay exact-recovery figure and plot mentions for the inversion workflow
* Synchronous averaging: sqrt(N) figure, diagnostics-tool guidance, See also, recording naming
* Data qualification: runs-test figure with dual snippet and peak-statistics plot mention
* MISO coherence: conditioning-order snippet, practical pitfalls and See also across the three trees
* Time-frequency: Harris window reference and See also across the three trees
* GUM uncertainty: map the domain pages that consume the clause-5 machinery, expand See also
* Filter banks: compliance plot mentions and recording naming in the crossover snippet
* Changelog entry for the core-metrology documentation figures and prose
* Regenerate llms-full.txt for the core-metrology documentation
* Drop the duplicated phase-axis translation key
Core metrology guides: result figures, ResampledSignalResult.plot() and real introductions (#364)
* Add ResampledSignalResult.plot(): the delivered anti-alias filter against its design spec
* Rewrite the multichannel guide intro: concrete use cases, per-channel guarantees, Bendat & Piersol citations
* Give the levels page a real introduction: descriptor families, when-to-use guidance and survey references
* Time weighting: framing intro with detector history, ANSI S1.4/Bies references and sibling links
* Calibration: proper introduction (SPL vs dBFS choice, workflow framing) with Bies reference and sibling links
* Add eleven core-metrology figures: resampling spec, cepstrum variants, liftering, correlation, IR alignment, Hilbert envelope, cross-spectra, Golay recovery, TSA noise law, runs test
* Test signals: anti-alias figure with dual snippet, res.plot() mention, See also, docs mirror sync
* Cepstrum guide: variants and liftering figures with dual snippets, complex-cepstrum plot mention
* Correlation guide: normalization, IR-alignment and Hilbert-envelope figures with dual snippets
* Spectral analysis: cross-spectral density and coherent-output-SNR figures with dual snippets
* System measurement: Golay exact-recovery figure and plot mentions for the inversion workflow
* Synchronous averaging: sqrt(N) figure, diagnostics-tool guidance, See also, recording naming
* Data qualification: runs-test figure with dual snippet and peak-statistics plot mention
* MISO coherence: conditioning-order snippet, practical pitfalls and See also across the three trees
* Time-frequency: Harris window reference and See also across the three trees
* GUM uncertainty: map the domain pages that consume the clause-5 machinery, expand See also
* Filter banks: compliance plot mentions and recording naming in the crossover snippet
* Changelog entry for the core-metrology documentation figures and prose
* Regenerate llms-full.txt for the core-metrology documentation
* Drop the duplicated phase-axis translation key
Core metrology guides: result figures, ResampledSignalResult.plot() and real introductions (#364)
* Add ResampledSignalResult.plot(): the delivered anti-alias filter against its design spec
* Rewrite the multichannel guide intro: concrete use cases, per-channel guarantees, Bendat & Piersol citations
* Give the levels page a real introduction: descriptor families, when-to-use guidance and survey references
* Time weighting: framing intro with detector history, ANSI S1.4/Bies references and sibling links
* Calibration: proper introduction (SPL vs dBFS choice, workflow framing) with Bies reference and sibling links
* Add eleven core-metrology figures: resampling spec, cepstrum variants, liftering, correlation, IR alignment, Hilbert envelope, cross-spectra, Golay recovery, TSA noise law, runs test
* Test signals: anti-alias figure with dual snippet, res.plot() mention, See also, docs mirror sync
* Cepstrum guide: variants and liftering figures with dual snippets, complex-cepstrum plot mention
* Correlation guide: normalization, IR-alignment and Hilbert-envelope figures with dual snippets
* Spectral analysis: cross-spectral density and coherent-output-SNR figures with dual snippets
* System measurement: Golay exact-recovery figure and plot mentions for the inversion workflow
* Synchronous averaging: sqrt(N) figure, diagnostics-tool guidance, See also, recording naming
* Data qualification: runs-test figure with dual snippet and peak-statistics plot mention
* MISO coherence: conditioning-order snippet, practical pitfalls and See also across the three trees
* Time-frequency: Harris window reference and See also across the three trees
* GUM uncertainty: map the domain pages that consume the clause-5 machinery, expand See also
* Filter banks: compliance plot mentions and recording naming in the crossover snippet
* Changelog entry for the core-metrology documentation figures and prose
* Regenerate llms-full.txt for the core-metrology documentation
* Drop the duplicated phase-axis translation key
Core metrology guides: result figures, ResampledSignalResult.plot() and real introductions (#364)
* Add ResampledSignalResult.plot(): the delivered anti-alias filter against its design spec
* Rewrite the multichannel guide intro: concrete use cases, per-channel guarantees, Bendat & Piersol citations
* Give the levels page a real introduction: descriptor families, when-to-use guidance and survey references
* Time weighting: framing intro with detector history, ANSI S1.4/Bies references and sibling links
* Calibration: proper introduction (SPL vs dBFS choice, workflow framing) with Bies reference and sibling links
* Add eleven core-metrology figures: resampling spec, cepstrum variants, liftering, correlation, IR alignment, Hilbert envelope, cross-spectra, Golay recovery, TSA noise law, runs test
* Test signals: anti-alias figure with dual snippet, res.plot() mention, See also, docs mirror sync
* Cepstrum guide: variants and liftering figures with dual snippets, complex-cepstrum plot mention
* Correlation guide: normalization, IR-alignment and Hilbert-envelope figures with dual snippets
* Spectral analysis: cross-spectral density and coherent-output-SNR figures with dual snippets
* System measurement: Golay exact-recovery figure and plot mentions for the inversion workflow
* Synchronous averaging: sqrt(N) figure, diagnostics-tool guidance, See also, recording naming
* Data qualification: runs-test figure with dual snippet and peak-statistics plot mention
* MISO coherence: conditioning-order snippet, practical pitfalls and See also across the three trees
* Time-frequency: Harris window reference and See also across the three trees
* GUM uncertainty: map the domain pages that consume the clause-5 machinery, expand See also
* Filter banks: compliance plot mentions and recording naming in the crossover snippet
* Changelog entry for the core-metrology documentation figures and prose
* Regenerate llms-full.txt for the core-metrology documentation
* Drop the duplicated phase-axis translation key
Core metrology guides: result figures, ResampledSignalResult.plot() and real introductions (#364)
* Add ResampledSignalResult.plot(): the delivered anti-alias filter against its design spec
* Rewrite the multichannel guide intro: concrete use cases, per-channel guarantees, Bendat & Piersol citations
* Give the levels page a real introduction: descriptor families, when-to-use guidance and survey references
* Time weighting: framing intro with detector history, ANSI S1.4/Bies references and sibling links
* Calibration: proper introduction (SPL vs dBFS choice, workflow framing) with Bies reference and sibling links
* Add eleven core-metrology figures: resampling spec, cepstrum variants, liftering, correlation, IR alignment, Hilbert envelope, cross-spectra, Golay recovery, TSA noise law, runs test
* Test signals: anti-alias figure with dual snippet, res.plot() mention, See also, docs mirror sync
* Cepstrum guide: variants and liftering figures with dual snippets, complex-cepstrum plot mention
* Correlation guide: normalization, IR-alignment and Hilbert-envelope figures with dual snippets
* Spectral analysis: cross-spectral density and coherent-output-SNR figures with dual snippets
* System measurement: Golay exact-recovery figure and plot mentions for the inversion workflow
* Synchronous averaging: sqrt(N) figure, diagnostics-tool guidance, See also, recording naming
* Data qualification: runs-test figure with dual snippet and peak-statistics plot mention
* MISO coherence: conditioning-order snippet, practical pitfalls and See also across the three trees
* Time-frequency: Harris window reference and See also across the three trees
* GUM uncertainty: map the domain pages that consume the clause-5 machinery, expand See also
* Filter banks: compliance plot mentions and recording naming in the crossover snippet
* Changelog entry for the core-metrology documentation figures and prose
* Regenerate llms-full.txt for the core-metrology documentation
* Drop the duplicated phase-axis translation key
Core metrology guides: result figures, ResampledSignalResult.plot() and real introductions (#364)
* Add ResampledSignalResult.plot(): the delivered anti-alias filter against its design spec
* Rewrite the multichannel guide intro: concrete use cases, per-channel guarantees, Bendat & Piersol citations
* Give the levels page a real introduction: descriptor families, when-to-use guidance and survey references
* Time weighting: framing intro with detector history, ANSI S1.4/Bies references and sibling links
* Calibration: proper introduction (SPL vs dBFS choice, workflow framing) with Bies reference and sibling links
* Add eleven core-metrology figures: resampling spec, cepstrum variants, liftering, correlation, IR alignment, Hilbert envelope, cross-spectra, Golay recovery, TSA noise law, runs test
* Test signals: anti-alias figure with dual snippet, res.plot() mention, See also, docs mirror sync
* Cepstrum guide: variants and liftering figures with dual snippets, complex-cepstrum plot mention
* Correlation guide: normalization, IR-alignment and Hilbert-envelope figures with dual snippets
* Spectral analysis: cross-spectral density and coherent-output-SNR figures with dual snippets
* System measurement: Golay exact-recovery figure and plot mentions for the inversion workflow
* Synchronous averaging: sqrt(N) figure, diagnostics-tool guidance, See also, recording naming
* Data qualification: runs-test figure with dual snippet and peak-statistics plot mention
* MISO coherence: conditioning-order snippet, practical pitfalls and See also across the three trees
* Time-frequency: Harris window reference and See also across the three trees
* GUM uncertainty: map the domain pages that consume the clause-5 machinery, expand See also
* Filter banks: compliance plot mentions and recording naming in the crossover snippet
* Changelog entry for the core-metrology documentation figures and prose
* Regenerate llms-full.txt for the core-metrology documentation
* Drop the duplicated phase-axis translation key
Core metrology guides: result figures, ResampledSignalResult.plot() and real introductions (#364)
* Add ResampledSignalResult.plot(): the delivered anti-alias filter against its design spec
* Rewrite the multichannel guide intro: concrete use cases, per-channel guarantees, Bendat & Piersol citations
* Give the levels page a real introduction: descriptor families, when-to-use guidance and survey references
* Time weighting: framing intro with detector history, ANSI S1.4/Bies references and sibling links
* Calibration: proper introduction (SPL vs dBFS choice, workflow framing) with Bies reference and sibling links
* Add eleven core-metrology figures: resampling spec, cepstrum variants, liftering, correlation, IR alignment, Hilbert envelope, cross-spectra, Golay recovery, TSA noise law, runs test
* Test signals: anti-alias figure with dual snippet, res.plot() mention, See also, docs mirror sync
* Cepstrum guide: variants and liftering figures with dual snippets, complex-cepstrum plot mention
* Correlation guide: normalization, IR-alignment and Hilbert-envelope figures with dual snippets
* Spectral analysis: cross-spectral density and coherent-output-SNR figures with dual snippets
* System measurement: Golay exact-recovery figure and plot mentions for the inversion workflow
* Synchronous averaging: sqrt(N) figure, diagnostics-tool guidance, See also, recording naming
* Data qualification: runs-test figure with dual snippet and peak-statistics plot mention
* MISO coherence: conditioning-order snippet, practical pitfalls and See also across the three trees
* Time-frequency: Harris window reference and See also across the three trees
* GUM uncertainty: map the domain pages that consume the clause-5 machinery, expand See also
* Filter banks: compliance plot mentions and recording naming in the crossover snippet
* Changelog entry for the core-metrology documentation figures and prose
* Regenerate llms-full.txt for the core-metrology documentation
* Drop the duplicated phase-axis translation key
Core metrology guides: result figures, ResampledSignalResult.plot() and real introductions (#364)
* Add ResampledSignalResult.plot(): the delivered anti-alias filter against its design spec
* Rewrite the multichannel guide intro: concrete use cases, per-channel guarantees, Bendat & Piersol citations
* Give the levels page a real introduction: descriptor families, when-to-use guidance and survey references
* Time weighting: framing intro with detector history, ANSI S1.4/Bies references and sibling links
* Calibration: proper introduction (SPL vs dBFS choice, workflow framing) with Bies reference and sibling links
* Add eleven core-metrology figures: resampling spec, cepstrum variants, liftering, correlation, IR alignment, Hilbert envelope, cross-spectra, Golay recovery, TSA noise law, runs test
* Test signals: anti-alias figure with dual snippet, res.plot() mention, See also, docs mirror sync
* Cepstrum guide: variants and liftering figures with dual snippets, complex-cepstrum plot mention
* Correlation guide: normalization, IR-alignment and Hilbert-envelope figures with dual snippets
* Spectral analysis: cross-spectral density and coherent-output-SNR figures with dual snippets
* System measurement: Golay exact-recovery figure and plot mentions for the inversion workflow
* Synchronous averaging: sqrt(N) figure, diagnostics-tool guidance, See also, recording naming
* Data qualification: runs-test figure with dual snippet and peak-statistics plot mention
* MISO coherence: conditioning-order snippet, practical pitfalls and See also across the three trees
* Time-frequency: Harris window reference and See also across the three trees
* GUM uncertainty: map the domain pages that consume the clause-5 machinery, expand See also
* Filter banks: compliance plot mentions and recording naming in the crossover snippet
* Changelog entry for the core-metrology documentation figures and prose
* Regenerate llms-full.txt for the core-metrology documentation
* Drop the duplicated phase-axis translation key
Core metrology guides: result figures, ResampledSignalResult.plot() and real introductions (#364)
* Add ResampledSignalResult.plot(): the delivered anti-alias filter against its design spec
* Rewrite the multichannel guide intro: concrete use cases, per-channel guarantees, Bendat & Piersol citations
* Give the levels page a real introduction: descriptor families, when-to-use guidance and survey references
* Time weighting: framing intro with detector history, ANSI S1.4/Bies references and sibling links
* Calibration: proper introduction (SPL vs dBFS choice, workflow framing) with Bies reference and sibling links
* Add eleven core-metrology figures: resampling spec, cepstrum variants, liftering, correlation, IR alignment, Hilbert envelope, cross-spectra, Golay recovery, TSA noise law, runs test
* Test signals: anti-alias figure with dual snippet, res.plot() mention, See also, docs mirror sync
* Cepstrum guide: variants and liftering figures with dual snippets, complex-cepstrum plot mention
* Correlation guide: normalization, IR-alignment and Hilbert-envelope figures with dual snippets
* Spectral analysis: cross-spectral density and coherent-output-SNR figures with dual snippets
* System measurement: Golay exact-recovery figure and plot mentions for the inversion workflow
* Synchronous averaging: sqrt(N) figure, diagnostics-tool guidance, See also, recording naming
* Data qualification: runs-test figure with dual snippet and peak-statistics plot mention
* MISO coherence: conditioning-order snippet, practical pitfalls and See also across the three trees
* Time-frequency: Harris window reference and See also across the three trees
* GUM uncertainty: map the domain pages that consume the clause-5 machinery, expand See also
* Filter banks: compliance plot mentions and recording naming in the crossover snippet
* Changelog entry for the core-metrology documentation figures and prose
* Regenerate llms-full.txt for the core-metrology documentation
* Drop the duplicated phase-axis translation key
Core metrology guides: result figures, ResampledSignalResult.plot() and real introductions (#364)
* Add ResampledSignalResult.plot(): the delivered anti-alias filter against its design spec
* Rewrite the multichannel guide intro: concrete use cases, per-channel guarantees, Bendat & Piersol citations
* Give the levels page a real introduction: descriptor families, when-to-use guidance and survey references
* Time weighting: framing intro with detector history, ANSI S1.4/Bies references and sibling links
* Calibration: proper introduction (SPL vs dBFS choice, workflow framing) with Bies reference and sibling links
* Add eleven core-metrology figures: resampling spec, cepstrum variants, liftering, correlation, IR alignment, Hilbert envelope, cross-spectra, Golay recovery, TSA noise law, runs test
* Test signals: anti-alias figure with dual snippet, res.plot() mention, See also, docs mirror sync
* Cepstrum guide: variants and liftering figures with dual snippets, complex-cepstrum plot mention
* Correlation guide: normalization, IR-alignment and Hilbert-envelope figures with dual snippets
* Spectral analysis: cross-spectral density and coherent-output-SNR figures with dual snippets
* System measurement: Golay exact-recovery figure and plot mentions for the inversion workflow
* Synchronous averaging: sqrt(N) figure, diagnostics-tool guidance, See also, recording naming
* Data qualification: runs-test figure with dual snippet and peak-statistics plot mention
* MISO coherence: conditioning-order snippet, practical pitfalls and See also across the three trees
* Time-frequency: Harris window reference and See also across the three trees
* GUM uncertainty: map the domain pages that consume the clause-5 machinery, expand See also
* Filter banks: compliance plot mentions and recording naming in the crossover snippet
* Changelog entry for the core-metrology documentation figures and prose
* Regenerate llms-full.txt for the core-metrology documentation
* Drop the duplicated phase-axis translation key
Acoustic materials: impedance tube, airflow resistance & sound-absorption rating (ISO 10534-1/-2, ASTM E2611, ISO 9053-1/-2, ISO 11654) (#91)
* feat: impedance tube, airflow resistance and ISO 11654 absorption rating
Clean-room from the standards (no third-party tool referenced):
- impedance_tube.py: ISO 10534-2 two-microphone transfer-function method
(reflection factor, surface impedance/admittance, absorption), ISO 10534-1
standing-wave-ratio method, and ASTM E2611 four-microphone transfer-matrix
method (wave decomposition, two-load/one-load T-matrix, transmission loss,
material wavenumber and characteristic impedance). Kelvin (ISO) vs Celsius
(ASTM) speed-of-sound helpers keep the two sign/unit conventions apart.
- airflow_resistance.py: ISO 9053-1 static method (through-origin quadratic
fit) and ISO 9053-2 alternating method (Formula 2), with R_s in Pa·s/m and
resistivity in Pa·s/m².
- absorption_rating.py: ISO 11654 weighted absorption alpha_w (0.05-grid
reference-curve shift, L/M/H shape indicators, absorption classes A-E),
verified against the Annex A.1/A.2 worked examples.
103 module tests plus public-export checks; physics-identity anchors for the
tube (rigid wall alpha=0, perfect absorber r=0/Z=rhoc, det(T)=1, air-layer
recovery to <1e-9) since neither tube standard prints a numeric example.
Claude-Session: https://claude.ai/code/session_01HUHMx4dxDes2t5UPQ25djP
* feat: ISO 9053-2 Annex A kappa', materials docs, figures & conformance
Address per-module review of the impedance-tube / materials modules:
- ISO 9053-2:2020 Annex A (normative): implement the heat-conduction-corrected
effective ratio of specific heats kappa' (Formula (A.7)) and the thermal
boundary-layer thickness b (A.4/A.5) as effective_kappa() and
thermal_boundary_layer_thickness(). The Annex A.3 worked example is a
digit-exact oracle (b = 1.83e-3 m, kappa' = 1.370). Fix the misleading
_ADIABATIC_KAPPA citation: 1.4 is the uncorrected adiabatic fallback, not the
Annex A output.
- absorption_rating: delegate .plot() to _plotting.plot_weighted_absorption,
matching the repo idiom (reuses _unfavourable_mask / _new_axes).
- docs/materials.md: new guide covering ISO 11654, ISO 9053-1/-2 and
ISO 10534-1/-2 + ASTM E2611, with runnable examples and three figures
(EN/ES, light/dark). Linked from the docs index.
- Conformance report: five materials checks (ISO 11654 Annex A.1/A.2,
ISO 9053-2 Annex A.3 b + kappa', ISO 10534-1 SWR); shared oracles in
reference_data.py. 48/48 checks pass.
Impedance-tube module review returned Approved (no code changes needed;
the Eq (20) phase citation was verified correct against ISO 10534-1 p.5).
Claude-Session: https://claude.ai/code/session_01JJLhQzF5hTdnEi3bfmqnqm
* docs: experimental-setup diagrams for the materials methods
Add hand-drawn SVG setup diagrams (EN/ES, light/dark) for the new methods,
mirroring the didactic style of the room-acoustics / outdoor diagrams, and
embed them in docs/materials.md:
- Impedance tube (ISO 10534-2): loudspeaker, tube, two flush microphones at
spacing s and distance x1 from the specimen face, rigid backing, incident/
reflected plane waves and the Eq. (17)-(19) relations.
- Four-microphone transmission-loss tube (ASTM E2611): source, two upstream
and two downstream microphones, adjustable two-load termination, the A/B/C/D
travelling waves, and s1/s2/l1/l2/d labelled to match the library's
transfer_matrix_two_load / wave_decomposition parameters (l1, l2 measured
from the specimen front reference plane).
- Airflow resistance (ISO 9053-1/-2): the static rig (specimen, laminar flow
q_v, differential manometer Δp) and the alternating rig (piston 1-4 Hz,
cavity V, specimen/airtight termination, cavity level L_p).
Also apply the whole-branch review's two before-merge items:
- airflow_resistance.py: add the module-level __all__ it was missing.
- impedance_tube.face_quantities: add functional tests (progressive/backward
wave impedance = ±rho*c) so the exported ASTM Eq. (21) helper is covered.
SVG text() now XML-escapes &, < and > so labels may contain them literally.
Diagrams validated by subagent against the standards' figures and the
library's public-API variable names; the ASTM l2 origin was corrected from
the rear to the front specimen face to match the library convention.
Claude-Session: https://claude.ai/code/session_01JJLhQzF5hTdnEi3bfmqnqm
* fix: harden ISO 11654 input coercion (bot review)
_coerce now rejects multi-dimensional array input instead of silently
flattening it (CodeRabbit) and rejects non-finite values with a clear message
instead of a cryptic downstream integer-conversion error (Gemini). Adds tests
for both.
Claude-Session: https://claude.ai/code/session_01JJLhQzF5hTdnEi3bfmqnqm
* fix: flag ill-conditioned transfer-matrix solves (bot review)
transfer_matrix_two_load / transfer_matrix_one_load now emit an
ImpedanceTubeWarning when the solve denominator is near-singular relative to
its operands — two insufficiently-different loads (two-load) or a near-resonant
geometry (one-load) — instead of silently propagating inf/nan (CodeRabbit).
Adds tests for both the singular and the well-conditioned case.
Claude-Session: https://claude.ai/code/session_01JJLhQzF5hTdnEi3bfmqnqm
Acoustic materials: impedance tube, airflow resistance & sound-absorption rating (ISO 10534-1/-2, ASTM E2611, ISO 9053-1/-2, ISO 11654) (#91)
* feat: impedance tube, airflow resistance and ISO 11654 absorption rating
Clean-room from the standards (no third-party tool referenced):
- impedance_tube.py: ISO 10534-2 two-microphone transfer-function method
(reflection factor, surface impedance/admittance, absorption), ISO 10534-1
standing-wave-ratio method, and ASTM E2611 four-microphone transfer-matrix
method (wave decomposition, two-load/one-load T-matrix, transmission loss,
material wavenumber and characteristic impedance). Kelvin (ISO) vs Celsius
(ASTM) speed-of-sound helpers keep the two sign/unit conventions apart.
- airflow_resistance.py: ISO 9053-1 static method (through-origin quadratic
fit) and ISO 9053-2 alternating method (Formula 2), with R_s in Pa·s/m and
resistivity in Pa·s/m².
- absorption_rating.py: ISO 11654 weighted absorption alpha_w (0.05-grid
reference-curve shift, L/M/H shape indicators, absorption classes A-E),
verified against the Annex A.1/A.2 worked examples.
103 module tests plus public-export checks; physics-identity anchors for the
tube (rigid wall alpha=0, perfect absorber r=0/Z=rhoc, det(T)=1, air-layer
recovery to <1e-9) since neither tube standard prints a numeric example.
Claude-Session: https://claude.ai/code/session_01HUHMx4dxDes2t5UPQ25djP
* feat: ISO 9053-2 Annex A kappa', materials docs, figures & conformance
Address per-module review of the impedance-tube / materials modules:
- ISO 9053-2:2020 Annex A (normative): implement the heat-conduction-corrected
effective ratio of specific heats kappa' (Formula (A.7)) and the thermal
boundary-layer thickness b (A.4/A.5) as effective_kappa() and
thermal_boundary_layer_thickness(). The Annex A.3 worked example is a
digit-exact oracle (b = 1.83e-3 m, kappa' = 1.370). Fix the misleading
_ADIABATIC_KAPPA citation: 1.4 is the uncorrected adiabatic fallback, not the
Annex A output.
- absorption_rating: delegate .plot() to _plotting.plot_weighted_absorption,
matching the repo idiom (reuses _unfavourable_mask / _new_axes).
- docs/materials.md: new guide covering ISO 11654, ISO 9053-1/-2 and
ISO 10534-1/-2 + ASTM E2611, with runnable examples and three figures
(EN/ES, light/dark). Linked from the docs index.
- Conformance report: five materials checks (ISO 11654 Annex A.1/A.2,
ISO 9053-2 Annex A.3 b + kappa', ISO 10534-1 SWR); shared oracles in
reference_data.py. 48/48 checks pass.
Impedance-tube module review returned Approved (no code changes needed;
the Eq (20) phase citation was verified correct against ISO 10534-1 p.5).
Claude-Session: https://claude.ai/code/session_01JJLhQzF5hTdnEi3bfmqnqm
* docs: experimental-setup diagrams for the materials methods
Add hand-drawn SVG setup diagrams (EN/ES, light/dark) for the new methods,
mirroring the didactic style of the room-acoustics / outdoor diagrams, and
embed them in docs/materials.md:
- Impedance tube (ISO 10534-2): loudspeaker, tube, two flush microphones at
spacing s and distance x1 from the specimen face, rigid backing, incident/
reflected plane waves and the Eq. (17)-(19) relations.
- Four-microphone transmission-loss tube (ASTM E2611): source, two upstream
and two downstream microphones, adjustable two-load termination, the A/B/C/D
travelling waves, and s1/s2/l1/l2/d labelled to match the library's
transfer_matrix_two_load / wave_decomposition parameters (l1, l2 measured
from the specimen front reference plane).
- Airflow resistance (ISO 9053-1/-2): the static rig (specimen, laminar flow
q_v, differential manometer Δp) and the alternating rig (piston 1-4 Hz,
cavity V, specimen/airtight termination, cavity level L_p).
Also apply the whole-branch review's two before-merge items:
- airflow_resistance.py: add the module-level __all__ it was missing.
- impedance_tube.face_quantities: add functional tests (progressive/backward
wave impedance = ±rho*c) so the exported ASTM Eq. (21) helper is covered.
SVG text() now XML-escapes &, < and > so labels may contain them literally.
Diagrams validated by subagent against the standards' figures and the
library's public-API variable names; the ASTM l2 origin was corrected from
the rear to the front specimen face to match the library convention.
Claude-Session: https://claude.ai/code/session_01JJLhQzF5hTdnEi3bfmqnqm
* fix: harden ISO 11654 input coercion (bot review)
_coerce now rejects multi-dimensional array input instead of silently
flattening it (CodeRabbit) and rejects non-finite values with a clear message
instead of a cryptic downstream integer-conversion error (Gemini). Adds tests
for both.
Claude-Session: https://claude.ai/code/session_01JJLhQzF5hTdnEi3bfmqnqm
* fix: flag ill-conditioned transfer-matrix solves (bot review)
transfer_matrix_two_load / transfer_matrix_one_load now emit an
ImpedanceTubeWarning when the solve denominator is near-singular relative to
its operands — two insufficiently-different loads (two-load) or a near-resonant
geometry (one-load) — instead of silently propagating inf/nan (CodeRabbit).
Adds tests for both the singular and the well-conditioned case.
Claude-Session: https://claude.ai/code/session_01JJLhQzF5hTdnEi3bfmqnqm
Acoustic materials: impedance tube, airflow resistance & sound-absorption rating (ISO 10534-1/-2, ASTM E2611, ISO 9053-1/-2, ISO 11654) (#91)
* feat: impedance tube, airflow resistance and ISO 11654 absorption rating
Clean-room from the standards (no third-party tool referenced):
- impedance_tube.py: ISO 10534-2 two-microphone transfer-function method
(reflection factor, surface impedance/admittance, absorption), ISO 10534-1
standing-wave-ratio method, and ASTM E2611 four-microphone transfer-matrix
method (wave decomposition, two-load/one-load T-matrix, transmission loss,
material wavenumber and characteristic impedance). Kelvin (ISO) vs Celsius
(ASTM) speed-of-sound helpers keep the two sign/unit conventions apart.
- airflow_resistance.py: ISO 9053-1 static method (through-origin quadratic
fit) and ISO 9053-2 alternating method (Formula 2), with R_s in Pa·s/m and
resistivity in Pa·s/m².
- absorption_rating.py: ISO 11654 weighted absorption alpha_w (0.05-grid
reference-curve shift, L/M/H shape indicators, absorption classes A-E),
verified against the Annex A.1/A.2 worked examples.
103 module tests plus public-export checks; physics-identity anchors for the
tube (rigid wall alpha=0, perfect absorber r=0/Z=rhoc, det(T)=1, air-layer
recovery to <1e-9) since neither tube standard prints a numeric example.
Claude-Session: https://claude.ai/code/session_01HUHMx4dxDes2t5UPQ25djP
* feat: ISO 9053-2 Annex A kappa', materials docs, figures & conformance
Address per-module review of the impedance-tube / materials modules:
- ISO 9053-2:2020 Annex A (normative): implement the heat-conduction-corrected
effective ratio of specific heats kappa' (Formula (A.7)) and the thermal
boundary-layer thickness b (A.4/A.5) as effective_kappa() and
thermal_boundary_layer_thickness(). The Annex A.3 worked example is a
digit-exact oracle (b = 1.83e-3 m, kappa' = 1.370). Fix the misleading
_ADIABATIC_KAPPA citation: 1.4 is the uncorrected adiabatic fallback, not the
Annex A output.
- absorption_rating: delegate .plot() to _plotting.plot_weighted_absorption,
matching the repo idiom (reuses _unfavourable_mask / _new_axes).
- docs/materials.md: new guide covering ISO 11654, ISO 9053-1/-2 and
ISO 10534-1/-2 + ASTM E2611, with runnable examples and three figures
(EN/ES, light/dark). Linked from the docs index.
- Conformance report: five materials checks (ISO 11654 Annex A.1/A.2,
ISO 9053-2 Annex A.3 b + kappa', ISO 10534-1 SWR); shared oracles in
reference_data.py. 48/48 checks pass.
Impedance-tube module review returned Approved (no code changes needed;
the Eq (20) phase citation was verified correct against ISO 10534-1 p.5).
Claude-Session: https://claude.ai/code/session_01JJLhQzF5hTdnEi3bfmqnqm
* docs: experimental-setup diagrams for the materials methods
Add hand-drawn SVG setup diagrams (EN/ES, light/dark) for the new methods,
mirroring the didactic style of the room-acoustics / outdoor diagrams, and
embed them in docs/materials.md:
- Impedance tube (ISO 10534-2): loudspeaker, tube, two flush microphones at
spacing s and distance x1 from the specimen face, rigid backing, incident/
reflected plane waves and the Eq. (17)-(19) relations.
- Four-microphone transmission-loss tube (ASTM E2611): source, two upstream
and two downstream microphones, adjustable two-load termination, the A/B/C/D
travelling waves, and s1/s2/l1/l2/d labelled to match the library's
transfer_matrix_two_load / wave_decomposition parameters (l1, l2 measured
from the specimen front reference plane).
- Airflow resistance (ISO 9053-1/-2): the static rig (specimen, laminar flow
q_v, differential manometer Δp) and the alternating rig (piston 1-4 Hz,
cavity V, specimen/airtight termination, cavity level L_p).
Also apply the whole-branch review's two before-merge items:
- airflow_resistance.py: add the module-level __all__ it was missing.
- impedance_tube.face_quantities: add functional tests (progressive/backward
wave impedance = ±rho*c) so the exported ASTM Eq. (21) helper is covered.
SVG text() now XML-escapes &, < and > so labels may contain them literally.
Diagrams validated by subagent against the standards' figures and the
library's public-API variable names; the ASTM l2 origin was corrected from
the rear to the front specimen face to match the library convention.
Claude-Session: https://claude.ai/code/session_01JJLhQzF5hTdnEi3bfmqnqm
* fix: harden ISO 11654 input coercion (bot review)
_coerce now rejects multi-dimensional array input instead of silently
flattening it (CodeRabbit) and rejects non-finite values with a clear message
instead of a cryptic downstream integer-conversion error (Gemini). Adds tests
for both.
Claude-Session: https://claude.ai/code/session_01JJLhQzF5hTdnEi3bfmqnqm
* fix: flag ill-conditioned transfer-matrix solves (bot review)
transfer_matrix_two_load / transfer_matrix_one_load now emit an
ImpedanceTubeWarning when the solve denominator is near-singular relative to
its operands — two insufficiently-different loads (two-load) or a near-resonant
geometry (one-load) — instead of silently propagating inf/nan (CodeRabbit).
Adds tests for both the singular and the well-conditioned case.
Claude-Session: https://claude.ai/code/session_01JJLhQzF5hTdnEi3bfmqnqm
Acoustic materials: impedance tube, airflow resistance & sound-absorption rating (ISO 10534-1/-2, ASTM E2611, ISO 9053-1/-2, ISO 11654) (#91)
* feat: impedance tube, airflow resistance and ISO 11654 absorption rating
Clean-room from the standards (no third-party tool referenced):
- impedance_tube.py: ISO 10534-2 two-microphone transfer-function method
(reflection factor, surface impedance/admittance, absorption), ISO 10534-1
standing-wave-ratio method, and ASTM E2611 four-microphone transfer-matrix
method (wave decomposition, two-load/one-load T-matrix, transmission loss,
material wavenumber and characteristic impedance). Kelvin (ISO) vs Celsius
(ASTM) speed-of-sound helpers keep the two sign/unit conventions apart.
- airflow_resistance.py: ISO 9053-1 static method (through-origin quadratic
fit) and ISO 9053-2 alternating method (Formula 2), with R_s in Pa·s/m and
resistivity in Pa·s/m².
- absorption_rating.py: ISO 11654 weighted absorption alpha_w (0.05-grid
reference-curve shift, L/M/H shape indicators, absorption classes A-E),
verified against the Annex A.1/A.2 worked examples.
103 module tests plus public-export checks; physics-identity anchors for the
tube (rigid wall alpha=0, perfect absorber r=0/Z=rhoc, det(T)=1, air-layer
recovery to <1e-9) since neither tube standard prints a numeric example.
Claude-Session: https://claude.ai/code/session_01HUHMx4dxDes2t5UPQ25djP
* feat: ISO 9053-2 Annex A kappa', materials docs, figures & conformance
Address per-module review of the impedance-tube / materials modules:
- ISO 9053-2:2020 Annex A (normative): implement the heat-conduction-corrected
effective ratio of specific heats kappa' (Formula (A.7)) and the thermal
boundary-layer thickness b (A.4/A.5) as effective_kappa() and
thermal_boundary_layer_thickness(). The Annex A.3 worked example is a
digit-exact oracle (b = 1.83e-3 m, kappa' = 1.370). Fix the misleading
_ADIABATIC_KAPPA citation: 1.4 is the uncorrected adiabatic fallback, not the
Annex A output.
- absorption_rating: delegate .plot() to _plotting.plot_weighted_absorption,
matching the repo idiom (reuses _unfavourable_mask / _new_axes).
- docs/materials.md: new guide covering ISO 11654, ISO 9053-1/-2 and
ISO 10534-1/-2 + ASTM E2611, with runnable examples and three figures
(EN/ES, light/dark). Linked from the docs index.
- Conformance report: five materials checks (ISO 11654 Annex A.1/A.2,
ISO 9053-2 Annex A.3 b + kappa', ISO 10534-1 SWR); shared oracles in
reference_data.py. 48/48 checks pass.
Impedance-tube module review returned Approved (no code changes needed;
the Eq (20) phase citation was verified correct against ISO 10534-1 p.5).
Claude-Session: https://claude.ai/code/session_01JJLhQzF5hTdnEi3bfmqnqm
* docs: experimental-setup diagrams for the materials methods
Add hand-drawn SVG setup diagrams (EN/ES, light/dark) for the new methods,
mirroring the didactic style of the room-acoustics / outdoor diagrams, and
embed them in docs/materials.md:
- Impedance tube (ISO 10534-2): loudspeaker, tube, two flush microphones at
spacing s and distance x1 from the specimen face, rigid backing, incident/
reflected plane waves and the Eq. (17)-(19) relations.
- Four-microphone transmission-loss tube (ASTM E2611): source, two upstream
and two downstream microphones, adjustable two-load termination, the A/B/C/D
travelling waves, and s1/s2/l1/l2/d labelled to match the library's
transfer_matrix_two_load / wave_decomposition parameters (l1, l2 measured
from the specimen front reference plane).
- Airflow resistance (ISO 9053-1/-2): the static rig (specimen, laminar flow
q_v, differential manometer Δp) and the alternating rig (piston 1-4 Hz,
cavity V, specimen/airtight termination, cavity level L_p).
Also apply the whole-branch review's two before-merge items:
- airflow_resistance.py: add the module-level __all__ it was missing.
- impedance_tube.face_quantities: add functional tests (progressive/backward
wave impedance = ±rho*c) so the exported ASTM Eq. (21) helper is covered.
SVG text() now XML-escapes &, < and > so labels may contain them literally.
Diagrams validated by subagent against the standards' figures and the
library's public-API variable names; the ASTM l2 origin was corrected from
the rear to the front specimen face to match the library convention.
Claude-Session: https://claude.ai/code/session_01JJLhQzF5hTdnEi3bfmqnqm
* fix: harden ISO 11654 input coercion (bot review)
_coerce now rejects multi-dimensional array input instead of silently
flattening it (CodeRabbit) and rejects non-finite values with a clear message
instead of a cryptic downstream integer-conversion error (Gemini). Adds tests
for both.
Claude-Session: https://claude.ai/code/session_01JJLhQzF5hTdnEi3bfmqnqm
* fix: flag ill-conditioned transfer-matrix solves (bot review)
transfer_matrix_two_load / transfer_matrix_one_load now emit an
ImpedanceTubeWarning when the solve denominator is near-singular relative to
its operands — two insufficiently-different loads (two-load) or a near-resonant
geometry (one-load) — instead of silently propagating inf/nan (CodeRabbit).
Adds tests for both the singular and the well-conditioned case.
Claude-Session: https://claude.ai/code/session_01JJLhQzF5hTdnEi3bfmqnqm
Acoustic materials: impedance tube, airflow resistance & sound-absorption rating (ISO 10534-1/-2, ASTM E2611, ISO 9053-1/-2, ISO 11654) (#91)
* feat: impedance tube, airflow resistance and ISO 11654 absorption rating
Clean-room from the standards (no third-party tool referenced):
- impedance_tube.py: ISO 10534-2 two-microphone transfer-function method
(reflection factor, surface impedance/admittance, absorption), ISO 10534-1
standing-wave-ratio method, and ASTM E2611 four-microphone transfer-matrix
method (wave decomposition, two-load/one-load T-matrix, transmission loss,
material wavenumber and characteristic impedance). Kelvin (ISO) vs Celsius
(ASTM) speed-of-sound helpers keep the two sign/unit conventions apart.
- airflow_resistance.py: ISO 9053-1 static method (through-origin quadratic
fit) and ISO 9053-2 alternating method (Formula 2), with R_s in Pa·s/m and
resistivity in Pa·s/m².
- absorption_rating.py: ISO 11654 weighted absorption alpha_w (0.05-grid
reference-curve shift, L/M/H shape indicators, absorption classes A-E),
verified against the Annex A.1/A.2 worked examples.
103 module tests plus public-export checks; physics-identity anchors for the
tube (rigid wall alpha=0, perfect absorber r=0/Z=rhoc, det(T)=1, air-layer
recovery to <1e-9) since neither tube standard prints a numeric example.
Claude-Session: https://claude.ai/code/session_01HUHMx4dxDes2t5UPQ25djP
* feat: ISO 9053-2 Annex A kappa', materials docs, figures & conformance
Address per-module review of the impedance-tube / materials modules:
- ISO 9053-2:2020 Annex A (normative): implement the heat-conduction-corrected
effective ratio of specific heats kappa' (Formula (A.7)) and the thermal
boundary-layer thickness b (A.4/A.5) as effective_kappa() and
thermal_boundary_layer_thickness(). The Annex A.3 worked example is a
digit-exact oracle (b = 1.83e-3 m, kappa' = 1.370). Fix the misleading
_ADIABATIC_KAPPA citation: 1.4 is the uncorrected adiabatic fallback, not the
Annex A output.
- absorption_rating: delegate .plot() to _plotting.plot_weighted_absorption,
matching the repo idiom (reuses _unfavourable_mask / _new_axes).
- docs/materials.md: new guide covering ISO 11654, ISO 9053-1/-2 and
ISO 10534-1/-2 + ASTM E2611, with runnable examples and three figures
(EN/ES, light/dark). Linked from the docs index.
- Conformance report: five materials checks (ISO 11654 Annex A.1/A.2,
ISO 9053-2 Annex A.3 b + kappa', ISO 10534-1 SWR); shared oracles in
reference_data.py. 48/48 checks pass.
Impedance-tube module review returned Approved (no code changes needed;
the Eq (20) phase citation was verified correct against ISO 10534-1 p.5).
Claude-Session: https://claude.ai/code/session_01JJLhQzF5hTdnEi3bfmqnqm
* docs: experimental-setup diagrams for the materials methods
Add hand-drawn SVG setup diagrams (EN/ES, light/dark) for the new methods,
mirroring the didactic style of the room-acoustics / outdoor diagrams, and
embed them in docs/materials.md:
- Impedance tube (ISO 10534-2): loudspeaker, tube, two flush microphones at
spacing s and distance x1 from the specimen face, rigid backing, incident/
reflected plane waves and the Eq. (17)-(19) relations.
- Four-microphone transmission-loss tube (ASTM E2611): source, two upstream
and two downstream microphones, adjustable two-load termination, the A/B/C/D
travelling waves, and s1/s2/l1/l2/d labelled to match the library's
transfer_matrix_two_load / wave_decomposition parameters (l1, l2 measured
from the specimen front reference plane).
- Airflow resistance (ISO 9053-1/-2): the static rig (specimen, laminar flow
q_v, differential manometer Δp) and the alternating rig (piston 1-4 Hz,
cavity V, specimen/airtight termination, cavity level L_p).
Also apply the whole-branch review's two before-merge items:
- airflow_resistance.py: add the module-level __all__ it was missing.
- impedance_tube.face_quantities: add functional tests (progressive/backward
wave impedance = ±rho*c) so the exported ASTM Eq. (21) helper is covered.
SVG text() now XML-escapes &, < and > so labels may contain them literally.
Diagrams validated by subagent against the standards' figures and the
library's public-API variable names; the ASTM l2 origin was corrected from
the rear to the front specimen face to match the library convention.
Claude-Session: https://claude.ai/code/session_01JJLhQzF5hTdnEi3bfmqnqm
* fix: harden ISO 11654 input coercion (bot review)
_coerce now rejects multi-dimensional array input instead of silently
flattening it (CodeRabbit) and rejects non-finite values with a clear message
instead of a cryptic downstream integer-conversion error (Gemini). Adds tests
for both.
Claude-Session: https://claude.ai/code/session_01JJLhQzF5hTdnEi3bfmqnqm
* fix: flag ill-conditioned transfer-matrix solves (bot review)
transfer_matrix_two_load / transfer_matrix_one_load now emit an
ImpedanceTubeWarning when the solve denominator is near-singular relative to
its operands — two insufficiently-different loads (two-load) or a near-resonant
geometry (one-load) — instead of silently propagating inf/nan (CodeRabbit).
Adds tests for both the singular and the well-conditioned case.
Claude-Session: https://claude.ai/code/session_01JJLhQzF5hTdnEi3bfmqnqm
Acoustic materials: impedance tube, airflow resistance & sound-absorption rating (ISO 10534-1/-2, ASTM E2611, ISO 9053-1/-2, ISO 11654) (#91)
* feat: impedance tube, airflow resistance and ISO 11654 absorption rating
Clean-room from the standards (no third-party tool referenced):
- impedance_tube.py: ISO 10534-2 two-microphone transfer-function method
(reflection factor, surface impedance/admittance, absorption), ISO 10534-1
standing-wave-ratio method, and ASTM E2611 four-microphone transfer-matrix
method (wave decomposition, two-load/one-load T-matrix, transmission loss,
material wavenumber and characteristic impedance). Kelvin (ISO) vs Celsius
(ASTM) speed-of-sound helpers keep the two sign/unit conventions apart.
- airflow_resistance.py: ISO 9053-1 static method (through-origin quadratic
fit) and ISO 9053-2 alternating method (Formula 2), with R_s in Pa·s/m and
resistivity in Pa·s/m².
- absorption_rating.py: ISO 11654 weighted absorption alpha_w (0.05-grid
reference-curve shift, L/M/H shape indicators, absorption classes A-E),
verified against the Annex A.1/A.2 worked examples.
103 module tests plus public-export checks; physics-identity anchors for the
tube (rigid wall alpha=0, perfect absorber r=0/Z=rhoc, det(T)=1, air-layer
recovery to <1e-9) since neither tube standard prints a numeric example.
Claude-Session: https://claude.ai/code/session_01HUHMx4dxDes2t5UPQ25djP
* feat: ISO 9053-2 Annex A kappa', materials docs, figures & conformance
Address per-module review of the impedance-tube / materials modules:
- ISO 9053-2:2020 Annex A (normative): implement the heat-conduction-corrected
effective ratio of specific heats kappa' (Formula (A.7)) and the thermal
boundary-layer thickness b (A.4/A.5) as effective_kappa() and
thermal_boundary_layer_thickness(). The Annex A.3 worked example is a
digit-exact oracle (b = 1.83e-3 m, kappa' = 1.370). Fix the misleading
_ADIABATIC_KAPPA citation: 1.4 is the uncorrected adiabatic fallback, not the
Annex A output.
- absorption_rating: delegate .plot() to _plotting.plot_weighted_absorption,
matching the repo idiom (reuses _unfavourable_mask / _new_axes).
- docs/materials.md: new guide covering ISO 11654, ISO 9053-1/-2 and
ISO 10534-1/-2 + ASTM E2611, with runnable examples and three figures
(EN/ES, light/dark). Linked from the docs index.
- Conformance report: five materials checks (ISO 11654 Annex A.1/A.2,
ISO 9053-2 Annex A.3 b + kappa', ISO 10534-1 SWR); shared oracles in
reference_data.py. 48/48 checks pass.
Impedance-tube module review returned Approved (no code changes needed;
the Eq (20) phase citation was verified correct against ISO 10534-1 p.5).
Claude-Session: https://claude.ai/code/session_01JJLhQzF5hTdnEi3bfmqnqm
* docs: experimental-setup diagrams for the materials methods
Add hand-drawn SVG setup diagrams (EN/ES, light/dark) for the new methods,
mirroring the didactic style of the room-acoustics / outdoor diagrams, and
embed them in docs/materials.md:
- Impedance tube (ISO 10534-2): loudspeaker, tube, two flush microphones at
spacing s and distance x1 from the specimen face, rigid backing, incident/
reflected plane waves and the Eq. (17)-(19) relations.
- Four-microphone transmission-loss tube (ASTM E2611): source, two upstream
and two downstream microphones, adjustable two-load termination, the A/B/C/D
travelling waves, and s1/s2/l1/l2/d labelled to match the library's
transfer_matrix_two_load / wave_decomposition parameters (l1, l2 measured
from the specimen front reference plane).
- Airflow resistance (ISO 9053-1/-2): the static rig (specimen, laminar flow
q_v, differential manometer Δp) and the alternating rig (piston 1-4 Hz,
cavity V, specimen/airtight termination, cavity level L_p).
Also apply the whole-branch review's two before-merge items:
- airflow_resistance.py: add the module-level __all__ it was missing.
- impedance_tube.face_quantities: add functional tests (progressive/backward
wave impedance = ±rho*c) so the exported ASTM Eq. (21) helper is covered.
SVG text() now XML-escapes &, < and > so labels may contain them literally.
Diagrams validated by subagent against the standards' figures and the
library's public-API variable names; the ASTM l2 origin was corrected from
the rear to the front specimen face to match the library convention.
Claude-Session: https://claude.ai/code/session_01JJLhQzF5hTdnEi3bfmqnqm
* fix: harden ISO 11654 input coercion (bot review)
_coerce now rejects multi-dimensional array input instead of silently
flattening it (CodeRabbit) and rejects non-finite values with a clear message
instead of a cryptic downstream integer-conversion error (Gemini). Adds tests
for both.
Claude-Session: https://claude.ai/code/session_01JJLhQzF5hTdnEi3bfmqnqm
* fix: flag ill-conditioned transfer-matrix solves (bot review)
transfer_matrix_two_load / transfer_matrix_one_load now emit an
ImpedanceTubeWarning when the solve denominator is near-singular relative to
its operands — two insufficiently-different loads (two-load) or a near-resonant
geometry (one-load) — instead of silently propagating inf/nan (CodeRabbit).
Adds tests for both the singular and the well-conditioned case.
Claude-Session: https://claude.ai/code/session_01JJLhQzF5hTdnEi3bfmqnqm
Acoustic materials: impedance tube, airflow resistance & sound-absorption rating (ISO 10534-1/-2, ASTM E2611, ISO 9053-1/-2, ISO 11654) (#91)
* feat: impedance tube, airflow resistance and ISO 11654 absorption rating
Clean-room from the standards (no third-party tool referenced):
- impedance_tube.py: ISO 10534-2 two-microphone transfer-function method
(reflection factor, surface impedance/admittance, absorption), ISO 10534-1
standing-wave-ratio method, and ASTM E2611 four-microphone transfer-matrix
method (wave decomposition, two-load/one-load T-matrix, transmission loss,
material wavenumber and characteristic impedance). Kelvin (ISO) vs Celsius
(ASTM) speed-of-sound helpers keep the two sign/unit conventions apart.
- airflow_resistance.py: ISO 9053-1 static method (through-origin quadratic
fit) and ISO 9053-2 alternating method (Formula 2), with R_s in Pa·s/m and
resistivity in Pa·s/m².
- absorption_rating.py: ISO 11654 weighted absorption alpha_w (0.05-grid
reference-curve shift, L/M/H shape indicators, absorption classes A-E),
verified against the Annex A.1/A.2 worked examples.
103 module tests plus public-export checks; physics-identity anchors for the
tube (rigid wall alpha=0, perfect absorber r=0/Z=rhoc, det(T)=1, air-layer
recovery to <1e-9) since neither tube standard prints a numeric example.
Claude-Session: https://claude.ai/code/session_01HUHMx4dxDes2t5UPQ25djP
* feat: ISO 9053-2 Annex A kappa', materials docs, figures & conformance
Address per-module review of the impedance-tube / materials modules:
- ISO 9053-2:2020 Annex A (normative): implement the heat-conduction-corrected
effective ratio of specific heats kappa' (Formula (A.7)) and the thermal
boundary-layer thickness b (A.4/A.5) as effective_kappa() and
thermal_boundary_layer_thickness(). The Annex A.3 worked example is a
digit-exact oracle (b = 1.83e-3 m, kappa' = 1.370). Fix the misleading
_ADIABATIC_KAPPA citation: 1.4 is the uncorrected adiabatic fallback, not the
Annex A output.
- absorption_rating: delegate .plot() to _plotting.plot_weighted_absorption,
matching the repo idiom (reuses _unfavourable_mask / _new_axes).
- docs/materials.md: new guide covering ISO 11654, ISO 9053-1/-2 and
ISO 10534-1/-2 + ASTM E2611, with runnable examples and three figures
(EN/ES, light/dark). Linked from the docs index.
- Conformance report: five materials checks (ISO 11654 Annex A.1/A.2,
ISO 9053-2 Annex A.3 b + kappa', ISO 10534-1 SWR); shared oracles in
reference_data.py. 48/48 checks pass.
Impedance-tube module review returned Approved (no code changes needed;
the Eq (20) phase citation was verified correct against ISO 10534-1 p.5).
Claude-Session: https://claude.ai/code/session_01JJLhQzF5hTdnEi3bfmqnqm
* docs: experimental-setup diagrams for the materials methods
Add hand-drawn SVG setup diagrams (EN/ES, light/dark) for the new methods,
mirroring the didactic style of the room-acoustics / outdoor diagrams, and
embed them in docs/materials.md:
- Impedance tube (ISO 10534-2): loudspeaker, tube, two flush microphones at
spacing s and distance x1 from the specimen face, rigid backing, incident/
reflected plane waves and the Eq. (17)-(19) relations.
- Four-microphone transmission-loss tube (ASTM E2611): source, two upstream
and two downstream microphones, adjustable two-load termination, the A/B/C/D
travelling waves, and s1/s2/l1/l2/d labelled to match the library's
transfer_matrix_two_load / wave_decomposition parameters (l1, l2 measured
from the specimen front reference plane).
- Airflow resistance (ISO 9053-1/-2): the static rig (specimen, laminar flow
q_v, differential manometer Δp) and the alternating rig (piston 1-4 Hz,
cavity V, specimen/airtight termination, cavity level L_p).
Also apply the whole-branch review's two before-merge items:
- airflow_resistance.py: add the module-level __all__ it was missing.
- impedance_tube.face_quantities: add functional tests (progressive/backward
wave impedance = ±rho*c) so the exported ASTM Eq. (21) helper is covered.
SVG text() now XML-escapes &, < and > so labels may contain them literally.
Diagrams validated by subagent against the standards' figures and the
library's public-API variable names; the ASTM l2 origin was corrected from
the rear to the front specimen face to match the library convention.
Claude-Session: https://claude.ai/code/session_01JJLhQzF5hTdnEi3bfmqnqm
* fix: harden ISO 11654 input coercion (bot review)
_coerce now rejects multi-dimensional array input instead of silently
flattening it (CodeRabbit) and rejects non-finite values with a clear message
instead of a cryptic downstream integer-conversion error (Gemini). Adds tests
for both.
Claude-Session: https://claude.ai/code/session_01JJLhQzF5hTdnEi3bfmqnqm
* fix: flag ill-conditioned transfer-matrix solves (bot review)
transfer_matrix_two_load / transfer_matrix_one_load now emit an
ImpedanceTubeWarning when the solve denominator is near-singular relative to
its operands — two insufficiently-different loads (two-load) or a near-resonant
geometry (one-load) — instead of silently propagating inf/nan (CodeRabbit).
Adds tests for both the singular and the well-conditioned case.
Claude-Session: https://claude.ai/code/session_01JJLhQzF5hTdnEi3bfmqnqm
Acoustic materials: impedance tube, airflow resistance & sound-absorption rating (ISO 10534-1/-2, ASTM E2611, ISO 9053-1/-2, ISO 11654) (#91)
* feat: impedance tube, airflow resistance and ISO 11654 absorption rating
Clean-room from the standards (no third-party tool referenced):
- impedance_tube.py: ISO 10534-2 two-microphone transfer-function method
(reflection factor, surface impedance/admittance, absorption), ISO 10534-1
standing-wave-ratio method, and ASTM E2611 four-microphone transfer-matrix
method (wave decomposition, two-load/one-load T-matrix, transmission loss,
material wavenumber and characteristic impedance). Kelvin (ISO) vs Celsius
(ASTM) speed-of-sound helpers keep the two sign/unit conventions apart.
- airflow_resistance.py: ISO 9053-1 static method (through-origin quadratic
fit) and ISO 9053-2 alternating method (Formula 2), with R_s in Pa·s/m and
resistivity in Pa·s/m².
- absorption_rating.py: ISO 11654 weighted absorption alpha_w (0.05-grid
reference-curve shift, L/M/H shape indicators, absorption classes A-E),
verified against the Annex A.1/A.2 worked examples.
103 module tests plus public-export checks; physics-identity anchors for the
tube (rigid wall alpha=0, perfect absorber r=0/Z=rhoc, det(T)=1, air-layer
recovery to <1e-9) since neither tube standard prints a numeric example.
Claude-Session: https://claude.ai/code/session_01HUHMx4dxDes2t5UPQ25djP
* feat: ISO 9053-2 Annex A kappa', materials docs, figures & conformance
Address per-module review of the impedance-tube / materials modules:
- ISO 9053-2:2020 Annex A (normative): implement the heat-conduction-corrected
effective ratio of specific heats kappa' (Formula (A.7)) and the thermal
boundary-layer thickness b (A.4/A.5) as effective_kappa() and
thermal_boundary_layer_thickness(). The Annex A.3 worked example is a
digit-exact oracle (b = 1.83e-3 m, kappa' = 1.370). Fix the misleading
_ADIABATIC_KAPPA citation: 1.4 is the uncorrected adiabatic fallback, not the
Annex A output.
- absorption_rating: delegate .plot() to _plotting.plot_weighted_absorption,
matching the repo idiom (reuses _unfavourable_mask / _new_axes).
- docs/materials.md: new guide covering ISO 11654, ISO 9053-1/-2 and
ISO 10534-1/-2 + ASTM E2611, with runnable examples and three figures
(EN/ES, light/dark). Linked from the docs index.
- Conformance report: five materials checks (ISO 11654 Annex A.1/A.2,
ISO 9053-2 Annex A.3 b + kappa', ISO 10534-1 SWR); shared oracles in
reference_data.py. 48/48 checks pass.
Impedance-tube module review returned Approved (no code changes needed;
the Eq (20) phase citation was verified correct against ISO 10534-1 p.5).
Claude-Session: https://claude.ai/code/session_01JJLhQzF5hTdnEi3bfmqnqm
* docs: experimental-setup diagrams for the materials methods
Add hand-drawn SVG setup diagrams (EN/ES, light/dark) for the new methods,
mirroring the didactic style of the room-acoustics / outdoor diagrams, and
embed them in docs/materials.md:
- Impedance tube (ISO 10534-2): loudspeaker, tube, two flush microphones at
spacing s and distance x1 from the specimen face, rigid backing, incident/
reflected plane waves and the Eq. (17)-(19) relations.
- Four-microphone transmission-loss tube (ASTM E2611): source, two upstream
and two downstream microphones, adjustable two-load termination, the A/B/C/D
travelling waves, and s1/s2/l1/l2/d labelled to match the library's
transfer_matrix_two_load / wave_decomposition parameters (l1, l2 measured
from the specimen front reference plane).
- Airflow resistance (ISO 9053-1/-2): the static rig (specimen, laminar flow
q_v, differential manometer Δp) and the alternating rig (piston 1-4 Hz,
cavity V, specimen/airtight termination, cavity level L_p).
Also apply the whole-branch review's two before-merge items:
- airflow_resistance.py: add the module-level __all__ it was missing.
- impedance_tube.face_quantities: add functional tests (progressive/backward
wave impedance = ±rho*c) so the exported ASTM Eq. (21) helper is covered.
SVG text() now XML-escapes &, < and > so labels may contain them literally.
Diagrams validated by subagent against the standards' figures and the
library's public-API variable names; the ASTM l2 origin was corrected from
the rear to the front specimen face to match the library convention.
Claude-Session: https://claude.ai/code/session_01JJLhQzF5hTdnEi3bfmqnqm
* fix: harden ISO 11654 input coercion (bot review)
_coerce now rejects multi-dimensional array input instead of silently
flattening it (CodeRabbit) and rejects non-finite values with a clear message
instead of a cryptic downstream integer-conversion error (Gemini). Adds tests
for both.
Claude-Session: https://claude.ai/code/session_01JJLhQzF5hTdnEi3bfmqnqm
* fix: flag ill-conditioned transfer-matrix solves (bot review)
transfer_matrix_two_load / transfer_matrix_one_load now emit an
ImpedanceTubeWarning when the solve denominator is near-singular relative to
its operands — two insufficiently-different loads (two-load) or a near-resonant
geometry (one-load) — instead of silently propagating inf/nan (CodeRabbit).
Adds tests for both the singular and the well-conditioned case.
Claude-Session: https://claude.ai/code/session_01JJLhQzF5hTdnEi3bfmqnqm
Audit pass 11a: seven new documentation diagrams (#121)
* Audit pass 11a: seven new documentation diagrams
Add SVG flow diagrams for the seven topics the audit flagged as having no
schematic: the exponential-detector chain of the time weightings
(IEC 61672-1), stateful vs reset block processing, the multichannel
array-shape flow, the open-plan spatial-decay line (ISO 3382-3), the
ISO 12999-1 uncertainty pipeline, the ISO 11654 absorption-rating flow and
the Zwicker loudness-model chain (ISO 532-1).
Each is generated deterministically by generate_diagrams.py in the four
EN/ES x light/dark variants, with every Spanish label added to the _ES
table (decimals localised to commas), and embedded in the repo docs and
both site trees beside the existing worked-example plots.
* Fix ISO 532-1 table citations in the Zwicker diagram
Review of the diagram against loudness_zwicker.py found two mislabelled
tables: the equal-loudness correction and lower-critical-band grouping is
Table A.3 (not A.4), and the threshold in quiet LTQ is Table A.6 (not A.3).
Reassign the a0/DDF/LTQ corrections to the core-loudness step (Tables
A.4-A.7) where they belong, update the Spanish labels, and align the ES
psychoacoustics alt text with the guide's own term "sonos" (was "sonios").
Audit pass 11a: seven new documentation diagrams (#121)
* Audit pass 11a: seven new documentation diagrams
Add SVG flow diagrams for the seven topics the audit flagged as having no
schematic: the exponential-detector chain of the time weightings
(IEC 61672-1), stateful vs reset block processing, the multichannel
array-shape flow, the open-plan spatial-decay line (ISO 3382-3), the
ISO 12999-1 uncertainty pipeline, the ISO 11654 absorption-rating flow and
the Zwicker loudness-model chain (ISO 532-1).
Each is generated deterministically by generate_diagrams.py in the four
EN/ES x light/dark variants, with every Spanish label added to the _ES
table (decimals localised to commas), and embedded in the repo docs and
both site trees beside the existing worked-example plots.
* Fix ISO 532-1 table citations in the Zwicker diagram
Review of the diagram against loudness_zwicker.py found two mislabelled
tables: the equal-loudness correction and lower-critical-band grouping is
Table A.3 (not A.4), and the threshold in quiet LTQ is Table A.6 (not A.3).
Reassign the a0/DDF/LTQ corrections to the core-loudness step (Tables
A.4-A.7) where they belong, update the Spanish labels, and align the ES
psychoacoustics alt text with the guide's own term "sonos" (was "sonios").
Audit pass 11a: seven new documentation diagrams (#121)
* Audit pass 11a: seven new documentation diagrams
Add SVG flow diagrams for the seven topics the audit flagged as having no
schematic: the exponential-detector chain of the time weightings
(IEC 61672-1), stateful vs reset block processing, the multichannel
array-shape flow, the open-plan spatial-decay line (ISO 3382-3), the
ISO 12999-1 uncertainty pipeline, the ISO 11654 absorption-rating flow and
the Zwicker loudness-model chain (ISO 532-1).
Each is generated deterministically by generate_diagrams.py in the four
EN/ES x light/dark variants, with every Spanish label added to the _ES
table (decimals localised to commas), and embedded in the repo docs and
both site trees beside the existing worked-example plots.
* Fix ISO 532-1 table citations in the Zwicker diagram
Review of the diagram against loudness_zwicker.py found two mislabelled
tables: the equal-loudness correction and lower-critical-band grouping is
Table A.3 (not A.4), and the threshold in quiet LTQ is Table A.6 (not A.3).
Reassign the a0/DDF/LTQ corrections to the core-loudness step (Tables
A.4-A.7) where they belong, update the Spanish labels, and align the ES
psychoacoustics alt text with the guide's own term "sonos" (was "sonios").
Audit pass 11a: seven new documentation diagrams (#121)
* Audit pass 11a: seven new documentation diagrams
Add SVG flow diagrams for the seven topics the audit flagged as having no
schematic: the exponential-detector chain of the time weightings
(IEC 61672-1), stateful vs reset block processing, the multichannel
array-shape flow, the open-plan spatial-decay line (ISO 3382-3), the
ISO 12999-1 uncertainty pipeline, the ISO 11654 absorption-rating flow and
the Zwicker loudness-model chain (ISO 532-1).
Each is generated deterministically by generate_diagrams.py in the four
EN/ES x light/dark variants, with every Spanish label added to the _ES
table (decimals localised to commas), and embedded in the repo docs and
both site trees beside the existing worked-example plots.
* Fix ISO 532-1 table citations in the Zwicker diagram
Review of the diagram against loudness_zwicker.py found two mislabelled
tables: the equal-loudness correction and lower-critical-band grouping is
Table A.3 (not A.4), and the threshold in quiet LTQ is Table A.6 (not A.3).
Reassign the a0/DDF/LTQ corrections to the core-loudness step (Tables
A.4-A.7) where they belong, update the Spanish labels, and align the ES
psychoacoustics alt text with the guide's own term "sonos" (was "sonios").
Didactic documentation: theory everywhere, bilingual figures, setup diagrams, parameter tables (#77)
* docs: harden diagram engine per visual audit
- dim() draws real witness lines from the measured points to the offset
dimension line (the offset=0 path emitted zero-length lines); vertical
labels sit left of the line, clear of masts and figures
- env diagram: the 4 m dimension now measures the mic axis itself and
the flush-mounted label moved to the clear zone between masts
- tonality top view: the 1.00 m dimension connects face and microphone
Claude-Session: https://claude.ai/code/session_013kkVt3nxi9svp1an28uHxf
* docs: bilingual diagram variants (EN/ES x light/dark)
Every setup diagram is now emitted in four variants; Spanish strings
(including decimal commas) come from a translation table applied by the
SVG engine, and layouts were adjusted where the longer Spanish labels
collided (env titles, processing-chain box width, calibration output
label, tonality dimension label side).
Claude-Session: https://claude.ai/code/session_013kkVt3nxi9svp1an28uHxf
* docs: bilingual figure variants for the ES site (EN/ES x light/dark)
generate_graphs.py now emits every figure in four variants: a Spanish
translation table (~75 exact strings + parametrized patterns) is applied
to the figure's Text artists at savefig time, so the generator functions
stay single-language internally. Spanish output uses UNE terminology
(ponderación temporal, líneas isofónicas, fonios, ráfaga) and a uniform
decimal comma (annotations and tick labels included); code identifiers
and normative mode names (Fast/Slow/Impulse) stay untranslated. The ES
site pages now reference the _es/_es_dark variants (56 URLs). The ES set
passed a 10-figure visual audit (10/10 approved, no blockers).
Claude-Session: https://claude.ai/code/session_013kkVt3nxi9svp1an28uHxf
* docs: didactic calibration page - theory, setup diagram, stability figure, parameter table
Adds the sensitivity-factor derivation with the calibration-chain SVG,
a new autogenerated calibration_stability figure (stable vs 3% AM tone
against the IEC 60942:2017 class 1 deviation band; 4 language/theme
variants; the ES decimal-comma pass now preserves clause numbers like
5.3.3), and a full parameter table for calculate_sensitivity - EN and
ES in parity.
Claude-Session: https://claude.ai/code/session_013kkVt3nxi9svp1an28uHxf
* docs: SEL concept, Lden 24h profile and annotated TNR spectrum figures
Three new didactic figures for the levels guide, each in four
language/theme variants: sel_concept (pass-by event vs its Leq and the
equal-energy 1 s SEL block, dBFS mode), lden_profile (synthetic urban
24 h LAeq with colored day/evening/night bands and the +5/+10 weighted
period levels clearly separated from the composite Lden), and
tonality_spectrum (averaged Hann spectrum with the critical band, the
detected tone and the live TNR value vs its criterion, computed by the
library itself).
Claude-Session: https://claude.ai/code/session_013kkVt3nxi9svp1an28uHxf
* docs: didactic levels guide, theory extensions and refreshed why-phonometry
- levels guide (EN docs+site): energy-mean rationale for Leq, percentile
semantics for LN, SEL and noise-dose theory with the new figures
embedded, TNR critical-band explanation with the annotated spectrum,
Lden profile figure, and parameter tables (type/units/range/default)
for every level function including the spectrogram
- theory page: five new sections (G-weighting pole/zero derivation,
ISO 226 formulae, ECMA-418-1 TNR/PR math, event/dose metrics,
ISO 1996-1 descriptors) with cross-references to the guides
- why-phonometry: rewritten around the conformance-testing story with
the per-standard verification table and honest ecosystem positioning
Claude-Session: https://claude.ai/code/session_013kkVt3nxi9svp1an28uHxf
* docs: weighting/time-weighting theory and parameter tables; fix math-block delimiters
The physiological origin of A/C (inverted 40/100-phon contours, the four
IEC corner frequencies) and the exponential-detector derivation with the
tau semantics, each with full parameter tables. Display math inserted by
the docs expansion now always uses block-style $$ delimiters on their
own lines - mid-line multi-line $$ blocks silently derailed remark
parsing and truncated every heading after them (caught because the
built pages lost their anchor ids); also replaced a raw < in a table.
Claude-Session: https://claude.ai/code/session_013kkVt3nxi9svp1an28uHxf
* docs: processing-chain and multirate diagrams, filter-bank math, streaming patterns
- getting-started embeds the processing-chain diagram as a guided map of
the guides
- filter-banks gains the IEC 61260-1 base-10 band math (G, fm, band
edges), a new multirate-decimation diagram (d5, four language/theme
variants) and the full octavefilter/OctaveFilterBank parameter table
- block-processing gains the canonical real-time level-meter loop
(validated against the actual API - TimeWeighting is inherently
stateful) and a stateful-constraints table
- multichannel gains the accepted-shapes table
Claude-Session: https://claude.ai/code/session_013kkVt3nxi9svp1an28uHxf
* docs: Spanish parity for the didactic expansion
Every enriched page now has its Spanish twin: levels (theory, three new
figures via _es variants, six parameter tables), weighting and
time-weighting (curve-origin and exponential-detector sections),
filter-banks (fractional-band math, multirate diagram, full parameter
table - terminology unified on 'decimación'), getting-started
(processing-chain map), block-processing (real-time meter pattern and
stateful constraints), multichannel (shapes table), theory (five new
sections) and a full rewrite of why-phonometry around the conformance
story. API reference now covers all 27 public exports in EN and ES
(added ToneAssessment and CalibrationWarning rows). UNE terminology and
Spanish decimal commas throughout; site builds with all links valid.
Claude-Session: https://claude.ai/code/session_013kkVt3nxi9svp1an28uHxf
* docs: audited fixes - Spanish tick commas and multirate note
Final visual-audit round: the d5 diagram now shows the no-decimation
note on the 16 kHz row in both languages, and Spanish figures render
every numeric tick with a decimal comma (FixedFormatter sequences are
rewritten in place; set_xticklabels-style FuncFormatters and plain
linear ScalarFormatters are wrapped - the first naive wrapper broke
ScalarFormatter ticks entirely and was caught visually).
Claude-Session: https://claude.ai/code/session_013kkVt3nxi9svp1an28uHxf
* docs(site): language selector in the mobile header, scrollable display math
Custom Header component (default markup plus a compact icon-only
LanguageSelect visible below the md breakpoint, where Starlight hides
the whole right group behind the hamburger menu) and overflow-x on
katex-display so wide formulas scroll inside their box on phones.
Verified with Playwright at 390 px in EN and ES.
Claude-Session: https://claude.ai/code/session_013kkVt3nxi9svp1an28uHxf
* fix: address review feedback on the didactic docs
- levels tables: spectrogram calibration_factor/dbfs marked constructor-
only, overlap range as 0 <= overlap < 1, composite hours constraints,
ln_levels shared-semantics row filled; ES translation leftovers and
the 'delante' typo fixed
- block-processing: y[..., -1] so the meter loop is multichannel-safe;
high_accuracy wording matches the real behavior (default resolves to
False, explicit True raises)
- API: CalibrationWarning row states the fs/validate preconditions (3 files)
- weighting: high_accuracy default column and oversampling claim made
precise (8x cap; silently ignored for G); ES row in parity
- filter-banks: 25 Hz relative bandwidth corrected to 0.024% of Nyquist
(EN/ES); verify_filter_class classes documented as 1/2/None
- generate_graphs: dropped the global plt.savefig monkey-patch - the
translation now runs inside themed_path(), which every generator
already calls at save time (verified output identical)
Claude-Session: https://claude.ai/code/session_013kkVt3nxi9svp1an28uHxf
Didactic documentation: theory everywhere, bilingual figures, setup diagrams, parameter tables (#77)
* docs: harden diagram engine per visual audit
- dim() draws real witness lines from the measured points to the offset
dimension line (the offset=0 path emitted zero-length lines); vertical
labels sit left of the line, clear of masts and figures
- env diagram: the 4 m dimension now measures the mic axis itself and
the flush-mounted label moved to the clear zone between masts
- tonality top view: the 1.00 m dimension connects face and microphone
Claude-Session: https://claude.ai/code/session_013kkVt3nxi9svp1an28uHxf
* docs: bilingual diagram variants (EN/ES x light/dark)
Every setup diagram is now emitted in four variants; Spanish strings
(including decimal commas) come from a translation table applied by the
SVG engine, and layouts were adjusted where the longer Spanish labels
collided (env titles, processing-chain box width, calibration output
label, tonality dimension label side).
Claude-Session: https://claude.ai/code/session_013kkVt3nxi9svp1an28uHxf
* docs: bilingual figure variants for the ES site (EN/ES x light/dark)
generate_graphs.py now emits every figure in four variants: a Spanish
translation table (~75 exact strings + parametrized patterns) is applied
to the figure's Text artists at savefig time, so the generator functions
stay single-language internally. Spanish output uses UNE terminology
(ponderación temporal, líneas isofónicas, fonios, ráfaga) and a uniform
decimal comma (annotations and tick labels included); code identifiers
and normative mode names (Fast/Slow/Impulse) stay untranslated. The ES
site pages now reference the _es/_es_dark variants (56 URLs). The ES set
passed a 10-figure visual audit (10/10 approved, no blockers).
Claude-Session: https://claude.ai/code/session_013kkVt3nxi9svp1an28uHxf
* docs: didactic calibration page - theory, setup diagram, stability figure, parameter table
Adds the sensitivity-factor derivation with the calibration-chain SVG,
a new autogenerated calibration_stability figure (stable vs 3% AM tone
against the IEC 60942:2017 class 1 deviation band; 4 language/theme
variants; the ES decimal-comma pass now preserves clause numbers like
5.3.3), and a full parameter table for calculate_sensitivity - EN and
ES in parity.
Claude-Session: https://claude.ai/code/session_013kkVt3nxi9svp1an28uHxf
* docs: SEL concept, Lden 24h profile and annotated TNR spectrum figures
Three new didactic figures for the levels guide, each in four
language/theme variants: sel_concept (pass-by event vs its Leq and the
equal-energy 1 s SEL block, dBFS mode), lden_profile (synthetic urban
24 h LAeq with colored day/evening/night bands and the +5/+10 weighted
period levels clearly separated from the composite Lden), and
tonality_spectrum (averaged Hann spectrum with the critical band, the
detected tone and the live TNR value vs its criterion, computed by the
library itself).
Claude-Session: https://claude.ai/code/session_013kkVt3nxi9svp1an28uHxf
* docs: didactic levels guide, theory extensions and refreshed why-phonometry
- levels guide (EN docs+site): energy-mean rationale for Leq, percentile
semantics for LN, SEL and noise-dose theory with the new figures
embedded, TNR critical-band explanation with the annotated spectrum,
Lden profile figure, and parameter tables (type/units/range/default)
for every level function including the spectrogram
- theory page: five new sections (G-weighting pole/zero derivation,
ISO 226 formulae, ECMA-418-1 TNR/PR math, event/dose metrics,
ISO 1996-1 descriptors) with cross-references to the guides
- why-phonometry: rewritten around the conformance-testing story with
the per-standard verification table and honest ecosystem positioning
Claude-Session: https://claude.ai/code/session_013kkVt3nxi9svp1an28uHxf
* docs: weighting/time-weighting theory and parameter tables; fix math-block delimiters
The physiological origin of A/C (inverted 40/100-phon contours, the four
IEC corner frequencies) and the exponential-detector derivation with the
tau semantics, each with full parameter tables. Display math inserted by
the docs expansion now always uses block-style $$ delimiters on their
own lines - mid-line multi-line $$ blocks silently derailed remark
parsing and truncated every heading after them (caught because the
built pages lost their anchor ids); also replaced a raw < in a table.
Claude-Session: https://claude.ai/code/session_013kkVt3nxi9svp1an28uHxf
* docs: processing-chain and multirate diagrams, filter-bank math, streaming patterns
- getting-started embeds the processing-chain diagram as a guided map of
the guides
- filter-banks gains the IEC 61260-1 base-10 band math (G, fm, band
edges), a new multirate-decimation diagram (d5, four language/theme
variants) and the full octavefilter/OctaveFilterBank parameter table
- block-processing gains the canonical real-time level-meter loop
(validated against the actual API - TimeWeighting is inherently
stateful) and a stateful-constraints table
- multichannel gains the accepted-shapes table
Claude-Session: https://claude.ai/code/session_013kkVt3nxi9svp1an28uHxf
* docs: Spanish parity for the didactic expansion
Every enriched page now has its Spanish twin: levels (theory, three new
figures via _es variants, six parameter tables), weighting and
time-weighting (curve-origin and exponential-detector sections),
filter-banks (fractional-band math, multirate diagram, full parameter
table - terminology unified on 'decimación'), getting-started
(processing-chain map), block-processing (real-time meter pattern and
stateful constraints), multichannel (shapes table), theory (five new
sections) and a full rewrite of why-phonometry around the conformance
story. API reference now covers all 27 public exports in EN and ES
(added ToneAssessment and CalibrationWarning rows). UNE terminology and
Spanish decimal commas throughout; site builds with all links valid.
Claude-Session: https://claude.ai/code/session_013kkVt3nxi9svp1an28uHxf
* docs: audited fixes - Spanish tick commas and multirate note
Final visual-audit round: the d5 diagram now shows the no-decimation
note on the 16 kHz row in both languages, and Spanish figures render
every numeric tick with a decimal comma (FixedFormatter sequences are
rewritten in place; set_xticklabels-style FuncFormatters and plain
linear ScalarFormatters are wrapped - the first naive wrapper broke
ScalarFormatter ticks entirely and was caught visually).
Claude-Session: https://claude.ai/code/session_013kkVt3nxi9svp1an28uHxf
* docs(site): language selector in the mobile header, scrollable display math
Custom Header component (default markup plus a compact icon-only
LanguageSelect visible below the md breakpoint, where Starlight hides
the whole right group behind the hamburger menu) and overflow-x on
katex-display so wide formulas scroll inside their box on phones.
Verified with Playwright at 390 px in EN and ES.
Claude-Session: https://claude.ai/code/session_013kkVt3nxi9svp1an28uHxf
* fix: address review feedback on the didactic docs
- levels tables: spectrogram calibration_factor/dbfs marked constructor-
only, overlap range as 0 <= overlap < 1, composite hours constraints,
ln_levels shared-semantics row filled; ES translation leftovers and
the 'delante' typo fixed
- block-processing: y[..., -1] so the meter loop is multichannel-safe;
high_accuracy wording matches the real behavior (default resolves to
False, explicit True raises)
- API: CalibrationWarning row states the fs/validate preconditions (3 files)
- weighting: high_accuracy default column and oversampling claim made
precise (8x cap; silently ignored for G); ES row in parity
- filter-banks: 25 Hz relative bandwidth corrected to 0.024% of Nyquist
(EN/ES); verify_filter_class classes documented as 1/2/None
- generate_graphs: dropped the global plt.savefig monkey-patch - the
translation now runs inside themed_path(), which every generator
already calls at save time (verified output identical)
Claude-Session: https://claude.ai/code/session_013kkVt3nxi9svp1an28uHxf
Didactic documentation: theory everywhere, bilingual figures, setup diagrams, parameter tables (#77)
* docs: harden diagram engine per visual audit
- dim() draws real witness lines from the measured points to the offset
dimension line (the offset=0 path emitted zero-length lines); vertical
labels sit left of the line, clear of masts and figures
- env diagram: the 4 m dimension now measures the mic axis itself and
the flush-mounted label moved to the clear zone between masts
- tonality top view: the 1.00 m dimension connects face and microphone
Claude-Session: https://claude.ai/code/session_013kkVt3nxi9svp1an28uHxf
* docs: bilingual diagram variants (EN/ES x light/dark)
Every setup diagram is now emitted in four variants; Spanish strings
(including decimal commas) come from a translation table applied by the
SVG engine, and layouts were adjusted where the longer Spanish labels
collided (env titles, processing-chain box width, calibration output
label, tonality dimension label side).
Claude-Session: https://claude.ai/code/session_013kkVt3nxi9svp1an28uHxf
* docs: bilingual figure variants for the ES site (EN/ES x light/dark)
generate_graphs.py now emits every figure in four variants: a Spanish
translation table (~75 exact strings + parametrized patterns) is applied
to the figure's Text artists at savefig time, so the generator functions
stay single-language internally. Spanish output uses UNE terminology
(ponderación temporal, líneas isofónicas, fonios, ráfaga) and a uniform
decimal comma (annotations and tick labels included); code identifiers
and normative mode names (Fast/Slow/Impulse) stay untranslated. The ES
site pages now reference the _es/_es_dark variants (56 URLs). The ES set
passed a 10-figure visual audit (10/10 approved, no blockers).
Claude-Session: https://claude.ai/code/session_013kkVt3nxi9svp1an28uHxf
* docs: didactic calibration page - theory, setup diagram, stability figure, parameter table
Adds the sensitivity-factor derivation with the calibration-chain SVG,
a new autogenerated calibration_stability figure (stable vs 3% AM tone
against the IEC 60942:2017 class 1 deviation band; 4 language/theme
variants; the ES decimal-comma pass now preserves clause numbers like
5.3.3), and a full parameter table for calculate_sensitivity - EN and
ES in parity.
Claude-Session: https://claude.ai/code/session_013kkVt3nxi9svp1an28uHxf
* docs: SEL concept, Lden 24h profile and annotated TNR spectrum figures
Three new didactic figures for the levels guide, each in four
language/theme variants: sel_concept (pass-by event vs its Leq and the
equal-energy 1 s SEL block, dBFS mode), lden_profile (synthetic urban
24 h LAeq with colored day/evening/night bands and the +5/+10 weighted
period levels clearly separated from the composite Lden), and
tonality_spectrum (averaged Hann spectrum with the critical band, the
detected tone and the live TNR value vs its criterion, computed by the
library itself).
Claude-Session: https://claude.ai/code/session_013kkVt3nxi9svp1an28uHxf
* docs: didactic levels guide, theory extensions and refreshed why-phonometry
- levels guide (EN docs+site): energy-mean rationale for Leq, percentile
semantics for LN, SEL and noise-dose theory with the new figures
embedded, TNR critical-band explanation with the annotated spectrum,
Lden profile figure, and parameter tables (type/units/range/default)
for every level function including the spectrogram
- theory page: five new sections (G-weighting pole/zero derivation,
ISO 226 formulae, ECMA-418-1 TNR/PR math, event/dose metrics,
ISO 1996-1 descriptors) with cross-references to the guides
- why-phonometry: rewritten around the conformance-testing story with
the per-standard verification table and honest ecosystem positioning
Claude-Session: https://claude.ai/code/session_013kkVt3nxi9svp1an28uHxf
* docs: weighting/time-weighting theory and parameter tables; fix math-block delimiters
The physiological origin of A/C (inverted 40/100-phon contours, the four
IEC corner frequencies) and the exponential-detector derivation with the
tau semantics, each with full parameter tables. Display math inserted by
the docs expansion now always uses block-style $$ delimiters on their
own lines - mid-line multi-line $$ blocks silently derailed remark
parsing and truncated every heading after them (caught because the
built pages lost their anchor ids); also replaced a raw < in a table.
Claude-Session: https://claude.ai/code/session_013kkVt3nxi9svp1an28uHxf
* docs: processing-chain and multirate diagrams, filter-bank math, streaming patterns
- getting-started embeds the processing-chain diagram as a guided map of
the guides
- filter-banks gains the IEC 61260-1 base-10 band math (G, fm, band
edges), a new multirate-decimation diagram (d5, four language/theme
variants) and the full octavefilter/OctaveFilterBank parameter table
- block-processing gains the canonical real-time level-meter loop
(validated against the actual API - TimeWeighting is inherently
stateful) and a stateful-constraints table
- multichannel gains the accepted-shapes table
Claude-Session: https://claude.ai/code/session_013kkVt3nxi9svp1an28uHxf
* docs: Spanish parity for the didactic expansion
Every enriched page now has its Spanish twin: levels (theory, three new
figures via _es variants, six parameter tables), weighting and
time-weighting (curve-origin and exponential-detector sections),
filter-banks (fractional-band math, multirate diagram, full parameter
table - terminology unified on 'decimación'), getting-started
(processing-chain map), block-processing (real-time meter pattern and
stateful constraints), multichannel (shapes table), theory (five new
sections) and a full rewrite of why-phonometry around the conformance
story. API reference now covers all 27 public exports in EN and ES
(added ToneAssessment and CalibrationWarning rows). UNE terminology and
Spanish decimal commas throughout; site builds with all links valid.
Claude-Session: https://claude.ai/code/session_013kkVt3nxi9svp1an28uHxf
* docs: audited fixes - Spanish tick commas and multirate note
Final visual-audit round: the d5 diagram now shows the no-decimation
note on the 16 kHz row in both languages, and Spanish figures render
every numeric tick with a decimal comma (FixedFormatter sequences are
rewritten in place; set_xticklabels-style FuncFormatters and plain
linear ScalarFormatters are wrapped - the first naive wrapper broke
ScalarFormatter ticks entirely and was caught visually).
Claude-Session: https://claude.ai/code/session_013kkVt3nxi9svp1an28uHxf
* docs(site): language selector in the mobile header, scrollable display math
Custom Header component (default markup plus a compact icon-only
LanguageSelect visible below the md breakpoint, where Starlight hides
the whole right group behind the hamburger menu) and overflow-x on
katex-display so wide formulas scroll inside their box on phones.
Verified with Playwright at 390 px in EN and ES.
Claude-Session: https://claude.ai/code/session_013kkVt3nxi9svp1an28uHxf
* fix: address review feedback on the didactic docs
- levels tables: spectrogram calibration_factor/dbfs marked constructor-
only, overlap range as 0 <= overlap < 1, composite hours constraints,
ln_levels shared-semantics row filled; ES translation leftovers and
the 'delante' typo fixed
- block-processing: y[..., -1] so the meter loop is multichannel-safe;
high_accuracy wording matches the real behavior (default resolves to
False, explicit True raises)
- API: CalibrationWarning row states the fs/validate preconditions (3 files)
- weighting: high_accuracy default column and oversampling claim made
precise (8x cap; silently ignored for G); ES row in parity
- filter-banks: 25 Hz relative bandwidth corrected to 0.024% of Nyquist
(EN/ES); verify_filter_class classes documented as 1/2/None
- generate_graphs: dropped the global plt.savefig monkey-patch - the
translation now runs inside themed_path(), which every generator
already calls at save time (verified output identical)
Claude-Session: https://claude.ai/code/session_013kkVt3nxi9svp1an28uHxf
Didactic documentation: theory everywhere, bilingual figures, setup diagrams, parameter tables (#77)
* docs: harden diagram engine per visual audit
- dim() draws real witness lines from the measured points to the offset
dimension line (the offset=0 path emitted zero-length lines); vertical
labels sit left of the line, clear of masts and figures
- env diagram: the 4 m dimension now measures the mic axis itself and
the flush-mounted label moved to the clear zone between masts
- tonality top view: the 1.00 m dimension connects face and microphone
Claude-Session: https://claude.ai/code/session_013kkVt3nxi9svp1an28uHxf
* docs: bilingual diagram variants (EN/ES x light/dark)
Every setup diagram is now emitted in four variants; Spanish strings
(including decimal commas) come from a translation table applied by the
SVG engine, and layouts were adjusted where the longer Spanish labels
collided (env titles, processing-chain box width, calibration output
label, tonality dimension label side).
Claude-Session: https://claude.ai/code/session_013kkVt3nxi9svp1an28uHxf
* docs: bilingual figure variants for the ES site (EN/ES x light/dark)
generate_graphs.py now emits every figure in four variants: a Spanish
translation table (~75 exact strings + parametrized patterns) is applied
to the figure's Text artists at savefig time, so the generator functions
stay single-language internally. Spanish output uses UNE terminology
(ponderación temporal, líneas isofónicas, fonios, ráfaga) and a uniform
decimal comma (annotations and tick labels included); code identifiers
and normative mode names (Fast/Slow/Impulse) stay untranslated. The ES
site pages now reference the _es/_es_dark variants (56 URLs). The ES set
passed a 10-figure visual audit (10/10 approved, no blockers).
Claude-Session: https://claude.ai/code/session_013kkVt3nxi9svp1an28uHxf
* docs: didactic calibration page - theory, setup diagram, stability figure, parameter table
Adds the sensitivity-factor derivation with the calibration-chain SVG,
a new autogenerated calibration_stability figure (stable vs 3% AM tone
against the IEC 60942:2017 class 1 deviation band; 4 language/theme
variants; the ES decimal-comma pass now preserves clause numbers like
5.3.3), and a full parameter table for calculate_sensitivity - EN and
ES in parity.
Claude-Session: https://claude.ai/code/session_013kkVt3nxi9svp1an28uHxf
* docs: SEL concept, Lden 24h profile and annotated TNR spectrum figures
Three new didactic figures for the levels guide, each in four
language/theme variants: sel_concept (pass-by event vs its Leq and the
equal-energy 1 s SEL block, dBFS mode), lden_profile (synthetic urban
24 h LAeq with colored day/evening/night bands and the +5/+10 weighted
period levels clearly separated from the composite Lden), and
tonality_spectrum (averaged Hann spectrum with the critical band, the
detected tone and the live TNR value vs its criterion, computed by the
library itself).
Claude-Session: https://claude.ai/code/session_013kkVt3nxi9svp1an28uHxf
* docs: didactic levels guide, theory extensions and refreshed why-phonometry
- levels guide (EN docs+site): energy-mean rationale for Leq, percentile
semantics for LN, SEL and noise-dose theory with the new figures
embedded, TNR critical-band explanation with the annotated spectrum,
Lden profile figure, and parameter tables (type/units/range/default)
for every level function including the spectrogram
- theory page: five new sections (G-weighting pole/zero derivation,
ISO 226 formulae, ECMA-418-1 TNR/PR math, event/dose metrics,
ISO 1996-1 descriptors) with cross-references to the guides
- why-phonometry: rewritten around the conformance-testing story with
the per-standard verification table and honest ecosystem positioning
Claude-Session: https://claude.ai/code/session_013kkVt3nxi9svp1an28uHxf
* docs: weighting/time-weighting theory and parameter tables; fix math-block delimiters
The physiological origin of A/C (inverted 40/100-phon contours, the four
IEC corner frequencies) and the exponential-detector derivation with the
tau semantics, each with full parameter tables. Display math inserted by
the docs expansion now always uses block-style $$ delimiters on their
own lines - mid-line multi-line $$ blocks silently derailed remark
parsing and truncated every heading after them (caught because the
built pages lost their anchor ids); also replaced a raw < in a table.
Claude-Session: https://claude.ai/code/session_013kkVt3nxi9svp1an28uHxf
* docs: processing-chain and multirate diagrams, filter-bank math, streaming patterns
- getting-started embeds the processing-chain diagram as a guided map of
the guides
- filter-banks gains the IEC 61260-1 base-10 band math (G, fm, band
edges), a new multirate-decimation diagram (d5, four language/theme
variants) and the full octavefilter/OctaveFilterBank parameter table
- block-processing gains the canonical real-time level-meter loop
(validated against the actual API - TimeWeighting is inherently
stateful) and a stateful-constraints table
- multichannel gains the accepted-shapes table
Claude-Session: https://claude.ai/code/session_013kkVt3nxi9svp1an28uHxf
* docs: Spanish parity for the didactic expansion
Every enriched page now has its Spanish twin: levels (theory, three new
figures via _es variants, six parameter tables), weighting and
time-weighting (curve-origin and exponential-detector sections),
filter-banks (fractional-band math, multirate diagram, full parameter
table - terminology unified on 'decimación'), getting-started
(processing-chain map), block-processing (real-time meter pattern and
stateful constraints), multichannel (shapes table), theory (five new
sections) and a full rewrite of why-phonometry around the conformance
story. API reference now covers all 27 public exports in EN and ES
(added ToneAssessment and CalibrationWarning rows). UNE terminology and
Spanish decimal commas throughout; site builds with all links valid.
Claude-Session: https://claude.ai/code/session_013kkVt3nxi9svp1an28uHxf
* docs: audited fixes - Spanish tick commas and multirate note
Final visual-audit round: the d5 diagram now shows the no-decimation
note on the 16 kHz row in both languages, and Spanish figures render
every numeric tick with a decimal comma (FixedFormatter sequences are
rewritten in place; set_xticklabels-style FuncFormatters and plain
linear ScalarFormatters are wrapped - the first naive wrapper broke
ScalarFormatter ticks entirely and was caught visually).
Claude-Session: https://claude.ai/code/session_013kkVt3nxi9svp1an28uHxf
* docs(site): language selector in the mobile header, scrollable display math
Custom Header component (default markup plus a compact icon-only
LanguageSelect visible below the md breakpoint, where Starlight hides
the whole right group behind the hamburger menu) and overflow-x on
katex-display so wide formulas scroll inside their box on phones.
Verified with Playwright at 390 px in EN and ES.
Claude-Session: https://claude.ai/code/session_013kkVt3nxi9svp1an28uHxf
* fix: address review feedback on the didactic docs
- levels tables: spectrogram calibration_factor/dbfs marked constructor-
only, overlap range as 0 <= overlap < 1, composite hours constraints,
ln_levels shared-semantics row filled; ES translation leftovers and
the 'delante' typo fixed
- block-processing: y[..., -1] so the meter loop is multichannel-safe;
high_accuracy wording matches the real behavior (default resolves to
False, explicit True raises)
- API: CalibrationWarning row states the fs/validate preconditions (3 files)
- weighting: high_accuracy default column and oversampling claim made
precise (8x cap; silently ignored for G); ES row in parity
- filter-banks: 25 Hz relative bandwidth corrected to 0.024% of Nyquist
(EN/ES); verify_filter_class classes documented as 1/2/None
- generate_graphs: dropped the global plt.savefig monkey-patch - the
translation now runs inside themed_path(), which every generator
already calls at save time (verified output identical)
Claude-Session: https://claude.ai/code/session_013kkVt3nxi9svp1an28uHxf
docs: psychoacoustics and hearing didactics, ISO 9612 dosimeter diagram and verified references (#191)
* docs: ISO 9612 occupational-exposure dosimeter and strategy diagram
Add diagram_dosimeter_iso9612 to the SVG toolkit: a worker wearing a
shoulder-mounted personal sound exposure meter with the microphone about
0.04 m above the shoulder and at least 0.1 m from the most-exposed ear
canal (Clause 12.3), alongside the three measurement strategies drawn as
labelled timelines over an eight-hour working day (task-based, job-based
and full-day, Clauses 9-11). Four deterministic variants (EN/ES, light/dark).
* docs: didactic depth and verified references for the psychoacoustics and hearing guides
Expand the six psychoacoustics and hearing guides (GitHub docs copies):
- tone-prominence: add the TNR and PR equations as display math, a
paragraph on when the two ratios disagree, a figure-code <details>, and
a References section (ECMA-418-1 and ECMA-74 free PDFs).
- tone-audibility: explain how the decisive band is selected and how to
read the extended uncertainty, including the ISO 1996-2 Annex J tonal
adjustment; References (ISO/PAS 20065, ISO 1996-2).
- psychoacoustic-annoyance: formalize the Fastl & Zwicker (2007), Osses
et al. (2016) and SQAT references.
- hearing-threshold: the otologically-normal population, percentile
interpretation, ISO 389-7 edition corrected to 2005; References.
- noise-induced-hearing-loss: NIPTS vs HTLAN vs total-threshold relations
and the fence caveats; References (ISO 1999, Passchier-Vermeer 1974,
NIOSH 98-126).
- occupational-exposure: embed the new ISO 9612 diagram, add
measurement-strategy selection and uncertainty-budget dominance prose;
References (ISO 9612, Directive 2003/10/EC, NIOSH 98-126).
Add the Psychoacoustics and Hearing groups to the global bibliography.
* docs(site): mirror the psychoacoustics and hearing didactics into the EN and ES guides
Mirror the six expanded guides (tone-prominence, tone-audibility,
psychoacoustic-annoyance, hearing-threshold, noise-induced-hearing-loss,
occupational-exposure) into the Astro site, English and Spanish: the new
equations, the didactic prose, the ISO 9612 dosimeter diagram embed and the
References sections, plus the Psychoacoustics and Hearing groups on both
bibliography pages.
* docs: deduplicate the site NIHL prose and align the index edition
Remove a duplicated, truncated copy of the "Three quantities, kept
distinct" block that slipped into the site EN noise-induced-hearing-loss
guide, and update the documentation index to the corrected ISO 389-7:2005
edition.
* docs: refine the psychoacoustics and hearing didactic wording
- Tone prominence: describe TNR and PR separately in the lead-in, since only
TNR compares the tone against the in-band noise while PR compares the middle
critical band with the mean of its neighbours. State both criteria piecewise
(8 dB and 9 dB flat from 1 kHz up) and apply them inclusively with an equal
sign, matching the implementation. Translate the Spanish figure snippet
strings (title, axis labels) to match the rendered figure.
- Hearing threshold: soften the unscreened-population claim to an average
tendency rather than every age or frequency, and tie database B to ISO 1999
as its alternate unscreened reference. Use a more natural Spanish verb for
the 90th percentile.
- Noise-induced hearing loss: present 40 dB of combined loss as an approximate
marker where the HN/120 compression becomes noticeable, not a hard boundary,
since the correction scales with the product of the two components.
- Tone audibility: note that ISO/PAS 20065:2016 is withdrawn and superseded by
ISO/TS 20065:2022, while keeping the implemented 2016 edition provenance.
docs: psychoacoustics and hearing didactics, ISO 9612 dosimeter diagram and verified references (#191)
* docs: ISO 9612 occupational-exposure dosimeter and strategy diagram
Add diagram_dosimeter_iso9612 to the SVG toolkit: a worker wearing a
shoulder-mounted personal sound exposure meter with the microphone about
0.04 m above the shoulder and at least 0.1 m from the most-exposed ear
canal (Clause 12.3), alongside the three measurement strategies drawn as
labelled timelines over an eight-hour working day (task-based, job-based
and full-day, Clauses 9-11). Four deterministic variants (EN/ES, light/dark).
* docs: didactic depth and verified references for the psychoacoustics and hearing guides
Expand the six psychoacoustics and hearing guides (GitHub docs copies):
- tone-prominence: add the TNR and PR equations as display math, a
paragraph on when the two ratios disagree, a figure-code <details>, and
a References section (ECMA-418-1 and ECMA-74 free PDFs).
- tone-audibility: explain how the decisive band is selected and how to
read the extended uncertainty, including the ISO 1996-2 Annex J tonal
adjustment; References (ISO/PAS 20065, ISO 1996-2).
- psychoacoustic-annoyance: formalize the Fastl & Zwicker (2007), Osses
et al. (2016) and SQAT references.
- hearing-threshold: the otologically-normal population, percentile
interpretation, ISO 389-7 edition corrected to 2005; References.
- noise-induced-hearing-loss: NIPTS vs HTLAN vs total-threshold relations
and the fence caveats; References (ISO 1999, Passchier-Vermeer 1974,
NIOSH 98-126).
- occupational-exposure: embed the new ISO 9612 diagram, add
measurement-strategy selection and uncertainty-budget dominance prose;
References (ISO 9612, Directive 2003/10/EC, NIOSH 98-126).
Add the Psychoacoustics and Hearing groups to the global bibliography.
* docs(site): mirror the psychoacoustics and hearing didactics into the EN and ES guides
Mirror the six expanded guides (tone-prominence, tone-audibility,
psychoacoustic-annoyance, hearing-threshold, noise-induced-hearing-loss,
occupational-exposure) into the Astro site, English and Spanish: the new
equations, the didactic prose, the ISO 9612 dosimeter diagram embed and the
References sections, plus the Psychoacoustics and Hearing groups on both
bibliography pages.
* docs: deduplicate the site NIHL prose and align the index edition
Remove a duplicated, truncated copy of the "Three quantities, kept
distinct" block that slipped into the site EN noise-induced-hearing-loss
guide, and update the documentation index to the corrected ISO 389-7:2005
edition.
* docs: refine the psychoacoustics and hearing didactic wording
- Tone prominence: describe TNR and PR separately in the lead-in, since only
TNR compares the tone against the in-band noise while PR compares the middle
critical band with the mean of its neighbours. State both criteria piecewise
(8 dB and 9 dB flat from 1 kHz up) and apply them inclusively with an equal
sign, matching the implementation. Translate the Spanish figure snippet
strings (title, axis labels) to match the rendered figure.
- Hearing threshold: soften the unscreened-population claim to an average
tendency rather than every age or frequency, and tie database B to ISO 1999
as its alternate unscreened reference. Use a more natural Spanish verb for
the 90th percentile.
- Noise-induced hearing loss: present 40 dB of combined loss as an approximate
marker where the HN/120 compression becomes noticeable, not a hard boundary,
since the correction scales with the product of the two components.
- Tone audibility: note that ISO/PAS 20065:2016 is withdrawn and superseded by
ISO/TS 20065:2022, while keeping the implemented 2016 edition provenance.
docs: psychoacoustics and hearing didactics, ISO 9612 dosimeter diagram and verified references (#191)
* docs: ISO 9612 occupational-exposure dosimeter and strategy diagram
Add diagram_dosimeter_iso9612 to the SVG toolkit: a worker wearing a
shoulder-mounted personal sound exposure meter with the microphone about
0.04 m above the shoulder and at least 0.1 m from the most-exposed ear
canal (Clause 12.3), alongside the three measurement strategies drawn as
labelled timelines over an eight-hour working day (task-based, job-based
and full-day, Clauses 9-11). Four deterministic variants (EN/ES, light/dark).
* docs: didactic depth and verified references for the psychoacoustics and hearing guides
Expand the six psychoacoustics and hearing guides (GitHub docs copies):
- tone-prominence: add the TNR and PR equations as display math, a
paragraph on when the two ratios disagree, a figure-code <details>, and
a References section (ECMA-418-1 and ECMA-74 free PDFs).
- tone-audibility: explain how the decisive band is selected and how to
read the extended uncertainty, including the ISO 1996-2 Annex J tonal
adjustment; References (ISO/PAS 20065, ISO 1996-2).
- psychoacoustic-annoyance: formalize the Fastl & Zwicker (2007), Osses
et al. (2016) and SQAT references.
- hearing-threshold: the otologically-normal population, percentile
interpretation, ISO 389-7 edition corrected to 2005; References.
- noise-induced-hearing-loss: NIPTS vs HTLAN vs total-threshold relations
and the fence caveats; References (ISO 1999, Passchier-Vermeer 1974,
NIOSH 98-126).
- occupational-exposure: embed the new ISO 9612 diagram, add
measurement-strategy selection and uncertainty-budget dominance prose;
References (ISO 9612, Directive 2003/10/EC, NIOSH 98-126).
Add the Psychoacoustics and Hearing groups to the global bibliography.
* docs(site): mirror the psychoacoustics and hearing didactics into the EN and ES guides
Mirror the six expanded guides (tone-prominence, tone-audibility,
psychoacoustic-annoyance, hearing-threshold, noise-induced-hearing-loss,
occupational-exposure) into the Astro site, English and Spanish: the new
equations, the didactic prose, the ISO 9612 dosimeter diagram embed and the
References sections, plus the Psychoacoustics and Hearing groups on both
bibliography pages.
* docs: deduplicate the site NIHL prose and align the index edition
Remove a duplicated, truncated copy of the "Three quantities, kept
distinct" block that slipped into the site EN noise-induced-hearing-loss
guide, and update the documentation index to the corrected ISO 389-7:2005
edition.
* docs: refine the psychoacoustics and hearing didactic wording
- Tone prominence: describe TNR and PR separately in the lead-in, since only
TNR compares the tone against the in-band noise while PR compares the middle
critical band with the mean of its neighbours. State both criteria piecewise
(8 dB and 9 dB flat from 1 kHz up) and apply them inclusively with an equal
sign, matching the implementation. Translate the Spanish figure snippet
strings (title, axis labels) to match the rendered figure.
- Hearing threshold: soften the unscreened-population claim to an average
tendency rather than every age or frequency, and tie database B to ISO 1999
as its alternate unscreened reference. Use a more natural Spanish verb for
the 90th percentile.
- Noise-induced hearing loss: present 40 dB of combined loss as an approximate
marker where the HN/120 compression becomes noticeable, not a hard boundary,
since the correction scales with the product of the two components.
- Tone audibility: note that ISO/PAS 20065:2016 is withdrawn and superseded by
ISO/TS 20065:2022, while keeping the implemented 2016 edition provenance.
docs: psychoacoustics and hearing didactics, ISO 9612 dosimeter diagram and verified references (#191)
* docs: ISO 9612 occupational-exposure dosimeter and strategy diagram
Add diagram_dosimeter_iso9612 to the SVG toolkit: a worker wearing a
shoulder-mounted personal sound exposure meter with the microphone about
0.04 m above the shoulder and at least 0.1 m from the most-exposed ear
canal (Clause 12.3), alongside the three measurement strategies drawn as
labelled timelines over an eight-hour working day (task-based, job-based
and full-day, Clauses 9-11). Four deterministic variants (EN/ES, light/dark).
* docs: didactic depth and verified references for the psychoacoustics and hearing guides
Expand the six psychoacoustics and hearing guides (GitHub docs copies):
- tone-prominence: add the TNR and PR equations as display math, a
paragraph on when the two ratios disagree, a figure-code <details>, and
a References section (ECMA-418-1 and ECMA-74 free PDFs).
- tone-audibility: explain how the decisive band is selected and how to
read the extended uncertainty, including the ISO 1996-2 Annex J tonal
adjustment; References (ISO/PAS 20065, ISO 1996-2).
- psychoacoustic-annoyance: formalize the Fastl & Zwicker (2007), Osses
et al. (2016) and SQAT references.
- hearing-threshold: the otologically-normal population, percentile
interpretation, ISO 389-7 edition corrected to 2005; References.
- noise-induced-hearing-loss: NIPTS vs HTLAN vs total-threshold relations
and the fence caveats; References (ISO 1999, Passchier-Vermeer 1974,
NIOSH 98-126).
- occupational-exposure: embed the new ISO 9612 diagram, add
measurement-strategy selection and uncertainty-budget dominance prose;
References (ISO 9612, Directive 2003/10/EC, NIOSH 98-126).
Add the Psychoacoustics and Hearing groups to the global bibliography.
* docs(site): mirror the psychoacoustics and hearing didactics into the EN and ES guides
Mirror the six expanded guides (tone-prominence, tone-audibility,
psychoacoustic-annoyance, hearing-threshold, noise-induced-hearing-loss,
occupational-exposure) into the Astro site, English and Spanish: the new
equations, the didactic prose, the ISO 9612 dosimeter diagram embed and the
References sections, plus the Psychoacoustics and Hearing groups on both
bibliography pages.
* docs: deduplicate the site NIHL prose and align the index edition
Remove a duplicated, truncated copy of the "Three quantities, kept
distinct" block that slipped into the site EN noise-induced-hearing-loss
guide, and update the documentation index to the corrected ISO 389-7:2005
edition.
* docs: refine the psychoacoustics and hearing didactic wording
- Tone prominence: describe TNR and PR separately in the lead-in, since only
TNR compares the tone against the in-band noise while PR compares the middle
critical band with the mean of its neighbours. State both criteria piecewise
(8 dB and 9 dB flat from 1 kHz up) and apply them inclusively with an equal
sign, matching the implementation. Translate the Spanish figure snippet
strings (title, axis labels) to match the rendered figure.
- Hearing threshold: soften the unscreened-population claim to an average
tendency rather than every age or frequency, and tie database B to ISO 1999
as its alternate unscreened reference. Use a more natural Spanish verb for
the 90th percentile.
- Noise-induced hearing loss: present 40 dB of combined loss as an approximate
marker where the HN/120 compression becomes noticeable, not a hard boundary,
since the correction scales with the product of the two components.
- Tone audibility: note that ISO/PAS 20065:2016 is withdrawn and superseded by
ISO/TS 20065:2022, while keeping the implemented 2016 edition provenance.
docs: building and structure-borne didactics, five rig diagrams and verified references (#193)
* docs: five structure-borne rig diagrams (ISO 9052-1, ISO 7626, ISO 10846, EN 15657, EN 12354-5)
Deterministic SVG builders with shared spring, accelerometer and exciter
helpers; light/dark and EN/ES variants of the dynamic-stiffness resonance
rig, the mobility beam rig, the direct/indirect transfer-stiffness stacks,
the reception plate and the EN 12354-5 installed-paths cross-section.
* docs: lab-vs-field quantities map and C/Ctr interpretation for the insulation guides
The apostrophe convention and flanking inclusion spelled out across the
trio, the extended lab/field quantities table, a didactic reading of the
spectrum adaptation terms, the measurement-prediction-check loop, and
verified References sections (Hopkins, Vigran, ISO 717-1, ISO 16283-1) in
the three copies (docs, site EN, site ES).
* docs: didactic depth for the structure-borne measurement guides
Rig diagrams embedded and prose added in all three copies: resonance-method
assumptions and preload pitfalls (EN 29052-1), how to read a mobility plot
and the ISO 7626-2 arrangement, why the blocked force and the frequency
split of the ISO 10846 methods, when the radiation-factor assumption breaks
(ISO/TS 7849), the reception-plate rationale (EN 15657) and the EN 12354-5
installation-paths context, each with a verified References section.
* docs: building-acoustics and structure-borne groups in the global bibliography
Hopkins, Vigran and Cremer/Heckl/Petersson with verified DOIs, the ISO
catalogue entries cited by the new References sections, and back-links to
the citing guides in the three bibliography copies.
* docs: legibility fixes in the mobility, transfer-stiffness and reception-plate diagrams
The driving-point caption clears the suspension spring, the Spanish
impedance-head caption clears the exciter stem, the excitation-mass boxes
fit the Spanish label, the indirect formula uses a consistent glyph style
and the Spanish source-quantities heading keeps a right margin.
* docs: precision and wording fixes in the new building and structure-borne prose
The radiation-factor caveat now qualifies accuracy rather than the bound,
Part 2 is tied explicitly to the radiation-factor problem, the survey
method keeps one Spanish term per page, the impedance-head note no longer
overstates, and Spanish register fixes (recrecido, diferencia, anclan) plus
site bibliography link texts aligned to the site page titles.
* docs: address review feedback on the building and structure-borne guides
- Field insulation guide: carry the spectrum adaptation terms on the field
descriptors (R'w + Ctr for facades, DnT,w + C between dwellings), matching
the example requirements of ISO 717-1, 5.3
- Transfer stiffness: state the ISO 10846-2 direct-method range from its
1 Hz scope bound instead of arbitrarily low frequencies, and say the
output is either rigidly blocked or loaded with a known mass
- Mechanical mobility: restrict the mobility-peak damping reading to the
isolated viscously damped resonator, present the soft free-free suspension
as the usual ISO 7626-2 arrangement rather than a requirement (clause 5),
and describe ISO 7626-5 as impact excitation with a non-attached exciter
whose spectrum is set by the impactor mass and tip stiffness
- Installed-paths diagram: render the EN 12354-5 Formula 17 path combination
as an energetic sum, 10 lg of the summed 10^(L/10) terms
- Spanish wording: parallel 'o bien ... o bien' in the transfer-stiffness
rig sentence and 'luego' in the resonance-rig diagram formula
docs: building and structure-borne didactics, five rig diagrams and verified references (#193)
* docs: five structure-borne rig diagrams (ISO 9052-1, ISO 7626, ISO 10846, EN 15657, EN 12354-5)
Deterministic SVG builders with shared spring, accelerometer and exciter
helpers; light/dark and EN/ES variants of the dynamic-stiffness resonance
rig, the mobility beam rig, the direct/indirect transfer-stiffness stacks,
the reception plate and the EN 12354-5 installed-paths cross-section.
* docs: lab-vs-field quantities map and C/Ctr interpretation for the insulation guides
The apostrophe convention and flanking inclusion spelled out across the
trio, the extended lab/field quantities table, a didactic reading of the
spectrum adaptation terms, the measurement-prediction-check loop, and
verified References sections (Hopkins, Vigran, ISO 717-1, ISO 16283-1) in
the three copies (docs, site EN, site ES).
* docs: didactic depth for the structure-borne measurement guides
Rig diagrams embedded and prose added in all three copies: resonance-method
assumptions and preload pitfalls (EN 29052-1), how to read a mobility plot
and the ISO 7626-2 arrangement, why the blocked force and the frequency
split of the ISO 10846 methods, when the radiation-factor assumption breaks
(ISO/TS 7849), the reception-plate rationale (EN 15657) and the EN 12354-5
installation-paths context, each with a verified References section.
* docs: building-acoustics and structure-borne groups in the global bibliography
Hopkins, Vigran and Cremer/Heckl/Petersson with verified DOIs, the ISO
catalogue entries cited by the new References sections, and back-links to
the citing guides in the three bibliography copies.
* docs: legibility fixes in the mobility, transfer-stiffness and reception-plate diagrams
The driving-point caption clears the suspension spring, the Spanish
impedance-head caption clears the exciter stem, the excitation-mass boxes
fit the Spanish label, the indirect formula uses a consistent glyph style
and the Spanish source-quantities heading keeps a right margin.
* docs: precision and wording fixes in the new building and structure-borne prose
The radiation-factor caveat now qualifies accuracy rather than the bound,
Part 2 is tied explicitly to the radiation-factor problem, the survey
method keeps one Spanish term per page, the impedance-head note no longer
overstates, and Spanish register fixes (recrecido, diferencia, anclan) plus
site bibliography link texts aligned to the site page titles.
* docs: address review feedback on the building and structure-borne guides
- Field insulation guide: carry the spectrum adaptation terms on the field
descriptors (R'w + Ctr for facades, DnT,w + C between dwellings), matching
the example requirements of ISO 717-1, 5.3
- Transfer stiffness: state the ISO 10846-2 direct-method range from its
1 Hz scope bound instead of arbitrarily low frequencies, and say the
output is either rigidly blocked or loaded with a known mass
- Mechanical mobility: restrict the mobility-peak damping reading to the
isolated viscously damped resonator, present the soft free-free suspension
as the usual ISO 7626-2 arrangement rather than a requirement (clause 5),
and describe ISO 7626-5 as impact excitation with a non-attached exciter
whose spectrum is set by the impactor mass and tip stiffness
- Installed-paths diagram: render the EN 12354-5 Formula 17 path combination
as an energetic sum, 10 lg of the summed 10^(L/10) terms
- Spanish wording: parallel 'o bien ... o bien' in the transfer-stiffness
rig sentence and 'luego' in the resonance-rig diagram formula
docs: building and structure-borne didactics, five rig diagrams and verified references (#193)
* docs: five structure-borne rig diagrams (ISO 9052-1, ISO 7626, ISO 10846, EN 15657, EN 12354-5)
Deterministic SVG builders with shared spring, accelerometer and exciter
helpers; light/dark and EN/ES variants of the dynamic-stiffness resonance
rig, the mobility beam rig, the direct/indirect transfer-stiffness stacks,
the reception plate and the EN 12354-5 installed-paths cross-section.
* docs: lab-vs-field quantities map and C/Ctr interpretation for the insulation guides
The apostrophe convention and flanking inclusion spelled out across the
trio, the extended lab/field quantities table, a didactic reading of the
spectrum adaptation terms, the measurement-prediction-check loop, and
verified References sections (Hopkins, Vigran, ISO 717-1, ISO 16283-1) in
the three copies (docs, site EN, site ES).
* docs: didactic depth for the structure-borne measurement guides
Rig diagrams embedded and prose added in all three copies: resonance-method
assumptions and preload pitfalls (EN 29052-1), how to read a mobility plot
and the ISO 7626-2 arrangement, why the blocked force and the frequency
split of the ISO 10846 methods, when the radiation-factor assumption breaks
(ISO/TS 7849), the reception-plate rationale (EN 15657) and the EN 12354-5
installation-paths context, each with a verified References section.
* docs: building-acoustics and structure-borne groups in the global bibliography
Hopkins, Vigran and Cremer/Heckl/Petersson with verified DOIs, the ISO
catalogue entries cited by the new References sections, and back-links to
the citing guides in the three bibliography copies.
* docs: legibility fixes in the mobility, transfer-stiffness and reception-plate diagrams
The driving-point caption clears the suspension spring, the Spanish
impedance-head caption clears the exciter stem, the excitation-mass boxes
fit the Spanish label, the indirect formula uses a consistent glyph style
and the Spanish source-quantities heading keeps a right margin.
* docs: precision and wording fixes in the new building and structure-borne prose
The radiation-factor caveat now qualifies accuracy rather than the bound,
Part 2 is tied explicitly to the radiation-factor problem, the survey
method keeps one Spanish term per page, the impedance-head note no longer
overstates, and Spanish register fixes (recrecido, diferencia, anclan) plus
site bibliography link texts aligned to the site page titles.
* docs: address review feedback on the building and structure-borne guides
- Field insulation guide: carry the spectrum adaptation terms on the field
descriptors (R'w + Ctr for facades, DnT,w + C between dwellings), matching
the example requirements of ISO 717-1, 5.3
- Transfer stiffness: state the ISO 10846-2 direct-method range from its
1 Hz scope bound instead of arbitrarily low frequencies, and say the
output is either rigidly blocked or loaded with a known mass
- Mechanical mobility: restrict the mobility-peak damping reading to the
isolated viscously damped resonator, present the soft free-free suspension
as the usual ISO 7626-2 arrangement rather than a requirement (clause 5),
and describe ISO 7626-5 as impact excitation with a non-attached exciter
whose spectrum is set by the impactor mass and tip stiffness
- Installed-paths diagram: render the EN 12354-5 Formula 17 path combination
as an energetic sum, 10 lg of the summed 10^(L/10) terms
- Spanish wording: parallel 'o bien ... o bien' in the transfer-stiffness
rig sentence and 'luego' in the resonance-rig diagram formula
docs: building and structure-borne didactics, five rig diagrams and verified references (#193)
* docs: five structure-borne rig diagrams (ISO 9052-1, ISO 7626, ISO 10846, EN 15657, EN 12354-5)
Deterministic SVG builders with shared spring, accelerometer and exciter
helpers; light/dark and EN/ES variants of the dynamic-stiffness resonance
rig, the mobility beam rig, the direct/indirect transfer-stiffness stacks,
the reception plate and the EN 12354-5 installed-paths cross-section.
* docs: lab-vs-field quantities map and C/Ctr interpretation for the insulation guides
The apostrophe convention and flanking inclusion spelled out across the
trio, the extended lab/field quantities table, a didactic reading of the
spectrum adaptation terms, the measurement-prediction-check loop, and
verified References sections (Hopkins, Vigran, ISO 717-1, ISO 16283-1) in
the three copies (docs, site EN, site ES).
* docs: didactic depth for the structure-borne measurement guides
Rig diagrams embedded and prose added in all three copies: resonance-method
assumptions and preload pitfalls (EN 29052-1), how to read a mobility plot
and the ISO 7626-2 arrangement, why the blocked force and the frequency
split of the ISO 10846 methods, when the radiation-factor assumption breaks
(ISO/TS 7849), the reception-plate rationale (EN 15657) and the EN 12354-5
installation-paths context, each with a verified References section.
* docs: building-acoustics and structure-borne groups in the global bibliography
Hopkins, Vigran and Cremer/Heckl/Petersson with verified DOIs, the ISO
catalogue entries cited by the new References sections, and back-links to
the citing guides in the three bibliography copies.
* docs: legibility fixes in the mobility, transfer-stiffness and reception-plate diagrams
The driving-point caption clears the suspension spring, the Spanish
impedance-head caption clears the exciter stem, the excitation-mass boxes
fit the Spanish label, the indirect formula uses a consistent glyph style
and the Spanish source-quantities heading keeps a right margin.
* docs: precision and wording fixes in the new building and structure-borne prose
The radiation-factor caveat now qualifies accuracy rather than the bound,
Part 2 is tied explicitly to the radiation-factor problem, the survey
method keeps one Spanish term per page, the impedance-head note no longer
overstates, and Spanish register fixes (recrecido, diferencia, anclan) plus
site bibliography link texts aligned to the site page titles.
* docs: address review feedback on the building and structure-borne guides
- Field insulation guide: carry the spectrum adaptation terms on the field
descriptors (R'w + Ctr for facades, DnT,w + C between dwellings), matching
the example requirements of ISO 717-1, 5.3
- Transfer stiffness: state the ISO 10846-2 direct-method range from its
1 Hz scope bound instead of arbitrarily low frequencies, and say the
output is either rigidly blocked or loaded with a known mass
- Mechanical mobility: restrict the mobility-peak damping reading to the
isolated viscously damped resonator, present the soft free-free suspension
as the usual ISO 7626-2 arrangement rather than a requirement (clause 5),
and describe ISO 7626-5 as impact excitation with a non-attached exciter
whose spectrum is set by the impactor mass and tip stiffness
- Installed-paths diagram: render the EN 12354-5 Formula 17 path combination
as an energetic sum, 10 lg of the summed 10^(L/10) terms
- Spanish wording: parallel 'o bien ... o bien' in the transfer-stiffness
rig sentence and 'luego' in the resonance-rig diagram formula
EN 12354-6: sound absorption in enclosed spaces (#107)
* feat: EN 12354-6 sound absorption in enclosed spaces
Add the EN 12354-6:2003 prediction of a room's total equivalent sound
absorption area and reverberation time from the absorption of its
surfaces and objects (the normative Clause 4 model).
The absorption area sums the surface contributions, the object areas and
the air absorption (Formula 1), with the air term Aair = 4*m*V*(1 - psi)
(Formula 2, Table 1), the object fraction psi = sum(Vobj)/V (Formula 3)
and the empirical hard-object area Aobj = Vobj^(2/3) (Formula 4). The
reverberation time follows as T = 55.3/c0 * V*(1 - psi)/A (Formula 5,
the 0.16 factor at c0 = 345.6 m/s). The informative Annex D method for
irregular spaces is out of scope.
New module phonometry.en12354_6 with equivalent_absorption_area,
object_fraction, hard_object_absorption, air_absorption_area,
reverberation_time and the per-band enclosed_space_reverberation
returning a ReverberationResult with .plot(). Conformance report gains
an enclosed-space absorption domain (2 checks, 90 total). Adds the
enclosed-space-absorption guide (repo + EN/ES site) with a figure and a
flow diagram.
Validated digit-exact against the three worked cases of Annex E
(A = 2.26/5.03/10.21 m2, T = 2.1/0.9/0.5 s, and the air-absorption
note Aair = 0.12 m2 -> T = 2.0 s).
* refactor: address review feedback on EN 12354-6
- validation helpers _require_positive/_require_fraction: single error
literal and no negated comparison, still rejecting NaN (SonarCloud
S1192/S1940)
- object_fraction: reject negative object volumes and a fraction >= 1
(Gemini)
- air_absorption_area: validate the object fraction range and a
non-negative attenuation coefficient (Gemini)
- equivalent_absorption_area: reject negative air_area, absorption
coefficients and object areas (Gemini)
- reverberation_time: validate the object fraction range (Gemini)
- enclosed_space_reverberation: clear error when a built-in
air_condition is combined with non-standard frequencies (Gemini)
- diagram + alt text: the speed-of-sound symbol is c0, not co
(CodeRabbit); the diagram now renders it as a proper subscript
- tests: cover the speed_of_sound guard (CodeRabbit), NaN volume, the
physical-range validations and the standard-bands guard
* docs: label the object-array sum in the Formula 1 prose
The third summand of Formula 1 is the standard's object arrays k
(groups of identical objects treated as an absorbing surface), not a
duplicated surface term; name all three indices in the surrounding
prose so the equation reads unambiguously (CodeRabbit).
EN 12354-6: sound absorption in enclosed spaces (#107)
* feat: EN 12354-6 sound absorption in enclosed spaces
Add the EN 12354-6:2003 prediction of a room's total equivalent sound
absorption area and reverberation time from the absorption of its
surfaces and objects (the normative Clause 4 model).
The absorption area sums the surface contributions, the object areas and
the air absorption (Formula 1), with the air term Aair = 4*m*V*(1 - psi)
(Formula 2, Table 1), the object fraction psi = sum(Vobj)/V (Formula 3)
and the empirical hard-object area Aobj = Vobj^(2/3) (Formula 4). The
reverberation time follows as T = 55.3/c0 * V*(1 - psi)/A (Formula 5,
the 0.16 factor at c0 = 345.6 m/s). The informative Annex D method for
irregular spaces is out of scope.
New module phonometry.en12354_6 with equivalent_absorption_area,
object_fraction, hard_object_absorption, air_absorption_area,
reverberation_time and the per-band enclosed_space_reverberation
returning a ReverberationResult with .plot(). Conformance report gains
an enclosed-space absorption domain (2 checks, 90 total). Adds the
enclosed-space-absorption guide (repo + EN/ES site) with a figure and a
flow diagram.
Validated digit-exact against the three worked cases of Annex E
(A = 2.26/5.03/10.21 m2, T = 2.1/0.9/0.5 s, and the air-absorption
note Aair = 0.12 m2 -> T = 2.0 s).
* refactor: address review feedback on EN 12354-6
- validation helpers _require_positive/_require_fraction: single error
literal and no negated comparison, still rejecting NaN (SonarCloud
S1192/S1940)
- object_fraction: reject negative object volumes and a fraction >= 1
(Gemini)
- air_absorption_area: validate the object fraction range and a
non-negative attenuation coefficient (Gemini)
- equivalent_absorption_area: reject negative air_area, absorption
coefficients and object areas (Gemini)
- reverberation_time: validate the object fraction range (Gemini)
- enclosed_space_reverberation: clear error when a built-in
air_condition is combined with non-standard frequencies (Gemini)
- diagram + alt text: the speed-of-sound symbol is c0, not co
(CodeRabbit); the diagram now renders it as a proper subscript
- tests: cover the speed_of_sound guard (CodeRabbit), NaN volume, the
physical-range validations and the standard-bands guard
* docs: label the object-array sum in the Formula 1 prose
The third summand of Formula 1 is the standard's object arrays k
(groups of identical objects treated as an absorbing surface), not a
duplicated surface term; name all three indices in the surrounding
prose so the equation reads unambiguously (CodeRabbit).
EN 12354-6: sound absorption in enclosed spaces (#107)
* feat: EN 12354-6 sound absorption in enclosed spaces
Add the EN 12354-6:2003 prediction of a room's total equivalent sound
absorption area and reverberation time from the absorption of its
surfaces and objects (the normative Clause 4 model).
The absorption area sums the surface contributions, the object areas and
the air absorption (Formula 1), with the air term Aair = 4*m*V*(1 - psi)
(Formula 2, Table 1), the object fraction psi = sum(Vobj)/V (Formula 3)
and the empirical hard-object area Aobj = Vobj^(2/3) (Formula 4). The
reverberation time follows as T = 55.3/c0 * V*(1 - psi)/A (Formula 5,
the 0.16 factor at c0 = 345.6 m/s). The informative Annex D method for
irregular spaces is out of scope.
New module phonometry.en12354_6 with equivalent_absorption_area,
object_fraction, hard_object_absorption, air_absorption_area,
reverberation_time and the per-band enclosed_space_reverberation
returning a ReverberationResult with .plot(). Conformance report gains
an enclosed-space absorption domain (2 checks, 90 total). Adds the
enclosed-space-absorption guide (repo + EN/ES site) with a figure and a
flow diagram.
Validated digit-exact against the three worked cases of Annex E
(A = 2.26/5.03/10.21 m2, T = 2.1/0.9/0.5 s, and the air-absorption
note Aair = 0.12 m2 -> T = 2.0 s).
* refactor: address review feedback on EN 12354-6
- validation helpers _require_positive/_require_fraction: single error
literal and no negated comparison, still rejecting NaN (SonarCloud
S1192/S1940)
- object_fraction: reject negative object volumes and a fraction >= 1
(Gemini)
- air_absorption_area: validate the object fraction range and a
non-negative attenuation coefficient (Gemini)
- equivalent_absorption_area: reject negative air_area, absorption
coefficients and object areas (Gemini)
- reverberation_time: validate the object fraction range (Gemini)
- enclosed_space_reverberation: clear error when a built-in
air_condition is combined with non-standard frequencies (Gemini)
- diagram + alt text: the speed-of-sound symbol is c0, not co
(CodeRabbit); the diagram now renders it as a proper subscript
- tests: cover the speed_of_sound guard (CodeRabbit), NaN volume, the
physical-range validations and the standard-bands guard
* docs: label the object-array sum in the Formula 1 prose
The third summand of Formula 1 is the standard's object arrays k
(groups of identical objects treated as an absorbing surface), not a
duplicated surface term; name all three indices in the surrounding
prose so the equation reads unambiguously (CodeRabbit).
EN 12354-6: sound absorption in enclosed spaces (#107)
* feat: EN 12354-6 sound absorption in enclosed spaces
Add the EN 12354-6:2003 prediction of a room's total equivalent sound
absorption area and reverberation time from the absorption of its
surfaces and objects (the normative Clause 4 model).
The absorption area sums the surface contributions, the object areas and
the air absorption (Formula 1), with the air term Aair = 4*m*V*(1 - psi)
(Formula 2, Table 1), the object fraction psi = sum(Vobj)/V (Formula 3)
and the empirical hard-object area Aobj = Vobj^(2/3) (Formula 4). The
reverberation time follows as T = 55.3/c0 * V*(1 - psi)/A (Formula 5,
the 0.16 factor at c0 = 345.6 m/s). The informative Annex D method for
irregular spaces is out of scope.
New module phonometry.en12354_6 with equivalent_absorption_area,
object_fraction, hard_object_absorption, air_absorption_area,
reverberation_time and the per-band enclosed_space_reverberation
returning a ReverberationResult with .plot(). Conformance report gains
an enclosed-space absorption domain (2 checks, 90 total). Adds the
enclosed-space-absorption guide (repo + EN/ES site) with a figure and a
flow diagram.
Validated digit-exact against the three worked cases of Annex E
(A = 2.26/5.03/10.21 m2, T = 2.1/0.9/0.5 s, and the air-absorption
note Aair = 0.12 m2 -> T = 2.0 s).
* refactor: address review feedback on EN 12354-6
- validation helpers _require_positive/_require_fraction: single error
literal and no negated comparison, still rejecting NaN (SonarCloud
S1192/S1940)
- object_fraction: reject negative object volumes and a fraction >= 1
(Gemini)
- air_absorption_area: validate the object fraction range and a
non-negative attenuation coefficient (Gemini)
- equivalent_absorption_area: reject negative air_area, absorption
coefficients and object areas (Gemini)
- reverberation_time: validate the object fraction range (Gemini)
- enclosed_space_reverberation: clear error when a built-in
air_condition is combined with non-standard frequencies (Gemini)
- diagram + alt text: the speed-of-sound symbol is c0, not co
(CodeRabbit); the diagram now renders it as a proper subscript
- tests: cover the speed_of_sound guard (CodeRabbit), NaN volume, the
physical-range validations and the standard-bands guard
* docs: label the object-array sum in the Formula 1 prose
The third summand of Formula 1 is the standard's object arrays k
(groups of identical objects treated as an absorbing surface), not a
duplicated surface term; name all three indices in the surrounding
prose so the equation reads unambiguously (CodeRabbit).
Didactic documentation: theory everywhere, bilingual figures, setup diagrams, parameter tables (#77)
* docs: harden diagram engine per visual audit
- dim() draws real witness lines from the measured points to the offset
dimension line (the offset=0 path emitted zero-length lines); vertical
labels sit left of the line, clear of masts and figures
- env diagram: the 4 m dimension now measures the mic axis itself and
the flush-mounted label moved to the clear zone between masts
- tonality top view: the 1.00 m dimension connects face and microphone
Claude-Session: https://claude.ai/code/session_013kkVt3nxi9svp1an28uHxf
* docs: bilingual diagram variants (EN/ES x light/dark)
Every setup diagram is now emitted in four variants; Spanish strings
(including decimal commas) come from a translation table applied by the
SVG engine, and layouts were adjusted where the longer Spanish labels
collided (env titles, processing-chain box width, calibration output
label, tonality dimension label side).
Claude-Session: https://claude.ai/code/session_013kkVt3nxi9svp1an28uHxf
* docs: bilingual figure variants for the ES site (EN/ES x light/dark)
generate_graphs.py now emits every figure in four variants: a Spanish
translation table (~75 exact strings + parametrized patterns) is applied
to the figure's Text artists at savefig time, so the generator functions
stay single-language internally. Spanish output uses UNE terminology
(ponderación temporal, líneas isofónicas, fonios, ráfaga) and a uniform
decimal comma (annotations and tick labels included); code identifiers
and normative mode names (Fast/Slow/Impulse) stay untranslated. The ES
site pages now reference the _es/_es_dark variants (56 URLs). The ES set
passed a 10-figure visual audit (10/10 approved, no blockers).
Claude-Session: https://claude.ai/code/session_013kkVt3nxi9svp1an28uHxf
* docs: didactic calibration page - theory, setup diagram, stability figure, parameter table
Adds the sensitivity-factor derivation with the calibration-chain SVG,
a new autogenerated calibration_stability figure (stable vs 3% AM tone
against the IEC 60942:2017 class 1 deviation band; 4 language/theme
variants; the ES decimal-comma pass now preserves clause numbers like
5.3.3), and a full parameter table for calculate_sensitivity - EN and
ES in parity.
Claude-Session: https://claude.ai/code/session_013kkVt3nxi9svp1an28uHxf
* docs: SEL concept, Lden 24h profile and annotated TNR spectrum figures
Three new didactic figures for the levels guide, each in four
language/theme variants: sel_concept (pass-by event vs its Leq and the
equal-energy 1 s SEL block, dBFS mode), lden_profile (synthetic urban
24 h LAeq with colored day/evening/night bands and the +5/+10 weighted
period levels clearly separated from the composite Lden), and
tonality_spectrum (averaged Hann spectrum with the critical band, the
detected tone and the live TNR value vs its criterion, computed by the
library itself).
Claude-Session: https://claude.ai/code/session_013kkVt3nxi9svp1an28uHxf
* docs: didactic levels guide, theory extensions and refreshed why-phonometry
- levels guide (EN docs+site): energy-mean rationale for Leq, percentile
semantics for LN, SEL and noise-dose theory with the new figures
embedded, TNR critical-band explanation with the annotated spectrum,
Lden profile figure, and parameter tables (type/units/range/default)
for every level function including the spectrogram
- theory page: five new sections (G-weighting pole/zero derivation,
ISO 226 formulae, ECMA-418-1 TNR/PR math, event/dose metrics,
ISO 1996-1 descriptors) with cross-references to the guides
- why-phonometry: rewritten around the conformance-testing story with
the per-standard verification table and honest ecosystem positioning
Claude-Session: https://claude.ai/code/session_013kkVt3nxi9svp1an28uHxf
* docs: weighting/time-weighting theory and parameter tables; fix math-block delimiters
The physiological origin of A/C (inverted 40/100-phon contours, the four
IEC corner frequencies) and the exponential-detector derivation with the
tau semantics, each with full parameter tables. Display math inserted by
the docs expansion now always uses block-style $$ delimiters on their
own lines - mid-line multi-line $$ blocks silently derailed remark
parsing and truncated every heading after them (caught because the
built pages lost their anchor ids); also replaced a raw < in a table.
Claude-Session: https://claude.ai/code/session_013kkVt3nxi9svp1an28uHxf
* docs: processing-chain and multirate diagrams, filter-bank math, streaming patterns
- getting-started embeds the processing-chain diagram as a guided map of
the guides
- filter-banks gains the IEC 61260-1 base-10 band math (G, fm, band
edges), a new multirate-decimation diagram (d5, four language/theme
variants) and the full octavefilter/OctaveFilterBank parameter table
- block-processing gains the canonical real-time level-meter loop
(validated against the actual API - TimeWeighting is inherently
stateful) and a stateful-constraints table
- multichannel gains the accepted-shapes table
Claude-Session: https://claude.ai/code/session_013kkVt3nxi9svp1an28uHxf
* docs: Spanish parity for the didactic expansion
Every enriched page now has its Spanish twin: levels (theory, three new
figures via _es variants, six parameter tables), weighting and
time-weighting (curve-origin and exponential-detector sections),
filter-banks (fractional-band math, multirate diagram, full parameter
table - terminology unified on 'decimación'), getting-started
(processing-chain map), block-processing (real-time meter pattern and
stateful constraints), multichannel (shapes table), theory (five new
sections) and a full rewrite of why-phonometry around the conformance
story. API reference now covers all 27 public exports in EN and ES
(added ToneAssessment and CalibrationWarning rows). UNE terminology and
Spanish decimal commas throughout; site builds with all links valid.
Claude-Session: https://claude.ai/code/session_013kkVt3nxi9svp1an28uHxf
* docs: audited fixes - Spanish tick commas and multirate note
Final visual-audit round: the d5 diagram now shows the no-decimation
note on the 16 kHz row in both languages, and Spanish figures render
every numeric tick with a decimal comma (FixedFormatter sequences are
rewritten in place; set_xticklabels-style FuncFormatters and plain
linear ScalarFormatters are wrapped - the first naive wrapper broke
ScalarFormatter ticks entirely and was caught visually).
Claude-Session: https://claude.ai/code/session_013kkVt3nxi9svp1an28uHxf
* docs(site): language selector in the mobile header, scrollable display math
Custom Header component (default markup plus a compact icon-only
LanguageSelect visible below the md breakpoint, where Starlight hides
the whole right group behind the hamburger menu) and overflow-x on
katex-display so wide formulas scroll inside their box on phones.
Verified with Playwright at 390 px in EN and ES.
Claude-Session: https://claude.ai/code/session_013kkVt3nxi9svp1an28uHxf
* fix: address review feedback on the didactic docs
- levels tables: spectrogram calibration_factor/dbfs marked constructor-
only, overlap range as 0 <= overlap < 1, composite hours constraints,
ln_levels shared-semantics row filled; ES translation leftovers and
the 'delante' typo fixed
- block-processing: y[..., -1] so the meter loop is multichannel-safe;
high_accuracy wording matches the real behavior (default resolves to
False, explicit True raises)
- API: CalibrationWarning row states the fs/validate preconditions (3 files)
- weighting: high_accuracy default column and oversampling claim made
precise (8x cap; silently ignored for G); ES row in parity
- filter-banks: 25 Hz relative bandwidth corrected to 0.024% of Nyquist
(EN/ES); verify_filter_class classes documented as 1/2/None
- generate_graphs: dropped the global plt.savefig monkey-patch - the
translation now runs inside themed_path(), which every generator
already calls at save time (verified output identical)
Claude-Session: https://claude.ai/code/session_013kkVt3nxi9svp1an28uHxf
Didactic documentation: theory everywhere, bilingual figures, setup diagrams, parameter tables (#77)
* docs: harden diagram engine per visual audit
- dim() draws real witness lines from the measured points to the offset
dimension line (the offset=0 path emitted zero-length lines); vertical
labels sit left of the line, clear of masts and figures
- env diagram: the 4 m dimension now measures the mic axis itself and
the flush-mounted label moved to the clear zone between masts
- tonality top view: the 1.00 m dimension connects face and microphone
Claude-Session: https://claude.ai/code/session_013kkVt3nxi9svp1an28uHxf
* docs: bilingual diagram variants (EN/ES x light/dark)
Every setup diagram is now emitted in four variants; Spanish strings
(including decimal commas) come from a translation table applied by the
SVG engine, and layouts were adjusted where the longer Spanish labels
collided (env titles, processing-chain box width, calibration output
label, tonality dimension label side).
Claude-Session: https://claude.ai/code/session_013kkVt3nxi9svp1an28uHxf
* docs: bilingual figure variants for the ES site (EN/ES x light/dark)
generate_graphs.py now emits every figure in four variants: a Spanish
translation table (~75 exact strings + parametrized patterns) is applied
to the figure's Text artists at savefig time, so the generator functions
stay single-language internally. Spanish output uses UNE terminology
(ponderación temporal, líneas isofónicas, fonios, ráfaga) and a uniform
decimal comma (annotations and tick labels included); code identifiers
and normative mode names (Fast/Slow/Impulse) stay untranslated. The ES
site pages now reference the _es/_es_dark variants (56 URLs). The ES set
passed a 10-figure visual audit (10/10 approved, no blockers).
Claude-Session: https://claude.ai/code/session_013kkVt3nxi9svp1an28uHxf
* docs: didactic calibration page - theory, setup diagram, stability figure, parameter table
Adds the sensitivity-factor derivation with the calibration-chain SVG,
a new autogenerated calibration_stability figure (stable vs 3% AM tone
against the IEC 60942:2017 class 1 deviation band; 4 language/theme
variants; the ES decimal-comma pass now preserves clause numbers like
5.3.3), and a full parameter table for calculate_sensitivity - EN and
ES in parity.
Claude-Session: https://claude.ai/code/session_013kkVt3nxi9svp1an28uHxf
* docs: SEL concept, Lden 24h profile and annotated TNR spectrum figures
Three new didactic figures for the levels guide, each in four
language/theme variants: sel_concept (pass-by event vs its Leq and the
equal-energy 1 s SEL block, dBFS mode), lden_profile (synthetic urban
24 h LAeq with colored day/evening/night bands and the +5/+10 weighted
period levels clearly separated from the composite Lden), and
tonality_spectrum (averaged Hann spectrum with the critical band, the
detected tone and the live TNR value vs its criterion, computed by the
library itself).
Claude-Session: https://claude.ai/code/session_013kkVt3nxi9svp1an28uHxf
* docs: didactic levels guide, theory extensions and refreshed why-phonometry
- levels guide (EN docs+site): energy-mean rationale for Leq, percentile
semantics for LN, SEL and noise-dose theory with the new figures
embedded, TNR critical-band explanation with the annotated spectrum,
Lden profile figure, and parameter tables (type/units/range/default)
for every level function including the spectrogram
- theory page: five new sections (G-weighting pole/zero derivation,
ISO 226 formulae, ECMA-418-1 TNR/PR math, event/dose metrics,
ISO 1996-1 descriptors) with cross-references to the guides
- why-phonometry: rewritten around the conformance-testing story with
the per-standard verification table and honest ecosystem positioning
Claude-Session: https://claude.ai/code/session_013kkVt3nxi9svp1an28uHxf
* docs: weighting/time-weighting theory and parameter tables; fix math-block delimiters
The physiological origin of A/C (inverted 40/100-phon contours, the four
IEC corner frequencies) and the exponential-detector derivation with the
tau semantics, each with full parameter tables. Display math inserted by
the docs expansion now always uses block-style $$ delimiters on their
own lines - mid-line multi-line $$ blocks silently derailed remark
parsing and truncated every heading after them (caught because the
built pages lost their anchor ids); also replaced a raw < in a table.
Claude-Session: https://claude.ai/code/session_013kkVt3nxi9svp1an28uHxf
* docs: processing-chain and multirate diagrams, filter-bank math, streaming patterns
- getting-started embeds the processing-chain diagram as a guided map of
the guides
- filter-banks gains the IEC 61260-1 base-10 band math (G, fm, band
edges), a new multirate-decimation diagram (d5, four language/theme
variants) and the full octavefilter/OctaveFilterBank parameter table
- block-processing gains the canonical real-time level-meter loop
(validated against the actual API - TimeWeighting is inherently
stateful) and a stateful-constraints table
- multichannel gains the accepted-shapes table
Claude-Session: https://claude.ai/code/session_013kkVt3nxi9svp1an28uHxf
* docs: Spanish parity for the didactic expansion
Every enriched page now has its Spanish twin: levels (theory, three new
figures via _es variants, six parameter tables), weighting and
time-weighting (curve-origin and exponential-detector sections),
filter-banks (fractional-band math, multirate diagram, full parameter
table - terminology unified on 'decimación'), getting-started
(processing-chain map), block-processing (real-time meter pattern and
stateful constraints), multichannel (shapes table), theory (five new
sections) and a full rewrite of why-phonometry around the conformance
story. API reference now covers all 27 public exports in EN and ES
(added ToneAssessment and CalibrationWarning rows). UNE terminology and
Spanish decimal commas throughout; site builds with all links valid.
Claude-Session: https://claude.ai/code/session_013kkVt3nxi9svp1an28uHxf
* docs: audited fixes - Spanish tick commas and multirate note
Final visual-audit round: the d5 diagram now shows the no-decimation
note on the 16 kHz row in both languages, and Spanish figures render
every numeric tick with a decimal comma (FixedFormatter sequences are
rewritten in place; set_xticklabels-style FuncFormatters and plain
linear ScalarFormatters are wrapped - the first naive wrapper broke
ScalarFormatter ticks entirely and was caught visually).
Claude-Session: https://claude.ai/code/session_013kkVt3nxi9svp1an28uHxf
* docs(site): language selector in the mobile header, scrollable display math
Custom Header component (default markup plus a compact icon-only
LanguageSelect visible below the md breakpoint, where Starlight hides
the whole right group behind the hamburger menu) and overflow-x on
katex-display so wide formulas scroll inside their box on phones.
Verified with Playwright at 390 px in EN and ES.
Claude-Session: https://claude.ai/code/session_013kkVt3nxi9svp1an28uHxf
* fix: address review feedback on the didactic docs
- levels tables: spectrogram calibration_factor/dbfs marked constructor-
only, overlap range as 0 <= overlap < 1, composite hours constraints,
ln_levels shared-semantics row filled; ES translation leftovers and
the 'delante' typo fixed
- block-processing: y[..., -1] so the meter loop is multichannel-safe;
high_accuracy wording matches the real behavior (default resolves to
False, explicit True raises)
- API: CalibrationWarning row states the fs/validate preconditions (3 files)
- weighting: high_accuracy default column and oversampling claim made
precise (8x cap; silently ignored for G); ES row in parity
- filter-banks: 25 Hz relative bandwidth corrected to 0.024% of Nyquist
(EN/ES); verify_filter_class classes documented as 1/2/None
- generate_graphs: dropped the global plt.savefig monkey-patch - the
translation now runs inside themed_path(), which every generator
already calls at save time (verified output identical)
Claude-Session: https://claude.ai/code/session_013kkVt3nxi9svp1an28uHxf
Didactic documentation: theory everywhere, bilingual figures, setup diagrams, parameter tables (#77)
* docs: harden diagram engine per visual audit
- dim() draws real witness lines from the measured points to the offset
dimension line (the offset=0 path emitted zero-length lines); vertical
labels sit left of the line, clear of masts and figures
- env diagram: the 4 m dimension now measures the mic axis itself and
the flush-mounted label moved to the clear zone between masts
- tonality top view: the 1.00 m dimension connects face and microphone
Claude-Session: https://claude.ai/code/session_013kkVt3nxi9svp1an28uHxf
* docs: bilingual diagram variants (EN/ES x light/dark)
Every setup diagram is now emitted in four variants; Spanish strings
(including decimal commas) come from a translation table applied by the
SVG engine, and layouts were adjusted where the longer Spanish labels
collided (env titles, processing-chain box width, calibration output
label, tonality dimension label side).
Claude-Session: https://claude.ai/code/session_013kkVt3nxi9svp1an28uHxf
* docs: bilingual figure variants for the ES site (EN/ES x light/dark)
generate_graphs.py now emits every figure in four variants: a Spanish
translation table (~75 exact strings + parametrized patterns) is applied
to the figure's Text artists at savefig time, so the generator functions
stay single-language internally. Spanish output uses UNE terminology
(ponderación temporal, líneas isofónicas, fonios, ráfaga) and a uniform
decimal comma (annotations and tick labels included); code identifiers
and normative mode names (Fast/Slow/Impulse) stay untranslated. The ES
site pages now reference the _es/_es_dark variants (56 URLs). The ES set
passed a 10-figure visual audit (10/10 approved, no blockers).
Claude-Session: https://claude.ai/code/session_013kkVt3nxi9svp1an28uHxf
* docs: didactic calibration page - theory, setup diagram, stability figure, parameter table
Adds the sensitivity-factor derivation with the calibration-chain SVG,
a new autogenerated calibration_stability figure (stable vs 3% AM tone
against the IEC 60942:2017 class 1 deviation band; 4 language/theme
variants; the ES decimal-comma pass now preserves clause numbers like
5.3.3), and a full parameter table for calculate_sensitivity - EN and
ES in parity.
Claude-Session: https://claude.ai/code/session_013kkVt3nxi9svp1an28uHxf
* docs: SEL concept, Lden 24h profile and annotated TNR spectrum figures
Three new didactic figures for the levels guide, each in four
language/theme variants: sel_concept (pass-by event vs its Leq and the
equal-energy 1 s SEL block, dBFS mode), lden_profile (synthetic urban
24 h LAeq with colored day/evening/night bands and the +5/+10 weighted
period levels clearly separated from the composite Lden), and
tonality_spectrum (averaged Hann spectrum with the critical band, the
detected tone and the live TNR value vs its criterion, computed by the
library itself).
Claude-Session: https://claude.ai/code/session_013kkVt3nxi9svp1an28uHxf
* docs: didactic levels guide, theory extensions and refreshed why-phonometry
- levels guide (EN docs+site): energy-mean rationale for Leq, percentile
semantics for LN, SEL and noise-dose theory with the new figures
embedded, TNR critical-band explanation with the annotated spectrum,
Lden profile figure, and parameter tables (type/units/range/default)
for every level function including the spectrogram
- theory page: five new sections (G-weighting pole/zero derivation,
ISO 226 formulae, ECMA-418-1 TNR/PR math, event/dose metrics,
ISO 1996-1 descriptors) with cross-references to the guides
- why-phonometry: rewritten around the conformance-testing story with
the per-standard verification table and honest ecosystem positioning
Claude-Session: https://claude.ai/code/session_013kkVt3nxi9svp1an28uHxf
* docs: weighting/time-weighting theory and parameter tables; fix math-block delimiters
The physiological origin of A/C (inverted 40/100-phon contours, the four
IEC corner frequencies) and the exponential-detector derivation with the
tau semantics, each with full parameter tables. Display math inserted by
the docs expansion now always uses block-style $$ delimiters on their
own lines - mid-line multi-line $$ blocks silently derailed remark
parsing and truncated every heading after them (caught because the
built pages lost their anchor ids); also replaced a raw < in a table.
Claude-Session: https://claude.ai/code/session_013kkVt3nxi9svp1an28uHxf
* docs: processing-chain and multirate diagrams, filter-bank math, streaming patterns
- getting-started embeds the processing-chain diagram as a guided map of
the guides
- filter-banks gains the IEC 61260-1 base-10 band math (G, fm, band
edges), a new multirate-decimation diagram (d5, four language/theme
variants) and the full octavefilter/OctaveFilterBank parameter table
- block-processing gains the canonical real-time level-meter loop
(validated against the actual API - TimeWeighting is inherently
stateful) and a stateful-constraints table
- multichannel gains the accepted-shapes table
Claude-Session: https://claude.ai/code/session_013kkVt3nxi9svp1an28uHxf
* docs: Spanish parity for the didactic expansion
Every enriched page now has its Spanish twin: levels (theory, three new
figures via _es variants, six parameter tables), weighting and
time-weighting (curve-origin and exponential-detector sections),
filter-banks (fractional-band math, multirate diagram, full parameter
table - terminology unified on 'decimación'), getting-started
(processing-chain map), block-processing (real-time meter pattern and
stateful constraints), multichannel (shapes table), theory (five new
sections) and a full rewrite of why-phonometry around the conformance
story. API reference now covers all 27 public exports in EN and ES
(added ToneAssessment and CalibrationWarning rows). UNE terminology and
Spanish decimal commas throughout; site builds with all links valid.
Claude-Session: https://claude.ai/code/session_013kkVt3nxi9svp1an28uHxf
* docs: audited fixes - Spanish tick commas and multirate note
Final visual-audit round: the d5 diagram now shows the no-decimation
note on the 16 kHz row in both languages, and Spanish figures render
every numeric tick with a decimal comma (FixedFormatter sequences are
rewritten in place; set_xticklabels-style FuncFormatters and plain
linear ScalarFormatters are wrapped - the first naive wrapper broke
ScalarFormatter ticks entirely and was caught visually).
Claude-Session: https://claude.ai/code/session_013kkVt3nxi9svp1an28uHxf
* docs(site): language selector in the mobile header, scrollable display math
Custom Header component (default markup plus a compact icon-only
LanguageSelect visible below the md breakpoint, where Starlight hides
the whole right group behind the hamburger menu) and overflow-x on
katex-display so wide formulas scroll inside their box on phones.
Verified with Playwright at 390 px in EN and ES.
Claude-Session: https://claude.ai/code/session_013kkVt3nxi9svp1an28uHxf
* fix: address review feedback on the didactic docs
- levels tables: spectrogram calibration_factor/dbfs marked constructor-
only, overlap range as 0 <= overlap < 1, composite hours constraints,
ln_levels shared-semantics row filled; ES translation leftovers and
the 'delante' typo fixed
- block-processing: y[..., -1] so the meter loop is multichannel-safe;
high_accuracy wording matches the real behavior (default resolves to
False, explicit True raises)
- API: CalibrationWarning row states the fs/validate preconditions (3 files)
- weighting: high_accuracy default column and oversampling claim made
precise (8x cap; silently ignored for G); ES row in parity
- filter-banks: 25 Hz relative bandwidth corrected to 0.024% of Nyquist
(EN/ES); verify_filter_class classes documented as 1/2/None
- generate_graphs: dropped the global plt.savefig monkey-patch - the
translation now runs inside themed_path(), which every generator
already calls at save time (verified output identical)
Claude-Session: https://claude.ai/code/session_013kkVt3nxi9svp1an28uHxf
Didactic documentation: theory everywhere, bilingual figures, setup diagrams, parameter tables (#77)
* docs: harden diagram engine per visual audit
- dim() draws real witness lines from the measured points to the offset
dimension line (the offset=0 path emitted zero-length lines); vertical
labels sit left of the line, clear of masts and figures
- env diagram: the 4 m dimension now measures the mic axis itself and
the flush-mounted label moved to the clear zone between masts
- tonality top view: the 1.00 m dimension connects face and microphone
Claude-Session: https://claude.ai/code/session_013kkVt3nxi9svp1an28uHxf
* docs: bilingual diagram variants (EN/ES x light/dark)
Every setup diagram is now emitted in four variants; Spanish strings
(including decimal commas) come from a translation table applied by the
SVG engine, and layouts were adjusted where the longer Spanish labels
collided (env titles, processing-chain box width, calibration output
label, tonality dimension label side).
Claude-Session: https://claude.ai/code/session_013kkVt3nxi9svp1an28uHxf
* docs: bilingual figure variants for the ES site (EN/ES x light/dark)
generate_graphs.py now emits every figure in four variants: a Spanish
translation table (~75 exact strings + parametrized patterns) is applied
to the figure's Text artists at savefig time, so the generator functions
stay single-language internally. Spanish output uses UNE terminology
(ponderación temporal, líneas isofónicas, fonios, ráfaga) and a uniform
decimal comma (annotations and tick labels included); code identifiers
and normative mode names (Fast/Slow/Impulse) stay untranslated. The ES
site pages now reference the _es/_es_dark variants (56 URLs). The ES set
passed a 10-figure visual audit (10/10 approved, no blockers).
Claude-Session: https://claude.ai/code/session_013kkVt3nxi9svp1an28uHxf
* docs: didactic calibration page - theory, setup diagram, stability figure, parameter table
Adds the sensitivity-factor derivation with the calibration-chain SVG,
a new autogenerated calibration_stability figure (stable vs 3% AM tone
against the IEC 60942:2017 class 1 deviation band; 4 language/theme
variants; the ES decimal-comma pass now preserves clause numbers like
5.3.3), and a full parameter table for calculate_sensitivity - EN and
ES in parity.
Claude-Session: https://claude.ai/code/session_013kkVt3nxi9svp1an28uHxf
* docs: SEL concept, Lden 24h profile and annotated TNR spectrum figures
Three new didactic figures for the levels guide, each in four
language/theme variants: sel_concept (pass-by event vs its Leq and the
equal-energy 1 s SEL block, dBFS mode), lden_profile (synthetic urban
24 h LAeq with colored day/evening/night bands and the +5/+10 weighted
period levels clearly separated from the composite Lden), and
tonality_spectrum (averaged Hann spectrum with the critical band, the
detected tone and the live TNR value vs its criterion, computed by the
library itself).
Claude-Session: https://claude.ai/code/session_013kkVt3nxi9svp1an28uHxf
* docs: didactic levels guide, theory extensions and refreshed why-phonometry
- levels guide (EN docs+site): energy-mean rationale for Leq, percentile
semantics for LN, SEL and noise-dose theory with the new figures
embedded, TNR critical-band explanation with the annotated spectrum,
Lden profile figure, and parameter tables (type/units/range/default)
for every level function including the spectrogram
- theory page: five new sections (G-weighting pole/zero derivation,
ISO 226 formulae, ECMA-418-1 TNR/PR math, event/dose metrics,
ISO 1996-1 descriptors) with cross-references to the guides
- why-phonometry: rewritten around the conformance-testing story with
the per-standard verification table and honest ecosystem positioning
Claude-Session: https://claude.ai/code/session_013kkVt3nxi9svp1an28uHxf
* docs: weighting/time-weighting theory and parameter tables; fix math-block delimiters
The physiological origin of A/C (inverted 40/100-phon contours, the four
IEC corner frequencies) and the exponential-detector derivation with the
tau semantics, each with full parameter tables. Display math inserted by
the docs expansion now always uses block-style $$ delimiters on their
own lines - mid-line multi-line $$ blocks silently derailed remark
parsing and truncated every heading after them (caught because the
built pages lost their anchor ids); also replaced a raw < in a table.
Claude-Session: https://claude.ai/code/session_013kkVt3nxi9svp1an28uHxf
* docs: processing-chain and multirate diagrams, filter-bank math, streaming patterns
- getting-started embeds the processing-chain diagram as a guided map of
the guides
- filter-banks gains the IEC 61260-1 base-10 band math (G, fm, band
edges), a new multirate-decimation diagram (d5, four language/theme
variants) and the full octavefilter/OctaveFilterBank parameter table
- block-processing gains the canonical real-time level-meter loop
(validated against the actual API - TimeWeighting is inherently
stateful) and a stateful-constraints table
- multichannel gains the accepted-shapes table
Claude-Session: https://claude.ai/code/session_013kkVt3nxi9svp1an28uHxf
* docs: Spanish parity for the didactic expansion
Every enriched page now has its Spanish twin: levels (theory, three new
figures via _es variants, six parameter tables), weighting and
time-weighting (curve-origin and exponential-detector sections),
filter-banks (fractional-band math, multirate diagram, full parameter
table - terminology unified on 'decimación'), getting-started
(processing-chain map), block-processing (real-time meter pattern and
stateful constraints), multichannel (shapes table), theory (five new
sections) and a full rewrite of why-phonometry around the conformance
story. API reference now covers all 27 public exports in EN and ES
(added ToneAssessment and CalibrationWarning rows). UNE terminology and
Spanish decimal commas throughout; site builds with all links valid.
Claude-Session: https://claude.ai/code/session_013kkVt3nxi9svp1an28uHxf
* docs: audited fixes - Spanish tick commas and multirate note
Final visual-audit round: the d5 diagram now shows the no-decimation
note on the 16 kHz row in both languages, and Spanish figures render
every numeric tick with a decimal comma (FixedFormatter sequences are
rewritten in place; set_xticklabels-style FuncFormatters and plain
linear ScalarFormatters are wrapped - the first naive wrapper broke
ScalarFormatter ticks entirely and was caught visually).
Claude-Session: https://claude.ai/code/session_013kkVt3nxi9svp1an28uHxf
* docs(site): language selector in the mobile header, scrollable display math
Custom Header component (default markup plus a compact icon-only
LanguageSelect visible below the md breakpoint, where Starlight hides
the whole right group behind the hamburger menu) and overflow-x on
katex-display so wide formulas scroll inside their box on phones.
Verified with Playwright at 390 px in EN and ES.
Claude-Session: https://claude.ai/code/session_013kkVt3nxi9svp1an28uHxf
* fix: address review feedback on the didactic docs
- levels tables: spectrogram calibration_factor/dbfs marked constructor-
only, overlap range as 0 <= overlap < 1, composite hours constraints,
ln_levels shared-semantics row filled; ES translation leftovers and
the 'delante' typo fixed
- block-processing: y[..., -1] so the meter loop is multichannel-safe;
high_accuracy wording matches the real behavior (default resolves to
False, explicit True raises)
- API: CalibrationWarning row states the fs/validate preconditions (3 files)
- weighting: high_accuracy default column and oversampling claim made
precise (8x cap; silently ignored for G); ES row in parity
- filter-banks: 25 Hz relative bandwidth corrected to 0.024% of Nyquist
(EN/ES); verify_filter_class classes documented as 1/2/None
- generate_graphs: dropped the global plt.savefig monkey-patch - the
translation now runs inside themed_path(), which every generator
already calls at save time (verified output identical)
Claude-Session: https://claude.ai/code/session_013kkVt3nxi9svp1an28uHxf
feat: 2D FDTD wave simulation as a public API (phonometry.simulation) (#221)
* feat: 2D FDTD wave simulation as a public API (phonometry.simulation)
Promote the staggered-grid pressure-velocity FDTD engine behind the
documentation animations to the library, following the reference model of
Attenborough & Van Renterghem (2021) chapter 4: fdtd_simulation() returns a
frozen FDTDResult with per-probe pressure histories, optional field
snapshots and .plot(); the FDTD2D stepping engine gains rasterised rigid
obstacle masks and per-side locally reacting real-impedance boundaries
(Eqs. 4.33-4.35) alongside the existing sponge layers, plus the
arbitrary-waveform SignalSource; scripts/fdtd2d.py becomes a re-export shim
so the committed animations render from the library code (verified
bit-identical). Validated against analytic oracles: box and duct
eigenfrequencies, free-field arrival delay and cylindrical decay, the
rigid-wall image echo, the normal-incidence impedance reflection
coefficient, the discrete dispersion relation and second-order convergence.
* test: FDTD conformance checks (rigid-box mode and pulse arrival delay)
Two additive analytic anchors in the conformance report: the (1,1)
eigenfrequency of a 1.0 x 0.7 m rigid box against the closed form
f = (c/2) sqrt(1/lx^2 + 1/ly^2), and the probe-to-probe arrival delay of a
free-field pulse over 0.6 m of air against (r2 - r1)/c.
* docs: FDTD concept figure and pipeline diagram
A single-concept figure from the public result object (a barrier
diffraction snapshot with the source, probes and geometry overlaid next to
the two probe histories, PNG per the raster-figure policy) and an SVG
pipeline diagram of the solver (domain, geometry, sources, leapfrog
update, stability bound, frozen result), both in the four language/theme
variants; existing figures regenerate byte-identically.
* docs: FDTD simulation guide (EN/ES), API reference and indices
A didactic guide in the three documentation trees: what FDTD is (the
staggered leapfrog scheme and the Courant bound), the sources, probes,
obstacles and boundary conditions, when a wave-based simulation is worth
its cost, the 2D line-source limits versus 3D, and the numerical
dispersion resolution rule, with runnable snippets whose printed values are
verified. New Wave simulation sidebar group with its section landing pages,
the generated API pages for phonometry.simulation.fdtd, the curated
api-reference rows, the README index entry, the bibliography cross-links
and the changelog entry.
* refactor: harden FDTD input validation and decompose the solver setup
- Reject multidimensional SignalSource samples instead of silently
flattening them, and require integral counts (sponge_width, steps,
record_every, decimate, snapshot_every, absorbing_layer_cells) and
integral source/probe cell indices: fractional values previously
crashed later inside numpy indexing or silently truncated the cell.
- Reuse a preallocated divergence buffer in the pressure step instead of
allocating a full-grid array every time step.
- Split FDTD2D.__init__, _build_edges and fdtd_simulation into focused
helpers with identical semantics; build boundary specs with
dict.fromkeys; construct test inputs outside pytest.raises blocks.
- Correct the numerical-dispersion prose in the guide, docstring and API
quick table: 10 cells per wavelength bounds the on-axis error at about
1.6 % ((k dx)^2 / 24), about 1.4 % at the default cfl, not below 1 %,
matching Attenborough & Van Renterghem's directional analysis; list
duration as its own parameter and drop the em-dashes from the table.
The default numerical path is bit-identical: a six-run battery (rigid
box, absorbing CW, mixed impedance/obstacle/damping, engine
record/decimate, variable c/rho maps, cfl 0.99 duct) reproduces the
previous arrays exactly (array_equal) and the committed figures
regenerate without churn.
* docs: state the dispersion error sign and the heterogeneous-domain caveat
The leading-order dispersion figure is the magnitude of a negative signed
error, and in a domain with spatially varying sound speed the 10-cell rule
uses the smallest speed while slower cells run at a lower local Courant
number, nearer the small-Courant bound. Stated in the guide (EN/ES), the
GitHub page and the source docstring, with the API page regenerated.
feat: 2D FDTD wave simulation as a public API (phonometry.simulation) (#221)
* feat: 2D FDTD wave simulation as a public API (phonometry.simulation)
Promote the staggered-grid pressure-velocity FDTD engine behind the
documentation animations to the library, following the reference model of
Attenborough & Van Renterghem (2021) chapter 4: fdtd_simulation() returns a
frozen FDTDResult with per-probe pressure histories, optional field
snapshots and .plot(); the FDTD2D stepping engine gains rasterised rigid
obstacle masks and per-side locally reacting real-impedance boundaries
(Eqs. 4.33-4.35) alongside the existing sponge layers, plus the
arbitrary-waveform SignalSource; scripts/fdtd2d.py becomes a re-export shim
so the committed animations render from the library code (verified
bit-identical). Validated against analytic oracles: box and duct
eigenfrequencies, free-field arrival delay and cylindrical decay, the
rigid-wall image echo, the normal-incidence impedance reflection
coefficient, the discrete dispersion relation and second-order convergence.
* test: FDTD conformance checks (rigid-box mode and pulse arrival delay)
Two additive analytic anchors in the conformance report: the (1,1)
eigenfrequency of a 1.0 x 0.7 m rigid box against the closed form
f = (c/2) sqrt(1/lx^2 + 1/ly^2), and the probe-to-probe arrival delay of a
free-field pulse over 0.6 m of air against (r2 - r1)/c.
* docs: FDTD concept figure and pipeline diagram
A single-concept figure from the public result object (a barrier
diffraction snapshot with the source, probes and geometry overlaid next to
the two probe histories, PNG per the raster-figure policy) and an SVG
pipeline diagram of the solver (domain, geometry, sources, leapfrog
update, stability bound, frozen result), both in the four language/theme
variants; existing figures regenerate byte-identically.
* docs: FDTD simulation guide (EN/ES), API reference and indices
A didactic guide in the three documentation trees: what FDTD is (the
staggered leapfrog scheme and the Courant bound), the sources, probes,
obstacles and boundary conditions, when a wave-based simulation is worth
its cost, the 2D line-source limits versus 3D, and the numerical
dispersion resolution rule, with runnable snippets whose printed values are
verified. New Wave simulation sidebar group with its section landing pages,
the generated API pages for phonometry.simulation.fdtd, the curated
api-reference rows, the README index entry, the bibliography cross-links
and the changelog entry.
* refactor: harden FDTD input validation and decompose the solver setup
- Reject multidimensional SignalSource samples instead of silently
flattening them, and require integral counts (sponge_width, steps,
record_every, decimate, snapshot_every, absorbing_layer_cells) and
integral source/probe cell indices: fractional values previously
crashed later inside numpy indexing or silently truncated the cell.
- Reuse a preallocated divergence buffer in the pressure step instead of
allocating a full-grid array every time step.
- Split FDTD2D.__init__, _build_edges and fdtd_simulation into focused
helpers with identical semantics; build boundary specs with
dict.fromkeys; construct test inputs outside pytest.raises blocks.
- Correct the numerical-dispersion prose in the guide, docstring and API
quick table: 10 cells per wavelength bounds the on-axis error at about
1.6 % ((k dx)^2 / 24), about 1.4 % at the default cfl, not below 1 %,
matching Attenborough & Van Renterghem's directional analysis; list
duration as its own parameter and drop the em-dashes from the table.
The default numerical path is bit-identical: a six-run battery (rigid
box, absorbing CW, mixed impedance/obstacle/damping, engine
record/decimate, variable c/rho maps, cfl 0.99 duct) reproduces the
previous arrays exactly (array_equal) and the committed figures
regenerate without churn.
* docs: state the dispersion error sign and the heterogeneous-domain caveat
The leading-order dispersion figure is the magnitude of a negative signed
error, and in a domain with spatially varying sound speed the 10-cell rule
uses the smallest speed while slower cells run at a lower local Courant
number, nearer the small-Courant bound. Stated in the guide (EN/ES), the
GitHub page and the source docstring, with the API page regenerated.
feat: 2D FDTD wave simulation as a public API (phonometry.simulation) (#221)
* feat: 2D FDTD wave simulation as a public API (phonometry.simulation)
Promote the staggered-grid pressure-velocity FDTD engine behind the
documentation animations to the library, following the reference model of
Attenborough & Van Renterghem (2021) chapter 4: fdtd_simulation() returns a
frozen FDTDResult with per-probe pressure histories, optional field
snapshots and .plot(); the FDTD2D stepping engine gains rasterised rigid
obstacle masks and per-side locally reacting real-impedance boundaries
(Eqs. 4.33-4.35) alongside the existing sponge layers, plus the
arbitrary-waveform SignalSource; scripts/fdtd2d.py becomes a re-export shim
so the committed animations render from the library code (verified
bit-identical). Validated against analytic oracles: box and duct
eigenfrequencies, free-field arrival delay and cylindrical decay, the
rigid-wall image echo, the normal-incidence impedance reflection
coefficient, the discrete dispersion relation and second-order convergence.
* test: FDTD conformance checks (rigid-box mode and pulse arrival delay)
Two additive analytic anchors in the conformance report: the (1,1)
eigenfrequency of a 1.0 x 0.7 m rigid box against the closed form
f = (c/2) sqrt(1/lx^2 + 1/ly^2), and the probe-to-probe arrival delay of a
free-field pulse over 0.6 m of air against (r2 - r1)/c.
* docs: FDTD concept figure and pipeline diagram
A single-concept figure from the public result object (a barrier
diffraction snapshot with the source, probes and geometry overlaid next to
the two probe histories, PNG per the raster-figure policy) and an SVG
pipeline diagram of the solver (domain, geometry, sources, leapfrog
update, stability bound, frozen result), both in the four language/theme
variants; existing figures regenerate byte-identically.
* docs: FDTD simulation guide (EN/ES), API reference and indices
A didactic guide in the three documentation trees: what FDTD is (the
staggered leapfrog scheme and the Courant bound), the sources, probes,
obstacles and boundary conditions, when a wave-based simulation is worth
its cost, the 2D line-source limits versus 3D, and the numerical
dispersion resolution rule, with runnable snippets whose printed values are
verified. New Wave simulation sidebar group with its section landing pages,
the generated API pages for phonometry.simulation.fdtd, the curated
api-reference rows, the README index entry, the bibliography cross-links
and the changelog entry.
* refactor: harden FDTD input validation and decompose the solver setup
- Reject multidimensional SignalSource samples instead of silently
flattening them, and require integral counts (sponge_width, steps,
record_every, decimate, snapshot_every, absorbing_layer_cells) and
integral source/probe cell indices: fractional values previously
crashed later inside numpy indexing or silently truncated the cell.
- Reuse a preallocated divergence buffer in the pressure step instead of
allocating a full-grid array every time step.
- Split FDTD2D.__init__, _build_edges and fdtd_simulation into focused
helpers with identical semantics; build boundary specs with
dict.fromkeys; construct test inputs outside pytest.raises blocks.
- Correct the numerical-dispersion prose in the guide, docstring and API
quick table: 10 cells per wavelength bounds the on-axis error at about
1.6 % ((k dx)^2 / 24), about 1.4 % at the default cfl, not below 1 %,
matching Attenborough & Van Renterghem's directional analysis; list
duration as its own parameter and drop the em-dashes from the table.
The default numerical path is bit-identical: a six-run battery (rigid
box, absorbing CW, mixed impedance/obstacle/damping, engine
record/decimate, variable c/rho maps, cfl 0.99 duct) reproduces the
previous arrays exactly (array_equal) and the committed figures
regenerate without churn.
* docs: state the dispersion error sign and the heterogeneous-domain caveat
The leading-order dispersion figure is the magnitude of a negative signed
error, and in a domain with spatially varying sound speed the 10-cell rule
uses the smallest speed while slower cells run at a lower local Courant
number, nearer the small-Courant bound. Stated in the guide (EN/ES), the
GitHub page and the source docstring, with the API page regenerated.
feat: 2D FDTD wave simulation as a public API (phonometry.simulation) (#221)
* feat: 2D FDTD wave simulation as a public API (phonometry.simulation)
Promote the staggered-grid pressure-velocity FDTD engine behind the
documentation animations to the library, following the reference model of
Attenborough & Van Renterghem (2021) chapter 4: fdtd_simulation() returns a
frozen FDTDResult with per-probe pressure histories, optional field
snapshots and .plot(); the FDTD2D stepping engine gains rasterised rigid
obstacle masks and per-side locally reacting real-impedance boundaries
(Eqs. 4.33-4.35) alongside the existing sponge layers, plus the
arbitrary-waveform SignalSource; scripts/fdtd2d.py becomes a re-export shim
so the committed animations render from the library code (verified
bit-identical). Validated against analytic oracles: box and duct
eigenfrequencies, free-field arrival delay and cylindrical decay, the
rigid-wall image echo, the normal-incidence impedance reflection
coefficient, the discrete dispersion relation and second-order convergence.
* test: FDTD conformance checks (rigid-box mode and pulse arrival delay)
Two additive analytic anchors in the conformance report: the (1,1)
eigenfrequency of a 1.0 x 0.7 m rigid box against the closed form
f = (c/2) sqrt(1/lx^2 + 1/ly^2), and the probe-to-probe arrival delay of a
free-field pulse over 0.6 m of air against (r2 - r1)/c.
* docs: FDTD concept figure and pipeline diagram
A single-concept figure from the public result object (a barrier
diffraction snapshot with the source, probes and geometry overlaid next to
the two probe histories, PNG per the raster-figure policy) and an SVG
pipeline diagram of the solver (domain, geometry, sources, leapfrog
update, stability bound, frozen result), both in the four language/theme
variants; existing figures regenerate byte-identically.
* docs: FDTD simulation guide (EN/ES), API reference and indices
A didactic guide in the three documentation trees: what FDTD is (the
staggered leapfrog scheme and the Courant bound), the sources, probes,
obstacles and boundary conditions, when a wave-based simulation is worth
its cost, the 2D line-source limits versus 3D, and the numerical
dispersion resolution rule, with runnable snippets whose printed values are
verified. New Wave simulation sidebar group with its section landing pages,
the generated API pages for phonometry.simulation.fdtd, the curated
api-reference rows, the README index entry, the bibliography cross-links
and the changelog entry.
* refactor: harden FDTD input validation and decompose the solver setup
- Reject multidimensional SignalSource samples instead of silently
flattening them, and require integral counts (sponge_width, steps,
record_every, decimate, snapshot_every, absorbing_layer_cells) and
integral source/probe cell indices: fractional values previously
crashed later inside numpy indexing or silently truncated the cell.
- Reuse a preallocated divergence buffer in the pressure step instead of
allocating a full-grid array every time step.
- Split FDTD2D.__init__, _build_edges and fdtd_simulation into focused
helpers with identical semantics; build boundary specs with
dict.fromkeys; construct test inputs outside pytest.raises blocks.
- Correct the numerical-dispersion prose in the guide, docstring and API
quick table: 10 cells per wavelength bounds the on-axis error at about
1.6 % ((k dx)^2 / 24), about 1.4 % at the default cfl, not below 1 %,
matching Attenborough & Van Renterghem's directional analysis; list
duration as its own parameter and drop the em-dashes from the table.
The default numerical path is bit-identical: a six-run battery (rigid
box, absorbing CW, mixed impedance/obstacle/damping, engine
record/decimate, variable c/rho maps, cfl 0.99 duct) reproduces the
previous arrays exactly (array_equal) and the committed figures
regenerate without churn.
* docs: state the dispersion error sign and the heterogeneous-domain caveat
The leading-order dispersion figure is the magnitude of a negative signed
error, and in a domain with spatially varying sound speed the 10-cell rule
uses the smallest speed while slower cells run at a lower local Courant
number, nearer the small-Courant bound. Stated in the guide (EN/ES), the
GitHub page and the source docstring, with the API page regenerated.
Building acoustics II: facade insulation (ISO 16283-3), laboratory measurement (ISO 10140), prediction with flanking (EN 12354) and uncertainty (ISO 12999-1) (#88)
* feat: ISO 16283-3 facade sound insulation
Add facade_insulation() and FacadeInsulationResult for field facade sound
insulation per ISO 16283-3: the global-method level difference D2m and its
standardized (D2m,nT) and normalized (D2m,n) forms, plus the element-method
apparent sound reduction index R'45 (loudspeaker, -1,5 dB) / R'tr,s (road
traffic, -3 dB). Reuses the ISO 16283-1 energy-averaging helpers, the
Sabine absorption area, and the ISO 717-1 airborne weighted_rating engine
unchanged for the single-number rating. Adds a per-band .plot() profile and
exports.
Claude-Session: https://claude.ai/code/session_013kkVt3nxi9svp1an28uHxf
* fix: ISO 16283-3 draft-edition caveat and symmetric R' validation
Claude-Session: https://claude.ai/code/session_013kkVt3nxi9svp1an28uHxf
* feat: ISO 10140 laboratory airborne and impact sound insulation
Add src/phonometry/lab_insulation.py, the laboratory counterpart of the
field ISO 16283 family:
- lab_airborne_insulation: R = L1 - L2 + 10 lg(S/A) with A = 0,16 V/T
(ISO 10140-2:2010 Formula (2); ISO 10140-4:2010 Formula (5)).
- lab_impact_insulation: Ln = Li + 10 lg(A/A0), A0 = 10 m²
(ISO 10140-3:2010 Formula (1)).
- background_correction: ISO 10140-4:2010 Clause 4.3 Formula (4) with the
6/15 dB criteria and the 1,3 dB limit-of-measurement cap.
Single-number Rw / Ln,w with C, Ctr, CI reuse the verified ISO 717-1/2
weighted_rating / weighted_impact_rating engines; position energy
averaging reuses _as_band_levels. 29 new closed-form / identity tests.
Claude-Session: https://claude.ai/code/session_013kkVt3nxi9svp1an28uHxf
* docs: reconcile facade citations with published ISO 16283-3:2016
The facade module was drafted from ISO/DIS 16283-3:2014; its docstrings
cited draft formula numbers with a caveat to reconcile against the
published edition. Reconciled against ISO 16283-3:2016(E) (First edition
2016-02-01):
- Clause numbers are edition-stable: the field-quantity definitions keep
3.12 (R'45deg), 3.13 (R'tr,s), 3.14 (D2m), 3.15 (D2m,nT), 3.16 (D2m,n),
3.17 (A=0,16V/T), and 9.5.1 (surface-level averaging).
- Formula numbers differ: in the 2016 edition the Clause 3 defining
formulas are UNNUMBERED (inline in the term definitions); the numbered
formulas (1)-(21) live in the procedural clauses. The surface-level
energy-average is Formula (7) in 2016 (was Formula (20) in the DIS).
- Dropped the invalid draft Formula (2)-(7) citations from the field-
quantity docstrings and the draft-edition reconciliation caveat.
- Constants and formula bodies are unchanged (-1,5 dB / -3 dB, A0=10 m2,
T0=0,5 s, A=0,16V/T, band ranges): no numeric change; 22 facade tests
green.
Claude-Session: https://claude.ai/code/session_013kkVt3nxi9svp1an28uHxf
* feat: EN 12354-1/2 building acoustic performance prediction with flanking
Implement the EN 12354:2000 simplified single-number prediction model for
apparent airborne (R'w) and impact (L'n,w) sound insulation, including direct
plus flanking transmission (Ff/Df/Fd paths) and the Annex E vibration-reduction
index Kij for rigid cross, rigid T, flexible-interlayer and lightweight-facade
junctions.
Airborne Formula (26)/(27)/(28a) with l0=1 m, Kij,min (29), lining composition
(30)/(31); impact Formula (21) with bare-floor Ln,w,eq (164-35 lg m'), Table 1
flanking correction K, and standardized L'nT,w (3). Results expose per-path
energy contributions so the dominant flanking path is visible.
Validated against the standards' worked examples: Part 1 Annex H.3 airborne
(R'w = 52 dB, 13 paths; +floating-floor 53 dB) and Part 2 Annex E.3 impact
(L'n,w = 45 dB, L'nT,w = 43 dB); all four Annex H junctions reproduce Kij.
Claude-Session: https://claude.ai/code/session_013kkVt3nxi9svp1an28uHxf
* feat: ISO 12999-1 building acoustics measurement uncertainty
Add building_uncertainty module implementing ISO 12999-1:2020 standard
uncertainties for sound-insulation quantities: per-band and single-number
values for airborne (Tables 2/3), impact (Tables 4/5) and floor-covering
reduction (Tables 6/7), across measurement situations A/B/C (Clause 5.2),
plus the Annex D sigma_R95 upper limits, Table 1 max repeatability and
Table 8 coverage factors.
Expansion U = k*u with k >= 1 (Clause 8), one-sided factors for conformity
checks (Formulae 4/5), and combination rules from Annexes A/B/C (prediction
input A.1, quadrature A.2/C.2, m-measurement reduction A.7, uncorrelated
single-number B.2). Composable UncertainValue attaches value +- U without
touching the rating dataclasses.
Claude-Session: https://claude.ai/code/session_013kkVt3nxi9svp1an28uHxf
* fix: numpy-stub-agnostic annotations for the two env-dependent mypy sites
Claude-Session: https://claude.ai/code/session_013kkVt3nxi9svp1an28uHxf
* refactor: PR-B review minors — anchors, Kij floor, uncertainty polish
- Table 3 r_w+ctr_50_5000 σsitu(B)=1.0 verified digit-by-digit against the
ISO 12999-1:2020(E) page image; anomalous but normative (comment added).
- Anchor the ISO 10140 rating tests to independent literals (Rw=54, Ln,w=58 —
reference-curve shape + the 32 dB / 16-band = 2 dB ISO 717 shift).
- background_correction: cross-ref sound_power.background_noise_correction and
document the negative-margin (Lb > Lsb) cap at Lsb−1.3.
- flanking_path: optional kij_min clamp for EN 12354-1 Clause 4.4.2 (Kij≥Kij,min),
documented on flanking_element; tested clamped vs unclamped (H.3 unaffected).
- impact_flanking_correction: comment on nearest-neighbour + tie-to-lower.
- Export COVERAGE_FACTORS (Table 8) as public API.
- single_number_uncertainty: note impact situation A is an estimate (Table 5 fn a).
Claude-Session: https://claude.ai/code/session_013kkVt3nxi9svp1an28uHxf
* feat: conformance checks for facade, lab insulation, EN 12354 and ISO 12999
Add six numerical conformance checks for the PR-B building-acoustics
standards, following the established registry pattern (single source of
truth in tests/reference_data.py, clause citations, honest tolerances):
- ISO 16283-3:2016 Clause 3.12: facade R'45 isolates the -1.5 dB
oblique-incidence correction on an S=A constructed case (exact).
- ISO 10140-2:2021 Formula (2): lab airborne R laid on the ISO 717-1
reference shape (S=A) -> Rw = 54 (the +2-shift analytic anchor).
- EN 12354-1:2000 Annex H.3: airborne prediction R'w = 52 from the 13
transmission paths (direct + 12 flanking), the branch's strongest oracle.
- EN 12354-2:2000 Annex E.3: impact prediction L'n,w = 45 (76-33+2).
- ISO 12999-1:2020 Table 2: airborne band uncertainty, situation A @
1 kHz = 1.8 dB (digit-exact), and Clause 8/Table 8 expanded
uncertainty U = 1.96 u = 2.352 dB (exact k=1.96 arithmetic).
Facade and lab checks join "Room & building acoustics"; the EN 12354 /
ISO 12999 checks form a new "Building prediction & uncertainty" domain.
Registry grows 26 -> 32 checks across 7 domains. Shared expected values
and the Annex H.3 input table move into reference_data.py so the report
and tests cannot drift; a consistency test pins them to the published
worked-example results. docs/CONFORMANCE.md regenerated via make conformance.
Claude-Session: https://claude.ai/code/session_013kkVt3nxi9svp1an28uHxf
* docs: building acoustics II — facade, laboratory, prediction and uncertainty (EN)
Extend the Room & Building Acoustics guide with facade insulation
(ISO 16283-3), laboratory characterisation (ISO 10140), flanking-transmission
performance prediction (EN 12354-1/2) and measurement uncertainty
(ISO 12999-1), with executed snippets reproducing the EN 12354-1 Annex H.3
(R'w = 52 dB) and Annex E.3 (L'n,w = 45 dB) worked examples. Add the matching
theory subsections, API-reference rows for every new public name, README and
landing-page entries (29 -> 33 standards), and CHANGELOG. EN docs and site
twins keep byte-identical code blocks.
Claude-Session: https://claude.ai/code/session_013kkVt3nxi9svp1an28uHxf
* docs: flanking-paths diagram, prediction and uncertainty figures
Claude-Session: https://claude.ai/code/session_013kkVt3nxi9svp1an28uHxf
* docs: gemelas ES de edificación II (fachadas, laboratorio, predicción, incertidumbre)
Claude-Session: https://claude.ai/code/session_013kkVt3nxi9svp1an28uHxf
* docs: PR-B final-review fixes — count, GitHub-safe math, edition alignment
Landing count corrected to 34 standards (slash-part convention); the
GitHub-unsafe math spacing tokens reintroduced by the new building
sections are scrubbed from the docs/ tree and its site twins; the whole
ISO 10140-2 citation chain aligned to the verified :2010 edition; plus
the six minor documentation-precision fixes from the final review.
Claude-Session: https://claude.ai/code/session_013kkVt3nxi9svp1an28uHxf
* fix: PR 88 review round 1 — isfinite idiom, heading levels, frequencies validation
- building_prediction._check_finite: replace 'v != v or v in (inf,-inf)'
NaN idiom with math.isfinite for SonarCloud (same behavior, cleaner).
- room-acoustics docs (EN docs + site, ES site): relevel the three
parameter-table headings that skipped H2->H4 to H3 (MD001).
- insulation.facade_insulation: validate 'frequencies' length against the
band count, raising a clear ValueError instead of deferring a matplotlib
shape error to plot(). lab_insulation/building_uncertainty have no such
gap (no user-supplied frequencies stored). Regenerated llms-full.txt.
Claude-Session: https://claude.ai/code/session_013kkVt3nxi9svp1an28uHxf
Building acoustics II: facade insulation (ISO 16283-3), laboratory measurement (ISO 10140), prediction with flanking (EN 12354) and uncertainty (ISO 12999-1) (#88)
* feat: ISO 16283-3 facade sound insulation
Add facade_insulation() and FacadeInsulationResult for field facade sound
insulation per ISO 16283-3: the global-method level difference D2m and its
standardized (D2m,nT) and normalized (D2m,n) forms, plus the element-method
apparent sound reduction index R'45 (loudspeaker, -1,5 dB) / R'tr,s (road
traffic, -3 dB). Reuses the ISO 16283-1 energy-averaging helpers, the
Sabine absorption area, and the ISO 717-1 airborne weighted_rating engine
unchanged for the single-number rating. Adds a per-band .plot() profile and
exports.
Claude-Session: https://claude.ai/code/session_013kkVt3nxi9svp1an28uHxf
* fix: ISO 16283-3 draft-edition caveat and symmetric R' validation
Claude-Session: https://claude.ai/code/session_013kkVt3nxi9svp1an28uHxf
* feat: ISO 10140 laboratory airborne and impact sound insulation
Add src/phonometry/lab_insulation.py, the laboratory counterpart of the
field ISO 16283 family:
- lab_airborne_insulation: R = L1 - L2 + 10 lg(S/A) with A = 0,16 V/T
(ISO 10140-2:2010 Formula (2); ISO 10140-4:2010 Formula (5)).
- lab_impact_insulation: Ln = Li + 10 lg(A/A0), A0 = 10 m²
(ISO 10140-3:2010 Formula (1)).
- background_correction: ISO 10140-4:2010 Clause 4.3 Formula (4) with the
6/15 dB criteria and the 1,3 dB limit-of-measurement cap.
Single-number Rw / Ln,w with C, Ctr, CI reuse the verified ISO 717-1/2
weighted_rating / weighted_impact_rating engines; position energy
averaging reuses _as_band_levels. 29 new closed-form / identity tests.
Claude-Session: https://claude.ai/code/session_013kkVt3nxi9svp1an28uHxf
* docs: reconcile facade citations with published ISO 16283-3:2016
The facade module was drafted from ISO/DIS 16283-3:2014; its docstrings
cited draft formula numbers with a caveat to reconcile against the
published edition. Reconciled against ISO 16283-3:2016(E) (First edition
2016-02-01):
- Clause numbers are edition-stable: the field-quantity definitions keep
3.12 (R'45deg), 3.13 (R'tr,s), 3.14 (D2m), 3.15 (D2m,nT), 3.16 (D2m,n),
3.17 (A=0,16V/T), and 9.5.1 (surface-level averaging).
- Formula numbers differ: in the 2016 edition the Clause 3 defining
formulas are UNNUMBERED (inline in the term definitions); the numbered
formulas (1)-(21) live in the procedural clauses. The surface-level
energy-average is Formula (7) in 2016 (was Formula (20) in the DIS).
- Dropped the invalid draft Formula (2)-(7) citations from the field-
quantity docstrings and the draft-edition reconciliation caveat.
- Constants and formula bodies are unchanged (-1,5 dB / -3 dB, A0=10 m2,
T0=0,5 s, A=0,16V/T, band ranges): no numeric change; 22 facade tests
green.
Claude-Session: https://claude.ai/code/session_013kkVt3nxi9svp1an28uHxf
* feat: EN 12354-1/2 building acoustic performance prediction with flanking
Implement the EN 12354:2000 simplified single-number prediction model for
apparent airborne (R'w) and impact (L'n,w) sound insulation, including direct
plus flanking transmission (Ff/Df/Fd paths) and the Annex E vibration-reduction
index Kij for rigid cross, rigid T, flexible-interlayer and lightweight-facade
junctions.
Airborne Formula (26)/(27)/(28a) with l0=1 m, Kij,min (29), lining composition
(30)/(31); impact Formula (21) with bare-floor Ln,w,eq (164-35 lg m'), Table 1
flanking correction K, and standardized L'nT,w (3). Results expose per-path
energy contributions so the dominant flanking path is visible.
Validated against the standards' worked examples: Part 1 Annex H.3 airborne
(R'w = 52 dB, 13 paths; +floating-floor 53 dB) and Part 2 Annex E.3 impact
(L'n,w = 45 dB, L'nT,w = 43 dB); all four Annex H junctions reproduce Kij.
Claude-Session: https://claude.ai/code/session_013kkVt3nxi9svp1an28uHxf
* feat: ISO 12999-1 building acoustics measurement uncertainty
Add building_uncertainty module implementing ISO 12999-1:2020 standard
uncertainties for sound-insulation quantities: per-band and single-number
values for airborne (Tables 2/3), impact (Tables 4/5) and floor-covering
reduction (Tables 6/7), across measurement situations A/B/C (Clause 5.2),
plus the Annex D sigma_R95 upper limits, Table 1 max repeatability and
Table 8 coverage factors.
Expansion U = k*u with k >= 1 (Clause 8), one-sided factors for conformity
checks (Formulae 4/5), and combination rules from Annexes A/B/C (prediction
input A.1, quadrature A.2/C.2, m-measurement reduction A.7, uncorrelated
single-number B.2). Composable UncertainValue attaches value +- U without
touching the rating dataclasses.
Claude-Session: https://claude.ai/code/session_013kkVt3nxi9svp1an28uHxf
* fix: numpy-stub-agnostic annotations for the two env-dependent mypy sites
Claude-Session: https://claude.ai/code/session_013kkVt3nxi9svp1an28uHxf
* refactor: PR-B review minors — anchors, Kij floor, uncertainty polish
- Table 3 r_w+ctr_50_5000 σsitu(B)=1.0 verified digit-by-digit against the
ISO 12999-1:2020(E) page image; anomalous but normative (comment added).
- Anchor the ISO 10140 rating tests to independent literals (Rw=54, Ln,w=58 —
reference-curve shape + the 32 dB / 16-band = 2 dB ISO 717 shift).
- background_correction: cross-ref sound_power.background_noise_correction and
document the negative-margin (Lb > Lsb) cap at Lsb−1.3.
- flanking_path: optional kij_min clamp for EN 12354-1 Clause 4.4.2 (Kij≥Kij,min),
documented on flanking_element; tested clamped vs unclamped (H.3 unaffected).
- impact_flanking_correction: comment on nearest-neighbour + tie-to-lower.
- Export COVERAGE_FACTORS (Table 8) as public API.
- single_number_uncertainty: note impact situation A is an estimate (Table 5 fn a).
Claude-Session: https://claude.ai/code/session_013kkVt3nxi9svp1an28uHxf
* feat: conformance checks for facade, lab insulation, EN 12354 and ISO 12999
Add six numerical conformance checks for the PR-B building-acoustics
standards, following the established registry pattern (single source of
truth in tests/reference_data.py, clause citations, honest tolerances):
- ISO 16283-3:2016 Clause 3.12: facade R'45 isolates the -1.5 dB
oblique-incidence correction on an S=A constructed case (exact).
- ISO 10140-2:2021 Formula (2): lab airborne R laid on the ISO 717-1
reference shape (S=A) -> Rw = 54 (the +2-shift analytic anchor).
- EN 12354-1:2000 Annex H.3: airborne prediction R'w = 52 from the 13
transmission paths (direct + 12 flanking), the branch's strongest oracle.
- EN 12354-2:2000 Annex E.3: impact prediction L'n,w = 45 (76-33+2).
- ISO 12999-1:2020 Table 2: airborne band uncertainty, situation A @
1 kHz = 1.8 dB (digit-exact), and Clause 8/Table 8 expanded
uncertainty U = 1.96 u = 2.352 dB (exact k=1.96 arithmetic).
Facade and lab checks join "Room & building acoustics"; the EN 12354 /
ISO 12999 checks form a new "Building prediction & uncertainty" domain.
Registry grows 26 -> 32 checks across 7 domains. Shared expected values
and the Annex H.3 input table move into reference_data.py so the report
and tests cannot drift; a consistency test pins them to the published
worked-example results. docs/CONFORMANCE.md regenerated via make conformance.
Claude-Session: https://claude.ai/code/session_013kkVt3nxi9svp1an28uHxf
* docs: building acoustics II — facade, laboratory, prediction and uncertainty (EN)
Extend the Room & Building Acoustics guide with facade insulation
(ISO 16283-3), laboratory characterisation (ISO 10140), flanking-transmission
performance prediction (EN 12354-1/2) and measurement uncertainty
(ISO 12999-1), with executed snippets reproducing the EN 12354-1 Annex H.3
(R'w = 52 dB) and Annex E.3 (L'n,w = 45 dB) worked examples. Add the matching
theory subsections, API-reference rows for every new public name, README and
landing-page entries (29 -> 33 standards), and CHANGELOG. EN docs and site
twins keep byte-identical code blocks.
Claude-Session: https://claude.ai/code/session_013kkVt3nxi9svp1an28uHxf
* docs: flanking-paths diagram, prediction and uncertainty figures
Claude-Session: https://claude.ai/code/session_013kkVt3nxi9svp1an28uHxf
* docs: gemelas ES de edificación II (fachadas, laboratorio, predicción, incertidumbre)
Claude-Session: https://claude.ai/code/session_013kkVt3nxi9svp1an28uHxf
* docs: PR-B final-review fixes — count, GitHub-safe math, edition alignment
Landing count corrected to 34 standards (slash-part convention); the
GitHub-unsafe math spacing tokens reintroduced by the new building
sections are scrubbed from the docs/ tree and its site twins; the whole
ISO 10140-2 citation chain aligned to the verified :2010 edition; plus
the six minor documentation-precision fixes from the final review.
Claude-Session: https://claude.ai/code/session_013kkVt3nxi9svp1an28uHxf
* fix: PR 88 review round 1 — isfinite idiom, heading levels, frequencies validation
- building_prediction._check_finite: replace 'v != v or v in (inf,-inf)'
NaN idiom with math.isfinite for SonarCloud (same behavior, cleaner).
- room-acoustics docs (EN docs + site, ES site): relevel the three
parameter-table headings that skipped H2->H4 to H3 (MD001).
- insulation.facade_insulation: validate 'frequencies' length against the
band count, raising a clear ValueError instead of deferring a matplotlib
shape error to plot(). lab_insulation/building_uncertainty have no such
gap (no user-supplied frequencies stored). Regenerated llms-full.txt.
Claude-Session: https://claude.ai/code/session_013kkVt3nxi9svp1an28uHxf
Building acoustics II: facade insulation (ISO 16283-3), laboratory measurement (ISO 10140), prediction with flanking (EN 12354) and uncertainty (ISO 12999-1) (#88)
* feat: ISO 16283-3 facade sound insulation
Add facade_insulation() and FacadeInsulationResult for field facade sound
insulation per ISO 16283-3: the global-method level difference D2m and its
standardized (D2m,nT) and normalized (D2m,n) forms, plus the element-method
apparent sound reduction index R'45 (loudspeaker, -1,5 dB) / R'tr,s (road
traffic, -3 dB). Reuses the ISO 16283-1 energy-averaging helpers, the
Sabine absorption area, and the ISO 717-1 airborne weighted_rating engine
unchanged for the single-number rating. Adds a per-band .plot() profile and
exports.
Claude-Session: https://claude.ai/code/session_013kkVt3nxi9svp1an28uHxf
* fix: ISO 16283-3 draft-edition caveat and symmetric R' validation
Claude-Session: https://claude.ai/code/session_013kkVt3nxi9svp1an28uHxf
* feat: ISO 10140 laboratory airborne and impact sound insulation
Add src/phonometry/lab_insulation.py, the laboratory counterpart of the
field ISO 16283 family:
- lab_airborne_insulation: R = L1 - L2 + 10 lg(S/A) with A = 0,16 V/T
(ISO 10140-2:2010 Formula (2); ISO 10140-4:2010 Formula (5)).
- lab_impact_insulation: Ln = Li + 10 lg(A/A0), A0 = 10 m²
(ISO 10140-3:2010 Formula (1)).
- background_correction: ISO 10140-4:2010 Clause 4.3 Formula (4) with the
6/15 dB criteria and the 1,3 dB limit-of-measurement cap.
Single-number Rw / Ln,w with C, Ctr, CI reuse the verified ISO 717-1/2
weighted_rating / weighted_impact_rating engines; position energy
averaging reuses _as_band_levels. 29 new closed-form / identity tests.
Claude-Session: https://claude.ai/code/session_013kkVt3nxi9svp1an28uHxf
* docs: reconcile facade citations with published ISO 16283-3:2016
The facade module was drafted from ISO/DIS 16283-3:2014; its docstrings
cited draft formula numbers with a caveat to reconcile against the
published edition. Reconciled against ISO 16283-3:2016(E) (First edition
2016-02-01):
- Clause numbers are edition-stable: the field-quantity definitions keep
3.12 (R'45deg), 3.13 (R'tr,s), 3.14 (D2m), 3.15 (D2m,nT), 3.16 (D2m,n),
3.17 (A=0,16V/T), and 9.5.1 (surface-level averaging).
- Formula numbers differ: in the 2016 edition the Clause 3 defining
formulas are UNNUMBERED (inline in the term definitions); the numbered
formulas (1)-(21) live in the procedural clauses. The surface-level
energy-average is Formula (7) in 2016 (was Formula (20) in the DIS).
- Dropped the invalid draft Formula (2)-(7) citations from the field-
quantity docstrings and the draft-edition reconciliation caveat.
- Constants and formula bodies are unchanged (-1,5 dB / -3 dB, A0=10 m2,
T0=0,5 s, A=0,16V/T, band ranges): no numeric change; 22 facade tests
green.
Claude-Session: https://claude.ai/code/session_013kkVt3nxi9svp1an28uHxf
* feat: EN 12354-1/2 building acoustic performance prediction with flanking
Implement the EN 12354:2000 simplified single-number prediction model for
apparent airborne (R'w) and impact (L'n,w) sound insulation, including direct
plus flanking transmission (Ff/Df/Fd paths) and the Annex E vibration-reduction
index Kij for rigid cross, rigid T, flexible-interlayer and lightweight-facade
junctions.
Airborne Formula (26)/(27)/(28a) with l0=1 m, Kij,min (29), lining composition
(30)/(31); impact Formula (21) with bare-floor Ln,w,eq (164-35 lg m'), Table 1
flanking correction K, and standardized L'nT,w (3). Results expose per-path
energy contributions so the dominant flanking path is visible.
Validated against the standards' worked examples: Part 1 Annex H.3 airborne
(R'w = 52 dB, 13 paths; +floating-floor 53 dB) and Part 2 Annex E.3 impact
(L'n,w = 45 dB, L'nT,w = 43 dB); all four Annex H junctions reproduce Kij.
Claude-Session: https://claude.ai/code/session_013kkVt3nxi9svp1an28uHxf
* feat: ISO 12999-1 building acoustics measurement uncertainty
Add building_uncertainty module implementing ISO 12999-1:2020 standard
uncertainties for sound-insulation quantities: per-band and single-number
values for airborne (Tables 2/3), impact (Tables 4/5) and floor-covering
reduction (Tables 6/7), across measurement situations A/B/C (Clause 5.2),
plus the Annex D sigma_R95 upper limits, Table 1 max repeatability and
Table 8 coverage factors.
Expansion U = k*u with k >= 1 (Clause 8), one-sided factors for conformity
checks (Formulae 4/5), and combination rules from Annexes A/B/C (prediction
input A.1, quadrature A.2/C.2, m-measurement reduction A.7, uncorrelated
single-number B.2). Composable UncertainValue attaches value +- U without
touching the rating dataclasses.
Claude-Session: https://claude.ai/code/session_013kkVt3nxi9svp1an28uHxf
* fix: numpy-stub-agnostic annotations for the two env-dependent mypy sites
Claude-Session: https://claude.ai/code/session_013kkVt3nxi9svp1an28uHxf
* refactor: PR-B review minors — anchors, Kij floor, uncertainty polish
- Table 3 r_w+ctr_50_5000 σsitu(B)=1.0 verified digit-by-digit against the
ISO 12999-1:2020(E) page image; anomalous but normative (comment added).
- Anchor the ISO 10140 rating tests to independent literals (Rw=54, Ln,w=58 —
reference-curve shape + the 32 dB / 16-band = 2 dB ISO 717 shift).
- background_correction: cross-ref sound_power.background_noise_correction and
document the negative-margin (Lb > Lsb) cap at Lsb−1.3.
- flanking_path: optional kij_min clamp for EN 12354-1 Clause 4.4.2 (Kij≥Kij,min),
documented on flanking_element; tested clamped vs unclamped (H.3 unaffected).
- impact_flanking_correction: comment on nearest-neighbour + tie-to-lower.
- Export COVERAGE_FACTORS (Table 8) as public API.
- single_number_uncertainty: note impact situation A is an estimate (Table 5 fn a).
Claude-Session: https://claude.ai/code/session_013kkVt3nxi9svp1an28uHxf
* feat: conformance checks for facade, lab insulation, EN 12354 and ISO 12999
Add six numerical conformance checks for the PR-B building-acoustics
standards, following the established registry pattern (single source of
truth in tests/reference_data.py, clause citations, honest tolerances):
- ISO 16283-3:2016 Clause 3.12: facade R'45 isolates the -1.5 dB
oblique-incidence correction on an S=A constructed case (exact).
- ISO 10140-2:2021 Formula (2): lab airborne R laid on the ISO 717-1
reference shape (S=A) -> Rw = 54 (the +2-shift analytic anchor).
- EN 12354-1:2000 Annex H.3: airborne prediction R'w = 52 from the 13
transmission paths (direct + 12 flanking), the branch's strongest oracle.
- EN 12354-2:2000 Annex E.3: impact prediction L'n,w = 45 (76-33+2).
- ISO 12999-1:2020 Table 2: airborne band uncertainty, situation A @
1 kHz = 1.8 dB (digit-exact), and Clause 8/Table 8 expanded
uncertainty U = 1.96 u = 2.352 dB (exact k=1.96 arithmetic).
Facade and lab checks join "Room & building acoustics"; the EN 12354 /
ISO 12999 checks form a new "Building prediction & uncertainty" domain.
Registry grows 26 -> 32 checks across 7 domains. Shared expected values
and the Annex H.3 input table move into reference_data.py so the report
and tests cannot drift; a consistency test pins them to the published
worked-example results. docs/CONFORMANCE.md regenerated via make conformance.
Claude-Session: https://claude.ai/code/session_013kkVt3nxi9svp1an28uHxf
* docs: building acoustics II — facade, laboratory, prediction and uncertainty (EN)
Extend the Room & Building Acoustics guide with facade insulation
(ISO 16283-3), laboratory characterisation (ISO 10140), flanking-transmission
performance prediction (EN 12354-1/2) and measurement uncertainty
(ISO 12999-1), with executed snippets reproducing the EN 12354-1 Annex H.3
(R'w = 52 dB) and Annex E.3 (L'n,w = 45 dB) worked examples. Add the matching
theory subsections, API-reference rows for every new public name, README and
landing-page entries (29 -> 33 standards), and CHANGELOG. EN docs and site
twins keep byte-identical code blocks.
Claude-Session: https://claude.ai/code/session_013kkVt3nxi9svp1an28uHxf
* docs: flanking-paths diagram, prediction and uncertainty figures
Claude-Session: https://claude.ai/code/session_013kkVt3nxi9svp1an28uHxf
* docs: gemelas ES de edificación II (fachadas, laboratorio, predicción, incertidumbre)
Claude-Session: https://claude.ai/code/session_013kkVt3nxi9svp1an28uHxf
* docs: PR-B final-review fixes — count, GitHub-safe math, edition alignment
Landing count corrected to 34 standards (slash-part convention); the
GitHub-unsafe math spacing tokens reintroduced by the new building
sections are scrubbed from the docs/ tree and its site twins; the whole
ISO 10140-2 citation chain aligned to the verified :2010 edition; plus
the six minor documentation-precision fixes from the final review.
Claude-Session: https://claude.ai/code/session_013kkVt3nxi9svp1an28uHxf
* fix: PR 88 review round 1 — isfinite idiom, heading levels, frequencies validation
- building_prediction._check_finite: replace 'v != v or v in (inf,-inf)'
NaN idiom with math.isfinite for SonarCloud (same behavior, cleaner).
- room-acoustics docs (EN docs + site, ES site): relevel the three
parameter-table headings that skipped H2->H4 to H3 (MD001).
- insulation.facade_insulation: validate 'frequencies' length against the
band count, raising a clear ValueError instead of deferring a matplotlib
shape error to plot(). lab_insulation/building_uncertainty have no such
gap (no user-supplied frequencies stored). Regenerated llms-full.txt.
Claude-Session: https://claude.ai/code/session_013kkVt3nxi9svp1an28uHxf
Building acoustics II: facade insulation (ISO 16283-3), laboratory measurement (ISO 10140), prediction with flanking (EN 12354) and uncertainty (ISO 12999-1) (#88)
* feat: ISO 16283-3 facade sound insulation
Add facade_insulation() and FacadeInsulationResult for field facade sound
insulation per ISO 16283-3: the global-method level difference D2m and its
standardized (D2m,nT) and normalized (D2m,n) forms, plus the element-method
apparent sound reduction index R'45 (loudspeaker, -1,5 dB) / R'tr,s (road
traffic, -3 dB). Reuses the ISO 16283-1 energy-averaging helpers, the
Sabine absorption area, and the ISO 717-1 airborne weighted_rating engine
unchanged for the single-number rating. Adds a per-band .plot() profile and
exports.
Claude-Session: https://claude.ai/code/session_013kkVt3nxi9svp1an28uHxf
* fix: ISO 16283-3 draft-edition caveat and symmetric R' validation
Claude-Session: https://claude.ai/code/session_013kkVt3nxi9svp1an28uHxf
* feat: ISO 10140 laboratory airborne and impact sound insulation
Add src/phonometry/lab_insulation.py, the laboratory counterpart of the
field ISO 16283 family:
- lab_airborne_insulation: R = L1 - L2 + 10 lg(S/A) with A = 0,16 V/T
(ISO 10140-2:2010 Formula (2); ISO 10140-4:2010 Formula (5)).
- lab_impact_insulation: Ln = Li + 10 lg(A/A0), A0 = 10 m²
(ISO 10140-3:2010 Formula (1)).
- background_correction: ISO 10140-4:2010 Clause 4.3 Formula (4) with the
6/15 dB criteria and the 1,3 dB limit-of-measurement cap.
Single-number Rw / Ln,w with C, Ctr, CI reuse the verified ISO 717-1/2
weighted_rating / weighted_impact_rating engines; position energy
averaging reuses _as_band_levels. 29 new closed-form / identity tests.
Claude-Session: https://claude.ai/code/session_013kkVt3nxi9svp1an28uHxf
* docs: reconcile facade citations with published ISO 16283-3:2016
The facade module was drafted from ISO/DIS 16283-3:2014; its docstrings
cited draft formula numbers with a caveat to reconcile against the
published edition. Reconciled against ISO 16283-3:2016(E) (First edition
2016-02-01):
- Clause numbers are edition-stable: the field-quantity definitions keep
3.12 (R'45deg), 3.13 (R'tr,s), 3.14 (D2m), 3.15 (D2m,nT), 3.16 (D2m,n),
3.17 (A=0,16V/T), and 9.5.1 (surface-level averaging).
- Formula numbers differ: in the 2016 edition the Clause 3 defining
formulas are UNNUMBERED (inline in the term definitions); the numbered
formulas (1)-(21) live in the procedural clauses. The surface-level
energy-average is Formula (7) in 2016 (was Formula (20) in the DIS).
- Dropped the invalid draft Formula (2)-(7) citations from the field-
quantity docstrings and the draft-edition reconciliation caveat.
- Constants and formula bodies are unchanged (-1,5 dB / -3 dB, A0=10 m2,
T0=0,5 s, A=0,16V/T, band ranges): no numeric change; 22 facade tests
green.
Claude-Session: https://claude.ai/code/session_013kkVt3nxi9svp1an28uHxf
* feat: EN 12354-1/2 building acoustic performance prediction with flanking
Implement the EN 12354:2000 simplified single-number prediction model for
apparent airborne (R'w) and impact (L'n,w) sound insulation, including direct
plus flanking transmission (Ff/Df/Fd paths) and the Annex E vibration-reduction
index Kij for rigid cross, rigid T, flexible-interlayer and lightweight-facade
junctions.
Airborne Formula (26)/(27)/(28a) with l0=1 m, Kij,min (29), lining composition
(30)/(31); impact Formula (21) with bare-floor Ln,w,eq (164-35 lg m'), Table 1
flanking correction K, and standardized L'nT,w (3). Results expose per-path
energy contributions so the dominant flanking path is visible.
Validated against the standards' worked examples: Part 1 Annex H.3 airborne
(R'w = 52 dB, 13 paths; +floating-floor 53 dB) and Part 2 Annex E.3 impact
(L'n,w = 45 dB, L'nT,w = 43 dB); all four Annex H junctions reproduce Kij.
Claude-Session: https://claude.ai/code/session_013kkVt3nxi9svp1an28uHxf
* feat: ISO 12999-1 building acoustics measurement uncertainty
Add building_uncertainty module implementing ISO 12999-1:2020 standard
uncertainties for sound-insulation quantities: per-band and single-number
values for airborne (Tables 2/3), impact (Tables 4/5) and floor-covering
reduction (Tables 6/7), across measurement situations A/B/C (Clause 5.2),
plus the Annex D sigma_R95 upper limits, Table 1 max repeatability and
Table 8 coverage factors.
Expansion U = k*u with k >= 1 (Clause 8), one-sided factors for conformity
checks (Formulae 4/5), and combination rules from Annexes A/B/C (prediction
input A.1, quadrature A.2/C.2, m-measurement reduction A.7, uncorrelated
single-number B.2). Composable UncertainValue attaches value +- U without
touching the rating dataclasses.
Claude-Session: https://claude.ai/code/session_013kkVt3nxi9svp1an28uHxf
* fix: numpy-stub-agnostic annotations for the two env-dependent mypy sites
Claude-Session: https://claude.ai/code/session_013kkVt3nxi9svp1an28uHxf
* refactor: PR-B review minors — anchors, Kij floor, uncertainty polish
- Table 3 r_w+ctr_50_5000 σsitu(B)=1.0 verified digit-by-digit against the
ISO 12999-1:2020(E) page image; anomalous but normative (comment added).
- Anchor the ISO 10140 rating tests to independent literals (Rw=54, Ln,w=58 —
reference-curve shape + the 32 dB / 16-band = 2 dB ISO 717 shift).
- background_correction: cross-ref sound_power.background_noise_correction and
document the negative-margin (Lb > Lsb) cap at Lsb−1.3.
- flanking_path: optional kij_min clamp for EN 12354-1 Clause 4.4.2 (Kij≥Kij,min),
documented on flanking_element; tested clamped vs unclamped (H.3 unaffected).
- impact_flanking_correction: comment on nearest-neighbour + tie-to-lower.
- Export COVERAGE_FACTORS (Table 8) as public API.
- single_number_uncertainty: note impact situation A is an estimate (Table 5 fn a).
Claude-Session: https://claude.ai/code/session_013kkVt3nxi9svp1an28uHxf
* feat: conformance checks for facade, lab insulation, EN 12354 and ISO 12999
Add six numerical conformance checks for the PR-B building-acoustics
standards, following the established registry pattern (single source of
truth in tests/reference_data.py, clause citations, honest tolerances):
- ISO 16283-3:2016 Clause 3.12: facade R'45 isolates the -1.5 dB
oblique-incidence correction on an S=A constructed case (exact).
- ISO 10140-2:2021 Formula (2): lab airborne R laid on the ISO 717-1
reference shape (S=A) -> Rw = 54 (the +2-shift analytic anchor).
- EN 12354-1:2000 Annex H.3: airborne prediction R'w = 52 from the 13
transmission paths (direct + 12 flanking), the branch's strongest oracle.
- EN 12354-2:2000 Annex E.3: impact prediction L'n,w = 45 (76-33+2).
- ISO 12999-1:2020 Table 2: airborne band uncertainty, situation A @
1 kHz = 1.8 dB (digit-exact), and Clause 8/Table 8 expanded
uncertainty U = 1.96 u = 2.352 dB (exact k=1.96 arithmetic).
Facade and lab checks join "Room & building acoustics"; the EN 12354 /
ISO 12999 checks form a new "Building prediction & uncertainty" domain.
Registry grows 26 -> 32 checks across 7 domains. Shared expected values
and the Annex H.3 input table move into reference_data.py so the report
and tests cannot drift; a consistency test pins them to the published
worked-example results. docs/CONFORMANCE.md regenerated via make conformance.
Claude-Session: https://claude.ai/code/session_013kkVt3nxi9svp1an28uHxf
* docs: building acoustics II — facade, laboratory, prediction and uncertainty (EN)
Extend the Room & Building Acoustics guide with facade insulation
(ISO 16283-3), laboratory characterisation (ISO 10140), flanking-transmission
performance prediction (EN 12354-1/2) and measurement uncertainty
(ISO 12999-1), with executed snippets reproducing the EN 12354-1 Annex H.3
(R'w = 52 dB) and Annex E.3 (L'n,w = 45 dB) worked examples. Add the matching
theory subsections, API-reference rows for every new public name, README and
landing-page entries (29 -> 33 standards), and CHANGELOG. EN docs and site
twins keep byte-identical code blocks.
Claude-Session: https://claude.ai/code/session_013kkVt3nxi9svp1an28uHxf
* docs: flanking-paths diagram, prediction and uncertainty figures
Claude-Session: https://claude.ai/code/session_013kkVt3nxi9svp1an28uHxf
* docs: gemelas ES de edificación II (fachadas, laboratorio, predicción, incertidumbre)
Claude-Session: https://claude.ai/code/session_013kkVt3nxi9svp1an28uHxf
* docs: PR-B final-review fixes — count, GitHub-safe math, edition alignment
Landing count corrected to 34 standards (slash-part convention); the
GitHub-unsafe math spacing tokens reintroduced by the new building
sections are scrubbed from the docs/ tree and its site twins; the whole
ISO 10140-2 citation chain aligned to the verified :2010 edition; plus
the six minor documentation-precision fixes from the final review.
Claude-Session: https://claude.ai/code/session_013kkVt3nxi9svp1an28uHxf
* fix: PR 88 review round 1 — isfinite idiom, heading levels, frequencies validation
- building_prediction._check_finite: replace 'v != v or v in (inf,-inf)'
NaN idiom with math.isfinite for SonarCloud (same behavior, cleaner).
- room-acoustics docs (EN docs + site, ES site): relevel the three
parameter-table headings that skipped H2->H4 to H3 (MD001).
- insulation.facade_insulation: validate 'frequencies' length against the
band count, raising a clear ValueError instead of deferring a matplotlib
shape error to plot(). lab_insulation/building_uncertainty have no such
gap (no user-supplied frequencies stored). Regenerated llms-full.txt.
Claude-Session: https://claude.ai/code/session_013kkVt3nxi9svp1an28uHxf
docs: outdoor and environmental didactics, measurement-geometry diagrams and verified references (#199)
* docs: IEC 61400-11 measurement-geometry and ground-reflection setup diagrams
Two new deterministic SVG diagrams (4 variants each, EN/ES x light/dark):
- diagram_wind_turbine_iec61400: side view of the turbine with the downwind
ground-board microphone at R0 = H + D/2, the slant distance R1 to the
rotor centre, the met mast, the board inclination angle and the Figure 3
plan-view position pattern (reference position downwind, optional
positions at +/-60 degrees and upwind).
- diagram_ground_reflection: source and receiver over a reflecting plane
with the direct ray, the specular reflection unfolded through the image
source, the path difference delta = r2 - r1 and the interference phase.
* docs: outdoor-propagation didactics: image source, favourable conditions, barrier pitfalls, CNOSSOS-EU
Expand the outdoor-propagation guide in the three trees (docs EN, site EN,
site ES):
- New subsection on the image source behind the ground effect, with the
ground-reflection diagram: path difference, interference phase, the hard
-3 dB result and the porous-ground notch that Table 3 parameterizes.
- New closing section on scope and pitfalls: what the favourable propagation
conditions of Clause 5 mean and why the method predicts the audible case;
barrier fine print (the 20/25 dB caps, the Kmet erosion over distance, the
modest double-diffraction bonus, the Abar = Dz - Agr fold-in and the
Clause 7.4 qualification rules); and an ISO 9613-2 vs CNOSSOS-EU
comparison covering scope, methodology and why the two frameworks disagree
on the same geometry.
- References section with verified entries: Salomons, Attenborough & Van
Renterghem, Maekawa 1968, the CNOSSOS-EU JRC report and the ISO 9613-1/-2
catalogue pages.
* docs: impulse-prominence context: category adjustments, ISO/PAS 1996-3 and logging caveats
Add a short standards-context section to the impulse-prominence guide in the
three trees: the fixed ISO 1996-1:2016 Table A.1 category adjustments (5 dB
regular, 12 dB highly impulsive) that the measured prominence replaces with
a graduated KI, the ISO/PAS 1996-3:2022 successor built on the same
onset-rate prominence, and two practical caveats (time-weighting-F smoothing
of very short impulses and prominence-not-energy). References section with
the Nordtest method page and the ISO 1996-1 / ISO/PAS 1996-3 catalogue
pages, all verified.
* docs: wind-turbine-noise didactics: measurement geometry, apparent power and wind-speed binning
Expand the wind-turbine-noise guide in the three trees:
- Embed the IEC 61400-11 measurement-geometry diagram (ground-board
microphone at R0 = H + D/2, slant distance R1, met mast, plan-view
position pattern).
- New subsection on why the apparent sound power is not a true LW: an
equivalent point source at the rotor centre matched to one downwind
position, with directivity folded in, comparable across turbines because
the geometry scales with the machine.
- New subsection on wind-speed bins and standardized conditions: 0.5 m/s
bins centred on integer and half-integer hub-height speeds, wind speed
derived from electric power through the power curve, the 0.8 to 1.3 times
85 %-power range, background-margin rules, and the Formula (29) conversion
to 10 m height over the 0.05 m reference roughness length.
- References section: IEC 61400-11:2012+AMD1:2018 CSV, IEC TS 61400-14:2005
and ISO 1996-2:2017, all verified.
* docs: outdoor and environmental sound group in the global bibliography
Add the Outdoor and environmental sound section to the bibliography in the
three trees, with back-links to the citing guides: Salomons, Attenborough &
Van Renterghem, Maekawa 1968, the CNOSSOS-EU JRC report, ISO 9613-1/-2,
ISO 1996-1/-2, NT ACOU 112, ISO/PAS 1996-3 and IEC 61400-11/-14. The
ISO 1996-2 entry also back-fills the tone-audibility citation that was
missing from the global list.
* docs: review fixes for the outdoor and environmental wave
- Bind the tonal-audibility criterion IEC 61400-11 reuses to the Annex C of
the 2007 edition of ISO 1996-2 (the 2017 edition carries the tonal methods
in Annexes J and K), in the wind-turbine References and the bibliography.
- ISO 3744 samples the pressure field over the enveloping surface; intensity
integration is ISO 9614 territory.
- IEC 61400-11 background rule: a margin of 3 dB or less voids the bin (the
boundary case included).
- Ground-reflection diagram: parenthesise the reflection-coefficient note so
SVG whitespace collapsing cannot glue it to the formula; move the
wind-turbine ground-board label clear of the R1 ray.
- Spanish polish: unify onset rate as tasa de crecimiento, replace the
recomprar calque with compensar.
* docs: review refinements in the outdoor and environmental guides
---------
Co-authored-by: José M. Requena Plens <jmrplens@icloud.com>
docs: outdoor and environmental didactics, measurement-geometry diagrams and verified references (#199)
* docs: IEC 61400-11 measurement-geometry and ground-reflection setup diagrams
Two new deterministic SVG diagrams (4 variants each, EN/ES x light/dark):
- diagram_wind_turbine_iec61400: side view of the turbine with the downwind
ground-board microphone at R0 = H + D/2, the slant distance R1 to the
rotor centre, the met mast, the board inclination angle and the Figure 3
plan-view position pattern (reference position downwind, optional
positions at +/-60 degrees and upwind).
- diagram_ground_reflection: source and receiver over a reflecting plane
with the direct ray, the specular reflection unfolded through the image
source, the path difference delta = r2 - r1 and the interference phase.
* docs: outdoor-propagation didactics: image source, favourable conditions, barrier pitfalls, CNOSSOS-EU
Expand the outdoor-propagation guide in the three trees (docs EN, site EN,
site ES):
- New subsection on the image source behind the ground effect, with the
ground-reflection diagram: path difference, interference phase, the hard
-3 dB result and the porous-ground notch that Table 3 parameterizes.
- New closing section on scope and pitfalls: what the favourable propagation
conditions of Clause 5 mean and why the method predicts the audible case;
barrier fine print (the 20/25 dB caps, the Kmet erosion over distance, the
modest double-diffraction bonus, the Abar = Dz - Agr fold-in and the
Clause 7.4 qualification rules); and an ISO 9613-2 vs CNOSSOS-EU
comparison covering scope, methodology and why the two frameworks disagree
on the same geometry.
- References section with verified entries: Salomons, Attenborough & Van
Renterghem, Maekawa 1968, the CNOSSOS-EU JRC report and the ISO 9613-1/-2
catalogue pages.
* docs: impulse-prominence context: category adjustments, ISO/PAS 1996-3 and logging caveats
Add a short standards-context section to the impulse-prominence guide in the
three trees: the fixed ISO 1996-1:2016 Table A.1 category adjustments (5 dB
regular, 12 dB highly impulsive) that the measured prominence replaces with
a graduated KI, the ISO/PAS 1996-3:2022 successor built on the same
onset-rate prominence, and two practical caveats (time-weighting-F smoothing
of very short impulses and prominence-not-energy). References section with
the Nordtest method page and the ISO 1996-1 / ISO/PAS 1996-3 catalogue
pages, all verified.
* docs: wind-turbine-noise didactics: measurement geometry, apparent power and wind-speed binning
Expand the wind-turbine-noise guide in the three trees:
- Embed the IEC 61400-11 measurement-geometry diagram (ground-board
microphone at R0 = H + D/2, slant distance R1, met mast, plan-view
position pattern).
- New subsection on why the apparent sound power is not a true LW: an
equivalent point source at the rotor centre matched to one downwind
position, with directivity folded in, comparable across turbines because
the geometry scales with the machine.
- New subsection on wind-speed bins and standardized conditions: 0.5 m/s
bins centred on integer and half-integer hub-height speeds, wind speed
derived from electric power through the power curve, the 0.8 to 1.3 times
85 %-power range, background-margin rules, and the Formula (29) conversion
to 10 m height over the 0.05 m reference roughness length.
- References section: IEC 61400-11:2012+AMD1:2018 CSV, IEC TS 61400-14:2005
and ISO 1996-2:2017, all verified.
* docs: outdoor and environmental sound group in the global bibliography
Add the Outdoor and environmental sound section to the bibliography in the
three trees, with back-links to the citing guides: Salomons, Attenborough &
Van Renterghem, Maekawa 1968, the CNOSSOS-EU JRC report, ISO 9613-1/-2,
ISO 1996-1/-2, NT ACOU 112, ISO/PAS 1996-3 and IEC 61400-11/-14. The
ISO 1996-2 entry also back-fills the tone-audibility citation that was
missing from the global list.
* docs: review fixes for the outdoor and environmental wave
- Bind the tonal-audibility criterion IEC 61400-11 reuses to the Annex C of
the 2007 edition of ISO 1996-2 (the 2017 edition carries the tonal methods
in Annexes J and K), in the wind-turbine References and the bibliography.
- ISO 3744 samples the pressure field over the enveloping surface; intensity
integration is ISO 9614 territory.
- IEC 61400-11 background rule: a margin of 3 dB or less voids the bin (the
boundary case included).
- Ground-reflection diagram: parenthesise the reflection-coefficient note so
SVG whitespace collapsing cannot glue it to the formula; move the
wind-turbine ground-board label clear of the R1 ray.
- Spanish polish: unify onset rate as tasa de crecimiento, replace the
recomprar calque with compensar.
* docs: review refinements in the outdoor and environmental guides
---------
Co-authored-by: José M. Requena Plens <jmrplens@icloud.com>
docs: outdoor and environmental didactics, measurement-geometry diagrams and verified references (#199)
* docs: IEC 61400-11 measurement-geometry and ground-reflection setup diagrams
Two new deterministic SVG diagrams (4 variants each, EN/ES x light/dark):
- diagram_wind_turbine_iec61400: side view of the turbine with the downwind
ground-board microphone at R0 = H + D/2, the slant distance R1 to the
rotor centre, the met mast, the board inclination angle and the Figure 3
plan-view position pattern (reference position downwind, optional
positions at +/-60 degrees and upwind).
- diagram_ground_reflection: source and receiver over a reflecting plane
with the direct ray, the specular reflection unfolded through the image
source, the path difference delta = r2 - r1 and the interference phase.
* docs: outdoor-propagation didactics: image source, favourable conditions, barrier pitfalls, CNOSSOS-EU
Expand the outdoor-propagation guide in the three trees (docs EN, site EN,
site ES):
- New subsection on the image source behind the ground effect, with the
ground-reflection diagram: path difference, interference phase, the hard
-3 dB result and the porous-ground notch that Table 3 parameterizes.
- New closing section on scope and pitfalls: what the favourable propagation
conditions of Clause 5 mean and why the method predicts the audible case;
barrier fine print (the 20/25 dB caps, the Kmet erosion over distance, the
modest double-diffraction bonus, the Abar = Dz - Agr fold-in and the
Clause 7.4 qualification rules); and an ISO 9613-2 vs CNOSSOS-EU
comparison covering scope, methodology and why the two frameworks disagree
on the same geometry.
- References section with verified entries: Salomons, Attenborough & Van
Renterghem, Maekawa 1968, the CNOSSOS-EU JRC report and the ISO 9613-1/-2
catalogue pages.
* docs: impulse-prominence context: category adjustments, ISO/PAS 1996-3 and logging caveats
Add a short standards-context section to the impulse-prominence guide in the
three trees: the fixed ISO 1996-1:2016 Table A.1 category adjustments (5 dB
regular, 12 dB highly impulsive) that the measured prominence replaces with
a graduated KI, the ISO/PAS 1996-3:2022 successor built on the same
onset-rate prominence, and two practical caveats (time-weighting-F smoothing
of very short impulses and prominence-not-energy). References section with
the Nordtest method page and the ISO 1996-1 / ISO/PAS 1996-3 catalogue
pages, all verified.
* docs: wind-turbine-noise didactics: measurement geometry, apparent power and wind-speed binning
Expand the wind-turbine-noise guide in the three trees:
- Embed the IEC 61400-11 measurement-geometry diagram (ground-board
microphone at R0 = H + D/2, slant distance R1, met mast, plan-view
position pattern).
- New subsection on why the apparent sound power is not a true LW: an
equivalent point source at the rotor centre matched to one downwind
position, with directivity folded in, comparable across turbines because
the geometry scales with the machine.
- New subsection on wind-speed bins and standardized conditions: 0.5 m/s
bins centred on integer and half-integer hub-height speeds, wind speed
derived from electric power through the power curve, the 0.8 to 1.3 times
85 %-power range, background-margin rules, and the Formula (29) conversion
to 10 m height over the 0.05 m reference roughness length.
- References section: IEC 61400-11:2012+AMD1:2018 CSV, IEC TS 61400-14:2005
and ISO 1996-2:2017, all verified.
* docs: outdoor and environmental sound group in the global bibliography
Add the Outdoor and environmental sound section to the bibliography in the
three trees, with back-links to the citing guides: Salomons, Attenborough &
Van Renterghem, Maekawa 1968, the CNOSSOS-EU JRC report, ISO 9613-1/-2,
ISO 1996-1/-2, NT ACOU 112, ISO/PAS 1996-3 and IEC 61400-11/-14. The
ISO 1996-2 entry also back-fills the tone-audibility citation that was
missing from the global list.
* docs: review fixes for the outdoor and environmental wave
- Bind the tonal-audibility criterion IEC 61400-11 reuses to the Annex C of
the 2007 edition of ISO 1996-2 (the 2017 edition carries the tonal methods
in Annexes J and K), in the wind-turbine References and the bibliography.
- ISO 3744 samples the pressure field over the enveloping surface; intensity
integration is ISO 9614 territory.
- IEC 61400-11 background rule: a margin of 3 dB or less voids the bin (the
boundary case included).
- Ground-reflection diagram: parenthesise the reflection-coefficient note so
SVG whitespace collapsing cannot glue it to the formula; move the
wind-turbine ground-board label clear of the R1 ray.
- Spanish polish: unify onset rate as tasa de crecimiento, replace the
recomprar calque with compensar.
* docs: review refinements in the outdoor and environmental guides
---------
Co-authored-by: José M. Requena Plens <jmrplens@icloud.com>
docs: outdoor and environmental didactics, measurement-geometry diagrams and verified references (#199)
* docs: IEC 61400-11 measurement-geometry and ground-reflection setup diagrams
Two new deterministic SVG diagrams (4 variants each, EN/ES x light/dark):
- diagram_wind_turbine_iec61400: side view of the turbine with the downwind
ground-board microphone at R0 = H + D/2, the slant distance R1 to the
rotor centre, the met mast, the board inclination angle and the Figure 3
plan-view position pattern (reference position downwind, optional
positions at +/-60 degrees and upwind).
- diagram_ground_reflection: source and receiver over a reflecting plane
with the direct ray, the specular reflection unfolded through the image
source, the path difference delta = r2 - r1 and the interference phase.
* docs: outdoor-propagation didactics: image source, favourable conditions, barrier pitfalls, CNOSSOS-EU
Expand the outdoor-propagation guide in the three trees (docs EN, site EN,
site ES):
- New subsection on the image source behind the ground effect, with the
ground-reflection diagram: path difference, interference phase, the hard
-3 dB result and the porous-ground notch that Table 3 parameterizes.
- New closing section on scope and pitfalls: what the favourable propagation
conditions of Clause 5 mean and why the method predicts the audible case;
barrier fine print (the 20/25 dB caps, the Kmet erosion over distance, the
modest double-diffraction bonus, the Abar = Dz - Agr fold-in and the
Clause 7.4 qualification rules); and an ISO 9613-2 vs CNOSSOS-EU
comparison covering scope, methodology and why the two frameworks disagree
on the same geometry.
- References section with verified entries: Salomons, Attenborough & Van
Renterghem, Maekawa 1968, the CNOSSOS-EU JRC report and the ISO 9613-1/-2
catalogue pages.
* docs: impulse-prominence context: category adjustments, ISO/PAS 1996-3 and logging caveats
Add a short standards-context section to the impulse-prominence guide in the
three trees: the fixed ISO 1996-1:2016 Table A.1 category adjustments (5 dB
regular, 12 dB highly impulsive) that the measured prominence replaces with
a graduated KI, the ISO/PAS 1996-3:2022 successor built on the same
onset-rate prominence, and two practical caveats (time-weighting-F smoothing
of very short impulses and prominence-not-energy). References section with
the Nordtest method page and the ISO 1996-1 / ISO/PAS 1996-3 catalogue
pages, all verified.
* docs: wind-turbine-noise didactics: measurement geometry, apparent power and wind-speed binning
Expand the wind-turbine-noise guide in the three trees:
- Embed the IEC 61400-11 measurement-geometry diagram (ground-board
microphone at R0 = H + D/2, slant distance R1, met mast, plan-view
position pattern).
- New subsection on why the apparent sound power is not a true LW: an
equivalent point source at the rotor centre matched to one downwind
position, with directivity folded in, comparable across turbines because
the geometry scales with the machine.
- New subsection on wind-speed bins and standardized conditions: 0.5 m/s
bins centred on integer and half-integer hub-height speeds, wind speed
derived from electric power through the power curve, the 0.8 to 1.3 times
85 %-power range, background-margin rules, and the Formula (29) conversion
to 10 m height over the 0.05 m reference roughness length.
- References section: IEC 61400-11:2012+AMD1:2018 CSV, IEC TS 61400-14:2005
and ISO 1996-2:2017, all verified.
* docs: outdoor and environmental sound group in the global bibliography
Add the Outdoor and environmental sound section to the bibliography in the
three trees, with back-links to the citing guides: Salomons, Attenborough &
Van Renterghem, Maekawa 1968, the CNOSSOS-EU JRC report, ISO 9613-1/-2,
ISO 1996-1/-2, NT ACOU 112, ISO/PAS 1996-3 and IEC 61400-11/-14. The
ISO 1996-2 entry also back-fills the tone-audibility citation that was
missing from the global list.
* docs: review fixes for the outdoor and environmental wave
- Bind the tonal-audibility criterion IEC 61400-11 reuses to the Annex C of
the 2007 edition of ISO 1996-2 (the 2017 edition carries the tonal methods
in Annexes J and K), in the wind-turbine References and the bibliography.
- ISO 3744 samples the pressure field over the enveloping surface; intensity
integration is ISO 9614 territory.
- IEC 61400-11 background rule: a margin of 3 dB or less voids the bin (the
boundary case included).
- Ground-reflection diagram: parenthesise the reflection-coefficient note so
SVG whitespace collapsing cannot glue it to the formula; move the
wind-turbine ground-board label clear of the R1 ray.
- Spanish polish: unify onset rate as tasa de crecimiento, replace the
recomprar calque with compensar.
* docs: review refinements in the outdoor and environmental guides
---------
Co-authored-by: José M. Requena Plens <jmrplens@icloud.com>
Base the whole-body A(8) on the Directive 2002/44/EC Part B dominant axis and tighten the vibration fiches (#352)
Directive 2002/44/EC bases the whole-body daily exposure A(8) on the
highest of the frequency-weighted axis values 1,4*a_wx, 1,4*a_wy, a_wz
(Annex, Part B, point 1), not on the ISO 2631-1 Eq. (10) vector total
a_v; the hand-arm side keeps the Part A vector total a_hv.
- Relabel the whole-body magnitude of the daily-exposure fiche as
a_w,max with a printed note stating the Part B basis (EN/ES); add
vibration.wbv_exposure_basis() returning the dominant-axis value and
document in daily_vibration_exposure which magnitude each kind must
be fed with; state the same basis in the human-vibration guide
(EN/ES) and the measurement-chain diagram.
- Derive the boxed exposure zone of the fiche from the same
displayed-rounded comparisons as the assessment rows and the verdict,
so an A(8) printing exactly at a threshold cannot show a zone one
step below its own Exceeded row.
- ISO 10848 Kij fiche: distinguish an empty single-number mean caused
by every in-range band being bracketed (M < 0,25) from a spectrum
with no bands in the Annex A range (EN/ES).
- Spanish ISO 2631-5 outputs: translate the subject sex in the
injury-probability plot title and the word Formula in the fiche's
clause references.
- Correct the running_rms comment: the linear window divides by the
full window length (zero-padded front), it does not average over the
available samples.
Base the whole-body A(8) on the Directive 2002/44/EC Part B dominant axis and tighten the vibration fiches (#352)
Directive 2002/44/EC bases the whole-body daily exposure A(8) on the
highest of the frequency-weighted axis values 1,4*a_wx, 1,4*a_wy, a_wz
(Annex, Part B, point 1), not on the ISO 2631-1 Eq. (10) vector total
a_v; the hand-arm side keeps the Part A vector total a_hv.
- Relabel the whole-body magnitude of the daily-exposure fiche as
a_w,max with a printed note stating the Part B basis (EN/ES); add
vibration.wbv_exposure_basis() returning the dominant-axis value and
document in daily_vibration_exposure which magnitude each kind must
be fed with; state the same basis in the human-vibration guide
(EN/ES) and the measurement-chain diagram.
- Derive the boxed exposure zone of the fiche from the same
displayed-rounded comparisons as the assessment rows and the verdict,
so an A(8) printing exactly at a threshold cannot show a zone one
step below its own Exceeded row.
- ISO 10848 Kij fiche: distinguish an empty single-number mean caused
by every in-range band being bracketed (M < 0,25) from a spectrum
with no bands in the Annex A range (EN/ES).
- Spanish ISO 2631-5 outputs: translate the subject sex in the
injury-probability plot title and the word Formula in the fiche's
clause references.
- Correct the running_rms comment: the linear window divides by the
full window length (zero-padded front), it does not average over the
available samples.
Base the whole-body A(8) on the Directive 2002/44/EC Part B dominant axis and tighten the vibration fiches (#352)
Directive 2002/44/EC bases the whole-body daily exposure A(8) on the
highest of the frequency-weighted axis values 1,4*a_wx, 1,4*a_wy, a_wz
(Annex, Part B, point 1), not on the ISO 2631-1 Eq. (10) vector total
a_v; the hand-arm side keeps the Part A vector total a_hv.
- Relabel the whole-body magnitude of the daily-exposure fiche as
a_w,max with a printed note stating the Part B basis (EN/ES); add
vibration.wbv_exposure_basis() returning the dominant-axis value and
document in daily_vibration_exposure which magnitude each kind must
be fed with; state the same basis in the human-vibration guide
(EN/ES) and the measurement-chain diagram.
- Derive the boxed exposure zone of the fiche from the same
displayed-rounded comparisons as the assessment rows and the verdict,
so an A(8) printing exactly at a threshold cannot show a zone one
step below its own Exceeded row.
- ISO 10848 Kij fiche: distinguish an empty single-number mean caused
by every in-range band being bracketed (M < 0,25) from a spectrum
with no bands in the Annex A range (EN/ES).
- Spanish ISO 2631-5 outputs: translate the subject sex in the
injury-probability plot title and the word Formula in the fiche's
clause references.
- Correct the running_rms comment: the linear window divides by the
full window length (zero-padded front), it does not average over the
available samples.
Base the whole-body A(8) on the Directive 2002/44/EC Part B dominant axis and tighten the vibration fiches (#352)
Directive 2002/44/EC bases the whole-body daily exposure A(8) on the
highest of the frequency-weighted axis values 1,4*a_wx, 1,4*a_wy, a_wz
(Annex, Part B, point 1), not on the ISO 2631-1 Eq. (10) vector total
a_v; the hand-arm side keeps the Part A vector total a_hv.
- Relabel the whole-body magnitude of the daily-exposure fiche as
a_w,max with a printed note stating the Part B basis (EN/ES); add
vibration.wbv_exposure_basis() returning the dominant-axis value and
document in daily_vibration_exposure which magnitude each kind must
be fed with; state the same basis in the human-vibration guide
(EN/ES) and the measurement-chain diagram.
- Derive the boxed exposure zone of the fiche from the same
displayed-rounded comparisons as the assessment rows and the verdict,
so an A(8) printing exactly at a threshold cannot show a zone one
step below its own Exceeded row.
- ISO 10848 Kij fiche: distinguish an empty single-number mean caused
by every in-range band being bracketed (M < 0,25) from a spectrum
with no bands in the Annex A range (EN/ES).
- Spanish ISO 2631-5 outputs: translate the subject sex in the
injury-probability plot title and the word Formula in the fiche's
clause references.
- Correct the running_rms comment: the linear window divides by the
full window length (zero-padded front), it does not average over the
available samples.
Sound power determination and building acoustics II: ISO 3744/3746, ISO 3741, ISO 9614-2, ISO 16283-2 + ISO 717-2, ISO 354 (#84)
* feat: ISO 3744/3746 sound power from pressure measurements
Add sound_power.py: sound power level of a noise source from sound
pressure levels over an enveloping measurement surface, ISO 3744:2010
(engineering, grade 2) and ISO 3746:2010 (survey, grade 3).
- sound_power_pressure(): per-band LW and A-weighted LWA from an
(NM, NB) level array over a hemisphere (radius) or parallelepiped
(dimensions + distance); surface area from the standard's closed forms
for 1/2/3 reflecting planes; energy average (Eq. 12), background K1
(Eq. 16), environmental K2 (Eq. A.2), apparent directivity index
(Eq. 7), expanded uncertainty.
- measurement_positions(): normative Annex B coordinates
(Tables B.1/B.2/B.3), grade- and plane-dependent subsets.
- background_noise_correction(): K1 with engineering/survey criteria.
- environmental_correction(): K2 from A, Sabine T+V, or alpha*Sv.
- SoundPowerResult (frozen dataclass), SoundPowerWarning.
Tests: 24 cases incl. monopole-over-plane exact LW recovery, radius
independence, K1/K2 closed forms, LWA via Annex E, and validations.
make check green (543 passed, 12 skipped); ruff/bandit/mypy --strict clean.
Claude-Session: https://claude.ai/code/session_013kkVt3nxi9svp1an28uHxf
* fix: directivity index under background correction, citation hygiene
Broadband K1 for the apparent directivity index was collapsing to the
surface-area term 10*lg(S/S0) (~+22 dB inflation with background
correction). Compute the true energy-based broadband K1 (per-band Eq. 16
aggregated over bands) so DI is correct in both paths.
Also: multi-band sound_power_level_a without frequencies now returns NaN
(A-weighting needs band centres); dropped PDF page-number citations from
Annex B/E table comments; corrected the survey parallelepiped position
citation to ISO 3746 clause C.1 / Figure C.7.
Claude-Session: https://claude.ai/code/session_013kkVt3nxi9svp1an28uHxf
* feat: ISO 3741 reverberation-room sound power
Add the ISO 3741:2010 precision (grade 1) methods for determining sound
power in a reverberation test room, in a new sound_power_reverberation
module:
- sound_power_reverberation() — direct method (Eq. 20): LW from the mean
room SPL and the Sabine equivalent absorption area A = (55,26/c)(V/T60),
with the full normative bracket: 10 lg(A/A0), 4,34*(A/S), the Waterhouse
boundary term 10 lg(1 + S c/(8 V f)), the reference-quantity (C1) and
radiation-impedance (C2) meteorological corrections and the -6 dB
constant. Speed of sound c = 20,05*sqrt(273 + theta).
- sound_power_comparison() — comparison method (Eq. 21) with a reference
sound source: LW = LW(RSS) + (Lp(ST) - Lp(RSS) + C2).
- ReverberationSoundPowerResult frozen dataclass; frequency-dependent
background correction K1 (Eq. 14, same formula as ISO 3744) with the
precision-grade 6/10 dB criteria; A-weighted total via Annex F.
Reuses the ISO 3744 energy-average and A-weighting helpers. Tests cover
exact inversion of Eq. (20), the Waterhouse term vanishing at high
frequency, the comparison method exact by construction, and synergy with
room_parameters T30 feeding the direct method.
Claude-Session: https://claude.ai/code/session_013kkVt3nxi9svp1an28uHxf
* fix: ISO 3741 room-qualification advisories and validation ordering
Claude-Session: https://claude.ai/code/session_013kkVt3nxi9svp1an28uHxf
* feat: ISO 9614-2 sound power by intensity scanning
Add sound_power_intensity() computing per-band LW = 10lg(sum Pi/P0) from
per-segment signed normal intensity and areas (partial power Pi = <In,i>*Si),
the scanning-method field indicators FpI (Eq. A.1) and F+/- (Eq. A.2), the
repeatability criterion 3, and the achieved engineering/survey grade per band
(Annex B criteria 1-3). Negative total power flags bands as non-determinable
(clause 9.2); negative partial power raises SoundPowerWarning. Reuses
dynamic_capability_index for Ld = dpI0 - K (Table 1).
Claude-Session: https://claude.ai/code/session_013kkVt3nxi9svp1an28uHxf
* feat: ISO 16283-2 impact sound insulation and ISO 717-2 ratings
Add field impact sound insulation (ISO 16283-2, tapping machine) and the
ISO 717-2 single-number weighted impact rating with the CI spectrum
adaptation term, reusing the verified reference-curve shift engine.
- impact_insulation(li, t2, *, volume=None, t0=0.5): per-band
L'nT = Li - 10 lg(T/T0) (Formula (1)) and L'n = Li + 10 lg(A/A0) with
A = 0,16 V/T, A0 = 10 m2 (Formula (2)); positions energy-averaged.
- weighted_impact_rating(values_by_band, bands=None): Ln,w / L'n,w /
L'nT,w (Clause 4.3, octave -5 dB rule) and CI (Clause A.2.1, energetic
sum 100-2500 / 125-2000). Impact unfavourable deviations (measurement
exceeds reference, sign opposite to airborne) reduce to the airborne
search on negated curves, so _best_shift is reused verbatim.
- _best_shift: tolerance absorbs float noise at the exact bound (sums are
true multiples of 0,1 dB); airborne behaviour unchanged.
Verified against ISO 717-2 Annex C worked examples (Table C.1 Ln,w=79,
CI=-11; Table C.3 octave Ln,w=54, CI=0) and an independent brute-force
shift search on 10 000 random curves per band set. 2013 and 2020 editions
are identical for all implemented maths (2020 only adds Annex D rubber
ball, out of scope).
Claude-Session: https://claude.ai/code/session_013kkVt3nxi9svp1an28uHxf
* feat: ISO 354 sound absorption in a reverberation room
Add phonometry.sound_absorption implementing BS EN ISO 354:2003:
- absorption_area(t60, volume, ...): equivalent sound absorption area
A = 55,3*V/(c*T) - 4*V*m (Eq. 5/7), speed of sound from Eq. (6).
- absorption_coefficient(t1, t2, volume, sample_area, ...): alpha_s =
(A2-A1)/S built from Eq. (8)/(9), per-measurement c1/c2, unclamped
(alpha_s > 1 valid, clause 3.7 NOTE 2); warns when T2 >= T1.
- attenuation_from_alpha: ISO-354 conversion m = alpha/(10 lg e) from an
ISO 9613-1 attenuation coefficient (m deferred to ISO 9613-1, default 0).
Composes directly with room_parameters() T20/T30 outputs. 25 tests
(exact T->A->T inversion, synthetic-alpha recovery, zero-m air term,
two-temperature Eq. (8), range validation, room_parameters synergy).
Claude-Session: https://claude.ai/code/session_013kkVt3nxi9svp1an28uHxf
* fix: ISO 354 room and sample-size advisories
Add advisory AbsorptionWarning (never raising; result still returned) for
setup conditions outside ISO 354:2003 limits:
- Room volume below the 150 m3 minimum of clause 6.1.1, in both
absorption_area and absorption_coefficient.
- Sample area outside the clause 6.2.1.1 range 10 <= S <= 12 m2, with the
upper limit scaled by (V/200)^(2/3) when V > 200 m3, in
absorption_coefficient.
The volume advisory is emitted once by absorption_coefficient and suppressed
in its internal absorption_area calls to avoid duplicate warnings.
Claude-Session: https://claude.ai/code/session_013kkVt3nxi9svp1an28uHxf
* fix: deferred review minors — airborne brute-force net, advisory consistency, labels
Claude-Session: https://claude.ai/code/session_013kkVt3nxi9svp1an28uHxf
* docs: sound power guide, impact and absorption sections, theory and API (EN)
Add a "Sound Power" guide covering the three LW routes (ISO 3744/3746
enveloping surface, ISO 3741 reverberation room with Waterhouse/C1/C2,
ISO 9614-2 intensity scanning), with a method-comparison table, executed
snippets and parameter tables. Extend the Room & Building Acoustics guide
with impact sound insulation (ISO 16283-2 + ISO 717-2, L'nT/L'n, tapping
machine, CI) and sound absorption in a reverberation room (ISO 354).
Add the matching theory sections (K1/K2, Waterhouse, C1/C2 derivations;
impact sign conventions; Sabine absorption) and API-reference rows for all
new public names. Update the landing standards count to 26, the sidebar,
README highlights/table, CHANGELOG and llms-full.txt.
Claude-Session: https://claude.ai/code/session_013kkVt3nxi9svp1an28uHxf
* docs: sound-power and impact figures and diagrams
Claude-Session: https://claude.ai/code/session_013kkVt3nxi9svp1an28uHxf
* docs: include the sound-power guide in llms coverage
Claude-Session: https://claude.ai/code/session_013kkVt3nxi9svp1an28uHxf
* docs: reposition Ln,w annotation in the impact figure
Claude-Session: https://claude.ai/code/session_013kkVt3nxi9svp1an28uHxf
* docs: gemelas ES de potencia sonora, impacto y absorción
Claude-Session: https://claude.ai/code/session_013kkVt3nxi9svp1an28uHxf
* fix: final-review findings — comparison K1 reporting, citations, knee unification, docs attribution
- sound_power_comparison now reports the test-source K1 actually applied
per band (zero when no background), matching the dataclass docstring;
LW unchanged.
- Replace gitignored notes-iso3744-3746.md citation in the DI comment with
the standard reference (ISO 3744:2010, 3.24 / Eq. 7 context).
- Unify the K1 zeroing knee to the >= form (ΔLp >= 15 -> no correction).
- Broaden SoundPowerWarning docstring to name all emitters (ISO 3744/3746,
ISO 3741, ISO 9614-2).
- Fix docs misattributing K2 to ISO 3741 (ISO 3744 K2 vs ISO 3741 absorption
term) across EN/ES room-acoustics guides.
- EN impact-setup diagram uses dot decimals (0.16); regenerate the 4 variants.
- CHANGELOG: label the ISO 717-2 Annex C value Ln,w = 79.
- Warn-after-validate in sound_power_comparison; "is raised" -> "is emitted".
Claude-Session: https://claude.ai/code/session_013kkVt3nxi9svp1an28uHxf
* fix: PR 84 review round 1 — per-band DI and K2, sweep-reversal repeatability, validation and broadcast ergonomics
Claude-Session: https://claude.ai/code/session_013kkVt3nxi9svp1an28uHxf
* fix: PR 84 round 2 — partial room-data validation, result-field docs
Raise a clear ValueError in environmental_correction (and its
sound_power_pressure pass-through) when exactly one member of a
room-data pair (reverberation_time/room_volume or
mean_absorption_coefficient/room_surface) is supplied, instead of
silently returning K2=0 as if free field. All-None remains the
legitimate free-field K2=0 path.
Document frequencies on the ReverberationSoundPowerResult row and
negative_band as a standalone per-band boolean field on the
SoundPowerIntensityResult row across docs/api-reference.md and the
EN/ES site twins.
Claude-Session: https://claude.ai/code/session_013kkVt3nxi9svp1an28uHxf
Sound power determination and building acoustics II: ISO 3744/3746, ISO 3741, ISO 9614-2, ISO 16283-2 + ISO 717-2, ISO 354 (#84)
* feat: ISO 3744/3746 sound power from pressure measurements
Add sound_power.py: sound power level of a noise source from sound
pressure levels over an enveloping measurement surface, ISO 3744:2010
(engineering, grade 2) and ISO 3746:2010 (survey, grade 3).
- sound_power_pressure(): per-band LW and A-weighted LWA from an
(NM, NB) level array over a hemisphere (radius) or parallelepiped
(dimensions + distance); surface area from the standard's closed forms
for 1/2/3 reflecting planes; energy average (Eq. 12), background K1
(Eq. 16), environmental K2 (Eq. A.2), apparent directivity index
(Eq. 7), expanded uncertainty.
- measurement_positions(): normative Annex B coordinates
(Tables B.1/B.2/B.3), grade- and plane-dependent subsets.
- background_noise_correction(): K1 with engineering/survey criteria.
- environmental_correction(): K2 from A, Sabine T+V, or alpha*Sv.
- SoundPowerResult (frozen dataclass), SoundPowerWarning.
Tests: 24 cases incl. monopole-over-plane exact LW recovery, radius
independence, K1/K2 closed forms, LWA via Annex E, and validations.
make check green (543 passed, 12 skipped); ruff/bandit/mypy --strict clean.
Claude-Session: https://claude.ai/code/session_013kkVt3nxi9svp1an28uHxf
* fix: directivity index under background correction, citation hygiene
Broadband K1 for the apparent directivity index was collapsing to the
surface-area term 10*lg(S/S0) (~+22 dB inflation with background
correction). Compute the true energy-based broadband K1 (per-band Eq. 16
aggregated over bands) so DI is correct in both paths.
Also: multi-band sound_power_level_a without frequencies now returns NaN
(A-weighting needs band centres); dropped PDF page-number citations from
Annex B/E table comments; corrected the survey parallelepiped position
citation to ISO 3746 clause C.1 / Figure C.7.
Claude-Session: https://claude.ai/code/session_013kkVt3nxi9svp1an28uHxf
* feat: ISO 3741 reverberation-room sound power
Add the ISO 3741:2010 precision (grade 1) methods for determining sound
power in a reverberation test room, in a new sound_power_reverberation
module:
- sound_power_reverberation() — direct method (Eq. 20): LW from the mean
room SPL and the Sabine equivalent absorption area A = (55,26/c)(V/T60),
with the full normative bracket: 10 lg(A/A0), 4,34*(A/S), the Waterhouse
boundary term 10 lg(1 + S c/(8 V f)), the reference-quantity (C1) and
radiation-impedance (C2) meteorological corrections and the -6 dB
constant. Speed of sound c = 20,05*sqrt(273 + theta).
- sound_power_comparison() — comparison method (Eq. 21) with a reference
sound source: LW = LW(RSS) + (Lp(ST) - Lp(RSS) + C2).
- ReverberationSoundPowerResult frozen dataclass; frequency-dependent
background correction K1 (Eq. 14, same formula as ISO 3744) with the
precision-grade 6/10 dB criteria; A-weighted total via Annex F.
Reuses the ISO 3744 energy-average and A-weighting helpers. Tests cover
exact inversion of Eq. (20), the Waterhouse term vanishing at high
frequency, the comparison method exact by construction, and synergy with
room_parameters T30 feeding the direct method.
Claude-Session: https://claude.ai/code/session_013kkVt3nxi9svp1an28uHxf
* fix: ISO 3741 room-qualification advisories and validation ordering
Claude-Session: https://claude.ai/code/session_013kkVt3nxi9svp1an28uHxf
* feat: ISO 9614-2 sound power by intensity scanning
Add sound_power_intensity() computing per-band LW = 10lg(sum Pi/P0) from
per-segment signed normal intensity and areas (partial power Pi = <In,i>*Si),
the scanning-method field indicators FpI (Eq. A.1) and F+/- (Eq. A.2), the
repeatability criterion 3, and the achieved engineering/survey grade per band
(Annex B criteria 1-3). Negative total power flags bands as non-determinable
(clause 9.2); negative partial power raises SoundPowerWarning. Reuses
dynamic_capability_index for Ld = dpI0 - K (Table 1).
Claude-Session: https://claude.ai/code/session_013kkVt3nxi9svp1an28uHxf
* feat: ISO 16283-2 impact sound insulation and ISO 717-2 ratings
Add field impact sound insulation (ISO 16283-2, tapping machine) and the
ISO 717-2 single-number weighted impact rating with the CI spectrum
adaptation term, reusing the verified reference-curve shift engine.
- impact_insulation(li, t2, *, volume=None, t0=0.5): per-band
L'nT = Li - 10 lg(T/T0) (Formula (1)) and L'n = Li + 10 lg(A/A0) with
A = 0,16 V/T, A0 = 10 m2 (Formula (2)); positions energy-averaged.
- weighted_impact_rating(values_by_band, bands=None): Ln,w / L'n,w /
L'nT,w (Clause 4.3, octave -5 dB rule) and CI (Clause A.2.1, energetic
sum 100-2500 / 125-2000). Impact unfavourable deviations (measurement
exceeds reference, sign opposite to airborne) reduce to the airborne
search on negated curves, so _best_shift is reused verbatim.
- _best_shift: tolerance absorbs float noise at the exact bound (sums are
true multiples of 0,1 dB); airborne behaviour unchanged.
Verified against ISO 717-2 Annex C worked examples (Table C.1 Ln,w=79,
CI=-11; Table C.3 octave Ln,w=54, CI=0) and an independent brute-force
shift search on 10 000 random curves per band set. 2013 and 2020 editions
are identical for all implemented maths (2020 only adds Annex D rubber
ball, out of scope).
Claude-Session: https://claude.ai/code/session_013kkVt3nxi9svp1an28uHxf
* feat: ISO 354 sound absorption in a reverberation room
Add phonometry.sound_absorption implementing BS EN ISO 354:2003:
- absorption_area(t60, volume, ...): equivalent sound absorption area
A = 55,3*V/(c*T) - 4*V*m (Eq. 5/7), speed of sound from Eq. (6).
- absorption_coefficient(t1, t2, volume, sample_area, ...): alpha_s =
(A2-A1)/S built from Eq. (8)/(9), per-measurement c1/c2, unclamped
(alpha_s > 1 valid, clause 3.7 NOTE 2); warns when T2 >= T1.
- attenuation_from_alpha: ISO-354 conversion m = alpha/(10 lg e) from an
ISO 9613-1 attenuation coefficient (m deferred to ISO 9613-1, default 0).
Composes directly with room_parameters() T20/T30 outputs. 25 tests
(exact T->A->T inversion, synthetic-alpha recovery, zero-m air term,
two-temperature Eq. (8), range validation, room_parameters synergy).
Claude-Session: https://claude.ai/code/session_013kkVt3nxi9svp1an28uHxf
* fix: ISO 354 room and sample-size advisories
Add advisory AbsorptionWarning (never raising; result still returned) for
setup conditions outside ISO 354:2003 limits:
- Room volume below the 150 m3 minimum of clause 6.1.1, in both
absorption_area and absorption_coefficient.
- Sample area outside the clause 6.2.1.1 range 10 <= S <= 12 m2, with the
upper limit scaled by (V/200)^(2/3) when V > 200 m3, in
absorption_coefficient.
The volume advisory is emitted once by absorption_coefficient and suppressed
in its internal absorption_area calls to avoid duplicate warnings.
Claude-Session: https://claude.ai/code/session_013kkVt3nxi9svp1an28uHxf
* fix: deferred review minors — airborne brute-force net, advisory consistency, labels
Claude-Session: https://claude.ai/code/session_013kkVt3nxi9svp1an28uHxf
* docs: sound power guide, impact and absorption sections, theory and API (EN)
Add a "Sound Power" guide covering the three LW routes (ISO 3744/3746
enveloping surface, ISO 3741 reverberation room with Waterhouse/C1/C2,
ISO 9614-2 intensity scanning), with a method-comparison table, executed
snippets and parameter tables. Extend the Room & Building Acoustics guide
with impact sound insulation (ISO 16283-2 + ISO 717-2, L'nT/L'n, tapping
machine, CI) and sound absorption in a reverberation room (ISO 354).
Add the matching theory sections (K1/K2, Waterhouse, C1/C2 derivations;
impact sign conventions; Sabine absorption) and API-reference rows for all
new public names. Update the landing standards count to 26, the sidebar,
README highlights/table, CHANGELOG and llms-full.txt.
Claude-Session: https://claude.ai/code/session_013kkVt3nxi9svp1an28uHxf
* docs: sound-power and impact figures and diagrams
Claude-Session: https://claude.ai/code/session_013kkVt3nxi9svp1an28uHxf
* docs: include the sound-power guide in llms coverage
Claude-Session: https://claude.ai/code/session_013kkVt3nxi9svp1an28uHxf
* docs: reposition Ln,w annotation in the impact figure
Claude-Session: https://claude.ai/code/session_013kkVt3nxi9svp1an28uHxf
* docs: gemelas ES de potencia sonora, impacto y absorción
Claude-Session: https://claude.ai/code/session_013kkVt3nxi9svp1an28uHxf
* fix: final-review findings — comparison K1 reporting, citations, knee unification, docs attribution
- sound_power_comparison now reports the test-source K1 actually applied
per band (zero when no background), matching the dataclass docstring;
LW unchanged.
- Replace gitignored notes-iso3744-3746.md citation in the DI comment with
the standard reference (ISO 3744:2010, 3.24 / Eq. 7 context).
- Unify the K1 zeroing knee to the >= form (ΔLp >= 15 -> no correction).
- Broaden SoundPowerWarning docstring to name all emitters (ISO 3744/3746,
ISO 3741, ISO 9614-2).
- Fix docs misattributing K2 to ISO 3741 (ISO 3744 K2 vs ISO 3741 absorption
term) across EN/ES room-acoustics guides.
- EN impact-setup diagram uses dot decimals (0.16); regenerate the 4 variants.
- CHANGELOG: label the ISO 717-2 Annex C value Ln,w = 79.
- Warn-after-validate in sound_power_comparison; "is raised" -> "is emitted".
Claude-Session: https://claude.ai/code/session_013kkVt3nxi9svp1an28uHxf
* fix: PR 84 review round 1 — per-band DI and K2, sweep-reversal repeatability, validation and broadcast ergonomics
Claude-Session: https://claude.ai/code/session_013kkVt3nxi9svp1an28uHxf
* fix: PR 84 round 2 — partial room-data validation, result-field docs
Raise a clear ValueError in environmental_correction (and its
sound_power_pressure pass-through) when exactly one member of a
room-data pair (reverberation_time/room_volume or
mean_absorption_coefficient/room_surface) is supplied, instead of
silently returning K2=0 as if free field. All-None remains the
legitimate free-field K2=0 path.
Document frequencies on the ReverberationSoundPowerResult row and
negative_band as a standalone per-band boolean field on the
SoundPowerIntensityResult row across docs/api-reference.md and the
EN/ES site twins.
Claude-Session: https://claude.ai/code/session_013kkVt3nxi9svp1an28uHxf
Sound power determination and building acoustics II: ISO 3744/3746, ISO 3741, ISO 9614-2, ISO 16283-2 + ISO 717-2, ISO 354 (#84)
* feat: ISO 3744/3746 sound power from pressure measurements
Add sound_power.py: sound power level of a noise source from sound
pressure levels over an enveloping measurement surface, ISO 3744:2010
(engineering, grade 2) and ISO 3746:2010 (survey, grade 3).
- sound_power_pressure(): per-band LW and A-weighted LWA from an
(NM, NB) level array over a hemisphere (radius) or parallelepiped
(dimensions + distance); surface area from the standard's closed forms
for 1/2/3 reflecting planes; energy average (Eq. 12), background K1
(Eq. 16), environmental K2 (Eq. A.2), apparent directivity index
(Eq. 7), expanded uncertainty.
- measurement_positions(): normative Annex B coordinates
(Tables B.1/B.2/B.3), grade- and plane-dependent subsets.
- background_noise_correction(): K1 with engineering/survey criteria.
- environmental_correction(): K2 from A, Sabine T+V, or alpha*Sv.
- SoundPowerResult (frozen dataclass), SoundPowerWarning.
Tests: 24 cases incl. monopole-over-plane exact LW recovery, radius
independence, K1/K2 closed forms, LWA via Annex E, and validations.
make check green (543 passed, 12 skipped); ruff/bandit/mypy --strict clean.
Claude-Session: https://claude.ai/code/session_013kkVt3nxi9svp1an28uHxf
* fix: directivity index under background correction, citation hygiene
Broadband K1 for the apparent directivity index was collapsing to the
surface-area term 10*lg(S/S0) (~+22 dB inflation with background
correction). Compute the true energy-based broadband K1 (per-band Eq. 16
aggregated over bands) so DI is correct in both paths.
Also: multi-band sound_power_level_a without frequencies now returns NaN
(A-weighting needs band centres); dropped PDF page-number citations from
Annex B/E table comments; corrected the survey parallelepiped position
citation to ISO 3746 clause C.1 / Figure C.7.
Claude-Session: https://claude.ai/code/session_013kkVt3nxi9svp1an28uHxf
* feat: ISO 3741 reverberation-room sound power
Add the ISO 3741:2010 precision (grade 1) methods for determining sound
power in a reverberation test room, in a new sound_power_reverberation
module:
- sound_power_reverberation() — direct method (Eq. 20): LW from the mean
room SPL and the Sabine equivalent absorption area A = (55,26/c)(V/T60),
with the full normative bracket: 10 lg(A/A0), 4,34*(A/S), the Waterhouse
boundary term 10 lg(1 + S c/(8 V f)), the reference-quantity (C1) and
radiation-impedance (C2) meteorological corrections and the -6 dB
constant. Speed of sound c = 20,05*sqrt(273 + theta).
- sound_power_comparison() — comparison method (Eq. 21) with a reference
sound source: LW = LW(RSS) + (Lp(ST) - Lp(RSS) + C2).
- ReverberationSoundPowerResult frozen dataclass; frequency-dependent
background correction K1 (Eq. 14, same formula as ISO 3744) with the
precision-grade 6/10 dB criteria; A-weighted total via Annex F.
Reuses the ISO 3744 energy-average and A-weighting helpers. Tests cover
exact inversion of Eq. (20), the Waterhouse term vanishing at high
frequency, the comparison method exact by construction, and synergy with
room_parameters T30 feeding the direct method.
Claude-Session: https://claude.ai/code/session_013kkVt3nxi9svp1an28uHxf
* fix: ISO 3741 room-qualification advisories and validation ordering
Claude-Session: https://claude.ai/code/session_013kkVt3nxi9svp1an28uHxf
* feat: ISO 9614-2 sound power by intensity scanning
Add sound_power_intensity() computing per-band LW = 10lg(sum Pi/P0) from
per-segment signed normal intensity and areas (partial power Pi = <In,i>*Si),
the scanning-method field indicators FpI (Eq. A.1) and F+/- (Eq. A.2), the
repeatability criterion 3, and the achieved engineering/survey grade per band
(Annex B criteria 1-3). Negative total power flags bands as non-determinable
(clause 9.2); negative partial power raises SoundPowerWarning. Reuses
dynamic_capability_index for Ld = dpI0 - K (Table 1).
Claude-Session: https://claude.ai/code/session_013kkVt3nxi9svp1an28uHxf
* feat: ISO 16283-2 impact sound insulation and ISO 717-2 ratings
Add field impact sound insulation (ISO 16283-2, tapping machine) and the
ISO 717-2 single-number weighted impact rating with the CI spectrum
adaptation term, reusing the verified reference-curve shift engine.
- impact_insulation(li, t2, *, volume=None, t0=0.5): per-band
L'nT = Li - 10 lg(T/T0) (Formula (1)) and L'n = Li + 10 lg(A/A0) with
A = 0,16 V/T, A0 = 10 m2 (Formula (2)); positions energy-averaged.
- weighted_impact_rating(values_by_band, bands=None): Ln,w / L'n,w /
L'nT,w (Clause 4.3, octave -5 dB rule) and CI (Clause A.2.1, energetic
sum 100-2500 / 125-2000). Impact unfavourable deviations (measurement
exceeds reference, sign opposite to airborne) reduce to the airborne
search on negated curves, so _best_shift is reused verbatim.
- _best_shift: tolerance absorbs float noise at the exact bound (sums are
true multiples of 0,1 dB); airborne behaviour unchanged.
Verified against ISO 717-2 Annex C worked examples (Table C.1 Ln,w=79,
CI=-11; Table C.3 octave Ln,w=54, CI=0) and an independent brute-force
shift search on 10 000 random curves per band set. 2013 and 2020 editions
are identical for all implemented maths (2020 only adds Annex D rubber
ball, out of scope).
Claude-Session: https://claude.ai/code/session_013kkVt3nxi9svp1an28uHxf
* feat: ISO 354 sound absorption in a reverberation room
Add phonometry.sound_absorption implementing BS EN ISO 354:2003:
- absorption_area(t60, volume, ...): equivalent sound absorption area
A = 55,3*V/(c*T) - 4*V*m (Eq. 5/7), speed of sound from Eq. (6).
- absorption_coefficient(t1, t2, volume, sample_area, ...): alpha_s =
(A2-A1)/S built from Eq. (8)/(9), per-measurement c1/c2, unclamped
(alpha_s > 1 valid, clause 3.7 NOTE 2); warns when T2 >= T1.
- attenuation_from_alpha: ISO-354 conversion m = alpha/(10 lg e) from an
ISO 9613-1 attenuation coefficient (m deferred to ISO 9613-1, default 0).
Composes directly with room_parameters() T20/T30 outputs. 25 tests
(exact T->A->T inversion, synthetic-alpha recovery, zero-m air term,
two-temperature Eq. (8), range validation, room_parameters synergy).
Claude-Session: https://claude.ai/code/session_013kkVt3nxi9svp1an28uHxf
* fix: ISO 354 room and sample-size advisories
Add advisory AbsorptionWarning (never raising; result still returned) for
setup conditions outside ISO 354:2003 limits:
- Room volume below the 150 m3 minimum of clause 6.1.1, in both
absorption_area and absorption_coefficient.
- Sample area outside the clause 6.2.1.1 range 10 <= S <= 12 m2, with the
upper limit scaled by (V/200)^(2/3) when V > 200 m3, in
absorption_coefficient.
The volume advisory is emitted once by absorption_coefficient and suppressed
in its internal absorption_area calls to avoid duplicate warnings.
Claude-Session: https://claude.ai/code/session_013kkVt3nxi9svp1an28uHxf
* fix: deferred review minors — airborne brute-force net, advisory consistency, labels
Claude-Session: https://claude.ai/code/session_013kkVt3nxi9svp1an28uHxf
* docs: sound power guide, impact and absorption sections, theory and API (EN)
Add a "Sound Power" guide covering the three LW routes (ISO 3744/3746
enveloping surface, ISO 3741 reverberation room with Waterhouse/C1/C2,
ISO 9614-2 intensity scanning), with a method-comparison table, executed
snippets and parameter tables. Extend the Room & Building Acoustics guide
with impact sound insulation (ISO 16283-2 + ISO 717-2, L'nT/L'n, tapping
machine, CI) and sound absorption in a reverberation room (ISO 354).
Add the matching theory sections (K1/K2, Waterhouse, C1/C2 derivations;
impact sign conventions; Sabine absorption) and API-reference rows for all
new public names. Update the landing standards count to 26, the sidebar,
README highlights/table, CHANGELOG and llms-full.txt.
Claude-Session: https://claude.ai/code/session_013kkVt3nxi9svp1an28uHxf
* docs: sound-power and impact figures and diagrams
Claude-Session: https://claude.ai/code/session_013kkVt3nxi9svp1an28uHxf
* docs: include the sound-power guide in llms coverage
Claude-Session: https://claude.ai/code/session_013kkVt3nxi9svp1an28uHxf
* docs: reposition Ln,w annotation in the impact figure
Claude-Session: https://claude.ai/code/session_013kkVt3nxi9svp1an28uHxf
* docs: gemelas ES de potencia sonora, impacto y absorción
Claude-Session: https://claude.ai/code/session_013kkVt3nxi9svp1an28uHxf
* fix: final-review findings — comparison K1 reporting, citations, knee unification, docs attribution
- sound_power_comparison now reports the test-source K1 actually applied
per band (zero when no background), matching the dataclass docstring;
LW unchanged.
- Replace gitignored notes-iso3744-3746.md citation in the DI comment with
the standard reference (ISO 3744:2010, 3.24 / Eq. 7 context).
- Unify the K1 zeroing knee to the >= form (ΔLp >= 15 -> no correction).
- Broaden SoundPowerWarning docstring to name all emitters (ISO 3744/3746,
ISO 3741, ISO 9614-2).
- Fix docs misattributing K2 to ISO 3741 (ISO 3744 K2 vs ISO 3741 absorption
term) across EN/ES room-acoustics guides.
- EN impact-setup diagram uses dot decimals (0.16); regenerate the 4 variants.
- CHANGELOG: label the ISO 717-2 Annex C value Ln,w = 79.
- Warn-after-validate in sound_power_comparison; "is raised" -> "is emitted".
Claude-Session: https://claude.ai/code/session_013kkVt3nxi9svp1an28uHxf
* fix: PR 84 review round 1 — per-band DI and K2, sweep-reversal repeatability, validation and broadcast ergonomics
Claude-Session: https://claude.ai/code/session_013kkVt3nxi9svp1an28uHxf
* fix: PR 84 round 2 — partial room-data validation, result-field docs
Raise a clear ValueError in environmental_correction (and its
sound_power_pressure pass-through) when exactly one member of a
room-data pair (reverberation_time/room_volume or
mean_absorption_coefficient/room_surface) is supplied, instead of
silently returning K2=0 as if free field. All-None remains the
legitimate free-field K2=0 path.
Document frequencies on the ReverberationSoundPowerResult row and
negative_band as a standalone per-band boolean field on the
SoundPowerIntensityResult row across docs/api-reference.md and the
EN/ES site twins.
Claude-Session: https://claude.ai/code/session_013kkVt3nxi9svp1an28uHxf
Sound power determination and building acoustics II: ISO 3744/3746, ISO 3741, ISO 9614-2, ISO 16283-2 + ISO 717-2, ISO 354 (#84)
* feat: ISO 3744/3746 sound power from pressure measurements
Add sound_power.py: sound power level of a noise source from sound
pressure levels over an enveloping measurement surface, ISO 3744:2010
(engineering, grade 2) and ISO 3746:2010 (survey, grade 3).
- sound_power_pressure(): per-band LW and A-weighted LWA from an
(NM, NB) level array over a hemisphere (radius) or parallelepiped
(dimensions + distance); surface area from the standard's closed forms
for 1/2/3 reflecting planes; energy average (Eq. 12), background K1
(Eq. 16), environmental K2 (Eq. A.2), apparent directivity index
(Eq. 7), expanded uncertainty.
- measurement_positions(): normative Annex B coordinates
(Tables B.1/B.2/B.3), grade- and plane-dependent subsets.
- background_noise_correction(): K1 with engineering/survey criteria.
- environmental_correction(): K2 from A, Sabine T+V, or alpha*Sv.
- SoundPowerResult (frozen dataclass), SoundPowerWarning.
Tests: 24 cases incl. monopole-over-plane exact LW recovery, radius
independence, K1/K2 closed forms, LWA via Annex E, and validations.
make check green (543 passed, 12 skipped); ruff/bandit/mypy --strict clean.
Claude-Session: https://claude.ai/code/session_013kkVt3nxi9svp1an28uHxf
* fix: directivity index under background correction, citation hygiene
Broadband K1 for the apparent directivity index was collapsing to the
surface-area term 10*lg(S/S0) (~+22 dB inflation with background
correction). Compute the true energy-based broadband K1 (per-band Eq. 16
aggregated over bands) so DI is correct in both paths.
Also: multi-band sound_power_level_a without frequencies now returns NaN
(A-weighting needs band centres); dropped PDF page-number citations from
Annex B/E table comments; corrected the survey parallelepiped position
citation to ISO 3746 clause C.1 / Figure C.7.
Claude-Session: https://claude.ai/code/session_013kkVt3nxi9svp1an28uHxf
* feat: ISO 3741 reverberation-room sound power
Add the ISO 3741:2010 precision (grade 1) methods for determining sound
power in a reverberation test room, in a new sound_power_reverberation
module:
- sound_power_reverberation() — direct method (Eq. 20): LW from the mean
room SPL and the Sabine equivalent absorption area A = (55,26/c)(V/T60),
with the full normative bracket: 10 lg(A/A0), 4,34*(A/S), the Waterhouse
boundary term 10 lg(1 + S c/(8 V f)), the reference-quantity (C1) and
radiation-impedance (C2) meteorological corrections and the -6 dB
constant. Speed of sound c = 20,05*sqrt(273 + theta).
- sound_power_comparison() — comparison method (Eq. 21) with a reference
sound source: LW = LW(RSS) + (Lp(ST) - Lp(RSS) + C2).
- ReverberationSoundPowerResult frozen dataclass; frequency-dependent
background correction K1 (Eq. 14, same formula as ISO 3744) with the
precision-grade 6/10 dB criteria; A-weighted total via Annex F.
Reuses the ISO 3744 energy-average and A-weighting helpers. Tests cover
exact inversion of Eq. (20), the Waterhouse term vanishing at high
frequency, the comparison method exact by construction, and synergy with
room_parameters T30 feeding the direct method.
Claude-Session: https://claude.ai/code/session_013kkVt3nxi9svp1an28uHxf
* fix: ISO 3741 room-qualification advisories and validation ordering
Claude-Session: https://claude.ai/code/session_013kkVt3nxi9svp1an28uHxf
* feat: ISO 9614-2 sound power by intensity scanning
Add sound_power_intensity() computing per-band LW = 10lg(sum Pi/P0) from
per-segment signed normal intensity and areas (partial power Pi = <In,i>*Si),
the scanning-method field indicators FpI (Eq. A.1) and F+/- (Eq. A.2), the
repeatability criterion 3, and the achieved engineering/survey grade per band
(Annex B criteria 1-3). Negative total power flags bands as non-determinable
(clause 9.2); negative partial power raises SoundPowerWarning. Reuses
dynamic_capability_index for Ld = dpI0 - K (Table 1).
Claude-Session: https://claude.ai/code/session_013kkVt3nxi9svp1an28uHxf
* feat: ISO 16283-2 impact sound insulation and ISO 717-2 ratings
Add field impact sound insulation (ISO 16283-2, tapping machine) and the
ISO 717-2 single-number weighted impact rating with the CI spectrum
adaptation term, reusing the verified reference-curve shift engine.
- impact_insulation(li, t2, *, volume=None, t0=0.5): per-band
L'nT = Li - 10 lg(T/T0) (Formula (1)) and L'n = Li + 10 lg(A/A0) with
A = 0,16 V/T, A0 = 10 m2 (Formula (2)); positions energy-averaged.
- weighted_impact_rating(values_by_band, bands=None): Ln,w / L'n,w /
L'nT,w (Clause 4.3, octave -5 dB rule) and CI (Clause A.2.1, energetic
sum 100-2500 / 125-2000). Impact unfavourable deviations (measurement
exceeds reference, sign opposite to airborne) reduce to the airborne
search on negated curves, so _best_shift is reused verbatim.
- _best_shift: tolerance absorbs float noise at the exact bound (sums are
true multiples of 0,1 dB); airborne behaviour unchanged.
Verified against ISO 717-2 Annex C worked examples (Table C.1 Ln,w=79,
CI=-11; Table C.3 octave Ln,w=54, CI=0) and an independent brute-force
shift search on 10 000 random curves per band set. 2013 and 2020 editions
are identical for all implemented maths (2020 only adds Annex D rubber
ball, out of scope).
Claude-Session: https://claude.ai/code/session_013kkVt3nxi9svp1an28uHxf
* feat: ISO 354 sound absorption in a reverberation room
Add phonometry.sound_absorption implementing BS EN ISO 354:2003:
- absorption_area(t60, volume, ...): equivalent sound absorption area
A = 55,3*V/(c*T) - 4*V*m (Eq. 5/7), speed of sound from Eq. (6).
- absorption_coefficient(t1, t2, volume, sample_area, ...): alpha_s =
(A2-A1)/S built from Eq. (8)/(9), per-measurement c1/c2, unclamped
(alpha_s > 1 valid, clause 3.7 NOTE 2); warns when T2 >= T1.
- attenuation_from_alpha: ISO-354 conversion m = alpha/(10 lg e) from an
ISO 9613-1 attenuation coefficient (m deferred to ISO 9613-1, default 0).
Composes directly with room_parameters() T20/T30 outputs. 25 tests
(exact T->A->T inversion, synthetic-alpha recovery, zero-m air term,
two-temperature Eq. (8), range validation, room_parameters synergy).
Claude-Session: https://claude.ai/code/session_013kkVt3nxi9svp1an28uHxf
* fix: ISO 354 room and sample-size advisories
Add advisory AbsorptionWarning (never raising; result still returned) for
setup conditions outside ISO 354:2003 limits:
- Room volume below the 150 m3 minimum of clause 6.1.1, in both
absorption_area and absorption_coefficient.
- Sample area outside the clause 6.2.1.1 range 10 <= S <= 12 m2, with the
upper limit scaled by (V/200)^(2/3) when V > 200 m3, in
absorption_coefficient.
The volume advisory is emitted once by absorption_coefficient and suppressed
in its internal absorption_area calls to avoid duplicate warnings.
Claude-Session: https://claude.ai/code/session_013kkVt3nxi9svp1an28uHxf
* fix: deferred review minors — airborne brute-force net, advisory consistency, labels
Claude-Session: https://claude.ai/code/session_013kkVt3nxi9svp1an28uHxf
* docs: sound power guide, impact and absorption sections, theory and API (EN)
Add a "Sound Power" guide covering the three LW routes (ISO 3744/3746
enveloping surface, ISO 3741 reverberation room with Waterhouse/C1/C2,
ISO 9614-2 intensity scanning), with a method-comparison table, executed
snippets and parameter tables. Extend the Room & Building Acoustics guide
with impact sound insulation (ISO 16283-2 + ISO 717-2, L'nT/L'n, tapping
machine, CI) and sound absorption in a reverberation room (ISO 354).
Add the matching theory sections (K1/K2, Waterhouse, C1/C2 derivations;
impact sign conventions; Sabine absorption) and API-reference rows for all
new public names. Update the landing standards count to 26, the sidebar,
README highlights/table, CHANGELOG and llms-full.txt.
Claude-Session: https://claude.ai/code/session_013kkVt3nxi9svp1an28uHxf
* docs: sound-power and impact figures and diagrams
Claude-Session: https://claude.ai/code/session_013kkVt3nxi9svp1an28uHxf
* docs: include the sound-power guide in llms coverage
Claude-Session: https://claude.ai/code/session_013kkVt3nxi9svp1an28uHxf
* docs: reposition Ln,w annotation in the impact figure
Claude-Session: https://claude.ai/code/session_013kkVt3nxi9svp1an28uHxf
* docs: gemelas ES de potencia sonora, impacto y absorción
Claude-Session: https://claude.ai/code/session_013kkVt3nxi9svp1an28uHxf
* fix: final-review findings — comparison K1 reporting, citations, knee unification, docs attribution
- sound_power_comparison now reports the test-source K1 actually applied
per band (zero when no background), matching the dataclass docstring;
LW unchanged.
- Replace gitignored notes-iso3744-3746.md citation in the DI comment with
the standard reference (ISO 3744:2010, 3.24 / Eq. 7 context).
- Unify the K1 zeroing knee to the >= form (ΔLp >= 15 -> no correction).
- Broaden SoundPowerWarning docstring to name all emitters (ISO 3744/3746,
ISO 3741, ISO 9614-2).
- Fix docs misattributing K2 to ISO 3741 (ISO 3744 K2 vs ISO 3741 absorption
term) across EN/ES room-acoustics guides.
- EN impact-setup diagram uses dot decimals (0.16); regenerate the 4 variants.
- CHANGELOG: label the ISO 717-2 Annex C value Ln,w = 79.
- Warn-after-validate in sound_power_comparison; "is raised" -> "is emitted".
Claude-Session: https://claude.ai/code/session_013kkVt3nxi9svp1an28uHxf
* fix: PR 84 review round 1 — per-band DI and K2, sweep-reversal repeatability, validation and broadcast ergonomics
Claude-Session: https://claude.ai/code/session_013kkVt3nxi9svp1an28uHxf
* fix: PR 84 round 2 — partial room-data validation, result-field docs
Raise a clear ValueError in environmental_correction (and its
sound_power_pressure pass-through) when exactly one member of a
room-data pair (reverberation_time/room_volume or
mean_absorption_coefficient/room_surface) is supplied, instead of
silently returning K2=0 as if free field. All-None remains the
legitimate free-field K2=0 path.
Document frequencies on the ReverberationSoundPowerResult row and
negative_band as a standalone per-band boolean field on the
SoundPowerIntensityResult row across docs/api-reference.md and the
EN/ES site twins.
Claude-Session: https://claude.ai/code/session_013kkVt3nxi9svp1an28uHxf
Acoustic materials: impedance tube, airflow resistance & sound-absorption rating (ISO 10534-1/-2, ASTM E2611, ISO 9053-1/-2, ISO 11654) (#91)
* feat: impedance tube, airflow resistance and ISO 11654 absorption rating
Clean-room from the standards (no third-party tool referenced):
- impedance_tube.py: ISO 10534-2 two-microphone transfer-function method
(reflection factor, surface impedance/admittance, absorption), ISO 10534-1
standing-wave-ratio method, and ASTM E2611 four-microphone transfer-matrix
method (wave decomposition, two-load/one-load T-matrix, transmission loss,
material wavenumber and characteristic impedance). Kelvin (ISO) vs Celsius
(ASTM) speed-of-sound helpers keep the two sign/unit conventions apart.
- airflow_resistance.py: ISO 9053-1 static method (through-origin quadratic
fit) and ISO 9053-2 alternating method (Formula 2), with R_s in Pa·s/m and
resistivity in Pa·s/m².
- absorption_rating.py: ISO 11654 weighted absorption alpha_w (0.05-grid
reference-curve shift, L/M/H shape indicators, absorption classes A-E),
verified against the Annex A.1/A.2 worked examples.
103 module tests plus public-export checks; physics-identity anchors for the
tube (rigid wall alpha=0, perfect absorber r=0/Z=rhoc, det(T)=1, air-layer
recovery to <1e-9) since neither tube standard prints a numeric example.
Claude-Session: https://claude.ai/code/session_01HUHMx4dxDes2t5UPQ25djP
* feat: ISO 9053-2 Annex A kappa', materials docs, figures & conformance
Address per-module review of the impedance-tube / materials modules:
- ISO 9053-2:2020 Annex A (normative): implement the heat-conduction-corrected
effective ratio of specific heats kappa' (Formula (A.7)) and the thermal
boundary-layer thickness b (A.4/A.5) as effective_kappa() and
thermal_boundary_layer_thickness(). The Annex A.3 worked example is a
digit-exact oracle (b = 1.83e-3 m, kappa' = 1.370). Fix the misleading
_ADIABATIC_KAPPA citation: 1.4 is the uncorrected adiabatic fallback, not the
Annex A output.
- absorption_rating: delegate .plot() to _plotting.plot_weighted_absorption,
matching the repo idiom (reuses _unfavourable_mask / _new_axes).
- docs/materials.md: new guide covering ISO 11654, ISO 9053-1/-2 and
ISO 10534-1/-2 + ASTM E2611, with runnable examples and three figures
(EN/ES, light/dark). Linked from the docs index.
- Conformance report: five materials checks (ISO 11654 Annex A.1/A.2,
ISO 9053-2 Annex A.3 b + kappa', ISO 10534-1 SWR); shared oracles in
reference_data.py. 48/48 checks pass.
Impedance-tube module review returned Approved (no code changes needed;
the Eq (20) phase citation was verified correct against ISO 10534-1 p.5).
Claude-Session: https://claude.ai/code/session_01JJLhQzF5hTdnEi3bfmqnqm
* docs: experimental-setup diagrams for the materials methods
Add hand-drawn SVG setup diagrams (EN/ES, light/dark) for the new methods,
mirroring the didactic style of the room-acoustics / outdoor diagrams, and
embed them in docs/materials.md:
- Impedance tube (ISO 10534-2): loudspeaker, tube, two flush microphones at
spacing s and distance x1 from the specimen face, rigid backing, incident/
reflected plane waves and the Eq. (17)-(19) relations.
- Four-microphone transmission-loss tube (ASTM E2611): source, two upstream
and two downstream microphones, adjustable two-load termination, the A/B/C/D
travelling waves, and s1/s2/l1/l2/d labelled to match the library's
transfer_matrix_two_load / wave_decomposition parameters (l1, l2 measured
from the specimen front reference plane).
- Airflow resistance (ISO 9053-1/-2): the static rig (specimen, laminar flow
q_v, differential manometer Δp) and the alternating rig (piston 1-4 Hz,
cavity V, specimen/airtight termination, cavity level L_p).
Also apply the whole-branch review's two before-merge items:
- airflow_resistance.py: add the module-level __all__ it was missing.
- impedance_tube.face_quantities: add functional tests (progressive/backward
wave impedance = ±rho*c) so the exported ASTM Eq. (21) helper is covered.
SVG text() now XML-escapes &, < and > so labels may contain them literally.
Diagrams validated by subagent against the standards' figures and the
library's public-API variable names; the ASTM l2 origin was corrected from
the rear to the front specimen face to match the library convention.
Claude-Session: https://claude.ai/code/session_01JJLhQzF5hTdnEi3bfmqnqm
* fix: harden ISO 11654 input coercion (bot review)
_coerce now rejects multi-dimensional array input instead of silently
flattening it (CodeRabbit) and rejects non-finite values with a clear message
instead of a cryptic downstream integer-conversion error (Gemini). Adds tests
for both.
Claude-Session: https://claude.ai/code/session_01JJLhQzF5hTdnEi3bfmqnqm
* fix: flag ill-conditioned transfer-matrix solves (bot review)
transfer_matrix_two_load / transfer_matrix_one_load now emit an
ImpedanceTubeWarning when the solve denominator is near-singular relative to
its operands — two insufficiently-different loads (two-load) or a near-resonant
geometry (one-load) — instead of silently propagating inf/nan (CodeRabbit).
Adds tests for both the singular and the well-conditioned case.
Claude-Session: https://claude.ai/code/session_01JJLhQzF5hTdnEi3bfmqnqm
Acoustic materials: impedance tube, airflow resistance & sound-absorption rating (ISO 10534-1/-2, ASTM E2611, ISO 9053-1/-2, ISO 11654) (#91)
* feat: impedance tube, airflow resistance and ISO 11654 absorption rating
Clean-room from the standards (no third-party tool referenced):
- impedance_tube.py: ISO 10534-2 two-microphone transfer-function method
(reflection factor, surface impedance/admittance, absorption), ISO 10534-1
standing-wave-ratio method, and ASTM E2611 four-microphone transfer-matrix
method (wave decomposition, two-load/one-load T-matrix, transmission loss,
material wavenumber and characteristic impedance). Kelvin (ISO) vs Celsius
(ASTM) speed-of-sound helpers keep the two sign/unit conventions apart.
- airflow_resistance.py: ISO 9053-1 static method (through-origin quadratic
fit) and ISO 9053-2 alternating method (Formula 2), with R_s in Pa·s/m and
resistivity in Pa·s/m².
- absorption_rating.py: ISO 11654 weighted absorption alpha_w (0.05-grid
reference-curve shift, L/M/H shape indicators, absorption classes A-E),
verified against the Annex A.1/A.2 worked examples.
103 module tests plus public-export checks; physics-identity anchors for the
tube (rigid wall alpha=0, perfect absorber r=0/Z=rhoc, det(T)=1, air-layer
recovery to <1e-9) since neither tube standard prints a numeric example.
Claude-Session: https://claude.ai/code/session_01HUHMx4dxDes2t5UPQ25djP
* feat: ISO 9053-2 Annex A kappa', materials docs, figures & conformance
Address per-module review of the impedance-tube / materials modules:
- ISO 9053-2:2020 Annex A (normative): implement the heat-conduction-corrected
effective ratio of specific heats kappa' (Formula (A.7)) and the thermal
boundary-layer thickness b (A.4/A.5) as effective_kappa() and
thermal_boundary_layer_thickness(). The Annex A.3 worked example is a
digit-exact oracle (b = 1.83e-3 m, kappa' = 1.370). Fix the misleading
_ADIABATIC_KAPPA citation: 1.4 is the uncorrected adiabatic fallback, not the
Annex A output.
- absorption_rating: delegate .plot() to _plotting.plot_weighted_absorption,
matching the repo idiom (reuses _unfavourable_mask / _new_axes).
- docs/materials.md: new guide covering ISO 11654, ISO 9053-1/-2 and
ISO 10534-1/-2 + ASTM E2611, with runnable examples and three figures
(EN/ES, light/dark). Linked from the docs index.
- Conformance report: five materials checks (ISO 11654 Annex A.1/A.2,
ISO 9053-2 Annex A.3 b + kappa', ISO 10534-1 SWR); shared oracles in
reference_data.py. 48/48 checks pass.
Impedance-tube module review returned Approved (no code changes needed;
the Eq (20) phase citation was verified correct against ISO 10534-1 p.5).
Claude-Session: https://claude.ai/code/session_01JJLhQzF5hTdnEi3bfmqnqm
* docs: experimental-setup diagrams for the materials methods
Add hand-drawn SVG setup diagrams (EN/ES, light/dark) for the new methods,
mirroring the didactic style of the room-acoustics / outdoor diagrams, and
embed them in docs/materials.md:
- Impedance tube (ISO 10534-2): loudspeaker, tube, two flush microphones at
spacing s and distance x1 from the specimen face, rigid backing, incident/
reflected plane waves and the Eq. (17)-(19) relations.
- Four-microphone transmission-loss tube (ASTM E2611): source, two upstream
and two downstream microphones, adjustable two-load termination, the A/B/C/D
travelling waves, and s1/s2/l1/l2/d labelled to match the library's
transfer_matrix_two_load / wave_decomposition parameters (l1, l2 measured
from the specimen front reference plane).
- Airflow resistance (ISO 9053-1/-2): the static rig (specimen, laminar flow
q_v, differential manometer Δp) and the alternating rig (piston 1-4 Hz,
cavity V, specimen/airtight termination, cavity level L_p).
Also apply the whole-branch review's two before-merge items:
- airflow_resistance.py: add the module-level __all__ it was missing.
- impedance_tube.face_quantities: add functional tests (progressive/backward
wave impedance = ±rho*c) so the exported ASTM Eq. (21) helper is covered.
SVG text() now XML-escapes &, < and > so labels may contain them literally.
Diagrams validated by subagent against the standards' figures and the
library's public-API variable names; the ASTM l2 origin was corrected from
the rear to the front specimen face to match the library convention.
Claude-Session: https://claude.ai/code/session_01JJLhQzF5hTdnEi3bfmqnqm
* fix: harden ISO 11654 input coercion (bot review)
_coerce now rejects multi-dimensional array input instead of silently
flattening it (CodeRabbit) and rejects non-finite values with a clear message
instead of a cryptic downstream integer-conversion error (Gemini). Adds tests
for both.
Claude-Session: https://claude.ai/code/session_01JJLhQzF5hTdnEi3bfmqnqm
* fix: flag ill-conditioned transfer-matrix solves (bot review)
transfer_matrix_two_load / transfer_matrix_one_load now emit an
ImpedanceTubeWarning when the solve denominator is near-singular relative to
its operands — two insufficiently-different loads (two-load) or a near-resonant
geometry (one-load) — instead of silently propagating inf/nan (CodeRabbit).
Adds tests for both the singular and the well-conditioned case.
Claude-Session: https://claude.ai/code/session_01JJLhQzF5hTdnEi3bfmqnqm
Acoustic materials: impedance tube, airflow resistance & sound-absorption rating (ISO 10534-1/-2, ASTM E2611, ISO 9053-1/-2, ISO 11654) (#91)
* feat: impedance tube, airflow resistance and ISO 11654 absorption rating
Clean-room from the standards (no third-party tool referenced):
- impedance_tube.py: ISO 10534-2 two-microphone transfer-function method
(reflection factor, surface impedance/admittance, absorption), ISO 10534-1
standing-wave-ratio method, and ASTM E2611 four-microphone transfer-matrix
method (wave decomposition, two-load/one-load T-matrix, transmission loss,
material wavenumber and characteristic impedance). Kelvin (ISO) vs Celsius
(ASTM) speed-of-sound helpers keep the two sign/unit conventions apart.
- airflow_resistance.py: ISO 9053-1 static method (through-origin quadratic
fit) and ISO 9053-2 alternating method (Formula 2), with R_s in Pa·s/m and
resistivity in Pa·s/m².
- absorption_rating.py: ISO 11654 weighted absorption alpha_w (0.05-grid
reference-curve shift, L/M/H shape indicators, absorption classes A-E),
verified against the Annex A.1/A.2 worked examples.
103 module tests plus public-export checks; physics-identity anchors for the
tube (rigid wall alpha=0, perfect absorber r=0/Z=rhoc, det(T)=1, air-layer
recovery to <1e-9) since neither tube standard prints a numeric example.
Claude-Session: https://claude.ai/code/session_01HUHMx4dxDes2t5UPQ25djP
* feat: ISO 9053-2 Annex A kappa', materials docs, figures & conformance
Address per-module review of the impedance-tube / materials modules:
- ISO 9053-2:2020 Annex A (normative): implement the heat-conduction-corrected
effective ratio of specific heats kappa' (Formula (A.7)) and the thermal
boundary-layer thickness b (A.4/A.5) as effective_kappa() and
thermal_boundary_layer_thickness(). The Annex A.3 worked example is a
digit-exact oracle (b = 1.83e-3 m, kappa' = 1.370). Fix the misleading
_ADIABATIC_KAPPA citation: 1.4 is the uncorrected adiabatic fallback, not the
Annex A output.
- absorption_rating: delegate .plot() to _plotting.plot_weighted_absorption,
matching the repo idiom (reuses _unfavourable_mask / _new_axes).
- docs/materials.md: new guide covering ISO 11654, ISO 9053-1/-2 and
ISO 10534-1/-2 + ASTM E2611, with runnable examples and three figures
(EN/ES, light/dark). Linked from the docs index.
- Conformance report: five materials checks (ISO 11654 Annex A.1/A.2,
ISO 9053-2 Annex A.3 b + kappa', ISO 10534-1 SWR); shared oracles in
reference_data.py. 48/48 checks pass.
Impedance-tube module review returned Approved (no code changes needed;
the Eq (20) phase citation was verified correct against ISO 10534-1 p.5).
Claude-Session: https://claude.ai/code/session_01JJLhQzF5hTdnEi3bfmqnqm
* docs: experimental-setup diagrams for the materials methods
Add hand-drawn SVG setup diagrams (EN/ES, light/dark) for the new methods,
mirroring the didactic style of the room-acoustics / outdoor diagrams, and
embed them in docs/materials.md:
- Impedance tube (ISO 10534-2): loudspeaker, tube, two flush microphones at
spacing s and distance x1 from the specimen face, rigid backing, incident/
reflected plane waves and the Eq. (17)-(19) relations.
- Four-microphone transmission-loss tube (ASTM E2611): source, two upstream
and two downstream microphones, adjustable two-load termination, the A/B/C/D
travelling waves, and s1/s2/l1/l2/d labelled to match the library's
transfer_matrix_two_load / wave_decomposition parameters (l1, l2 measured
from the specimen front reference plane).
- Airflow resistance (ISO 9053-1/-2): the static rig (specimen, laminar flow
q_v, differential manometer Δp) and the alternating rig (piston 1-4 Hz,
cavity V, specimen/airtight termination, cavity level L_p).
Also apply the whole-branch review's two before-merge items:
- airflow_resistance.py: add the module-level __all__ it was missing.
- impedance_tube.face_quantities: add functional tests (progressive/backward
wave impedance = ±rho*c) so the exported ASTM Eq. (21) helper is covered.
SVG text() now XML-escapes &, < and > so labels may contain them literally.
Diagrams validated by subagent against the standards' figures and the
library's public-API variable names; the ASTM l2 origin was corrected from
the rear to the front specimen face to match the library convention.
Claude-Session: https://claude.ai/code/session_01JJLhQzF5hTdnEi3bfmqnqm
* fix: harden ISO 11654 input coercion (bot review)
_coerce now rejects multi-dimensional array input instead of silently
flattening it (CodeRabbit) and rejects non-finite values with a clear message
instead of a cryptic downstream integer-conversion error (Gemini). Adds tests
for both.
Claude-Session: https://claude.ai/code/session_01JJLhQzF5hTdnEi3bfmqnqm
* fix: flag ill-conditioned transfer-matrix solves (bot review)
transfer_matrix_two_load / transfer_matrix_one_load now emit an
ImpedanceTubeWarning when the solve denominator is near-singular relative to
its operands — two insufficiently-different loads (two-load) or a near-resonant
geometry (one-load) — instead of silently propagating inf/nan (CodeRabbit).
Adds tests for both the singular and the well-conditioned case.
Claude-Session: https://claude.ai/code/session_01JJLhQzF5hTdnEi3bfmqnqm
Acoustic materials: impedance tube, airflow resistance & sound-absorption rating (ISO 10534-1/-2, ASTM E2611, ISO 9053-1/-2, ISO 11654) (#91)
* feat: impedance tube, airflow resistance and ISO 11654 absorption rating
Clean-room from the standards (no third-party tool referenced):
- impedance_tube.py: ISO 10534-2 two-microphone transfer-function method
(reflection factor, surface impedance/admittance, absorption), ISO 10534-1
standing-wave-ratio method, and ASTM E2611 four-microphone transfer-matrix
method (wave decomposition, two-load/one-load T-matrix, transmission loss,
material wavenumber and characteristic impedance). Kelvin (ISO) vs Celsius
(ASTM) speed-of-sound helpers keep the two sign/unit conventions apart.
- airflow_resistance.py: ISO 9053-1 static method (through-origin quadratic
fit) and ISO 9053-2 alternating method (Formula 2), with R_s in Pa·s/m and
resistivity in Pa·s/m².
- absorption_rating.py: ISO 11654 weighted absorption alpha_w (0.05-grid
reference-curve shift, L/M/H shape indicators, absorption classes A-E),
verified against the Annex A.1/A.2 worked examples.
103 module tests plus public-export checks; physics-identity anchors for the
tube (rigid wall alpha=0, perfect absorber r=0/Z=rhoc, det(T)=1, air-layer
recovery to <1e-9) since neither tube standard prints a numeric example.
Claude-Session: https://claude.ai/code/session_01HUHMx4dxDes2t5UPQ25djP
* feat: ISO 9053-2 Annex A kappa', materials docs, figures & conformance
Address per-module review of the impedance-tube / materials modules:
- ISO 9053-2:2020 Annex A (normative): implement the heat-conduction-corrected
effective ratio of specific heats kappa' (Formula (A.7)) and the thermal
boundary-layer thickness b (A.4/A.5) as effective_kappa() and
thermal_boundary_layer_thickness(). The Annex A.3 worked example is a
digit-exact oracle (b = 1.83e-3 m, kappa' = 1.370). Fix the misleading
_ADIABATIC_KAPPA citation: 1.4 is the uncorrected adiabatic fallback, not the
Annex A output.
- absorption_rating: delegate .plot() to _plotting.plot_weighted_absorption,
matching the repo idiom (reuses _unfavourable_mask / _new_axes).
- docs/materials.md: new guide covering ISO 11654, ISO 9053-1/-2 and
ISO 10534-1/-2 + ASTM E2611, with runnable examples and three figures
(EN/ES, light/dark). Linked from the docs index.
- Conformance report: five materials checks (ISO 11654 Annex A.1/A.2,
ISO 9053-2 Annex A.3 b + kappa', ISO 10534-1 SWR); shared oracles in
reference_data.py. 48/48 checks pass.
Impedance-tube module review returned Approved (no code changes needed;
the Eq (20) phase citation was verified correct against ISO 10534-1 p.5).
Claude-Session: https://claude.ai/code/session_01JJLhQzF5hTdnEi3bfmqnqm
* docs: experimental-setup diagrams for the materials methods
Add hand-drawn SVG setup diagrams (EN/ES, light/dark) for the new methods,
mirroring the didactic style of the room-acoustics / outdoor diagrams, and
embed them in docs/materials.md:
- Impedance tube (ISO 10534-2): loudspeaker, tube, two flush microphones at
spacing s and distance x1 from the specimen face, rigid backing, incident/
reflected plane waves and the Eq. (17)-(19) relations.
- Four-microphone transmission-loss tube (ASTM E2611): source, two upstream
and two downstream microphones, adjustable two-load termination, the A/B/C/D
travelling waves, and s1/s2/l1/l2/d labelled to match the library's
transfer_matrix_two_load / wave_decomposition parameters (l1, l2 measured
from the specimen front reference plane).
- Airflow resistance (ISO 9053-1/-2): the static rig (specimen, laminar flow
q_v, differential manometer Δp) and the alternating rig (piston 1-4 Hz,
cavity V, specimen/airtight termination, cavity level L_p).
Also apply the whole-branch review's two before-merge items:
- airflow_resistance.py: add the module-level __all__ it was missing.
- impedance_tube.face_quantities: add functional tests (progressive/backward
wave impedance = ±rho*c) so the exported ASTM Eq. (21) helper is covered.
SVG text() now XML-escapes &, < and > so labels may contain them literally.
Diagrams validated by subagent against the standards' figures and the
library's public-API variable names; the ASTM l2 origin was corrected from
the rear to the front specimen face to match the library convention.
Claude-Session: https://claude.ai/code/session_01JJLhQzF5hTdnEi3bfmqnqm
* fix: harden ISO 11654 input coercion (bot review)
_coerce now rejects multi-dimensional array input instead of silently
flattening it (CodeRabbit) and rejects non-finite values with a clear message
instead of a cryptic downstream integer-conversion error (Gemini). Adds tests
for both.
Claude-Session: https://claude.ai/code/session_01JJLhQzF5hTdnEi3bfmqnqm
* fix: flag ill-conditioned transfer-matrix solves (bot review)
transfer_matrix_two_load / transfer_matrix_one_load now emit an
ImpedanceTubeWarning when the solve denominator is near-singular relative to
its operands — two insufficiently-different loads (two-load) or a near-resonant
geometry (one-load) — instead of silently propagating inf/nan (CodeRabbit).
Adds tests for both the singular and the well-conditioned case.
Claude-Session: https://claude.ai/code/session_01JJLhQzF5hTdnEi3bfmqnqm
docs: building and structure-borne didactics, five rig diagrams and verified references (#193)
* docs: five structure-borne rig diagrams (ISO 9052-1, ISO 7626, ISO 10846, EN 15657, EN 12354-5)
Deterministic SVG builders with shared spring, accelerometer and exciter
helpers; light/dark and EN/ES variants of the dynamic-stiffness resonance
rig, the mobility beam rig, the direct/indirect transfer-stiffness stacks,
the reception plate and the EN 12354-5 installed-paths cross-section.
* docs: lab-vs-field quantities map and C/Ctr interpretation for the insulation guides
The apostrophe convention and flanking inclusion spelled out across the
trio, the extended lab/field quantities table, a didactic reading of the
spectrum adaptation terms, the measurement-prediction-check loop, and
verified References sections (Hopkins, Vigran, ISO 717-1, ISO 16283-1) in
the three copies (docs, site EN, site ES).
* docs: didactic depth for the structure-borne measurement guides
Rig diagrams embedded and prose added in all three copies: resonance-method
assumptions and preload pitfalls (EN 29052-1), how to read a mobility plot
and the ISO 7626-2 arrangement, why the blocked force and the frequency
split of the ISO 10846 methods, when the radiation-factor assumption breaks
(ISO/TS 7849), the reception-plate rationale (EN 15657) and the EN 12354-5
installation-paths context, each with a verified References section.
* docs: building-acoustics and structure-borne groups in the global bibliography
Hopkins, Vigran and Cremer/Heckl/Petersson with verified DOIs, the ISO
catalogue entries cited by the new References sections, and back-links to
the citing guides in the three bibliography copies.
* docs: legibility fixes in the mobility, transfer-stiffness and reception-plate diagrams
The driving-point caption clears the suspension spring, the Spanish
impedance-head caption clears the exciter stem, the excitation-mass boxes
fit the Spanish label, the indirect formula uses a consistent glyph style
and the Spanish source-quantities heading keeps a right margin.
* docs: precision and wording fixes in the new building and structure-borne prose
The radiation-factor caveat now qualifies accuracy rather than the bound,
Part 2 is tied explicitly to the radiation-factor problem, the survey
method keeps one Spanish term per page, the impedance-head note no longer
overstates, and Spanish register fixes (recrecido, diferencia, anclan) plus
site bibliography link texts aligned to the site page titles.
* docs: address review feedback on the building and structure-borne guides
- Field insulation guide: carry the spectrum adaptation terms on the field
descriptors (R'w + Ctr for facades, DnT,w + C between dwellings), matching
the example requirements of ISO 717-1, 5.3
- Transfer stiffness: state the ISO 10846-2 direct-method range from its
1 Hz scope bound instead of arbitrarily low frequencies, and say the
output is either rigidly blocked or loaded with a known mass
- Mechanical mobility: restrict the mobility-peak damping reading to the
isolated viscously damped resonator, present the soft free-free suspension
as the usual ISO 7626-2 arrangement rather than a requirement (clause 5),
and describe ISO 7626-5 as impact excitation with a non-attached exciter
whose spectrum is set by the impactor mass and tip stiffness
- Installed-paths diagram: render the EN 12354-5 Formula 17 path combination
as an energetic sum, 10 lg of the summed 10^(L/10) terms
- Spanish wording: parallel 'o bien ... o bien' in the transfer-stiffness
rig sentence and 'luego' in the resonance-rig diagram formula
docs: building and structure-borne didactics, five rig diagrams and verified references (#193)
* docs: five structure-borne rig diagrams (ISO 9052-1, ISO 7626, ISO 10846, EN 15657, EN 12354-5)
Deterministic SVG builders with shared spring, accelerometer and exciter
helpers; light/dark and EN/ES variants of the dynamic-stiffness resonance
rig, the mobility beam rig, the direct/indirect transfer-stiffness stacks,
the reception plate and the EN 12354-5 installed-paths cross-section.
* docs: lab-vs-field quantities map and C/Ctr interpretation for the insulation guides
The apostrophe convention and flanking inclusion spelled out across the
trio, the extended lab/field quantities table, a didactic reading of the
spectrum adaptation terms, the measurement-prediction-check loop, and
verified References sections (Hopkins, Vigran, ISO 717-1, ISO 16283-1) in
the three copies (docs, site EN, site ES).
* docs: didactic depth for the structure-borne measurement guides
Rig diagrams embedded and prose added in all three copies: resonance-method
assumptions and preload pitfalls (EN 29052-1), how to read a mobility plot
and the ISO 7626-2 arrangement, why the blocked force and the frequency
split of the ISO 10846 methods, when the radiation-factor assumption breaks
(ISO/TS 7849), the reception-plate rationale (EN 15657) and the EN 12354-5
installation-paths context, each with a verified References section.
* docs: building-acoustics and structure-borne groups in the global bibliography
Hopkins, Vigran and Cremer/Heckl/Petersson with verified DOIs, the ISO
catalogue entries cited by the new References sections, and back-links to
the citing guides in the three bibliography copies.
* docs: legibility fixes in the mobility, transfer-stiffness and reception-plate diagrams
The driving-point caption clears the suspension spring, the Spanish
impedance-head caption clears the exciter stem, the excitation-mass boxes
fit the Spanish label, the indirect formula uses a consistent glyph style
and the Spanish source-quantities heading keeps a right margin.
* docs: precision and wording fixes in the new building and structure-borne prose
The radiation-factor caveat now qualifies accuracy rather than the bound,
Part 2 is tied explicitly to the radiation-factor problem, the survey
method keeps one Spanish term per page, the impedance-head note no longer
overstates, and Spanish register fixes (recrecido, diferencia, anclan) plus
site bibliography link texts aligned to the site page titles.
* docs: address review feedback on the building and structure-borne guides
- Field insulation guide: carry the spectrum adaptation terms on the field
descriptors (R'w + Ctr for facades, DnT,w + C between dwellings), matching
the example requirements of ISO 717-1, 5.3
- Transfer stiffness: state the ISO 10846-2 direct-method range from its
1 Hz scope bound instead of arbitrarily low frequencies, and say the
output is either rigidly blocked or loaded with a known mass
- Mechanical mobility: restrict the mobility-peak damping reading to the
isolated viscously damped resonator, present the soft free-free suspension
as the usual ISO 7626-2 arrangement rather than a requirement (clause 5),
and describe ISO 7626-5 as impact excitation with a non-attached exciter
whose spectrum is set by the impactor mass and tip stiffness
- Installed-paths diagram: render the EN 12354-5 Formula 17 path combination
as an energetic sum, 10 lg of the summed 10^(L/10) terms
- Spanish wording: parallel 'o bien ... o bien' in the transfer-stiffness
rig sentence and 'luego' in the resonance-rig diagram formula
docs: building and structure-borne didactics, five rig diagrams and verified references (#193)
* docs: five structure-borne rig diagrams (ISO 9052-1, ISO 7626, ISO 10846, EN 15657, EN 12354-5)
Deterministic SVG builders with shared spring, accelerometer and exciter
helpers; light/dark and EN/ES variants of the dynamic-stiffness resonance
rig, the mobility beam rig, the direct/indirect transfer-stiffness stacks,
the reception plate and the EN 12354-5 installed-paths cross-section.
* docs: lab-vs-field quantities map and C/Ctr interpretation for the insulation guides
The apostrophe convention and flanking inclusion spelled out across the
trio, the extended lab/field quantities table, a didactic reading of the
spectrum adaptation terms, the measurement-prediction-check loop, and
verified References sections (Hopkins, Vigran, ISO 717-1, ISO 16283-1) in
the three copies (docs, site EN, site ES).
* docs: didactic depth for the structure-borne measurement guides
Rig diagrams embedded and prose added in all three copies: resonance-method
assumptions and preload pitfalls (EN 29052-1), how to read a mobility plot
and the ISO 7626-2 arrangement, why the blocked force and the frequency
split of the ISO 10846 methods, when the radiation-factor assumption breaks
(ISO/TS 7849), the reception-plate rationale (EN 15657) and the EN 12354-5
installation-paths context, each with a verified References section.
* docs: building-acoustics and structure-borne groups in the global bibliography
Hopkins, Vigran and Cremer/Heckl/Petersson with verified DOIs, the ISO
catalogue entries cited by the new References sections, and back-links to
the citing guides in the three bibliography copies.
* docs: legibility fixes in the mobility, transfer-stiffness and reception-plate diagrams
The driving-point caption clears the suspension spring, the Spanish
impedance-head caption clears the exciter stem, the excitation-mass boxes
fit the Spanish label, the indirect formula uses a consistent glyph style
and the Spanish source-quantities heading keeps a right margin.
* docs: precision and wording fixes in the new building and structure-borne prose
The radiation-factor caveat now qualifies accuracy rather than the bound,
Part 2 is tied explicitly to the radiation-factor problem, the survey
method keeps one Spanish term per page, the impedance-head note no longer
overstates, and Spanish register fixes (recrecido, diferencia, anclan) plus
site bibliography link texts aligned to the site page titles.
* docs: address review feedback on the building and structure-borne guides
- Field insulation guide: carry the spectrum adaptation terms on the field
descriptors (R'w + Ctr for facades, DnT,w + C between dwellings), matching
the example requirements of ISO 717-1, 5.3
- Transfer stiffness: state the ISO 10846-2 direct-method range from its
1 Hz scope bound instead of arbitrarily low frequencies, and say the
output is either rigidly blocked or loaded with a known mass
- Mechanical mobility: restrict the mobility-peak damping reading to the
isolated viscously damped resonator, present the soft free-free suspension
as the usual ISO 7626-2 arrangement rather than a requirement (clause 5),
and describe ISO 7626-5 as impact excitation with a non-attached exciter
whose spectrum is set by the impactor mass and tip stiffness
- Installed-paths diagram: render the EN 12354-5 Formula 17 path combination
as an energetic sum, 10 lg of the summed 10^(L/10) terms
- Spanish wording: parallel 'o bien ... o bien' in the transfer-stiffness
rig sentence and 'luego' in the resonance-rig diagram formula
docs: building and structure-borne didactics, five rig diagrams and verified references (#193)
* docs: five structure-borne rig diagrams (ISO 9052-1, ISO 7626, ISO 10846, EN 15657, EN 12354-5)
Deterministic SVG builders with shared spring, accelerometer and exciter
helpers; light/dark and EN/ES variants of the dynamic-stiffness resonance
rig, the mobility beam rig, the direct/indirect transfer-stiffness stacks,
the reception plate and the EN 12354-5 installed-paths cross-section.
* docs: lab-vs-field quantities map and C/Ctr interpretation for the insulation guides
The apostrophe convention and flanking inclusion spelled out across the
trio, the extended lab/field quantities table, a didactic reading of the
spectrum adaptation terms, the measurement-prediction-check loop, and
verified References sections (Hopkins, Vigran, ISO 717-1, ISO 16283-1) in
the three copies (docs, site EN, site ES).
* docs: didactic depth for the structure-borne measurement guides
Rig diagrams embedded and prose added in all three copies: resonance-method
assumptions and preload pitfalls (EN 29052-1), how to read a mobility plot
and the ISO 7626-2 arrangement, why the blocked force and the frequency
split of the ISO 10846 methods, when the radiation-factor assumption breaks
(ISO/TS 7849), the reception-plate rationale (EN 15657) and the EN 12354-5
installation-paths context, each with a verified References section.
* docs: building-acoustics and structure-borne groups in the global bibliography
Hopkins, Vigran and Cremer/Heckl/Petersson with verified DOIs, the ISO
catalogue entries cited by the new References sections, and back-links to
the citing guides in the three bibliography copies.
* docs: legibility fixes in the mobility, transfer-stiffness and reception-plate diagrams
The driving-point caption clears the suspension spring, the Spanish
impedance-head caption clears the exciter stem, the excitation-mass boxes
fit the Spanish label, the indirect formula uses a consistent glyph style
and the Spanish source-quantities heading keeps a right margin.
* docs: precision and wording fixes in the new building and structure-borne prose
The radiation-factor caveat now qualifies accuracy rather than the bound,
Part 2 is tied explicitly to the radiation-factor problem, the survey
method keeps one Spanish term per page, the impedance-head note no longer
overstates, and Spanish register fixes (recrecido, diferencia, anclan) plus
site bibliography link texts aligned to the site page titles.
* docs: address review feedback on the building and structure-borne guides
- Field insulation guide: carry the spectrum adaptation terms on the field
descriptors (R'w + Ctr for facades, DnT,w + C between dwellings), matching
the example requirements of ISO 717-1, 5.3
- Transfer stiffness: state the ISO 10846-2 direct-method range from its
1 Hz scope bound instead of arbitrarily low frequencies, and say the
output is either rigidly blocked or loaded with a known mass
- Mechanical mobility: restrict the mobility-peak damping reading to the
isolated viscously damped resonator, present the soft free-free suspension
as the usual ISO 7626-2 arrangement rather than a requirement (clause 5),
and describe ISO 7626-5 as impact excitation with a non-attached exciter
whose spectrum is set by the impactor mass and tip stiffness
- Installed-paths diagram: render the EN 12354-5 Formula 17 path combination
as an energetic sum, 10 lg of the summed 10^(L/10) terms
- Spanish wording: parallel 'o bien ... o bien' in the transfer-stiffness
rig sentence and 'luego' in the resonance-rig diagram formula
Room and building acoustics: ISO 18233, ISO 3382-1/2/3, ISO 16283-1 + ISO 717-1 (#81)
* feat: ISO 18233 sweep/MLS impulse-response acquisition
Add src/phonometry/room_ir.py implementing the ISO 18233:2006
deterministic-excitation IR front end: exponential sine sweep with exact
analytic phase (Annex B), linear spectral-division deconvolution with a
Farina inverse-filter option for harmonic separation (B.5), and
maximum-length-sequence generation (LFSR, orders 2-20) with circular
cross-correlation recovery (Annex A).
Validated against closed forms: known IIR bandpass recovered within 0.1 dB
in band (sweep and MLS), ideal chain to a band-limited delta, +3 dB SNR per
sweep-duration doubling (B.6), and all MLS orders verified as true
maximum-length sequences (autocorrelation L / -1).
433 passed, 12 skipped; ruff, mypy --strict and bandit clean.
Claude-Session: https://claude.ai/code/session_013kkVt3nxi9svp1an28uHxf
* feat: ISO 3382 room acoustic parameters from impulse responses
Add src/phonometry/room_acoustics.py implementing ISO 3382-1:2009 and
ISO 3382-2:2008 analysis of measured impulse responses:
- decay_curve(): Schroeder backward integration of the squared IR
(5.3.3, Eq. 1) with background-noise truncation at the noise/slope
crossing and exponential tail compensation (Eq. 3), broadband or per
IEC 61260 fractional-octave band.
- room_parameters(): per-band EDT (0/-10 dB, A.2.2), T20 (-5/-25 dB)
and T30 (-5/-35 dB) by least-squares fits (ISO 3382-2 Annex C),
clarity C50/C80 (Eq. A.10), definition D50 (Eq. A.11) and centre
time Ts (Eq. A.13), octave bands 125 Hz-4 kHz by default with a
one-third-octave option and a broadband mode.
- Validity flags per the 5.3.3 dynamic-range criterion (noise at least
evaluation range + 15 dB below the IR maximum: 25/35/45 dB) plus the
Annex B curvature indicator C = 100*(T30/T20 - 1).
Tests validate against closed forms for exponential decays (EDT = T20 =
T30 = T within 1 %; C_te = 10*lg(exp(13.8155*te/T) - 1); D50 =
1 - exp(-0.6908/T); Ts = T/13.8155), the exact C50/D50 relation
(Eq. A.12), double-slope decays (EDT < T20 < T30) and noise-driven
validity-flag behaviour, with tolerances far below the Table A.1 JNDs.
Claude-Session: https://claude.ai/code/session_013kkVt3nxi9svp1an28uHxf
* chore: move figure/diagram generators to scripts/
generate_graphs.py and generate_diagrams.py join benchmark_filters.py
and gen_llms.py in scripts/, where dev tooling already lives. Updated
the Makefile graphs target, the sys.path bootstrap in the graph guard
tests and in generate_graphs.py itself (src/ is now one level up), the
CONTRIBUTING instructions and the theme-images.css pointer. Verified:
module loads from the new location and regenerating the SVG diagrams
produces byte-identical output.
Claude-Session: https://claude.ai/code/session_013kkVt3nxi9svp1an28uHxf
* feat: ISO 3382-3 open-plan office spatial metrics
Add open_plan_metrics() computing the ISO 3382-3:2012 single-number
quantities from a line of workstation measurements: spatial decay rate
D2,S and nominal speech level Lp,A,S,4m (Clause 6.2, Eq.5; 2-16 m
positions on a log-distance regression) and distraction/privacy
distances rD/rP (Clause 6.3; STI-vs-distance linear regression crossing
0,50 and 0,20). Returns a frozen OpenPlanResult; validates the minimum
of four positions (5.2.2) and equal array lengths.
Claude-Session: https://claude.ai/code/session_013kkVt3nxi9svp1an28uHxf
* feat: ISO 16283-1 field insulation and ISO 717-1 weighted ratings
Add phonometry.insulation implementing field airborne sound insulation
(ISO 16283-1:2014) and single-number weighted ratings with C/Ctr
(ISO 717-1):
- airborne_insulation: per-band level difference D (Formula (1)),
standardized level difference DnT = D + 10 lg(T/T0) (Formula (2)) and
apparent sound reduction index R' = D + 10 lg(S/A), A = 0,16 V/T
(Formula (4)/(5)); energy-averages microphone positions (Formula (9)).
- weighted_rating: reference-curve shifting method (Clause 4.4, Table 3)
with the 32,0/10,0 dB unfavourable-deviation bound, plus C/Ctr from the
Table 4 spectra (Clause 4.5). Reference values, spectra and method are
identical in the 2013 and 2020 editions.
- energy_average_level: ISO 16283-1 Formula (9) helper.
Verified against the ISO 717-1 Annex C worked example (Rw(C;Ctr) =
30(-2;-3), unfavourable sum 31,8 dB) and exact-bound / tipping edge
cases. 20 new tests; make check green (484 passed, 12 skipped).
Claude-Session: https://claude.ai/code/session_013kkVt3nxi9svp1an28uHxf
* docs: room & building acoustics guide, theory, API and landing (EN)
New "Room & building acoustics" guide (docs/ + Starlight twin) covering the
full measurement chain: ISO 18233 swept-sine/MLS impulse-response acquisition,
ISO 3382-1/2 decay analysis and room parameters (EDT/T20/T30/C50/C80/D50/Ts),
ISO 3382-3 open-plan speech metrics, and ISO 16283-1 / ISO 717-1 field
insulation with weighted ratings. Adds the matching theory section (Schroeder
integration, regression windows, C/D/Ts, D2,S, DnT/R', reference-curve method),
API-reference rows for all new public names, sidebar entry, README highlight +
docs row, EN landing card, CHANGELOG entries, docs index row, and regenerated
llms-full.txt. All snippets validated; site build and make check green.
Claude-Session: https://claude.ai/code/session_013kkVt3nxi9svp1an28uHxf
* docs: Schroeder, ISO 717-1 rating and insulation-setup figures
Add three room/building-acoustics documentation figure sets (each in
en/es x light/dark):
- schroeder_decay: synthetic IR, Schroeder backward integration with
EDT/T20/T30 regressions and evaluation ranges (ISO 3382); annotated
values match room_parameters.
- insulation_rating: ISO 717-1 Annex C example with shifted reference
curve, unfavourable-deviation shading and Rw read at 500 Hz; Rw, C,
Ctr and the unfavourable sum come from weighted_rating.
- diagram_insulation_setup: ISO 16283-1 airborne setup plan view with
the normative minimum distances (clauses 7.6 and 7.2.2).
Claude-Session: https://claude.ai/code/session_013kkVt3nxi9svp1an28uHxf
* docs: gemelas ES de acústica de salas y edificación
Claude-Session: https://claude.ai/code/session_013kkVt3nxi9svp1an28uHxf
* docs: terminología UNE — ponderación temporal en lugar de balística (ES)
Claude-Session: https://claude.ai/code/session_013kkVt3nxi9svp1an28uHxf
* docs: markdown/README parity with the site + llms guide coverage
Scrub GitHub-unsafe display math (\, thin-spaces and escaped \{ \}) from
docs/intensity.md and docs/psychoacoustics.md — the only two guides that
missed the GitHub-safe math conversion of PRs #78/#79 — matching the safe
forms already used in docs/theory.md. Align calibration's sensitivity
symbol/formula to the site ($S$, single-line \qquad).
Extend scripts/gen_llms.py PAGES with the three omitted guides
(psychoacoustics, intensity, room-acoustics) and regenerate llms.txt /
llms-full.txt so AI-facing artifacts cover all 14 docs pages.
The guides/references were otherwise already in parity (didactic code
comments, theory sections, tables, and figures from PRs #77/#80 all
present); docs/README index and README highlights/table verified complete.
Claude-Session: https://claude.ai/code/session_013kkVt3nxi9svp1an28uHxf
* fix: final-review findings — open_plan validation, limits rename, Farina caveat, MLS averaging test
Claude-Session: https://claude.ai/code/session_013kkVt3nxi9svp1an28uHxf
* docs: ISO 18233 measurement-chain diagram and guide fixes
Claude-Session: https://claude.ai/code/session_013kkVt3nxi9svp1an28uHxf
* docs: fix sweep_signal cross-reference in Farina caveat
Claude-Session: https://claude.ai/code/session_013kkVt3nxi9svp1an28uHxf
* fix: PR 81 review round 1 — inverse-filter guards, truncation threshold, IR input validation, docs pipeline wording
Claude-Session: https://claude.ai/code/session_013kkVt3nxi9svp1an28uHxf
* docs: blank lines around CONTRIBUTING fence (MD031)
Claude-Session: https://claude.ai/code/session_013kkVt3nxi9svp1an28uHxf
Room and building acoustics: ISO 18233, ISO 3382-1/2/3, ISO 16283-1 + ISO 717-1 (#81)
* feat: ISO 18233 sweep/MLS impulse-response acquisition
Add src/phonometry/room_ir.py implementing the ISO 18233:2006
deterministic-excitation IR front end: exponential sine sweep with exact
analytic phase (Annex B), linear spectral-division deconvolution with a
Farina inverse-filter option for harmonic separation (B.5), and
maximum-length-sequence generation (LFSR, orders 2-20) with circular
cross-correlation recovery (Annex A).
Validated against closed forms: known IIR bandpass recovered within 0.1 dB
in band (sweep and MLS), ideal chain to a band-limited delta, +3 dB SNR per
sweep-duration doubling (B.6), and all MLS orders verified as true
maximum-length sequences (autocorrelation L / -1).
433 passed, 12 skipped; ruff, mypy --strict and bandit clean.
Claude-Session: https://claude.ai/code/session_013kkVt3nxi9svp1an28uHxf
* feat: ISO 3382 room acoustic parameters from impulse responses
Add src/phonometry/room_acoustics.py implementing ISO 3382-1:2009 and
ISO 3382-2:2008 analysis of measured impulse responses:
- decay_curve(): Schroeder backward integration of the squared IR
(5.3.3, Eq. 1) with background-noise truncation at the noise/slope
crossing and exponential tail compensation (Eq. 3), broadband or per
IEC 61260 fractional-octave band.
- room_parameters(): per-band EDT (0/-10 dB, A.2.2), T20 (-5/-25 dB)
and T30 (-5/-35 dB) by least-squares fits (ISO 3382-2 Annex C),
clarity C50/C80 (Eq. A.10), definition D50 (Eq. A.11) and centre
time Ts (Eq. A.13), octave bands 125 Hz-4 kHz by default with a
one-third-octave option and a broadband mode.
- Validity flags per the 5.3.3 dynamic-range criterion (noise at least
evaluation range + 15 dB below the IR maximum: 25/35/45 dB) plus the
Annex B curvature indicator C = 100*(T30/T20 - 1).
Tests validate against closed forms for exponential decays (EDT = T20 =
T30 = T within 1 %; C_te = 10*lg(exp(13.8155*te/T) - 1); D50 =
1 - exp(-0.6908/T); Ts = T/13.8155), the exact C50/D50 relation
(Eq. A.12), double-slope decays (EDT < T20 < T30) and noise-driven
validity-flag behaviour, with tolerances far below the Table A.1 JNDs.
Claude-Session: https://claude.ai/code/session_013kkVt3nxi9svp1an28uHxf
* chore: move figure/diagram generators to scripts/
generate_graphs.py and generate_diagrams.py join benchmark_filters.py
and gen_llms.py in scripts/, where dev tooling already lives. Updated
the Makefile graphs target, the sys.path bootstrap in the graph guard
tests and in generate_graphs.py itself (src/ is now one level up), the
CONTRIBUTING instructions and the theme-images.css pointer. Verified:
module loads from the new location and regenerating the SVG diagrams
produces byte-identical output.
Claude-Session: https://claude.ai/code/session_013kkVt3nxi9svp1an28uHxf
* feat: ISO 3382-3 open-plan office spatial metrics
Add open_plan_metrics() computing the ISO 3382-3:2012 single-number
quantities from a line of workstation measurements: spatial decay rate
D2,S and nominal speech level Lp,A,S,4m (Clause 6.2, Eq.5; 2-16 m
positions on a log-distance regression) and distraction/privacy
distances rD/rP (Clause 6.3; STI-vs-distance linear regression crossing
0,50 and 0,20). Returns a frozen OpenPlanResult; validates the minimum
of four positions (5.2.2) and equal array lengths.
Claude-Session: https://claude.ai/code/session_013kkVt3nxi9svp1an28uHxf
* feat: ISO 16283-1 field insulation and ISO 717-1 weighted ratings
Add phonometry.insulation implementing field airborne sound insulation
(ISO 16283-1:2014) and single-number weighted ratings with C/Ctr
(ISO 717-1):
- airborne_insulation: per-band level difference D (Formula (1)),
standardized level difference DnT = D + 10 lg(T/T0) (Formula (2)) and
apparent sound reduction index R' = D + 10 lg(S/A), A = 0,16 V/T
(Formula (4)/(5)); energy-averages microphone positions (Formula (9)).
- weighted_rating: reference-curve shifting method (Clause 4.4, Table 3)
with the 32,0/10,0 dB unfavourable-deviation bound, plus C/Ctr from the
Table 4 spectra (Clause 4.5). Reference values, spectra and method are
identical in the 2013 and 2020 editions.
- energy_average_level: ISO 16283-1 Formula (9) helper.
Verified against the ISO 717-1 Annex C worked example (Rw(C;Ctr) =
30(-2;-3), unfavourable sum 31,8 dB) and exact-bound / tipping edge
cases. 20 new tests; make check green (484 passed, 12 skipped).
Claude-Session: https://claude.ai/code/session_013kkVt3nxi9svp1an28uHxf
* docs: room & building acoustics guide, theory, API and landing (EN)
New "Room & building acoustics" guide (docs/ + Starlight twin) covering the
full measurement chain: ISO 18233 swept-sine/MLS impulse-response acquisition,
ISO 3382-1/2 decay analysis and room parameters (EDT/T20/T30/C50/C80/D50/Ts),
ISO 3382-3 open-plan speech metrics, and ISO 16283-1 / ISO 717-1 field
insulation with weighted ratings. Adds the matching theory section (Schroeder
integration, regression windows, C/D/Ts, D2,S, DnT/R', reference-curve method),
API-reference rows for all new public names, sidebar entry, README highlight +
docs row, EN landing card, CHANGELOG entries, docs index row, and regenerated
llms-full.txt. All snippets validated; site build and make check green.
Claude-Session: https://claude.ai/code/session_013kkVt3nxi9svp1an28uHxf
* docs: Schroeder, ISO 717-1 rating and insulation-setup figures
Add three room/building-acoustics documentation figure sets (each in
en/es x light/dark):
- schroeder_decay: synthetic IR, Schroeder backward integration with
EDT/T20/T30 regressions and evaluation ranges (ISO 3382); annotated
values match room_parameters.
- insulation_rating: ISO 717-1 Annex C example with shifted reference
curve, unfavourable-deviation shading and Rw read at 500 Hz; Rw, C,
Ctr and the unfavourable sum come from weighted_rating.
- diagram_insulation_setup: ISO 16283-1 airborne setup plan view with
the normative minimum distances (clauses 7.6 and 7.2.2).
Claude-Session: https://claude.ai/code/session_013kkVt3nxi9svp1an28uHxf
* docs: gemelas ES de acústica de salas y edificación
Claude-Session: https://claude.ai/code/session_013kkVt3nxi9svp1an28uHxf
* docs: terminología UNE — ponderación temporal en lugar de balística (ES)
Claude-Session: https://claude.ai/code/session_013kkVt3nxi9svp1an28uHxf
* docs: markdown/README parity with the site + llms guide coverage
Scrub GitHub-unsafe display math (\, thin-spaces and escaped \{ \}) from
docs/intensity.md and docs/psychoacoustics.md — the only two guides that
missed the GitHub-safe math conversion of PRs #78/#79 — matching the safe
forms already used in docs/theory.md. Align calibration's sensitivity
symbol/formula to the site ($S$, single-line \qquad).
Extend scripts/gen_llms.py PAGES with the three omitted guides
(psychoacoustics, intensity, room-acoustics) and regenerate llms.txt /
llms-full.txt so AI-facing artifacts cover all 14 docs pages.
The guides/references were otherwise already in parity (didactic code
comments, theory sections, tables, and figures from PRs #77/#80 all
present); docs/README index and README highlights/table verified complete.
Claude-Session: https://claude.ai/code/session_013kkVt3nxi9svp1an28uHxf
* fix: final-review findings — open_plan validation, limits rename, Farina caveat, MLS averaging test
Claude-Session: https://claude.ai/code/session_013kkVt3nxi9svp1an28uHxf
* docs: ISO 18233 measurement-chain diagram and guide fixes
Claude-Session: https://claude.ai/code/session_013kkVt3nxi9svp1an28uHxf
* docs: fix sweep_signal cross-reference in Farina caveat
Claude-Session: https://claude.ai/code/session_013kkVt3nxi9svp1an28uHxf
* fix: PR 81 review round 1 — inverse-filter guards, truncation threshold, IR input validation, docs pipeline wording
Claude-Session: https://claude.ai/code/session_013kkVt3nxi9svp1an28uHxf
* docs: blank lines around CONTRIBUTING fence (MD031)
Claude-Session: https://claude.ai/code/session_013kkVt3nxi9svp1an28uHxf
Room and building acoustics: ISO 18233, ISO 3382-1/2/3, ISO 16283-1 + ISO 717-1 (#81)
* feat: ISO 18233 sweep/MLS impulse-response acquisition
Add src/phonometry/room_ir.py implementing the ISO 18233:2006
deterministic-excitation IR front end: exponential sine sweep with exact
analytic phase (Annex B), linear spectral-division deconvolution with a
Farina inverse-filter option for harmonic separation (B.5), and
maximum-length-sequence generation (LFSR, orders 2-20) with circular
cross-correlation recovery (Annex A).
Validated against closed forms: known IIR bandpass recovered within 0.1 dB
in band (sweep and MLS), ideal chain to a band-limited delta, +3 dB SNR per
sweep-duration doubling (B.6), and all MLS orders verified as true
maximum-length sequences (autocorrelation L / -1).
433 passed, 12 skipped; ruff, mypy --strict and bandit clean.
Claude-Session: https://claude.ai/code/session_013kkVt3nxi9svp1an28uHxf
* feat: ISO 3382 room acoustic parameters from impulse responses
Add src/phonometry/room_acoustics.py implementing ISO 3382-1:2009 and
ISO 3382-2:2008 analysis of measured impulse responses:
- decay_curve(): Schroeder backward integration of the squared IR
(5.3.3, Eq. 1) with background-noise truncation at the noise/slope
crossing and exponential tail compensation (Eq. 3), broadband or per
IEC 61260 fractional-octave band.
- room_parameters(): per-band EDT (0/-10 dB, A.2.2), T20 (-5/-25 dB)
and T30 (-5/-35 dB) by least-squares fits (ISO 3382-2 Annex C),
clarity C50/C80 (Eq. A.10), definition D50 (Eq. A.11) and centre
time Ts (Eq. A.13), octave bands 125 Hz-4 kHz by default with a
one-third-octave option and a broadband mode.
- Validity flags per the 5.3.3 dynamic-range criterion (noise at least
evaluation range + 15 dB below the IR maximum: 25/35/45 dB) plus the
Annex B curvature indicator C = 100*(T30/T20 - 1).
Tests validate against closed forms for exponential decays (EDT = T20 =
T30 = T within 1 %; C_te = 10*lg(exp(13.8155*te/T) - 1); D50 =
1 - exp(-0.6908/T); Ts = T/13.8155), the exact C50/D50 relation
(Eq. A.12), double-slope decays (EDT < T20 < T30) and noise-driven
validity-flag behaviour, with tolerances far below the Table A.1 JNDs.
Claude-Session: https://claude.ai/code/session_013kkVt3nxi9svp1an28uHxf
* chore: move figure/diagram generators to scripts/
generate_graphs.py and generate_diagrams.py join benchmark_filters.py
and gen_llms.py in scripts/, where dev tooling already lives. Updated
the Makefile graphs target, the sys.path bootstrap in the graph guard
tests and in generate_graphs.py itself (src/ is now one level up), the
CONTRIBUTING instructions and the theme-images.css pointer. Verified:
module loads from the new location and regenerating the SVG diagrams
produces byte-identical output.
Claude-Session: https://claude.ai/code/session_013kkVt3nxi9svp1an28uHxf
* feat: ISO 3382-3 open-plan office spatial metrics
Add open_plan_metrics() computing the ISO 3382-3:2012 single-number
quantities from a line of workstation measurements: spatial decay rate
D2,S and nominal speech level Lp,A,S,4m (Clause 6.2, Eq.5; 2-16 m
positions on a log-distance regression) and distraction/privacy
distances rD/rP (Clause 6.3; STI-vs-distance linear regression crossing
0,50 and 0,20). Returns a frozen OpenPlanResult; validates the minimum
of four positions (5.2.2) and equal array lengths.
Claude-Session: https://claude.ai/code/session_013kkVt3nxi9svp1an28uHxf
* feat: ISO 16283-1 field insulation and ISO 717-1 weighted ratings
Add phonometry.insulation implementing field airborne sound insulation
(ISO 16283-1:2014) and single-number weighted ratings with C/Ctr
(ISO 717-1):
- airborne_insulation: per-band level difference D (Formula (1)),
standardized level difference DnT = D + 10 lg(T/T0) (Formula (2)) and
apparent sound reduction index R' = D + 10 lg(S/A), A = 0,16 V/T
(Formula (4)/(5)); energy-averages microphone positions (Formula (9)).
- weighted_rating: reference-curve shifting method (Clause 4.4, Table 3)
with the 32,0/10,0 dB unfavourable-deviation bound, plus C/Ctr from the
Table 4 spectra (Clause 4.5). Reference values, spectra and method are
identical in the 2013 and 2020 editions.
- energy_average_level: ISO 16283-1 Formula (9) helper.
Verified against the ISO 717-1 Annex C worked example (Rw(C;Ctr) =
30(-2;-3), unfavourable sum 31,8 dB) and exact-bound / tipping edge
cases. 20 new tests; make check green (484 passed, 12 skipped).
Claude-Session: https://claude.ai/code/session_013kkVt3nxi9svp1an28uHxf
* docs: room & building acoustics guide, theory, API and landing (EN)
New "Room & building acoustics" guide (docs/ + Starlight twin) covering the
full measurement chain: ISO 18233 swept-sine/MLS impulse-response acquisition,
ISO 3382-1/2 decay analysis and room parameters (EDT/T20/T30/C50/C80/D50/Ts),
ISO 3382-3 open-plan speech metrics, and ISO 16283-1 / ISO 717-1 field
insulation with weighted ratings. Adds the matching theory section (Schroeder
integration, regression windows, C/D/Ts, D2,S, DnT/R', reference-curve method),
API-reference rows for all new public names, sidebar entry, README highlight +
docs row, EN landing card, CHANGELOG entries, docs index row, and regenerated
llms-full.txt. All snippets validated; site build and make check green.
Claude-Session: https://claude.ai/code/session_013kkVt3nxi9svp1an28uHxf
* docs: Schroeder, ISO 717-1 rating and insulation-setup figures
Add three room/building-acoustics documentation figure sets (each in
en/es x light/dark):
- schroeder_decay: synthetic IR, Schroeder backward integration with
EDT/T20/T30 regressions and evaluation ranges (ISO 3382); annotated
values match room_parameters.
- insulation_rating: ISO 717-1 Annex C example with shifted reference
curve, unfavourable-deviation shading and Rw read at 500 Hz; Rw, C,
Ctr and the unfavourable sum come from weighted_rating.
- diagram_insulation_setup: ISO 16283-1 airborne setup plan view with
the normative minimum distances (clauses 7.6 and 7.2.2).
Claude-Session: https://claude.ai/code/session_013kkVt3nxi9svp1an28uHxf
* docs: gemelas ES de acústica de salas y edificación
Claude-Session: https://claude.ai/code/session_013kkVt3nxi9svp1an28uHxf
* docs: terminología UNE — ponderación temporal en lugar de balística (ES)
Claude-Session: https://claude.ai/code/session_013kkVt3nxi9svp1an28uHxf
* docs: markdown/README parity with the site + llms guide coverage
Scrub GitHub-unsafe display math (\, thin-spaces and escaped \{ \}) from
docs/intensity.md and docs/psychoacoustics.md — the only two guides that
missed the GitHub-safe math conversion of PRs #78/#79 — matching the safe
forms already used in docs/theory.md. Align calibration's sensitivity
symbol/formula to the site ($S$, single-line \qquad).
Extend scripts/gen_llms.py PAGES with the three omitted guides
(psychoacoustics, intensity, room-acoustics) and regenerate llms.txt /
llms-full.txt so AI-facing artifacts cover all 14 docs pages.
The guides/references were otherwise already in parity (didactic code
comments, theory sections, tables, and figures from PRs #77/#80 all
present); docs/README index and README highlights/table verified complete.
Claude-Session: https://claude.ai/code/session_013kkVt3nxi9svp1an28uHxf
* fix: final-review findings — open_plan validation, limits rename, Farina caveat, MLS averaging test
Claude-Session: https://claude.ai/code/session_013kkVt3nxi9svp1an28uHxf
* docs: ISO 18233 measurement-chain diagram and guide fixes
Claude-Session: https://claude.ai/code/session_013kkVt3nxi9svp1an28uHxf
* docs: fix sweep_signal cross-reference in Farina caveat
Claude-Session: https://claude.ai/code/session_013kkVt3nxi9svp1an28uHxf
* fix: PR 81 review round 1 — inverse-filter guards, truncation threshold, IR input validation, docs pipeline wording
Claude-Session: https://claude.ai/code/session_013kkVt3nxi9svp1an28uHxf
* docs: blank lines around CONTRIBUTING fence (MD031)
Claude-Session: https://claude.ai/code/session_013kkVt3nxi9svp1an28uHxf
Room and building acoustics: ISO 18233, ISO 3382-1/2/3, ISO 16283-1 + ISO 717-1 (#81)
* feat: ISO 18233 sweep/MLS impulse-response acquisition
Add src/phonometry/room_ir.py implementing the ISO 18233:2006
deterministic-excitation IR front end: exponential sine sweep with exact
analytic phase (Annex B), linear spectral-division deconvolution with a
Farina inverse-filter option for harmonic separation (B.5), and
maximum-length-sequence generation (LFSR, orders 2-20) with circular
cross-correlation recovery (Annex A).
Validated against closed forms: known IIR bandpass recovered within 0.1 dB
in band (sweep and MLS), ideal chain to a band-limited delta, +3 dB SNR per
sweep-duration doubling (B.6), and all MLS orders verified as true
maximum-length sequences (autocorrelation L / -1).
433 passed, 12 skipped; ruff, mypy --strict and bandit clean.
Claude-Session: https://claude.ai/code/session_013kkVt3nxi9svp1an28uHxf
* feat: ISO 3382 room acoustic parameters from impulse responses
Add src/phonometry/room_acoustics.py implementing ISO 3382-1:2009 and
ISO 3382-2:2008 analysis of measured impulse responses:
- decay_curve(): Schroeder backward integration of the squared IR
(5.3.3, Eq. 1) with background-noise truncation at the noise/slope
crossing and exponential tail compensation (Eq. 3), broadband or per
IEC 61260 fractional-octave band.
- room_parameters(): per-band EDT (0/-10 dB, A.2.2), T20 (-5/-25 dB)
and T30 (-5/-35 dB) by least-squares fits (ISO 3382-2 Annex C),
clarity C50/C80 (Eq. A.10), definition D50 (Eq. A.11) and centre
time Ts (Eq. A.13), octave bands 125 Hz-4 kHz by default with a
one-third-octave option and a broadband mode.
- Validity flags per the 5.3.3 dynamic-range criterion (noise at least
evaluation range + 15 dB below the IR maximum: 25/35/45 dB) plus the
Annex B curvature indicator C = 100*(T30/T20 - 1).
Tests validate against closed forms for exponential decays (EDT = T20 =
T30 = T within 1 %; C_te = 10*lg(exp(13.8155*te/T) - 1); D50 =
1 - exp(-0.6908/T); Ts = T/13.8155), the exact C50/D50 relation
(Eq. A.12), double-slope decays (EDT < T20 < T30) and noise-driven
validity-flag behaviour, with tolerances far below the Table A.1 JNDs.
Claude-Session: https://claude.ai/code/session_013kkVt3nxi9svp1an28uHxf
* chore: move figure/diagram generators to scripts/
generate_graphs.py and generate_diagrams.py join benchmark_filters.py
and gen_llms.py in scripts/, where dev tooling already lives. Updated
the Makefile graphs target, the sys.path bootstrap in the graph guard
tests and in generate_graphs.py itself (src/ is now one level up), the
CONTRIBUTING instructions and the theme-images.css pointer. Verified:
module loads from the new location and regenerating the SVG diagrams
produces byte-identical output.
Claude-Session: https://claude.ai/code/session_013kkVt3nxi9svp1an28uHxf
* feat: ISO 3382-3 open-plan office spatial metrics
Add open_plan_metrics() computing the ISO 3382-3:2012 single-number
quantities from a line of workstation measurements: spatial decay rate
D2,S and nominal speech level Lp,A,S,4m (Clause 6.2, Eq.5; 2-16 m
positions on a log-distance regression) and distraction/privacy
distances rD/rP (Clause 6.3; STI-vs-distance linear regression crossing
0,50 and 0,20). Returns a frozen OpenPlanResult; validates the minimum
of four positions (5.2.2) and equal array lengths.
Claude-Session: https://claude.ai/code/session_013kkVt3nxi9svp1an28uHxf
* feat: ISO 16283-1 field insulation and ISO 717-1 weighted ratings
Add phonometry.insulation implementing field airborne sound insulation
(ISO 16283-1:2014) and single-number weighted ratings with C/Ctr
(ISO 717-1):
- airborne_insulation: per-band level difference D (Formula (1)),
standardized level difference DnT = D + 10 lg(T/T0) (Formula (2)) and
apparent sound reduction index R' = D + 10 lg(S/A), A = 0,16 V/T
(Formula (4)/(5)); energy-averages microphone positions (Formula (9)).
- weighted_rating: reference-curve shifting method (Clause 4.4, Table 3)
with the 32,0/10,0 dB unfavourable-deviation bound, plus C/Ctr from the
Table 4 spectra (Clause 4.5). Reference values, spectra and method are
identical in the 2013 and 2020 editions.
- energy_average_level: ISO 16283-1 Formula (9) helper.
Verified against the ISO 717-1 Annex C worked example (Rw(C;Ctr) =
30(-2;-3), unfavourable sum 31,8 dB) and exact-bound / tipping edge
cases. 20 new tests; make check green (484 passed, 12 skipped).
Claude-Session: https://claude.ai/code/session_013kkVt3nxi9svp1an28uHxf
* docs: room & building acoustics guide, theory, API and landing (EN)
New "Room & building acoustics" guide (docs/ + Starlight twin) covering the
full measurement chain: ISO 18233 swept-sine/MLS impulse-response acquisition,
ISO 3382-1/2 decay analysis and room parameters (EDT/T20/T30/C50/C80/D50/Ts),
ISO 3382-3 open-plan speech metrics, and ISO 16283-1 / ISO 717-1 field
insulation with weighted ratings. Adds the matching theory section (Schroeder
integration, regression windows, C/D/Ts, D2,S, DnT/R', reference-curve method),
API-reference rows for all new public names, sidebar entry, README highlight +
docs row, EN landing card, CHANGELOG entries, docs index row, and regenerated
llms-full.txt. All snippets validated; site build and make check green.
Claude-Session: https://claude.ai/code/session_013kkVt3nxi9svp1an28uHxf
* docs: Schroeder, ISO 717-1 rating and insulation-setup figures
Add three room/building-acoustics documentation figure sets (each in
en/es x light/dark):
- schroeder_decay: synthetic IR, Schroeder backward integration with
EDT/T20/T30 regressions and evaluation ranges (ISO 3382); annotated
values match room_parameters.
- insulation_rating: ISO 717-1 Annex C example with shifted reference
curve, unfavourable-deviation shading and Rw read at 500 Hz; Rw, C,
Ctr and the unfavourable sum come from weighted_rating.
- diagram_insulation_setup: ISO 16283-1 airborne setup plan view with
the normative minimum distances (clauses 7.6 and 7.2.2).
Claude-Session: https://claude.ai/code/session_013kkVt3nxi9svp1an28uHxf
* docs: gemelas ES de acústica de salas y edificación
Claude-Session: https://claude.ai/code/session_013kkVt3nxi9svp1an28uHxf
* docs: terminología UNE — ponderación temporal en lugar de balística (ES)
Claude-Session: https://claude.ai/code/session_013kkVt3nxi9svp1an28uHxf
* docs: markdown/README parity with the site + llms guide coverage
Scrub GitHub-unsafe display math (\, thin-spaces and escaped \{ \}) from
docs/intensity.md and docs/psychoacoustics.md — the only two guides that
missed the GitHub-safe math conversion of PRs #78/#79 — matching the safe
forms already used in docs/theory.md. Align calibration's sensitivity
symbol/formula to the site ($S$, single-line \qquad).
Extend scripts/gen_llms.py PAGES with the three omitted guides
(psychoacoustics, intensity, room-acoustics) and regenerate llms.txt /
llms-full.txt so AI-facing artifacts cover all 14 docs pages.
The guides/references were otherwise already in parity (didactic code
comments, theory sections, tables, and figures from PRs #77/#80 all
present); docs/README index and README highlights/table verified complete.
Claude-Session: https://claude.ai/code/session_013kkVt3nxi9svp1an28uHxf
* fix: final-review findings — open_plan validation, limits rename, Farina caveat, MLS averaging test
Claude-Session: https://claude.ai/code/session_013kkVt3nxi9svp1an28uHxf
* docs: ISO 18233 measurement-chain diagram and guide fixes
Claude-Session: https://claude.ai/code/session_013kkVt3nxi9svp1an28uHxf
* docs: fix sweep_signal cross-reference in Farina caveat
Claude-Session: https://claude.ai/code/session_013kkVt3nxi9svp1an28uHxf
* fix: PR 81 review round 1 — inverse-filter guards, truncation threshold, IR input validation, docs pipeline wording
Claude-Session: https://claude.ai/code/session_013kkVt3nxi9svp1an28uHxf
* docs: blank lines around CONTRIBUTING fence (MD031)
Claude-Session: https://claude.ai/code/session_013kkVt3nxi9svp1an28uHxf
Spanish docs: UNE terminology, decimal commas, localized snippets and theory figures (#365)
* Normalize Spanish docs prose to UNE acoustic terminology
Sweep the Spanish pages for the non-UNE forms "presion sonora",
"potencia sonora" and "intensidad sonora" and normalize the prose to
the wording used by the official Spanish editions of the standards:
"presion acustica" (UNE-EN ISO 16283-2:2016, UNE-EN ISO 10052:2005,
UNE-EN ISO 3746:2011, UNE-ISO 226:2013), "potencia acustica"
(UNE-EN ISO 3746:2011, UNE-EN ISO 4871:2010, UNE-EN ISO 9614-1:2010),
"intensidad acustica" (UNE-EN 61043:1999, UNE-EN ISO 9614-1:2010) and
"nivel de presion acustica de impactos" (UNE-EN ISO 12354-2:2018,
UNE-EN ISO 717-2:2013). 92 replacements across 32 pages, prose only:
code snippets keep the labels they share with the generated figures.
Rename the intensity guide to "Intensidad acustica (p-p)" and the
structure-borne power guide to "Potencia acustica estructural de
equipos (EN 15657)", updating every cross-link text and the theory
anchor intensidad-sonora-iec-61043 accordingly. The API sidebar group
label becomes "Potencia acustica e intensidad" via api_taxonomy.py
with the generated sidebar regenerated.
* Use decimal commas in Spanish docs prose quantities
Sweep every Spanish page for decimal points leaking into prose numbers
and switch them to the comma the locale convention calls for: the
rotorcraft validation prose (fourteen tolerances such as 0,08 dB(A) and
0,5 s), the insulation-prediction worked example (53,6 dB / 53,8 dB),
the tone-audibility Annex E tone (137,3 Hz), the Mackenzie check value
(1550,744 m/s), the EPNL, loudness and absorption fiche descriptions
(98,3 EPNdB; 8,2 sonos and 70,4 fonios; 0,60 y 0,55), the junction
constants table and the third-octave band-edge table in the signal
analysis theory page. Code snippets, inline code, math, clause numbers
and quoted source text keep their points.
* Pass language="es" in Spanish figure-reproduction snippets
The <details> blocks under each localized figure in the Spanish guides
are meant to reproduce the _es variant shown on the page, but 82 of the
one-line result .plot() calls omitted the language="es" argument and
would render English axis labels instead. Add the argument across 33
guides, matching the pattern the intensity field-indicators snippet
already used. The three lab-insulation results whose plot() does not
take a language argument (lab airborne, lab impact and the
element-normalized intensity difference) are left as they were.
* Extend the UNE terminology sweep to sound absorption
Normalize "absorción sonora" to "absorción acústica" across the
Spanish pages (36 occurrences in 14 pages, including the EN 12354-6
guide title and the theory headings), the wording of UNE-EN ISO
3746:2011 and of the equivalent absorption area in UNE-EN ISO
10140-3:2011, UNE-EN ISO 12354-2:2018 and UNE-EN ISO 16283-2:2016, and
the same term the accredited report strings already use. Also restore
the accent in the theory index anchor to the renamed intensity heading,
since heading slugs keep accented characters.
* Theory pages: illustrate each section family with existing result figures
The seven theory pages carried no figures at all. Embed sixteen of the
existing generated figures (light and dark variants, Spanish variants on
the Spanish mirrors) where the concept matches the prose: weighting
curves, time integration and the p-p intensity estimator in the signal
analysis page; equal-loudness contours, the specific-loudness pattern
and the hearing-threshold panels in perception; NC/RC rating, the
Schroeder decay and the ISO 717-1 shifted reference in rooms and
buildings; the Lden profile, ISO 9613-1 absorption and the three sound
power routes in environment and transport; the scattering coefficient
and ISO 11654 rating in materials and surfaces; and the Wk weighting and
the resonator mobility triplet in vibration. Each embed reuses the alt
text of the guide that owns the figure and adds a one-line caption.
Also give the wave-simulation section hub the reading-order paragraph
its siblings already have, linking the closed-form pages the FDTD solver
cross-checks, in both languages.
* Address review findings from the Spanish locale sweeps
Second pass fixes flagged by review: five terminology occurrences the
line-based sweep missed because the noun and adjective were split by a
line wrap or emphasis markup (sound-power, rotorcraft-noise and two
section hubs); six Spanish pages that still embedded the English figure
variant although the _es variant exists (junction-transmission,
aircraft-noise airport contour, miso-coherence,
objective-intelligibility, psychoacoustic-annoyance twice); and 19 more
language="es" arguments on figure-reproduction plot calls the first
pass missed, chained-call receivers such as room.noise_criterion(spl)
.plot() and the axes-creating first call of the two-profile
atmospheric-refraction snippet among them. The lab-insulation plot
wrappers forward keyword arguments to the rating plot, so the three
calls excluded earlier now take the argument too. All Spanish python
fences re-checked to compile and EN/ES parity re-verified.
* Carry the UNE terminology into the generated-asset Spanish strings
Apply the same evidence-based decisions to every Spanish string source
that feeds generated assets: the translation tables of
generate_graphs.py and generate_diagrams.py, the _STRINGS tables of the
plot modules and the report i18n values. 35 strings change: "presión
acústica" (UNE-EN ISO 16283-2:2016, 10052:2005, 3746:2011),
"potencia acústica" (UNE-EN ISO 3746:2011, 4871:2010, 9614-1:2010),
"intensidad acústica" (UNE-EN 61043:1999, 9614-1:2010), "absorción
acústica" (UNE-EN ISO 3746:2011) and "nivel de presión acústica de
impactos" (UNE-EN ISO 12354-2:2018). Strings the UNE editions keep are
untouched: "emisión sonora", "exposición sonora", "campo sonoro",
"fuente sonora". Only Spanish values change; the English keys stay.
The two plot-i18n test assertions that pin the axis label follow, and
the eight Spanish doc fences that deliberately mirrored the old figure
labels now mirror the new ones.
* Regenerate the Spanish figure variants with the UNE terminology
make graphs after the string-source change: 48 files, all of them _es
or _es_dark variants (24 figure/diagram pairs), picking up "presión
acústica", "potencia acústica", "intensidad acústica", "absorción
acústica" and "nivel de presión acústica de impactos" in titles and
axis labels. The English variants are untouched. The committed example
fiches need no regeneration: every example in generate_reports.py
renders in English, so no changed Spanish report string reaches them.
* Align the intensity-fiche Spanish assertions with the UNE terminology
Spanish docs: UNE terminology, decimal commas, localized snippets and theory figures (#365)
* Normalize Spanish docs prose to UNE acoustic terminology
Sweep the Spanish pages for the non-UNE forms "presion sonora",
"potencia sonora" and "intensidad sonora" and normalize the prose to
the wording used by the official Spanish editions of the standards:
"presion acustica" (UNE-EN ISO 16283-2:2016, UNE-EN ISO 10052:2005,
UNE-EN ISO 3746:2011, UNE-ISO 226:2013), "potencia acustica"
(UNE-EN ISO 3746:2011, UNE-EN ISO 4871:2010, UNE-EN ISO 9614-1:2010),
"intensidad acustica" (UNE-EN 61043:1999, UNE-EN ISO 9614-1:2010) and
"nivel de presion acustica de impactos" (UNE-EN ISO 12354-2:2018,
UNE-EN ISO 717-2:2013). 92 replacements across 32 pages, prose only:
code snippets keep the labels they share with the generated figures.
Rename the intensity guide to "Intensidad acustica (p-p)" and the
structure-borne power guide to "Potencia acustica estructural de
equipos (EN 15657)", updating every cross-link text and the theory
anchor intensidad-sonora-iec-61043 accordingly. The API sidebar group
label becomes "Potencia acustica e intensidad" via api_taxonomy.py
with the generated sidebar regenerated.
* Use decimal commas in Spanish docs prose quantities
Sweep every Spanish page for decimal points leaking into prose numbers
and switch them to the comma the locale convention calls for: the
rotorcraft validation prose (fourteen tolerances such as 0,08 dB(A) and
0,5 s), the insulation-prediction worked example (53,6 dB / 53,8 dB),
the tone-audibility Annex E tone (137,3 Hz), the Mackenzie check value
(1550,744 m/s), the EPNL, loudness and absorption fiche descriptions
(98,3 EPNdB; 8,2 sonos and 70,4 fonios; 0,60 y 0,55), the junction
constants table and the third-octave band-edge table in the signal
analysis theory page. Code snippets, inline code, math, clause numbers
and quoted source text keep their points.
* Pass language="es" in Spanish figure-reproduction snippets
The <details> blocks under each localized figure in the Spanish guides
are meant to reproduce the _es variant shown on the page, but 82 of the
one-line result .plot() calls omitted the language="es" argument and
would render English axis labels instead. Add the argument across 33
guides, matching the pattern the intensity field-indicators snippet
already used. The three lab-insulation results whose plot() does not
take a language argument (lab airborne, lab impact and the
element-normalized intensity difference) are left as they were.
* Extend the UNE terminology sweep to sound absorption
Normalize "absorción sonora" to "absorción acústica" across the
Spanish pages (36 occurrences in 14 pages, including the EN 12354-6
guide title and the theory headings), the wording of UNE-EN ISO
3746:2011 and of the equivalent absorption area in UNE-EN ISO
10140-3:2011, UNE-EN ISO 12354-2:2018 and UNE-EN ISO 16283-2:2016, and
the same term the accredited report strings already use. Also restore
the accent in the theory index anchor to the renamed intensity heading,
since heading slugs keep accented characters.
* Theory pages: illustrate each section family with existing result figures
The seven theory pages carried no figures at all. Embed sixteen of the
existing generated figures (light and dark variants, Spanish variants on
the Spanish mirrors) where the concept matches the prose: weighting
curves, time integration and the p-p intensity estimator in the signal
analysis page; equal-loudness contours, the specific-loudness pattern
and the hearing-threshold panels in perception; NC/RC rating, the
Schroeder decay and the ISO 717-1 shifted reference in rooms and
buildings; the Lden profile, ISO 9613-1 absorption and the three sound
power routes in environment and transport; the scattering coefficient
and ISO 11654 rating in materials and surfaces; and the Wk weighting and
the resonator mobility triplet in vibration. Each embed reuses the alt
text of the guide that owns the figure and adds a one-line caption.
Also give the wave-simulation section hub the reading-order paragraph
its siblings already have, linking the closed-form pages the FDTD solver
cross-checks, in both languages.
* Address review findings from the Spanish locale sweeps
Second pass fixes flagged by review: five terminology occurrences the
line-based sweep missed because the noun and adjective were split by a
line wrap or emphasis markup (sound-power, rotorcraft-noise and two
section hubs); six Spanish pages that still embedded the English figure
variant although the _es variant exists (junction-transmission,
aircraft-noise airport contour, miso-coherence,
objective-intelligibility, psychoacoustic-annoyance twice); and 19 more
language="es" arguments on figure-reproduction plot calls the first
pass missed, chained-call receivers such as room.noise_criterion(spl)
.plot() and the axes-creating first call of the two-profile
atmospheric-refraction snippet among them. The lab-insulation plot
wrappers forward keyword arguments to the rating plot, so the three
calls excluded earlier now take the argument too. All Spanish python
fences re-checked to compile and EN/ES parity re-verified.
* Carry the UNE terminology into the generated-asset Spanish strings
Apply the same evidence-based decisions to every Spanish string source
that feeds generated assets: the translation tables of
generate_graphs.py and generate_diagrams.py, the _STRINGS tables of the
plot modules and the report i18n values. 35 strings change: "presión
acústica" (UNE-EN ISO 16283-2:2016, 10052:2005, 3746:2011),
"potencia acústica" (UNE-EN ISO 3746:2011, 4871:2010, 9614-1:2010),
"intensidad acústica" (UNE-EN 61043:1999, 9614-1:2010), "absorción
acústica" (UNE-EN ISO 3746:2011) and "nivel de presión acústica de
impactos" (UNE-EN ISO 12354-2:2018). Strings the UNE editions keep are
untouched: "emisión sonora", "exposición sonora", "campo sonoro",
"fuente sonora". Only Spanish values change; the English keys stay.
The two plot-i18n test assertions that pin the axis label follow, and
the eight Spanish doc fences that deliberately mirrored the old figure
labels now mirror the new ones.
* Regenerate the Spanish figure variants with the UNE terminology
make graphs after the string-source change: 48 files, all of them _es
or _es_dark variants (24 figure/diagram pairs), picking up "presión
acústica", "potencia acústica", "intensidad acústica", "absorción
acústica" and "nivel de presión acústica de impactos" in titles and
axis labels. The English variants are untouched. The committed example
fiches need no regeneration: every example in generate_reports.py
renders in English, so no changed Spanish report string reaches them.
* Align the intensity-fiche Spanish assertions with the UNE terminology
Room and building acoustics: ISO 18233, ISO 3382-1/2/3, ISO 16283-1 + ISO 717-1 (#81)
* feat: ISO 18233 sweep/MLS impulse-response acquisition
Add src/phonometry/room_ir.py implementing the ISO 18233:2006
deterministic-excitation IR front end: exponential sine sweep with exact
analytic phase (Annex B), linear spectral-division deconvolution with a
Farina inverse-filter option for harmonic separation (B.5), and
maximum-length-sequence generation (LFSR, orders 2-20) with circular
cross-correlation recovery (Annex A).
Validated against closed forms: known IIR bandpass recovered within 0.1 dB
in band (sweep and MLS), ideal chain to a band-limited delta, +3 dB SNR per
sweep-duration doubling (B.6), and all MLS orders verified as true
maximum-length sequences (autocorrelation L / -1).
433 passed, 12 skipped; ruff, mypy --strict and bandit clean.
Claude-Session: https://claude.ai/code/session_013kkVt3nxi9svp1an28uHxf
* feat: ISO 3382 room acoustic parameters from impulse responses
Add src/phonometry/room_acoustics.py implementing ISO 3382-1:2009 and
ISO 3382-2:2008 analysis of measured impulse responses:
- decay_curve(): Schroeder backward integration of the squared IR
(5.3.3, Eq. 1) with background-noise truncation at the noise/slope
crossing and exponential tail compensation (Eq. 3), broadband or per
IEC 61260 fractional-octave band.
- room_parameters(): per-band EDT (0/-10 dB, A.2.2), T20 (-5/-25 dB)
and T30 (-5/-35 dB) by least-squares fits (ISO 3382-2 Annex C),
clarity C50/C80 (Eq. A.10), definition D50 (Eq. A.11) and centre
time Ts (Eq. A.13), octave bands 125 Hz-4 kHz by default with a
one-third-octave option and a broadband mode.
- Validity flags per the 5.3.3 dynamic-range criterion (noise at least
evaluation range + 15 dB below the IR maximum: 25/35/45 dB) plus the
Annex B curvature indicator C = 100*(T30/T20 - 1).
Tests validate against closed forms for exponential decays (EDT = T20 =
T30 = T within 1 %; C_te = 10*lg(exp(13.8155*te/T) - 1); D50 =
1 - exp(-0.6908/T); Ts = T/13.8155), the exact C50/D50 relation
(Eq. A.12), double-slope decays (EDT < T20 < T30) and noise-driven
validity-flag behaviour, with tolerances far below the Table A.1 JNDs.
Claude-Session: https://claude.ai/code/session_013kkVt3nxi9svp1an28uHxf
* chore: move figure/diagram generators to scripts/
generate_graphs.py and generate_diagrams.py join benchmark_filters.py
and gen_llms.py in scripts/, where dev tooling already lives. Updated
the Makefile graphs target, the sys.path bootstrap in the graph guard
tests and in generate_graphs.py itself (src/ is now one level up), the
CONTRIBUTING instructions and the theme-images.css pointer. Verified:
module loads from the new location and regenerating the SVG diagrams
produces byte-identical output.
Claude-Session: https://claude.ai/code/session_013kkVt3nxi9svp1an28uHxf
* feat: ISO 3382-3 open-plan office spatial metrics
Add open_plan_metrics() computing the ISO 3382-3:2012 single-number
quantities from a line of workstation measurements: spatial decay rate
D2,S and nominal speech level Lp,A,S,4m (Clause 6.2, Eq.5; 2-16 m
positions on a log-distance regression) and distraction/privacy
distances rD/rP (Clause 6.3; STI-vs-distance linear regression crossing
0,50 and 0,20). Returns a frozen OpenPlanResult; validates the minimum
of four positions (5.2.2) and equal array lengths.
Claude-Session: https://claude.ai/code/session_013kkVt3nxi9svp1an28uHxf
* feat: ISO 16283-1 field insulation and ISO 717-1 weighted ratings
Add phonometry.insulation implementing field airborne sound insulation
(ISO 16283-1:2014) and single-number weighted ratings with C/Ctr
(ISO 717-1):
- airborne_insulation: per-band level difference D (Formula (1)),
standardized level difference DnT = D + 10 lg(T/T0) (Formula (2)) and
apparent sound reduction index R' = D + 10 lg(S/A), A = 0,16 V/T
(Formula (4)/(5)); energy-averages microphone positions (Formula (9)).
- weighted_rating: reference-curve shifting method (Clause 4.4, Table 3)
with the 32,0/10,0 dB unfavourable-deviation bound, plus C/Ctr from the
Table 4 spectra (Clause 4.5). Reference values, spectra and method are
identical in the 2013 and 2020 editions.
- energy_average_level: ISO 16283-1 Formula (9) helper.
Verified against the ISO 717-1 Annex C worked example (Rw(C;Ctr) =
30(-2;-3), unfavourable sum 31,8 dB) and exact-bound / tipping edge
cases. 20 new tests; make check green (484 passed, 12 skipped).
Claude-Session: https://claude.ai/code/session_013kkVt3nxi9svp1an28uHxf
* docs: room & building acoustics guide, theory, API and landing (EN)
New "Room & building acoustics" guide (docs/ + Starlight twin) covering the
full measurement chain: ISO 18233 swept-sine/MLS impulse-response acquisition,
ISO 3382-1/2 decay analysis and room parameters (EDT/T20/T30/C50/C80/D50/Ts),
ISO 3382-3 open-plan speech metrics, and ISO 16283-1 / ISO 717-1 field
insulation with weighted ratings. Adds the matching theory section (Schroeder
integration, regression windows, C/D/Ts, D2,S, DnT/R', reference-curve method),
API-reference rows for all new public names, sidebar entry, README highlight +
docs row, EN landing card, CHANGELOG entries, docs index row, and regenerated
llms-full.txt. All snippets validated; site build and make check green.
Claude-Session: https://claude.ai/code/session_013kkVt3nxi9svp1an28uHxf
* docs: Schroeder, ISO 717-1 rating and insulation-setup figures
Add three room/building-acoustics documentation figure sets (each in
en/es x light/dark):
- schroeder_decay: synthetic IR, Schroeder backward integration with
EDT/T20/T30 regressions and evaluation ranges (ISO 3382); annotated
values match room_parameters.
- insulation_rating: ISO 717-1 Annex C example with shifted reference
curve, unfavourable-deviation shading and Rw read at 500 Hz; Rw, C,
Ctr and the unfavourable sum come from weighted_rating.
- diagram_insulation_setup: ISO 16283-1 airborne setup plan view with
the normative minimum distances (clauses 7.6 and 7.2.2).
Claude-Session: https://claude.ai/code/session_013kkVt3nxi9svp1an28uHxf
* docs: gemelas ES de acústica de salas y edificación
Claude-Session: https://claude.ai/code/session_013kkVt3nxi9svp1an28uHxf
* docs: terminología UNE — ponderación temporal en lugar de balística (ES)
Claude-Session: https://claude.ai/code/session_013kkVt3nxi9svp1an28uHxf
* docs: markdown/README parity with the site + llms guide coverage
Scrub GitHub-unsafe display math (\, thin-spaces and escaped \{ \}) from
docs/intensity.md and docs/psychoacoustics.md — the only two guides that
missed the GitHub-safe math conversion of PRs #78/#79 — matching the safe
forms already used in docs/theory.md. Align calibration's sensitivity
symbol/formula to the site ($S$, single-line \qquad).
Extend scripts/gen_llms.py PAGES with the three omitted guides
(psychoacoustics, intensity, room-acoustics) and regenerate llms.txt /
llms-full.txt so AI-facing artifacts cover all 14 docs pages.
The guides/references were otherwise already in parity (didactic code
comments, theory sections, tables, and figures from PRs #77/#80 all
present); docs/README index and README highlights/table verified complete.
Claude-Session: https://claude.ai/code/session_013kkVt3nxi9svp1an28uHxf
* fix: final-review findings — open_plan validation, limits rename, Farina caveat, MLS averaging test
Claude-Session: https://claude.ai/code/session_013kkVt3nxi9svp1an28uHxf
* docs: ISO 18233 measurement-chain diagram and guide fixes
Claude-Session: https://claude.ai/code/session_013kkVt3nxi9svp1an28uHxf
* docs: fix sweep_signal cross-reference in Farina caveat
Claude-Session: https://claude.ai/code/session_013kkVt3nxi9svp1an28uHxf
* fix: PR 81 review round 1 — inverse-filter guards, truncation threshold, IR input validation, docs pipeline wording
Claude-Session: https://claude.ai/code/session_013kkVt3nxi9svp1an28uHxf
* docs: blank lines around CONTRIBUTING fence (MD031)
Claude-Session: https://claude.ai/code/session_013kkVt3nxi9svp1an28uHxf
Room and building acoustics: ISO 18233, ISO 3382-1/2/3, ISO 16283-1 + ISO 717-1 (#81)
* feat: ISO 18233 sweep/MLS impulse-response acquisition
Add src/phonometry/room_ir.py implementing the ISO 18233:2006
deterministic-excitation IR front end: exponential sine sweep with exact
analytic phase (Annex B), linear spectral-division deconvolution with a
Farina inverse-filter option for harmonic separation (B.5), and
maximum-length-sequence generation (LFSR, orders 2-20) with circular
cross-correlation recovery (Annex A).
Validated against closed forms: known IIR bandpass recovered within 0.1 dB
in band (sweep and MLS), ideal chain to a band-limited delta, +3 dB SNR per
sweep-duration doubling (B.6), and all MLS orders verified as true
maximum-length sequences (autocorrelation L / -1).
433 passed, 12 skipped; ruff, mypy --strict and bandit clean.
Claude-Session: https://claude.ai/code/session_013kkVt3nxi9svp1an28uHxf
* feat: ISO 3382 room acoustic parameters from impulse responses
Add src/phonometry/room_acoustics.py implementing ISO 3382-1:2009 and
ISO 3382-2:2008 analysis of measured impulse responses:
- decay_curve(): Schroeder backward integration of the squared IR
(5.3.3, Eq. 1) with background-noise truncation at the noise/slope
crossing and exponential tail compensation (Eq. 3), broadband or per
IEC 61260 fractional-octave band.
- room_parameters(): per-band EDT (0/-10 dB, A.2.2), T20 (-5/-25 dB)
and T30 (-5/-35 dB) by least-squares fits (ISO 3382-2 Annex C),
clarity C50/C80 (Eq. A.10), definition D50 (Eq. A.11) and centre
time Ts (Eq. A.13), octave bands 125 Hz-4 kHz by default with a
one-third-octave option and a broadband mode.
- Validity flags per the 5.3.3 dynamic-range criterion (noise at least
evaluation range + 15 dB below the IR maximum: 25/35/45 dB) plus the
Annex B curvature indicator C = 100*(T30/T20 - 1).
Tests validate against closed forms for exponential decays (EDT = T20 =
T30 = T within 1 %; C_te = 10*lg(exp(13.8155*te/T) - 1); D50 =
1 - exp(-0.6908/T); Ts = T/13.8155), the exact C50/D50 relation
(Eq. A.12), double-slope decays (EDT < T20 < T30) and noise-driven
validity-flag behaviour, with tolerances far below the Table A.1 JNDs.
Claude-Session: https://claude.ai/code/session_013kkVt3nxi9svp1an28uHxf
* chore: move figure/diagram generators to scripts/
generate_graphs.py and generate_diagrams.py join benchmark_filters.py
and gen_llms.py in scripts/, where dev tooling already lives. Updated
the Makefile graphs target, the sys.path bootstrap in the graph guard
tests and in generate_graphs.py itself (src/ is now one level up), the
CONTRIBUTING instructions and the theme-images.css pointer. Verified:
module loads from the new location and regenerating the SVG diagrams
produces byte-identical output.
Claude-Session: https://claude.ai/code/session_013kkVt3nxi9svp1an28uHxf
* feat: ISO 3382-3 open-plan office spatial metrics
Add open_plan_metrics() computing the ISO 3382-3:2012 single-number
quantities from a line of workstation measurements: spatial decay rate
D2,S and nominal speech level Lp,A,S,4m (Clause 6.2, Eq.5; 2-16 m
positions on a log-distance regression) and distraction/privacy
distances rD/rP (Clause 6.3; STI-vs-distance linear regression crossing
0,50 and 0,20). Returns a frozen OpenPlanResult; validates the minimum
of four positions (5.2.2) and equal array lengths.
Claude-Session: https://claude.ai/code/session_013kkVt3nxi9svp1an28uHxf
* feat: ISO 16283-1 field insulation and ISO 717-1 weighted ratings
Add phonometry.insulation implementing field airborne sound insulation
(ISO 16283-1:2014) and single-number weighted ratings with C/Ctr
(ISO 717-1):
- airborne_insulation: per-band level difference D (Formula (1)),
standardized level difference DnT = D + 10 lg(T/T0) (Formula (2)) and
apparent sound reduction index R' = D + 10 lg(S/A), A = 0,16 V/T
(Formula (4)/(5)); energy-averages microphone positions (Formula (9)).
- weighted_rating: reference-curve shifting method (Clause 4.4, Table 3)
with the 32,0/10,0 dB unfavourable-deviation bound, plus C/Ctr from the
Table 4 spectra (Clause 4.5). Reference values, spectra and method are
identical in the 2013 and 2020 editions.
- energy_average_level: ISO 16283-1 Formula (9) helper.
Verified against the ISO 717-1 Annex C worked example (Rw(C;Ctr) =
30(-2;-3), unfavourable sum 31,8 dB) and exact-bound / tipping edge
cases. 20 new tests; make check green (484 passed, 12 skipped).
Claude-Session: https://claude.ai/code/session_013kkVt3nxi9svp1an28uHxf
* docs: room & building acoustics guide, theory, API and landing (EN)
New "Room & building acoustics" guide (docs/ + Starlight twin) covering the
full measurement chain: ISO 18233 swept-sine/MLS impulse-response acquisition,
ISO 3382-1/2 decay analysis and room parameters (EDT/T20/T30/C50/C80/D50/Ts),
ISO 3382-3 open-plan speech metrics, and ISO 16283-1 / ISO 717-1 field
insulation with weighted ratings. Adds the matching theory section (Schroeder
integration, regression windows, C/D/Ts, D2,S, DnT/R', reference-curve method),
API-reference rows for all new public names, sidebar entry, README highlight +
docs row, EN landing card, CHANGELOG entries, docs index row, and regenerated
llms-full.txt. All snippets validated; site build and make check green.
Claude-Session: https://claude.ai/code/session_013kkVt3nxi9svp1an28uHxf
* docs: Schroeder, ISO 717-1 rating and insulation-setup figures
Add three room/building-acoustics documentation figure sets (each in
en/es x light/dark):
- schroeder_decay: synthetic IR, Schroeder backward integration with
EDT/T20/T30 regressions and evaluation ranges (ISO 3382); annotated
values match room_parameters.
- insulation_rating: ISO 717-1 Annex C example with shifted reference
curve, unfavourable-deviation shading and Rw read at 500 Hz; Rw, C,
Ctr and the unfavourable sum come from weighted_rating.
- diagram_insulation_setup: ISO 16283-1 airborne setup plan view with
the normative minimum distances (clauses 7.6 and 7.2.2).
Claude-Session: https://claude.ai/code/session_013kkVt3nxi9svp1an28uHxf
* docs: gemelas ES de acústica de salas y edificación
Claude-Session: https://claude.ai/code/session_013kkVt3nxi9svp1an28uHxf
* docs: terminología UNE — ponderación temporal en lugar de balística (ES)
Claude-Session: https://claude.ai/code/session_013kkVt3nxi9svp1an28uHxf
* docs: markdown/README parity with the site + llms guide coverage
Scrub GitHub-unsafe display math (\, thin-spaces and escaped \{ \}) from
docs/intensity.md and docs/psychoacoustics.md — the only two guides that
missed the GitHub-safe math conversion of PRs #78/#79 — matching the safe
forms already used in docs/theory.md. Align calibration's sensitivity
symbol/formula to the site ($S$, single-line \qquad).
Extend scripts/gen_llms.py PAGES with the three omitted guides
(psychoacoustics, intensity, room-acoustics) and regenerate llms.txt /
llms-full.txt so AI-facing artifacts cover all 14 docs pages.
The guides/references were otherwise already in parity (didactic code
comments, theory sections, tables, and figures from PRs #77/#80 all
present); docs/README index and README highlights/table verified complete.
Claude-Session: https://claude.ai/code/session_013kkVt3nxi9svp1an28uHxf
* fix: final-review findings — open_plan validation, limits rename, Farina caveat, MLS averaging test
Claude-Session: https://claude.ai/code/session_013kkVt3nxi9svp1an28uHxf
* docs: ISO 18233 measurement-chain diagram and guide fixes
Claude-Session: https://claude.ai/code/session_013kkVt3nxi9svp1an28uHxf
* docs: fix sweep_signal cross-reference in Farina caveat
Claude-Session: https://claude.ai/code/session_013kkVt3nxi9svp1an28uHxf
* fix: PR 81 review round 1 — inverse-filter guards, truncation threshold, IR input validation, docs pipeline wording
Claude-Session: https://claude.ai/code/session_013kkVt3nxi9svp1an28uHxf
* docs: blank lines around CONTRIBUTING fence (MD031)
Claude-Session: https://claude.ai/code/session_013kkVt3nxi9svp1an28uHxf
Room and building acoustics: ISO 18233, ISO 3382-1/2/3, ISO 16283-1 + ISO 717-1 (#81)
* feat: ISO 18233 sweep/MLS impulse-response acquisition
Add src/phonometry/room_ir.py implementing the ISO 18233:2006
deterministic-excitation IR front end: exponential sine sweep with exact
analytic phase (Annex B), linear spectral-division deconvolution with a
Farina inverse-filter option for harmonic separation (B.5), and
maximum-length-sequence generation (LFSR, orders 2-20) with circular
cross-correlation recovery (Annex A).
Validated against closed forms: known IIR bandpass recovered within 0.1 dB
in band (sweep and MLS), ideal chain to a band-limited delta, +3 dB SNR per
sweep-duration doubling (B.6), and all MLS orders verified as true
maximum-length sequences (autocorrelation L / -1).
433 passed, 12 skipped; ruff, mypy --strict and bandit clean.
Claude-Session: https://claude.ai/code/session_013kkVt3nxi9svp1an28uHxf
* feat: ISO 3382 room acoustic parameters from impulse responses
Add src/phonometry/room_acoustics.py implementing ISO 3382-1:2009 and
ISO 3382-2:2008 analysis of measured impulse responses:
- decay_curve(): Schroeder backward integration of the squared IR
(5.3.3, Eq. 1) with background-noise truncation at the noise/slope
crossing and exponential tail compensation (Eq. 3), broadband or per
IEC 61260 fractional-octave band.
- room_parameters(): per-band EDT (0/-10 dB, A.2.2), T20 (-5/-25 dB)
and T30 (-5/-35 dB) by least-squares fits (ISO 3382-2 Annex C),
clarity C50/C80 (Eq. A.10), definition D50 (Eq. A.11) and centre
time Ts (Eq. A.13), octave bands 125 Hz-4 kHz by default with a
one-third-octave option and a broadband mode.
- Validity flags per the 5.3.3 dynamic-range criterion (noise at least
evaluation range + 15 dB below the IR maximum: 25/35/45 dB) plus the
Annex B curvature indicator C = 100*(T30/T20 - 1).
Tests validate against closed forms for exponential decays (EDT = T20 =
T30 = T within 1 %; C_te = 10*lg(exp(13.8155*te/T) - 1); D50 =
1 - exp(-0.6908/T); Ts = T/13.8155), the exact C50/D50 relation
(Eq. A.12), double-slope decays (EDT < T20 < T30) and noise-driven
validity-flag behaviour, with tolerances far below the Table A.1 JNDs.
Claude-Session: https://claude.ai/code/session_013kkVt3nxi9svp1an28uHxf
* chore: move figure/diagram generators to scripts/
generate_graphs.py and generate_diagrams.py join benchmark_filters.py
and gen_llms.py in scripts/, where dev tooling already lives. Updated
the Makefile graphs target, the sys.path bootstrap in the graph guard
tests and in generate_graphs.py itself (src/ is now one level up), the
CONTRIBUTING instructions and the theme-images.css pointer. Verified:
module loads from the new location and regenerating the SVG diagrams
produces byte-identical output.
Claude-Session: https://claude.ai/code/session_013kkVt3nxi9svp1an28uHxf
* feat: ISO 3382-3 open-plan office spatial metrics
Add open_plan_metrics() computing the ISO 3382-3:2012 single-number
quantities from a line of workstation measurements: spatial decay rate
D2,S and nominal speech level Lp,A,S,4m (Clause 6.2, Eq.5; 2-16 m
positions on a log-distance regression) and distraction/privacy
distances rD/rP (Clause 6.3; STI-vs-distance linear regression crossing
0,50 and 0,20). Returns a frozen OpenPlanResult; validates the minimum
of four positions (5.2.2) and equal array lengths.
Claude-Session: https://claude.ai/code/session_013kkVt3nxi9svp1an28uHxf
* feat: ISO 16283-1 field insulation and ISO 717-1 weighted ratings
Add phonometry.insulation implementing field airborne sound insulation
(ISO 16283-1:2014) and single-number weighted ratings with C/Ctr
(ISO 717-1):
- airborne_insulation: per-band level difference D (Formula (1)),
standardized level difference DnT = D + 10 lg(T/T0) (Formula (2)) and
apparent sound reduction index R' = D + 10 lg(S/A), A = 0,16 V/T
(Formula (4)/(5)); energy-averages microphone positions (Formula (9)).
- weighted_rating: reference-curve shifting method (Clause 4.4, Table 3)
with the 32,0/10,0 dB unfavourable-deviation bound, plus C/Ctr from the
Table 4 spectra (Clause 4.5). Reference values, spectra and method are
identical in the 2013 and 2020 editions.
- energy_average_level: ISO 16283-1 Formula (9) helper.
Verified against the ISO 717-1 Annex C worked example (Rw(C;Ctr) =
30(-2;-3), unfavourable sum 31,8 dB) and exact-bound / tipping edge
cases. 20 new tests; make check green (484 passed, 12 skipped).
Claude-Session: https://claude.ai/code/session_013kkVt3nxi9svp1an28uHxf
* docs: room & building acoustics guide, theory, API and landing (EN)
New "Room & building acoustics" guide (docs/ + Starlight twin) covering the
full measurement chain: ISO 18233 swept-sine/MLS impulse-response acquisition,
ISO 3382-1/2 decay analysis and room parameters (EDT/T20/T30/C50/C80/D50/Ts),
ISO 3382-3 open-plan speech metrics, and ISO 16283-1 / ISO 717-1 field
insulation with weighted ratings. Adds the matching theory section (Schroeder
integration, regression windows, C/D/Ts, D2,S, DnT/R', reference-curve method),
API-reference rows for all new public names, sidebar entry, README highlight +
docs row, EN landing card, CHANGELOG entries, docs index row, and regenerated
llms-full.txt. All snippets validated; site build and make check green.
Claude-Session: https://claude.ai/code/session_013kkVt3nxi9svp1an28uHxf
* docs: Schroeder, ISO 717-1 rating and insulation-setup figures
Add three room/building-acoustics documentation figure sets (each in
en/es x light/dark):
- schroeder_decay: synthetic IR, Schroeder backward integration with
EDT/T20/T30 regressions and evaluation ranges (ISO 3382); annotated
values match room_parameters.
- insulation_rating: ISO 717-1 Annex C example with shifted reference
curve, unfavourable-deviation shading and Rw read at 500 Hz; Rw, C,
Ctr and the unfavourable sum come from weighted_rating.
- diagram_insulation_setup: ISO 16283-1 airborne setup plan view with
the normative minimum distances (clauses 7.6 and 7.2.2).
Claude-Session: https://claude.ai/code/session_013kkVt3nxi9svp1an28uHxf
* docs: gemelas ES de acústica de salas y edificación
Claude-Session: https://claude.ai/code/session_013kkVt3nxi9svp1an28uHxf
* docs: terminología UNE — ponderación temporal en lugar de balística (ES)
Claude-Session: https://claude.ai/code/session_013kkVt3nxi9svp1an28uHxf
* docs: markdown/README parity with the site + llms guide coverage
Scrub GitHub-unsafe display math (\, thin-spaces and escaped \{ \}) from
docs/intensity.md and docs/psychoacoustics.md — the only two guides that
missed the GitHub-safe math conversion of PRs #78/#79 — matching the safe
forms already used in docs/theory.md. Align calibration's sensitivity
symbol/formula to the site ($S$, single-line \qquad).
Extend scripts/gen_llms.py PAGES with the three omitted guides
(psychoacoustics, intensity, room-acoustics) and regenerate llms.txt /
llms-full.txt so AI-facing artifacts cover all 14 docs pages.
The guides/references were otherwise already in parity (didactic code
comments, theory sections, tables, and figures from PRs #77/#80 all
present); docs/README index and README highlights/table verified complete.
Claude-Session: https://claude.ai/code/session_013kkVt3nxi9svp1an28uHxf
* fix: final-review findings — open_plan validation, limits rename, Farina caveat, MLS averaging test
Claude-Session: https://claude.ai/code/session_013kkVt3nxi9svp1an28uHxf
* docs: ISO 18233 measurement-chain diagram and guide fixes
Claude-Session: https://claude.ai/code/session_013kkVt3nxi9svp1an28uHxf
* docs: fix sweep_signal cross-reference in Farina caveat
Claude-Session: https://claude.ai/code/session_013kkVt3nxi9svp1an28uHxf
* fix: PR 81 review round 1 — inverse-filter guards, truncation threshold, IR input validation, docs pipeline wording
Claude-Session: https://claude.ai/code/session_013kkVt3nxi9svp1an28uHxf
* docs: blank lines around CONTRIBUTING fence (MD031)
Claude-Session: https://claude.ai/code/session_013kkVt3nxi9svp1an28uHxf
Room and building acoustics: ISO 18233, ISO 3382-1/2/3, ISO 16283-1 + ISO 717-1 (#81)
* feat: ISO 18233 sweep/MLS impulse-response acquisition
Add src/phonometry/room_ir.py implementing the ISO 18233:2006
deterministic-excitation IR front end: exponential sine sweep with exact
analytic phase (Annex B), linear spectral-division deconvolution with a
Farina inverse-filter option for harmonic separation (B.5), and
maximum-length-sequence generation (LFSR, orders 2-20) with circular
cross-correlation recovery (Annex A).
Validated against closed forms: known IIR bandpass recovered within 0.1 dB
in band (sweep and MLS), ideal chain to a band-limited delta, +3 dB SNR per
sweep-duration doubling (B.6), and all MLS orders verified as true
maximum-length sequences (autocorrelation L / -1).
433 passed, 12 skipped; ruff, mypy --strict and bandit clean.
Claude-Session: https://claude.ai/code/session_013kkVt3nxi9svp1an28uHxf
* feat: ISO 3382 room acoustic parameters from impulse responses
Add src/phonometry/room_acoustics.py implementing ISO 3382-1:2009 and
ISO 3382-2:2008 analysis of measured impulse responses:
- decay_curve(): Schroeder backward integration of the squared IR
(5.3.3, Eq. 1) with background-noise truncation at the noise/slope
crossing and exponential tail compensation (Eq. 3), broadband or per
IEC 61260 fractional-octave band.
- room_parameters(): per-band EDT (0/-10 dB, A.2.2), T20 (-5/-25 dB)
and T30 (-5/-35 dB) by least-squares fits (ISO 3382-2 Annex C),
clarity C50/C80 (Eq. A.10), definition D50 (Eq. A.11) and centre
time Ts (Eq. A.13), octave bands 125 Hz-4 kHz by default with a
one-third-octave option and a broadband mode.
- Validity flags per the 5.3.3 dynamic-range criterion (noise at least
evaluation range + 15 dB below the IR maximum: 25/35/45 dB) plus the
Annex B curvature indicator C = 100*(T30/T20 - 1).
Tests validate against closed forms for exponential decays (EDT = T20 =
T30 = T within 1 %; C_te = 10*lg(exp(13.8155*te/T) - 1); D50 =
1 - exp(-0.6908/T); Ts = T/13.8155), the exact C50/D50 relation
(Eq. A.12), double-slope decays (EDT < T20 < T30) and noise-driven
validity-flag behaviour, with tolerances far below the Table A.1 JNDs.
Claude-Session: https://claude.ai/code/session_013kkVt3nxi9svp1an28uHxf
* chore: move figure/diagram generators to scripts/
generate_graphs.py and generate_diagrams.py join benchmark_filters.py
and gen_llms.py in scripts/, where dev tooling already lives. Updated
the Makefile graphs target, the sys.path bootstrap in the graph guard
tests and in generate_graphs.py itself (src/ is now one level up), the
CONTRIBUTING instructions and the theme-images.css pointer. Verified:
module loads from the new location and regenerating the SVG diagrams
produces byte-identical output.
Claude-Session: https://claude.ai/code/session_013kkVt3nxi9svp1an28uHxf
* feat: ISO 3382-3 open-plan office spatial metrics
Add open_plan_metrics() computing the ISO 3382-3:2012 single-number
quantities from a line of workstation measurements: spatial decay rate
D2,S and nominal speech level Lp,A,S,4m (Clause 6.2, Eq.5; 2-16 m
positions on a log-distance regression) and distraction/privacy
distances rD/rP (Clause 6.3; STI-vs-distance linear regression crossing
0,50 and 0,20). Returns a frozen OpenPlanResult; validates the minimum
of four positions (5.2.2) and equal array lengths.
Claude-Session: https://claude.ai/code/session_013kkVt3nxi9svp1an28uHxf
* feat: ISO 16283-1 field insulation and ISO 717-1 weighted ratings
Add phonometry.insulation implementing field airborne sound insulation
(ISO 16283-1:2014) and single-number weighted ratings with C/Ctr
(ISO 717-1):
- airborne_insulation: per-band level difference D (Formula (1)),
standardized level difference DnT = D + 10 lg(T/T0) (Formula (2)) and
apparent sound reduction index R' = D + 10 lg(S/A), A = 0,16 V/T
(Formula (4)/(5)); energy-averages microphone positions (Formula (9)).
- weighted_rating: reference-curve shifting method (Clause 4.4, Table 3)
with the 32,0/10,0 dB unfavourable-deviation bound, plus C/Ctr from the
Table 4 spectra (Clause 4.5). Reference values, spectra and method are
identical in the 2013 and 2020 editions.
- energy_average_level: ISO 16283-1 Formula (9) helper.
Verified against the ISO 717-1 Annex C worked example (Rw(C;Ctr) =
30(-2;-3), unfavourable sum 31,8 dB) and exact-bound / tipping edge
cases. 20 new tests; make check green (484 passed, 12 skipped).
Claude-Session: https://claude.ai/code/session_013kkVt3nxi9svp1an28uHxf
* docs: room & building acoustics guide, theory, API and landing (EN)
New "Room & building acoustics" guide (docs/ + Starlight twin) covering the
full measurement chain: ISO 18233 swept-sine/MLS impulse-response acquisition,
ISO 3382-1/2 decay analysis and room parameters (EDT/T20/T30/C50/C80/D50/Ts),
ISO 3382-3 open-plan speech metrics, and ISO 16283-1 / ISO 717-1 field
insulation with weighted ratings. Adds the matching theory section (Schroeder
integration, regression windows, C/D/Ts, D2,S, DnT/R', reference-curve method),
API-reference rows for all new public names, sidebar entry, README highlight +
docs row, EN landing card, CHANGELOG entries, docs index row, and regenerated
llms-full.txt. All snippets validated; site build and make check green.
Claude-Session: https://claude.ai/code/session_013kkVt3nxi9svp1an28uHxf
* docs: Schroeder, ISO 717-1 rating and insulation-setup figures
Add three room/building-acoustics documentation figure sets (each in
en/es x light/dark):
- schroeder_decay: synthetic IR, Schroeder backward integration with
EDT/T20/T30 regressions and evaluation ranges (ISO 3382); annotated
values match room_parameters.
- insulation_rating: ISO 717-1 Annex C example with shifted reference
curve, unfavourable-deviation shading and Rw read at 500 Hz; Rw, C,
Ctr and the unfavourable sum come from weighted_rating.
- diagram_insulation_setup: ISO 16283-1 airborne setup plan view with
the normative minimum distances (clauses 7.6 and 7.2.2).
Claude-Session: https://claude.ai/code/session_013kkVt3nxi9svp1an28uHxf
* docs: gemelas ES de acústica de salas y edificación
Claude-Session: https://claude.ai/code/session_013kkVt3nxi9svp1an28uHxf
* docs: terminología UNE — ponderación temporal en lugar de balística (ES)
Claude-Session: https://claude.ai/code/session_013kkVt3nxi9svp1an28uHxf
* docs: markdown/README parity with the site + llms guide coverage
Scrub GitHub-unsafe display math (\, thin-spaces and escaped \{ \}) from
docs/intensity.md and docs/psychoacoustics.md — the only two guides that
missed the GitHub-safe math conversion of PRs #78/#79 — matching the safe
forms already used in docs/theory.md. Align calibration's sensitivity
symbol/formula to the site ($S$, single-line \qquad).
Extend scripts/gen_llms.py PAGES with the three omitted guides
(psychoacoustics, intensity, room-acoustics) and regenerate llms.txt /
llms-full.txt so AI-facing artifacts cover all 14 docs pages.
The guides/references were otherwise already in parity (didactic code
comments, theory sections, tables, and figures from PRs #77/#80 all
present); docs/README index and README highlights/table verified complete.
Claude-Session: https://claude.ai/code/session_013kkVt3nxi9svp1an28uHxf
* fix: final-review findings — open_plan validation, limits rename, Farina caveat, MLS averaging test
Claude-Session: https://claude.ai/code/session_013kkVt3nxi9svp1an28uHxf
* docs: ISO 18233 measurement-chain diagram and guide fixes
Claude-Session: https://claude.ai/code/session_013kkVt3nxi9svp1an28uHxf
* docs: fix sweep_signal cross-reference in Farina caveat
Claude-Session: https://claude.ai/code/session_013kkVt3nxi9svp1an28uHxf
* fix: PR 81 review round 1 — inverse-filter guards, truncation threshold, IR input validation, docs pipeline wording
Claude-Session: https://claude.ai/code/session_013kkVt3nxi9svp1an28uHxf
* docs: blank lines around CONTRIBUTING fence (MD031)
Claude-Session: https://claude.ai/code/session_013kkVt3nxi9svp1an28uHxf
Audit pass 11a: seven new documentation diagrams (#121)
* Audit pass 11a: seven new documentation diagrams
Add SVG flow diagrams for the seven topics the audit flagged as having no
schematic: the exponential-detector chain of the time weightings
(IEC 61672-1), stateful vs reset block processing, the multichannel
array-shape flow, the open-plan spatial-decay line (ISO 3382-3), the
ISO 12999-1 uncertainty pipeline, the ISO 11654 absorption-rating flow and
the Zwicker loudness-model chain (ISO 532-1).
Each is generated deterministically by generate_diagrams.py in the four
EN/ES x light/dark variants, with every Spanish label added to the _ES
table (decimals localised to commas), and embedded in the repo docs and
both site trees beside the existing worked-example plots.
* Fix ISO 532-1 table citations in the Zwicker diagram
Review of the diagram against loudness_zwicker.py found two mislabelled
tables: the equal-loudness correction and lower-critical-band grouping is
Table A.3 (not A.4), and the threshold in quiet LTQ is Table A.6 (not A.3).
Reassign the a0/DDF/LTQ corrections to the core-loudness step (Tables
A.4-A.7) where they belong, update the Spanish labels, and align the ES
psychoacoustics alt text with the guide's own term "sonos" (was "sonios").
Audit pass 11a: seven new documentation diagrams (#121)
* Audit pass 11a: seven new documentation diagrams
Add SVG flow diagrams for the seven topics the audit flagged as having no
schematic: the exponential-detector chain of the time weightings
(IEC 61672-1), stateful vs reset block processing, the multichannel
array-shape flow, the open-plan spatial-decay line (ISO 3382-3), the
ISO 12999-1 uncertainty pipeline, the ISO 11654 absorption-rating flow and
the Zwicker loudness-model chain (ISO 532-1).
Each is generated deterministically by generate_diagrams.py in the four
EN/ES x light/dark variants, with every Spanish label added to the _ES
table (decimals localised to commas), and embedded in the repo docs and
both site trees beside the existing worked-example plots.
* Fix ISO 532-1 table citations in the Zwicker diagram
Review of the diagram against loudness_zwicker.py found two mislabelled
tables: the equal-loudness correction and lower-critical-band grouping is
Table A.3 (not A.4), and the threshold in quiet LTQ is Table A.6 (not A.3).
Reassign the a0/DDF/LTQ corrections to the core-loudness step (Tables
A.4-A.7) where they belong, update the Spanish labels, and align the ES
psychoacoustics alt text with the guide's own term "sonos" (was "sonios").
Spanish docs: UNE terminology, decimal commas, localized snippets and theory figures (#365)
* Normalize Spanish docs prose to UNE acoustic terminology
Sweep the Spanish pages for the non-UNE forms "presion sonora",
"potencia sonora" and "intensidad sonora" and normalize the prose to
the wording used by the official Spanish editions of the standards:
"presion acustica" (UNE-EN ISO 16283-2:2016, UNE-EN ISO 10052:2005,
UNE-EN ISO 3746:2011, UNE-ISO 226:2013), "potencia acustica"
(UNE-EN ISO 3746:2011, UNE-EN ISO 4871:2010, UNE-EN ISO 9614-1:2010),
"intensidad acustica" (UNE-EN 61043:1999, UNE-EN ISO 9614-1:2010) and
"nivel de presion acustica de impactos" (UNE-EN ISO 12354-2:2018,
UNE-EN ISO 717-2:2013). 92 replacements across 32 pages, prose only:
code snippets keep the labels they share with the generated figures.
Rename the intensity guide to "Intensidad acustica (p-p)" and the
structure-borne power guide to "Potencia acustica estructural de
equipos (EN 15657)", updating every cross-link text and the theory
anchor intensidad-sonora-iec-61043 accordingly. The API sidebar group
label becomes "Potencia acustica e intensidad" via api_taxonomy.py
with the generated sidebar regenerated.
* Use decimal commas in Spanish docs prose quantities
Sweep every Spanish page for decimal points leaking into prose numbers
and switch them to the comma the locale convention calls for: the
rotorcraft validation prose (fourteen tolerances such as 0,08 dB(A) and
0,5 s), the insulation-prediction worked example (53,6 dB / 53,8 dB),
the tone-audibility Annex E tone (137,3 Hz), the Mackenzie check value
(1550,744 m/s), the EPNL, loudness and absorption fiche descriptions
(98,3 EPNdB; 8,2 sonos and 70,4 fonios; 0,60 y 0,55), the junction
constants table and the third-octave band-edge table in the signal
analysis theory page. Code snippets, inline code, math, clause numbers
and quoted source text keep their points.
* Pass language="es" in Spanish figure-reproduction snippets
The <details> blocks under each localized figure in the Spanish guides
are meant to reproduce the _es variant shown on the page, but 82 of the
one-line result .plot() calls omitted the language="es" argument and
would render English axis labels instead. Add the argument across 33
guides, matching the pattern the intensity field-indicators snippet
already used. The three lab-insulation results whose plot() does not
take a language argument (lab airborne, lab impact and the
element-normalized intensity difference) are left as they were.
* Extend the UNE terminology sweep to sound absorption
Normalize "absorción sonora" to "absorción acústica" across the
Spanish pages (36 occurrences in 14 pages, including the EN 12354-6
guide title and the theory headings), the wording of UNE-EN ISO
3746:2011 and of the equivalent absorption area in UNE-EN ISO
10140-3:2011, UNE-EN ISO 12354-2:2018 and UNE-EN ISO 16283-2:2016, and
the same term the accredited report strings already use. Also restore
the accent in the theory index anchor to the renamed intensity heading,
since heading slugs keep accented characters.
* Theory pages: illustrate each section family with existing result figures
The seven theory pages carried no figures at all. Embed sixteen of the
existing generated figures (light and dark variants, Spanish variants on
the Spanish mirrors) where the concept matches the prose: weighting
curves, time integration and the p-p intensity estimator in the signal
analysis page; equal-loudness contours, the specific-loudness pattern
and the hearing-threshold panels in perception; NC/RC rating, the
Schroeder decay and the ISO 717-1 shifted reference in rooms and
buildings; the Lden profile, ISO 9613-1 absorption and the three sound
power routes in environment and transport; the scattering coefficient
and ISO 11654 rating in materials and surfaces; and the Wk weighting and
the resonator mobility triplet in vibration. Each embed reuses the alt
text of the guide that owns the figure and adds a one-line caption.
Also give the wave-simulation section hub the reading-order paragraph
its siblings already have, linking the closed-form pages the FDTD solver
cross-checks, in both languages.
* Address review findings from the Spanish locale sweeps
Second pass fixes flagged by review: five terminology occurrences the
line-based sweep missed because the noun and adjective were split by a
line wrap or emphasis markup (sound-power, rotorcraft-noise and two
section hubs); six Spanish pages that still embedded the English figure
variant although the _es variant exists (junction-transmission,
aircraft-noise airport contour, miso-coherence,
objective-intelligibility, psychoacoustic-annoyance twice); and 19 more
language="es" arguments on figure-reproduction plot calls the first
pass missed, chained-call receivers such as room.noise_criterion(spl)
.plot() and the axes-creating first call of the two-profile
atmospheric-refraction snippet among them. The lab-insulation plot
wrappers forward keyword arguments to the rating plot, so the three
calls excluded earlier now take the argument too. All Spanish python
fences re-checked to compile and EN/ES parity re-verified.
* Carry the UNE terminology into the generated-asset Spanish strings
Apply the same evidence-based decisions to every Spanish string source
that feeds generated assets: the translation tables of
generate_graphs.py and generate_diagrams.py, the _STRINGS tables of the
plot modules and the report i18n values. 35 strings change: "presión
acústica" (UNE-EN ISO 16283-2:2016, 10052:2005, 3746:2011),
"potencia acústica" (UNE-EN ISO 3746:2011, 4871:2010, 9614-1:2010),
"intensidad acústica" (UNE-EN 61043:1999, 9614-1:2010), "absorción
acústica" (UNE-EN ISO 3746:2011) and "nivel de presión acústica de
impactos" (UNE-EN ISO 12354-2:2018). Strings the UNE editions keep are
untouched: "emisión sonora", "exposición sonora", "campo sonoro",
"fuente sonora". Only Spanish values change; the English keys stay.
The two plot-i18n test assertions that pin the axis label follow, and
the eight Spanish doc fences that deliberately mirrored the old figure
labels now mirror the new ones.
* Regenerate the Spanish figure variants with the UNE terminology
make graphs after the string-source change: 48 files, all of them _es
or _es_dark variants (24 figure/diagram pairs), picking up "presión
acústica", "potencia acústica", "intensidad acústica", "absorción
acústica" and "nivel de presión acústica de impactos" in titles and
axis labels. The English variants are untouched. The committed example
fiches need no regeneration: every example in generate_reports.py
renders in English, so no changed Spanish report string reaches them.
* Align the intensity-fiche Spanish assertions with the UNE terminology
Spanish docs: UNE terminology, decimal commas, localized snippets and theory figures (#365)
* Normalize Spanish docs prose to UNE acoustic terminology
Sweep the Spanish pages for the non-UNE forms "presion sonora",
"potencia sonora" and "intensidad sonora" and normalize the prose to
the wording used by the official Spanish editions of the standards:
"presion acustica" (UNE-EN ISO 16283-2:2016, UNE-EN ISO 10052:2005,
UNE-EN ISO 3746:2011, UNE-ISO 226:2013), "potencia acustica"
(UNE-EN ISO 3746:2011, UNE-EN ISO 4871:2010, UNE-EN ISO 9614-1:2010),
"intensidad acustica" (UNE-EN 61043:1999, UNE-EN ISO 9614-1:2010) and
"nivel de presion acustica de impactos" (UNE-EN ISO 12354-2:2018,
UNE-EN ISO 717-2:2013). 92 replacements across 32 pages, prose only:
code snippets keep the labels they share with the generated figures.
Rename the intensity guide to "Intensidad acustica (p-p)" and the
structure-borne power guide to "Potencia acustica estructural de
equipos (EN 15657)", updating every cross-link text and the theory
anchor intensidad-sonora-iec-61043 accordingly. The API sidebar group
label becomes "Potencia acustica e intensidad" via api_taxonomy.py
with the generated sidebar regenerated.
* Use decimal commas in Spanish docs prose quantities
Sweep every Spanish page for decimal points leaking into prose numbers
and switch them to the comma the locale convention calls for: the
rotorcraft validation prose (fourteen tolerances such as 0,08 dB(A) and
0,5 s), the insulation-prediction worked example (53,6 dB / 53,8 dB),
the tone-audibility Annex E tone (137,3 Hz), the Mackenzie check value
(1550,744 m/s), the EPNL, loudness and absorption fiche descriptions
(98,3 EPNdB; 8,2 sonos and 70,4 fonios; 0,60 y 0,55), the junction
constants table and the third-octave band-edge table in the signal
analysis theory page. Code snippets, inline code, math, clause numbers
and quoted source text keep their points.
* Pass language="es" in Spanish figure-reproduction snippets
The <details> blocks under each localized figure in the Spanish guides
are meant to reproduce the _es variant shown on the page, but 82 of the
one-line result .plot() calls omitted the language="es" argument and
would render English axis labels instead. Add the argument across 33
guides, matching the pattern the intensity field-indicators snippet
already used. The three lab-insulation results whose plot() does not
take a language argument (lab airborne, lab impact and the
element-normalized intensity difference) are left as they were.
* Extend the UNE terminology sweep to sound absorption
Normalize "absorción sonora" to "absorción acústica" across the
Spanish pages (36 occurrences in 14 pages, including the EN 12354-6
guide title and the theory headings), the wording of UNE-EN ISO
3746:2011 and of the equivalent absorption area in UNE-EN ISO
10140-3:2011, UNE-EN ISO 12354-2:2018 and UNE-EN ISO 16283-2:2016, and
the same term the accredited report strings already use. Also restore
the accent in the theory index anchor to the renamed intensity heading,
since heading slugs keep accented characters.
* Theory pages: illustrate each section family with existing result figures
The seven theory pages carried no figures at all. Embed sixteen of the
existing generated figures (light and dark variants, Spanish variants on
the Spanish mirrors) where the concept matches the prose: weighting
curves, time integration and the p-p intensity estimator in the signal
analysis page; equal-loudness contours, the specific-loudness pattern
and the hearing-threshold panels in perception; NC/RC rating, the
Schroeder decay and the ISO 717-1 shifted reference in rooms and
buildings; the Lden profile, ISO 9613-1 absorption and the three sound
power routes in environment and transport; the scattering coefficient
and ISO 11654 rating in materials and surfaces; and the Wk weighting and
the resonator mobility triplet in vibration. Each embed reuses the alt
text of the guide that owns the figure and adds a one-line caption.
Also give the wave-simulation section hub the reading-order paragraph
its siblings already have, linking the closed-form pages the FDTD solver
cross-checks, in both languages.
* Address review findings from the Spanish locale sweeps
Second pass fixes flagged by review: five terminology occurrences the
line-based sweep missed because the noun and adjective were split by a
line wrap or emphasis markup (sound-power, rotorcraft-noise and two
section hubs); six Spanish pages that still embedded the English figure
variant although the _es variant exists (junction-transmission,
aircraft-noise airport contour, miso-coherence,
objective-intelligibility, psychoacoustic-annoyance twice); and 19 more
language="es" arguments on figure-reproduction plot calls the first
pass missed, chained-call receivers such as room.noise_criterion(spl)
.plot() and the axes-creating first call of the two-profile
atmospheric-refraction snippet among them. The lab-insulation plot
wrappers forward keyword arguments to the rating plot, so the three
calls excluded earlier now take the argument too. All Spanish python
fences re-checked to compile and EN/ES parity re-verified.
* Carry the UNE terminology into the generated-asset Spanish strings
Apply the same evidence-based decisions to every Spanish string source
that feeds generated assets: the translation tables of
generate_graphs.py and generate_diagrams.py, the _STRINGS tables of the
plot modules and the report i18n values. 35 strings change: "presión
acústica" (UNE-EN ISO 16283-2:2016, 10052:2005, 3746:2011),
"potencia acústica" (UNE-EN ISO 3746:2011, 4871:2010, 9614-1:2010),
"intensidad acústica" (UNE-EN 61043:1999, 9614-1:2010), "absorción
acústica" (UNE-EN ISO 3746:2011) and "nivel de presión acústica de
impactos" (UNE-EN ISO 12354-2:2018). Strings the UNE editions keep are
untouched: "emisión sonora", "exposición sonora", "campo sonoro",
"fuente sonora". Only Spanish values change; the English keys stay.
The two plot-i18n test assertions that pin the axis label follow, and
the eight Spanish doc fences that deliberately mirrored the old figure
labels now mirror the new ones.
* Regenerate the Spanish figure variants with the UNE terminology
make graphs after the string-source change: 48 files, all of them _es
or _es_dark variants (24 figure/diagram pairs), picking up "presión
acústica", "potencia acústica", "intensidad acústica", "absorción
acústica" and "nivel de presión acústica de impactos" in titles and
axis labels. The English variants are untouched. The committed example
fiches need no regeneration: every example in generate_reports.py
renders in English, so no changed Spanish report string reaches them.
* Align the intensity-fiche Spanish assertions with the UNE terminology
Audit pass 11a: seven new documentation diagrams (#121)
* Audit pass 11a: seven new documentation diagrams
Add SVG flow diagrams for the seven topics the audit flagged as having no
schematic: the exponential-detector chain of the time weightings
(IEC 61672-1), stateful vs reset block processing, the multichannel
array-shape flow, the open-plan spatial-decay line (ISO 3382-3), the
ISO 12999-1 uncertainty pipeline, the ISO 11654 absorption-rating flow and
the Zwicker loudness-model chain (ISO 532-1).
Each is generated deterministically by generate_diagrams.py in the four
EN/ES x light/dark variants, with every Spanish label added to the _ES
table (decimals localised to commas), and embedded in the repo docs and
both site trees beside the existing worked-example plots.
* Fix ISO 532-1 table citations in the Zwicker diagram
Review of the diagram against loudness_zwicker.py found two mislabelled
tables: the equal-loudness correction and lower-critical-band grouping is
Table A.3 (not A.4), and the threshold in quiet LTQ is Table A.6 (not A.3).
Reassign the a0/DDF/LTQ corrections to the core-loudness step (Tables
A.4-A.7) where they belong, update the Spanish labels, and align the ES
psychoacoustics alt text with the guide's own term "sonos" (was "sonios").
Audit pass 11a: seven new documentation diagrams (#121)
* Audit pass 11a: seven new documentation diagrams
Add SVG flow diagrams for the seven topics the audit flagged as having no
schematic: the exponential-detector chain of the time weightings
(IEC 61672-1), stateful vs reset block processing, the multichannel
array-shape flow, the open-plan spatial-decay line (ISO 3382-3), the
ISO 12999-1 uncertainty pipeline, the ISO 11654 absorption-rating flow and
the Zwicker loudness-model chain (ISO 532-1).
Each is generated deterministically by generate_diagrams.py in the four
EN/ES x light/dark variants, with every Spanish label added to the _ES
table (decimals localised to commas), and embedded in the repo docs and
both site trees beside the existing worked-example plots.
* Fix ISO 532-1 table citations in the Zwicker diagram
Review of the diagram against loudness_zwicker.py found two mislabelled
tables: the equal-loudness correction and lower-critical-band grouping is
Table A.3 (not A.4), and the threshold in quiet LTQ is Table A.6 (not A.3).
Reassign the a0/DDF/LTQ corrections to the core-loudness step (Tables
A.4-A.7) where they belong, update the Spanish labels, and align the ES
psychoacoustics alt text with the guide's own term "sonos" (was "sonios").
Audit pass 11a: seven new documentation diagrams (#121)
* Audit pass 11a: seven new documentation diagrams
Add SVG flow diagrams for the seven topics the audit flagged as having no
schematic: the exponential-detector chain of the time weightings
(IEC 61672-1), stateful vs reset block processing, the multichannel
array-shape flow, the open-plan spatial-decay line (ISO 3382-3), the
ISO 12999-1 uncertainty pipeline, the ISO 11654 absorption-rating flow and
the Zwicker loudness-model chain (ISO 532-1).
Each is generated deterministically by generate_diagrams.py in the four
EN/ES x light/dark variants, with every Spanish label added to the _ES
table (decimals localised to commas), and embedded in the repo docs and
both site trees beside the existing worked-example plots.
* Fix ISO 532-1 table citations in the Zwicker diagram
Review of the diagram against loudness_zwicker.py found two mislabelled
tables: the equal-loudness correction and lower-critical-band grouping is
Table A.3 (not A.4), and the threshold in quiet LTQ is Table A.6 (not A.3).
Reassign the a0/DDF/LTQ corrections to the core-loudness step (Tables
A.4-A.7) where they belong, update the Spanish labels, and align the ES
psychoacoustics alt text with the guide's own term "sonos" (was "sonios").
Audit pass 11a: seven new documentation diagrams (#121)
* Audit pass 11a: seven new documentation diagrams
Add SVG flow diagrams for the seven topics the audit flagged as having no
schematic: the exponential-detector chain of the time weightings
(IEC 61672-1), stateful vs reset block processing, the multichannel
array-shape flow, the open-plan spatial-decay line (ISO 3382-3), the
ISO 12999-1 uncertainty pipeline, the ISO 11654 absorption-rating flow and
the Zwicker loudness-model chain (ISO 532-1).
Each is generated deterministically by generate_diagrams.py in the four
EN/ES x light/dark variants, with every Spanish label added to the _ES
table (decimals localised to commas), and embedded in the repo docs and
both site trees beside the existing worked-example plots.
* Fix ISO 532-1 table citations in the Zwicker diagram
Review of the diagram against loudness_zwicker.py found two mislabelled
tables: the equal-loudness correction and lower-critical-band grouping is
Table A.3 (not A.4), and the threshold in quiet LTQ is Table A.6 (not A.3).
Reassign the a0/DDF/LTQ corrections to the core-loudness step (Tables
A.4-A.7) where they belong, update the Spanish labels, and align the ES
psychoacoustics alt text with the guide's own term "sonos" (was "sonios").
ISO 2631-5: multiple-shock whole-body vibration (#106)
* feat: ISO 2631-5 multiple-shock whole-body vibration
Add the ISO 2631-5:2018 spinal-response model for whole-body vibration
containing multiple shocks: the normative Clause 5 dose and the Annex C
injury assessment (the vertical z-axis).
A seat-to-spine transfer function (clause 5.2, Formula 1) maps the
measured seat acceleration to the spinal response Az(t); the acceleration
dose Dz = 1.07*(sum Az,i^6)^(1/6) combines the positive response peaks
(Formula 3), scaled to a daily dose (Formula 4/5). Annex C turns the
daily dose into the compressive stress Sd = mz*Dzd (C.1), the
age-cumulated stress variable R (C.3/C.4) and the Weibull probability of
lumbar injury (C.5).
New module phonometry.iso2631_5 with seat_to_spine_transfer,
spinal_response, acceleration_dose, daily_dose(_multi), compression_dose,
injury_risk, injury_probability and the multiple_shock_assessment
convenience returning a MultipleShockResult with .plot(). Conformance
report gains a multiple-shock domain (3 checks, 88 total). Adds the
multiple-shock-vibration guide (repo + EN/ES site) with a figure and a
flow diagram.
Validated against the standard: the seat-to-spine transfer function
reproduces the Annex D 256 Hz digital realization to within the clause
5.2 tolerance, and the Annex C worked example (5 x 40 m/s2, 82 kg male)
gives Dzd=55.97 m/s2, R=1.22 and injury probability 0.37.
* refactor: address review feedback on ISO 2631-5
- response_peaks: vectorize the positive-peak search with NumPy instead
of a Python loop (Gemini, CodeRabbit)
- injury_probability: accept array-like R and return an array or float,
clamping negative R to zero (Gemini)
- multiple_shock_assessment: raise if only one of exposure_time /
measurement_time is given instead of silently skipping the daily-dose
scaling (Gemini, CodeRabbit)
- spinal_response: reject multi-dimensional input with a clear error
(CodeRabbit)
- export static_stress alongside the other Annex C helpers (CodeRabbit)
- figure/plot: use the vectorized injury_probability directly
- tests: assert_allclose over the transfer-function band, use MZ_MALE
and strict zip, cover array probability and the partial-argument guard
- es guide: consistent decimal style in the code comment (CodeRabbit)
* fix: Spanish decimal comma in mathtext figure legends
The decimal-comma pass skips any label containing mathtext ($...$), so
the ISO 2631-5 'Ejemplo $R$ = 1.22' and NT ACOU 112 'Determinante
$K_I$ = 13.0 dB' legends kept a dot in Spanish. Fold the decimal
conversion into the _ES_PATTERNS rules for those labels (CodeRabbit).
ISO 2631-5: multiple-shock whole-body vibration (#106)
* feat: ISO 2631-5 multiple-shock whole-body vibration
Add the ISO 2631-5:2018 spinal-response model for whole-body vibration
containing multiple shocks: the normative Clause 5 dose and the Annex C
injury assessment (the vertical z-axis).
A seat-to-spine transfer function (clause 5.2, Formula 1) maps the
measured seat acceleration to the spinal response Az(t); the acceleration
dose Dz = 1.07*(sum Az,i^6)^(1/6) combines the positive response peaks
(Formula 3), scaled to a daily dose (Formula 4/5). Annex C turns the
daily dose into the compressive stress Sd = mz*Dzd (C.1), the
age-cumulated stress variable R (C.3/C.4) and the Weibull probability of
lumbar injury (C.5).
New module phonometry.iso2631_5 with seat_to_spine_transfer,
spinal_response, acceleration_dose, daily_dose(_multi), compression_dose,
injury_risk, injury_probability and the multiple_shock_assessment
convenience returning a MultipleShockResult with .plot(). Conformance
report gains a multiple-shock domain (3 checks, 88 total). Adds the
multiple-shock-vibration guide (repo + EN/ES site) with a figure and a
flow diagram.
Validated against the standard: the seat-to-spine transfer function
reproduces the Annex D 256 Hz digital realization to within the clause
5.2 tolerance, and the Annex C worked example (5 x 40 m/s2, 82 kg male)
gives Dzd=55.97 m/s2, R=1.22 and injury probability 0.37.
* refactor: address review feedback on ISO 2631-5
- response_peaks: vectorize the positive-peak search with NumPy instead
of a Python loop (Gemini, CodeRabbit)
- injury_probability: accept array-like R and return an array or float,
clamping negative R to zero (Gemini)
- multiple_shock_assessment: raise if only one of exposure_time /
measurement_time is given instead of silently skipping the daily-dose
scaling (Gemini, CodeRabbit)
- spinal_response: reject multi-dimensional input with a clear error
(CodeRabbit)
- export static_stress alongside the other Annex C helpers (CodeRabbit)
- figure/plot: use the vectorized injury_probability directly
- tests: assert_allclose over the transfer-function band, use MZ_MALE
and strict zip, cover array probability and the partial-argument guard
- es guide: consistent decimal style in the code comment (CodeRabbit)
* fix: Spanish decimal comma in mathtext figure legends
The decimal-comma pass skips any label containing mathtext ($...$), so
the ISO 2631-5 'Ejemplo $R$ = 1.22' and NT ACOU 112 'Determinante
$K_I$ = 13.0 dB' legends kept a dot in Spanish. Fold the decimal
conversion into the _ES_PATTERNS rules for those labels (CodeRabbit).
ISO 2631-5: multiple-shock whole-body vibration (#106)
* feat: ISO 2631-5 multiple-shock whole-body vibration
Add the ISO 2631-5:2018 spinal-response model for whole-body vibration
containing multiple shocks: the normative Clause 5 dose and the Annex C
injury assessment (the vertical z-axis).
A seat-to-spine transfer function (clause 5.2, Formula 1) maps the
measured seat acceleration to the spinal response Az(t); the acceleration
dose Dz = 1.07*(sum Az,i^6)^(1/6) combines the positive response peaks
(Formula 3), scaled to a daily dose (Formula 4/5). Annex C turns the
daily dose into the compressive stress Sd = mz*Dzd (C.1), the
age-cumulated stress variable R (C.3/C.4) and the Weibull probability of
lumbar injury (C.5).
New module phonometry.iso2631_5 with seat_to_spine_transfer,
spinal_response, acceleration_dose, daily_dose(_multi), compression_dose,
injury_risk, injury_probability and the multiple_shock_assessment
convenience returning a MultipleShockResult with .plot(). Conformance
report gains a multiple-shock domain (3 checks, 88 total). Adds the
multiple-shock-vibration guide (repo + EN/ES site) with a figure and a
flow diagram.
Validated against the standard: the seat-to-spine transfer function
reproduces the Annex D 256 Hz digital realization to within the clause
5.2 tolerance, and the Annex C worked example (5 x 40 m/s2, 82 kg male)
gives Dzd=55.97 m/s2, R=1.22 and injury probability 0.37.
* refactor: address review feedback on ISO 2631-5
- response_peaks: vectorize the positive-peak search with NumPy instead
of a Python loop (Gemini, CodeRabbit)
- injury_probability: accept array-like R and return an array or float,
clamping negative R to zero (Gemini)
- multiple_shock_assessment: raise if only one of exposure_time /
measurement_time is given instead of silently skipping the daily-dose
scaling (Gemini, CodeRabbit)
- spinal_response: reject multi-dimensional input with a clear error
(CodeRabbit)
- export static_stress alongside the other Annex C helpers (CodeRabbit)
- figure/plot: use the vectorized injury_probability directly
- tests: assert_allclose over the transfer-function band, use MZ_MALE
and strict zip, cover array probability and the partial-argument guard
- es guide: consistent decimal style in the code comment (CodeRabbit)
* fix: Spanish decimal comma in mathtext figure legends
The decimal-comma pass skips any label containing mathtext ($...$), so
the ISO 2631-5 'Ejemplo $R$ = 1.22' and NT ACOU 112 'Determinante
$K_I$ = 13.0 dB' legends kept a dot in Spanish. Fold the decimal
conversion into the _ES_PATTERNS rules for those labels (CodeRabbit).
ISO 2631-5: multiple-shock whole-body vibration (#106)
* feat: ISO 2631-5 multiple-shock whole-body vibration
Add the ISO 2631-5:2018 spinal-response model for whole-body vibration
containing multiple shocks: the normative Clause 5 dose and the Annex C
injury assessment (the vertical z-axis).
A seat-to-spine transfer function (clause 5.2, Formula 1) maps the
measured seat acceleration to the spinal response Az(t); the acceleration
dose Dz = 1.07*(sum Az,i^6)^(1/6) combines the positive response peaks
(Formula 3), scaled to a daily dose (Formula 4/5). Annex C turns the
daily dose into the compressive stress Sd = mz*Dzd (C.1), the
age-cumulated stress variable R (C.3/C.4) and the Weibull probability of
lumbar injury (C.5).
New module phonometry.iso2631_5 with seat_to_spine_transfer,
spinal_response, acceleration_dose, daily_dose(_multi), compression_dose,
injury_risk, injury_probability and the multiple_shock_assessment
convenience returning a MultipleShockResult with .plot(). Conformance
report gains a multiple-shock domain (3 checks, 88 total). Adds the
multiple-shock-vibration guide (repo + EN/ES site) with a figure and a
flow diagram.
Validated against the standard: the seat-to-spine transfer function
reproduces the Annex D 256 Hz digital realization to within the clause
5.2 tolerance, and the Annex C worked example (5 x 40 m/s2, 82 kg male)
gives Dzd=55.97 m/s2, R=1.22 and injury probability 0.37.
* refactor: address review feedback on ISO 2631-5
- response_peaks: vectorize the positive-peak search with NumPy instead
of a Python loop (Gemini, CodeRabbit)
- injury_probability: accept array-like R and return an array or float,
clamping negative R to zero (Gemini)
- multiple_shock_assessment: raise if only one of exposure_time /
measurement_time is given instead of silently skipping the daily-dose
scaling (Gemini, CodeRabbit)
- spinal_response: reject multi-dimensional input with a clear error
(CodeRabbit)
- export static_stress alongside the other Annex C helpers (CodeRabbit)
- figure/plot: use the vectorized injury_probability directly
- tests: assert_allclose over the transfer-function band, use MZ_MALE
and strict zip, cover array probability and the partial-argument guard
- es guide: consistent decimal style in the code comment (CodeRabbit)
* fix: Spanish decimal comma in mathtext figure legends
The decimal-comma pass skips any label containing mathtext ($...$), so
the ISO 2631-5 'Ejemplo $R$ = 1.22' and NT ACOU 112 'Determinante
$K_I$ = 13.0 dB' legends kept a dot in Spanish. Fold the decimal
conversion into the _ES_PATTERNS rules for those labels (CodeRabbit).
docs: speech and electroacoustics didactics, free-field sensitivity diagram and verified references (#190)
* docs: free-field loudspeaker sensitivity setup diagram (IEC 60268-5)
New diagram_loudspeaker_freefield builder in the SVG generator: loudspeaker
on a stand in an anechoic room, amplifier at 2.83 V, dashed reference axis,
measurement microphone at the 1 m reference distance with a drafting
dimension, and the governing sensitivity relations. Four deterministic
variants (EN/ES, light/dark).
* docs: sensitivity-conventions section in the electroacoustics guide
New section on the IEC 60268-4/-5 sensitivity conventions: microphone
sensitivity in mV/Pa and dB re 1 V/Pa with the reference pitfall, and the
loudspeaker characteristic sensitivity with its electrical (2.83 V vs 1 W)
and geometric (1 m reference distance, inverse-distance referral)
normalizations. Embeds the new setup diagram, adds a References section
(Beranek & Mellow) and extends the Standards footer. EN docs, site EN and
site ES.
* docs: MTF intuition and method pitfalls in the speech-transmission guide
Why modulation depth carries intelligibility (envelope valleys, the 7x14
m(F) grid, the effective-SNR mapping), and a direct-vs-indirect subsection
with the pitfalls the standard is explicit about: non-linear and
time-variant channels, level-dependent masking, impulsive and fluctuating
background noise, and the statistical spread of repeated STIPA runs. Adds a
References section (Houtgast & Steeneken 1985). EN docs, site EN and
site ES.
* docs: band-importance meaning and SII vs STI comparison in the SII guide
What the band-importance function means (the French & Steinberg
articulation lineage; intelligibility vs speech power across bands) and a
new SII-or-STI section with a comparison table of questions answered,
inputs, band machinery, blind spots and typical uses. Adds a References
section (French & Steinberg 1947). EN docs, site EN and site ES.
* docs: Speech group in the bibliography
Houtgast & Steeneken (1985) and French & Steinberg (1947) with verified
DOIs and back-links to the guides that cite them; Cited-by line for
Beranek & Mellow from the electroacoustics guide.
docs: speech and electroacoustics didactics, free-field sensitivity diagram and verified references (#190)
* docs: free-field loudspeaker sensitivity setup diagram (IEC 60268-5)
New diagram_loudspeaker_freefield builder in the SVG generator: loudspeaker
on a stand in an anechoic room, amplifier at 2.83 V, dashed reference axis,
measurement microphone at the 1 m reference distance with a drafting
dimension, and the governing sensitivity relations. Four deterministic
variants (EN/ES, light/dark).
* docs: sensitivity-conventions section in the electroacoustics guide
New section on the IEC 60268-4/-5 sensitivity conventions: microphone
sensitivity in mV/Pa and dB re 1 V/Pa with the reference pitfall, and the
loudspeaker characteristic sensitivity with its electrical (2.83 V vs 1 W)
and geometric (1 m reference distance, inverse-distance referral)
normalizations. Embeds the new setup diagram, adds a References section
(Beranek & Mellow) and extends the Standards footer. EN docs, site EN and
site ES.
* docs: MTF intuition and method pitfalls in the speech-transmission guide
Why modulation depth carries intelligibility (envelope valleys, the 7x14
m(F) grid, the effective-SNR mapping), and a direct-vs-indirect subsection
with the pitfalls the standard is explicit about: non-linear and
time-variant channels, level-dependent masking, impulsive and fluctuating
background noise, and the statistical spread of repeated STIPA runs. Adds a
References section (Houtgast & Steeneken 1985). EN docs, site EN and
site ES.
* docs: band-importance meaning and SII vs STI comparison in the SII guide
What the band-importance function means (the French & Steinberg
articulation lineage; intelligibility vs speech power across bands) and a
new SII-or-STI section with a comparison table of questions answered,
inputs, band machinery, blind spots and typical uses. Adds a References
section (French & Steinberg 1947). EN docs, site EN and site ES.
* docs: Speech group in the bibliography
Houtgast & Steeneken (1985) and French & Steinberg (1947) with verified
DOIs and back-links to the guides that cite them; Cited-by line for
Beranek & Mellow from the electroacoustics guide.
docs: speech and electroacoustics didactics, free-field sensitivity diagram and verified references (#190)
* docs: free-field loudspeaker sensitivity setup diagram (IEC 60268-5)
New diagram_loudspeaker_freefield builder in the SVG generator: loudspeaker
on a stand in an anechoic room, amplifier at 2.83 V, dashed reference axis,
measurement microphone at the 1 m reference distance with a drafting
dimension, and the governing sensitivity relations. Four deterministic
variants (EN/ES, light/dark).
* docs: sensitivity-conventions section in the electroacoustics guide
New section on the IEC 60268-4/-5 sensitivity conventions: microphone
sensitivity in mV/Pa and dB re 1 V/Pa with the reference pitfall, and the
loudspeaker characteristic sensitivity with its electrical (2.83 V vs 1 W)
and geometric (1 m reference distance, inverse-distance referral)
normalizations. Embeds the new setup diagram, adds a References section
(Beranek & Mellow) and extends the Standards footer. EN docs, site EN and
site ES.
* docs: MTF intuition and method pitfalls in the speech-transmission guide
Why modulation depth carries intelligibility (envelope valleys, the 7x14
m(F) grid, the effective-SNR mapping), and a direct-vs-indirect subsection
with the pitfalls the standard is explicit about: non-linear and
time-variant channels, level-dependent masking, impulsive and fluctuating
background noise, and the statistical spread of repeated STIPA runs. Adds a
References section (Houtgast & Steeneken 1985). EN docs, site EN and
site ES.
* docs: band-importance meaning and SII vs STI comparison in the SII guide
What the band-importance function means (the French & Steinberg
articulation lineage; intelligibility vs speech power across bands) and a
new SII-or-STI section with a comparison table of questions answered,
inputs, band machinery, blind spots and typical uses. Adds a References
section (French & Steinberg 1947). EN docs, site EN and site ES.
* docs: Speech group in the bibliography
Houtgast & Steeneken (1985) and French & Steinberg (1947) with verified
DOIs and back-links to the guides that cite them; Cited-by line for
Beranek & Mellow from the electroacoustics guide.
docs: speech and electroacoustics didactics, free-field sensitivity diagram and verified references (#190)
* docs: free-field loudspeaker sensitivity setup diagram (IEC 60268-5)
New diagram_loudspeaker_freefield builder in the SVG generator: loudspeaker
on a stand in an anechoic room, amplifier at 2.83 V, dashed reference axis,
measurement microphone at the 1 m reference distance with a drafting
dimension, and the governing sensitivity relations. Four deterministic
variants (EN/ES, light/dark).
* docs: sensitivity-conventions section in the electroacoustics guide
New section on the IEC 60268-4/-5 sensitivity conventions: microphone
sensitivity in mV/Pa and dB re 1 V/Pa with the reference pitfall, and the
loudspeaker characteristic sensitivity with its electrical (2.83 V vs 1 W)
and geometric (1 m reference distance, inverse-distance referral)
normalizations. Embeds the new setup diagram, adds a References section
(Beranek & Mellow) and extends the Standards footer. EN docs, site EN and
site ES.
* docs: MTF intuition and method pitfalls in the speech-transmission guide
Why modulation depth carries intelligibility (envelope valleys, the 7x14
m(F) grid, the effective-SNR mapping), and a direct-vs-indirect subsection
with the pitfalls the standard is explicit about: non-linear and
time-variant channels, level-dependent masking, impulsive and fluctuating
background noise, and the statistical spread of repeated STIPA runs. Adds a
References section (Houtgast & Steeneken 1985). EN docs, site EN and
site ES.
* docs: band-importance meaning and SII vs STI comparison in the SII guide
What the band-importance function means (the French & Steinberg
articulation lineage; intelligibility vs speech power across bands) and a
new SII-or-STI section with a comparison table of questions answered,
inputs, band machinery, blind spots and typical uses. Adds a References
section (French & Steinberg 1947). EN docs, site EN and site ES.
* docs: Speech group in the bibliography
Houtgast & Steeneken (1985) and French & Steinberg (1947) with verified
DOIs and back-links to the guides that cite them; Cited-by line for
Beranek & Mellow from the electroacoustics guide.
docs: building and structure-borne didactics, five rig diagrams and verified references (#193)
* docs: five structure-borne rig diagrams (ISO 9052-1, ISO 7626, ISO 10846, EN 15657, EN 12354-5)
Deterministic SVG builders with shared spring, accelerometer and exciter
helpers; light/dark and EN/ES variants of the dynamic-stiffness resonance
rig, the mobility beam rig, the direct/indirect transfer-stiffness stacks,
the reception plate and the EN 12354-5 installed-paths cross-section.
* docs: lab-vs-field quantities map and C/Ctr interpretation for the insulation guides
The apostrophe convention and flanking inclusion spelled out across the
trio, the extended lab/field quantities table, a didactic reading of the
spectrum adaptation terms, the measurement-prediction-check loop, and
verified References sections (Hopkins, Vigran, ISO 717-1, ISO 16283-1) in
the three copies (docs, site EN, site ES).
* docs: didactic depth for the structure-borne measurement guides
Rig diagrams embedded and prose added in all three copies: resonance-method
assumptions and preload pitfalls (EN 29052-1), how to read a mobility plot
and the ISO 7626-2 arrangement, why the blocked force and the frequency
split of the ISO 10846 methods, when the radiation-factor assumption breaks
(ISO/TS 7849), the reception-plate rationale (EN 15657) and the EN 12354-5
installation-paths context, each with a verified References section.
* docs: building-acoustics and structure-borne groups in the global bibliography
Hopkins, Vigran and Cremer/Heckl/Petersson with verified DOIs, the ISO
catalogue entries cited by the new References sections, and back-links to
the citing guides in the three bibliography copies.
* docs: legibility fixes in the mobility, transfer-stiffness and reception-plate diagrams
The driving-point caption clears the suspension spring, the Spanish
impedance-head caption clears the exciter stem, the excitation-mass boxes
fit the Spanish label, the indirect formula uses a consistent glyph style
and the Spanish source-quantities heading keeps a right margin.
* docs: precision and wording fixes in the new building and structure-borne prose
The radiation-factor caveat now qualifies accuracy rather than the bound,
Part 2 is tied explicitly to the radiation-factor problem, the survey
method keeps one Spanish term per page, the impedance-head note no longer
overstates, and Spanish register fixes (recrecido, diferencia, anclan) plus
site bibliography link texts aligned to the site page titles.
* docs: address review feedback on the building and structure-borne guides
- Field insulation guide: carry the spectrum adaptation terms on the field
descriptors (R'w + Ctr for facades, DnT,w + C between dwellings), matching
the example requirements of ISO 717-1, 5.3
- Transfer stiffness: state the ISO 10846-2 direct-method range from its
1 Hz scope bound instead of arbitrarily low frequencies, and say the
output is either rigidly blocked or loaded with a known mass
- Mechanical mobility: restrict the mobility-peak damping reading to the
isolated viscously damped resonator, present the soft free-free suspension
as the usual ISO 7626-2 arrangement rather than a requirement (clause 5),
and describe ISO 7626-5 as impact excitation with a non-attached exciter
whose spectrum is set by the impactor mass and tip stiffness
- Installed-paths diagram: render the EN 12354-5 Formula 17 path combination
as an energetic sum, 10 lg of the summed 10^(L/10) terms
- Spanish wording: parallel 'o bien ... o bien' in the transfer-stiffness
rig sentence and 'luego' in the resonance-rig diagram formula
docs: building and structure-borne didactics, five rig diagrams and verified references (#193)
* docs: five structure-borne rig diagrams (ISO 9052-1, ISO 7626, ISO 10846, EN 15657, EN 12354-5)
Deterministic SVG builders with shared spring, accelerometer and exciter
helpers; light/dark and EN/ES variants of the dynamic-stiffness resonance
rig, the mobility beam rig, the direct/indirect transfer-stiffness stacks,
the reception plate and the EN 12354-5 installed-paths cross-section.
* docs: lab-vs-field quantities map and C/Ctr interpretation for the insulation guides
The apostrophe convention and flanking inclusion spelled out across the
trio, the extended lab/field quantities table, a didactic reading of the
spectrum adaptation terms, the measurement-prediction-check loop, and
verified References sections (Hopkins, Vigran, ISO 717-1, ISO 16283-1) in
the three copies (docs, site EN, site ES).
* docs: didactic depth for the structure-borne measurement guides
Rig diagrams embedded and prose added in all three copies: resonance-method
assumptions and preload pitfalls (EN 29052-1), how to read a mobility plot
and the ISO 7626-2 arrangement, why the blocked force and the frequency
split of the ISO 10846 methods, when the radiation-factor assumption breaks
(ISO/TS 7849), the reception-plate rationale (EN 15657) and the EN 12354-5
installation-paths context, each with a verified References section.
* docs: building-acoustics and structure-borne groups in the global bibliography
Hopkins, Vigran and Cremer/Heckl/Petersson with verified DOIs, the ISO
catalogue entries cited by the new References sections, and back-links to
the citing guides in the three bibliography copies.
* docs: legibility fixes in the mobility, transfer-stiffness and reception-plate diagrams
The driving-point caption clears the suspension spring, the Spanish
impedance-head caption clears the exciter stem, the excitation-mass boxes
fit the Spanish label, the indirect formula uses a consistent glyph style
and the Spanish source-quantities heading keeps a right margin.
* docs: precision and wording fixes in the new building and structure-borne prose
The radiation-factor caveat now qualifies accuracy rather than the bound,
Part 2 is tied explicitly to the radiation-factor problem, the survey
method keeps one Spanish term per page, the impedance-head note no longer
overstates, and Spanish register fixes (recrecido, diferencia, anclan) plus
site bibliography link texts aligned to the site page titles.
* docs: address review feedback on the building and structure-borne guides
- Field insulation guide: carry the spectrum adaptation terms on the field
descriptors (R'w + Ctr for facades, DnT,w + C between dwellings), matching
the example requirements of ISO 717-1, 5.3
- Transfer stiffness: state the ISO 10846-2 direct-method range from its
1 Hz scope bound instead of arbitrarily low frequencies, and say the
output is either rigidly blocked or loaded with a known mass
- Mechanical mobility: restrict the mobility-peak damping reading to the
isolated viscously damped resonator, present the soft free-free suspension
as the usual ISO 7626-2 arrangement rather than a requirement (clause 5),
and describe ISO 7626-5 as impact excitation with a non-attached exciter
whose spectrum is set by the impactor mass and tip stiffness
- Installed-paths diagram: render the EN 12354-5 Formula 17 path combination
as an energetic sum, 10 lg of the summed 10^(L/10) terms
- Spanish wording: parallel 'o bien ... o bien' in the transfer-stiffness
rig sentence and 'luego' in the resonance-rig diagram formula
docs: building and structure-borne didactics, five rig diagrams and verified references (#193)
* docs: five structure-borne rig diagrams (ISO 9052-1, ISO 7626, ISO 10846, EN 15657, EN 12354-5)
Deterministic SVG builders with shared spring, accelerometer and exciter
helpers; light/dark and EN/ES variants of the dynamic-stiffness resonance
rig, the mobility beam rig, the direct/indirect transfer-stiffness stacks,
the reception plate and the EN 12354-5 installed-paths cross-section.
* docs: lab-vs-field quantities map and C/Ctr interpretation for the insulation guides
The apostrophe convention and flanking inclusion spelled out across the
trio, the extended lab/field quantities table, a didactic reading of the
spectrum adaptation terms, the measurement-prediction-check loop, and
verified References sections (Hopkins, Vigran, ISO 717-1, ISO 16283-1) in
the three copies (docs, site EN, site ES).
* docs: didactic depth for the structure-borne measurement guides
Rig diagrams embedded and prose added in all three copies: resonance-method
assumptions and preload pitfalls (EN 29052-1), how to read a mobility plot
and the ISO 7626-2 arrangement, why the blocked force and the frequency
split of the ISO 10846 methods, when the radiation-factor assumption breaks
(ISO/TS 7849), the reception-plate rationale (EN 15657) and the EN 12354-5
installation-paths context, each with a verified References section.
* docs: building-acoustics and structure-borne groups in the global bibliography
Hopkins, Vigran and Cremer/Heckl/Petersson with verified DOIs, the ISO
catalogue entries cited by the new References sections, and back-links to
the citing guides in the three bibliography copies.
* docs: legibility fixes in the mobility, transfer-stiffness and reception-plate diagrams
The driving-point caption clears the suspension spring, the Spanish
impedance-head caption clears the exciter stem, the excitation-mass boxes
fit the Spanish label, the indirect formula uses a consistent glyph style
and the Spanish source-quantities heading keeps a right margin.
* docs: precision and wording fixes in the new building and structure-borne prose
The radiation-factor caveat now qualifies accuracy rather than the bound,
Part 2 is tied explicitly to the radiation-factor problem, the survey
method keeps one Spanish term per page, the impedance-head note no longer
overstates, and Spanish register fixes (recrecido, diferencia, anclan) plus
site bibliography link texts aligned to the site page titles.
* docs: address review feedback on the building and structure-borne guides
- Field insulation guide: carry the spectrum adaptation terms on the field
descriptors (R'w + Ctr for facades, DnT,w + C between dwellings), matching
the example requirements of ISO 717-1, 5.3
- Transfer stiffness: state the ISO 10846-2 direct-method range from its
1 Hz scope bound instead of arbitrarily low frequencies, and say the
output is either rigidly blocked or loaded with a known mass
- Mechanical mobility: restrict the mobility-peak damping reading to the
isolated viscously damped resonator, present the soft free-free suspension
as the usual ISO 7626-2 arrangement rather than a requirement (clause 5),
and describe ISO 7626-5 as impact excitation with a non-attached exciter
whose spectrum is set by the impactor mass and tip stiffness
- Installed-paths diagram: render the EN 12354-5 Formula 17 path combination
as an energetic sum, 10 lg of the summed 10^(L/10) terms
- Spanish wording: parallel 'o bien ... o bien' in the transfer-stiffness
rig sentence and 'luego' in the resonance-rig diagram formula
docs: building and structure-borne didactics, five rig diagrams and verified references (#193)
* docs: five structure-borne rig diagrams (ISO 9052-1, ISO 7626, ISO 10846, EN 15657, EN 12354-5)
Deterministic SVG builders with shared spring, accelerometer and exciter
helpers; light/dark and EN/ES variants of the dynamic-stiffness resonance
rig, the mobility beam rig, the direct/indirect transfer-stiffness stacks,
the reception plate and the EN 12354-5 installed-paths cross-section.
* docs: lab-vs-field quantities map and C/Ctr interpretation for the insulation guides
The apostrophe convention and flanking inclusion spelled out across the
trio, the extended lab/field quantities table, a didactic reading of the
spectrum adaptation terms, the measurement-prediction-check loop, and
verified References sections (Hopkins, Vigran, ISO 717-1, ISO 16283-1) in
the three copies (docs, site EN, site ES).
* docs: didactic depth for the structure-borne measurement guides
Rig diagrams embedded and prose added in all three copies: resonance-method
assumptions and preload pitfalls (EN 29052-1), how to read a mobility plot
and the ISO 7626-2 arrangement, why the blocked force and the frequency
split of the ISO 10846 methods, when the radiation-factor assumption breaks
(ISO/TS 7849), the reception-plate rationale (EN 15657) and the EN 12354-5
installation-paths context, each with a verified References section.
* docs: building-acoustics and structure-borne groups in the global bibliography
Hopkins, Vigran and Cremer/Heckl/Petersson with verified DOIs, the ISO
catalogue entries cited by the new References sections, and back-links to
the citing guides in the three bibliography copies.
* docs: legibility fixes in the mobility, transfer-stiffness and reception-plate diagrams
The driving-point caption clears the suspension spring, the Spanish
impedance-head caption clears the exciter stem, the excitation-mass boxes
fit the Spanish label, the indirect formula uses a consistent glyph style
and the Spanish source-quantities heading keeps a right margin.
* docs: precision and wording fixes in the new building and structure-borne prose
The radiation-factor caveat now qualifies accuracy rather than the bound,
Part 2 is tied explicitly to the radiation-factor problem, the survey
method keeps one Spanish term per page, the impedance-head note no longer
overstates, and Spanish register fixes (recrecido, diferencia, anclan) plus
site bibliography link texts aligned to the site page titles.
* docs: address review feedback on the building and structure-borne guides
- Field insulation guide: carry the spectrum adaptation terms on the field
descriptors (R'w + Ctr for facades, DnT,w + C between dwellings), matching
the example requirements of ISO 717-1, 5.3
- Transfer stiffness: state the ISO 10846-2 direct-method range from its
1 Hz scope bound instead of arbitrarily low frequencies, and say the
output is either rigidly blocked or loaded with a known mass
- Mechanical mobility: restrict the mobility-peak damping reading to the
isolated viscously damped resonator, present the soft free-free suspension
as the usual ISO 7626-2 arrangement rather than a requirement (clause 5),
and describe ISO 7626-5 as impact excitation with a non-attached exciter
whose spectrum is set by the impactor mass and tip stiffness
- Installed-paths diagram: render the EN 12354-5 Formula 17 path combination
as an energetic sum, 10 lg of the summed 10^(L/10) terms
- Spanish wording: parallel 'o bien ... o bien' in the transfer-stiffness
rig sentence and 'luego' in the resonance-rig diagram formula
Audit pass 11a: seven new documentation diagrams (#121)
* Audit pass 11a: seven new documentation diagrams
Add SVG flow diagrams for the seven topics the audit flagged as having no
schematic: the exponential-detector chain of the time weightings
(IEC 61672-1), stateful vs reset block processing, the multichannel
array-shape flow, the open-plan spatial-decay line (ISO 3382-3), the
ISO 12999-1 uncertainty pipeline, the ISO 11654 absorption-rating flow and
the Zwicker loudness-model chain (ISO 532-1).
Each is generated deterministically by generate_diagrams.py in the four
EN/ES x light/dark variants, with every Spanish label added to the _ES
table (decimals localised to commas), and embedded in the repo docs and
both site trees beside the existing worked-example plots.
* Fix ISO 532-1 table citations in the Zwicker diagram
Review of the diagram against loudness_zwicker.py found two mislabelled
tables: the equal-loudness correction and lower-critical-band grouping is
Table A.3 (not A.4), and the threshold in quiet LTQ is Table A.6 (not A.3).
Reassign the a0/DDF/LTQ corrections to the core-loudness step (Tables
A.4-A.7) where they belong, update the Spanish labels, and align the ES
psychoacoustics alt text with the guide's own term "sonos" (was "sonios").
Audit pass 11a: seven new documentation diagrams (#121)
* Audit pass 11a: seven new documentation diagrams
Add SVG flow diagrams for the seven topics the audit flagged as having no
schematic: the exponential-detector chain of the time weightings
(IEC 61672-1), stateful vs reset block processing, the multichannel
array-shape flow, the open-plan spatial-decay line (ISO 3382-3), the
ISO 12999-1 uncertainty pipeline, the ISO 11654 absorption-rating flow and
the Zwicker loudness-model chain (ISO 532-1).
Each is generated deterministically by generate_diagrams.py in the four
EN/ES x light/dark variants, with every Spanish label added to the _ES
table (decimals localised to commas), and embedded in the repo docs and
both site trees beside the existing worked-example plots.
* Fix ISO 532-1 table citations in the Zwicker diagram
Review of the diagram against loudness_zwicker.py found two mislabelled
tables: the equal-loudness correction and lower-critical-band grouping is
Table A.3 (not A.4), and the threshold in quiet LTQ is Table A.6 (not A.3).
Reassign the a0/DDF/LTQ corrections to the core-loudness step (Tables
A.4-A.7) where they belong, update the Spanish labels, and align the ES
psychoacoustics alt text with the guide's own term "sonos" (was "sonios").
Audit pass 11a: seven new documentation diagrams (#121)
* Audit pass 11a: seven new documentation diagrams
Add SVG flow diagrams for the seven topics the audit flagged as having no
schematic: the exponential-detector chain of the time weightings
(IEC 61672-1), stateful vs reset block processing, the multichannel
array-shape flow, the open-plan spatial-decay line (ISO 3382-3), the
ISO 12999-1 uncertainty pipeline, the ISO 11654 absorption-rating flow and
the Zwicker loudness-model chain (ISO 532-1).
Each is generated deterministically by generate_diagrams.py in the four
EN/ES x light/dark variants, with every Spanish label added to the _ES
table (decimals localised to commas), and embedded in the repo docs and
both site trees beside the existing worked-example plots.
* Fix ISO 532-1 table citations in the Zwicker diagram
Review of the diagram against loudness_zwicker.py found two mislabelled
tables: the equal-loudness correction and lower-critical-band grouping is
Table A.3 (not A.4), and the threshold in quiet LTQ is Table A.6 (not A.3).
Reassign the a0/DDF/LTQ corrections to the core-loudness step (Tables
A.4-A.7) where they belong, update the Spanish labels, and align the ES
psychoacoustics alt text with the guide's own term "sonos" (was "sonios").
Audit pass 11a: seven new documentation diagrams (#121)
* Audit pass 11a: seven new documentation diagrams
Add SVG flow diagrams for the seven topics the audit flagged as having no
schematic: the exponential-detector chain of the time weightings
(IEC 61672-1), stateful vs reset block processing, the multichannel
array-shape flow, the open-plan spatial-decay line (ISO 3382-3), the
ISO 12999-1 uncertainty pipeline, the ISO 11654 absorption-rating flow and
the Zwicker loudness-model chain (ISO 532-1).
Each is generated deterministically by generate_diagrams.py in the four
EN/ES x light/dark variants, with every Spanish label added to the _ES
table (decimals localised to commas), and embedded in the repo docs and
both site trees beside the existing worked-example plots.
* Fix ISO 532-1 table citations in the Zwicker diagram
Review of the diagram against loudness_zwicker.py found two mislabelled
tables: the equal-loudness correction and lower-critical-band grouping is
Table A.3 (not A.4), and the threshold in quiet LTQ is Table A.6 (not A.3).
Reassign the a0/DDF/LTQ corrections to the core-loudness step (Tables
A.4-A.7) where they belong, update the Spanish labels, and align the ES
psychoacoustics alt text with the guide's own term "sonos" (was "sonios").
Didactic documentation: theory everywhere, bilingual figures, setup diagrams, parameter tables (#77)
* docs: harden diagram engine per visual audit
- dim() draws real witness lines from the measured points to the offset
dimension line (the offset=0 path emitted zero-length lines); vertical
labels sit left of the line, clear of masts and figures
- env diagram: the 4 m dimension now measures the mic axis itself and
the flush-mounted label moved to the clear zone between masts
- tonality top view: the 1.00 m dimension connects face and microphone
Claude-Session: https://claude.ai/code/session_013kkVt3nxi9svp1an28uHxf
* docs: bilingual diagram variants (EN/ES x light/dark)
Every setup diagram is now emitted in four variants; Spanish strings
(including decimal commas) come from a translation table applied by the
SVG engine, and layouts were adjusted where the longer Spanish labels
collided (env titles, processing-chain box width, calibration output
label, tonality dimension label side).
Claude-Session: https://claude.ai/code/session_013kkVt3nxi9svp1an28uHxf
* docs: bilingual figure variants for the ES site (EN/ES x light/dark)
generate_graphs.py now emits every figure in four variants: a Spanish
translation table (~75 exact strings + parametrized patterns) is applied
to the figure's Text artists at savefig time, so the generator functions
stay single-language internally. Spanish output uses UNE terminology
(ponderación temporal, líneas isofónicas, fonios, ráfaga) and a uniform
decimal comma (annotations and tick labels included); code identifiers
and normative mode names (Fast/Slow/Impulse) stay untranslated. The ES
site pages now reference the _es/_es_dark variants (56 URLs). The ES set
passed a 10-figure visual audit (10/10 approved, no blockers).
Claude-Session: https://claude.ai/code/session_013kkVt3nxi9svp1an28uHxf
* docs: didactic calibration page - theory, setup diagram, stability figure, parameter table
Adds the sensitivity-factor derivation with the calibration-chain SVG,
a new autogenerated calibration_stability figure (stable vs 3% AM tone
against the IEC 60942:2017 class 1 deviation band; 4 language/theme
variants; the ES decimal-comma pass now preserves clause numbers like
5.3.3), and a full parameter table for calculate_sensitivity - EN and
ES in parity.
Claude-Session: https://claude.ai/code/session_013kkVt3nxi9svp1an28uHxf
* docs: SEL concept, Lden 24h profile and annotated TNR spectrum figures
Three new didactic figures for the levels guide, each in four
language/theme variants: sel_concept (pass-by event vs its Leq and the
equal-energy 1 s SEL block, dBFS mode), lden_profile (synthetic urban
24 h LAeq with colored day/evening/night bands and the +5/+10 weighted
period levels clearly separated from the composite Lden), and
tonality_spectrum (averaged Hann spectrum with the critical band, the
detected tone and the live TNR value vs its criterion, computed by the
library itself).
Claude-Session: https://claude.ai/code/session_013kkVt3nxi9svp1an28uHxf
* docs: didactic levels guide, theory extensions and refreshed why-phonometry
- levels guide (EN docs+site): energy-mean rationale for Leq, percentile
semantics for LN, SEL and noise-dose theory with the new figures
embedded, TNR critical-band explanation with the annotated spectrum,
Lden profile figure, and parameter tables (type/units/range/default)
for every level function including the spectrogram
- theory page: five new sections (G-weighting pole/zero derivation,
ISO 226 formulae, ECMA-418-1 TNR/PR math, event/dose metrics,
ISO 1996-1 descriptors) with cross-references to the guides
- why-phonometry: rewritten around the conformance-testing story with
the per-standard verification table and honest ecosystem positioning
Claude-Session: https://claude.ai/code/session_013kkVt3nxi9svp1an28uHxf
* docs: weighting/time-weighting theory and parameter tables; fix math-block delimiters
The physiological origin of A/C (inverted 40/100-phon contours, the four
IEC corner frequencies) and the exponential-detector derivation with the
tau semantics, each with full parameter tables. Display math inserted by
the docs expansion now always uses block-style $$ delimiters on their
own lines - mid-line multi-line $$ blocks silently derailed remark
parsing and truncated every heading after them (caught because the
built pages lost their anchor ids); also replaced a raw < in a table.
Claude-Session: https://claude.ai/code/session_013kkVt3nxi9svp1an28uHxf
* docs: processing-chain and multirate diagrams, filter-bank math, streaming patterns
- getting-started embeds the processing-chain diagram as a guided map of
the guides
- filter-banks gains the IEC 61260-1 base-10 band math (G, fm, band
edges), a new multirate-decimation diagram (d5, four language/theme
variants) and the full octavefilter/OctaveFilterBank parameter table
- block-processing gains the canonical real-time level-meter loop
(validated against the actual API - TimeWeighting is inherently
stateful) and a stateful-constraints table
- multichannel gains the accepted-shapes table
Claude-Session: https://claude.ai/code/session_013kkVt3nxi9svp1an28uHxf
* docs: Spanish parity for the didactic expansion
Every enriched page now has its Spanish twin: levels (theory, three new
figures via _es variants, six parameter tables), weighting and
time-weighting (curve-origin and exponential-detector sections),
filter-banks (fractional-band math, multirate diagram, full parameter
table - terminology unified on 'decimación'), getting-started
(processing-chain map), block-processing (real-time meter pattern and
stateful constraints), multichannel (shapes table), theory (five new
sections) and a full rewrite of why-phonometry around the conformance
story. API reference now covers all 27 public exports in EN and ES
(added ToneAssessment and CalibrationWarning rows). UNE terminology and
Spanish decimal commas throughout; site builds with all links valid.
Claude-Session: https://claude.ai/code/session_013kkVt3nxi9svp1an28uHxf
* docs: audited fixes - Spanish tick commas and multirate note
Final visual-audit round: the d5 diagram now shows the no-decimation
note on the 16 kHz row in both languages, and Spanish figures render
every numeric tick with a decimal comma (FixedFormatter sequences are
rewritten in place; set_xticklabels-style FuncFormatters and plain
linear ScalarFormatters are wrapped - the first naive wrapper broke
ScalarFormatter ticks entirely and was caught visually).
Claude-Session: https://claude.ai/code/session_013kkVt3nxi9svp1an28uHxf
* docs(site): language selector in the mobile header, scrollable display math
Custom Header component (default markup plus a compact icon-only
LanguageSelect visible below the md breakpoint, where Starlight hides
the whole right group behind the hamburger menu) and overflow-x on
katex-display so wide formulas scroll inside their box on phones.
Verified with Playwright at 390 px in EN and ES.
Claude-Session: https://claude.ai/code/session_013kkVt3nxi9svp1an28uHxf
* fix: address review feedback on the didactic docs
- levels tables: spectrogram calibration_factor/dbfs marked constructor-
only, overlap range as 0 <= overlap < 1, composite hours constraints,
ln_levels shared-semantics row filled; ES translation leftovers and
the 'delante' typo fixed
- block-processing: y[..., -1] so the meter loop is multichannel-safe;
high_accuracy wording matches the real behavior (default resolves to
False, explicit True raises)
- API: CalibrationWarning row states the fs/validate preconditions (3 files)
- weighting: high_accuracy default column and oversampling claim made
precise (8x cap; silently ignored for G); ES row in parity
- filter-banks: 25 Hz relative bandwidth corrected to 0.024% of Nyquist
(EN/ES); verify_filter_class classes documented as 1/2/None
- generate_graphs: dropped the global plt.savefig monkey-patch - the
translation now runs inside themed_path(), which every generator
already calls at save time (verified output identical)
Claude-Session: https://claude.ai/code/session_013kkVt3nxi9svp1an28uHxf
Didactic documentation: theory everywhere, bilingual figures, setup diagrams, parameter tables (#77)
* docs: harden diagram engine per visual audit
- dim() draws real witness lines from the measured points to the offset
dimension line (the offset=0 path emitted zero-length lines); vertical
labels sit left of the line, clear of masts and figures
- env diagram: the 4 m dimension now measures the mic axis itself and
the flush-mounted label moved to the clear zone between masts
- tonality top view: the 1.00 m dimension connects face and microphone
Claude-Session: https://claude.ai/code/session_013kkVt3nxi9svp1an28uHxf
* docs: bilingual diagram variants (EN/ES x light/dark)
Every setup diagram is now emitted in four variants; Spanish strings
(including decimal commas) come from a translation table applied by the
SVG engine, and layouts were adjusted where the longer Spanish labels
collided (env titles, processing-chain box width, calibration output
label, tonality dimension label side).
Claude-Session: https://claude.ai/code/session_013kkVt3nxi9svp1an28uHxf
* docs: bilingual figure variants for the ES site (EN/ES x light/dark)
generate_graphs.py now emits every figure in four variants: a Spanish
translation table (~75 exact strings + parametrized patterns) is applied
to the figure's Text artists at savefig time, so the generator functions
stay single-language internally. Spanish output uses UNE terminology
(ponderación temporal, líneas isofónicas, fonios, ráfaga) and a uniform
decimal comma (annotations and tick labels included); code identifiers
and normative mode names (Fast/Slow/Impulse) stay untranslated. The ES
site pages now reference the _es/_es_dark variants (56 URLs). The ES set
passed a 10-figure visual audit (10/10 approved, no blockers).
Claude-Session: https://claude.ai/code/session_013kkVt3nxi9svp1an28uHxf
* docs: didactic calibration page - theory, setup diagram, stability figure, parameter table
Adds the sensitivity-factor derivation with the calibration-chain SVG,
a new autogenerated calibration_stability figure (stable vs 3% AM tone
against the IEC 60942:2017 class 1 deviation band; 4 language/theme
variants; the ES decimal-comma pass now preserves clause numbers like
5.3.3), and a full parameter table for calculate_sensitivity - EN and
ES in parity.
Claude-Session: https://claude.ai/code/session_013kkVt3nxi9svp1an28uHxf
* docs: SEL concept, Lden 24h profile and annotated TNR spectrum figures
Three new didactic figures for the levels guide, each in four
language/theme variants: sel_concept (pass-by event vs its Leq and the
equal-energy 1 s SEL block, dBFS mode), lden_profile (synthetic urban
24 h LAeq with colored day/evening/night bands and the +5/+10 weighted
period levels clearly separated from the composite Lden), and
tonality_spectrum (averaged Hann spectrum with the critical band, the
detected tone and the live TNR value vs its criterion, computed by the
library itself).
Claude-Session: https://claude.ai/code/session_013kkVt3nxi9svp1an28uHxf
* docs: didactic levels guide, theory extensions and refreshed why-phonometry
- levels guide (EN docs+site): energy-mean rationale for Leq, percentile
semantics for LN, SEL and noise-dose theory with the new figures
embedded, TNR critical-band explanation with the annotated spectrum,
Lden profile figure, and parameter tables (type/units/range/default)
for every level function including the spectrogram
- theory page: five new sections (G-weighting pole/zero derivation,
ISO 226 formulae, ECMA-418-1 TNR/PR math, event/dose metrics,
ISO 1996-1 descriptors) with cross-references to the guides
- why-phonometry: rewritten around the conformance-testing story with
the per-standard verification table and honest ecosystem positioning
Claude-Session: https://claude.ai/code/session_013kkVt3nxi9svp1an28uHxf
* docs: weighting/time-weighting theory and parameter tables; fix math-block delimiters
The physiological origin of A/C (inverted 40/100-phon contours, the four
IEC corner frequencies) and the exponential-detector derivation with the
tau semantics, each with full parameter tables. Display math inserted by
the docs expansion now always uses block-style $$ delimiters on their
own lines - mid-line multi-line $$ blocks silently derailed remark
parsing and truncated every heading after them (caught because the
built pages lost their anchor ids); also replaced a raw < in a table.
Claude-Session: https://claude.ai/code/session_013kkVt3nxi9svp1an28uHxf
* docs: processing-chain and multirate diagrams, filter-bank math, streaming patterns
- getting-started embeds the processing-chain diagram as a guided map of
the guides
- filter-banks gains the IEC 61260-1 base-10 band math (G, fm, band
edges), a new multirate-decimation diagram (d5, four language/theme
variants) and the full octavefilter/OctaveFilterBank parameter table
- block-processing gains the canonical real-time level-meter loop
(validated against the actual API - TimeWeighting is inherently
stateful) and a stateful-constraints table
- multichannel gains the accepted-shapes table
Claude-Session: https://claude.ai/code/session_013kkVt3nxi9svp1an28uHxf
* docs: Spanish parity for the didactic expansion
Every enriched page now has its Spanish twin: levels (theory, three new
figures via _es variants, six parameter tables), weighting and
time-weighting (curve-origin and exponential-detector sections),
filter-banks (fractional-band math, multirate diagram, full parameter
table - terminology unified on 'decimación'), getting-started
(processing-chain map), block-processing (real-time meter pattern and
stateful constraints), multichannel (shapes table), theory (five new
sections) and a full rewrite of why-phonometry around the conformance
story. API reference now covers all 27 public exports in EN and ES
(added ToneAssessment and CalibrationWarning rows). UNE terminology and
Spanish decimal commas throughout; site builds with all links valid.
Claude-Session: https://claude.ai/code/session_013kkVt3nxi9svp1an28uHxf
* docs: audited fixes - Spanish tick commas and multirate note
Final visual-audit round: the d5 diagram now shows the no-decimation
note on the 16 kHz row in both languages, and Spanish figures render
every numeric tick with a decimal comma (FixedFormatter sequences are
rewritten in place; set_xticklabels-style FuncFormatters and plain
linear ScalarFormatters are wrapped - the first naive wrapper broke
ScalarFormatter ticks entirely and was caught visually).
Claude-Session: https://claude.ai/code/session_013kkVt3nxi9svp1an28uHxf
* docs(site): language selector in the mobile header, scrollable display math
Custom Header component (default markup plus a compact icon-only
LanguageSelect visible below the md breakpoint, where Starlight hides
the whole right group behind the hamburger menu) and overflow-x on
katex-display so wide formulas scroll inside their box on phones.
Verified with Playwright at 390 px in EN and ES.
Claude-Session: https://claude.ai/code/session_013kkVt3nxi9svp1an28uHxf
* fix: address review feedback on the didactic docs
- levels tables: spectrogram calibration_factor/dbfs marked constructor-
only, overlap range as 0 <= overlap < 1, composite hours constraints,
ln_levels shared-semantics row filled; ES translation leftovers and
the 'delante' typo fixed
- block-processing: y[..., -1] so the meter loop is multichannel-safe;
high_accuracy wording matches the real behavior (default resolves to
False, explicit True raises)
- API: CalibrationWarning row states the fs/validate preconditions (3 files)
- weighting: high_accuracy default column and oversampling claim made
precise (8x cap; silently ignored for G); ES row in parity
- filter-banks: 25 Hz relative bandwidth corrected to 0.024% of Nyquist
(EN/ES); verify_filter_class classes documented as 1/2/None
- generate_graphs: dropped the global plt.savefig monkey-patch - the
translation now runs inside themed_path(), which every generator
already calls at save time (verified output identical)
Claude-Session: https://claude.ai/code/session_013kkVt3nxi9svp1an28uHxf
Didactic documentation: theory everywhere, bilingual figures, setup diagrams, parameter tables (#77)
* docs: harden diagram engine per visual audit
- dim() draws real witness lines from the measured points to the offset
dimension line (the offset=0 path emitted zero-length lines); vertical
labels sit left of the line, clear of masts and figures
- env diagram: the 4 m dimension now measures the mic axis itself and
the flush-mounted label moved to the clear zone between masts
- tonality top view: the 1.00 m dimension connects face and microphone
Claude-Session: https://claude.ai/code/session_013kkVt3nxi9svp1an28uHxf
* docs: bilingual diagram variants (EN/ES x light/dark)
Every setup diagram is now emitted in four variants; Spanish strings
(including decimal commas) come from a translation table applied by the
SVG engine, and layouts were adjusted where the longer Spanish labels
collided (env titles, processing-chain box width, calibration output
label, tonality dimension label side).
Claude-Session: https://claude.ai/code/session_013kkVt3nxi9svp1an28uHxf
* docs: bilingual figure variants for the ES site (EN/ES x light/dark)
generate_graphs.py now emits every figure in four variants: a Spanish
translation table (~75 exact strings + parametrized patterns) is applied
to the figure's Text artists at savefig time, so the generator functions
stay single-language internally. Spanish output uses UNE terminology
(ponderación temporal, líneas isofónicas, fonios, ráfaga) and a uniform
decimal comma (annotations and tick labels included); code identifiers
and normative mode names (Fast/Slow/Impulse) stay untranslated. The ES
site pages now reference the _es/_es_dark variants (56 URLs). The ES set
passed a 10-figure visual audit (10/10 approved, no blockers).
Claude-Session: https://claude.ai/code/session_013kkVt3nxi9svp1an28uHxf
* docs: didactic calibration page - theory, setup diagram, stability figure, parameter table
Adds the sensitivity-factor derivation with the calibration-chain SVG,
a new autogenerated calibration_stability figure (stable vs 3% AM tone
against the IEC 60942:2017 class 1 deviation band; 4 language/theme
variants; the ES decimal-comma pass now preserves clause numbers like
5.3.3), and a full parameter table for calculate_sensitivity - EN and
ES in parity.
Claude-Session: https://claude.ai/code/session_013kkVt3nxi9svp1an28uHxf
* docs: SEL concept, Lden 24h profile and annotated TNR spectrum figures
Three new didactic figures for the levels guide, each in four
language/theme variants: sel_concept (pass-by event vs its Leq and the
equal-energy 1 s SEL block, dBFS mode), lden_profile (synthetic urban
24 h LAeq with colored day/evening/night bands and the +5/+10 weighted
period levels clearly separated from the composite Lden), and
tonality_spectrum (averaged Hann spectrum with the critical band, the
detected tone and the live TNR value vs its criterion, computed by the
library itself).
Claude-Session: https://claude.ai/code/session_013kkVt3nxi9svp1an28uHxf
* docs: didactic levels guide, theory extensions and refreshed why-phonometry
- levels guide (EN docs+site): energy-mean rationale for Leq, percentile
semantics for LN, SEL and noise-dose theory with the new figures
embedded, TNR critical-band explanation with the annotated spectrum,
Lden profile figure, and parameter tables (type/units/range/default)
for every level function including the spectrogram
- theory page: five new sections (G-weighting pole/zero derivation,
ISO 226 formulae, ECMA-418-1 TNR/PR math, event/dose metrics,
ISO 1996-1 descriptors) with cross-references to the guides
- why-phonometry: rewritten around the conformance-testing story with
the per-standard verification table and honest ecosystem positioning
Claude-Session: https://claude.ai/code/session_013kkVt3nxi9svp1an28uHxf
* docs: weighting/time-weighting theory and parameter tables; fix math-block delimiters
The physiological origin of A/C (inverted 40/100-phon contours, the four
IEC corner frequencies) and the exponential-detector derivation with the
tau semantics, each with full parameter tables. Display math inserted by
the docs expansion now always uses block-style $$ delimiters on their
own lines - mid-line multi-line $$ blocks silently derailed remark
parsing and truncated every heading after them (caught because the
built pages lost their anchor ids); also replaced a raw < in a table.
Claude-Session: https://claude.ai/code/session_013kkVt3nxi9svp1an28uHxf
* docs: processing-chain and multirate diagrams, filter-bank math, streaming patterns
- getting-started embeds the processing-chain diagram as a guided map of
the guides
- filter-banks gains the IEC 61260-1 base-10 band math (G, fm, band
edges), a new multirate-decimation diagram (d5, four language/theme
variants) and the full octavefilter/OctaveFilterBank parameter table
- block-processing gains the canonical real-time level-meter loop
(validated against the actual API - TimeWeighting is inherently
stateful) and a stateful-constraints table
- multichannel gains the accepted-shapes table
Claude-Session: https://claude.ai/code/session_013kkVt3nxi9svp1an28uHxf
* docs: Spanish parity for the didactic expansion
Every enriched page now has its Spanish twin: levels (theory, three new
figures via _es variants, six parameter tables), weighting and
time-weighting (curve-origin and exponential-detector sections),
filter-banks (fractional-band math, multirate diagram, full parameter
table - terminology unified on 'decimación'), getting-started
(processing-chain map), block-processing (real-time meter pattern and
stateful constraints), multichannel (shapes table), theory (five new
sections) and a full rewrite of why-phonometry around the conformance
story. API reference now covers all 27 public exports in EN and ES
(added ToneAssessment and CalibrationWarning rows). UNE terminology and
Spanish decimal commas throughout; site builds with all links valid.
Claude-Session: https://claude.ai/code/session_013kkVt3nxi9svp1an28uHxf
* docs: audited fixes - Spanish tick commas and multirate note
Final visual-audit round: the d5 diagram now shows the no-decimation
note on the 16 kHz row in both languages, and Spanish figures render
every numeric tick with a decimal comma (FixedFormatter sequences are
rewritten in place; set_xticklabels-style FuncFormatters and plain
linear ScalarFormatters are wrapped - the first naive wrapper broke
ScalarFormatter ticks entirely and was caught visually).
Claude-Session: https://claude.ai/code/session_013kkVt3nxi9svp1an28uHxf
* docs(site): language selector in the mobile header, scrollable display math
Custom Header component (default markup plus a compact icon-only
LanguageSelect visible below the md breakpoint, where Starlight hides
the whole right group behind the hamburger menu) and overflow-x on
katex-display so wide formulas scroll inside their box on phones.
Verified with Playwright at 390 px in EN and ES.
Claude-Session: https://claude.ai/code/session_013kkVt3nxi9svp1an28uHxf
* fix: address review feedback on the didactic docs
- levels tables: spectrogram calibration_factor/dbfs marked constructor-
only, overlap range as 0 <= overlap < 1, composite hours constraints,
ln_levels shared-semantics row filled; ES translation leftovers and
the 'delante' typo fixed
- block-processing: y[..., -1] so the meter loop is multichannel-safe;
high_accuracy wording matches the real behavior (default resolves to
False, explicit True raises)
- API: CalibrationWarning row states the fs/validate preconditions (3 files)
- weighting: high_accuracy default column and oversampling claim made
precise (8x cap; silently ignored for G); ES row in parity
- filter-banks: 25 Hz relative bandwidth corrected to 0.024% of Nyquist
(EN/ES); verify_filter_class classes documented as 1/2/None
- generate_graphs: dropped the global plt.savefig monkey-patch - the
translation now runs inside themed_path(), which every generator
already calls at save time (verified output identical)
Claude-Session: https://claude.ai/code/session_013kkVt3nxi9svp1an28uHxf
Didactic documentation: theory everywhere, bilingual figures, setup diagrams, parameter tables (#77)
* docs: harden diagram engine per visual audit
- dim() draws real witness lines from the measured points to the offset
dimension line (the offset=0 path emitted zero-length lines); vertical
labels sit left of the line, clear of masts and figures
- env diagram: the 4 m dimension now measures the mic axis itself and
the flush-mounted label moved to the clear zone between masts
- tonality top view: the 1.00 m dimension connects face and microphone
Claude-Session: https://claude.ai/code/session_013kkVt3nxi9svp1an28uHxf
* docs: bilingual diagram variants (EN/ES x light/dark)
Every setup diagram is now emitted in four variants; Spanish strings
(including decimal commas) come from a translation table applied by the
SVG engine, and layouts were adjusted where the longer Spanish labels
collided (env titles, processing-chain box width, calibration output
label, tonality dimension label side).
Claude-Session: https://claude.ai/code/session_013kkVt3nxi9svp1an28uHxf
* docs: bilingual figure variants for the ES site (EN/ES x light/dark)
generate_graphs.py now emits every figure in four variants: a Spanish
translation table (~75 exact strings + parametrized patterns) is applied
to the figure's Text artists at savefig time, so the generator functions
stay single-language internally. Spanish output uses UNE terminology
(ponderación temporal, líneas isofónicas, fonios, ráfaga) and a uniform
decimal comma (annotations and tick labels included); code identifiers
and normative mode names (Fast/Slow/Impulse) stay untranslated. The ES
site pages now reference the _es/_es_dark variants (56 URLs). The ES set
passed a 10-figure visual audit (10/10 approved, no blockers).
Claude-Session: https://claude.ai/code/session_013kkVt3nxi9svp1an28uHxf
* docs: didactic calibration page - theory, setup diagram, stability figure, parameter table
Adds the sensitivity-factor derivation with the calibration-chain SVG,
a new autogenerated calibration_stability figure (stable vs 3% AM tone
against the IEC 60942:2017 class 1 deviation band; 4 language/theme
variants; the ES decimal-comma pass now preserves clause numbers like
5.3.3), and a full parameter table for calculate_sensitivity - EN and
ES in parity.
Claude-Session: https://claude.ai/code/session_013kkVt3nxi9svp1an28uHxf
* docs: SEL concept, Lden 24h profile and annotated TNR spectrum figures
Three new didactic figures for the levels guide, each in four
language/theme variants: sel_concept (pass-by event vs its Leq and the
equal-energy 1 s SEL block, dBFS mode), lden_profile (synthetic urban
24 h LAeq with colored day/evening/night bands and the +5/+10 weighted
period levels clearly separated from the composite Lden), and
tonality_spectrum (averaged Hann spectrum with the critical band, the
detected tone and the live TNR value vs its criterion, computed by the
library itself).
Claude-Session: https://claude.ai/code/session_013kkVt3nxi9svp1an28uHxf
* docs: didactic levels guide, theory extensions and refreshed why-phonometry
- levels guide (EN docs+site): energy-mean rationale for Leq, percentile
semantics for LN, SEL and noise-dose theory with the new figures
embedded, TNR critical-band explanation with the annotated spectrum,
Lden profile figure, and parameter tables (type/units/range/default)
for every level function including the spectrogram
- theory page: five new sections (G-weighting pole/zero derivation,
ISO 226 formulae, ECMA-418-1 TNR/PR math, event/dose metrics,
ISO 1996-1 descriptors) with cross-references to the guides
- why-phonometry: rewritten around the conformance-testing story with
the per-standard verification table and honest ecosystem positioning
Claude-Session: https://claude.ai/code/session_013kkVt3nxi9svp1an28uHxf
* docs: weighting/time-weighting theory and parameter tables; fix math-block delimiters
The physiological origin of A/C (inverted 40/100-phon contours, the four
IEC corner frequencies) and the exponential-detector derivation with the
tau semantics, each with full parameter tables. Display math inserted by
the docs expansion now always uses block-style $$ delimiters on their
own lines - mid-line multi-line $$ blocks silently derailed remark
parsing and truncated every heading after them (caught because the
built pages lost their anchor ids); also replaced a raw < in a table.
Claude-Session: https://claude.ai/code/session_013kkVt3nxi9svp1an28uHxf
* docs: processing-chain and multirate diagrams, filter-bank math, streaming patterns
- getting-started embeds the processing-chain diagram as a guided map of
the guides
- filter-banks gains the IEC 61260-1 base-10 band math (G, fm, band
edges), a new multirate-decimation diagram (d5, four language/theme
variants) and the full octavefilter/OctaveFilterBank parameter table
- block-processing gains the canonical real-time level-meter loop
(validated against the actual API - TimeWeighting is inherently
stateful) and a stateful-constraints table
- multichannel gains the accepted-shapes table
Claude-Session: https://claude.ai/code/session_013kkVt3nxi9svp1an28uHxf
* docs: Spanish parity for the didactic expansion
Every enriched page now has its Spanish twin: levels (theory, three new
figures via _es variants, six parameter tables), weighting and
time-weighting (curve-origin and exponential-detector sections),
filter-banks (fractional-band math, multirate diagram, full parameter
table - terminology unified on 'decimación'), getting-started
(processing-chain map), block-processing (real-time meter pattern and
stateful constraints), multichannel (shapes table), theory (five new
sections) and a full rewrite of why-phonometry around the conformance
story. API reference now covers all 27 public exports in EN and ES
(added ToneAssessment and CalibrationWarning rows). UNE terminology and
Spanish decimal commas throughout; site builds with all links valid.
Claude-Session: https://claude.ai/code/session_013kkVt3nxi9svp1an28uHxf
* docs: audited fixes - Spanish tick commas and multirate note
Final visual-audit round: the d5 diagram now shows the no-decimation
note on the 16 kHz row in both languages, and Spanish figures render
every numeric tick with a decimal comma (FixedFormatter sequences are
rewritten in place; set_xticklabels-style FuncFormatters and plain
linear ScalarFormatters are wrapped - the first naive wrapper broke
ScalarFormatter ticks entirely and was caught visually).
Claude-Session: https://claude.ai/code/session_013kkVt3nxi9svp1an28uHxf
* docs(site): language selector in the mobile header, scrollable display math
Custom Header component (default markup plus a compact icon-only
LanguageSelect visible below the md breakpoint, where Starlight hides
the whole right group behind the hamburger menu) and overflow-x on
katex-display so wide formulas scroll inside their box on phones.
Verified with Playwright at 390 px in EN and ES.
Claude-Session: https://claude.ai/code/session_013kkVt3nxi9svp1an28uHxf
* fix: address review feedback on the didactic docs
- levels tables: spectrogram calibration_factor/dbfs marked constructor-
only, overlap range as 0 <= overlap < 1, composite hours constraints,
ln_levels shared-semantics row filled; ES translation leftovers and
the 'delante' typo fixed
- block-processing: y[..., -1] so the meter loop is multichannel-safe;
high_accuracy wording matches the real behavior (default resolves to
False, explicit True raises)
- API: CalibrationWarning row states the fs/validate preconditions (3 files)
- weighting: high_accuracy default column and oversampling claim made
precise (8x cap; silently ignored for G); ES row in parity
- filter-banks: 25 Hz relative bandwidth corrected to 0.024% of Nyquist
(EN/ES); verify_filter_class classes documented as 1/2/None
- generate_graphs: dropped the global plt.savefig monkey-patch - the
translation now runs inside themed_path(), which every generator
already calls at save time (verified output identical)
Claude-Session: https://claude.ai/code/session_013kkVt3nxi9svp1an28uHxf
feat: noise-induced hearing loss (ISO 1999:2013 NIPTS and HTLAN) (#103)
Adds a `phonometry.iso1999` module estimating occupational noise-induced hearing loss, extending the ISO 7029 age-related threshold with a noise component.
* `nipts(l_ex, years, fractile)` — noise-induced permanent threshold shift over 500-6000 Hz: median N50 (clause 6.3.1, Formula 2/3, Table 1) and population fractiles from the half-Gaussian spreads du/dl (clause 6.3.2, Formulae 4-7, Tables 2-3), clamped at zero.
* `htlan(age, sex, l_ex, years, fractile)` — hearing threshold level associated with age and noise, combining the age component (HTLA = ISO 7029) with the NIPTS by H' = H + N - H*N/120 (clause 6.1, Formula 1).
Validated against ISO 1999 Annex D (Tables D.1-D.4, 85-100 dB, 10-40 years): reproduces every tabulated dB value. Conformance 82/82; full suite 1686 passed. Figure + two-lane NIHL diagram (EN/ES, light/dark), repo doc and EN/ES site guides.
feat: noise-induced hearing loss (ISO 1999:2013 NIPTS and HTLAN) (#103)
Adds a `phonometry.iso1999` module estimating occupational noise-induced hearing loss, extending the ISO 7029 age-related threshold with a noise component.
* `nipts(l_ex, years, fractile)` — noise-induced permanent threshold shift over 500-6000 Hz: median N50 (clause 6.3.1, Formula 2/3, Table 1) and population fractiles from the half-Gaussian spreads du/dl (clause 6.3.2, Formulae 4-7, Tables 2-3), clamped at zero.
* `htlan(age, sex, l_ex, years, fractile)` — hearing threshold level associated with age and noise, combining the age component (HTLA = ISO 7029) with the NIPTS by H' = H + N - H*N/120 (clause 6.1, Formula 1).
Validated against ISO 1999 Annex D (Tables D.1-D.4, 85-100 dB, 10-40 years): reproduces every tabulated dB value. Conformance 82/82; full suite 1686 passed. Figure + two-lane NIHL diagram (EN/ES, light/dark), repo doc and EN/ES site guides.
feat: noise-induced hearing loss (ISO 1999:2013 NIPTS and HTLAN) (#103)
Adds a `phonometry.iso1999` module estimating occupational noise-induced hearing loss, extending the ISO 7029 age-related threshold with a noise component.
* `nipts(l_ex, years, fractile)` — noise-induced permanent threshold shift over 500-6000 Hz: median N50 (clause 6.3.1, Formula 2/3, Table 1) and population fractiles from the half-Gaussian spreads du/dl (clause 6.3.2, Formulae 4-7, Tables 2-3), clamped at zero.
* `htlan(age, sex, l_ex, years, fractile)` — hearing threshold level associated with age and noise, combining the age component (HTLA = ISO 7029) with the NIPTS by H' = H + N - H*N/120 (clause 6.1, Formula 1).
Validated against ISO 1999 Annex D (Tables D.1-D.4, 85-100 dB, 10-40 years): reproduces every tabulated dB value. Conformance 82/82; full suite 1686 passed. Figure + two-lane NIHL diagram (EN/ES, light/dark), repo doc and EN/ES site guides.
feat: noise-induced hearing loss (ISO 1999:2013 NIPTS and HTLAN) (#103)
Adds a `phonometry.iso1999` module estimating occupational noise-induced hearing loss, extending the ISO 7029 age-related threshold with a noise component.
* `nipts(l_ex, years, fractile)` — noise-induced permanent threshold shift over 500-6000 Hz: median N50 (clause 6.3.1, Formula 2/3, Table 1) and population fractiles from the half-Gaussian spreads du/dl (clause 6.3.2, Formulae 4-7, Tables 2-3), clamped at zero.
* `htlan(age, sex, l_ex, years, fractile)` — hearing threshold level associated with age and noise, combining the age component (HTLA = ISO 7029) with the NIPTS by H' = H + N - H*N/120 (clause 6.1, Formula 1).
Validated against ISO 1999 Annex D (Tables D.1-D.4, 85-100 dB, 10-40 years): reproduces every tabulated dB value. Conformance 82/82; full suite 1686 passed. Figure + two-lane NIHL diagram (EN/ES, light/dark), repo doc and EN/ES site guides.
NT ACOU 112: impulsive-sound prominence and LAeq adjustment (#105)
* feat: NT ACOU 112 impulsive-sound prominence and LAeq adjustment
Add the Nordtest NT ACOU 112:2002 method for the prominence of
impulsive sounds: the predicted prominence P = 3 lg(OR) + 2 lg(LD)
from each impulse's onset rate and level difference (clause 7,
Formula 1), the graduated adjustment KI = 1.8 (P - 5) dB for P > 5
(clause 8, Formula 2), and the rating level over a reference time
interval (clause 8, Note 1).
New module phonometry.ntacou112 with predicted_prominence,
impulse_adjustment, impulse_prominence (ImpulseProminence result with
.plot()) and rating_level. Conformance report gains an impulsive-sound
domain (2 checks). Adds the impulse-prominence guide (repo + EN/ES
site) with figure and flow diagram.
* refactor: address review feedback on NT ACOU 112
- impulse_prominence: ravel inputs so multi-dimensional arrays flatten
to a 1-D impulse sequence (Gemini)
- figure: use a distinct neutral for the threshold line instead of the
grid color, matching plot_impulse_prominence (Gemini)
- tests: use the shared NTACOU_PROMINENCE / NTACOU_ADJUSTMENT_P10
reference constants instead of hardcoded literals (CodeRabbit)
* refactor: second-pass review polish for NT ACOU 112
- figure: give the impulse markers a distinct light blue (#aec7e8),
matching plot_impulse_prominence, so they read apart from the neutral
threshold line (CodeRabbit)
- tests: split the chained magnitude/approx assertion into two clearer
assertions (CodeRabbit)
NT ACOU 112: impulsive-sound prominence and LAeq adjustment (#105)
* feat: NT ACOU 112 impulsive-sound prominence and LAeq adjustment
Add the Nordtest NT ACOU 112:2002 method for the prominence of
impulsive sounds: the predicted prominence P = 3 lg(OR) + 2 lg(LD)
from each impulse's onset rate and level difference (clause 7,
Formula 1), the graduated adjustment KI = 1.8 (P - 5) dB for P > 5
(clause 8, Formula 2), and the rating level over a reference time
interval (clause 8, Note 1).
New module phonometry.ntacou112 with predicted_prominence,
impulse_adjustment, impulse_prominence (ImpulseProminence result with
.plot()) and rating_level. Conformance report gains an impulsive-sound
domain (2 checks). Adds the impulse-prominence guide (repo + EN/ES
site) with figure and flow diagram.
* refactor: address review feedback on NT ACOU 112
- impulse_prominence: ravel inputs so multi-dimensional arrays flatten
to a 1-D impulse sequence (Gemini)
- figure: use a distinct neutral for the threshold line instead of the
grid color, matching plot_impulse_prominence (Gemini)
- tests: use the shared NTACOU_PROMINENCE / NTACOU_ADJUSTMENT_P10
reference constants instead of hardcoded literals (CodeRabbit)
* refactor: second-pass review polish for NT ACOU 112
- figure: give the impulse markers a distinct light blue (#aec7e8),
matching plot_impulse_prominence, so they read apart from the neutral
threshold line (CodeRabbit)
- tests: split the chained magnitude/approx assertion into two clearer
assertions (CodeRabbit)
Audit pass 7: bilingual EN/ES consistency (#116)
* docs: bilingual EN/ES consistency batch
Audit batch 7 - the Spanish side catches up with the English one:
Content drift: the five per-architecture filter figures join the ES
filter-banks guide; the missing outdoor-propagation card joins the ES
index (7 cards on both sides); the sound-power card says five methods
in both languages (it said three since before ISO 3745/9614-3).
Decimals: the four prose dot-decimals and four code-comment
comma-decimals fixed per convention, and the systematic LaTeX {,}
migration lands - 146 conversions across 16 ES files, every hit
manually reviewed (clause numbers, standard designations, def.:
literals and code identifiers deliberately untouched; zero \d.\d
remain in ES math). The theory band-edge table keeps points (it
mirrors a code snippet's printed output); the why-phonometry report
tables convert to commas (prose).
Terminology unified: fonios, diezmado (including the divergent
multirate alt pair), umbral de audicion, banda atenuada, nivel de
evaluacion (including the rendered NT ACOU 112 ES diagram - the
generator string is fixed and only that SVG pair regenerated),
sharpness (agudeza), and clausula/apartado unified per file majority
(theory: clausula; api: apartado).
Code comments: 22 English comments translated across gum-uncertainty,
hearing-threshold, noise-induced-hearing-loss, room-noise and
occupational-exposure ES (the occupational f-string outputs were
re-executed and match the echoed comments byte-for-byte).
* docs: 'atenuación en banda atenuada' in the ES filter guide
The glossary fix produced a clumsy repetition ('atenuación de banda
atenuada'); the natural phrasing for stopband attenuation is 'en'
(Copilot).
* docs: the sound-power cards enumerate the guide's five routes exactly
The card grouped ISO 9614-2/3 into one item, making 'five routes' read
as four groups (or six standards); it now mirrors the guide's canonical
five-item enumeration, in both languages (CodeRabbit).
Audit pass 7: bilingual EN/ES consistency (#116)
* docs: bilingual EN/ES consistency batch
Audit batch 7 - the Spanish side catches up with the English one:
Content drift: the five per-architecture filter figures join the ES
filter-banks guide; the missing outdoor-propagation card joins the ES
index (7 cards on both sides); the sound-power card says five methods
in both languages (it said three since before ISO 3745/9614-3).
Decimals: the four prose dot-decimals and four code-comment
comma-decimals fixed per convention, and the systematic LaTeX {,}
migration lands - 146 conversions across 16 ES files, every hit
manually reviewed (clause numbers, standard designations, def.:
literals and code identifiers deliberately untouched; zero \d.\d
remain in ES math). The theory band-edge table keeps points (it
mirrors a code snippet's printed output); the why-phonometry report
tables convert to commas (prose).
Terminology unified: fonios, diezmado (including the divergent
multirate alt pair), umbral de audicion, banda atenuada, nivel de
evaluacion (including the rendered NT ACOU 112 ES diagram - the
generator string is fixed and only that SVG pair regenerated),
sharpness (agudeza), and clausula/apartado unified per file majority
(theory: clausula; api: apartado).
Code comments: 22 English comments translated across gum-uncertainty,
hearing-threshold, noise-induced-hearing-loss, room-noise and
occupational-exposure ES (the occupational f-string outputs were
re-executed and match the echoed comments byte-for-byte).
* docs: 'atenuación en banda atenuada' in the ES filter guide
The glossary fix produced a clumsy repetition ('atenuación de banda
atenuada'); the natural phrasing for stopband attenuation is 'en'
(Copilot).
* docs: the sound-power cards enumerate the guide's five routes exactly
The card grouped ISO 9614-2/3 into one item, making 'five routes' read
as four groups (or six standards); it now mirrors the guide's canonical
five-item enumeration, in both languages (CodeRabbit).
Audit pass 11a: seven new documentation diagrams (#121)
* Audit pass 11a: seven new documentation diagrams
Add SVG flow diagrams for the seven topics the audit flagged as having no
schematic: the exponential-detector chain of the time weightings
(IEC 61672-1), stateful vs reset block processing, the multichannel
array-shape flow, the open-plan spatial-decay line (ISO 3382-3), the
ISO 12999-1 uncertainty pipeline, the ISO 11654 absorption-rating flow and
the Zwicker loudness-model chain (ISO 532-1).
Each is generated deterministically by generate_diagrams.py in the four
EN/ES x light/dark variants, with every Spanish label added to the _ES
table (decimals localised to commas), and embedded in the repo docs and
both site trees beside the existing worked-example plots.
* Fix ISO 532-1 table citations in the Zwicker diagram
Review of the diagram against loudness_zwicker.py found two mislabelled
tables: the equal-loudness correction and lower-critical-band grouping is
Table A.3 (not A.4), and the threshold in quiet LTQ is Table A.6 (not A.3).
Reassign the a0/DDF/LTQ corrections to the core-loudness step (Tables
A.4-A.7) where they belong, update the Spanish labels, and align the ES
psychoacoustics alt text with the guide's own term "sonos" (was "sonios").
Audit pass 11a: seven new documentation diagrams (#121)
* Audit pass 11a: seven new documentation diagrams
Add SVG flow diagrams for the seven topics the audit flagged as having no
schematic: the exponential-detector chain of the time weightings
(IEC 61672-1), stateful vs reset block processing, the multichannel
array-shape flow, the open-plan spatial-decay line (ISO 3382-3), the
ISO 12999-1 uncertainty pipeline, the ISO 11654 absorption-rating flow and
the Zwicker loudness-model chain (ISO 532-1).
Each is generated deterministically by generate_diagrams.py in the four
EN/ES x light/dark variants, with every Spanish label added to the _ES
table (decimals localised to commas), and embedded in the repo docs and
both site trees beside the existing worked-example plots.
* Fix ISO 532-1 table citations in the Zwicker diagram
Review of the diagram against loudness_zwicker.py found two mislabelled
tables: the equal-loudness correction and lower-critical-band grouping is
Table A.3 (not A.4), and the threshold in quiet LTQ is Table A.6 (not A.3).
Reassign the a0/DDF/LTQ corrections to the core-loudness step (Tables
A.4-A.7) where they belong, update the Spanish labels, and align the ES
psychoacoustics alt text with the guide's own term "sonos" (was "sonios").
Audit pass 11a: seven new documentation diagrams (#121)
* Audit pass 11a: seven new documentation diagrams
Add SVG flow diagrams for the seven topics the audit flagged as having no
schematic: the exponential-detector chain of the time weightings
(IEC 61672-1), stateful vs reset block processing, the multichannel
array-shape flow, the open-plan spatial-decay line (ISO 3382-3), the
ISO 12999-1 uncertainty pipeline, the ISO 11654 absorption-rating flow and
the Zwicker loudness-model chain (ISO 532-1).
Each is generated deterministically by generate_diagrams.py in the four
EN/ES x light/dark variants, with every Spanish label added to the _ES
table (decimals localised to commas), and embedded in the repo docs and
both site trees beside the existing worked-example plots.
* Fix ISO 532-1 table citations in the Zwicker diagram
Review of the diagram against loudness_zwicker.py found two mislabelled
tables: the equal-loudness correction and lower-critical-band grouping is
Table A.3 (not A.4), and the threshold in quiet LTQ is Table A.6 (not A.3).
Reassign the a0/DDF/LTQ corrections to the core-loudness step (Tables
A.4-A.7) where they belong, update the Spanish labels, and align the ES
psychoacoustics alt text with the guide's own term "sonos" (was "sonios").
Audit pass 11a: seven new documentation diagrams (#121)
* Audit pass 11a: seven new documentation diagrams
Add SVG flow diagrams for the seven topics the audit flagged as having no
schematic: the exponential-detector chain of the time weightings
(IEC 61672-1), stateful vs reset block processing, the multichannel
array-shape flow, the open-plan spatial-decay line (ISO 3382-3), the
ISO 12999-1 uncertainty pipeline, the ISO 11654 absorption-rating flow and
the Zwicker loudness-model chain (ISO 532-1).
Each is generated deterministically by generate_diagrams.py in the four
EN/ES x light/dark variants, with every Spanish label added to the _ES
table (decimals localised to commas), and embedded in the repo docs and
both site trees beside the existing worked-example plots.
* Fix ISO 532-1 table citations in the Zwicker diagram
Review of the diagram against loudness_zwicker.py found two mislabelled
tables: the equal-loudness correction and lower-critical-band grouping is
Table A.3 (not A.4), and the threshold in quiet LTQ is Table A.6 (not A.3).
Reassign the a0/DDF/LTQ corrections to the core-loudness step (Tables
A.4-A.7) where they belong, update the Spanish labels, and align the ES
psychoacoustics alt text with the guide's own term "sonos" (was "sonios").
Outdoor sound propagation and occupational noise exposure (ISO 9613-1, ISO 9613-2, ISO 9612) (#89)
* feat: ISO 9613-1 atmospheric sound absorption
Full alpha(f, T, RH, p) model per ISO 9613-1:1993 clauses 6.2-6.4:
oxygen/nitrogen relaxation frequencies, water-vapour molar
concentration from relative humidity, classical + rotational +
vibrational terms. Validated against a 13-point Table 1 grid
(worst deviation 0.39 %, rounding-limited, vs the standard's
stated +/-10 % accuracy) with the exact midband convention of
Eq. (6) Note 5. air_attenuation_m() feeds the ISO 354 m parameter
directly, closing the user-supplied gap. Two conformance checks
added (34/34).
Claude-Session: https://claude.ai/code/session_013kkVt3nxi9svp1an28uHxf
* refactor: C1 review nits — test name and comment direction
Claude-Session: https://claude.ai/code/session_013kkVt3nxi9svp1an28uHxf
* test: extend ISO 9613-1 Table 1 oracle against the full standard text
The full 37-page ISO 9613-1:1993 text (now in hand) confirms every
implemented constant of Eqs. (3)-(6), the Annex B psychrometric
conversion and the clause 4.2 reference conditions exactly as coded.
Oracle extended from 13 to 23 Table 1 points, adding the 20-50 degC
sub-tables 1(i)-1(p) unavailable in the interim source. Worst
deviation unchanged at 0.385 % (rounding-limited).
Claude-Session: https://claude.ai/code/session_013kkVt3nxi9svp1an28uHxf
* feat: ISO 9613-2 outdoor sound propagation
Implement the ISO 9613-2:1996 general method for octave-band outdoor sound
attenuation: geometrical divergence (Eq. 7), atmospheric absorption (Eq. 8,
via ISO 9613-1 air_absorption), ground effect (general per-region method of
7.3.1 with the Table 3 a'/b'/c'/d' functions, Eq. 9, plus the alternative
method of 7.3.2, Eq. 10, and the DOmega index Eq. 11), and screening (Eq. 12-18
with the C2/C3 factors, single/double diffraction, Kmet and the 20/25 dB caps).
Adds the Cmet meteorological correction (Eq. 21/22) and the LfT(DW)=Lw+Dc-A
receiver-level composition (Eq. 3/6). Frozen dataclass result exposes the
per-term breakdown (Adiv/Aatm/Agr/Abar). New module, tests and exports.
Claude-Session: https://claude.ai/code/session_013kkVt3nxi9svp1an28uHxf
* feat: ISO 9612 occupational noise exposure strategies and uncertainty
Add phonometry.occupational_exposure implementing the three ISO 9612:2009
measurement strategies and the normative Annex C uncertainty budget:
- task_based_exposure (Clause 9): per-task energy average (Eq 7), task
contributions (Eq 8), daily level (Eq 9/10); uncertainty Eq C.3 with
sampling u1a (Eq C.6), duration u1b (Eq C.7) and sensitivity coefficients
c1a (Eq C.4) / c1b (Eq C.5).
- job_based_exposure (Clause 10): effective-day energy average (Eq 11),
daily level (Eq 12); Table 1 minimum-duration check; uncertainty Eq C.9.
- full_day_exposure (Clause 11): whole-day averaging (Eq 11/13) with the
Clause 11.3 three-measurement / 3 dB spread rule.
- Table C.4 (job/full-day c1*u1, bilinear interpolation), Table C.5 (u2),
u3 = 1.0 dB, coverage factor k = 1.65 (one-sided 95 %).
Frozen dataclasses (Task, TaskContribution, ExposureResult), ExposureWarning
advisories for the sampling rules, and exports appended to __init__.
Tests reproduce the Annex D (task), E (job) and F (full-day) worked examples
to the standard's precision, plus closed-form oracles (single 85 dB/8 h task
= 85; equal-level tasks; -3.01 dB per halved duration; k = 1.65) and the
Table C.4 / Table 1 lookups. make check green: 1167 passed, 12 skipped.
Claude-Session: https://claude.ai/code/session_013kkVt3nxi9svp1an28uHxf
* fix: ISO 9612 review corrections — Table C.4 digits and Eq C.7 denominator
Two Table C.4 cells verified against the page image at 200 dpi and
corrected (N=6/u1=3.5: 3.4 -> 3.3; N=20/u1=2.0: 0.6 -> 0.5), the test
that echoed the wrong N=6 cell now pins the printed value plus the
corrected N=20 cell. The duration_samples branch of Eq C.7 divides by
J(J-1) like Eq C.6 (standard error of the mean), with a regression test
pinning u1b = 1.0 h for samples (4, 6) h. Module docstring now states
the Lp,Cpeak uncertainty scope cut (Table C.5, NOTE 1).
Claude-Session: https://claude.ai/code/session_01HUHMx4dxDes2t5UPQ25djP
* test: ISO 9613-2 and ISO 9612 conformance checks
Add a new "Outdoor propagation & occupational exposure" conformance domain
with seven closed-form / worked-example checks backed by shared constants in
tests/reference_data.py:
- ISO 9613-2:1996 Eq. (7) geometrical divergence Adiv = 51 dB at 100 m.
- ISO 9613-2:1996 Table 3 ground limit b'(0) = 10,1 -> Agr(250 Hz) = 17,2 dB
(porous ground, hs = hr = 0, dp -> inf).
- ISO 9613-2:1996 clause 7.4 single/double diffraction 20/25 dB caps.
- ISO 9612:2009 Annex D/E/F daily exposure LEX,8h and expanded uncertainty U
(84,3/2,7, 88,1/3,8, 90,1/3,4 dB), the Task objects rebuilt from the shared
input table.
Registry grows 34 -> 41 checks across 8 domains; docs/CONFORMANCE.md
regenerated via make conformance. Registration and reference-data consistency
tests pin the constants to the published values.
Claude-Session: https://claude.ai/code/session_01HUHMx4dxDes2t5UPQ25djP
* docs: figures for outdoor propagation and occupational exposure
Add four documentation figures (each EN/ES x light/dark) plus a setup diagram:
- air_absorption_alpha: ISO 9613-1 alpha(f) over frequency at four
temperature/humidity combinations (relaxation roll-off, f^2 growth).
- outdoor_attenuation_breakdown: ISO 9613-2 per-term stacked bar (Adiv, Aatm,
Agr, Abar) with the total A, for a 200 m path over porous ground with a 4 m
barrier.
- exposure_uncertainty: ISO 9612 Annex D task contributions with the daily
LEX,8h and the one-sided 95 % upper limit LEX,8h + U.
- diagram_outdoor_geometry: source-barrier-receiver geometry (dss/dsr/z, the
blocked direct ray and the diffracted ray over the top edge).
Spanish translations added to the generate_graphs / generate_diagrams
dictionaries (decimal commas, UNE terminology). Every image visually audited.
Claude-Session: https://claude.ai/code/session_01HUHMx4dxDes2t5UPQ25djP
* docs: ISO 9613-1/2 outdoor propagation guide and ISO 9612 exposure (EN)
Add the didactic Outdoor Sound Propagation guide (docs/outdoor-propagation.md)
covering ISO 9613-1 atmospheric absorption and the ISO 9613-2 general method
(divergence, atmospheric, ground and barrier terms, the OutdoorAttenuation
breakdown, the alternative 7.3.2 ground method, Cmet), with executed snippets
and honest scope notes (Amisc/reflections not implemented, 7.3.2 not
auto-wired, per-band Cmet a convenience). Extend the Levels guide with the
ISO 9612 occupational-exposure section (task/job/full-day strategies, the
C.6 I(I-1) vs C.12 N-1 asymmetry, Table C.4, k = 1,65, LEX,8h + U upper limit,
Lp,Cpeak uncertainty out of scope), reproducing the Annex D/E/F worked
examples.
Add the matching theory sections, API-reference rows for every new public
name, README feature list + docs table, docs index and CHANGELOG entries.
llms-full.txt / llms.txt regenerated (make llms) with the new page wired into
gen_llms.py. GitHub-safe math throughout; every snippet executed with pasted
outputs.
Claude-Session: https://claude.ai/code/session_01HUHMx4dxDes2t5UPQ25djP
* docs: outdoor propagation and exposure site twins (EN + ES)
Add the English and Spanish Starlight twins of the new content:
- guides/outdoor-propagation.md (EN + ES) — code-identical snippets to the
docs page; Spanish prose uses UNE terminology ("ponderación temporal"),
decimal commas outside math and code, and the _es figure variants.
- The ISO 9612 section added to guides/levels.md (EN + ES).
- reference/theory.md and reference/api.md rows (EN + ES).
- Landing cards and standards list bumped 34 -> 37 (index.mdx EN + ES);
guides/outdoor-propagation added to the sidebar.
Claude-Session: https://claude.ai/code/session_01HUHMx4dxDes2t5UPQ25djP
* fix: final branch review — API rows, precision phrasing and ES links
Adds the five missing public-symbol rows (TaskContribution,
table_c4_contribution, minimum_cumulative_duration_hours, COVERAGE_FACTOR,
INSTRUMENT_U2) to the three API references, states the ISO 9613-2 default
atmosphere (20 °C / 70 %, a Table 2 reference atmosphere) in the API rows
and guides, and softens "digit-for-digit" to "the standard's printed
precision" wherever it covered Annex E, whose final level differs only by
the standard's own pre-rounding. ES pages now use the /es/ link prefix
consistently. Code nits from the review: dead arg > 1 guard removed
(z > 0 implies arg >= 3), _with_advisory uses dataclasses.replace, and the
float-keyed _PRIME_BY_BAND gets a safety comment. llms files regenerated.
Claude-Session: https://claude.ai/code/session_01HUHMx4dxDes2t5UPQ25djP
* fix: validate propagation/exposure inputs and docs lint (PR review)
Addresses the PR #89 bot review:
- Barrier.__post_init__ rejects negative edge distances and a zero
edge_separation (which previously divided by zero in the C3 double-
diffraction factor); Task.__post_init__ rejects empty samples and a
non-positive duration.
- ground_attenuation and barrier_attenuation reject non-positive
frequencies (a zero frequency gave an infinite wavelength / division by
zero); ground_attenuation also checks a positive distance and
non-negative heights. job_based_exposure rejects a non-positive
sample_duration_hours.
- Rewrite the ISO 9613-2 7.3.2 closed form in the guides and API tables so
Markdownlint no longer parses `(...)[...]` as a reversed link (MD011).
- Regression tests for every new guard; docstrings note the new raises.
Claude-Session: https://claude.ai/code/session_01HUHMx4dxDes2t5UPQ25djP
Outdoor sound propagation and occupational noise exposure (ISO 9613-1, ISO 9613-2, ISO 9612) (#89)
* feat: ISO 9613-1 atmospheric sound absorption
Full alpha(f, T, RH, p) model per ISO 9613-1:1993 clauses 6.2-6.4:
oxygen/nitrogen relaxation frequencies, water-vapour molar
concentration from relative humidity, classical + rotational +
vibrational terms. Validated against a 13-point Table 1 grid
(worst deviation 0.39 %, rounding-limited, vs the standard's
stated +/-10 % accuracy) with the exact midband convention of
Eq. (6) Note 5. air_attenuation_m() feeds the ISO 354 m parameter
directly, closing the user-supplied gap. Two conformance checks
added (34/34).
Claude-Session: https://claude.ai/code/session_013kkVt3nxi9svp1an28uHxf
* refactor: C1 review nits — test name and comment direction
Claude-Session: https://claude.ai/code/session_013kkVt3nxi9svp1an28uHxf
* test: extend ISO 9613-1 Table 1 oracle against the full standard text
The full 37-page ISO 9613-1:1993 text (now in hand) confirms every
implemented constant of Eqs. (3)-(6), the Annex B psychrometric
conversion and the clause 4.2 reference conditions exactly as coded.
Oracle extended from 13 to 23 Table 1 points, adding the 20-50 degC
sub-tables 1(i)-1(p) unavailable in the interim source. Worst
deviation unchanged at 0.385 % (rounding-limited).
Claude-Session: https://claude.ai/code/session_013kkVt3nxi9svp1an28uHxf
* feat: ISO 9613-2 outdoor sound propagation
Implement the ISO 9613-2:1996 general method for octave-band outdoor sound
attenuation: geometrical divergence (Eq. 7), atmospheric absorption (Eq. 8,
via ISO 9613-1 air_absorption), ground effect (general per-region method of
7.3.1 with the Table 3 a'/b'/c'/d' functions, Eq. 9, plus the alternative
method of 7.3.2, Eq. 10, and the DOmega index Eq. 11), and screening (Eq. 12-18
with the C2/C3 factors, single/double diffraction, Kmet and the 20/25 dB caps).
Adds the Cmet meteorological correction (Eq. 21/22) and the LfT(DW)=Lw+Dc-A
receiver-level composition (Eq. 3/6). Frozen dataclass result exposes the
per-term breakdown (Adiv/Aatm/Agr/Abar). New module, tests and exports.
Claude-Session: https://claude.ai/code/session_013kkVt3nxi9svp1an28uHxf
* feat: ISO 9612 occupational noise exposure strategies and uncertainty
Add phonometry.occupational_exposure implementing the three ISO 9612:2009
measurement strategies and the normative Annex C uncertainty budget:
- task_based_exposure (Clause 9): per-task energy average (Eq 7), task
contributions (Eq 8), daily level (Eq 9/10); uncertainty Eq C.3 with
sampling u1a (Eq C.6), duration u1b (Eq C.7) and sensitivity coefficients
c1a (Eq C.4) / c1b (Eq C.5).
- job_based_exposure (Clause 10): effective-day energy average (Eq 11),
daily level (Eq 12); Table 1 minimum-duration check; uncertainty Eq C.9.
- full_day_exposure (Clause 11): whole-day averaging (Eq 11/13) with the
Clause 11.3 three-measurement / 3 dB spread rule.
- Table C.4 (job/full-day c1*u1, bilinear interpolation), Table C.5 (u2),
u3 = 1.0 dB, coverage factor k = 1.65 (one-sided 95 %).
Frozen dataclasses (Task, TaskContribution, ExposureResult), ExposureWarning
advisories for the sampling rules, and exports appended to __init__.
Tests reproduce the Annex D (task), E (job) and F (full-day) worked examples
to the standard's precision, plus closed-form oracles (single 85 dB/8 h task
= 85; equal-level tasks; -3.01 dB per halved duration; k = 1.65) and the
Table C.4 / Table 1 lookups. make check green: 1167 passed, 12 skipped.
Claude-Session: https://claude.ai/code/session_013kkVt3nxi9svp1an28uHxf
* fix: ISO 9612 review corrections — Table C.4 digits and Eq C.7 denominator
Two Table C.4 cells verified against the page image at 200 dpi and
corrected (N=6/u1=3.5: 3.4 -> 3.3; N=20/u1=2.0: 0.6 -> 0.5), the test
that echoed the wrong N=6 cell now pins the printed value plus the
corrected N=20 cell. The duration_samples branch of Eq C.7 divides by
J(J-1) like Eq C.6 (standard error of the mean), with a regression test
pinning u1b = 1.0 h for samples (4, 6) h. Module docstring now states
the Lp,Cpeak uncertainty scope cut (Table C.5, NOTE 1).
Claude-Session: https://claude.ai/code/session_01HUHMx4dxDes2t5UPQ25djP
* test: ISO 9613-2 and ISO 9612 conformance checks
Add a new "Outdoor propagation & occupational exposure" conformance domain
with seven closed-form / worked-example checks backed by shared constants in
tests/reference_data.py:
- ISO 9613-2:1996 Eq. (7) geometrical divergence Adiv = 51 dB at 100 m.
- ISO 9613-2:1996 Table 3 ground limit b'(0) = 10,1 -> Agr(250 Hz) = 17,2 dB
(porous ground, hs = hr = 0, dp -> inf).
- ISO 9613-2:1996 clause 7.4 single/double diffraction 20/25 dB caps.
- ISO 9612:2009 Annex D/E/F daily exposure LEX,8h and expanded uncertainty U
(84,3/2,7, 88,1/3,8, 90,1/3,4 dB), the Task objects rebuilt from the shared
input table.
Registry grows 34 -> 41 checks across 8 domains; docs/CONFORMANCE.md
regenerated via make conformance. Registration and reference-data consistency
tests pin the constants to the published values.
Claude-Session: https://claude.ai/code/session_01HUHMx4dxDes2t5UPQ25djP
* docs: figures for outdoor propagation and occupational exposure
Add four documentation figures (each EN/ES x light/dark) plus a setup diagram:
- air_absorption_alpha: ISO 9613-1 alpha(f) over frequency at four
temperature/humidity combinations (relaxation roll-off, f^2 growth).
- outdoor_attenuation_breakdown: ISO 9613-2 per-term stacked bar (Adiv, Aatm,
Agr, Abar) with the total A, for a 200 m path over porous ground with a 4 m
barrier.
- exposure_uncertainty: ISO 9612 Annex D task contributions with the daily
LEX,8h and the one-sided 95 % upper limit LEX,8h + U.
- diagram_outdoor_geometry: source-barrier-receiver geometry (dss/dsr/z, the
blocked direct ray and the diffracted ray over the top edge).
Spanish translations added to the generate_graphs / generate_diagrams
dictionaries (decimal commas, UNE terminology). Every image visually audited.
Claude-Session: https://claude.ai/code/session_01HUHMx4dxDes2t5UPQ25djP
* docs: ISO 9613-1/2 outdoor propagation guide and ISO 9612 exposure (EN)
Add the didactic Outdoor Sound Propagation guide (docs/outdoor-propagation.md)
covering ISO 9613-1 atmospheric absorption and the ISO 9613-2 general method
(divergence, atmospheric, ground and barrier terms, the OutdoorAttenuation
breakdown, the alternative 7.3.2 ground method, Cmet), with executed snippets
and honest scope notes (Amisc/reflections not implemented, 7.3.2 not
auto-wired, per-band Cmet a convenience). Extend the Levels guide with the
ISO 9612 occupational-exposure section (task/job/full-day strategies, the
C.6 I(I-1) vs C.12 N-1 asymmetry, Table C.4, k = 1,65, LEX,8h + U upper limit,
Lp,Cpeak uncertainty out of scope), reproducing the Annex D/E/F worked
examples.
Add the matching theory sections, API-reference rows for every new public
name, README feature list + docs table, docs index and CHANGELOG entries.
llms-full.txt / llms.txt regenerated (make llms) with the new page wired into
gen_llms.py. GitHub-safe math throughout; every snippet executed with pasted
outputs.
Claude-Session: https://claude.ai/code/session_01HUHMx4dxDes2t5UPQ25djP
* docs: outdoor propagation and exposure site twins (EN + ES)
Add the English and Spanish Starlight twins of the new content:
- guides/outdoor-propagation.md (EN + ES) — code-identical snippets to the
docs page; Spanish prose uses UNE terminology ("ponderación temporal"),
decimal commas outside math and code, and the _es figure variants.
- The ISO 9612 section added to guides/levels.md (EN + ES).
- reference/theory.md and reference/api.md rows (EN + ES).
- Landing cards and standards list bumped 34 -> 37 (index.mdx EN + ES);
guides/outdoor-propagation added to the sidebar.
Claude-Session: https://claude.ai/code/session_01HUHMx4dxDes2t5UPQ25djP
* fix: final branch review — API rows, precision phrasing and ES links
Adds the five missing public-symbol rows (TaskContribution,
table_c4_contribution, minimum_cumulative_duration_hours, COVERAGE_FACTOR,
INSTRUMENT_U2) to the three API references, states the ISO 9613-2 default
atmosphere (20 °C / 70 %, a Table 2 reference atmosphere) in the API rows
and guides, and softens "digit-for-digit" to "the standard's printed
precision" wherever it covered Annex E, whose final level differs only by
the standard's own pre-rounding. ES pages now use the /es/ link prefix
consistently. Code nits from the review: dead arg > 1 guard removed
(z > 0 implies arg >= 3), _with_advisory uses dataclasses.replace, and the
float-keyed _PRIME_BY_BAND gets a safety comment. llms files regenerated.
Claude-Session: https://claude.ai/code/session_01HUHMx4dxDes2t5UPQ25djP
* fix: validate propagation/exposure inputs and docs lint (PR review)
Addresses the PR #89 bot review:
- Barrier.__post_init__ rejects negative edge distances and a zero
edge_separation (which previously divided by zero in the C3 double-
diffraction factor); Task.__post_init__ rejects empty samples and a
non-positive duration.
- ground_attenuation and barrier_attenuation reject non-positive
frequencies (a zero frequency gave an infinite wavelength / division by
zero); ground_attenuation also checks a positive distance and
non-negative heights. job_based_exposure rejects a non-positive
sample_duration_hours.
- Rewrite the ISO 9613-2 7.3.2 closed form in the guides and API tables so
Markdownlint no longer parses `(...)[...]` as a reversed link (MD011).
- Regression tests for every new guard; docstrings note the new raises.
Claude-Session: https://claude.ai/code/session_01HUHMx4dxDes2t5UPQ25djP
Outdoor sound propagation and occupational noise exposure (ISO 9613-1, ISO 9613-2, ISO 9612) (#89)
* feat: ISO 9613-1 atmospheric sound absorption
Full alpha(f, T, RH, p) model per ISO 9613-1:1993 clauses 6.2-6.4:
oxygen/nitrogen relaxation frequencies, water-vapour molar
concentration from relative humidity, classical + rotational +
vibrational terms. Validated against a 13-point Table 1 grid
(worst deviation 0.39 %, rounding-limited, vs the standard's
stated +/-10 % accuracy) with the exact midband convention of
Eq. (6) Note 5. air_attenuation_m() feeds the ISO 354 m parameter
directly, closing the user-supplied gap. Two conformance checks
added (34/34).
Claude-Session: https://claude.ai/code/session_013kkVt3nxi9svp1an28uHxf
* refactor: C1 review nits — test name and comment direction
Claude-Session: https://claude.ai/code/session_013kkVt3nxi9svp1an28uHxf
* test: extend ISO 9613-1 Table 1 oracle against the full standard text
The full 37-page ISO 9613-1:1993 text (now in hand) confirms every
implemented constant of Eqs. (3)-(6), the Annex B psychrometric
conversion and the clause 4.2 reference conditions exactly as coded.
Oracle extended from 13 to 23 Table 1 points, adding the 20-50 degC
sub-tables 1(i)-1(p) unavailable in the interim source. Worst
deviation unchanged at 0.385 % (rounding-limited).
Claude-Session: https://claude.ai/code/session_013kkVt3nxi9svp1an28uHxf
* feat: ISO 9613-2 outdoor sound propagation
Implement the ISO 9613-2:1996 general method for octave-band outdoor sound
attenuation: geometrical divergence (Eq. 7), atmospheric absorption (Eq. 8,
via ISO 9613-1 air_absorption), ground effect (general per-region method of
7.3.1 with the Table 3 a'/b'/c'/d' functions, Eq. 9, plus the alternative
method of 7.3.2, Eq. 10, and the DOmega index Eq. 11), and screening (Eq. 12-18
with the C2/C3 factors, single/double diffraction, Kmet and the 20/25 dB caps).
Adds the Cmet meteorological correction (Eq. 21/22) and the LfT(DW)=Lw+Dc-A
receiver-level composition (Eq. 3/6). Frozen dataclass result exposes the
per-term breakdown (Adiv/Aatm/Agr/Abar). New module, tests and exports.
Claude-Session: https://claude.ai/code/session_013kkVt3nxi9svp1an28uHxf
* feat: ISO 9612 occupational noise exposure strategies and uncertainty
Add phonometry.occupational_exposure implementing the three ISO 9612:2009
measurement strategies and the normative Annex C uncertainty budget:
- task_based_exposure (Clause 9): per-task energy average (Eq 7), task
contributions (Eq 8), daily level (Eq 9/10); uncertainty Eq C.3 with
sampling u1a (Eq C.6), duration u1b (Eq C.7) and sensitivity coefficients
c1a (Eq C.4) / c1b (Eq C.5).
- job_based_exposure (Clause 10): effective-day energy average (Eq 11),
daily level (Eq 12); Table 1 minimum-duration check; uncertainty Eq C.9.
- full_day_exposure (Clause 11): whole-day averaging (Eq 11/13) with the
Clause 11.3 three-measurement / 3 dB spread rule.
- Table C.4 (job/full-day c1*u1, bilinear interpolation), Table C.5 (u2),
u3 = 1.0 dB, coverage factor k = 1.65 (one-sided 95 %).
Frozen dataclasses (Task, TaskContribution, ExposureResult), ExposureWarning
advisories for the sampling rules, and exports appended to __init__.
Tests reproduce the Annex D (task), E (job) and F (full-day) worked examples
to the standard's precision, plus closed-form oracles (single 85 dB/8 h task
= 85; equal-level tasks; -3.01 dB per halved duration; k = 1.65) and the
Table C.4 / Table 1 lookups. make check green: 1167 passed, 12 skipped.
Claude-Session: https://claude.ai/code/session_013kkVt3nxi9svp1an28uHxf
* fix: ISO 9612 review corrections — Table C.4 digits and Eq C.7 denominator
Two Table C.4 cells verified against the page image at 200 dpi and
corrected (N=6/u1=3.5: 3.4 -> 3.3; N=20/u1=2.0: 0.6 -> 0.5), the test
that echoed the wrong N=6 cell now pins the printed value plus the
corrected N=20 cell. The duration_samples branch of Eq C.7 divides by
J(J-1) like Eq C.6 (standard error of the mean), with a regression test
pinning u1b = 1.0 h for samples (4, 6) h. Module docstring now states
the Lp,Cpeak uncertainty scope cut (Table C.5, NOTE 1).
Claude-Session: https://claude.ai/code/session_01HUHMx4dxDes2t5UPQ25djP
* test: ISO 9613-2 and ISO 9612 conformance checks
Add a new "Outdoor propagation & occupational exposure" conformance domain
with seven closed-form / worked-example checks backed by shared constants in
tests/reference_data.py:
- ISO 9613-2:1996 Eq. (7) geometrical divergence Adiv = 51 dB at 100 m.
- ISO 9613-2:1996 Table 3 ground limit b'(0) = 10,1 -> Agr(250 Hz) = 17,2 dB
(porous ground, hs = hr = 0, dp -> inf).
- ISO 9613-2:1996 clause 7.4 single/double diffraction 20/25 dB caps.
- ISO 9612:2009 Annex D/E/F daily exposure LEX,8h and expanded uncertainty U
(84,3/2,7, 88,1/3,8, 90,1/3,4 dB), the Task objects rebuilt from the shared
input table.
Registry grows 34 -> 41 checks across 8 domains; docs/CONFORMANCE.md
regenerated via make conformance. Registration and reference-data consistency
tests pin the constants to the published values.
Claude-Session: https://claude.ai/code/session_01HUHMx4dxDes2t5UPQ25djP
* docs: figures for outdoor propagation and occupational exposure
Add four documentation figures (each EN/ES x light/dark) plus a setup diagram:
- air_absorption_alpha: ISO 9613-1 alpha(f) over frequency at four
temperature/humidity combinations (relaxation roll-off, f^2 growth).
- outdoor_attenuation_breakdown: ISO 9613-2 per-term stacked bar (Adiv, Aatm,
Agr, Abar) with the total A, for a 200 m path over porous ground with a 4 m
barrier.
- exposure_uncertainty: ISO 9612 Annex D task contributions with the daily
LEX,8h and the one-sided 95 % upper limit LEX,8h + U.
- diagram_outdoor_geometry: source-barrier-receiver geometry (dss/dsr/z, the
blocked direct ray and the diffracted ray over the top edge).
Spanish translations added to the generate_graphs / generate_diagrams
dictionaries (decimal commas, UNE terminology). Every image visually audited.
Claude-Session: https://claude.ai/code/session_01HUHMx4dxDes2t5UPQ25djP
* docs: ISO 9613-1/2 outdoor propagation guide and ISO 9612 exposure (EN)
Add the didactic Outdoor Sound Propagation guide (docs/outdoor-propagation.md)
covering ISO 9613-1 atmospheric absorption and the ISO 9613-2 general method
(divergence, atmospheric, ground and barrier terms, the OutdoorAttenuation
breakdown, the alternative 7.3.2 ground method, Cmet), with executed snippets
and honest scope notes (Amisc/reflections not implemented, 7.3.2 not
auto-wired, per-band Cmet a convenience). Extend the Levels guide with the
ISO 9612 occupational-exposure section (task/job/full-day strategies, the
C.6 I(I-1) vs C.12 N-1 asymmetry, Table C.4, k = 1,65, LEX,8h + U upper limit,
Lp,Cpeak uncertainty out of scope), reproducing the Annex D/E/F worked
examples.
Add the matching theory sections, API-reference rows for every new public
name, README feature list + docs table, docs index and CHANGELOG entries.
llms-full.txt / llms.txt regenerated (make llms) with the new page wired into
gen_llms.py. GitHub-safe math throughout; every snippet executed with pasted
outputs.
Claude-Session: https://claude.ai/code/session_01HUHMx4dxDes2t5UPQ25djP
* docs: outdoor propagation and exposure site twins (EN + ES)
Add the English and Spanish Starlight twins of the new content:
- guides/outdoor-propagation.md (EN + ES) — code-identical snippets to the
docs page; Spanish prose uses UNE terminology ("ponderación temporal"),
decimal commas outside math and code, and the _es figure variants.
- The ISO 9612 section added to guides/levels.md (EN + ES).
- reference/theory.md and reference/api.md rows (EN + ES).
- Landing cards and standards list bumped 34 -> 37 (index.mdx EN + ES);
guides/outdoor-propagation added to the sidebar.
Claude-Session: https://claude.ai/code/session_01HUHMx4dxDes2t5UPQ25djP
* fix: final branch review — API rows, precision phrasing and ES links
Adds the five missing public-symbol rows (TaskContribution,
table_c4_contribution, minimum_cumulative_duration_hours, COVERAGE_FACTOR,
INSTRUMENT_U2) to the three API references, states the ISO 9613-2 default
atmosphere (20 °C / 70 %, a Table 2 reference atmosphere) in the API rows
and guides, and softens "digit-for-digit" to "the standard's printed
precision" wherever it covered Annex E, whose final level differs only by
the standard's own pre-rounding. ES pages now use the /es/ link prefix
consistently. Code nits from the review: dead arg > 1 guard removed
(z > 0 implies arg >= 3), _with_advisory uses dataclasses.replace, and the
float-keyed _PRIME_BY_BAND gets a safety comment. llms files regenerated.
Claude-Session: https://claude.ai/code/session_01HUHMx4dxDes2t5UPQ25djP
* fix: validate propagation/exposure inputs and docs lint (PR review)
Addresses the PR #89 bot review:
- Barrier.__post_init__ rejects negative edge distances and a zero
edge_separation (which previously divided by zero in the C3 double-
diffraction factor); Task.__post_init__ rejects empty samples and a
non-positive duration.
- ground_attenuation and barrier_attenuation reject non-positive
frequencies (a zero frequency gave an infinite wavelength / division by
zero); ground_attenuation also checks a positive distance and
non-negative heights. job_based_exposure rejects a non-positive
sample_duration_hours.
- Rewrite the ISO 9613-2 7.3.2 closed form in the guides and API tables so
Markdownlint no longer parses `(...)[...]` as a reversed link (MD011).
- Regression tests for every new guard; docstrings note the new raises.
Claude-Session: https://claude.ai/code/session_01HUHMx4dxDes2t5UPQ25djP
Outdoor sound propagation and occupational noise exposure (ISO 9613-1, ISO 9613-2, ISO 9612) (#89)
* feat: ISO 9613-1 atmospheric sound absorption
Full alpha(f, T, RH, p) model per ISO 9613-1:1993 clauses 6.2-6.4:
oxygen/nitrogen relaxation frequencies, water-vapour molar
concentration from relative humidity, classical + rotational +
vibrational terms. Validated against a 13-point Table 1 grid
(worst deviation 0.39 %, rounding-limited, vs the standard's
stated +/-10 % accuracy) with the exact midband convention of
Eq. (6) Note 5. air_attenuation_m() feeds the ISO 354 m parameter
directly, closing the user-supplied gap. Two conformance checks
added (34/34).
Claude-Session: https://claude.ai/code/session_013kkVt3nxi9svp1an28uHxf
* refactor: C1 review nits — test name and comment direction
Claude-Session: https://claude.ai/code/session_013kkVt3nxi9svp1an28uHxf
* test: extend ISO 9613-1 Table 1 oracle against the full standard text
The full 37-page ISO 9613-1:1993 text (now in hand) confirms every
implemented constant of Eqs. (3)-(6), the Annex B psychrometric
conversion and the clause 4.2 reference conditions exactly as coded.
Oracle extended from 13 to 23 Table 1 points, adding the 20-50 degC
sub-tables 1(i)-1(p) unavailable in the interim source. Worst
deviation unchanged at 0.385 % (rounding-limited).
Claude-Session: https://claude.ai/code/session_013kkVt3nxi9svp1an28uHxf
* feat: ISO 9613-2 outdoor sound propagation
Implement the ISO 9613-2:1996 general method for octave-band outdoor sound
attenuation: geometrical divergence (Eq. 7), atmospheric absorption (Eq. 8,
via ISO 9613-1 air_absorption), ground effect (general per-region method of
7.3.1 with the Table 3 a'/b'/c'/d' functions, Eq. 9, plus the alternative
method of 7.3.2, Eq. 10, and the DOmega index Eq. 11), and screening (Eq. 12-18
with the C2/C3 factors, single/double diffraction, Kmet and the 20/25 dB caps).
Adds the Cmet meteorological correction (Eq. 21/22) and the LfT(DW)=Lw+Dc-A
receiver-level composition (Eq. 3/6). Frozen dataclass result exposes the
per-term breakdown (Adiv/Aatm/Agr/Abar). New module, tests and exports.
Claude-Session: https://claude.ai/code/session_013kkVt3nxi9svp1an28uHxf
* feat: ISO 9612 occupational noise exposure strategies and uncertainty
Add phonometry.occupational_exposure implementing the three ISO 9612:2009
measurement strategies and the normative Annex C uncertainty budget:
- task_based_exposure (Clause 9): per-task energy average (Eq 7), task
contributions (Eq 8), daily level (Eq 9/10); uncertainty Eq C.3 with
sampling u1a (Eq C.6), duration u1b (Eq C.7) and sensitivity coefficients
c1a (Eq C.4) / c1b (Eq C.5).
- job_based_exposure (Clause 10): effective-day energy average (Eq 11),
daily level (Eq 12); Table 1 minimum-duration check; uncertainty Eq C.9.
- full_day_exposure (Clause 11): whole-day averaging (Eq 11/13) with the
Clause 11.3 three-measurement / 3 dB spread rule.
- Table C.4 (job/full-day c1*u1, bilinear interpolation), Table C.5 (u2),
u3 = 1.0 dB, coverage factor k = 1.65 (one-sided 95 %).
Frozen dataclasses (Task, TaskContribution, ExposureResult), ExposureWarning
advisories for the sampling rules, and exports appended to __init__.
Tests reproduce the Annex D (task), E (job) and F (full-day) worked examples
to the standard's precision, plus closed-form oracles (single 85 dB/8 h task
= 85; equal-level tasks; -3.01 dB per halved duration; k = 1.65) and the
Table C.4 / Table 1 lookups. make check green: 1167 passed, 12 skipped.
Claude-Session: https://claude.ai/code/session_013kkVt3nxi9svp1an28uHxf
* fix: ISO 9612 review corrections — Table C.4 digits and Eq C.7 denominator
Two Table C.4 cells verified against the page image at 200 dpi and
corrected (N=6/u1=3.5: 3.4 -> 3.3; N=20/u1=2.0: 0.6 -> 0.5), the test
that echoed the wrong N=6 cell now pins the printed value plus the
corrected N=20 cell. The duration_samples branch of Eq C.7 divides by
J(J-1) like Eq C.6 (standard error of the mean), with a regression test
pinning u1b = 1.0 h for samples (4, 6) h. Module docstring now states
the Lp,Cpeak uncertainty scope cut (Table C.5, NOTE 1).
Claude-Session: https://claude.ai/code/session_01HUHMx4dxDes2t5UPQ25djP
* test: ISO 9613-2 and ISO 9612 conformance checks
Add a new "Outdoor propagation & occupational exposure" conformance domain
with seven closed-form / worked-example checks backed by shared constants in
tests/reference_data.py:
- ISO 9613-2:1996 Eq. (7) geometrical divergence Adiv = 51 dB at 100 m.
- ISO 9613-2:1996 Table 3 ground limit b'(0) = 10,1 -> Agr(250 Hz) = 17,2 dB
(porous ground, hs = hr = 0, dp -> inf).
- ISO 9613-2:1996 clause 7.4 single/double diffraction 20/25 dB caps.
- ISO 9612:2009 Annex D/E/F daily exposure LEX,8h and expanded uncertainty U
(84,3/2,7, 88,1/3,8, 90,1/3,4 dB), the Task objects rebuilt from the shared
input table.
Registry grows 34 -> 41 checks across 8 domains; docs/CONFORMANCE.md
regenerated via make conformance. Registration and reference-data consistency
tests pin the constants to the published values.
Claude-Session: https://claude.ai/code/session_01HUHMx4dxDes2t5UPQ25djP
* docs: figures for outdoor propagation and occupational exposure
Add four documentation figures (each EN/ES x light/dark) plus a setup diagram:
- air_absorption_alpha: ISO 9613-1 alpha(f) over frequency at four
temperature/humidity combinations (relaxation roll-off, f^2 growth).
- outdoor_attenuation_breakdown: ISO 9613-2 per-term stacked bar (Adiv, Aatm,
Agr, Abar) with the total A, for a 200 m path over porous ground with a 4 m
barrier.
- exposure_uncertainty: ISO 9612 Annex D task contributions with the daily
LEX,8h and the one-sided 95 % upper limit LEX,8h + U.
- diagram_outdoor_geometry: source-barrier-receiver geometry (dss/dsr/z, the
blocked direct ray and the diffracted ray over the top edge).
Spanish translations added to the generate_graphs / generate_diagrams
dictionaries (decimal commas, UNE terminology). Every image visually audited.
Claude-Session: https://claude.ai/code/session_01HUHMx4dxDes2t5UPQ25djP
* docs: ISO 9613-1/2 outdoor propagation guide and ISO 9612 exposure (EN)
Add the didactic Outdoor Sound Propagation guide (docs/outdoor-propagation.md)
covering ISO 9613-1 atmospheric absorption and the ISO 9613-2 general method
(divergence, atmospheric, ground and barrier terms, the OutdoorAttenuation
breakdown, the alternative 7.3.2 ground method, Cmet), with executed snippets
and honest scope notes (Amisc/reflections not implemented, 7.3.2 not
auto-wired, per-band Cmet a convenience). Extend the Levels guide with the
ISO 9612 occupational-exposure section (task/job/full-day strategies, the
C.6 I(I-1) vs C.12 N-1 asymmetry, Table C.4, k = 1,65, LEX,8h + U upper limit,
Lp,Cpeak uncertainty out of scope), reproducing the Annex D/E/F worked
examples.
Add the matching theory sections, API-reference rows for every new public
name, README feature list + docs table, docs index and CHANGELOG entries.
llms-full.txt / llms.txt regenerated (make llms) with the new page wired into
gen_llms.py. GitHub-safe math throughout; every snippet executed with pasted
outputs.
Claude-Session: https://claude.ai/code/session_01HUHMx4dxDes2t5UPQ25djP
* docs: outdoor propagation and exposure site twins (EN + ES)
Add the English and Spanish Starlight twins of the new content:
- guides/outdoor-propagation.md (EN + ES) — code-identical snippets to the
docs page; Spanish prose uses UNE terminology ("ponderación temporal"),
decimal commas outside math and code, and the _es figure variants.
- The ISO 9612 section added to guides/levels.md (EN + ES).
- reference/theory.md and reference/api.md rows (EN + ES).
- Landing cards and standards list bumped 34 -> 37 (index.mdx EN + ES);
guides/outdoor-propagation added to the sidebar.
Claude-Session: https://claude.ai/code/session_01HUHMx4dxDes2t5UPQ25djP
* fix: final branch review — API rows, precision phrasing and ES links
Adds the five missing public-symbol rows (TaskContribution,
table_c4_contribution, minimum_cumulative_duration_hours, COVERAGE_FACTOR,
INSTRUMENT_U2) to the three API references, states the ISO 9613-2 default
atmosphere (20 °C / 70 %, a Table 2 reference atmosphere) in the API rows
and guides, and softens "digit-for-digit" to "the standard's printed
precision" wherever it covered Annex E, whose final level differs only by
the standard's own pre-rounding. ES pages now use the /es/ link prefix
consistently. Code nits from the review: dead arg > 1 guard removed
(z > 0 implies arg >= 3), _with_advisory uses dataclasses.replace, and the
float-keyed _PRIME_BY_BAND gets a safety comment. llms files regenerated.
Claude-Session: https://claude.ai/code/session_01HUHMx4dxDes2t5UPQ25djP
* fix: validate propagation/exposure inputs and docs lint (PR review)
Addresses the PR #89 bot review:
- Barrier.__post_init__ rejects negative edge distances and a zero
edge_separation (which previously divided by zero in the C3 double-
diffraction factor); Task.__post_init__ rejects empty samples and a
non-positive duration.
- ground_attenuation and barrier_attenuation reject non-positive
frequencies (a zero frequency gave an infinite wavelength / division by
zero); ground_attenuation also checks a positive distance and
non-negative heights. job_based_exposure rejects a non-positive
sample_duration_hours.
- Rewrite the ISO 9613-2 7.3.2 closed form in the guides and API tables so
Markdownlint no longer parses `(...)[...]` as a reversed link (MD011).
- Regression tests for every new guard; docstrings note the new raises.
Claude-Session: https://claude.ai/code/session_01HUHMx4dxDes2t5UPQ25djP
Psychoacoustics, speech intelligibility and sound intensity (ISO 532-1, DIN 45692, IEC 60268-16, IEC 61043) (#80)
* test: ISO 532-1 Annex B expected-value fixtures
Expected N (stationary, with the Annex tolerances) and Nmax/N5
(time-varying, 5% tolerance) for all 25 normative test signals,
extracted from the results workbooks of the freely downloadable
ISO 532-1:2017 electronic attachment, plus the Test signal 1
third-octave input levels.
Claude-Session: https://claude.ai/code/session_013kkVt3nxi9svp1an28uHxf
* feat: Zwicker loudness per ISO 532-1:2017 (stationary and time-varying)
Clean-room Python port of the normative Annex A.4 reference
implementation: all twelve numeric tables (A.1-A.9) verified
digit-exact against the C source in _zwicker_data.py, the Table A.1/A.2
third-octave filterbank, the level-dependent weighting, critical-band
and core-loudness stages, the exact f_nl nonlinear temporal-decay state
machine, temporal weighting and the 500 Hz loudness-vs-time trace with
Nmax/N5/N10. API: loudness_zwicker(x, fs, field=, stationary=) and
loudness_zwicker_from_spectrum(levels, field=) returning a frozen
ZwickerLoudness dataclass.
Conformance (Annex B, from the freely downloadable ISO electronic
attachment): Test signal 1 stationary spectrum matches the published N
to all printed digits (83.2957 sone); regenerated B.3 tones sit inside
the workbook tolerance intervals; the B.4 tone-pulse WAVs (included,
small) must keep >=99% of the N(t) trace inside the per-sample
normative tolerance band - the workbook header N5 values are not
reproducible from their own published traces and are documented as not
asserted. B.5 technical recordings run when ISO532_1_TESTDATA points
at the attachment.
Claude-Session: https://claude.ai/code/session_013kkVt3nxi9svp1an28uHxf
* feat: sharpness per DIN 45692:2009 (acum)
sharpness_din(x, fs, field=, method=) and
sharpness_din_from_specific(specific) implement Equation (1) - the
g(z)-weighted first moment of the ISO 532-1 specific-loudness pattern -
with the normalization constant k derived numerically from the clause 6
standard test signal (critical-band-wide 920-1080 Hz noise at 60 dB ->
exactly 1.00 acum; the derived k = 0.108 sits inside the normative
0.105 <= k < 0.115 window). The informative Annex B variants of Aures
and von Bismarck are selectable. Conformance tests: reference identity,
k range, and Table A.2 targets at four centre frequencies using
critical-band noises equalized to 4 sone (Tabelle A.1 band edges),
within the clause 6 tolerance of 5 % or 0.05 acum.
Claude-Session: https://claude.ai/code/session_013kkVt3nxi9svp1an28uHxf
* fix: annotate Aures weighting return for strict mypy
Claude-Session: https://claude.ai/code/session_013kkVt3nxi9svp1an28uHxf
* fix: robust short-signal handling and consistent peak pattern in Zwicker port
Findings surfaced by review bots on an accidental early diff: (1) inputs
shorter than one 500 Hz output sample crashed on an empty percentile
buffer - the minimum-length validation now requires a full output step;
(2) the returned specific pattern was picked with the un-decimated
argmax while Nmax/N5/N10 come from the decimated trace - both now use
the same decimated instant (regression tests added; note the pattern
integral only equals Nmax for steady signals, since N(t) is temporally
weighted).
Claude-Session: https://claude.ai/code/session_013kkVt3nxi9svp1an28uHxf
* feat: STI/STIPA (IEC 60268-16 Ed. 5) and p-p sound intensity (IEC 61043 + ISO 9614-1)
STI: sti_from_impulse_response (indirect method: IEC 61260 octave bank,
Schroeder MTF at the 14 modulation frequencies, optional SNR/masking/
reception-threshold corrections per Tables A.2/A.3, +-15 dB clip, male
alpha/beta weighting), stipa() direct method and an Ed. 5-conformant
stipa_signal() generator using the revised A.6.1 male spectrum. Ed. 4
PDF is the primary source; Ed. 5 deltas are source-attributed in the
constants (MathWorks Ed. 5 compliance doc, zawi01/stipa - numeric
values only, no GPL code). Verified: the six A.2.2 weighting pairs
exact to 0.001, eleven m<->STI pairs, masking control points,
exponential decays vs the Schroeder closed form at four T60 values,
STIPA loop-back 0.998 and monotonic SNR degradation.
Intensity: sound_intensity() cross-spectral p-p method
(I = -Im{G12}/(2pi f rho dr)) with octave/third-octave integration,
pressure-intensity index, direction, finite-difference bias correction
validated against IEC 61043 Table 3, plus ISO 9614-1 Annex A field
indicators (F2/F3/F4) and the dynamic-capability criterion (Ld = dpI0-K,
Table 1). Verified against exact plane-wave and standing-wave physics.
415 tests, mypy strict clean.
Claude-Session: https://claude.ai/code/session_013kkVt3nxi9svp1an28uHxf
* docs: new guide pages, refreshed landing and README for the expanded scope
Psychoacoustics & Speech Intelligibility and Sound Intensity guide pages
(EN, docs + site with sidebar entries), the ISO 1996-2 and ECMA-74
position diagrams finally embedded in the levels guide (EN/ES), and the
outdated landing page (EN/ES), README highlights/docs table and
changelog brought up to the real scope - the hero and cards now name
the thirteen standards under conformance test instead of the original
two.
Claude-Session: https://claude.ai/code/session_013kkVt3nxi9svp1an28uHxf
* docs: didactic pages, figures, diagrams and theory for psychoacoustics and intensity
Three new audited figures in four language/theme variants (specific
loudness pattern narrowband-vs-broadband, STI vs T60 with the Annex F
rating bands against the analytic Schroeder curve, and plane-vs-standing
wave intensity panels showing the pressure-intensity index), two new
setup diagrams (p-p probe with the spacer dimension, STI measurement
chain), Spanish twins of the two new guide pages, three theory sections
(Zwicker chain, MTF/STI math, intensity estimator with its bias) in
EN docs, EN site and ES site with GitHub-safe math, and API rows for
all thirteen new exports in the three reference tables.
Claude-Session: https://claude.ai/code/session_013kkVt3nxi9svp1an28uHxf
* test: track the ISO 532-1 Annex B.4 pulse WAVs (were gitignored)
The global *.wav ignore silently excluded the four normative tone-pulse
fixtures, so CI failed with FileNotFoundError on every OS while local
runs passed against the untracked files. Force-added with an explicit
gitignore exception.
Claude-Session: https://claude.ai/code/session_013kkVt3nxi9svp1an28uHxf
* fix: address PR 80 review round 1
- docs: use the real dynamic_capability_index signature and keep the
intensity example bands under the 12 mm spacer validity ceiling
- docs: calibration example wording (raw recording, not already-Pa)
- changelog: merge the duplicated Unreleased Added sections
- loudness: reject non-finite inputs and pathological resampling ratios
(gcd-1 rates like 44101 Hz) with clear errors, regression-tested
- tests: anchor the Aures/von Bismarck variants to the 1 acum reference
within 0.05 acum instead of a loose sanity bound
Claude-Session: https://claude.ai/code/session_013kkVt3nxi9svp1an28uHxf
Psychoacoustics, speech intelligibility and sound intensity (ISO 532-1, DIN 45692, IEC 60268-16, IEC 61043) (#80)
* test: ISO 532-1 Annex B expected-value fixtures
Expected N (stationary, with the Annex tolerances) and Nmax/N5
(time-varying, 5% tolerance) for all 25 normative test signals,
extracted from the results workbooks of the freely downloadable
ISO 532-1:2017 electronic attachment, plus the Test signal 1
third-octave input levels.
Claude-Session: https://claude.ai/code/session_013kkVt3nxi9svp1an28uHxf
* feat: Zwicker loudness per ISO 532-1:2017 (stationary and time-varying)
Clean-room Python port of the normative Annex A.4 reference
implementation: all twelve numeric tables (A.1-A.9) verified
digit-exact against the C source in _zwicker_data.py, the Table A.1/A.2
third-octave filterbank, the level-dependent weighting, critical-band
and core-loudness stages, the exact f_nl nonlinear temporal-decay state
machine, temporal weighting and the 500 Hz loudness-vs-time trace with
Nmax/N5/N10. API: loudness_zwicker(x, fs, field=, stationary=) and
loudness_zwicker_from_spectrum(levels, field=) returning a frozen
ZwickerLoudness dataclass.
Conformance (Annex B, from the freely downloadable ISO electronic
attachment): Test signal 1 stationary spectrum matches the published N
to all printed digits (83.2957 sone); regenerated B.3 tones sit inside
the workbook tolerance intervals; the B.4 tone-pulse WAVs (included,
small) must keep >=99% of the N(t) trace inside the per-sample
normative tolerance band - the workbook header N5 values are not
reproducible from their own published traces and are documented as not
asserted. B.5 technical recordings run when ISO532_1_TESTDATA points
at the attachment.
Claude-Session: https://claude.ai/code/session_013kkVt3nxi9svp1an28uHxf
* feat: sharpness per DIN 45692:2009 (acum)
sharpness_din(x, fs, field=, method=) and
sharpness_din_from_specific(specific) implement Equation (1) - the
g(z)-weighted first moment of the ISO 532-1 specific-loudness pattern -
with the normalization constant k derived numerically from the clause 6
standard test signal (critical-band-wide 920-1080 Hz noise at 60 dB ->
exactly 1.00 acum; the derived k = 0.108 sits inside the normative
0.105 <= k < 0.115 window). The informative Annex B variants of Aures
and von Bismarck are selectable. Conformance tests: reference identity,
k range, and Table A.2 targets at four centre frequencies using
critical-band noises equalized to 4 sone (Tabelle A.1 band edges),
within the clause 6 tolerance of 5 % or 0.05 acum.
Claude-Session: https://claude.ai/code/session_013kkVt3nxi9svp1an28uHxf
* fix: annotate Aures weighting return for strict mypy
Claude-Session: https://claude.ai/code/session_013kkVt3nxi9svp1an28uHxf
* fix: robust short-signal handling and consistent peak pattern in Zwicker port
Findings surfaced by review bots on an accidental early diff: (1) inputs
shorter than one 500 Hz output sample crashed on an empty percentile
buffer - the minimum-length validation now requires a full output step;
(2) the returned specific pattern was picked with the un-decimated
argmax while Nmax/N5/N10 come from the decimated trace - both now use
the same decimated instant (regression tests added; note the pattern
integral only equals Nmax for steady signals, since N(t) is temporally
weighted).
Claude-Session: https://claude.ai/code/session_013kkVt3nxi9svp1an28uHxf
* feat: STI/STIPA (IEC 60268-16 Ed. 5) and p-p sound intensity (IEC 61043 + ISO 9614-1)
STI: sti_from_impulse_response (indirect method: IEC 61260 octave bank,
Schroeder MTF at the 14 modulation frequencies, optional SNR/masking/
reception-threshold corrections per Tables A.2/A.3, +-15 dB clip, male
alpha/beta weighting), stipa() direct method and an Ed. 5-conformant
stipa_signal() generator using the revised A.6.1 male spectrum. Ed. 4
PDF is the primary source; Ed. 5 deltas are source-attributed in the
constants (MathWorks Ed. 5 compliance doc, zawi01/stipa - numeric
values only, no GPL code). Verified: the six A.2.2 weighting pairs
exact to 0.001, eleven m<->STI pairs, masking control points,
exponential decays vs the Schroeder closed form at four T60 values,
STIPA loop-back 0.998 and monotonic SNR degradation.
Intensity: sound_intensity() cross-spectral p-p method
(I = -Im{G12}/(2pi f rho dr)) with octave/third-octave integration,
pressure-intensity index, direction, finite-difference bias correction
validated against IEC 61043 Table 3, plus ISO 9614-1 Annex A field
indicators (F2/F3/F4) and the dynamic-capability criterion (Ld = dpI0-K,
Table 1). Verified against exact plane-wave and standing-wave physics.
415 tests, mypy strict clean.
Claude-Session: https://claude.ai/code/session_013kkVt3nxi9svp1an28uHxf
* docs: new guide pages, refreshed landing and README for the expanded scope
Psychoacoustics & Speech Intelligibility and Sound Intensity guide pages
(EN, docs + site with sidebar entries), the ISO 1996-2 and ECMA-74
position diagrams finally embedded in the levels guide (EN/ES), and the
outdated landing page (EN/ES), README highlights/docs table and
changelog brought up to the real scope - the hero and cards now name
the thirteen standards under conformance test instead of the original
two.
Claude-Session: https://claude.ai/code/session_013kkVt3nxi9svp1an28uHxf
* docs: didactic pages, figures, diagrams and theory for psychoacoustics and intensity
Three new audited figures in four language/theme variants (specific
loudness pattern narrowband-vs-broadband, STI vs T60 with the Annex F
rating bands against the analytic Schroeder curve, and plane-vs-standing
wave intensity panels showing the pressure-intensity index), two new
setup diagrams (p-p probe with the spacer dimension, STI measurement
chain), Spanish twins of the two new guide pages, three theory sections
(Zwicker chain, MTF/STI math, intensity estimator with its bias) in
EN docs, EN site and ES site with GitHub-safe math, and API rows for
all thirteen new exports in the three reference tables.
Claude-Session: https://claude.ai/code/session_013kkVt3nxi9svp1an28uHxf
* test: track the ISO 532-1 Annex B.4 pulse WAVs (were gitignored)
The global *.wav ignore silently excluded the four normative tone-pulse
fixtures, so CI failed with FileNotFoundError on every OS while local
runs passed against the untracked files. Force-added with an explicit
gitignore exception.
Claude-Session: https://claude.ai/code/session_013kkVt3nxi9svp1an28uHxf
* fix: address PR 80 review round 1
- docs: use the real dynamic_capability_index signature and keep the
intensity example bands under the 12 mm spacer validity ceiling
- docs: calibration example wording (raw recording, not already-Pa)
- changelog: merge the duplicated Unreleased Added sections
- loudness: reject non-finite inputs and pathological resampling ratios
(gcd-1 rates like 44101 Hz) with clear errors, regression-tested
- tests: anchor the Aures/von Bismarck variants to the 1 acum reference
within 0.05 acum instead of a loose sanity bound
Claude-Session: https://claude.ai/code/session_013kkVt3nxi9svp1an28uHxf
Psychoacoustics, speech intelligibility and sound intensity (ISO 532-1, DIN 45692, IEC 60268-16, IEC 61043) (#80)
* test: ISO 532-1 Annex B expected-value fixtures
Expected N (stationary, with the Annex tolerances) and Nmax/N5
(time-varying, 5% tolerance) for all 25 normative test signals,
extracted from the results workbooks of the freely downloadable
ISO 532-1:2017 electronic attachment, plus the Test signal 1
third-octave input levels.
Claude-Session: https://claude.ai/code/session_013kkVt3nxi9svp1an28uHxf
* feat: Zwicker loudness per ISO 532-1:2017 (stationary and time-varying)
Clean-room Python port of the normative Annex A.4 reference
implementation: all twelve numeric tables (A.1-A.9) verified
digit-exact against the C source in _zwicker_data.py, the Table A.1/A.2
third-octave filterbank, the level-dependent weighting, critical-band
and core-loudness stages, the exact f_nl nonlinear temporal-decay state
machine, temporal weighting and the 500 Hz loudness-vs-time trace with
Nmax/N5/N10. API: loudness_zwicker(x, fs, field=, stationary=) and
loudness_zwicker_from_spectrum(levels, field=) returning a frozen
ZwickerLoudness dataclass.
Conformance (Annex B, from the freely downloadable ISO electronic
attachment): Test signal 1 stationary spectrum matches the published N
to all printed digits (83.2957 sone); regenerated B.3 tones sit inside
the workbook tolerance intervals; the B.4 tone-pulse WAVs (included,
small) must keep >=99% of the N(t) trace inside the per-sample
normative tolerance band - the workbook header N5 values are not
reproducible from their own published traces and are documented as not
asserted. B.5 technical recordings run when ISO532_1_TESTDATA points
at the attachment.
Claude-Session: https://claude.ai/code/session_013kkVt3nxi9svp1an28uHxf
* feat: sharpness per DIN 45692:2009 (acum)
sharpness_din(x, fs, field=, method=) and
sharpness_din_from_specific(specific) implement Equation (1) - the
g(z)-weighted first moment of the ISO 532-1 specific-loudness pattern -
with the normalization constant k derived numerically from the clause 6
standard test signal (critical-band-wide 920-1080 Hz noise at 60 dB ->
exactly 1.00 acum; the derived k = 0.108 sits inside the normative
0.105 <= k < 0.115 window). The informative Annex B variants of Aures
and von Bismarck are selectable. Conformance tests: reference identity,
k range, and Table A.2 targets at four centre frequencies using
critical-band noises equalized to 4 sone (Tabelle A.1 band edges),
within the clause 6 tolerance of 5 % or 0.05 acum.
Claude-Session: https://claude.ai/code/session_013kkVt3nxi9svp1an28uHxf
* fix: annotate Aures weighting return for strict mypy
Claude-Session: https://claude.ai/code/session_013kkVt3nxi9svp1an28uHxf
* fix: robust short-signal handling and consistent peak pattern in Zwicker port
Findings surfaced by review bots on an accidental early diff: (1) inputs
shorter than one 500 Hz output sample crashed on an empty percentile
buffer - the minimum-length validation now requires a full output step;
(2) the returned specific pattern was picked with the un-decimated
argmax while Nmax/N5/N10 come from the decimated trace - both now use
the same decimated instant (regression tests added; note the pattern
integral only equals Nmax for steady signals, since N(t) is temporally
weighted).
Claude-Session: https://claude.ai/code/session_013kkVt3nxi9svp1an28uHxf
* feat: STI/STIPA (IEC 60268-16 Ed. 5) and p-p sound intensity (IEC 61043 + ISO 9614-1)
STI: sti_from_impulse_response (indirect method: IEC 61260 octave bank,
Schroeder MTF at the 14 modulation frequencies, optional SNR/masking/
reception-threshold corrections per Tables A.2/A.3, +-15 dB clip, male
alpha/beta weighting), stipa() direct method and an Ed. 5-conformant
stipa_signal() generator using the revised A.6.1 male spectrum. Ed. 4
PDF is the primary source; Ed. 5 deltas are source-attributed in the
constants (MathWorks Ed. 5 compliance doc, zawi01/stipa - numeric
values only, no GPL code). Verified: the six A.2.2 weighting pairs
exact to 0.001, eleven m<->STI pairs, masking control points,
exponential decays vs the Schroeder closed form at four T60 values,
STIPA loop-back 0.998 and monotonic SNR degradation.
Intensity: sound_intensity() cross-spectral p-p method
(I = -Im{G12}/(2pi f rho dr)) with octave/third-octave integration,
pressure-intensity index, direction, finite-difference bias correction
validated against IEC 61043 Table 3, plus ISO 9614-1 Annex A field
indicators (F2/F3/F4) and the dynamic-capability criterion (Ld = dpI0-K,
Table 1). Verified against exact plane-wave and standing-wave physics.
415 tests, mypy strict clean.
Claude-Session: https://claude.ai/code/session_013kkVt3nxi9svp1an28uHxf
* docs: new guide pages, refreshed landing and README for the expanded scope
Psychoacoustics & Speech Intelligibility and Sound Intensity guide pages
(EN, docs + site with sidebar entries), the ISO 1996-2 and ECMA-74
position diagrams finally embedded in the levels guide (EN/ES), and the
outdated landing page (EN/ES), README highlights/docs table and
changelog brought up to the real scope - the hero and cards now name
the thirteen standards under conformance test instead of the original
two.
Claude-Session: https://claude.ai/code/session_013kkVt3nxi9svp1an28uHxf
* docs: didactic pages, figures, diagrams and theory for psychoacoustics and intensity
Three new audited figures in four language/theme variants (specific
loudness pattern narrowband-vs-broadband, STI vs T60 with the Annex F
rating bands against the analytic Schroeder curve, and plane-vs-standing
wave intensity panels showing the pressure-intensity index), two new
setup diagrams (p-p probe with the spacer dimension, STI measurement
chain), Spanish twins of the two new guide pages, three theory sections
(Zwicker chain, MTF/STI math, intensity estimator with its bias) in
EN docs, EN site and ES site with GitHub-safe math, and API rows for
all thirteen new exports in the three reference tables.
Claude-Session: https://claude.ai/code/session_013kkVt3nxi9svp1an28uHxf
* test: track the ISO 532-1 Annex B.4 pulse WAVs (were gitignored)
The global *.wav ignore silently excluded the four normative tone-pulse
fixtures, so CI failed with FileNotFoundError on every OS while local
runs passed against the untracked files. Force-added with an explicit
gitignore exception.
Claude-Session: https://claude.ai/code/session_013kkVt3nxi9svp1an28uHxf
* fix: address PR 80 review round 1
- docs: use the real dynamic_capability_index signature and keep the
intensity example bands under the 12 mm spacer validity ceiling
- docs: calibration example wording (raw recording, not already-Pa)
- changelog: merge the duplicated Unreleased Added sections
- loudness: reject non-finite inputs and pathological resampling ratios
(gcd-1 rates like 44101 Hz) with clear errors, regression-tested
- tests: anchor the Aures/von Bismarck variants to the 1 acum reference
within 0.05 acum instead of a loose sanity bound
Claude-Session: https://claude.ai/code/session_013kkVt3nxi9svp1an28uHxf
Psychoacoustics, speech intelligibility and sound intensity (ISO 532-1, DIN 45692, IEC 60268-16, IEC 61043) (#80)
* test: ISO 532-1 Annex B expected-value fixtures
Expected N (stationary, with the Annex tolerances) and Nmax/N5
(time-varying, 5% tolerance) for all 25 normative test signals,
extracted from the results workbooks of the freely downloadable
ISO 532-1:2017 electronic attachment, plus the Test signal 1
third-octave input levels.
Claude-Session: https://claude.ai/code/session_013kkVt3nxi9svp1an28uHxf
* feat: Zwicker loudness per ISO 532-1:2017 (stationary and time-varying)
Clean-room Python port of the normative Annex A.4 reference
implementation: all twelve numeric tables (A.1-A.9) verified
digit-exact against the C source in _zwicker_data.py, the Table A.1/A.2
third-octave filterbank, the level-dependent weighting, critical-band
and core-loudness stages, the exact f_nl nonlinear temporal-decay state
machine, temporal weighting and the 500 Hz loudness-vs-time trace with
Nmax/N5/N10. API: loudness_zwicker(x, fs, field=, stationary=) and
loudness_zwicker_from_spectrum(levels, field=) returning a frozen
ZwickerLoudness dataclass.
Conformance (Annex B, from the freely downloadable ISO electronic
attachment): Test signal 1 stationary spectrum matches the published N
to all printed digits (83.2957 sone); regenerated B.3 tones sit inside
the workbook tolerance intervals; the B.4 tone-pulse WAVs (included,
small) must keep >=99% of the N(t) trace inside the per-sample
normative tolerance band - the workbook header N5 values are not
reproducible from their own published traces and are documented as not
asserted. B.5 technical recordings run when ISO532_1_TESTDATA points
at the attachment.
Claude-Session: https://claude.ai/code/session_013kkVt3nxi9svp1an28uHxf
* feat: sharpness per DIN 45692:2009 (acum)
sharpness_din(x, fs, field=, method=) and
sharpness_din_from_specific(specific) implement Equation (1) - the
g(z)-weighted first moment of the ISO 532-1 specific-loudness pattern -
with the normalization constant k derived numerically from the clause 6
standard test signal (critical-band-wide 920-1080 Hz noise at 60 dB ->
exactly 1.00 acum; the derived k = 0.108 sits inside the normative
0.105 <= k < 0.115 window). The informative Annex B variants of Aures
and von Bismarck are selectable. Conformance tests: reference identity,
k range, and Table A.2 targets at four centre frequencies using
critical-band noises equalized to 4 sone (Tabelle A.1 band edges),
within the clause 6 tolerance of 5 % or 0.05 acum.
Claude-Session: https://claude.ai/code/session_013kkVt3nxi9svp1an28uHxf
* fix: annotate Aures weighting return for strict mypy
Claude-Session: https://claude.ai/code/session_013kkVt3nxi9svp1an28uHxf
* fix: robust short-signal handling and consistent peak pattern in Zwicker port
Findings surfaced by review bots on an accidental early diff: (1) inputs
shorter than one 500 Hz output sample crashed on an empty percentile
buffer - the minimum-length validation now requires a full output step;
(2) the returned specific pattern was picked with the un-decimated
argmax while Nmax/N5/N10 come from the decimated trace - both now use
the same decimated instant (regression tests added; note the pattern
integral only equals Nmax for steady signals, since N(t) is temporally
weighted).
Claude-Session: https://claude.ai/code/session_013kkVt3nxi9svp1an28uHxf
* feat: STI/STIPA (IEC 60268-16 Ed. 5) and p-p sound intensity (IEC 61043 + ISO 9614-1)
STI: sti_from_impulse_response (indirect method: IEC 61260 octave bank,
Schroeder MTF at the 14 modulation frequencies, optional SNR/masking/
reception-threshold corrections per Tables A.2/A.3, +-15 dB clip, male
alpha/beta weighting), stipa() direct method and an Ed. 5-conformant
stipa_signal() generator using the revised A.6.1 male spectrum. Ed. 4
PDF is the primary source; Ed. 5 deltas are source-attributed in the
constants (MathWorks Ed. 5 compliance doc, zawi01/stipa - numeric
values only, no GPL code). Verified: the six A.2.2 weighting pairs
exact to 0.001, eleven m<->STI pairs, masking control points,
exponential decays vs the Schroeder closed form at four T60 values,
STIPA loop-back 0.998 and monotonic SNR degradation.
Intensity: sound_intensity() cross-spectral p-p method
(I = -Im{G12}/(2pi f rho dr)) with octave/third-octave integration,
pressure-intensity index, direction, finite-difference bias correction
validated against IEC 61043 Table 3, plus ISO 9614-1 Annex A field
indicators (F2/F3/F4) and the dynamic-capability criterion (Ld = dpI0-K,
Table 1). Verified against exact plane-wave and standing-wave physics.
415 tests, mypy strict clean.
Claude-Session: https://claude.ai/code/session_013kkVt3nxi9svp1an28uHxf
* docs: new guide pages, refreshed landing and README for the expanded scope
Psychoacoustics & Speech Intelligibility and Sound Intensity guide pages
(EN, docs + site with sidebar entries), the ISO 1996-2 and ECMA-74
position diagrams finally embedded in the levels guide (EN/ES), and the
outdated landing page (EN/ES), README highlights/docs table and
changelog brought up to the real scope - the hero and cards now name
the thirteen standards under conformance test instead of the original
two.
Claude-Session: https://claude.ai/code/session_013kkVt3nxi9svp1an28uHxf
* docs: didactic pages, figures, diagrams and theory for psychoacoustics and intensity
Three new audited figures in four language/theme variants (specific
loudness pattern narrowband-vs-broadband, STI vs T60 with the Annex F
rating bands against the analytic Schroeder curve, and plane-vs-standing
wave intensity panels showing the pressure-intensity index), two new
setup diagrams (p-p probe with the spacer dimension, STI measurement
chain), Spanish twins of the two new guide pages, three theory sections
(Zwicker chain, MTF/STI math, intensity estimator with its bias) in
EN docs, EN site and ES site with GitHub-safe math, and API rows for
all thirteen new exports in the three reference tables.
Claude-Session: https://claude.ai/code/session_013kkVt3nxi9svp1an28uHxf
* test: track the ISO 532-1 Annex B.4 pulse WAVs (were gitignored)
The global *.wav ignore silently excluded the four normative tone-pulse
fixtures, so CI failed with FileNotFoundError on every OS while local
runs passed against the untracked files. Force-added with an explicit
gitignore exception.
Claude-Session: https://claude.ai/code/session_013kkVt3nxi9svp1an28uHxf
* fix: address PR 80 review round 1
- docs: use the real dynamic_capability_index signature and keep the
intensity example bands under the 12 mm spacer validity ceiling
- docs: calibration example wording (raw recording, not already-Pa)
- changelog: merge the duplicated Unreleased Added sections
- loudness: reject non-finite inputs and pathological resampling ratios
(gcd-1 rates like 44101 Hz) with clear errors, regression-tested
- tests: anchor the Aures/von Bismarck variants to the 1 acum reference
within 0.05 acum instead of a loose sanity bound
Claude-Session: https://claude.ai/code/session_013kkVt3nxi9svp1an28uHxf
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.
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: building and structure-borne didactics, five rig diagrams and verified references (#193)
* docs: five structure-borne rig diagrams (ISO 9052-1, ISO 7626, ISO 10846, EN 15657, EN 12354-5)
Deterministic SVG builders with shared spring, accelerometer and exciter
helpers; light/dark and EN/ES variants of the dynamic-stiffness resonance
rig, the mobility beam rig, the direct/indirect transfer-stiffness stacks,
the reception plate and the EN 12354-5 installed-paths cross-section.
* docs: lab-vs-field quantities map and C/Ctr interpretation for the insulation guides
The apostrophe convention and flanking inclusion spelled out across the
trio, the extended lab/field quantities table, a didactic reading of the
spectrum adaptation terms, the measurement-prediction-check loop, and
verified References sections (Hopkins, Vigran, ISO 717-1, ISO 16283-1) in
the three copies (docs, site EN, site ES).
* docs: didactic depth for the structure-borne measurement guides
Rig diagrams embedded and prose added in all three copies: resonance-method
assumptions and preload pitfalls (EN 29052-1), how to read a mobility plot
and the ISO 7626-2 arrangement, why the blocked force and the frequency
split of the ISO 10846 methods, when the radiation-factor assumption breaks
(ISO/TS 7849), the reception-plate rationale (EN 15657) and the EN 12354-5
installation-paths context, each with a verified References section.
* docs: building-acoustics and structure-borne groups in the global bibliography
Hopkins, Vigran and Cremer/Heckl/Petersson with verified DOIs, the ISO
catalogue entries cited by the new References sections, and back-links to
the citing guides in the three bibliography copies.
* docs: legibility fixes in the mobility, transfer-stiffness and reception-plate diagrams
The driving-point caption clears the suspension spring, the Spanish
impedance-head caption clears the exciter stem, the excitation-mass boxes
fit the Spanish label, the indirect formula uses a consistent glyph style
and the Spanish source-quantities heading keeps a right margin.
* docs: precision and wording fixes in the new building and structure-borne prose
The radiation-factor caveat now qualifies accuracy rather than the bound,
Part 2 is tied explicitly to the radiation-factor problem, the survey
method keeps one Spanish term per page, the impedance-head note no longer
overstates, and Spanish register fixes (recrecido, diferencia, anclan) plus
site bibliography link texts aligned to the site page titles.
* docs: address review feedback on the building and structure-borne guides
- Field insulation guide: carry the spectrum adaptation terms on the field
descriptors (R'w + Ctr for facades, DnT,w + C between dwellings), matching
the example requirements of ISO 717-1, 5.3
- Transfer stiffness: state the ISO 10846-2 direct-method range from its
1 Hz scope bound instead of arbitrarily low frequencies, and say the
output is either rigidly blocked or loaded with a known mass
- Mechanical mobility: restrict the mobility-peak damping reading to the
isolated viscously damped resonator, present the soft free-free suspension
as the usual ISO 7626-2 arrangement rather than a requirement (clause 5),
and describe ISO 7626-5 as impact excitation with a non-attached exciter
whose spectrum is set by the impactor mass and tip stiffness
- Installed-paths diagram: render the EN 12354-5 Formula 17 path combination
as an energetic sum, 10 lg of the summed 10^(L/10) terms
- Spanish wording: parallel 'o bien ... o bien' in the transfer-stiffness
rig sentence and 'luego' in the resonance-rig diagram formula
docs: building and structure-borne didactics, five rig diagrams and verified references (#193)
* docs: five structure-borne rig diagrams (ISO 9052-1, ISO 7626, ISO 10846, EN 15657, EN 12354-5)
Deterministic SVG builders with shared spring, accelerometer and exciter
helpers; light/dark and EN/ES variants of the dynamic-stiffness resonance
rig, the mobility beam rig, the direct/indirect transfer-stiffness stacks,
the reception plate and the EN 12354-5 installed-paths cross-section.
* docs: lab-vs-field quantities map and C/Ctr interpretation for the insulation guides
The apostrophe convention and flanking inclusion spelled out across the
trio, the extended lab/field quantities table, a didactic reading of the
spectrum adaptation terms, the measurement-prediction-check loop, and
verified References sections (Hopkins, Vigran, ISO 717-1, ISO 16283-1) in
the three copies (docs, site EN, site ES).
* docs: didactic depth for the structure-borne measurement guides
Rig diagrams embedded and prose added in all three copies: resonance-method
assumptions and preload pitfalls (EN 29052-1), how to read a mobility plot
and the ISO 7626-2 arrangement, why the blocked force and the frequency
split of the ISO 10846 methods, when the radiation-factor assumption breaks
(ISO/TS 7849), the reception-plate rationale (EN 15657) and the EN 12354-5
installation-paths context, each with a verified References section.
* docs: building-acoustics and structure-borne groups in the global bibliography
Hopkins, Vigran and Cremer/Heckl/Petersson with verified DOIs, the ISO
catalogue entries cited by the new References sections, and back-links to
the citing guides in the three bibliography copies.
* docs: legibility fixes in the mobility, transfer-stiffness and reception-plate diagrams
The driving-point caption clears the suspension spring, the Spanish
impedance-head caption clears the exciter stem, the excitation-mass boxes
fit the Spanish label, the indirect formula uses a consistent glyph style
and the Spanish source-quantities heading keeps a right margin.
* docs: precision and wording fixes in the new building and structure-borne prose
The radiation-factor caveat now qualifies accuracy rather than the bound,
Part 2 is tied explicitly to the radiation-factor problem, the survey
method keeps one Spanish term per page, the impedance-head note no longer
overstates, and Spanish register fixes (recrecido, diferencia, anclan) plus
site bibliography link texts aligned to the site page titles.
* docs: address review feedback on the building and structure-borne guides
- Field insulation guide: carry the spectrum adaptation terms on the field
descriptors (R'w + Ctr for facades, DnT,w + C between dwellings), matching
the example requirements of ISO 717-1, 5.3
- Transfer stiffness: state the ISO 10846-2 direct-method range from its
1 Hz scope bound instead of arbitrarily low frequencies, and say the
output is either rigidly blocked or loaded with a known mass
- Mechanical mobility: restrict the mobility-peak damping reading to the
isolated viscously damped resonator, present the soft free-free suspension
as the usual ISO 7626-2 arrangement rather than a requirement (clause 5),
and describe ISO 7626-5 as impact excitation with a non-attached exciter
whose spectrum is set by the impactor mass and tip stiffness
- Installed-paths diagram: render the EN 12354-5 Formula 17 path combination
as an energetic sum, 10 lg of the summed 10^(L/10) terms
- Spanish wording: parallel 'o bien ... o bien' in the transfer-stiffness
rig sentence and 'luego' in the resonance-rig diagram formula
docs: building and structure-borne didactics, five rig diagrams and verified references (#193)
* docs: five structure-borne rig diagrams (ISO 9052-1, ISO 7626, ISO 10846, EN 15657, EN 12354-5)
Deterministic SVG builders with shared spring, accelerometer and exciter
helpers; light/dark and EN/ES variants of the dynamic-stiffness resonance
rig, the mobility beam rig, the direct/indirect transfer-stiffness stacks,
the reception plate and the EN 12354-5 installed-paths cross-section.
* docs: lab-vs-field quantities map and C/Ctr interpretation for the insulation guides
The apostrophe convention and flanking inclusion spelled out across the
trio, the extended lab/field quantities table, a didactic reading of the
spectrum adaptation terms, the measurement-prediction-check loop, and
verified References sections (Hopkins, Vigran, ISO 717-1, ISO 16283-1) in
the three copies (docs, site EN, site ES).
* docs: didactic depth for the structure-borne measurement guides
Rig diagrams embedded and prose added in all three copies: resonance-method
assumptions and preload pitfalls (EN 29052-1), how to read a mobility plot
and the ISO 7626-2 arrangement, why the blocked force and the frequency
split of the ISO 10846 methods, when the radiation-factor assumption breaks
(ISO/TS 7849), the reception-plate rationale (EN 15657) and the EN 12354-5
installation-paths context, each with a verified References section.
* docs: building-acoustics and structure-borne groups in the global bibliography
Hopkins, Vigran and Cremer/Heckl/Petersson with verified DOIs, the ISO
catalogue entries cited by the new References sections, and back-links to
the citing guides in the three bibliography copies.
* docs: legibility fixes in the mobility, transfer-stiffness and reception-plate diagrams
The driving-point caption clears the suspension spring, the Spanish
impedance-head caption clears the exciter stem, the excitation-mass boxes
fit the Spanish label, the indirect formula uses a consistent glyph style
and the Spanish source-quantities heading keeps a right margin.
* docs: precision and wording fixes in the new building and structure-borne prose
The radiation-factor caveat now qualifies accuracy rather than the bound,
Part 2 is tied explicitly to the radiation-factor problem, the survey
method keeps one Spanish term per page, the impedance-head note no longer
overstates, and Spanish register fixes (recrecido, diferencia, anclan) plus
site bibliography link texts aligned to the site page titles.
* docs: address review feedback on the building and structure-borne guides
- Field insulation guide: carry the spectrum adaptation terms on the field
descriptors (R'w + Ctr for facades, DnT,w + C between dwellings), matching
the example requirements of ISO 717-1, 5.3
- Transfer stiffness: state the ISO 10846-2 direct-method range from its
1 Hz scope bound instead of arbitrarily low frequencies, and say the
output is either rigidly blocked or loaded with a known mass
- Mechanical mobility: restrict the mobility-peak damping reading to the
isolated viscously damped resonator, present the soft free-free suspension
as the usual ISO 7626-2 arrangement rather than a requirement (clause 5),
and describe ISO 7626-5 as impact excitation with a non-attached exciter
whose spectrum is set by the impactor mass and tip stiffness
- Installed-paths diagram: render the EN 12354-5 Formula 17 path combination
as an energetic sum, 10 lg of the summed 10^(L/10) terms
- Spanish wording: parallel 'o bien ... o bien' in the transfer-stiffness
rig sentence and 'luego' in the resonance-rig diagram formula
docs: building and structure-borne didactics, five rig diagrams and verified references (#193)
* docs: five structure-borne rig diagrams (ISO 9052-1, ISO 7626, ISO 10846, EN 15657, EN 12354-5)
Deterministic SVG builders with shared spring, accelerometer and exciter
helpers; light/dark and EN/ES variants of the dynamic-stiffness resonance
rig, the mobility beam rig, the direct/indirect transfer-stiffness stacks,
the reception plate and the EN 12354-5 installed-paths cross-section.
* docs: lab-vs-field quantities map and C/Ctr interpretation for the insulation guides
The apostrophe convention and flanking inclusion spelled out across the
trio, the extended lab/field quantities table, a didactic reading of the
spectrum adaptation terms, the measurement-prediction-check loop, and
verified References sections (Hopkins, Vigran, ISO 717-1, ISO 16283-1) in
the three copies (docs, site EN, site ES).
* docs: didactic depth for the structure-borne measurement guides
Rig diagrams embedded and prose added in all three copies: resonance-method
assumptions and preload pitfalls (EN 29052-1), how to read a mobility plot
and the ISO 7626-2 arrangement, why the blocked force and the frequency
split of the ISO 10846 methods, when the radiation-factor assumption breaks
(ISO/TS 7849), the reception-plate rationale (EN 15657) and the EN 12354-5
installation-paths context, each with a verified References section.
* docs: building-acoustics and structure-borne groups in the global bibliography
Hopkins, Vigran and Cremer/Heckl/Petersson with verified DOIs, the ISO
catalogue entries cited by the new References sections, and back-links to
the citing guides in the three bibliography copies.
* docs: legibility fixes in the mobility, transfer-stiffness and reception-plate diagrams
The driving-point caption clears the suspension spring, the Spanish
impedance-head caption clears the exciter stem, the excitation-mass boxes
fit the Spanish label, the indirect formula uses a consistent glyph style
and the Spanish source-quantities heading keeps a right margin.
* docs: precision and wording fixes in the new building and structure-borne prose
The radiation-factor caveat now qualifies accuracy rather than the bound,
Part 2 is tied explicitly to the radiation-factor problem, the survey
method keeps one Spanish term per page, the impedance-head note no longer
overstates, and Spanish register fixes (recrecido, diferencia, anclan) plus
site bibliography link texts aligned to the site page titles.
* docs: address review feedback on the building and structure-borne guides
- Field insulation guide: carry the spectrum adaptation terms on the field
descriptors (R'w + Ctr for facades, DnT,w + C between dwellings), matching
the example requirements of ISO 717-1, 5.3
- Transfer stiffness: state the ISO 10846-2 direct-method range from its
1 Hz scope bound instead of arbitrarily low frequencies, and say the
output is either rigidly blocked or loaded with a known mass
- Mechanical mobility: restrict the mobility-peak damping reading to the
isolated viscously damped resonator, present the soft free-free suspension
as the usual ISO 7626-2 arrangement rather than a requirement (clause 5),
and describe ISO 7626-5 as impact excitation with a non-attached exciter
whose spectrum is set by the impactor mass and tip stiffness
- Installed-paths diagram: render the EN 12354-5 Formula 17 path combination
as an energetic sum, 10 lg of the summed 10^(L/10) terms
- Spanish wording: parallel 'o bien ... o bien' in the transfer-stiffness
rig sentence and 'luego' in the resonance-rig diagram formula
Spanish docs: UNE terminology, decimal commas, localized snippets and theory figures (#365)
* Normalize Spanish docs prose to UNE acoustic terminology
Sweep the Spanish pages for the non-UNE forms "presion sonora",
"potencia sonora" and "intensidad sonora" and normalize the prose to
the wording used by the official Spanish editions of the standards:
"presion acustica" (UNE-EN ISO 16283-2:2016, UNE-EN ISO 10052:2005,
UNE-EN ISO 3746:2011, UNE-ISO 226:2013), "potencia acustica"
(UNE-EN ISO 3746:2011, UNE-EN ISO 4871:2010, UNE-EN ISO 9614-1:2010),
"intensidad acustica" (UNE-EN 61043:1999, UNE-EN ISO 9614-1:2010) and
"nivel de presion acustica de impactos" (UNE-EN ISO 12354-2:2018,
UNE-EN ISO 717-2:2013). 92 replacements across 32 pages, prose only:
code snippets keep the labels they share with the generated figures.
Rename the intensity guide to "Intensidad acustica (p-p)" and the
structure-borne power guide to "Potencia acustica estructural de
equipos (EN 15657)", updating every cross-link text and the theory
anchor intensidad-sonora-iec-61043 accordingly. The API sidebar group
label becomes "Potencia acustica e intensidad" via api_taxonomy.py
with the generated sidebar regenerated.
* Use decimal commas in Spanish docs prose quantities
Sweep every Spanish page for decimal points leaking into prose numbers
and switch them to the comma the locale convention calls for: the
rotorcraft validation prose (fourteen tolerances such as 0,08 dB(A) and
0,5 s), the insulation-prediction worked example (53,6 dB / 53,8 dB),
the tone-audibility Annex E tone (137,3 Hz), the Mackenzie check value
(1550,744 m/s), the EPNL, loudness and absorption fiche descriptions
(98,3 EPNdB; 8,2 sonos and 70,4 fonios; 0,60 y 0,55), the junction
constants table and the third-octave band-edge table in the signal
analysis theory page. Code snippets, inline code, math, clause numbers
and quoted source text keep their points.
* Pass language="es" in Spanish figure-reproduction snippets
The <details> blocks under each localized figure in the Spanish guides
are meant to reproduce the _es variant shown on the page, but 82 of the
one-line result .plot() calls omitted the language="es" argument and
would render English axis labels instead. Add the argument across 33
guides, matching the pattern the intensity field-indicators snippet
already used. The three lab-insulation results whose plot() does not
take a language argument (lab airborne, lab impact and the
element-normalized intensity difference) are left as they were.
* Extend the UNE terminology sweep to sound absorption
Normalize "absorción sonora" to "absorción acústica" across the
Spanish pages (36 occurrences in 14 pages, including the EN 12354-6
guide title and the theory headings), the wording of UNE-EN ISO
3746:2011 and of the equivalent absorption area in UNE-EN ISO
10140-3:2011, UNE-EN ISO 12354-2:2018 and UNE-EN ISO 16283-2:2016, and
the same term the accredited report strings already use. Also restore
the accent in the theory index anchor to the renamed intensity heading,
since heading slugs keep accented characters.
* Theory pages: illustrate each section family with existing result figures
The seven theory pages carried no figures at all. Embed sixteen of the
existing generated figures (light and dark variants, Spanish variants on
the Spanish mirrors) where the concept matches the prose: weighting
curves, time integration and the p-p intensity estimator in the signal
analysis page; equal-loudness contours, the specific-loudness pattern
and the hearing-threshold panels in perception; NC/RC rating, the
Schroeder decay and the ISO 717-1 shifted reference in rooms and
buildings; the Lden profile, ISO 9613-1 absorption and the three sound
power routes in environment and transport; the scattering coefficient
and ISO 11654 rating in materials and surfaces; and the Wk weighting and
the resonator mobility triplet in vibration. Each embed reuses the alt
text of the guide that owns the figure and adds a one-line caption.
Also give the wave-simulation section hub the reading-order paragraph
its siblings already have, linking the closed-form pages the FDTD solver
cross-checks, in both languages.
* Address review findings from the Spanish locale sweeps
Second pass fixes flagged by review: five terminology occurrences the
line-based sweep missed because the noun and adjective were split by a
line wrap or emphasis markup (sound-power, rotorcraft-noise and two
section hubs); six Spanish pages that still embedded the English figure
variant although the _es variant exists (junction-transmission,
aircraft-noise airport contour, miso-coherence,
objective-intelligibility, psychoacoustic-annoyance twice); and 19 more
language="es" arguments on figure-reproduction plot calls the first
pass missed, chained-call receivers such as room.noise_criterion(spl)
.plot() and the axes-creating first call of the two-profile
atmospheric-refraction snippet among them. The lab-insulation plot
wrappers forward keyword arguments to the rating plot, so the three
calls excluded earlier now take the argument too. All Spanish python
fences re-checked to compile and EN/ES parity re-verified.
* Carry the UNE terminology into the generated-asset Spanish strings
Apply the same evidence-based decisions to every Spanish string source
that feeds generated assets: the translation tables of
generate_graphs.py and generate_diagrams.py, the _STRINGS tables of the
plot modules and the report i18n values. 35 strings change: "presión
acústica" (UNE-EN ISO 16283-2:2016, 10052:2005, 3746:2011),
"potencia acústica" (UNE-EN ISO 3746:2011, 4871:2010, 9614-1:2010),
"intensidad acústica" (UNE-EN 61043:1999, 9614-1:2010), "absorción
acústica" (UNE-EN ISO 3746:2011) and "nivel de presión acústica de
impactos" (UNE-EN ISO 12354-2:2018). Strings the UNE editions keep are
untouched: "emisión sonora", "exposición sonora", "campo sonoro",
"fuente sonora". Only Spanish values change; the English keys stay.
The two plot-i18n test assertions that pin the axis label follow, and
the eight Spanish doc fences that deliberately mirrored the old figure
labels now mirror the new ones.
* Regenerate the Spanish figure variants with the UNE terminology
make graphs after the string-source change: 48 files, all of them _es
or _es_dark variants (24 figure/diagram pairs), picking up "presión
acústica", "potencia acústica", "intensidad acústica", "absorción
acústica" and "nivel de presión acústica de impactos" in titles and
axis labels. The English variants are untouched. The committed example
fiches need no regeneration: every example in generate_reports.py
renders in English, so no changed Spanish report string reaches them.
* Align the intensity-fiche Spanish assertions with the UNE terminology
Spanish docs: UNE terminology, decimal commas, localized snippets and theory figures (#365)
* Normalize Spanish docs prose to UNE acoustic terminology
Sweep the Spanish pages for the non-UNE forms "presion sonora",
"potencia sonora" and "intensidad sonora" and normalize the prose to
the wording used by the official Spanish editions of the standards:
"presion acustica" (UNE-EN ISO 16283-2:2016, UNE-EN ISO 10052:2005,
UNE-EN ISO 3746:2011, UNE-ISO 226:2013), "potencia acustica"
(UNE-EN ISO 3746:2011, UNE-EN ISO 4871:2010, UNE-EN ISO 9614-1:2010),
"intensidad acustica" (UNE-EN 61043:1999, UNE-EN ISO 9614-1:2010) and
"nivel de presion acustica de impactos" (UNE-EN ISO 12354-2:2018,
UNE-EN ISO 717-2:2013). 92 replacements across 32 pages, prose only:
code snippets keep the labels they share with the generated figures.
Rename the intensity guide to "Intensidad acustica (p-p)" and the
structure-borne power guide to "Potencia acustica estructural de
equipos (EN 15657)", updating every cross-link text and the theory
anchor intensidad-sonora-iec-61043 accordingly. The API sidebar group
label becomes "Potencia acustica e intensidad" via api_taxonomy.py
with the generated sidebar regenerated.
* Use decimal commas in Spanish docs prose quantities
Sweep every Spanish page for decimal points leaking into prose numbers
and switch them to the comma the locale convention calls for: the
rotorcraft validation prose (fourteen tolerances such as 0,08 dB(A) and
0,5 s), the insulation-prediction worked example (53,6 dB / 53,8 dB),
the tone-audibility Annex E tone (137,3 Hz), the Mackenzie check value
(1550,744 m/s), the EPNL, loudness and absorption fiche descriptions
(98,3 EPNdB; 8,2 sonos and 70,4 fonios; 0,60 y 0,55), the junction
constants table and the third-octave band-edge table in the signal
analysis theory page. Code snippets, inline code, math, clause numbers
and quoted source text keep their points.
* Pass language="es" in Spanish figure-reproduction snippets
The <details> blocks under each localized figure in the Spanish guides
are meant to reproduce the _es variant shown on the page, but 82 of the
one-line result .plot() calls omitted the language="es" argument and
would render English axis labels instead. Add the argument across 33
guides, matching the pattern the intensity field-indicators snippet
already used. The three lab-insulation results whose plot() does not
take a language argument (lab airborne, lab impact and the
element-normalized intensity difference) are left as they were.
* Extend the UNE terminology sweep to sound absorption
Normalize "absorción sonora" to "absorción acústica" across the
Spanish pages (36 occurrences in 14 pages, including the EN 12354-6
guide title and the theory headings), the wording of UNE-EN ISO
3746:2011 and of the equivalent absorption area in UNE-EN ISO
10140-3:2011, UNE-EN ISO 12354-2:2018 and UNE-EN ISO 16283-2:2016, and
the same term the accredited report strings already use. Also restore
the accent in the theory index anchor to the renamed intensity heading,
since heading slugs keep accented characters.
* Theory pages: illustrate each section family with existing result figures
The seven theory pages carried no figures at all. Embed sixteen of the
existing generated figures (light and dark variants, Spanish variants on
the Spanish mirrors) where the concept matches the prose: weighting
curves, time integration and the p-p intensity estimator in the signal
analysis page; equal-loudness contours, the specific-loudness pattern
and the hearing-threshold panels in perception; NC/RC rating, the
Schroeder decay and the ISO 717-1 shifted reference in rooms and
buildings; the Lden profile, ISO 9613-1 absorption and the three sound
power routes in environment and transport; the scattering coefficient
and ISO 11654 rating in materials and surfaces; and the Wk weighting and
the resonator mobility triplet in vibration. Each embed reuses the alt
text of the guide that owns the figure and adds a one-line caption.
Also give the wave-simulation section hub the reading-order paragraph
its siblings already have, linking the closed-form pages the FDTD solver
cross-checks, in both languages.
* Address review findings from the Spanish locale sweeps
Second pass fixes flagged by review: five terminology occurrences the
line-based sweep missed because the noun and adjective were split by a
line wrap or emphasis markup (sound-power, rotorcraft-noise and two
section hubs); six Spanish pages that still embedded the English figure
variant although the _es variant exists (junction-transmission,
aircraft-noise airport contour, miso-coherence,
objective-intelligibility, psychoacoustic-annoyance twice); and 19 more
language="es" arguments on figure-reproduction plot calls the first
pass missed, chained-call receivers such as room.noise_criterion(spl)
.plot() and the axes-creating first call of the two-profile
atmospheric-refraction snippet among them. The lab-insulation plot
wrappers forward keyword arguments to the rating plot, so the three
calls excluded earlier now take the argument too. All Spanish python
fences re-checked to compile and EN/ES parity re-verified.
* Carry the UNE terminology into the generated-asset Spanish strings
Apply the same evidence-based decisions to every Spanish string source
that feeds generated assets: the translation tables of
generate_graphs.py and generate_diagrams.py, the _STRINGS tables of the
plot modules and the report i18n values. 35 strings change: "presión
acústica" (UNE-EN ISO 16283-2:2016, 10052:2005, 3746:2011),
"potencia acústica" (UNE-EN ISO 3746:2011, 4871:2010, 9614-1:2010),
"intensidad acústica" (UNE-EN 61043:1999, 9614-1:2010), "absorción
acústica" (UNE-EN ISO 3746:2011) and "nivel de presión acústica de
impactos" (UNE-EN ISO 12354-2:2018). Strings the UNE editions keep are
untouched: "emisión sonora", "exposición sonora", "campo sonoro",
"fuente sonora". Only Spanish values change; the English keys stay.
The two plot-i18n test assertions that pin the axis label follow, and
the eight Spanish doc fences that deliberately mirrored the old figure
labels now mirror the new ones.
* Regenerate the Spanish figure variants with the UNE terminology
make graphs after the string-source change: 48 files, all of them _es
or _es_dark variants (24 figure/diagram pairs), picking up "presión
acústica", "potencia acústica", "intensidad acústica", "absorción
acústica" and "nivel de presión acústica de impactos" in titles and
axis labels. The English variants are untouched. The committed example
fiches need no regeneration: every example in generate_reports.py
renders in English, so no changed Spanish report string reaches them.
* Align the intensity-fiche Spanish assertions with the UNE terminology
docs: final consistency sweep with titled Standards sections and theory references (#202)
* docs: promote closing Standards paragraphs to titled sections
Every guide's closing standards paragraph becomes a proper heading
(## Standards in English, ## Normas in Spanish) across docs/, the site
guides and their Spanish translations, replacing the horizontal rule and
bold-prefix convention. The bibliography pages now describe the new
convention. Content of every paragraph is unchanged.
* docs: add References sections to the domain theory pages
Each theory page (signal analysis, perception and hearing, rooms and
buildings, environment and transport, vibration) now closes with a
References section in English and Spanish, reusing the verified
bibliography entries with support notes tied to the sections of each
page. No new bibliography entries were needed.
* docs: link the bibliography from getting-started and why-phonometry
Getting-started's next-steps list and the closing paragraph of the
why-phonometry comparison now point to the bibliography, in English and
Spanish.
* docs(es): usar "cámara reverberante" en contextos de ISO 354 e ISO 17497
La sala de ensayo de ISO 354 e ISO 17497-1 pasa a llamarse cámara
reverberante en las guías y páginas de teoría en español y en las
etiquetas de los diagramas afectados (dispersión ISO 17497-1 e
ISO 11654), con las variantes SVG regeneradas de forma determinista.
Los contextos de ISO 3741 conservan "sala reverberante".
* docs(es): ISO 3746 es "método de inspección" en la página de teoría
La página de teoría de entorno y transporte alinea el nombre del método
de ISO 3746 con el título de la norma UNE y con la guía de potencia
sonora, que ya decían inspección.
* fix: cite ISO 389-7:2005, the edition actually implemented
The reference-threshold docstrings, theory pages, curated API table and
conformance labels said ISO 389-7:2006; the implemented edition is
ISO 389-7:2005 (EN ISO 389-7:2006 is its European adoption and keeps its
own year). Generated API pages and the conformance report regenerated.
* docs: shorten the high_accuracy table cell in the weighting guide
The oversampling and G-curve details move from the parameter table to
the high-frequency accuracy section, in English and Spanish; the cell
now fits on one line.
* docs: typeset the underwater-propagation formulas as math
The transmission-loss, sonar-equation, seabed-reflection and Wenz
rule-of-fives expressions move from inline code spans to LaTeX math in
the English and Spanish guides and the docs mirror, matching the rest of
the documentation.
* docs: add References sections to loudness, sound quality and multichannel
The three guides now cite their supporting bibliography entries
(Fastl & Zwicker, Fletcher & Munson, ISO 226, IEC 61260-1 and
IEC 61672-1) with per-page support notes, in English and Spanish, and
the bibliographies' cited-by lists are extended accordingly.
* docs(es): última "sala reverberante" pendiente en contexto ISO 17497-1
La frase partida entre líneas de la guía de dispersión superficial se
había escapado del barrido anterior.
* docs: refresh llms-full.txt from the current docs
The committed copy was last generated before the recent documentation
waves; regenerating picks up the didactic pages added since, the new
Standards and References sections and the ISO 389-7:2005 correction.
* docs(site): align the underwater propagation pages with the richer GitHub mirror
docs: final consistency sweep with titled Standards sections and theory references (#202)
* docs: promote closing Standards paragraphs to titled sections
Every guide's closing standards paragraph becomes a proper heading
(## Standards in English, ## Normas in Spanish) across docs/, the site
guides and their Spanish translations, replacing the horizontal rule and
bold-prefix convention. The bibliography pages now describe the new
convention. Content of every paragraph is unchanged.
* docs: add References sections to the domain theory pages
Each theory page (signal analysis, perception and hearing, rooms and
buildings, environment and transport, vibration) now closes with a
References section in English and Spanish, reusing the verified
bibliography entries with support notes tied to the sections of each
page. No new bibliography entries were needed.
* docs: link the bibliography from getting-started and why-phonometry
Getting-started's next-steps list and the closing paragraph of the
why-phonometry comparison now point to the bibliography, in English and
Spanish.
* docs(es): usar "cámara reverberante" en contextos de ISO 354 e ISO 17497
La sala de ensayo de ISO 354 e ISO 17497-1 pasa a llamarse cámara
reverberante en las guías y páginas de teoría en español y en las
etiquetas de los diagramas afectados (dispersión ISO 17497-1 e
ISO 11654), con las variantes SVG regeneradas de forma determinista.
Los contextos de ISO 3741 conservan "sala reverberante".
* docs(es): ISO 3746 es "método de inspección" en la página de teoría
La página de teoría de entorno y transporte alinea el nombre del método
de ISO 3746 con el título de la norma UNE y con la guía de potencia
sonora, que ya decían inspección.
* fix: cite ISO 389-7:2005, the edition actually implemented
The reference-threshold docstrings, theory pages, curated API table and
conformance labels said ISO 389-7:2006; the implemented edition is
ISO 389-7:2005 (EN ISO 389-7:2006 is its European adoption and keeps its
own year). Generated API pages and the conformance report regenerated.
* docs: shorten the high_accuracy table cell in the weighting guide
The oversampling and G-curve details move from the parameter table to
the high-frequency accuracy section, in English and Spanish; the cell
now fits on one line.
* docs: typeset the underwater-propagation formulas as math
The transmission-loss, sonar-equation, seabed-reflection and Wenz
rule-of-fives expressions move from inline code spans to LaTeX math in
the English and Spanish guides and the docs mirror, matching the rest of
the documentation.
* docs: add References sections to loudness, sound quality and multichannel
The three guides now cite their supporting bibliography entries
(Fastl & Zwicker, Fletcher & Munson, ISO 226, IEC 61260-1 and
IEC 61672-1) with per-page support notes, in English and Spanish, and
the bibliographies' cited-by lists are extended accordingly.
* docs(es): última "sala reverberante" pendiente en contexto ISO 17497-1
La frase partida entre líneas de la guía de dispersión superficial se
había escapado del barrido anterior.
* docs: refresh llms-full.txt from the current docs
The committed copy was last generated before the recent documentation
waves; regenerating picks up the didactic pages added since, the new
Standards and References sections and the ISO 389-7:2005 correction.
* docs(site): align the underwater propagation pages with the richer GitHub mirror
Didactic documentation: theory everywhere, bilingual figures, setup diagrams, parameter tables (#77)
* docs: harden diagram engine per visual audit
- dim() draws real witness lines from the measured points to the offset
dimension line (the offset=0 path emitted zero-length lines); vertical
labels sit left of the line, clear of masts and figures
- env diagram: the 4 m dimension now measures the mic axis itself and
the flush-mounted label moved to the clear zone between masts
- tonality top view: the 1.00 m dimension connects face and microphone
Claude-Session: https://claude.ai/code/session_013kkVt3nxi9svp1an28uHxf
* docs: bilingual diagram variants (EN/ES x light/dark)
Every setup diagram is now emitted in four variants; Spanish strings
(including decimal commas) come from a translation table applied by the
SVG engine, and layouts were adjusted where the longer Spanish labels
collided (env titles, processing-chain box width, calibration output
label, tonality dimension label side).
Claude-Session: https://claude.ai/code/session_013kkVt3nxi9svp1an28uHxf
* docs: bilingual figure variants for the ES site (EN/ES x light/dark)
generate_graphs.py now emits every figure in four variants: a Spanish
translation table (~75 exact strings + parametrized patterns) is applied
to the figure's Text artists at savefig time, so the generator functions
stay single-language internally. Spanish output uses UNE terminology
(ponderación temporal, líneas isofónicas, fonios, ráfaga) and a uniform
decimal comma (annotations and tick labels included); code identifiers
and normative mode names (Fast/Slow/Impulse) stay untranslated. The ES
site pages now reference the _es/_es_dark variants (56 URLs). The ES set
passed a 10-figure visual audit (10/10 approved, no blockers).
Claude-Session: https://claude.ai/code/session_013kkVt3nxi9svp1an28uHxf
* docs: didactic calibration page - theory, setup diagram, stability figure, parameter table
Adds the sensitivity-factor derivation with the calibration-chain SVG,
a new autogenerated calibration_stability figure (stable vs 3% AM tone
against the IEC 60942:2017 class 1 deviation band; 4 language/theme
variants; the ES decimal-comma pass now preserves clause numbers like
5.3.3), and a full parameter table for calculate_sensitivity - EN and
ES in parity.
Claude-Session: https://claude.ai/code/session_013kkVt3nxi9svp1an28uHxf
* docs: SEL concept, Lden 24h profile and annotated TNR spectrum figures
Three new didactic figures for the levels guide, each in four
language/theme variants: sel_concept (pass-by event vs its Leq and the
equal-energy 1 s SEL block, dBFS mode), lden_profile (synthetic urban
24 h LAeq with colored day/evening/night bands and the +5/+10 weighted
period levels clearly separated from the composite Lden), and
tonality_spectrum (averaged Hann spectrum with the critical band, the
detected tone and the live TNR value vs its criterion, computed by the
library itself).
Claude-Session: https://claude.ai/code/session_013kkVt3nxi9svp1an28uHxf
* docs: didactic levels guide, theory extensions and refreshed why-phonometry
- levels guide (EN docs+site): energy-mean rationale for Leq, percentile
semantics for LN, SEL and noise-dose theory with the new figures
embedded, TNR critical-band explanation with the annotated spectrum,
Lden profile figure, and parameter tables (type/units/range/default)
for every level function including the spectrogram
- theory page: five new sections (G-weighting pole/zero derivation,
ISO 226 formulae, ECMA-418-1 TNR/PR math, event/dose metrics,
ISO 1996-1 descriptors) with cross-references to the guides
- why-phonometry: rewritten around the conformance-testing story with
the per-standard verification table and honest ecosystem positioning
Claude-Session: https://claude.ai/code/session_013kkVt3nxi9svp1an28uHxf
* docs: weighting/time-weighting theory and parameter tables; fix math-block delimiters
The physiological origin of A/C (inverted 40/100-phon contours, the four
IEC corner frequencies) and the exponential-detector derivation with the
tau semantics, each with full parameter tables. Display math inserted by
the docs expansion now always uses block-style $$ delimiters on their
own lines - mid-line multi-line $$ blocks silently derailed remark
parsing and truncated every heading after them (caught because the
built pages lost their anchor ids); also replaced a raw < in a table.
Claude-Session: https://claude.ai/code/session_013kkVt3nxi9svp1an28uHxf
* docs: processing-chain and multirate diagrams, filter-bank math, streaming patterns
- getting-started embeds the processing-chain diagram as a guided map of
the guides
- filter-banks gains the IEC 61260-1 base-10 band math (G, fm, band
edges), a new multirate-decimation diagram (d5, four language/theme
variants) and the full octavefilter/OctaveFilterBank parameter table
- block-processing gains the canonical real-time level-meter loop
(validated against the actual API - TimeWeighting is inherently
stateful) and a stateful-constraints table
- multichannel gains the accepted-shapes table
Claude-Session: https://claude.ai/code/session_013kkVt3nxi9svp1an28uHxf
* docs: Spanish parity for the didactic expansion
Every enriched page now has its Spanish twin: levels (theory, three new
figures via _es variants, six parameter tables), weighting and
time-weighting (curve-origin and exponential-detector sections),
filter-banks (fractional-band math, multirate diagram, full parameter
table - terminology unified on 'decimación'), getting-started
(processing-chain map), block-processing (real-time meter pattern and
stateful constraints), multichannel (shapes table), theory (five new
sections) and a full rewrite of why-phonometry around the conformance
story. API reference now covers all 27 public exports in EN and ES
(added ToneAssessment and CalibrationWarning rows). UNE terminology and
Spanish decimal commas throughout; site builds with all links valid.
Claude-Session: https://claude.ai/code/session_013kkVt3nxi9svp1an28uHxf
* docs: audited fixes - Spanish tick commas and multirate note
Final visual-audit round: the d5 diagram now shows the no-decimation
note on the 16 kHz row in both languages, and Spanish figures render
every numeric tick with a decimal comma (FixedFormatter sequences are
rewritten in place; set_xticklabels-style FuncFormatters and plain
linear ScalarFormatters are wrapped - the first naive wrapper broke
ScalarFormatter ticks entirely and was caught visually).
Claude-Session: https://claude.ai/code/session_013kkVt3nxi9svp1an28uHxf
* docs(site): language selector in the mobile header, scrollable display math
Custom Header component (default markup plus a compact icon-only
LanguageSelect visible below the md breakpoint, where Starlight hides
the whole right group behind the hamburger menu) and overflow-x on
katex-display so wide formulas scroll inside their box on phones.
Verified with Playwright at 390 px in EN and ES.
Claude-Session: https://claude.ai/code/session_013kkVt3nxi9svp1an28uHxf
* fix: address review feedback on the didactic docs
- levels tables: spectrogram calibration_factor/dbfs marked constructor-
only, overlap range as 0 <= overlap < 1, composite hours constraints,
ln_levels shared-semantics row filled; ES translation leftovers and
the 'delante' typo fixed
- block-processing: y[..., -1] so the meter loop is multichannel-safe;
high_accuracy wording matches the real behavior (default resolves to
False, explicit True raises)
- API: CalibrationWarning row states the fs/validate preconditions (3 files)
- weighting: high_accuracy default column and oversampling claim made
precise (8x cap; silently ignored for G); ES row in parity
- filter-banks: 25 Hz relative bandwidth corrected to 0.024% of Nyquist
(EN/ES); verify_filter_class classes documented as 1/2/None
- generate_graphs: dropped the global plt.savefig monkey-patch - the
translation now runs inside themed_path(), which every generator
already calls at save time (verified output identical)
Claude-Session: https://claude.ai/code/session_013kkVt3nxi9svp1an28uHxf
Didactic documentation: theory everywhere, bilingual figures, setup diagrams, parameter tables (#77)
* docs: harden diagram engine per visual audit
- dim() draws real witness lines from the measured points to the offset
dimension line (the offset=0 path emitted zero-length lines); vertical
labels sit left of the line, clear of masts and figures
- env diagram: the 4 m dimension now measures the mic axis itself and
the flush-mounted label moved to the clear zone between masts
- tonality top view: the 1.00 m dimension connects face and microphone
Claude-Session: https://claude.ai/code/session_013kkVt3nxi9svp1an28uHxf
* docs: bilingual diagram variants (EN/ES x light/dark)
Every setup diagram is now emitted in four variants; Spanish strings
(including decimal commas) come from a translation table applied by the
SVG engine, and layouts were adjusted where the longer Spanish labels
collided (env titles, processing-chain box width, calibration output
label, tonality dimension label side).
Claude-Session: https://claude.ai/code/session_013kkVt3nxi9svp1an28uHxf
* docs: bilingual figure variants for the ES site (EN/ES x light/dark)
generate_graphs.py now emits every figure in four variants: a Spanish
translation table (~75 exact strings + parametrized patterns) is applied
to the figure's Text artists at savefig time, so the generator functions
stay single-language internally. Spanish output uses UNE terminology
(ponderación temporal, líneas isofónicas, fonios, ráfaga) and a uniform
decimal comma (annotations and tick labels included); code identifiers
and normative mode names (Fast/Slow/Impulse) stay untranslated. The ES
site pages now reference the _es/_es_dark variants (56 URLs). The ES set
passed a 10-figure visual audit (10/10 approved, no blockers).
Claude-Session: https://claude.ai/code/session_013kkVt3nxi9svp1an28uHxf
* docs: didactic calibration page - theory, setup diagram, stability figure, parameter table
Adds the sensitivity-factor derivation with the calibration-chain SVG,
a new autogenerated calibration_stability figure (stable vs 3% AM tone
against the IEC 60942:2017 class 1 deviation band; 4 language/theme
variants; the ES decimal-comma pass now preserves clause numbers like
5.3.3), and a full parameter table for calculate_sensitivity - EN and
ES in parity.
Claude-Session: https://claude.ai/code/session_013kkVt3nxi9svp1an28uHxf
* docs: SEL concept, Lden 24h profile and annotated TNR spectrum figures
Three new didactic figures for the levels guide, each in four
language/theme variants: sel_concept (pass-by event vs its Leq and the
equal-energy 1 s SEL block, dBFS mode), lden_profile (synthetic urban
24 h LAeq with colored day/evening/night bands and the +5/+10 weighted
period levels clearly separated from the composite Lden), and
tonality_spectrum (averaged Hann spectrum with the critical band, the
detected tone and the live TNR value vs its criterion, computed by the
library itself).
Claude-Session: https://claude.ai/code/session_013kkVt3nxi9svp1an28uHxf
* docs: didactic levels guide, theory extensions and refreshed why-phonometry
- levels guide (EN docs+site): energy-mean rationale for Leq, percentile
semantics for LN, SEL and noise-dose theory with the new figures
embedded, TNR critical-band explanation with the annotated spectrum,
Lden profile figure, and parameter tables (type/units/range/default)
for every level function including the spectrogram
- theory page: five new sections (G-weighting pole/zero derivation,
ISO 226 formulae, ECMA-418-1 TNR/PR math, event/dose metrics,
ISO 1996-1 descriptors) with cross-references to the guides
- why-phonometry: rewritten around the conformance-testing story with
the per-standard verification table and honest ecosystem positioning
Claude-Session: https://claude.ai/code/session_013kkVt3nxi9svp1an28uHxf
* docs: weighting/time-weighting theory and parameter tables; fix math-block delimiters
The physiological origin of A/C (inverted 40/100-phon contours, the four
IEC corner frequencies) and the exponential-detector derivation with the
tau semantics, each with full parameter tables. Display math inserted by
the docs expansion now always uses block-style $$ delimiters on their
own lines - mid-line multi-line $$ blocks silently derailed remark
parsing and truncated every heading after them (caught because the
built pages lost their anchor ids); also replaced a raw < in a table.
Claude-Session: https://claude.ai/code/session_013kkVt3nxi9svp1an28uHxf
* docs: processing-chain and multirate diagrams, filter-bank math, streaming patterns
- getting-started embeds the processing-chain diagram as a guided map of
the guides
- filter-banks gains the IEC 61260-1 base-10 band math (G, fm, band
edges), a new multirate-decimation diagram (d5, four language/theme
variants) and the full octavefilter/OctaveFilterBank parameter table
- block-processing gains the canonical real-time level-meter loop
(validated against the actual API - TimeWeighting is inherently
stateful) and a stateful-constraints table
- multichannel gains the accepted-shapes table
Claude-Session: https://claude.ai/code/session_013kkVt3nxi9svp1an28uHxf
* docs: Spanish parity for the didactic expansion
Every enriched page now has its Spanish twin: levels (theory, three new
figures via _es variants, six parameter tables), weighting and
time-weighting (curve-origin and exponential-detector sections),
filter-banks (fractional-band math, multirate diagram, full parameter
table - terminology unified on 'decimación'), getting-started
(processing-chain map), block-processing (real-time meter pattern and
stateful constraints), multichannel (shapes table), theory (five new
sections) and a full rewrite of why-phonometry around the conformance
story. API reference now covers all 27 public exports in EN and ES
(added ToneAssessment and CalibrationWarning rows). UNE terminology and
Spanish decimal commas throughout; site builds with all links valid.
Claude-Session: https://claude.ai/code/session_013kkVt3nxi9svp1an28uHxf
* docs: audited fixes - Spanish tick commas and multirate note
Final visual-audit round: the d5 diagram now shows the no-decimation
note on the 16 kHz row in both languages, and Spanish figures render
every numeric tick with a decimal comma (FixedFormatter sequences are
rewritten in place; set_xticklabels-style FuncFormatters and plain
linear ScalarFormatters are wrapped - the first naive wrapper broke
ScalarFormatter ticks entirely and was caught visually).
Claude-Session: https://claude.ai/code/session_013kkVt3nxi9svp1an28uHxf
* docs(site): language selector in the mobile header, scrollable display math
Custom Header component (default markup plus a compact icon-only
LanguageSelect visible below the md breakpoint, where Starlight hides
the whole right group behind the hamburger menu) and overflow-x on
katex-display so wide formulas scroll inside their box on phones.
Verified with Playwright at 390 px in EN and ES.
Claude-Session: https://claude.ai/code/session_013kkVt3nxi9svp1an28uHxf
* fix: address review feedback on the didactic docs
- levels tables: spectrogram calibration_factor/dbfs marked constructor-
only, overlap range as 0 <= overlap < 1, composite hours constraints,
ln_levels shared-semantics row filled; ES translation leftovers and
the 'delante' typo fixed
- block-processing: y[..., -1] so the meter loop is multichannel-safe;
high_accuracy wording matches the real behavior (default resolves to
False, explicit True raises)
- API: CalibrationWarning row states the fs/validate preconditions (3 files)
- weighting: high_accuracy default column and oversampling claim made
precise (8x cap; silently ignored for G); ES row in parity
- filter-banks: 25 Hz relative bandwidth corrected to 0.024% of Nyquist
(EN/ES); verify_filter_class classes documented as 1/2/None
- generate_graphs: dropped the global plt.savefig monkey-patch - the
translation now runs inside themed_path(), which every generator
already calls at save time (verified output identical)
Claude-Session: https://claude.ai/code/session_013kkVt3nxi9svp1an28uHxf
Didactic documentation: theory everywhere, bilingual figures, setup diagrams, parameter tables (#77)
* docs: harden diagram engine per visual audit
- dim() draws real witness lines from the measured points to the offset
dimension line (the offset=0 path emitted zero-length lines); vertical
labels sit left of the line, clear of masts and figures
- env diagram: the 4 m dimension now measures the mic axis itself and
the flush-mounted label moved to the clear zone between masts
- tonality top view: the 1.00 m dimension connects face and microphone
Claude-Session: https://claude.ai/code/session_013kkVt3nxi9svp1an28uHxf
* docs: bilingual diagram variants (EN/ES x light/dark)
Every setup diagram is now emitted in four variants; Spanish strings
(including decimal commas) come from a translation table applied by the
SVG engine, and layouts were adjusted where the longer Spanish labels
collided (env titles, processing-chain box width, calibration output
label, tonality dimension label side).
Claude-Session: https://claude.ai/code/session_013kkVt3nxi9svp1an28uHxf
* docs: bilingual figure variants for the ES site (EN/ES x light/dark)
generate_graphs.py now emits every figure in four variants: a Spanish
translation table (~75 exact strings + parametrized patterns) is applied
to the figure's Text artists at savefig time, so the generator functions
stay single-language internally. Spanish output uses UNE terminology
(ponderación temporal, líneas isofónicas, fonios, ráfaga) and a uniform
decimal comma (annotations and tick labels included); code identifiers
and normative mode names (Fast/Slow/Impulse) stay untranslated. The ES
site pages now reference the _es/_es_dark variants (56 URLs). The ES set
passed a 10-figure visual audit (10/10 approved, no blockers).
Claude-Session: https://claude.ai/code/session_013kkVt3nxi9svp1an28uHxf
* docs: didactic calibration page - theory, setup diagram, stability figure, parameter table
Adds the sensitivity-factor derivation with the calibration-chain SVG,
a new autogenerated calibration_stability figure (stable vs 3% AM tone
against the IEC 60942:2017 class 1 deviation band; 4 language/theme
variants; the ES decimal-comma pass now preserves clause numbers like
5.3.3), and a full parameter table for calculate_sensitivity - EN and
ES in parity.
Claude-Session: https://claude.ai/code/session_013kkVt3nxi9svp1an28uHxf
* docs: SEL concept, Lden 24h profile and annotated TNR spectrum figures
Three new didactic figures for the levels guide, each in four
language/theme variants: sel_concept (pass-by event vs its Leq and the
equal-energy 1 s SEL block, dBFS mode), lden_profile (synthetic urban
24 h LAeq with colored day/evening/night bands and the +5/+10 weighted
period levels clearly separated from the composite Lden), and
tonality_spectrum (averaged Hann spectrum with the critical band, the
detected tone and the live TNR value vs its criterion, computed by the
library itself).
Claude-Session: https://claude.ai/code/session_013kkVt3nxi9svp1an28uHxf
* docs: didactic levels guide, theory extensions and refreshed why-phonometry
- levels guide (EN docs+site): energy-mean rationale for Leq, percentile
semantics for LN, SEL and noise-dose theory with the new figures
embedded, TNR critical-band explanation with the annotated spectrum,
Lden profile figure, and parameter tables (type/units/range/default)
for every level function including the spectrogram
- theory page: five new sections (G-weighting pole/zero derivation,
ISO 226 formulae, ECMA-418-1 TNR/PR math, event/dose metrics,
ISO 1996-1 descriptors) with cross-references to the guides
- why-phonometry: rewritten around the conformance-testing story with
the per-standard verification table and honest ecosystem positioning
Claude-Session: https://claude.ai/code/session_013kkVt3nxi9svp1an28uHxf
* docs: weighting/time-weighting theory and parameter tables; fix math-block delimiters
The physiological origin of A/C (inverted 40/100-phon contours, the four
IEC corner frequencies) and the exponential-detector derivation with the
tau semantics, each with full parameter tables. Display math inserted by
the docs expansion now always uses block-style $$ delimiters on their
own lines - mid-line multi-line $$ blocks silently derailed remark
parsing and truncated every heading after them (caught because the
built pages lost their anchor ids); also replaced a raw < in a table.
Claude-Session: https://claude.ai/code/session_013kkVt3nxi9svp1an28uHxf
* docs: processing-chain and multirate diagrams, filter-bank math, streaming patterns
- getting-started embeds the processing-chain diagram as a guided map of
the guides
- filter-banks gains the IEC 61260-1 base-10 band math (G, fm, band
edges), a new multirate-decimation diagram (d5, four language/theme
variants) and the full octavefilter/OctaveFilterBank parameter table
- block-processing gains the canonical real-time level-meter loop
(validated against the actual API - TimeWeighting is inherently
stateful) and a stateful-constraints table
- multichannel gains the accepted-shapes table
Claude-Session: https://claude.ai/code/session_013kkVt3nxi9svp1an28uHxf
* docs: Spanish parity for the didactic expansion
Every enriched page now has its Spanish twin: levels (theory, three new
figures via _es variants, six parameter tables), weighting and
time-weighting (curve-origin and exponential-detector sections),
filter-banks (fractional-band math, multirate diagram, full parameter
table - terminology unified on 'decimación'), getting-started
(processing-chain map), block-processing (real-time meter pattern and
stateful constraints), multichannel (shapes table), theory (five new
sections) and a full rewrite of why-phonometry around the conformance
story. API reference now covers all 27 public exports in EN and ES
(added ToneAssessment and CalibrationWarning rows). UNE terminology and
Spanish decimal commas throughout; site builds with all links valid.
Claude-Session: https://claude.ai/code/session_013kkVt3nxi9svp1an28uHxf
* docs: audited fixes - Spanish tick commas and multirate note
Final visual-audit round: the d5 diagram now shows the no-decimation
note on the 16 kHz row in both languages, and Spanish figures render
every numeric tick with a decimal comma (FixedFormatter sequences are
rewritten in place; set_xticklabels-style FuncFormatters and plain
linear ScalarFormatters are wrapped - the first naive wrapper broke
ScalarFormatter ticks entirely and was caught visually).
Claude-Session: https://claude.ai/code/session_013kkVt3nxi9svp1an28uHxf
* docs(site): language selector in the mobile header, scrollable display math
Custom Header component (default markup plus a compact icon-only
LanguageSelect visible below the md breakpoint, where Starlight hides
the whole right group behind the hamburger menu) and overflow-x on
katex-display so wide formulas scroll inside their box on phones.
Verified with Playwright at 390 px in EN and ES.
Claude-Session: https://claude.ai/code/session_013kkVt3nxi9svp1an28uHxf
* fix: address review feedback on the didactic docs
- levels tables: spectrogram calibration_factor/dbfs marked constructor-
only, overlap range as 0 <= overlap < 1, composite hours constraints,
ln_levels shared-semantics row filled; ES translation leftovers and
the 'delante' typo fixed
- block-processing: y[..., -1] so the meter loop is multichannel-safe;
high_accuracy wording matches the real behavior (default resolves to
False, explicit True raises)
- API: CalibrationWarning row states the fs/validate preconditions (3 files)
- weighting: high_accuracy default column and oversampling claim made
precise (8x cap; silently ignored for G); ES row in parity
- filter-banks: 25 Hz relative bandwidth corrected to 0.024% of Nyquist
(EN/ES); verify_filter_class classes documented as 1/2/None
- generate_graphs: dropped the global plt.savefig monkey-patch - the
translation now runs inside themed_path(), which every generator
already calls at save time (verified output identical)
Claude-Session: https://claude.ai/code/session_013kkVt3nxi9svp1an28uHxf
Didactic documentation: theory everywhere, bilingual figures, setup diagrams, parameter tables (#77)
* docs: harden diagram engine per visual audit
- dim() draws real witness lines from the measured points to the offset
dimension line (the offset=0 path emitted zero-length lines); vertical
labels sit left of the line, clear of masts and figures
- env diagram: the 4 m dimension now measures the mic axis itself and
the flush-mounted label moved to the clear zone between masts
- tonality top view: the 1.00 m dimension connects face and microphone
Claude-Session: https://claude.ai/code/session_013kkVt3nxi9svp1an28uHxf
* docs: bilingual diagram variants (EN/ES x light/dark)
Every setup diagram is now emitted in four variants; Spanish strings
(including decimal commas) come from a translation table applied by the
SVG engine, and layouts were adjusted where the longer Spanish labels
collided (env titles, processing-chain box width, calibration output
label, tonality dimension label side).
Claude-Session: https://claude.ai/code/session_013kkVt3nxi9svp1an28uHxf
* docs: bilingual figure variants for the ES site (EN/ES x light/dark)
generate_graphs.py now emits every figure in four variants: a Spanish
translation table (~75 exact strings + parametrized patterns) is applied
to the figure's Text artists at savefig time, so the generator functions
stay single-language internally. Spanish output uses UNE terminology
(ponderación temporal, líneas isofónicas, fonios, ráfaga) and a uniform
decimal comma (annotations and tick labels included); code identifiers
and normative mode names (Fast/Slow/Impulse) stay untranslated. The ES
site pages now reference the _es/_es_dark variants (56 URLs). The ES set
passed a 10-figure visual audit (10/10 approved, no blockers).
Claude-Session: https://claude.ai/code/session_013kkVt3nxi9svp1an28uHxf
* docs: didactic calibration page - theory, setup diagram, stability figure, parameter table
Adds the sensitivity-factor derivation with the calibration-chain SVG,
a new autogenerated calibration_stability figure (stable vs 3% AM tone
against the IEC 60942:2017 class 1 deviation band; 4 language/theme
variants; the ES decimal-comma pass now preserves clause numbers like
5.3.3), and a full parameter table for calculate_sensitivity - EN and
ES in parity.
Claude-Session: https://claude.ai/code/session_013kkVt3nxi9svp1an28uHxf
* docs: SEL concept, Lden 24h profile and annotated TNR spectrum figures
Three new didactic figures for the levels guide, each in four
language/theme variants: sel_concept (pass-by event vs its Leq and the
equal-energy 1 s SEL block, dBFS mode), lden_profile (synthetic urban
24 h LAeq with colored day/evening/night bands and the +5/+10 weighted
period levels clearly separated from the composite Lden), and
tonality_spectrum (averaged Hann spectrum with the critical band, the
detected tone and the live TNR value vs its criterion, computed by the
library itself).
Claude-Session: https://claude.ai/code/session_013kkVt3nxi9svp1an28uHxf
* docs: didactic levels guide, theory extensions and refreshed why-phonometry
- levels guide (EN docs+site): energy-mean rationale for Leq, percentile
semantics for LN, SEL and noise-dose theory with the new figures
embedded, TNR critical-band explanation with the annotated spectrum,
Lden profile figure, and parameter tables (type/units/range/default)
for every level function including the spectrogram
- theory page: five new sections (G-weighting pole/zero derivation,
ISO 226 formulae, ECMA-418-1 TNR/PR math, event/dose metrics,
ISO 1996-1 descriptors) with cross-references to the guides
- why-phonometry: rewritten around the conformance-testing story with
the per-standard verification table and honest ecosystem positioning
Claude-Session: https://claude.ai/code/session_013kkVt3nxi9svp1an28uHxf
* docs: weighting/time-weighting theory and parameter tables; fix math-block delimiters
The physiological origin of A/C (inverted 40/100-phon contours, the four
IEC corner frequencies) and the exponential-detector derivation with the
tau semantics, each with full parameter tables. Display math inserted by
the docs expansion now always uses block-style $$ delimiters on their
own lines - mid-line multi-line $$ blocks silently derailed remark
parsing and truncated every heading after them (caught because the
built pages lost their anchor ids); also replaced a raw < in a table.
Claude-Session: https://claude.ai/code/session_013kkVt3nxi9svp1an28uHxf
* docs: processing-chain and multirate diagrams, filter-bank math, streaming patterns
- getting-started embeds the processing-chain diagram as a guided map of
the guides
- filter-banks gains the IEC 61260-1 base-10 band math (G, fm, band
edges), a new multirate-decimation diagram (d5, four language/theme
variants) and the full octavefilter/OctaveFilterBank parameter table
- block-processing gains the canonical real-time level-meter loop
(validated against the actual API - TimeWeighting is inherently
stateful) and a stateful-constraints table
- multichannel gains the accepted-shapes table
Claude-Session: https://claude.ai/code/session_013kkVt3nxi9svp1an28uHxf
* docs: Spanish parity for the didactic expansion
Every enriched page now has its Spanish twin: levels (theory, three new
figures via _es variants, six parameter tables), weighting and
time-weighting (curve-origin and exponential-detector sections),
filter-banks (fractional-band math, multirate diagram, full parameter
table - terminology unified on 'decimación'), getting-started
(processing-chain map), block-processing (real-time meter pattern and
stateful constraints), multichannel (shapes table), theory (five new
sections) and a full rewrite of why-phonometry around the conformance
story. API reference now covers all 27 public exports in EN and ES
(added ToneAssessment and CalibrationWarning rows). UNE terminology and
Spanish decimal commas throughout; site builds with all links valid.
Claude-Session: https://claude.ai/code/session_013kkVt3nxi9svp1an28uHxf
* docs: audited fixes - Spanish tick commas and multirate note
Final visual-audit round: the d5 diagram now shows the no-decimation
note on the 16 kHz row in both languages, and Spanish figures render
every numeric tick with a decimal comma (FixedFormatter sequences are
rewritten in place; set_xticklabels-style FuncFormatters and plain
linear ScalarFormatters are wrapped - the first naive wrapper broke
ScalarFormatter ticks entirely and was caught visually).
Claude-Session: https://claude.ai/code/session_013kkVt3nxi9svp1an28uHxf
* docs(site): language selector in the mobile header, scrollable display math
Custom Header component (default markup plus a compact icon-only
LanguageSelect visible below the md breakpoint, where Starlight hides
the whole right group behind the hamburger menu) and overflow-x on
katex-display so wide formulas scroll inside their box on phones.
Verified with Playwright at 390 px in EN and ES.
Claude-Session: https://claude.ai/code/session_013kkVt3nxi9svp1an28uHxf
* fix: address review feedback on the didactic docs
- levels tables: spectrogram calibration_factor/dbfs marked constructor-
only, overlap range as 0 <= overlap < 1, composite hours constraints,
ln_levels shared-semantics row filled; ES translation leftovers and
the 'delante' typo fixed
- block-processing: y[..., -1] so the meter loop is multichannel-safe;
high_accuracy wording matches the real behavior (default resolves to
False, explicit True raises)
- API: CalibrationWarning row states the fs/validate preconditions (3 files)
- weighting: high_accuracy default column and oversampling claim made
precise (8x cap; silently ignored for G); ES row in parity
- filter-banks: 25 Hz relative bandwidth corrected to 0.024% of Nyquist
(EN/ES); verify_filter_class classes documented as 1/2/None
- generate_graphs: dropped the global plt.savefig monkey-patch - the
translation now runs inside themed_path(), which every generator
already calls at save time (verified output identical)
Claude-Session: https://claude.ai/code/session_013kkVt3nxi9svp1an28uHxf
Sound power determination and building acoustics II: ISO 3744/3746, ISO 3741, ISO 9614-2, ISO 16283-2 + ISO 717-2, ISO 354 (#84)
* feat: ISO 3744/3746 sound power from pressure measurements
Add sound_power.py: sound power level of a noise source from sound
pressure levels over an enveloping measurement surface, ISO 3744:2010
(engineering, grade 2) and ISO 3746:2010 (survey, grade 3).
- sound_power_pressure(): per-band LW and A-weighted LWA from an
(NM, NB) level array over a hemisphere (radius) or parallelepiped
(dimensions + distance); surface area from the standard's closed forms
for 1/2/3 reflecting planes; energy average (Eq. 12), background K1
(Eq. 16), environmental K2 (Eq. A.2), apparent directivity index
(Eq. 7), expanded uncertainty.
- measurement_positions(): normative Annex B coordinates
(Tables B.1/B.2/B.3), grade- and plane-dependent subsets.
- background_noise_correction(): K1 with engineering/survey criteria.
- environmental_correction(): K2 from A, Sabine T+V, or alpha*Sv.
- SoundPowerResult (frozen dataclass), SoundPowerWarning.
Tests: 24 cases incl. monopole-over-plane exact LW recovery, radius
independence, K1/K2 closed forms, LWA via Annex E, and validations.
make check green (543 passed, 12 skipped); ruff/bandit/mypy --strict clean.
Claude-Session: https://claude.ai/code/session_013kkVt3nxi9svp1an28uHxf
* fix: directivity index under background correction, citation hygiene
Broadband K1 for the apparent directivity index was collapsing to the
surface-area term 10*lg(S/S0) (~+22 dB inflation with background
correction). Compute the true energy-based broadband K1 (per-band Eq. 16
aggregated over bands) so DI is correct in both paths.
Also: multi-band sound_power_level_a without frequencies now returns NaN
(A-weighting needs band centres); dropped PDF page-number citations from
Annex B/E table comments; corrected the survey parallelepiped position
citation to ISO 3746 clause C.1 / Figure C.7.
Claude-Session: https://claude.ai/code/session_013kkVt3nxi9svp1an28uHxf
* feat: ISO 3741 reverberation-room sound power
Add the ISO 3741:2010 precision (grade 1) methods for determining sound
power in a reverberation test room, in a new sound_power_reverberation
module:
- sound_power_reverberation() — direct method (Eq. 20): LW from the mean
room SPL and the Sabine equivalent absorption area A = (55,26/c)(V/T60),
with the full normative bracket: 10 lg(A/A0), 4,34*(A/S), the Waterhouse
boundary term 10 lg(1 + S c/(8 V f)), the reference-quantity (C1) and
radiation-impedance (C2) meteorological corrections and the -6 dB
constant. Speed of sound c = 20,05*sqrt(273 + theta).
- sound_power_comparison() — comparison method (Eq. 21) with a reference
sound source: LW = LW(RSS) + (Lp(ST) - Lp(RSS) + C2).
- ReverberationSoundPowerResult frozen dataclass; frequency-dependent
background correction K1 (Eq. 14, same formula as ISO 3744) with the
precision-grade 6/10 dB criteria; A-weighted total via Annex F.
Reuses the ISO 3744 energy-average and A-weighting helpers. Tests cover
exact inversion of Eq. (20), the Waterhouse term vanishing at high
frequency, the comparison method exact by construction, and synergy with
room_parameters T30 feeding the direct method.
Claude-Session: https://claude.ai/code/session_013kkVt3nxi9svp1an28uHxf
* fix: ISO 3741 room-qualification advisories and validation ordering
Claude-Session: https://claude.ai/code/session_013kkVt3nxi9svp1an28uHxf
* feat: ISO 9614-2 sound power by intensity scanning
Add sound_power_intensity() computing per-band LW = 10lg(sum Pi/P0) from
per-segment signed normal intensity and areas (partial power Pi = <In,i>*Si),
the scanning-method field indicators FpI (Eq. A.1) and F+/- (Eq. A.2), the
repeatability criterion 3, and the achieved engineering/survey grade per band
(Annex B criteria 1-3). Negative total power flags bands as non-determinable
(clause 9.2); negative partial power raises SoundPowerWarning. Reuses
dynamic_capability_index for Ld = dpI0 - K (Table 1).
Claude-Session: https://claude.ai/code/session_013kkVt3nxi9svp1an28uHxf
* feat: ISO 16283-2 impact sound insulation and ISO 717-2 ratings
Add field impact sound insulation (ISO 16283-2, tapping machine) and the
ISO 717-2 single-number weighted impact rating with the CI spectrum
adaptation term, reusing the verified reference-curve shift engine.
- impact_insulation(li, t2, *, volume=None, t0=0.5): per-band
L'nT = Li - 10 lg(T/T0) (Formula (1)) and L'n = Li + 10 lg(A/A0) with
A = 0,16 V/T, A0 = 10 m2 (Formula (2)); positions energy-averaged.
- weighted_impact_rating(values_by_band, bands=None): Ln,w / L'n,w /
L'nT,w (Clause 4.3, octave -5 dB rule) and CI (Clause A.2.1, energetic
sum 100-2500 / 125-2000). Impact unfavourable deviations (measurement
exceeds reference, sign opposite to airborne) reduce to the airborne
search on negated curves, so _best_shift is reused verbatim.
- _best_shift: tolerance absorbs float noise at the exact bound (sums are
true multiples of 0,1 dB); airborne behaviour unchanged.
Verified against ISO 717-2 Annex C worked examples (Table C.1 Ln,w=79,
CI=-11; Table C.3 octave Ln,w=54, CI=0) and an independent brute-force
shift search on 10 000 random curves per band set. 2013 and 2020 editions
are identical for all implemented maths (2020 only adds Annex D rubber
ball, out of scope).
Claude-Session: https://claude.ai/code/session_013kkVt3nxi9svp1an28uHxf
* feat: ISO 354 sound absorption in a reverberation room
Add phonometry.sound_absorption implementing BS EN ISO 354:2003:
- absorption_area(t60, volume, ...): equivalent sound absorption area
A = 55,3*V/(c*T) - 4*V*m (Eq. 5/7), speed of sound from Eq. (6).
- absorption_coefficient(t1, t2, volume, sample_area, ...): alpha_s =
(A2-A1)/S built from Eq. (8)/(9), per-measurement c1/c2, unclamped
(alpha_s > 1 valid, clause 3.7 NOTE 2); warns when T2 >= T1.
- attenuation_from_alpha: ISO-354 conversion m = alpha/(10 lg e) from an
ISO 9613-1 attenuation coefficient (m deferred to ISO 9613-1, default 0).
Composes directly with room_parameters() T20/T30 outputs. 25 tests
(exact T->A->T inversion, synthetic-alpha recovery, zero-m air term,
two-temperature Eq. (8), range validation, room_parameters synergy).
Claude-Session: https://claude.ai/code/session_013kkVt3nxi9svp1an28uHxf
* fix: ISO 354 room and sample-size advisories
Add advisory AbsorptionWarning (never raising; result still returned) for
setup conditions outside ISO 354:2003 limits:
- Room volume below the 150 m3 minimum of clause 6.1.1, in both
absorption_area and absorption_coefficient.
- Sample area outside the clause 6.2.1.1 range 10 <= S <= 12 m2, with the
upper limit scaled by (V/200)^(2/3) when V > 200 m3, in
absorption_coefficient.
The volume advisory is emitted once by absorption_coefficient and suppressed
in its internal absorption_area calls to avoid duplicate warnings.
Claude-Session: https://claude.ai/code/session_013kkVt3nxi9svp1an28uHxf
* fix: deferred review minors — airborne brute-force net, advisory consistency, labels
Claude-Session: https://claude.ai/code/session_013kkVt3nxi9svp1an28uHxf
* docs: sound power guide, impact and absorption sections, theory and API (EN)
Add a "Sound Power" guide covering the three LW routes (ISO 3744/3746
enveloping surface, ISO 3741 reverberation room with Waterhouse/C1/C2,
ISO 9614-2 intensity scanning), with a method-comparison table, executed
snippets and parameter tables. Extend the Room & Building Acoustics guide
with impact sound insulation (ISO 16283-2 + ISO 717-2, L'nT/L'n, tapping
machine, CI) and sound absorption in a reverberation room (ISO 354).
Add the matching theory sections (K1/K2, Waterhouse, C1/C2 derivations;
impact sign conventions; Sabine absorption) and API-reference rows for all
new public names. Update the landing standards count to 26, the sidebar,
README highlights/table, CHANGELOG and llms-full.txt.
Claude-Session: https://claude.ai/code/session_013kkVt3nxi9svp1an28uHxf
* docs: sound-power and impact figures and diagrams
Claude-Session: https://claude.ai/code/session_013kkVt3nxi9svp1an28uHxf
* docs: include the sound-power guide in llms coverage
Claude-Session: https://claude.ai/code/session_013kkVt3nxi9svp1an28uHxf
* docs: reposition Ln,w annotation in the impact figure
Claude-Session: https://claude.ai/code/session_013kkVt3nxi9svp1an28uHxf
* docs: gemelas ES de potencia sonora, impacto y absorción
Claude-Session: https://claude.ai/code/session_013kkVt3nxi9svp1an28uHxf
* fix: final-review findings — comparison K1 reporting, citations, knee unification, docs attribution
- sound_power_comparison now reports the test-source K1 actually applied
per band (zero when no background), matching the dataclass docstring;
LW unchanged.
- Replace gitignored notes-iso3744-3746.md citation in the DI comment with
the standard reference (ISO 3744:2010, 3.24 / Eq. 7 context).
- Unify the K1 zeroing knee to the >= form (ΔLp >= 15 -> no correction).
- Broaden SoundPowerWarning docstring to name all emitters (ISO 3744/3746,
ISO 3741, ISO 9614-2).
- Fix docs misattributing K2 to ISO 3741 (ISO 3744 K2 vs ISO 3741 absorption
term) across EN/ES room-acoustics guides.
- EN impact-setup diagram uses dot decimals (0.16); regenerate the 4 variants.
- CHANGELOG: label the ISO 717-2 Annex C value Ln,w = 79.
- Warn-after-validate in sound_power_comparison; "is raised" -> "is emitted".
Claude-Session: https://claude.ai/code/session_013kkVt3nxi9svp1an28uHxf
* fix: PR 84 review round 1 — per-band DI and K2, sweep-reversal repeatability, validation and broadcast ergonomics
Claude-Session: https://claude.ai/code/session_013kkVt3nxi9svp1an28uHxf
* fix: PR 84 round 2 — partial room-data validation, result-field docs
Raise a clear ValueError in environmental_correction (and its
sound_power_pressure pass-through) when exactly one member of a
room-data pair (reverberation_time/room_volume or
mean_absorption_coefficient/room_surface) is supplied, instead of
silently returning K2=0 as if free field. All-None remains the
legitimate free-field K2=0 path.
Document frequencies on the ReverberationSoundPowerResult row and
negative_band as a standalone per-band boolean field on the
SoundPowerIntensityResult row across docs/api-reference.md and the
EN/ES site twins.
Claude-Session: https://claude.ai/code/session_013kkVt3nxi9svp1an28uHxf
Sound power determination and building acoustics II: ISO 3744/3746, ISO 3741, ISO 9614-2, ISO 16283-2 + ISO 717-2, ISO 354 (#84)
* feat: ISO 3744/3746 sound power from pressure measurements
Add sound_power.py: sound power level of a noise source from sound
pressure levels over an enveloping measurement surface, ISO 3744:2010
(engineering, grade 2) and ISO 3746:2010 (survey, grade 3).
- sound_power_pressure(): per-band LW and A-weighted LWA from an
(NM, NB) level array over a hemisphere (radius) or parallelepiped
(dimensions + distance); surface area from the standard's closed forms
for 1/2/3 reflecting planes; energy average (Eq. 12), background K1
(Eq. 16), environmental K2 (Eq. A.2), apparent directivity index
(Eq. 7), expanded uncertainty.
- measurement_positions(): normative Annex B coordinates
(Tables B.1/B.2/B.3), grade- and plane-dependent subsets.
- background_noise_correction(): K1 with engineering/survey criteria.
- environmental_correction(): K2 from A, Sabine T+V, or alpha*Sv.
- SoundPowerResult (frozen dataclass), SoundPowerWarning.
Tests: 24 cases incl. monopole-over-plane exact LW recovery, radius
independence, K1/K2 closed forms, LWA via Annex E, and validations.
make check green (543 passed, 12 skipped); ruff/bandit/mypy --strict clean.
Claude-Session: https://claude.ai/code/session_013kkVt3nxi9svp1an28uHxf
* fix: directivity index under background correction, citation hygiene
Broadband K1 for the apparent directivity index was collapsing to the
surface-area term 10*lg(S/S0) (~+22 dB inflation with background
correction). Compute the true energy-based broadband K1 (per-band Eq. 16
aggregated over bands) so DI is correct in both paths.
Also: multi-band sound_power_level_a without frequencies now returns NaN
(A-weighting needs band centres); dropped PDF page-number citations from
Annex B/E table comments; corrected the survey parallelepiped position
citation to ISO 3746 clause C.1 / Figure C.7.
Claude-Session: https://claude.ai/code/session_013kkVt3nxi9svp1an28uHxf
* feat: ISO 3741 reverberation-room sound power
Add the ISO 3741:2010 precision (grade 1) methods for determining sound
power in a reverberation test room, in a new sound_power_reverberation
module:
- sound_power_reverberation() — direct method (Eq. 20): LW from the mean
room SPL and the Sabine equivalent absorption area A = (55,26/c)(V/T60),
with the full normative bracket: 10 lg(A/A0), 4,34*(A/S), the Waterhouse
boundary term 10 lg(1 + S c/(8 V f)), the reference-quantity (C1) and
radiation-impedance (C2) meteorological corrections and the -6 dB
constant. Speed of sound c = 20,05*sqrt(273 + theta).
- sound_power_comparison() — comparison method (Eq. 21) with a reference
sound source: LW = LW(RSS) + (Lp(ST) - Lp(RSS) + C2).
- ReverberationSoundPowerResult frozen dataclass; frequency-dependent
background correction K1 (Eq. 14, same formula as ISO 3744) with the
precision-grade 6/10 dB criteria; A-weighted total via Annex F.
Reuses the ISO 3744 energy-average and A-weighting helpers. Tests cover
exact inversion of Eq. (20), the Waterhouse term vanishing at high
frequency, the comparison method exact by construction, and synergy with
room_parameters T30 feeding the direct method.
Claude-Session: https://claude.ai/code/session_013kkVt3nxi9svp1an28uHxf
* fix: ISO 3741 room-qualification advisories and validation ordering
Claude-Session: https://claude.ai/code/session_013kkVt3nxi9svp1an28uHxf
* feat: ISO 9614-2 sound power by intensity scanning
Add sound_power_intensity() computing per-band LW = 10lg(sum Pi/P0) from
per-segment signed normal intensity and areas (partial power Pi = <In,i>*Si),
the scanning-method field indicators FpI (Eq. A.1) and F+/- (Eq. A.2), the
repeatability criterion 3, and the achieved engineering/survey grade per band
(Annex B criteria 1-3). Negative total power flags bands as non-determinable
(clause 9.2); negative partial power raises SoundPowerWarning. Reuses
dynamic_capability_index for Ld = dpI0 - K (Table 1).
Claude-Session: https://claude.ai/code/session_013kkVt3nxi9svp1an28uHxf
* feat: ISO 16283-2 impact sound insulation and ISO 717-2 ratings
Add field impact sound insulation (ISO 16283-2, tapping machine) and the
ISO 717-2 single-number weighted impact rating with the CI spectrum
adaptation term, reusing the verified reference-curve shift engine.
- impact_insulation(li, t2, *, volume=None, t0=0.5): per-band
L'nT = Li - 10 lg(T/T0) (Formula (1)) and L'n = Li + 10 lg(A/A0) with
A = 0,16 V/T, A0 = 10 m2 (Formula (2)); positions energy-averaged.
- weighted_impact_rating(values_by_band, bands=None): Ln,w / L'n,w /
L'nT,w (Clause 4.3, octave -5 dB rule) and CI (Clause A.2.1, energetic
sum 100-2500 / 125-2000). Impact unfavourable deviations (measurement
exceeds reference, sign opposite to airborne) reduce to the airborne
search on negated curves, so _best_shift is reused verbatim.
- _best_shift: tolerance absorbs float noise at the exact bound (sums are
true multiples of 0,1 dB); airborne behaviour unchanged.
Verified against ISO 717-2 Annex C worked examples (Table C.1 Ln,w=79,
CI=-11; Table C.3 octave Ln,w=54, CI=0) and an independent brute-force
shift search on 10 000 random curves per band set. 2013 and 2020 editions
are identical for all implemented maths (2020 only adds Annex D rubber
ball, out of scope).
Claude-Session: https://claude.ai/code/session_013kkVt3nxi9svp1an28uHxf
* feat: ISO 354 sound absorption in a reverberation room
Add phonometry.sound_absorption implementing BS EN ISO 354:2003:
- absorption_area(t60, volume, ...): equivalent sound absorption area
A = 55,3*V/(c*T) - 4*V*m (Eq. 5/7), speed of sound from Eq. (6).
- absorption_coefficient(t1, t2, volume, sample_area, ...): alpha_s =
(A2-A1)/S built from Eq. (8)/(9), per-measurement c1/c2, unclamped
(alpha_s > 1 valid, clause 3.7 NOTE 2); warns when T2 >= T1.
- attenuation_from_alpha: ISO-354 conversion m = alpha/(10 lg e) from an
ISO 9613-1 attenuation coefficient (m deferred to ISO 9613-1, default 0).
Composes directly with room_parameters() T20/T30 outputs. 25 tests
(exact T->A->T inversion, synthetic-alpha recovery, zero-m air term,
two-temperature Eq. (8), range validation, room_parameters synergy).
Claude-Session: https://claude.ai/code/session_013kkVt3nxi9svp1an28uHxf
* fix: ISO 354 room and sample-size advisories
Add advisory AbsorptionWarning (never raising; result still returned) for
setup conditions outside ISO 354:2003 limits:
- Room volume below the 150 m3 minimum of clause 6.1.1, in both
absorption_area and absorption_coefficient.
- Sample area outside the clause 6.2.1.1 range 10 <= S <= 12 m2, with the
upper limit scaled by (V/200)^(2/3) when V > 200 m3, in
absorption_coefficient.
The volume advisory is emitted once by absorption_coefficient and suppressed
in its internal absorption_area calls to avoid duplicate warnings.
Claude-Session: https://claude.ai/code/session_013kkVt3nxi9svp1an28uHxf
* fix: deferred review minors — airborne brute-force net, advisory consistency, labels
Claude-Session: https://claude.ai/code/session_013kkVt3nxi9svp1an28uHxf
* docs: sound power guide, impact and absorption sections, theory and API (EN)
Add a "Sound Power" guide covering the three LW routes (ISO 3744/3746
enveloping surface, ISO 3741 reverberation room with Waterhouse/C1/C2,
ISO 9614-2 intensity scanning), with a method-comparison table, executed
snippets and parameter tables. Extend the Room & Building Acoustics guide
with impact sound insulation (ISO 16283-2 + ISO 717-2, L'nT/L'n, tapping
machine, CI) and sound absorption in a reverberation room (ISO 354).
Add the matching theory sections (K1/K2, Waterhouse, C1/C2 derivations;
impact sign conventions; Sabine absorption) and API-reference rows for all
new public names. Update the landing standards count to 26, the sidebar,
README highlights/table, CHANGELOG and llms-full.txt.
Claude-Session: https://claude.ai/code/session_013kkVt3nxi9svp1an28uHxf
* docs: sound-power and impact figures and diagrams
Claude-Session: https://claude.ai/code/session_013kkVt3nxi9svp1an28uHxf
* docs: include the sound-power guide in llms coverage
Claude-Session: https://claude.ai/code/session_013kkVt3nxi9svp1an28uHxf
* docs: reposition Ln,w annotation in the impact figure
Claude-Session: https://claude.ai/code/session_013kkVt3nxi9svp1an28uHxf
* docs: gemelas ES de potencia sonora, impacto y absorción
Claude-Session: https://claude.ai/code/session_013kkVt3nxi9svp1an28uHxf
* fix: final-review findings — comparison K1 reporting, citations, knee unification, docs attribution
- sound_power_comparison now reports the test-source K1 actually applied
per band (zero when no background), matching the dataclass docstring;
LW unchanged.
- Replace gitignored notes-iso3744-3746.md citation in the DI comment with
the standard reference (ISO 3744:2010, 3.24 / Eq. 7 context).
- Unify the K1 zeroing knee to the >= form (ΔLp >= 15 -> no correction).
- Broaden SoundPowerWarning docstring to name all emitters (ISO 3744/3746,
ISO 3741, ISO 9614-2).
- Fix docs misattributing K2 to ISO 3741 (ISO 3744 K2 vs ISO 3741 absorption
term) across EN/ES room-acoustics guides.
- EN impact-setup diagram uses dot decimals (0.16); regenerate the 4 variants.
- CHANGELOG: label the ISO 717-2 Annex C value Ln,w = 79.
- Warn-after-validate in sound_power_comparison; "is raised" -> "is emitted".
Claude-Session: https://claude.ai/code/session_013kkVt3nxi9svp1an28uHxf
* fix: PR 84 review round 1 — per-band DI and K2, sweep-reversal repeatability, validation and broadcast ergonomics
Claude-Session: https://claude.ai/code/session_013kkVt3nxi9svp1an28uHxf
* fix: PR 84 round 2 — partial room-data validation, result-field docs
Raise a clear ValueError in environmental_correction (and its
sound_power_pressure pass-through) when exactly one member of a
room-data pair (reverberation_time/room_volume or
mean_absorption_coefficient/room_surface) is supplied, instead of
silently returning K2=0 as if free field. All-None remains the
legitimate free-field K2=0 path.
Document frequencies on the ReverberationSoundPowerResult row and
negative_band as a standalone per-band boolean field on the
SoundPowerIntensityResult row across docs/api-reference.md and the
EN/ES site twins.
Claude-Session: https://claude.ai/code/session_013kkVt3nxi9svp1an28uHxf
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.
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.
fix: SII disturbance per ANSI S3.5, IEC-exact intermodulation and the AES17 measurement chain (#173)
* fix: SII equivalent disturbance is the clause 5.6 maximum, not an energy sum
ANSI S3.5-1997 clause 5.6 defines the equivalent disturbance spectrum
level Di as the larger of the equivalent masking level Zi and the
equivalent internal noise level Xi'. The module summed the two in energy,
underestimating the SII by up to 0.042 in noise-plus-hearing-loss
conditions (0.1841 vs 0.2185 for normal speech in flat 30 dB noise with a
flat 40 dB loss). The official Hornsby worksheet computes the maximum in
every band and the R CRAN worked example confirms it.
Oracles: quiet-condition SII pinned at the worksheet full precision
(0.99582516666667, abs 1e-6), the disturbance intermediate locked at
5000 Hz (-23.6 dB), a discriminating noise-plus-loss case (0.2185) and
the independent R package Example C.2 (0.8513749). A code comment records
that the level-distortion factor referencing the normal-effort spectrum
for every vocal effort is the standard's own definition.
* test: STIPA direct-method modulation-depth staircase and NIPTS reading notes
The IEC 60268-16:2020 C.3.2 verification signal (Formula C.1, sinusoidal
carriers at the A.6.1 male levels) is synthesized end to end and the
published STI staircase for m = 0.0 to 1.0 (0, 0.18, 0.30, 0.38, 0.44,
0.50, 0.56, 0.62, 0.70, 0.82, 1) is asserted within the published
tolerance of 0.05 through the full stipa() audio path; the m = 0.5 point
also joins the conformance report.
ISO 1999 notes: the sub-10-year NIPTS spread keeps the raw lg(t) reading
(Formulae 6/7 carry no Formula-3 extrapolation provision) and the Annex D
half-integer rounding ambiguity of Table D.4 is recorded next to the
pinned cells.
* fix: IEC-exact intermodulation distortion (14.12.7, 14.12.8, 14.12.10)
modulation_distortion now returns the per-order IEC 60268-3 values: d_m,2
and d_m,3 are the arithmetic sums of the sideband amplitudes referenced to
the output voltage at f2 (14.12.7.2 g-h), bundled with the SMPTE-analyzer
combined RMS as an explicitly labelled convention in a new
ModulationDistortionResult.
difference_frequency_distortion references U_2,ref = 2 U_2,f2 (the sum of
both tone amplitudes) and sums the third-order products arithmetically per
14.12.8.1; the former half-difference search window could swallow the
primary tones (octave-spaced clean tones read d2 = 1.0) or the DC bin, so
product windows are now a few bins wide, capped by the component spacing,
clamped to (0, Nyquist) and forced to zero when they cannot be separated
from a primary tone or DC.
total_difference_frequency_distortion implements 14.12.10.1 directly: only
the two in-band products at f0 -/+ delta, rms-summed over the arithmetic
sum of the tone output voltages, with the standard 8 kHz / 11.95 kHz tones
as defaults.
The conformance entries carry the corrected per-clause labels and exact
values (d_m,2 = 0.16, d_m,3 = 0.08, d_d,2 = 0.03, d_d,3 = 0.04, d_TDFD =
sqrt(0.0013)). The 14.12.9.2 f) print of the DIM denominator (U2 vs the
14.12.9.1 f_s amplitude) is recorded in docs/ERRATA.md with a code comment
at the reference measurement.
* fix: AES17 measurement bandwidth, effective notch Q and the ITU-R 468 weighted THD
thd_plus_noise and sinad now measure both the residual and the total
signal through the AES17 chain (5.2.5 / 6.3.1): a 20 Hz high-pass plus
the standard low-pass at a configurable bandwidth (default 20 kHz),
realised as a brick-wall frequency-domain band per 5.2.10. Out-of-band
noise at high sample rates (+7 dB at fs = 192 kHz) and DC offsets no
longer inflate the result; bandwidth=None keeps the full-Nyquist
measurement.
The standard notch is designed so the APPLIED zero-phase response has the
requested quality factor (AES17 5.2.8 defines Q on the combined response;
filtfilt squares the magnitude, so the single-pass design is sharpened by
sqrt(1 + sqrt(2))). Previously a nominal Q of 2.0 acted as 1.29 and
requests below ~1.87 silently fell outside the AES17 [1.2, 3] range.
weighted_thd defaults to the network IEC 60268-3 14.12.11 actually
requires: the IEC 60268-1 Appendix A curve, i.e. ITU-R BS.468-4 Table 1
(peak +12.2 dB at 6.3 kHz), interpolated per the recommendation's own
log-frequency rule and exposed as itu_r_468_weighting; A and C remain as
labelled options and the 31.5 Hz - 400 Hz fundamental validity range is
documented. THD now raises when no harmonic fits below Nyquist instead of
returning 0, captures shorter than 64 samples are rejected, and the THD/
SINAD docstrings state the 14.12.3.2 R-convention and the derived nature
of SINAD explicitly.
New oracles: clipped-sine Fourier constants, the full-signal DIM
regression recipe (1.536 MHz synthesis, weak polynomial nonlinearity,
FIR decimation to 192 kHz, exact-bin FFT oracle), the H1 input-noise
bias SNR/(1+SNR), the printed ITU-R 468 table values including the AES17
CCIR-RMS cross-check, and the effective-notch-Q validation.
* test: ISO 532-1 Annex B.4 level-ramp oracles and reference-source provenance
The Annex B.4 ramp signals 6-9 join the validation suite: the tone ramps
(250 Hz / 1 kHz / 4 kHz, 30 dB to 80 dB at 5 dB/s over 10 s inside a
10.6 s file) are synthesized from parameters measured on the official
electronic-attachment WAVs and pinned to the workbook Nmax/N5 with
tolerances calibrated against those WAVs (module-on-official-WAV agrees
with the workbook to < 0.01 % on Nmax; the synthesis lands within +0.3 %
/ -0.8 %, pinned at 0.6 % / 2 %). The pink-noise ramp (overall SPL
25.85 + 5t dB per the WAV's Annex B.1 calibration) is pinned at a
realization-honest 10 %.
The sub-1-sone phon conversion (0.0005 offset, 3.0 phon floor, exact
10/lg 2 factor) and the NX percentile ((k-1, k) mean at
k = int((1 - X/100) n)) are now confirmed line by line against the
attachment's Annex A.4 reference program source; the provenance
docstrings record the exact code they match.
* docs: IEC-exact IMD semantics, AES17 bandwidth and ITU-R 468 weighting across guides and reference
The electroacoustics guide (EN and ES) and the API reference describe the
per-order modulation and difference-frequency definitions with their
references and arithmetic sums, the 14.12.10 two-product TDFD with the
standard 8 kHz / 11.95 kHz defaults, the AES17 measurement-bandwidth chain
with its bandwidth escape hatch, the effective notch Q, the ITU-R BS.468-4
default weighting for weighted THD with the 31.5-400 Hz validity range,
the DIM denominator erratum link and the corrected THD/SINAD convention
wording. CHANGELOG records the added API and the fixes; the conformance
report and the distortion figure variants are regenerated.
* docs: the ISO 12354-1:2017 edition repeats the K24 clamp misprint and flips the double-leaf K24 sign
The 2017 edition repeats the impossible '0 <= K24 <= -4 dB' interval of the
2000 print verbatim, and its E.3.5 prints the double-leaf K24 with a plus
where the 2000 edition's formula and its own corroborating Figure E.9 curve
carry a minus; both are recorded in the errata registry and the sign choice
is noted at the implementation.
* docs: the theory pages and SII diagram teach the max-form disturbance
The equivalent disturbance prose in the theory pages and the diagram label
follow the corrected ANSI S3.5 clause 5.6 reading (the larger of masking
and internal noise, not their energy sum), in English and Spanish; the
ISO 532-1 provenance docstrings paraphrase the reference program instead of
quoting it; and the notch-Q compensation note states the bilinear-warp
caveat near Nyquist.
* fix: regenerate the SII figure for the max-form disturbance and analysis follow-ups
The speech-intelligibility figure consumes the corrected clause 5.6
disturbance, so its four variants are regenerated; the 468 weighting's
zero-frequency guard avoids floating-point equality and the exception
tests keep one throwing call per block.
fix: SII disturbance per ANSI S3.5, IEC-exact intermodulation and the AES17 measurement chain (#173)
* fix: SII equivalent disturbance is the clause 5.6 maximum, not an energy sum
ANSI S3.5-1997 clause 5.6 defines the equivalent disturbance spectrum
level Di as the larger of the equivalent masking level Zi and the
equivalent internal noise level Xi'. The module summed the two in energy,
underestimating the SII by up to 0.042 in noise-plus-hearing-loss
conditions (0.1841 vs 0.2185 for normal speech in flat 30 dB noise with a
flat 40 dB loss). The official Hornsby worksheet computes the maximum in
every band and the R CRAN worked example confirms it.
Oracles: quiet-condition SII pinned at the worksheet full precision
(0.99582516666667, abs 1e-6), the disturbance intermediate locked at
5000 Hz (-23.6 dB), a discriminating noise-plus-loss case (0.2185) and
the independent R package Example C.2 (0.8513749). A code comment records
that the level-distortion factor referencing the normal-effort spectrum
for every vocal effort is the standard's own definition.
* test: STIPA direct-method modulation-depth staircase and NIPTS reading notes
The IEC 60268-16:2020 C.3.2 verification signal (Formula C.1, sinusoidal
carriers at the A.6.1 male levels) is synthesized end to end and the
published STI staircase for m = 0.0 to 1.0 (0, 0.18, 0.30, 0.38, 0.44,
0.50, 0.56, 0.62, 0.70, 0.82, 1) is asserted within the published
tolerance of 0.05 through the full stipa() audio path; the m = 0.5 point
also joins the conformance report.
ISO 1999 notes: the sub-10-year NIPTS spread keeps the raw lg(t) reading
(Formulae 6/7 carry no Formula-3 extrapolation provision) and the Annex D
half-integer rounding ambiguity of Table D.4 is recorded next to the
pinned cells.
* fix: IEC-exact intermodulation distortion (14.12.7, 14.12.8, 14.12.10)
modulation_distortion now returns the per-order IEC 60268-3 values: d_m,2
and d_m,3 are the arithmetic sums of the sideband amplitudes referenced to
the output voltage at f2 (14.12.7.2 g-h), bundled with the SMPTE-analyzer
combined RMS as an explicitly labelled convention in a new
ModulationDistortionResult.
difference_frequency_distortion references U_2,ref = 2 U_2,f2 (the sum of
both tone amplitudes) and sums the third-order products arithmetically per
14.12.8.1; the former half-difference search window could swallow the
primary tones (octave-spaced clean tones read d2 = 1.0) or the DC bin, so
product windows are now a few bins wide, capped by the component spacing,
clamped to (0, Nyquist) and forced to zero when they cannot be separated
from a primary tone or DC.
total_difference_frequency_distortion implements 14.12.10.1 directly: only
the two in-band products at f0 -/+ delta, rms-summed over the arithmetic
sum of the tone output voltages, with the standard 8 kHz / 11.95 kHz tones
as defaults.
The conformance entries carry the corrected per-clause labels and exact
values (d_m,2 = 0.16, d_m,3 = 0.08, d_d,2 = 0.03, d_d,3 = 0.04, d_TDFD =
sqrt(0.0013)). The 14.12.9.2 f) print of the DIM denominator (U2 vs the
14.12.9.1 f_s amplitude) is recorded in docs/ERRATA.md with a code comment
at the reference measurement.
* fix: AES17 measurement bandwidth, effective notch Q and the ITU-R 468 weighted THD
thd_plus_noise and sinad now measure both the residual and the total
signal through the AES17 chain (5.2.5 / 6.3.1): a 20 Hz high-pass plus
the standard low-pass at a configurable bandwidth (default 20 kHz),
realised as a brick-wall frequency-domain band per 5.2.10. Out-of-band
noise at high sample rates (+7 dB at fs = 192 kHz) and DC offsets no
longer inflate the result; bandwidth=None keeps the full-Nyquist
measurement.
The standard notch is designed so the APPLIED zero-phase response has the
requested quality factor (AES17 5.2.8 defines Q on the combined response;
filtfilt squares the magnitude, so the single-pass design is sharpened by
sqrt(1 + sqrt(2))). Previously a nominal Q of 2.0 acted as 1.29 and
requests below ~1.87 silently fell outside the AES17 [1.2, 3] range.
weighted_thd defaults to the network IEC 60268-3 14.12.11 actually
requires: the IEC 60268-1 Appendix A curve, i.e. ITU-R BS.468-4 Table 1
(peak +12.2 dB at 6.3 kHz), interpolated per the recommendation's own
log-frequency rule and exposed as itu_r_468_weighting; A and C remain as
labelled options and the 31.5 Hz - 400 Hz fundamental validity range is
documented. THD now raises when no harmonic fits below Nyquist instead of
returning 0, captures shorter than 64 samples are rejected, and the THD/
SINAD docstrings state the 14.12.3.2 R-convention and the derived nature
of SINAD explicitly.
New oracles: clipped-sine Fourier constants, the full-signal DIM
regression recipe (1.536 MHz synthesis, weak polynomial nonlinearity,
FIR decimation to 192 kHz, exact-bin FFT oracle), the H1 input-noise
bias SNR/(1+SNR), the printed ITU-R 468 table values including the AES17
CCIR-RMS cross-check, and the effective-notch-Q validation.
* test: ISO 532-1 Annex B.4 level-ramp oracles and reference-source provenance
The Annex B.4 ramp signals 6-9 join the validation suite: the tone ramps
(250 Hz / 1 kHz / 4 kHz, 30 dB to 80 dB at 5 dB/s over 10 s inside a
10.6 s file) are synthesized from parameters measured on the official
electronic-attachment WAVs and pinned to the workbook Nmax/N5 with
tolerances calibrated against those WAVs (module-on-official-WAV agrees
with the workbook to < 0.01 % on Nmax; the synthesis lands within +0.3 %
/ -0.8 %, pinned at 0.6 % / 2 %). The pink-noise ramp (overall SPL
25.85 + 5t dB per the WAV's Annex B.1 calibration) is pinned at a
realization-honest 10 %.
The sub-1-sone phon conversion (0.0005 offset, 3.0 phon floor, exact
10/lg 2 factor) and the NX percentile ((k-1, k) mean at
k = int((1 - X/100) n)) are now confirmed line by line against the
attachment's Annex A.4 reference program source; the provenance
docstrings record the exact code they match.
* docs: IEC-exact IMD semantics, AES17 bandwidth and ITU-R 468 weighting across guides and reference
The electroacoustics guide (EN and ES) and the API reference describe the
per-order modulation and difference-frequency definitions with their
references and arithmetic sums, the 14.12.10 two-product TDFD with the
standard 8 kHz / 11.95 kHz defaults, the AES17 measurement-bandwidth chain
with its bandwidth escape hatch, the effective notch Q, the ITU-R BS.468-4
default weighting for weighted THD with the 31.5-400 Hz validity range,
the DIM denominator erratum link and the corrected THD/SINAD convention
wording. CHANGELOG records the added API and the fixes; the conformance
report and the distortion figure variants are regenerated.
* docs: the ISO 12354-1:2017 edition repeats the K24 clamp misprint and flips the double-leaf K24 sign
The 2017 edition repeats the impossible '0 <= K24 <= -4 dB' interval of the
2000 print verbatim, and its E.3.5 prints the double-leaf K24 with a plus
where the 2000 edition's formula and its own corroborating Figure E.9 curve
carry a minus; both are recorded in the errata registry and the sign choice
is noted at the implementation.
* docs: the theory pages and SII diagram teach the max-form disturbance
The equivalent disturbance prose in the theory pages and the diagram label
follow the corrected ANSI S3.5 clause 5.6 reading (the larger of masking
and internal noise, not their energy sum), in English and Spanish; the
ISO 532-1 provenance docstrings paraphrase the reference program instead of
quoting it; and the notch-Q compensation note states the bilinear-warp
caveat near Nyquist.
* fix: regenerate the SII figure for the max-form disturbance and analysis follow-ups
The speech-intelligibility figure consumes the corrected clause 5.6
disturbance, so its four variants are regenerated; the 468 weighting's
zero-frequency guard avoids floating-point equality and the exception
tests keep one throwing call per block.
fix: SII disturbance per ANSI S3.5, IEC-exact intermodulation and the AES17 measurement chain (#173)
* fix: SII equivalent disturbance is the clause 5.6 maximum, not an energy sum
ANSI S3.5-1997 clause 5.6 defines the equivalent disturbance spectrum
level Di as the larger of the equivalent masking level Zi and the
equivalent internal noise level Xi'. The module summed the two in energy,
underestimating the SII by up to 0.042 in noise-plus-hearing-loss
conditions (0.1841 vs 0.2185 for normal speech in flat 30 dB noise with a
flat 40 dB loss). The official Hornsby worksheet computes the maximum in
every band and the R CRAN worked example confirms it.
Oracles: quiet-condition SII pinned at the worksheet full precision
(0.99582516666667, abs 1e-6), the disturbance intermediate locked at
5000 Hz (-23.6 dB), a discriminating noise-plus-loss case (0.2185) and
the independent R package Example C.2 (0.8513749). A code comment records
that the level-distortion factor referencing the normal-effort spectrum
for every vocal effort is the standard's own definition.
* test: STIPA direct-method modulation-depth staircase and NIPTS reading notes
The IEC 60268-16:2020 C.3.2 verification signal (Formula C.1, sinusoidal
carriers at the A.6.1 male levels) is synthesized end to end and the
published STI staircase for m = 0.0 to 1.0 (0, 0.18, 0.30, 0.38, 0.44,
0.50, 0.56, 0.62, 0.70, 0.82, 1) is asserted within the published
tolerance of 0.05 through the full stipa() audio path; the m = 0.5 point
also joins the conformance report.
ISO 1999 notes: the sub-10-year NIPTS spread keeps the raw lg(t) reading
(Formulae 6/7 carry no Formula-3 extrapolation provision) and the Annex D
half-integer rounding ambiguity of Table D.4 is recorded next to the
pinned cells.
* fix: IEC-exact intermodulation distortion (14.12.7, 14.12.8, 14.12.10)
modulation_distortion now returns the per-order IEC 60268-3 values: d_m,2
and d_m,3 are the arithmetic sums of the sideband amplitudes referenced to
the output voltage at f2 (14.12.7.2 g-h), bundled with the SMPTE-analyzer
combined RMS as an explicitly labelled convention in a new
ModulationDistortionResult.
difference_frequency_distortion references U_2,ref = 2 U_2,f2 (the sum of
both tone amplitudes) and sums the third-order products arithmetically per
14.12.8.1; the former half-difference search window could swallow the
primary tones (octave-spaced clean tones read d2 = 1.0) or the DC bin, so
product windows are now a few bins wide, capped by the component spacing,
clamped to (0, Nyquist) and forced to zero when they cannot be separated
from a primary tone or DC.
total_difference_frequency_distortion implements 14.12.10.1 directly: only
the two in-band products at f0 -/+ delta, rms-summed over the arithmetic
sum of the tone output voltages, with the standard 8 kHz / 11.95 kHz tones
as defaults.
The conformance entries carry the corrected per-clause labels and exact
values (d_m,2 = 0.16, d_m,3 = 0.08, d_d,2 = 0.03, d_d,3 = 0.04, d_TDFD =
sqrt(0.0013)). The 14.12.9.2 f) print of the DIM denominator (U2 vs the
14.12.9.1 f_s amplitude) is recorded in docs/ERRATA.md with a code comment
at the reference measurement.
* fix: AES17 measurement bandwidth, effective notch Q and the ITU-R 468 weighted THD
thd_plus_noise and sinad now measure both the residual and the total
signal through the AES17 chain (5.2.5 / 6.3.1): a 20 Hz high-pass plus
the standard low-pass at a configurable bandwidth (default 20 kHz),
realised as a brick-wall frequency-domain band per 5.2.10. Out-of-band
noise at high sample rates (+7 dB at fs = 192 kHz) and DC offsets no
longer inflate the result; bandwidth=None keeps the full-Nyquist
measurement.
The standard notch is designed so the APPLIED zero-phase response has the
requested quality factor (AES17 5.2.8 defines Q on the combined response;
filtfilt squares the magnitude, so the single-pass design is sharpened by
sqrt(1 + sqrt(2))). Previously a nominal Q of 2.0 acted as 1.29 and
requests below ~1.87 silently fell outside the AES17 [1.2, 3] range.
weighted_thd defaults to the network IEC 60268-3 14.12.11 actually
requires: the IEC 60268-1 Appendix A curve, i.e. ITU-R BS.468-4 Table 1
(peak +12.2 dB at 6.3 kHz), interpolated per the recommendation's own
log-frequency rule and exposed as itu_r_468_weighting; A and C remain as
labelled options and the 31.5 Hz - 400 Hz fundamental validity range is
documented. THD now raises when no harmonic fits below Nyquist instead of
returning 0, captures shorter than 64 samples are rejected, and the THD/
SINAD docstrings state the 14.12.3.2 R-convention and the derived nature
of SINAD explicitly.
New oracles: clipped-sine Fourier constants, the full-signal DIM
regression recipe (1.536 MHz synthesis, weak polynomial nonlinearity,
FIR decimation to 192 kHz, exact-bin FFT oracle), the H1 input-noise
bias SNR/(1+SNR), the printed ITU-R 468 table values including the AES17
CCIR-RMS cross-check, and the effective-notch-Q validation.
* test: ISO 532-1 Annex B.4 level-ramp oracles and reference-source provenance
The Annex B.4 ramp signals 6-9 join the validation suite: the tone ramps
(250 Hz / 1 kHz / 4 kHz, 30 dB to 80 dB at 5 dB/s over 10 s inside a
10.6 s file) are synthesized from parameters measured on the official
electronic-attachment WAVs and pinned to the workbook Nmax/N5 with
tolerances calibrated against those WAVs (module-on-official-WAV agrees
with the workbook to < 0.01 % on Nmax; the synthesis lands within +0.3 %
/ -0.8 %, pinned at 0.6 % / 2 %). The pink-noise ramp (overall SPL
25.85 + 5t dB per the WAV's Annex B.1 calibration) is pinned at a
realization-honest 10 %.
The sub-1-sone phon conversion (0.0005 offset, 3.0 phon floor, exact
10/lg 2 factor) and the NX percentile ((k-1, k) mean at
k = int((1 - X/100) n)) are now confirmed line by line against the
attachment's Annex A.4 reference program source; the provenance
docstrings record the exact code they match.
* docs: IEC-exact IMD semantics, AES17 bandwidth and ITU-R 468 weighting across guides and reference
The electroacoustics guide (EN and ES) and the API reference describe the
per-order modulation and difference-frequency definitions with their
references and arithmetic sums, the 14.12.10 two-product TDFD with the
standard 8 kHz / 11.95 kHz defaults, the AES17 measurement-bandwidth chain
with its bandwidth escape hatch, the effective notch Q, the ITU-R BS.468-4
default weighting for weighted THD with the 31.5-400 Hz validity range,
the DIM denominator erratum link and the corrected THD/SINAD convention
wording. CHANGELOG records the added API and the fixes; the conformance
report and the distortion figure variants are regenerated.
* docs: the ISO 12354-1:2017 edition repeats the K24 clamp misprint and flips the double-leaf K24 sign
The 2017 edition repeats the impossible '0 <= K24 <= -4 dB' interval of the
2000 print verbatim, and its E.3.5 prints the double-leaf K24 with a plus
where the 2000 edition's formula and its own corroborating Figure E.9 curve
carry a minus; both are recorded in the errata registry and the sign choice
is noted at the implementation.
* docs: the theory pages and SII diagram teach the max-form disturbance
The equivalent disturbance prose in the theory pages and the diagram label
follow the corrected ANSI S3.5 clause 5.6 reading (the larger of masking
and internal noise, not their energy sum), in English and Spanish; the
ISO 532-1 provenance docstrings paraphrase the reference program instead of
quoting it; and the notch-Q compensation note states the bilinear-warp
caveat near Nyquist.
* fix: regenerate the SII figure for the max-form disturbance and analysis follow-ups
The speech-intelligibility figure consumes the corrected clause 5.6
disturbance, so its four variants are regenerated; the 468 weighting's
zero-frequency guard avoids floating-point equality and the exception
tests keep one throwing call per block.
fix: SII disturbance per ANSI S3.5, IEC-exact intermodulation and the AES17 measurement chain (#173)
* fix: SII equivalent disturbance is the clause 5.6 maximum, not an energy sum
ANSI S3.5-1997 clause 5.6 defines the equivalent disturbance spectrum
level Di as the larger of the equivalent masking level Zi and the
equivalent internal noise level Xi'. The module summed the two in energy,
underestimating the SII by up to 0.042 in noise-plus-hearing-loss
conditions (0.1841 vs 0.2185 for normal speech in flat 30 dB noise with a
flat 40 dB loss). The official Hornsby worksheet computes the maximum in
every band and the R CRAN worked example confirms it.
Oracles: quiet-condition SII pinned at the worksheet full precision
(0.99582516666667, abs 1e-6), the disturbance intermediate locked at
5000 Hz (-23.6 dB), a discriminating noise-plus-loss case (0.2185) and
the independent R package Example C.2 (0.8513749). A code comment records
that the level-distortion factor referencing the normal-effort spectrum
for every vocal effort is the standard's own definition.
* test: STIPA direct-method modulation-depth staircase and NIPTS reading notes
The IEC 60268-16:2020 C.3.2 verification signal (Formula C.1, sinusoidal
carriers at the A.6.1 male levels) is synthesized end to end and the
published STI staircase for m = 0.0 to 1.0 (0, 0.18, 0.30, 0.38, 0.44,
0.50, 0.56, 0.62, 0.70, 0.82, 1) is asserted within the published
tolerance of 0.05 through the full stipa() audio path; the m = 0.5 point
also joins the conformance report.
ISO 1999 notes: the sub-10-year NIPTS spread keeps the raw lg(t) reading
(Formulae 6/7 carry no Formula-3 extrapolation provision) and the Annex D
half-integer rounding ambiguity of Table D.4 is recorded next to the
pinned cells.
* fix: IEC-exact intermodulation distortion (14.12.7, 14.12.8, 14.12.10)
modulation_distortion now returns the per-order IEC 60268-3 values: d_m,2
and d_m,3 are the arithmetic sums of the sideband amplitudes referenced to
the output voltage at f2 (14.12.7.2 g-h), bundled with the SMPTE-analyzer
combined RMS as an explicitly labelled convention in a new
ModulationDistortionResult.
difference_frequency_distortion references U_2,ref = 2 U_2,f2 (the sum of
both tone amplitudes) and sums the third-order products arithmetically per
14.12.8.1; the former half-difference search window could swallow the
primary tones (octave-spaced clean tones read d2 = 1.0) or the DC bin, so
product windows are now a few bins wide, capped by the component spacing,
clamped to (0, Nyquist) and forced to zero when they cannot be separated
from a primary tone or DC.
total_difference_frequency_distortion implements 14.12.10.1 directly: only
the two in-band products at f0 -/+ delta, rms-summed over the arithmetic
sum of the tone output voltages, with the standard 8 kHz / 11.95 kHz tones
as defaults.
The conformance entries carry the corrected per-clause labels and exact
values (d_m,2 = 0.16, d_m,3 = 0.08, d_d,2 = 0.03, d_d,3 = 0.04, d_TDFD =
sqrt(0.0013)). The 14.12.9.2 f) print of the DIM denominator (U2 vs the
14.12.9.1 f_s amplitude) is recorded in docs/ERRATA.md with a code comment
at the reference measurement.
* fix: AES17 measurement bandwidth, effective notch Q and the ITU-R 468 weighted THD
thd_plus_noise and sinad now measure both the residual and the total
signal through the AES17 chain (5.2.5 / 6.3.1): a 20 Hz high-pass plus
the standard low-pass at a configurable bandwidth (default 20 kHz),
realised as a brick-wall frequency-domain band per 5.2.10. Out-of-band
noise at high sample rates (+7 dB at fs = 192 kHz) and DC offsets no
longer inflate the result; bandwidth=None keeps the full-Nyquist
measurement.
The standard notch is designed so the APPLIED zero-phase response has the
requested quality factor (AES17 5.2.8 defines Q on the combined response;
filtfilt squares the magnitude, so the single-pass design is sharpened by
sqrt(1 + sqrt(2))). Previously a nominal Q of 2.0 acted as 1.29 and
requests below ~1.87 silently fell outside the AES17 [1.2, 3] range.
weighted_thd defaults to the network IEC 60268-3 14.12.11 actually
requires: the IEC 60268-1 Appendix A curve, i.e. ITU-R BS.468-4 Table 1
(peak +12.2 dB at 6.3 kHz), interpolated per the recommendation's own
log-frequency rule and exposed as itu_r_468_weighting; A and C remain as
labelled options and the 31.5 Hz - 400 Hz fundamental validity range is
documented. THD now raises when no harmonic fits below Nyquist instead of
returning 0, captures shorter than 64 samples are rejected, and the THD/
SINAD docstrings state the 14.12.3.2 R-convention and the derived nature
of SINAD explicitly.
New oracles: clipped-sine Fourier constants, the full-signal DIM
regression recipe (1.536 MHz synthesis, weak polynomial nonlinearity,
FIR decimation to 192 kHz, exact-bin FFT oracle), the H1 input-noise
bias SNR/(1+SNR), the printed ITU-R 468 table values including the AES17
CCIR-RMS cross-check, and the effective-notch-Q validation.
* test: ISO 532-1 Annex B.4 level-ramp oracles and reference-source provenance
The Annex B.4 ramp signals 6-9 join the validation suite: the tone ramps
(250 Hz / 1 kHz / 4 kHz, 30 dB to 80 dB at 5 dB/s over 10 s inside a
10.6 s file) are synthesized from parameters measured on the official
electronic-attachment WAVs and pinned to the workbook Nmax/N5 with
tolerances calibrated against those WAVs (module-on-official-WAV agrees
with the workbook to < 0.01 % on Nmax; the synthesis lands within +0.3 %
/ -0.8 %, pinned at 0.6 % / 2 %). The pink-noise ramp (overall SPL
25.85 + 5t dB per the WAV's Annex B.1 calibration) is pinned at a
realization-honest 10 %.
The sub-1-sone phon conversion (0.0005 offset, 3.0 phon floor, exact
10/lg 2 factor) and the NX percentile ((k-1, k) mean at
k = int((1 - X/100) n)) are now confirmed line by line against the
attachment's Annex A.4 reference program source; the provenance
docstrings record the exact code they match.
* docs: IEC-exact IMD semantics, AES17 bandwidth and ITU-R 468 weighting across guides and reference
The electroacoustics guide (EN and ES) and the API reference describe the
per-order modulation and difference-frequency definitions with their
references and arithmetic sums, the 14.12.10 two-product TDFD with the
standard 8 kHz / 11.95 kHz defaults, the AES17 measurement-bandwidth chain
with its bandwidth escape hatch, the effective notch Q, the ITU-R BS.468-4
default weighting for weighted THD with the 31.5-400 Hz validity range,
the DIM denominator erratum link and the corrected THD/SINAD convention
wording. CHANGELOG records the added API and the fixes; the conformance
report and the distortion figure variants are regenerated.
* docs: the ISO 12354-1:2017 edition repeats the K24 clamp misprint and flips the double-leaf K24 sign
The 2017 edition repeats the impossible '0 <= K24 <= -4 dB' interval of the
2000 print verbatim, and its E.3.5 prints the double-leaf K24 with a plus
where the 2000 edition's formula and its own corroborating Figure E.9 curve
carry a minus; both are recorded in the errata registry and the sign choice
is noted at the implementation.
* docs: the theory pages and SII diagram teach the max-form disturbance
The equivalent disturbance prose in the theory pages and the diagram label
follow the corrected ANSI S3.5 clause 5.6 reading (the larger of masking
and internal noise, not their energy sum), in English and Spanish; the
ISO 532-1 provenance docstrings paraphrase the reference program instead of
quoting it; and the notch-Q compensation note states the bilinear-warp
caveat near Nyquist.
* fix: regenerate the SII figure for the max-form disturbance and analysis follow-ups
The speech-intelligibility figure consumes the corrected clause 5.6
disturbance, so its four variants are regenerated; the 468 weighting's
zero-frequency guard avoids floating-point equality and the exception
tests keep one throwing call per block.
Psychoacoustics, speech intelligibility and sound intensity (ISO 532-1, DIN 45692, IEC 60268-16, IEC 61043) (#80)
* test: ISO 532-1 Annex B expected-value fixtures
Expected N (stationary, with the Annex tolerances) and Nmax/N5
(time-varying, 5% tolerance) for all 25 normative test signals,
extracted from the results workbooks of the freely downloadable
ISO 532-1:2017 electronic attachment, plus the Test signal 1
third-octave input levels.
Claude-Session: https://claude.ai/code/session_013kkVt3nxi9svp1an28uHxf
* feat: Zwicker loudness per ISO 532-1:2017 (stationary and time-varying)
Clean-room Python port of the normative Annex A.4 reference
implementation: all twelve numeric tables (A.1-A.9) verified
digit-exact against the C source in _zwicker_data.py, the Table A.1/A.2
third-octave filterbank, the level-dependent weighting, critical-band
and core-loudness stages, the exact f_nl nonlinear temporal-decay state
machine, temporal weighting and the 500 Hz loudness-vs-time trace with
Nmax/N5/N10. API: loudness_zwicker(x, fs, field=, stationary=) and
loudness_zwicker_from_spectrum(levels, field=) returning a frozen
ZwickerLoudness dataclass.
Conformance (Annex B, from the freely downloadable ISO electronic
attachment): Test signal 1 stationary spectrum matches the published N
to all printed digits (83.2957 sone); regenerated B.3 tones sit inside
the workbook tolerance intervals; the B.4 tone-pulse WAVs (included,
small) must keep >=99% of the N(t) trace inside the per-sample
normative tolerance band - the workbook header N5 values are not
reproducible from their own published traces and are documented as not
asserted. B.5 technical recordings run when ISO532_1_TESTDATA points
at the attachment.
Claude-Session: https://claude.ai/code/session_013kkVt3nxi9svp1an28uHxf
* feat: sharpness per DIN 45692:2009 (acum)
sharpness_din(x, fs, field=, method=) and
sharpness_din_from_specific(specific) implement Equation (1) - the
g(z)-weighted first moment of the ISO 532-1 specific-loudness pattern -
with the normalization constant k derived numerically from the clause 6
standard test signal (critical-band-wide 920-1080 Hz noise at 60 dB ->
exactly 1.00 acum; the derived k = 0.108 sits inside the normative
0.105 <= k < 0.115 window). The informative Annex B variants of Aures
and von Bismarck are selectable. Conformance tests: reference identity,
k range, and Table A.2 targets at four centre frequencies using
critical-band noises equalized to 4 sone (Tabelle A.1 band edges),
within the clause 6 tolerance of 5 % or 0.05 acum.
Claude-Session: https://claude.ai/code/session_013kkVt3nxi9svp1an28uHxf
* fix: annotate Aures weighting return for strict mypy
Claude-Session: https://claude.ai/code/session_013kkVt3nxi9svp1an28uHxf
* fix: robust short-signal handling and consistent peak pattern in Zwicker port
Findings surfaced by review bots on an accidental early diff: (1) inputs
shorter than one 500 Hz output sample crashed on an empty percentile
buffer - the minimum-length validation now requires a full output step;
(2) the returned specific pattern was picked with the un-decimated
argmax while Nmax/N5/N10 come from the decimated trace - both now use
the same decimated instant (regression tests added; note the pattern
integral only equals Nmax for steady signals, since N(t) is temporally
weighted).
Claude-Session: https://claude.ai/code/session_013kkVt3nxi9svp1an28uHxf
* feat: STI/STIPA (IEC 60268-16 Ed. 5) and p-p sound intensity (IEC 61043 + ISO 9614-1)
STI: sti_from_impulse_response (indirect method: IEC 61260 octave bank,
Schroeder MTF at the 14 modulation frequencies, optional SNR/masking/
reception-threshold corrections per Tables A.2/A.3, +-15 dB clip, male
alpha/beta weighting), stipa() direct method and an Ed. 5-conformant
stipa_signal() generator using the revised A.6.1 male spectrum. Ed. 4
PDF is the primary source; Ed. 5 deltas are source-attributed in the
constants (MathWorks Ed. 5 compliance doc, zawi01/stipa - numeric
values only, no GPL code). Verified: the six A.2.2 weighting pairs
exact to 0.001, eleven m<->STI pairs, masking control points,
exponential decays vs the Schroeder closed form at four T60 values,
STIPA loop-back 0.998 and monotonic SNR degradation.
Intensity: sound_intensity() cross-spectral p-p method
(I = -Im{G12}/(2pi f rho dr)) with octave/third-octave integration,
pressure-intensity index, direction, finite-difference bias correction
validated against IEC 61043 Table 3, plus ISO 9614-1 Annex A field
indicators (F2/F3/F4) and the dynamic-capability criterion (Ld = dpI0-K,
Table 1). Verified against exact plane-wave and standing-wave physics.
415 tests, mypy strict clean.
Claude-Session: https://claude.ai/code/session_013kkVt3nxi9svp1an28uHxf
* docs: new guide pages, refreshed landing and README for the expanded scope
Psychoacoustics & Speech Intelligibility and Sound Intensity guide pages
(EN, docs + site with sidebar entries), the ISO 1996-2 and ECMA-74
position diagrams finally embedded in the levels guide (EN/ES), and the
outdated landing page (EN/ES), README highlights/docs table and
changelog brought up to the real scope - the hero and cards now name
the thirteen standards under conformance test instead of the original
two.
Claude-Session: https://claude.ai/code/session_013kkVt3nxi9svp1an28uHxf
* docs: didactic pages, figures, diagrams and theory for psychoacoustics and intensity
Three new audited figures in four language/theme variants (specific
loudness pattern narrowband-vs-broadband, STI vs T60 with the Annex F
rating bands against the analytic Schroeder curve, and plane-vs-standing
wave intensity panels showing the pressure-intensity index), two new
setup diagrams (p-p probe with the spacer dimension, STI measurement
chain), Spanish twins of the two new guide pages, three theory sections
(Zwicker chain, MTF/STI math, intensity estimator with its bias) in
EN docs, EN site and ES site with GitHub-safe math, and API rows for
all thirteen new exports in the three reference tables.
Claude-Session: https://claude.ai/code/session_013kkVt3nxi9svp1an28uHxf
* test: track the ISO 532-1 Annex B.4 pulse WAVs (were gitignored)
The global *.wav ignore silently excluded the four normative tone-pulse
fixtures, so CI failed with FileNotFoundError on every OS while local
runs passed against the untracked files. Force-added with an explicit
gitignore exception.
Claude-Session: https://claude.ai/code/session_013kkVt3nxi9svp1an28uHxf
* fix: address PR 80 review round 1
- docs: use the real dynamic_capability_index signature and keep the
intensity example bands under the 12 mm spacer validity ceiling
- docs: calibration example wording (raw recording, not already-Pa)
- changelog: merge the duplicated Unreleased Added sections
- loudness: reject non-finite inputs and pathological resampling ratios
(gcd-1 rates like 44101 Hz) with clear errors, regression-tested
- tests: anchor the Aures/von Bismarck variants to the 1 acum reference
within 0.05 acum instead of a loose sanity bound
Claude-Session: https://claude.ai/code/session_013kkVt3nxi9svp1an28uHxf
Psychoacoustics, speech intelligibility and sound intensity (ISO 532-1, DIN 45692, IEC 60268-16, IEC 61043) (#80)
* test: ISO 532-1 Annex B expected-value fixtures
Expected N (stationary, with the Annex tolerances) and Nmax/N5
(time-varying, 5% tolerance) for all 25 normative test signals,
extracted from the results workbooks of the freely downloadable
ISO 532-1:2017 electronic attachment, plus the Test signal 1
third-octave input levels.
Claude-Session: https://claude.ai/code/session_013kkVt3nxi9svp1an28uHxf
* feat: Zwicker loudness per ISO 532-1:2017 (stationary and time-varying)
Clean-room Python port of the normative Annex A.4 reference
implementation: all twelve numeric tables (A.1-A.9) verified
digit-exact against the C source in _zwicker_data.py, the Table A.1/A.2
third-octave filterbank, the level-dependent weighting, critical-band
and core-loudness stages, the exact f_nl nonlinear temporal-decay state
machine, temporal weighting and the 500 Hz loudness-vs-time trace with
Nmax/N5/N10. API: loudness_zwicker(x, fs, field=, stationary=) and
loudness_zwicker_from_spectrum(levels, field=) returning a frozen
ZwickerLoudness dataclass.
Conformance (Annex B, from the freely downloadable ISO electronic
attachment): Test signal 1 stationary spectrum matches the published N
to all printed digits (83.2957 sone); regenerated B.3 tones sit inside
the workbook tolerance intervals; the B.4 tone-pulse WAVs (included,
small) must keep >=99% of the N(t) trace inside the per-sample
normative tolerance band - the workbook header N5 values are not
reproducible from their own published traces and are documented as not
asserted. B.5 technical recordings run when ISO532_1_TESTDATA points
at the attachment.
Claude-Session: https://claude.ai/code/session_013kkVt3nxi9svp1an28uHxf
* feat: sharpness per DIN 45692:2009 (acum)
sharpness_din(x, fs, field=, method=) and
sharpness_din_from_specific(specific) implement Equation (1) - the
g(z)-weighted first moment of the ISO 532-1 specific-loudness pattern -
with the normalization constant k derived numerically from the clause 6
standard test signal (critical-band-wide 920-1080 Hz noise at 60 dB ->
exactly 1.00 acum; the derived k = 0.108 sits inside the normative
0.105 <= k < 0.115 window). The informative Annex B variants of Aures
and von Bismarck are selectable. Conformance tests: reference identity,
k range, and Table A.2 targets at four centre frequencies using
critical-band noises equalized to 4 sone (Tabelle A.1 band edges),
within the clause 6 tolerance of 5 % or 0.05 acum.
Claude-Session: https://claude.ai/code/session_013kkVt3nxi9svp1an28uHxf
* fix: annotate Aures weighting return for strict mypy
Claude-Session: https://claude.ai/code/session_013kkVt3nxi9svp1an28uHxf
* fix: robust short-signal handling and consistent peak pattern in Zwicker port
Findings surfaced by review bots on an accidental early diff: (1) inputs
shorter than one 500 Hz output sample crashed on an empty percentile
buffer - the minimum-length validation now requires a full output step;
(2) the returned specific pattern was picked with the un-decimated
argmax while Nmax/N5/N10 come from the decimated trace - both now use
the same decimated instant (regression tests added; note the pattern
integral only equals Nmax for steady signals, since N(t) is temporally
weighted).
Claude-Session: https://claude.ai/code/session_013kkVt3nxi9svp1an28uHxf
* feat: STI/STIPA (IEC 60268-16 Ed. 5) and p-p sound intensity (IEC 61043 + ISO 9614-1)
STI: sti_from_impulse_response (indirect method: IEC 61260 octave bank,
Schroeder MTF at the 14 modulation frequencies, optional SNR/masking/
reception-threshold corrections per Tables A.2/A.3, +-15 dB clip, male
alpha/beta weighting), stipa() direct method and an Ed. 5-conformant
stipa_signal() generator using the revised A.6.1 male spectrum. Ed. 4
PDF is the primary source; Ed. 5 deltas are source-attributed in the
constants (MathWorks Ed. 5 compliance doc, zawi01/stipa - numeric
values only, no GPL code). Verified: the six A.2.2 weighting pairs
exact to 0.001, eleven m<->STI pairs, masking control points,
exponential decays vs the Schroeder closed form at four T60 values,
STIPA loop-back 0.998 and monotonic SNR degradation.
Intensity: sound_intensity() cross-spectral p-p method
(I = -Im{G12}/(2pi f rho dr)) with octave/third-octave integration,
pressure-intensity index, direction, finite-difference bias correction
validated against IEC 61043 Table 3, plus ISO 9614-1 Annex A field
indicators (F2/F3/F4) and the dynamic-capability criterion (Ld = dpI0-K,
Table 1). Verified against exact plane-wave and standing-wave physics.
415 tests, mypy strict clean.
Claude-Session: https://claude.ai/code/session_013kkVt3nxi9svp1an28uHxf
* docs: new guide pages, refreshed landing and README for the expanded scope
Psychoacoustics & Speech Intelligibility and Sound Intensity guide pages
(EN, docs + site with sidebar entries), the ISO 1996-2 and ECMA-74
position diagrams finally embedded in the levels guide (EN/ES), and the
outdated landing page (EN/ES), README highlights/docs table and
changelog brought up to the real scope - the hero and cards now name
the thirteen standards under conformance test instead of the original
two.
Claude-Session: https://claude.ai/code/session_013kkVt3nxi9svp1an28uHxf
* docs: didactic pages, figures, diagrams and theory for psychoacoustics and intensity
Three new audited figures in four language/theme variants (specific
loudness pattern narrowband-vs-broadband, STI vs T60 with the Annex F
rating bands against the analytic Schroeder curve, and plane-vs-standing
wave intensity panels showing the pressure-intensity index), two new
setup diagrams (p-p probe with the spacer dimension, STI measurement
chain), Spanish twins of the two new guide pages, three theory sections
(Zwicker chain, MTF/STI math, intensity estimator with its bias) in
EN docs, EN site and ES site with GitHub-safe math, and API rows for
all thirteen new exports in the three reference tables.
Claude-Session: https://claude.ai/code/session_013kkVt3nxi9svp1an28uHxf
* test: track the ISO 532-1 Annex B.4 pulse WAVs (were gitignored)
The global *.wav ignore silently excluded the four normative tone-pulse
fixtures, so CI failed with FileNotFoundError on every OS while local
runs passed against the untracked files. Force-added with an explicit
gitignore exception.
Claude-Session: https://claude.ai/code/session_013kkVt3nxi9svp1an28uHxf
* fix: address PR 80 review round 1
- docs: use the real dynamic_capability_index signature and keep the
intensity example bands under the 12 mm spacer validity ceiling
- docs: calibration example wording (raw recording, not already-Pa)
- changelog: merge the duplicated Unreleased Added sections
- loudness: reject non-finite inputs and pathological resampling ratios
(gcd-1 rates like 44101 Hz) with clear errors, regression-tested
- tests: anchor the Aures/von Bismarck variants to the 1 acum reference
within 0.05 acum instead of a loose sanity bound
Claude-Session: https://claude.ai/code/session_013kkVt3nxi9svp1an28uHxf
Psychoacoustics, speech intelligibility and sound intensity (ISO 532-1, DIN 45692, IEC 60268-16, IEC 61043) (#80)
* test: ISO 532-1 Annex B expected-value fixtures
Expected N (stationary, with the Annex tolerances) and Nmax/N5
(time-varying, 5% tolerance) for all 25 normative test signals,
extracted from the results workbooks of the freely downloadable
ISO 532-1:2017 electronic attachment, plus the Test signal 1
third-octave input levels.
Claude-Session: https://claude.ai/code/session_013kkVt3nxi9svp1an28uHxf
* feat: Zwicker loudness per ISO 532-1:2017 (stationary and time-varying)
Clean-room Python port of the normative Annex A.4 reference
implementation: all twelve numeric tables (A.1-A.9) verified
digit-exact against the C source in _zwicker_data.py, the Table A.1/A.2
third-octave filterbank, the level-dependent weighting, critical-band
and core-loudness stages, the exact f_nl nonlinear temporal-decay state
machine, temporal weighting and the 500 Hz loudness-vs-time trace with
Nmax/N5/N10. API: loudness_zwicker(x, fs, field=, stationary=) and
loudness_zwicker_from_spectrum(levels, field=) returning a frozen
ZwickerLoudness dataclass.
Conformance (Annex B, from the freely downloadable ISO electronic
attachment): Test signal 1 stationary spectrum matches the published N
to all printed digits (83.2957 sone); regenerated B.3 tones sit inside
the workbook tolerance intervals; the B.4 tone-pulse WAVs (included,
small) must keep >=99% of the N(t) trace inside the per-sample
normative tolerance band - the workbook header N5 values are not
reproducible from their own published traces and are documented as not
asserted. B.5 technical recordings run when ISO532_1_TESTDATA points
at the attachment.
Claude-Session: https://claude.ai/code/session_013kkVt3nxi9svp1an28uHxf
* feat: sharpness per DIN 45692:2009 (acum)
sharpness_din(x, fs, field=, method=) and
sharpness_din_from_specific(specific) implement Equation (1) - the
g(z)-weighted first moment of the ISO 532-1 specific-loudness pattern -
with the normalization constant k derived numerically from the clause 6
standard test signal (critical-band-wide 920-1080 Hz noise at 60 dB ->
exactly 1.00 acum; the derived k = 0.108 sits inside the normative
0.105 <= k < 0.115 window). The informative Annex B variants of Aures
and von Bismarck are selectable. Conformance tests: reference identity,
k range, and Table A.2 targets at four centre frequencies using
critical-band noises equalized to 4 sone (Tabelle A.1 band edges),
within the clause 6 tolerance of 5 % or 0.05 acum.
Claude-Session: https://claude.ai/code/session_013kkVt3nxi9svp1an28uHxf
* fix: annotate Aures weighting return for strict mypy
Claude-Session: https://claude.ai/code/session_013kkVt3nxi9svp1an28uHxf
* fix: robust short-signal handling and consistent peak pattern in Zwicker port
Findings surfaced by review bots on an accidental early diff: (1) inputs
shorter than one 500 Hz output sample crashed on an empty percentile
buffer - the minimum-length validation now requires a full output step;
(2) the returned specific pattern was picked with the un-decimated
argmax while Nmax/N5/N10 come from the decimated trace - both now use
the same decimated instant (regression tests added; note the pattern
integral only equals Nmax for steady signals, since N(t) is temporally
weighted).
Claude-Session: https://claude.ai/code/session_013kkVt3nxi9svp1an28uHxf
* feat: STI/STIPA (IEC 60268-16 Ed. 5) and p-p sound intensity (IEC 61043 + ISO 9614-1)
STI: sti_from_impulse_response (indirect method: IEC 61260 octave bank,
Schroeder MTF at the 14 modulation frequencies, optional SNR/masking/
reception-threshold corrections per Tables A.2/A.3, +-15 dB clip, male
alpha/beta weighting), stipa() direct method and an Ed. 5-conformant
stipa_signal() generator using the revised A.6.1 male spectrum. Ed. 4
PDF is the primary source; Ed. 5 deltas are source-attributed in the
constants (MathWorks Ed. 5 compliance doc, zawi01/stipa - numeric
values only, no GPL code). Verified: the six A.2.2 weighting pairs
exact to 0.001, eleven m<->STI pairs, masking control points,
exponential decays vs the Schroeder closed form at four T60 values,
STIPA loop-back 0.998 and monotonic SNR degradation.
Intensity: sound_intensity() cross-spectral p-p method
(I = -Im{G12}/(2pi f rho dr)) with octave/third-octave integration,
pressure-intensity index, direction, finite-difference bias correction
validated against IEC 61043 Table 3, plus ISO 9614-1 Annex A field
indicators (F2/F3/F4) and the dynamic-capability criterion (Ld = dpI0-K,
Table 1). Verified against exact plane-wave and standing-wave physics.
415 tests, mypy strict clean.
Claude-Session: https://claude.ai/code/session_013kkVt3nxi9svp1an28uHxf
* docs: new guide pages, refreshed landing and README for the expanded scope
Psychoacoustics & Speech Intelligibility and Sound Intensity guide pages
(EN, docs + site with sidebar entries), the ISO 1996-2 and ECMA-74
position diagrams finally embedded in the levels guide (EN/ES), and the
outdated landing page (EN/ES), README highlights/docs table and
changelog brought up to the real scope - the hero and cards now name
the thirteen standards under conformance test instead of the original
two.
Claude-Session: https://claude.ai/code/session_013kkVt3nxi9svp1an28uHxf
* docs: didactic pages, figures, diagrams and theory for psychoacoustics and intensity
Three new audited figures in four language/theme variants (specific
loudness pattern narrowband-vs-broadband, STI vs T60 with the Annex F
rating bands against the analytic Schroeder curve, and plane-vs-standing
wave intensity panels showing the pressure-intensity index), two new
setup diagrams (p-p probe with the spacer dimension, STI measurement
chain), Spanish twins of the two new guide pages, three theory sections
(Zwicker chain, MTF/STI math, intensity estimator with its bias) in
EN docs, EN site and ES site with GitHub-safe math, and API rows for
all thirteen new exports in the three reference tables.
Claude-Session: https://claude.ai/code/session_013kkVt3nxi9svp1an28uHxf
* test: track the ISO 532-1 Annex B.4 pulse WAVs (were gitignored)
The global *.wav ignore silently excluded the four normative tone-pulse
fixtures, so CI failed with FileNotFoundError on every OS while local
runs passed against the untracked files. Force-added with an explicit
gitignore exception.
Claude-Session: https://claude.ai/code/session_013kkVt3nxi9svp1an28uHxf
* fix: address PR 80 review round 1
- docs: use the real dynamic_capability_index signature and keep the
intensity example bands under the 12 mm spacer validity ceiling
- docs: calibration example wording (raw recording, not already-Pa)
- changelog: merge the duplicated Unreleased Added sections
- loudness: reject non-finite inputs and pathological resampling ratios
(gcd-1 rates like 44101 Hz) with clear errors, regression-tested
- tests: anchor the Aures/von Bismarck variants to the 1 acum reference
within 0.05 acum instead of a loose sanity bound
Claude-Session: https://claude.ai/code/session_013kkVt3nxi9svp1an28uHxf
Psychoacoustics, speech intelligibility and sound intensity (ISO 532-1, DIN 45692, IEC 60268-16, IEC 61043) (#80)
* test: ISO 532-1 Annex B expected-value fixtures
Expected N (stationary, with the Annex tolerances) and Nmax/N5
(time-varying, 5% tolerance) for all 25 normative test signals,
extracted from the results workbooks of the freely downloadable
ISO 532-1:2017 electronic attachment, plus the Test signal 1
third-octave input levels.
Claude-Session: https://claude.ai/code/session_013kkVt3nxi9svp1an28uHxf
* feat: Zwicker loudness per ISO 532-1:2017 (stationary and time-varying)
Clean-room Python port of the normative Annex A.4 reference
implementation: all twelve numeric tables (A.1-A.9) verified
digit-exact against the C source in _zwicker_data.py, the Table A.1/A.2
third-octave filterbank, the level-dependent weighting, critical-band
and core-loudness stages, the exact f_nl nonlinear temporal-decay state
machine, temporal weighting and the 500 Hz loudness-vs-time trace with
Nmax/N5/N10. API: loudness_zwicker(x, fs, field=, stationary=) and
loudness_zwicker_from_spectrum(levels, field=) returning a frozen
ZwickerLoudness dataclass.
Conformance (Annex B, from the freely downloadable ISO electronic
attachment): Test signal 1 stationary spectrum matches the published N
to all printed digits (83.2957 sone); regenerated B.3 tones sit inside
the workbook tolerance intervals; the B.4 tone-pulse WAVs (included,
small) must keep >=99% of the N(t) trace inside the per-sample
normative tolerance band - the workbook header N5 values are not
reproducible from their own published traces and are documented as not
asserted. B.5 technical recordings run when ISO532_1_TESTDATA points
at the attachment.
Claude-Session: https://claude.ai/code/session_013kkVt3nxi9svp1an28uHxf
* feat: sharpness per DIN 45692:2009 (acum)
sharpness_din(x, fs, field=, method=) and
sharpness_din_from_specific(specific) implement Equation (1) - the
g(z)-weighted first moment of the ISO 532-1 specific-loudness pattern -
with the normalization constant k derived numerically from the clause 6
standard test signal (critical-band-wide 920-1080 Hz noise at 60 dB ->
exactly 1.00 acum; the derived k = 0.108 sits inside the normative
0.105 <= k < 0.115 window). The informative Annex B variants of Aures
and von Bismarck are selectable. Conformance tests: reference identity,
k range, and Table A.2 targets at four centre frequencies using
critical-band noises equalized to 4 sone (Tabelle A.1 band edges),
within the clause 6 tolerance of 5 % or 0.05 acum.
Claude-Session: https://claude.ai/code/session_013kkVt3nxi9svp1an28uHxf
* fix: annotate Aures weighting return for strict mypy
Claude-Session: https://claude.ai/code/session_013kkVt3nxi9svp1an28uHxf
* fix: robust short-signal handling and consistent peak pattern in Zwicker port
Findings surfaced by review bots on an accidental early diff: (1) inputs
shorter than one 500 Hz output sample crashed on an empty percentile
buffer - the minimum-length validation now requires a full output step;
(2) the returned specific pattern was picked with the un-decimated
argmax while Nmax/N5/N10 come from the decimated trace - both now use
the same decimated instant (regression tests added; note the pattern
integral only equals Nmax for steady signals, since N(t) is temporally
weighted).
Claude-Session: https://claude.ai/code/session_013kkVt3nxi9svp1an28uHxf
* feat: STI/STIPA (IEC 60268-16 Ed. 5) and p-p sound intensity (IEC 61043 + ISO 9614-1)
STI: sti_from_impulse_response (indirect method: IEC 61260 octave bank,
Schroeder MTF at the 14 modulation frequencies, optional SNR/masking/
reception-threshold corrections per Tables A.2/A.3, +-15 dB clip, male
alpha/beta weighting), stipa() direct method and an Ed. 5-conformant
stipa_signal() generator using the revised A.6.1 male spectrum. Ed. 4
PDF is the primary source; Ed. 5 deltas are source-attributed in the
constants (MathWorks Ed. 5 compliance doc, zawi01/stipa - numeric
values only, no GPL code). Verified: the six A.2.2 weighting pairs
exact to 0.001, eleven m<->STI pairs, masking control points,
exponential decays vs the Schroeder closed form at four T60 values,
STIPA loop-back 0.998 and monotonic SNR degradation.
Intensity: sound_intensity() cross-spectral p-p method
(I = -Im{G12}/(2pi f rho dr)) with octave/third-octave integration,
pressure-intensity index, direction, finite-difference bias correction
validated against IEC 61043 Table 3, plus ISO 9614-1 Annex A field
indicators (F2/F3/F4) and the dynamic-capability criterion (Ld = dpI0-K,
Table 1). Verified against exact plane-wave and standing-wave physics.
415 tests, mypy strict clean.
Claude-Session: https://claude.ai/code/session_013kkVt3nxi9svp1an28uHxf
* docs: new guide pages, refreshed landing and README for the expanded scope
Psychoacoustics & Speech Intelligibility and Sound Intensity guide pages
(EN, docs + site with sidebar entries), the ISO 1996-2 and ECMA-74
position diagrams finally embedded in the levels guide (EN/ES), and the
outdated landing page (EN/ES), README highlights/docs table and
changelog brought up to the real scope - the hero and cards now name
the thirteen standards under conformance test instead of the original
two.
Claude-Session: https://claude.ai/code/session_013kkVt3nxi9svp1an28uHxf
* docs: didactic pages, figures, diagrams and theory for psychoacoustics and intensity
Three new audited figures in four language/theme variants (specific
loudness pattern narrowband-vs-broadband, STI vs T60 with the Annex F
rating bands against the analytic Schroeder curve, and plane-vs-standing
wave intensity panels showing the pressure-intensity index), two new
setup diagrams (p-p probe with the spacer dimension, STI measurement
chain), Spanish twins of the two new guide pages, three theory sections
(Zwicker chain, MTF/STI math, intensity estimator with its bias) in
EN docs, EN site and ES site with GitHub-safe math, and API rows for
all thirteen new exports in the three reference tables.
Claude-Session: https://claude.ai/code/session_013kkVt3nxi9svp1an28uHxf
* test: track the ISO 532-1 Annex B.4 pulse WAVs (were gitignored)
The global *.wav ignore silently excluded the four normative tone-pulse
fixtures, so CI failed with FileNotFoundError on every OS while local
runs passed against the untracked files. Force-added with an explicit
gitignore exception.
Claude-Session: https://claude.ai/code/session_013kkVt3nxi9svp1an28uHxf
* fix: address PR 80 review round 1
- docs: use the real dynamic_capability_index signature and keep the
intensity example bands under the 12 mm spacer validity ceiling
- docs: calibration example wording (raw recording, not already-Pa)
- changelog: merge the duplicated Unreleased Added sections
- loudness: reject non-finite inputs and pathological resampling ratios
(gcd-1 rates like 44101 Hz) with clear errors, regression-tested
- tests: anchor the Aures/von Bismarck variants to the 1 acum reference
within 0.05 acum instead of a loose sanity bound
Claude-Session: https://claude.ai/code/session_013kkVt3nxi9svp1an28uHxf
Audit pass 11a: seven new documentation diagrams (#121)
* Audit pass 11a: seven new documentation diagrams
Add SVG flow diagrams for the seven topics the audit flagged as having no
schematic: the exponential-detector chain of the time weightings
(IEC 61672-1), stateful vs reset block processing, the multichannel
array-shape flow, the open-plan spatial-decay line (ISO 3382-3), the
ISO 12999-1 uncertainty pipeline, the ISO 11654 absorption-rating flow and
the Zwicker loudness-model chain (ISO 532-1).
Each is generated deterministically by generate_diagrams.py in the four
EN/ES x light/dark variants, with every Spanish label added to the _ES
table (decimals localised to commas), and embedded in the repo docs and
both site trees beside the existing worked-example plots.
* Fix ISO 532-1 table citations in the Zwicker diagram
Review of the diagram against loudness_zwicker.py found two mislabelled
tables: the equal-loudness correction and lower-critical-band grouping is
Table A.3 (not A.4), and the threshold in quiet LTQ is Table A.6 (not A.3).
Reassign the a0/DDF/LTQ corrections to the core-loudness step (Tables
A.4-A.7) where they belong, update the Spanish labels, and align the ES
psychoacoustics alt text with the guide's own term "sonos" (was "sonios").
Audit pass 11a: seven new documentation diagrams (#121)
* Audit pass 11a: seven new documentation diagrams
Add SVG flow diagrams for the seven topics the audit flagged as having no
schematic: the exponential-detector chain of the time weightings
(IEC 61672-1), stateful vs reset block processing, the multichannel
array-shape flow, the open-plan spatial-decay line (ISO 3382-3), the
ISO 12999-1 uncertainty pipeline, the ISO 11654 absorption-rating flow and
the Zwicker loudness-model chain (ISO 532-1).
Each is generated deterministically by generate_diagrams.py in the four
EN/ES x light/dark variants, with every Spanish label added to the _ES
table (decimals localised to commas), and embedded in the repo docs and
both site trees beside the existing worked-example plots.
* Fix ISO 532-1 table citations in the Zwicker diagram
Review of the diagram against loudness_zwicker.py found two mislabelled
tables: the equal-loudness correction and lower-critical-band grouping is
Table A.3 (not A.4), and the threshold in quiet LTQ is Table A.6 (not A.3).
Reassign the a0/DDF/LTQ corrections to the core-loudness step (Tables
A.4-A.7) where they belong, update the Spanish labels, and align the ES
psychoacoustics alt text with the guide's own term "sonos" (was "sonios").
Audit pass 11a: seven new documentation diagrams (#121)
* Audit pass 11a: seven new documentation diagrams
Add SVG flow diagrams for the seven topics the audit flagged as having no
schematic: the exponential-detector chain of the time weightings
(IEC 61672-1), stateful vs reset block processing, the multichannel
array-shape flow, the open-plan spatial-decay line (ISO 3382-3), the
ISO 12999-1 uncertainty pipeline, the ISO 11654 absorption-rating flow and
the Zwicker loudness-model chain (ISO 532-1).
Each is generated deterministically by generate_diagrams.py in the four
EN/ES x light/dark variants, with every Spanish label added to the _ES
table (decimals localised to commas), and embedded in the repo docs and
both site trees beside the existing worked-example plots.
* Fix ISO 532-1 table citations in the Zwicker diagram
Review of the diagram against loudness_zwicker.py found two mislabelled
tables: the equal-loudness correction and lower-critical-band grouping is
Table A.3 (not A.4), and the threshold in quiet LTQ is Table A.6 (not A.3).
Reassign the a0/DDF/LTQ corrections to the core-loudness step (Tables
A.4-A.7) where they belong, update the Spanish labels, and align the ES
psychoacoustics alt text with the guide's own term "sonos" (was "sonios").
Audit pass 11a: seven new documentation diagrams (#121)
* Audit pass 11a: seven new documentation diagrams
Add SVG flow diagrams for the seven topics the audit flagged as having no
schematic: the exponential-detector chain of the time weightings
(IEC 61672-1), stateful vs reset block processing, the multichannel
array-shape flow, the open-plan spatial-decay line (ISO 3382-3), the
ISO 12999-1 uncertainty pipeline, the ISO 11654 absorption-rating flow and
the Zwicker loudness-model chain (ISO 532-1).
Each is generated deterministically by generate_diagrams.py in the four
EN/ES x light/dark variants, with every Spanish label added to the _ES
table (decimals localised to commas), and embedded in the repo docs and
both site trees beside the existing worked-example plots.
* Fix ISO 532-1 table citations in the Zwicker diagram
Review of the diagram against loudness_zwicker.py found two mislabelled
tables: the equal-loudness correction and lower-critical-band grouping is
Table A.3 (not A.4), and the threshold in quiet LTQ is Table A.6 (not A.3).
Reassign the a0/DDF/LTQ corrections to the core-loudness step (Tables
A.4-A.7) where they belong, update the Spanish labels, and align the ES
psychoacoustics alt text with the guide's own term "sonos" (was "sonios").
Didactic documentation: theory everywhere, bilingual figures, setup diagrams, parameter tables (#77)
* docs: harden diagram engine per visual audit
- dim() draws real witness lines from the measured points to the offset
dimension line (the offset=0 path emitted zero-length lines); vertical
labels sit left of the line, clear of masts and figures
- env diagram: the 4 m dimension now measures the mic axis itself and
the flush-mounted label moved to the clear zone between masts
- tonality top view: the 1.00 m dimension connects face and microphone
Claude-Session: https://claude.ai/code/session_013kkVt3nxi9svp1an28uHxf
* docs: bilingual diagram variants (EN/ES x light/dark)
Every setup diagram is now emitted in four variants; Spanish strings
(including decimal commas) come from a translation table applied by the
SVG engine, and layouts were adjusted where the longer Spanish labels
collided (env titles, processing-chain box width, calibration output
label, tonality dimension label side).
Claude-Session: https://claude.ai/code/session_013kkVt3nxi9svp1an28uHxf
* docs: bilingual figure variants for the ES site (EN/ES x light/dark)
generate_graphs.py now emits every figure in four variants: a Spanish
translation table (~75 exact strings + parametrized patterns) is applied
to the figure's Text artists at savefig time, so the generator functions
stay single-language internally. Spanish output uses UNE terminology
(ponderación temporal, líneas isofónicas, fonios, ráfaga) and a uniform
decimal comma (annotations and tick labels included); code identifiers
and normative mode names (Fast/Slow/Impulse) stay untranslated. The ES
site pages now reference the _es/_es_dark variants (56 URLs). The ES set
passed a 10-figure visual audit (10/10 approved, no blockers).
Claude-Session: https://claude.ai/code/session_013kkVt3nxi9svp1an28uHxf
* docs: didactic calibration page - theory, setup diagram, stability figure, parameter table
Adds the sensitivity-factor derivation with the calibration-chain SVG,
a new autogenerated calibration_stability figure (stable vs 3% AM tone
against the IEC 60942:2017 class 1 deviation band; 4 language/theme
variants; the ES decimal-comma pass now preserves clause numbers like
5.3.3), and a full parameter table for calculate_sensitivity - EN and
ES in parity.
Claude-Session: https://claude.ai/code/session_013kkVt3nxi9svp1an28uHxf
* docs: SEL concept, Lden 24h profile and annotated TNR spectrum figures
Three new didactic figures for the levels guide, each in four
language/theme variants: sel_concept (pass-by event vs its Leq and the
equal-energy 1 s SEL block, dBFS mode), lden_profile (synthetic urban
24 h LAeq with colored day/evening/night bands and the +5/+10 weighted
period levels clearly separated from the composite Lden), and
tonality_spectrum (averaged Hann spectrum with the critical band, the
detected tone and the live TNR value vs its criterion, computed by the
library itself).
Claude-Session: https://claude.ai/code/session_013kkVt3nxi9svp1an28uHxf
* docs: didactic levels guide, theory extensions and refreshed why-phonometry
- levels guide (EN docs+site): energy-mean rationale for Leq, percentile
semantics for LN, SEL and noise-dose theory with the new figures
embedded, TNR critical-band explanation with the annotated spectrum,
Lden profile figure, and parameter tables (type/units/range/default)
for every level function including the spectrogram
- theory page: five new sections (G-weighting pole/zero derivation,
ISO 226 formulae, ECMA-418-1 TNR/PR math, event/dose metrics,
ISO 1996-1 descriptors) with cross-references to the guides
- why-phonometry: rewritten around the conformance-testing story with
the per-standard verification table and honest ecosystem positioning
Claude-Session: https://claude.ai/code/session_013kkVt3nxi9svp1an28uHxf
* docs: weighting/time-weighting theory and parameter tables; fix math-block delimiters
The physiological origin of A/C (inverted 40/100-phon contours, the four
IEC corner frequencies) and the exponential-detector derivation with the
tau semantics, each with full parameter tables. Display math inserted by
the docs expansion now always uses block-style $$ delimiters on their
own lines - mid-line multi-line $$ blocks silently derailed remark
parsing and truncated every heading after them (caught because the
built pages lost their anchor ids); also replaced a raw < in a table.
Claude-Session: https://claude.ai/code/session_013kkVt3nxi9svp1an28uHxf
* docs: processing-chain and multirate diagrams, filter-bank math, streaming patterns
- getting-started embeds the processing-chain diagram as a guided map of
the guides
- filter-banks gains the IEC 61260-1 base-10 band math (G, fm, band
edges), a new multirate-decimation diagram (d5, four language/theme
variants) and the full octavefilter/OctaveFilterBank parameter table
- block-processing gains the canonical real-time level-meter loop
(validated against the actual API - TimeWeighting is inherently
stateful) and a stateful-constraints table
- multichannel gains the accepted-shapes table
Claude-Session: https://claude.ai/code/session_013kkVt3nxi9svp1an28uHxf
* docs: Spanish parity for the didactic expansion
Every enriched page now has its Spanish twin: levels (theory, three new
figures via _es variants, six parameter tables), weighting and
time-weighting (curve-origin and exponential-detector sections),
filter-banks (fractional-band math, multirate diagram, full parameter
table - terminology unified on 'decimación'), getting-started
(processing-chain map), block-processing (real-time meter pattern and
stateful constraints), multichannel (shapes table), theory (five new
sections) and a full rewrite of why-phonometry around the conformance
story. API reference now covers all 27 public exports in EN and ES
(added ToneAssessment and CalibrationWarning rows). UNE terminology and
Spanish decimal commas throughout; site builds with all links valid.
Claude-Session: https://claude.ai/code/session_013kkVt3nxi9svp1an28uHxf
* docs: audited fixes - Spanish tick commas and multirate note
Final visual-audit round: the d5 diagram now shows the no-decimation
note on the 16 kHz row in both languages, and Spanish figures render
every numeric tick with a decimal comma (FixedFormatter sequences are
rewritten in place; set_xticklabels-style FuncFormatters and plain
linear ScalarFormatters are wrapped - the first naive wrapper broke
ScalarFormatter ticks entirely and was caught visually).
Claude-Session: https://claude.ai/code/session_013kkVt3nxi9svp1an28uHxf
* docs(site): language selector in the mobile header, scrollable display math
Custom Header component (default markup plus a compact icon-only
LanguageSelect visible below the md breakpoint, where Starlight hides
the whole right group behind the hamburger menu) and overflow-x on
katex-display so wide formulas scroll inside their box on phones.
Verified with Playwright at 390 px in EN and ES.
Claude-Session: https://claude.ai/code/session_013kkVt3nxi9svp1an28uHxf
* fix: address review feedback on the didactic docs
- levels tables: spectrogram calibration_factor/dbfs marked constructor-
only, overlap range as 0 <= overlap < 1, composite hours constraints,
ln_levels shared-semantics row filled; ES translation leftovers and
the 'delante' typo fixed
- block-processing: y[..., -1] so the meter loop is multichannel-safe;
high_accuracy wording matches the real behavior (default resolves to
False, explicit True raises)
- API: CalibrationWarning row states the fs/validate preconditions (3 files)
- weighting: high_accuracy default column and oversampling claim made
precise (8x cap; silently ignored for G); ES row in parity
- filter-banks: 25 Hz relative bandwidth corrected to 0.024% of Nyquist
(EN/ES); verify_filter_class classes documented as 1/2/None
- generate_graphs: dropped the global plt.savefig monkey-patch - the
translation now runs inside themed_path(), which every generator
already calls at save time (verified output identical)
Claude-Session: https://claude.ai/code/session_013kkVt3nxi9svp1an28uHxf
Didactic documentation: theory everywhere, bilingual figures, setup diagrams, parameter tables (#77)
* docs: harden diagram engine per visual audit
- dim() draws real witness lines from the measured points to the offset
dimension line (the offset=0 path emitted zero-length lines); vertical
labels sit left of the line, clear of masts and figures
- env diagram: the 4 m dimension now measures the mic axis itself and
the flush-mounted label moved to the clear zone between masts
- tonality top view: the 1.00 m dimension connects face and microphone
Claude-Session: https://claude.ai/code/session_013kkVt3nxi9svp1an28uHxf
* docs: bilingual diagram variants (EN/ES x light/dark)
Every setup diagram is now emitted in four variants; Spanish strings
(including decimal commas) come from a translation table applied by the
SVG engine, and layouts were adjusted where the longer Spanish labels
collided (env titles, processing-chain box width, calibration output
label, tonality dimension label side).
Claude-Session: https://claude.ai/code/session_013kkVt3nxi9svp1an28uHxf
* docs: bilingual figure variants for the ES site (EN/ES x light/dark)
generate_graphs.py now emits every figure in four variants: a Spanish
translation table (~75 exact strings + parametrized patterns) is applied
to the figure's Text artists at savefig time, so the generator functions
stay single-language internally. Spanish output uses UNE terminology
(ponderación temporal, líneas isofónicas, fonios, ráfaga) and a uniform
decimal comma (annotations and tick labels included); code identifiers
and normative mode names (Fast/Slow/Impulse) stay untranslated. The ES
site pages now reference the _es/_es_dark variants (56 URLs). The ES set
passed a 10-figure visual audit (10/10 approved, no blockers).
Claude-Session: https://claude.ai/code/session_013kkVt3nxi9svp1an28uHxf
* docs: didactic calibration page - theory, setup diagram, stability figure, parameter table
Adds the sensitivity-factor derivation with the calibration-chain SVG,
a new autogenerated calibration_stability figure (stable vs 3% AM tone
against the IEC 60942:2017 class 1 deviation band; 4 language/theme
variants; the ES decimal-comma pass now preserves clause numbers like
5.3.3), and a full parameter table for calculate_sensitivity - EN and
ES in parity.
Claude-Session: https://claude.ai/code/session_013kkVt3nxi9svp1an28uHxf
* docs: SEL concept, Lden 24h profile and annotated TNR spectrum figures
Three new didactic figures for the levels guide, each in four
language/theme variants: sel_concept (pass-by event vs its Leq and the
equal-energy 1 s SEL block, dBFS mode), lden_profile (synthetic urban
24 h LAeq with colored day/evening/night bands and the +5/+10 weighted
period levels clearly separated from the composite Lden), and
tonality_spectrum (averaged Hann spectrum with the critical band, the
detected tone and the live TNR value vs its criterion, computed by the
library itself).
Claude-Session: https://claude.ai/code/session_013kkVt3nxi9svp1an28uHxf
* docs: didactic levels guide, theory extensions and refreshed why-phonometry
- levels guide (EN docs+site): energy-mean rationale for Leq, percentile
semantics for LN, SEL and noise-dose theory with the new figures
embedded, TNR critical-band explanation with the annotated spectrum,
Lden profile figure, and parameter tables (type/units/range/default)
for every level function including the spectrogram
- theory page: five new sections (G-weighting pole/zero derivation,
ISO 226 formulae, ECMA-418-1 TNR/PR math, event/dose metrics,
ISO 1996-1 descriptors) with cross-references to the guides
- why-phonometry: rewritten around the conformance-testing story with
the per-standard verification table and honest ecosystem positioning
Claude-Session: https://claude.ai/code/session_013kkVt3nxi9svp1an28uHxf
* docs: weighting/time-weighting theory and parameter tables; fix math-block delimiters
The physiological origin of A/C (inverted 40/100-phon contours, the four
IEC corner frequencies) and the exponential-detector derivation with the
tau semantics, each with full parameter tables. Display math inserted by
the docs expansion now always uses block-style $$ delimiters on their
own lines - mid-line multi-line $$ blocks silently derailed remark
parsing and truncated every heading after them (caught because the
built pages lost their anchor ids); also replaced a raw < in a table.
Claude-Session: https://claude.ai/code/session_013kkVt3nxi9svp1an28uHxf
* docs: processing-chain and multirate diagrams, filter-bank math, streaming patterns
- getting-started embeds the processing-chain diagram as a guided map of
the guides
- filter-banks gains the IEC 61260-1 base-10 band math (G, fm, band
edges), a new multirate-decimation diagram (d5, four language/theme
variants) and the full octavefilter/OctaveFilterBank parameter table
- block-processing gains the canonical real-time level-meter loop
(validated against the actual API - TimeWeighting is inherently
stateful) and a stateful-constraints table
- multichannel gains the accepted-shapes table
Claude-Session: https://claude.ai/code/session_013kkVt3nxi9svp1an28uHxf
* docs: Spanish parity for the didactic expansion
Every enriched page now has its Spanish twin: levels (theory, three new
figures via _es variants, six parameter tables), weighting and
time-weighting (curve-origin and exponential-detector sections),
filter-banks (fractional-band math, multirate diagram, full parameter
table - terminology unified on 'decimación'), getting-started
(processing-chain map), block-processing (real-time meter pattern and
stateful constraints), multichannel (shapes table), theory (five new
sections) and a full rewrite of why-phonometry around the conformance
story. API reference now covers all 27 public exports in EN and ES
(added ToneAssessment and CalibrationWarning rows). UNE terminology and
Spanish decimal commas throughout; site builds with all links valid.
Claude-Session: https://claude.ai/code/session_013kkVt3nxi9svp1an28uHxf
* docs: audited fixes - Spanish tick commas and multirate note
Final visual-audit round: the d5 diagram now shows the no-decimation
note on the 16 kHz row in both languages, and Spanish figures render
every numeric tick with a decimal comma (FixedFormatter sequences are
rewritten in place; set_xticklabels-style FuncFormatters and plain
linear ScalarFormatters are wrapped - the first naive wrapper broke
ScalarFormatter ticks entirely and was caught visually).
Claude-Session: https://claude.ai/code/session_013kkVt3nxi9svp1an28uHxf
* docs(site): language selector in the mobile header, scrollable display math
Custom Header component (default markup plus a compact icon-only
LanguageSelect visible below the md breakpoint, where Starlight hides
the whole right group behind the hamburger menu) and overflow-x on
katex-display so wide formulas scroll inside their box on phones.
Verified with Playwright at 390 px in EN and ES.
Claude-Session: https://claude.ai/code/session_013kkVt3nxi9svp1an28uHxf
* fix: address review feedback on the didactic docs
- levels tables: spectrogram calibration_factor/dbfs marked constructor-
only, overlap range as 0 <= overlap < 1, composite hours constraints,
ln_levels shared-semantics row filled; ES translation leftovers and
the 'delante' typo fixed
- block-processing: y[..., -1] so the meter loop is multichannel-safe;
high_accuracy wording matches the real behavior (default resolves to
False, explicit True raises)
- API: CalibrationWarning row states the fs/validate preconditions (3 files)
- weighting: high_accuracy default column and oversampling claim made
precise (8x cap; silently ignored for G); ES row in parity
- filter-banks: 25 Hz relative bandwidth corrected to 0.024% of Nyquist
(EN/ES); verify_filter_class classes documented as 1/2/None
- generate_graphs: dropped the global plt.savefig monkey-patch - the
translation now runs inside themed_path(), which every generator
already calls at save time (verified output identical)
Claude-Session: https://claude.ai/code/session_013kkVt3nxi9svp1an28uHxf
Didactic documentation: theory everywhere, bilingual figures, setup diagrams, parameter tables (#77)
* docs: harden diagram engine per visual audit
- dim() draws real witness lines from the measured points to the offset
dimension line (the offset=0 path emitted zero-length lines); vertical
labels sit left of the line, clear of masts and figures
- env diagram: the 4 m dimension now measures the mic axis itself and
the flush-mounted label moved to the clear zone between masts
- tonality top view: the 1.00 m dimension connects face and microphone
Claude-Session: https://claude.ai/code/session_013kkVt3nxi9svp1an28uHxf
* docs: bilingual diagram variants (EN/ES x light/dark)
Every setup diagram is now emitted in four variants; Spanish strings
(including decimal commas) come from a translation table applied by the
SVG engine, and layouts were adjusted where the longer Spanish labels
collided (env titles, processing-chain box width, calibration output
label, tonality dimension label side).
Claude-Session: https://claude.ai/code/session_013kkVt3nxi9svp1an28uHxf
* docs: bilingual figure variants for the ES site (EN/ES x light/dark)
generate_graphs.py now emits every figure in four variants: a Spanish
translation table (~75 exact strings + parametrized patterns) is applied
to the figure's Text artists at savefig time, so the generator functions
stay single-language internally. Spanish output uses UNE terminology
(ponderación temporal, líneas isofónicas, fonios, ráfaga) and a uniform
decimal comma (annotations and tick labels included); code identifiers
and normative mode names (Fast/Slow/Impulse) stay untranslated. The ES
site pages now reference the _es/_es_dark variants (56 URLs). The ES set
passed a 10-figure visual audit (10/10 approved, no blockers).
Claude-Session: https://claude.ai/code/session_013kkVt3nxi9svp1an28uHxf
* docs: didactic calibration page - theory, setup diagram, stability figure, parameter table
Adds the sensitivity-factor derivation with the calibration-chain SVG,
a new autogenerated calibration_stability figure (stable vs 3% AM tone
against the IEC 60942:2017 class 1 deviation band; 4 language/theme
variants; the ES decimal-comma pass now preserves clause numbers like
5.3.3), and a full parameter table for calculate_sensitivity - EN and
ES in parity.
Claude-Session: https://claude.ai/code/session_013kkVt3nxi9svp1an28uHxf
* docs: SEL concept, Lden 24h profile and annotated TNR spectrum figures
Three new didactic figures for the levels guide, each in four
language/theme variants: sel_concept (pass-by event vs its Leq and the
equal-energy 1 s SEL block, dBFS mode), lden_profile (synthetic urban
24 h LAeq with colored day/evening/night bands and the +5/+10 weighted
period levels clearly separated from the composite Lden), and
tonality_spectrum (averaged Hann spectrum with the critical band, the
detected tone and the live TNR value vs its criterion, computed by the
library itself).
Claude-Session: https://claude.ai/code/session_013kkVt3nxi9svp1an28uHxf
* docs: didactic levels guide, theory extensions and refreshed why-phonometry
- levels guide (EN docs+site): energy-mean rationale for Leq, percentile
semantics for LN, SEL and noise-dose theory with the new figures
embedded, TNR critical-band explanation with the annotated spectrum,
Lden profile figure, and parameter tables (type/units/range/default)
for every level function including the spectrogram
- theory page: five new sections (G-weighting pole/zero derivation,
ISO 226 formulae, ECMA-418-1 TNR/PR math, event/dose metrics,
ISO 1996-1 descriptors) with cross-references to the guides
- why-phonometry: rewritten around the conformance-testing story with
the per-standard verification table and honest ecosystem positioning
Claude-Session: https://claude.ai/code/session_013kkVt3nxi9svp1an28uHxf
* docs: weighting/time-weighting theory and parameter tables; fix math-block delimiters
The physiological origin of A/C (inverted 40/100-phon contours, the four
IEC corner frequencies) and the exponential-detector derivation with the
tau semantics, each with full parameter tables. Display math inserted by
the docs expansion now always uses block-style $$ delimiters on their
own lines - mid-line multi-line $$ blocks silently derailed remark
parsing and truncated every heading after them (caught because the
built pages lost their anchor ids); also replaced a raw < in a table.
Claude-Session: https://claude.ai/code/session_013kkVt3nxi9svp1an28uHxf
* docs: processing-chain and multirate diagrams, filter-bank math, streaming patterns
- getting-started embeds the processing-chain diagram as a guided map of
the guides
- filter-banks gains the IEC 61260-1 base-10 band math (G, fm, band
edges), a new multirate-decimation diagram (d5, four language/theme
variants) and the full octavefilter/OctaveFilterBank parameter table
- block-processing gains the canonical real-time level-meter loop
(validated against the actual API - TimeWeighting is inherently
stateful) and a stateful-constraints table
- multichannel gains the accepted-shapes table
Claude-Session: https://claude.ai/code/session_013kkVt3nxi9svp1an28uHxf
* docs: Spanish parity for the didactic expansion
Every enriched page now has its Spanish twin: levels (theory, three new
figures via _es variants, six parameter tables), weighting and
time-weighting (curve-origin and exponential-detector sections),
filter-banks (fractional-band math, multirate diagram, full parameter
table - terminology unified on 'decimación'), getting-started
(processing-chain map), block-processing (real-time meter pattern and
stateful constraints), multichannel (shapes table), theory (five new
sections) and a full rewrite of why-phonometry around the conformance
story. API reference now covers all 27 public exports in EN and ES
(added ToneAssessment and CalibrationWarning rows). UNE terminology and
Spanish decimal commas throughout; site builds with all links valid.
Claude-Session: https://claude.ai/code/session_013kkVt3nxi9svp1an28uHxf
* docs: audited fixes - Spanish tick commas and multirate note
Final visual-audit round: the d5 diagram now shows the no-decimation
note on the 16 kHz row in both languages, and Spanish figures render
every numeric tick with a decimal comma (FixedFormatter sequences are
rewritten in place; set_xticklabels-style FuncFormatters and plain
linear ScalarFormatters are wrapped - the first naive wrapper broke
ScalarFormatter ticks entirely and was caught visually).
Claude-Session: https://claude.ai/code/session_013kkVt3nxi9svp1an28uHxf
* docs(site): language selector in the mobile header, scrollable display math
Custom Header component (default markup plus a compact icon-only
LanguageSelect visible below the md breakpoint, where Starlight hides
the whole right group behind the hamburger menu) and overflow-x on
katex-display so wide formulas scroll inside their box on phones.
Verified with Playwright at 390 px in EN and ES.
Claude-Session: https://claude.ai/code/session_013kkVt3nxi9svp1an28uHxf
* fix: address review feedback on the didactic docs
- levels tables: spectrogram calibration_factor/dbfs marked constructor-
only, overlap range as 0 <= overlap < 1, composite hours constraints,
ln_levels shared-semantics row filled; ES translation leftovers and
the 'delante' typo fixed
- block-processing: y[..., -1] so the meter loop is multichannel-safe;
high_accuracy wording matches the real behavior (default resolves to
False, explicit True raises)
- API: CalibrationWarning row states the fs/validate preconditions (3 files)
- weighting: high_accuracy default column and oversampling claim made
precise (8x cap; silently ignored for G); ES row in parity
- filter-banks: 25 Hz relative bandwidth corrected to 0.024% of Nyquist
(EN/ES); verify_filter_class classes documented as 1/2/None
- generate_graphs: dropped the global plt.savefig monkey-patch - the
translation now runs inside themed_path(), which every generator
already calls at save time (verified output identical)
Claude-Session: https://claude.ai/code/session_013kkVt3nxi9svp1an28uHxf
Didactic documentation: theory everywhere, bilingual figures, setup diagrams, parameter tables (#77)
* docs: harden diagram engine per visual audit
- dim() draws real witness lines from the measured points to the offset
dimension line (the offset=0 path emitted zero-length lines); vertical
labels sit left of the line, clear of masts and figures
- env diagram: the 4 m dimension now measures the mic axis itself and
the flush-mounted label moved to the clear zone between masts
- tonality top view: the 1.00 m dimension connects face and microphone
Claude-Session: https://claude.ai/code/session_013kkVt3nxi9svp1an28uHxf
* docs: bilingual diagram variants (EN/ES x light/dark)
Every setup diagram is now emitted in four variants; Spanish strings
(including decimal commas) come from a translation table applied by the
SVG engine, and layouts were adjusted where the longer Spanish labels
collided (env titles, processing-chain box width, calibration output
label, tonality dimension label side).
Claude-Session: https://claude.ai/code/session_013kkVt3nxi9svp1an28uHxf
* docs: bilingual figure variants for the ES site (EN/ES x light/dark)
generate_graphs.py now emits every figure in four variants: a Spanish
translation table (~75 exact strings + parametrized patterns) is applied
to the figure's Text artists at savefig time, so the generator functions
stay single-language internally. Spanish output uses UNE terminology
(ponderación temporal, líneas isofónicas, fonios, ráfaga) and a uniform
decimal comma (annotations and tick labels included); code identifiers
and normative mode names (Fast/Slow/Impulse) stay untranslated. The ES
site pages now reference the _es/_es_dark variants (56 URLs). The ES set
passed a 10-figure visual audit (10/10 approved, no blockers).
Claude-Session: https://claude.ai/code/session_013kkVt3nxi9svp1an28uHxf
* docs: didactic calibration page - theory, setup diagram, stability figure, parameter table
Adds the sensitivity-factor derivation with the calibration-chain SVG,
a new autogenerated calibration_stability figure (stable vs 3% AM tone
against the IEC 60942:2017 class 1 deviation band; 4 language/theme
variants; the ES decimal-comma pass now preserves clause numbers like
5.3.3), and a full parameter table for calculate_sensitivity - EN and
ES in parity.
Claude-Session: https://claude.ai/code/session_013kkVt3nxi9svp1an28uHxf
* docs: SEL concept, Lden 24h profile and annotated TNR spectrum figures
Three new didactic figures for the levels guide, each in four
language/theme variants: sel_concept (pass-by event vs its Leq and the
equal-energy 1 s SEL block, dBFS mode), lden_profile (synthetic urban
24 h LAeq with colored day/evening/night bands and the +5/+10 weighted
period levels clearly separated from the composite Lden), and
tonality_spectrum (averaged Hann spectrum with the critical band, the
detected tone and the live TNR value vs its criterion, computed by the
library itself).
Claude-Session: https://claude.ai/code/session_013kkVt3nxi9svp1an28uHxf
* docs: didactic levels guide, theory extensions and refreshed why-phonometry
- levels guide (EN docs+site): energy-mean rationale for Leq, percentile
semantics for LN, SEL and noise-dose theory with the new figures
embedded, TNR critical-band explanation with the annotated spectrum,
Lden profile figure, and parameter tables (type/units/range/default)
for every level function including the spectrogram
- theory page: five new sections (G-weighting pole/zero derivation,
ISO 226 formulae, ECMA-418-1 TNR/PR math, event/dose metrics,
ISO 1996-1 descriptors) with cross-references to the guides
- why-phonometry: rewritten around the conformance-testing story with
the per-standard verification table and honest ecosystem positioning
Claude-Session: https://claude.ai/code/session_013kkVt3nxi9svp1an28uHxf
* docs: weighting/time-weighting theory and parameter tables; fix math-block delimiters
The physiological origin of A/C (inverted 40/100-phon contours, the four
IEC corner frequencies) and the exponential-detector derivation with the
tau semantics, each with full parameter tables. Display math inserted by
the docs expansion now always uses block-style $$ delimiters on their
own lines - mid-line multi-line $$ blocks silently derailed remark
parsing and truncated every heading after them (caught because the
built pages lost their anchor ids); also replaced a raw < in a table.
Claude-Session: https://claude.ai/code/session_013kkVt3nxi9svp1an28uHxf
* docs: processing-chain and multirate diagrams, filter-bank math, streaming patterns
- getting-started embeds the processing-chain diagram as a guided map of
the guides
- filter-banks gains the IEC 61260-1 base-10 band math (G, fm, band
edges), a new multirate-decimation diagram (d5, four language/theme
variants) and the full octavefilter/OctaveFilterBank parameter table
- block-processing gains the canonical real-time level-meter loop
(validated against the actual API - TimeWeighting is inherently
stateful) and a stateful-constraints table
- multichannel gains the accepted-shapes table
Claude-Session: https://claude.ai/code/session_013kkVt3nxi9svp1an28uHxf
* docs: Spanish parity for the didactic expansion
Every enriched page now has its Spanish twin: levels (theory, three new
figures via _es variants, six parameter tables), weighting and
time-weighting (curve-origin and exponential-detector sections),
filter-banks (fractional-band math, multirate diagram, full parameter
table - terminology unified on 'decimación'), getting-started
(processing-chain map), block-processing (real-time meter pattern and
stateful constraints), multichannel (shapes table), theory (five new
sections) and a full rewrite of why-phonometry around the conformance
story. API reference now covers all 27 public exports in EN and ES
(added ToneAssessment and CalibrationWarning rows). UNE terminology and
Spanish decimal commas throughout; site builds with all links valid.
Claude-Session: https://claude.ai/code/session_013kkVt3nxi9svp1an28uHxf
* docs: audited fixes - Spanish tick commas and multirate note
Final visual-audit round: the d5 diagram now shows the no-decimation
note on the 16 kHz row in both languages, and Spanish figures render
every numeric tick with a decimal comma (FixedFormatter sequences are
rewritten in place; set_xticklabels-style FuncFormatters and plain
linear ScalarFormatters are wrapped - the first naive wrapper broke
ScalarFormatter ticks entirely and was caught visually).
Claude-Session: https://claude.ai/code/session_013kkVt3nxi9svp1an28uHxf
* docs(site): language selector in the mobile header, scrollable display math
Custom Header component (default markup plus a compact icon-only
LanguageSelect visible below the md breakpoint, where Starlight hides
the whole right group behind the hamburger menu) and overflow-x on
katex-display so wide formulas scroll inside their box on phones.
Verified with Playwright at 390 px in EN and ES.
Claude-Session: https://claude.ai/code/session_013kkVt3nxi9svp1an28uHxf
* fix: address review feedback on the didactic docs
- levels tables: spectrogram calibration_factor/dbfs marked constructor-
only, overlap range as 0 <= overlap < 1, composite hours constraints,
ln_levels shared-semantics row filled; ES translation leftovers and
the 'delante' typo fixed
- block-processing: y[..., -1] so the meter loop is multichannel-safe;
high_accuracy wording matches the real behavior (default resolves to
False, explicit True raises)
- API: CalibrationWarning row states the fs/validate preconditions (3 files)
- weighting: high_accuracy default column and oversampling claim made
precise (8x cap; silently ignored for G); ES row in parity
- filter-banks: 25 Hz relative bandwidth corrected to 0.024% of Nyquist
(EN/ES); verify_filter_class classes documented as 1/2/None
- generate_graphs: dropped the global plt.savefig monkey-patch - the
translation now runs inside themed_path(), which every generator
already calls at save time (verified output identical)
Claude-Session: https://claude.ai/code/session_013kkVt3nxi9svp1an28uHxf
docs: building and structure-borne didactics, five rig diagrams and verified references (#193)
* docs: five structure-borne rig diagrams (ISO 9052-1, ISO 7626, ISO 10846, EN 15657, EN 12354-5)
Deterministic SVG builders with shared spring, accelerometer and exciter
helpers; light/dark and EN/ES variants of the dynamic-stiffness resonance
rig, the mobility beam rig, the direct/indirect transfer-stiffness stacks,
the reception plate and the EN 12354-5 installed-paths cross-section.
* docs: lab-vs-field quantities map and C/Ctr interpretation for the insulation guides
The apostrophe convention and flanking inclusion spelled out across the
trio, the extended lab/field quantities table, a didactic reading of the
spectrum adaptation terms, the measurement-prediction-check loop, and
verified References sections (Hopkins, Vigran, ISO 717-1, ISO 16283-1) in
the three copies (docs, site EN, site ES).
* docs: didactic depth for the structure-borne measurement guides
Rig diagrams embedded and prose added in all three copies: resonance-method
assumptions and preload pitfalls (EN 29052-1), how to read a mobility plot
and the ISO 7626-2 arrangement, why the blocked force and the frequency
split of the ISO 10846 methods, when the radiation-factor assumption breaks
(ISO/TS 7849), the reception-plate rationale (EN 15657) and the EN 12354-5
installation-paths context, each with a verified References section.
* docs: building-acoustics and structure-borne groups in the global bibliography
Hopkins, Vigran and Cremer/Heckl/Petersson with verified DOIs, the ISO
catalogue entries cited by the new References sections, and back-links to
the citing guides in the three bibliography copies.
* docs: legibility fixes in the mobility, transfer-stiffness and reception-plate diagrams
The driving-point caption clears the suspension spring, the Spanish
impedance-head caption clears the exciter stem, the excitation-mass boxes
fit the Spanish label, the indirect formula uses a consistent glyph style
and the Spanish source-quantities heading keeps a right margin.
* docs: precision and wording fixes in the new building and structure-borne prose
The radiation-factor caveat now qualifies accuracy rather than the bound,
Part 2 is tied explicitly to the radiation-factor problem, the survey
method keeps one Spanish term per page, the impedance-head note no longer
overstates, and Spanish register fixes (recrecido, diferencia, anclan) plus
site bibliography link texts aligned to the site page titles.
* docs: address review feedback on the building and structure-borne guides
- Field insulation guide: carry the spectrum adaptation terms on the field
descriptors (R'w + Ctr for facades, DnT,w + C between dwellings), matching
the example requirements of ISO 717-1, 5.3
- Transfer stiffness: state the ISO 10846-2 direct-method range from its
1 Hz scope bound instead of arbitrarily low frequencies, and say the
output is either rigidly blocked or loaded with a known mass
- Mechanical mobility: restrict the mobility-peak damping reading to the
isolated viscously damped resonator, present the soft free-free suspension
as the usual ISO 7626-2 arrangement rather than a requirement (clause 5),
and describe ISO 7626-5 as impact excitation with a non-attached exciter
whose spectrum is set by the impactor mass and tip stiffness
- Installed-paths diagram: render the EN 12354-5 Formula 17 path combination
as an energetic sum, 10 lg of the summed 10^(L/10) terms
- Spanish wording: parallel 'o bien ... o bien' in the transfer-stiffness
rig sentence and 'luego' in the resonance-rig diagram formula
docs: building and structure-borne didactics, five rig diagrams and verified references (#193)
* docs: five structure-borne rig diagrams (ISO 9052-1, ISO 7626, ISO 10846, EN 15657, EN 12354-5)
Deterministic SVG builders with shared spring, accelerometer and exciter
helpers; light/dark and EN/ES variants of the dynamic-stiffness resonance
rig, the mobility beam rig, the direct/indirect transfer-stiffness stacks,
the reception plate and the EN 12354-5 installed-paths cross-section.
* docs: lab-vs-field quantities map and C/Ctr interpretation for the insulation guides
The apostrophe convention and flanking inclusion spelled out across the
trio, the extended lab/field quantities table, a didactic reading of the
spectrum adaptation terms, the measurement-prediction-check loop, and
verified References sections (Hopkins, Vigran, ISO 717-1, ISO 16283-1) in
the three copies (docs, site EN, site ES).
* docs: didactic depth for the structure-borne measurement guides
Rig diagrams embedded and prose added in all three copies: resonance-method
assumptions and preload pitfalls (EN 29052-1), how to read a mobility plot
and the ISO 7626-2 arrangement, why the blocked force and the frequency
split of the ISO 10846 methods, when the radiation-factor assumption breaks
(ISO/TS 7849), the reception-plate rationale (EN 15657) and the EN 12354-5
installation-paths context, each with a verified References section.
* docs: building-acoustics and structure-borne groups in the global bibliography
Hopkins, Vigran and Cremer/Heckl/Petersson with verified DOIs, the ISO
catalogue entries cited by the new References sections, and back-links to
the citing guides in the three bibliography copies.
* docs: legibility fixes in the mobility, transfer-stiffness and reception-plate diagrams
The driving-point caption clears the suspension spring, the Spanish
impedance-head caption clears the exciter stem, the excitation-mass boxes
fit the Spanish label, the indirect formula uses a consistent glyph style
and the Spanish source-quantities heading keeps a right margin.
* docs: precision and wording fixes in the new building and structure-borne prose
The radiation-factor caveat now qualifies accuracy rather than the bound,
Part 2 is tied explicitly to the radiation-factor problem, the survey
method keeps one Spanish term per page, the impedance-head note no longer
overstates, and Spanish register fixes (recrecido, diferencia, anclan) plus
site bibliography link texts aligned to the site page titles.
* docs: address review feedback on the building and structure-borne guides
- Field insulation guide: carry the spectrum adaptation terms on the field
descriptors (R'w + Ctr for facades, DnT,w + C between dwellings), matching
the example requirements of ISO 717-1, 5.3
- Transfer stiffness: state the ISO 10846-2 direct-method range from its
1 Hz scope bound instead of arbitrarily low frequencies, and say the
output is either rigidly blocked or loaded with a known mass
- Mechanical mobility: restrict the mobility-peak damping reading to the
isolated viscously damped resonator, present the soft free-free suspension
as the usual ISO 7626-2 arrangement rather than a requirement (clause 5),
and describe ISO 7626-5 as impact excitation with a non-attached exciter
whose spectrum is set by the impactor mass and tip stiffness
- Installed-paths diagram: render the EN 12354-5 Formula 17 path combination
as an energetic sum, 10 lg of the summed 10^(L/10) terms
- Spanish wording: parallel 'o bien ... o bien' in the transfer-stiffness
rig sentence and 'luego' in the resonance-rig diagram formula
docs: building and structure-borne didactics, five rig diagrams and verified references (#193)
* docs: five structure-borne rig diagrams (ISO 9052-1, ISO 7626, ISO 10846, EN 15657, EN 12354-5)
Deterministic SVG builders with shared spring, accelerometer and exciter
helpers; light/dark and EN/ES variants of the dynamic-stiffness resonance
rig, the mobility beam rig, the direct/indirect transfer-stiffness stacks,
the reception plate and the EN 12354-5 installed-paths cross-section.
* docs: lab-vs-field quantities map and C/Ctr interpretation for the insulation guides
The apostrophe convention and flanking inclusion spelled out across the
trio, the extended lab/field quantities table, a didactic reading of the
spectrum adaptation terms, the measurement-prediction-check loop, and
verified References sections (Hopkins, Vigran, ISO 717-1, ISO 16283-1) in
the three copies (docs, site EN, site ES).
* docs: didactic depth for the structure-borne measurement guides
Rig diagrams embedded and prose added in all three copies: resonance-method
assumptions and preload pitfalls (EN 29052-1), how to read a mobility plot
and the ISO 7626-2 arrangement, why the blocked force and the frequency
split of the ISO 10846 methods, when the radiation-factor assumption breaks
(ISO/TS 7849), the reception-plate rationale (EN 15657) and the EN 12354-5
installation-paths context, each with a verified References section.
* docs: building-acoustics and structure-borne groups in the global bibliography
Hopkins, Vigran and Cremer/Heckl/Petersson with verified DOIs, the ISO
catalogue entries cited by the new References sections, and back-links to
the citing guides in the three bibliography copies.
* docs: legibility fixes in the mobility, transfer-stiffness and reception-plate diagrams
The driving-point caption clears the suspension spring, the Spanish
impedance-head caption clears the exciter stem, the excitation-mass boxes
fit the Spanish label, the indirect formula uses a consistent glyph style
and the Spanish source-quantities heading keeps a right margin.
* docs: precision and wording fixes in the new building and structure-borne prose
The radiation-factor caveat now qualifies accuracy rather than the bound,
Part 2 is tied explicitly to the radiation-factor problem, the survey
method keeps one Spanish term per page, the impedance-head note no longer
overstates, and Spanish register fixes (recrecido, diferencia, anclan) plus
site bibliography link texts aligned to the site page titles.
* docs: address review feedback on the building and structure-borne guides
- Field insulation guide: carry the spectrum adaptation terms on the field
descriptors (R'w + Ctr for facades, DnT,w + C between dwellings), matching
the example requirements of ISO 717-1, 5.3
- Transfer stiffness: state the ISO 10846-2 direct-method range from its
1 Hz scope bound instead of arbitrarily low frequencies, and say the
output is either rigidly blocked or loaded with a known mass
- Mechanical mobility: restrict the mobility-peak damping reading to the
isolated viscously damped resonator, present the soft free-free suspension
as the usual ISO 7626-2 arrangement rather than a requirement (clause 5),
and describe ISO 7626-5 as impact excitation with a non-attached exciter
whose spectrum is set by the impactor mass and tip stiffness
- Installed-paths diagram: render the EN 12354-5 Formula 17 path combination
as an energetic sum, 10 lg of the summed 10^(L/10) terms
- Spanish wording: parallel 'o bien ... o bien' in the transfer-stiffness
rig sentence and 'luego' in the resonance-rig diagram formula
docs: building and structure-borne didactics, five rig diagrams and verified references (#193)
* docs: five structure-borne rig diagrams (ISO 9052-1, ISO 7626, ISO 10846, EN 15657, EN 12354-5)
Deterministic SVG builders with shared spring, accelerometer and exciter
helpers; light/dark and EN/ES variants of the dynamic-stiffness resonance
rig, the mobility beam rig, the direct/indirect transfer-stiffness stacks,
the reception plate and the EN 12354-5 installed-paths cross-section.
* docs: lab-vs-field quantities map and C/Ctr interpretation for the insulation guides
The apostrophe convention and flanking inclusion spelled out across the
trio, the extended lab/field quantities table, a didactic reading of the
spectrum adaptation terms, the measurement-prediction-check loop, and
verified References sections (Hopkins, Vigran, ISO 717-1, ISO 16283-1) in
the three copies (docs, site EN, site ES).
* docs: didactic depth for the structure-borne measurement guides
Rig diagrams embedded and prose added in all three copies: resonance-method
assumptions and preload pitfalls (EN 29052-1), how to read a mobility plot
and the ISO 7626-2 arrangement, why the blocked force and the frequency
split of the ISO 10846 methods, when the radiation-factor assumption breaks
(ISO/TS 7849), the reception-plate rationale (EN 15657) and the EN 12354-5
installation-paths context, each with a verified References section.
* docs: building-acoustics and structure-borne groups in the global bibliography
Hopkins, Vigran and Cremer/Heckl/Petersson with verified DOIs, the ISO
catalogue entries cited by the new References sections, and back-links to
the citing guides in the three bibliography copies.
* docs: legibility fixes in the mobility, transfer-stiffness and reception-plate diagrams
The driving-point caption clears the suspension spring, the Spanish
impedance-head caption clears the exciter stem, the excitation-mass boxes
fit the Spanish label, the indirect formula uses a consistent glyph style
and the Spanish source-quantities heading keeps a right margin.
* docs: precision and wording fixes in the new building and structure-borne prose
The radiation-factor caveat now qualifies accuracy rather than the bound,
Part 2 is tied explicitly to the radiation-factor problem, the survey
method keeps one Spanish term per page, the impedance-head note no longer
overstates, and Spanish register fixes (recrecido, diferencia, anclan) plus
site bibliography link texts aligned to the site page titles.
* docs: address review feedback on the building and structure-borne guides
- Field insulation guide: carry the spectrum adaptation terms on the field
descriptors (R'w + Ctr for facades, DnT,w + C between dwellings), matching
the example requirements of ISO 717-1, 5.3
- Transfer stiffness: state the ISO 10846-2 direct-method range from its
1 Hz scope bound instead of arbitrarily low frequencies, and say the
output is either rigidly blocked or loaded with a known mass
- Mechanical mobility: restrict the mobility-peak damping reading to the
isolated viscously damped resonator, present the soft free-free suspension
as the usual ISO 7626-2 arrangement rather than a requirement (clause 5),
and describe ISO 7626-5 as impact excitation with a non-attached exciter
whose spectrum is set by the impactor mass and tip stiffness
- Installed-paths diagram: render the EN 12354-5 Formula 17 path combination
as an energetic sum, 10 lg of the summed 10^(L/10) terms
- Spanish wording: parallel 'o bien ... o bien' in the transfer-stiffness
rig sentence and 'luego' in the resonance-rig diagram formula
feat: measurement uncertainty (GUM ISO/IEC Guide 98-3:2008 + Monte Carlo Supplement 1) (#102)
Adds a `phonometry.uncertainty` module implementing the two propagation methods of the GUM:
* Law of propagation of uncertainty (ISO/IEC Guide 98-3:2008, clause 5) — `combine_uncertainty` builds the combined standard uncertainty from central-difference sensitivity coefficients, with optional input correlations (validated for shape, symmetry, unit diagonal and positive-semidefiniteness), Welch-Satterthwaite effective degrees of freedom (Annex G.4) and the expanded uncertainty U = k*uc (clause 6).
* Monte Carlo method (ISO/IEC Guide 98-3-1:2008, Supplement 1, clause 7) — `monte_carlo` propagates the input PDFs and returns the estimate, its standard uncertainty and the probabilistically symmetric coverage interval (clause 7.7).
Type B quantities from a half-width: `rectangular` (a/sqrt3), `triangular` (a/sqrt6), `u_shaped` (a/sqrt2). Results expose `.expanded()` and `.plot()` (uncertainty budget).
Validated against the Guides' worked examples: additive uc=2.0 (Suppl. 1, 9.2), coverage factor k=2.92 at p=0.99/v=16 (Table G.2), Welch-Satterthwaite v_eff=40 (Annex G.4), Monte Carlo interval [-3.88, 3.88] (Suppl. 1, 9.2.3). Conformance 79/79.
Includes the budget/Monte-Carlo figure, the two-lane GUM-vs-Monte-Carlo diagram (EN/ES, light/dark), the repo doc and the EN/ES site guides under a new "Metrology & uncertainty" section.
feat: measurement uncertainty (GUM ISO/IEC Guide 98-3:2008 + Monte Carlo Supplement 1) (#102)
Adds a `phonometry.uncertainty` module implementing the two propagation methods of the GUM:
* Law of propagation of uncertainty (ISO/IEC Guide 98-3:2008, clause 5) — `combine_uncertainty` builds the combined standard uncertainty from central-difference sensitivity coefficients, with optional input correlations (validated for shape, symmetry, unit diagonal and positive-semidefiniteness), Welch-Satterthwaite effective degrees of freedom (Annex G.4) and the expanded uncertainty U = k*uc (clause 6).
* Monte Carlo method (ISO/IEC Guide 98-3-1:2008, Supplement 1, clause 7) — `monte_carlo` propagates the input PDFs and returns the estimate, its standard uncertainty and the probabilistically symmetric coverage interval (clause 7.7).
Type B quantities from a half-width: `rectangular` (a/sqrt3), `triangular` (a/sqrt6), `u_shaped` (a/sqrt2). Results expose `.expanded()` and `.plot()` (uncertainty budget).
Validated against the Guides' worked examples: additive uc=2.0 (Suppl. 1, 9.2), coverage factor k=2.92 at p=0.99/v=16 (Table G.2), Welch-Satterthwaite v_eff=40 (Annex G.4), Monte Carlo interval [-3.88, 3.88] (Suppl. 1, 9.2.3). Conformance 79/79.
Includes the budget/Monte-Carlo figure, the two-lane GUM-vs-Monte-Carlo diagram (EN/ES, light/dark), the repo doc and the EN/ES site guides under a new "Metrology & uncertainty" section.
feat: measurement uncertainty (GUM ISO/IEC Guide 98-3:2008 + Monte Carlo Supplement 1) (#102)
Adds a `phonometry.uncertainty` module implementing the two propagation methods of the GUM:
* Law of propagation of uncertainty (ISO/IEC Guide 98-3:2008, clause 5) — `combine_uncertainty` builds the combined standard uncertainty from central-difference sensitivity coefficients, with optional input correlations (validated for shape, symmetry, unit diagonal and positive-semidefiniteness), Welch-Satterthwaite effective degrees of freedom (Annex G.4) and the expanded uncertainty U = k*uc (clause 6).
* Monte Carlo method (ISO/IEC Guide 98-3-1:2008, Supplement 1, clause 7) — `monte_carlo` propagates the input PDFs and returns the estimate, its standard uncertainty and the probabilistically symmetric coverage interval (clause 7.7).
Type B quantities from a half-width: `rectangular` (a/sqrt3), `triangular` (a/sqrt6), `u_shaped` (a/sqrt2). Results expose `.expanded()` and `.plot()` (uncertainty budget).
Validated against the Guides' worked examples: additive uc=2.0 (Suppl. 1, 9.2), coverage factor k=2.92 at p=0.99/v=16 (Table G.2), Welch-Satterthwaite v_eff=40 (Annex G.4), Monte Carlo interval [-3.88, 3.88] (Suppl. 1, 9.2.3). Conformance 79/79.
Includes the budget/Monte-Carlo figure, the two-lane GUM-vs-Monte-Carlo diagram (EN/ES, light/dark), the repo doc and the EN/ES site guides under a new "Metrology & uncertainty" section.
feat: measurement uncertainty (GUM ISO/IEC Guide 98-3:2008 + Monte Carlo Supplement 1) (#102)
Adds a `phonometry.uncertainty` module implementing the two propagation methods of the GUM:
* Law of propagation of uncertainty (ISO/IEC Guide 98-3:2008, clause 5) — `combine_uncertainty` builds the combined standard uncertainty from central-difference sensitivity coefficients, with optional input correlations (validated for shape, symmetry, unit diagonal and positive-semidefiniteness), Welch-Satterthwaite effective degrees of freedom (Annex G.4) and the expanded uncertainty U = k*uc (clause 6).
* Monte Carlo method (ISO/IEC Guide 98-3-1:2008, Supplement 1, clause 7) — `monte_carlo` propagates the input PDFs and returns the estimate, its standard uncertainty and the probabilistically symmetric coverage interval (clause 7.7).
Type B quantities from a half-width: `rectangular` (a/sqrt3), `triangular` (a/sqrt6), `u_shaped` (a/sqrt2). Results expose `.expanded()` and `.plot()` (uncertainty budget).
Validated against the Guides' worked examples: additive uc=2.0 (Suppl. 1, 9.2), coverage factor k=2.92 at p=0.99/v=16 (Table G.2), Welch-Satterthwaite v_eff=40 (Annex G.4), Monte Carlo interval [-3.88, 3.88] (Suppl. 1, 9.2.3). Conformance 79/79.
Includes the budget/Monte-Carlo figure, the two-lane GUM-vs-Monte-Carlo diagram (EN/ES, light/dark), the repo doc and the EN/ES site guides under a new "Metrology & uncertainty" section.
docs: outdoor and environmental didactics, measurement-geometry diagrams and verified references (#199)
* docs: IEC 61400-11 measurement-geometry and ground-reflection setup diagrams
Two new deterministic SVG diagrams (4 variants each, EN/ES x light/dark):
- diagram_wind_turbine_iec61400: side view of the turbine with the downwind
ground-board microphone at R0 = H + D/2, the slant distance R1 to the
rotor centre, the met mast, the board inclination angle and the Figure 3
plan-view position pattern (reference position downwind, optional
positions at +/-60 degrees and upwind).
- diagram_ground_reflection: source and receiver over a reflecting plane
with the direct ray, the specular reflection unfolded through the image
source, the path difference delta = r2 - r1 and the interference phase.
* docs: outdoor-propagation didactics: image source, favourable conditions, barrier pitfalls, CNOSSOS-EU
Expand the outdoor-propagation guide in the three trees (docs EN, site EN,
site ES):
- New subsection on the image source behind the ground effect, with the
ground-reflection diagram: path difference, interference phase, the hard
-3 dB result and the porous-ground notch that Table 3 parameterizes.
- New closing section on scope and pitfalls: what the favourable propagation
conditions of Clause 5 mean and why the method predicts the audible case;
barrier fine print (the 20/25 dB caps, the Kmet erosion over distance, the
modest double-diffraction bonus, the Abar = Dz - Agr fold-in and the
Clause 7.4 qualification rules); and an ISO 9613-2 vs CNOSSOS-EU
comparison covering scope, methodology and why the two frameworks disagree
on the same geometry.
- References section with verified entries: Salomons, Attenborough & Van
Renterghem, Maekawa 1968, the CNOSSOS-EU JRC report and the ISO 9613-1/-2
catalogue pages.
* docs: impulse-prominence context: category adjustments, ISO/PAS 1996-3 and logging caveats
Add a short standards-context section to the impulse-prominence guide in the
three trees: the fixed ISO 1996-1:2016 Table A.1 category adjustments (5 dB
regular, 12 dB highly impulsive) that the measured prominence replaces with
a graduated KI, the ISO/PAS 1996-3:2022 successor built on the same
onset-rate prominence, and two practical caveats (time-weighting-F smoothing
of very short impulses and prominence-not-energy). References section with
the Nordtest method page and the ISO 1996-1 / ISO/PAS 1996-3 catalogue
pages, all verified.
* docs: wind-turbine-noise didactics: measurement geometry, apparent power and wind-speed binning
Expand the wind-turbine-noise guide in the three trees:
- Embed the IEC 61400-11 measurement-geometry diagram (ground-board
microphone at R0 = H + D/2, slant distance R1, met mast, plan-view
position pattern).
- New subsection on why the apparent sound power is not a true LW: an
equivalent point source at the rotor centre matched to one downwind
position, with directivity folded in, comparable across turbines because
the geometry scales with the machine.
- New subsection on wind-speed bins and standardized conditions: 0.5 m/s
bins centred on integer and half-integer hub-height speeds, wind speed
derived from electric power through the power curve, the 0.8 to 1.3 times
85 %-power range, background-margin rules, and the Formula (29) conversion
to 10 m height over the 0.05 m reference roughness length.
- References section: IEC 61400-11:2012+AMD1:2018 CSV, IEC TS 61400-14:2005
and ISO 1996-2:2017, all verified.
* docs: outdoor and environmental sound group in the global bibliography
Add the Outdoor and environmental sound section to the bibliography in the
three trees, with back-links to the citing guides: Salomons, Attenborough &
Van Renterghem, Maekawa 1968, the CNOSSOS-EU JRC report, ISO 9613-1/-2,
ISO 1996-1/-2, NT ACOU 112, ISO/PAS 1996-3 and IEC 61400-11/-14. The
ISO 1996-2 entry also back-fills the tone-audibility citation that was
missing from the global list.
* docs: review fixes for the outdoor and environmental wave
- Bind the tonal-audibility criterion IEC 61400-11 reuses to the Annex C of
the 2007 edition of ISO 1996-2 (the 2017 edition carries the tonal methods
in Annexes J and K), in the wind-turbine References and the bibliography.
- ISO 3744 samples the pressure field over the enveloping surface; intensity
integration is ISO 9614 territory.
- IEC 61400-11 background rule: a margin of 3 dB or less voids the bin (the
boundary case included).
- Ground-reflection diagram: parenthesise the reflection-coefficient note so
SVG whitespace collapsing cannot glue it to the formula; move the
wind-turbine ground-board label clear of the R1 ray.
- Spanish polish: unify onset rate as tasa de crecimiento, replace the
recomprar calque with compensar.
* docs: review refinements in the outdoor and environmental guides
---------
Co-authored-by: José M. Requena Plens <jmrplens@icloud.com>
docs: outdoor and environmental didactics, measurement-geometry diagrams and verified references (#199)
* docs: IEC 61400-11 measurement-geometry and ground-reflection setup diagrams
Two new deterministic SVG diagrams (4 variants each, EN/ES x light/dark):
- diagram_wind_turbine_iec61400: side view of the turbine with the downwind
ground-board microphone at R0 = H + D/2, the slant distance R1 to the
rotor centre, the met mast, the board inclination angle and the Figure 3
plan-view position pattern (reference position downwind, optional
positions at +/-60 degrees and upwind).
- diagram_ground_reflection: source and receiver over a reflecting plane
with the direct ray, the specular reflection unfolded through the image
source, the path difference delta = r2 - r1 and the interference phase.
* docs: outdoor-propagation didactics: image source, favourable conditions, barrier pitfalls, CNOSSOS-EU
Expand the outdoor-propagation guide in the three trees (docs EN, site EN,
site ES):
- New subsection on the image source behind the ground effect, with the
ground-reflection diagram: path difference, interference phase, the hard
-3 dB result and the porous-ground notch that Table 3 parameterizes.
- New closing section on scope and pitfalls: what the favourable propagation
conditions of Clause 5 mean and why the method predicts the audible case;
barrier fine print (the 20/25 dB caps, the Kmet erosion over distance, the
modest double-diffraction bonus, the Abar = Dz - Agr fold-in and the
Clause 7.4 qualification rules); and an ISO 9613-2 vs CNOSSOS-EU
comparison covering scope, methodology and why the two frameworks disagree
on the same geometry.
- References section with verified entries: Salomons, Attenborough & Van
Renterghem, Maekawa 1968, the CNOSSOS-EU JRC report and the ISO 9613-1/-2
catalogue pages.
* docs: impulse-prominence context: category adjustments, ISO/PAS 1996-3 and logging caveats
Add a short standards-context section to the impulse-prominence guide in the
three trees: the fixed ISO 1996-1:2016 Table A.1 category adjustments (5 dB
regular, 12 dB highly impulsive) that the measured prominence replaces with
a graduated KI, the ISO/PAS 1996-3:2022 successor built on the same
onset-rate prominence, and two practical caveats (time-weighting-F smoothing
of very short impulses and prominence-not-energy). References section with
the Nordtest method page and the ISO 1996-1 / ISO/PAS 1996-3 catalogue
pages, all verified.
* docs: wind-turbine-noise didactics: measurement geometry, apparent power and wind-speed binning
Expand the wind-turbine-noise guide in the three trees:
- Embed the IEC 61400-11 measurement-geometry diagram (ground-board
microphone at R0 = H + D/2, slant distance R1, met mast, plan-view
position pattern).
- New subsection on why the apparent sound power is not a true LW: an
equivalent point source at the rotor centre matched to one downwind
position, with directivity folded in, comparable across turbines because
the geometry scales with the machine.
- New subsection on wind-speed bins and standardized conditions: 0.5 m/s
bins centred on integer and half-integer hub-height speeds, wind speed
derived from electric power through the power curve, the 0.8 to 1.3 times
85 %-power range, background-margin rules, and the Formula (29) conversion
to 10 m height over the 0.05 m reference roughness length.
- References section: IEC 61400-11:2012+AMD1:2018 CSV, IEC TS 61400-14:2005
and ISO 1996-2:2017, all verified.
* docs: outdoor and environmental sound group in the global bibliography
Add the Outdoor and environmental sound section to the bibliography in the
three trees, with back-links to the citing guides: Salomons, Attenborough &
Van Renterghem, Maekawa 1968, the CNOSSOS-EU JRC report, ISO 9613-1/-2,
ISO 1996-1/-2, NT ACOU 112, ISO/PAS 1996-3 and IEC 61400-11/-14. The
ISO 1996-2 entry also back-fills the tone-audibility citation that was
missing from the global list.
* docs: review fixes for the outdoor and environmental wave
- Bind the tonal-audibility criterion IEC 61400-11 reuses to the Annex C of
the 2007 edition of ISO 1996-2 (the 2017 edition carries the tonal methods
in Annexes J and K), in the wind-turbine References and the bibliography.
- ISO 3744 samples the pressure field over the enveloping surface; intensity
integration is ISO 9614 territory.
- IEC 61400-11 background rule: a margin of 3 dB or less voids the bin (the
boundary case included).
- Ground-reflection diagram: parenthesise the reflection-coefficient note so
SVG whitespace collapsing cannot glue it to the formula; move the
wind-turbine ground-board label clear of the R1 ray.
- Spanish polish: unify onset rate as tasa de crecimiento, replace the
recomprar calque with compensar.
* docs: review refinements in the outdoor and environmental guides
---------
Co-authored-by: José M. Requena Plens <jmrplens@icloud.com>
docs: outdoor and environmental didactics, measurement-geometry diagrams and verified references (#199)
* docs: IEC 61400-11 measurement-geometry and ground-reflection setup diagrams
Two new deterministic SVG diagrams (4 variants each, EN/ES x light/dark):
- diagram_wind_turbine_iec61400: side view of the turbine with the downwind
ground-board microphone at R0 = H + D/2, the slant distance R1 to the
rotor centre, the met mast, the board inclination angle and the Figure 3
plan-view position pattern (reference position downwind, optional
positions at +/-60 degrees and upwind).
- diagram_ground_reflection: source and receiver over a reflecting plane
with the direct ray, the specular reflection unfolded through the image
source, the path difference delta = r2 - r1 and the interference phase.
* docs: outdoor-propagation didactics: image source, favourable conditions, barrier pitfalls, CNOSSOS-EU
Expand the outdoor-propagation guide in the three trees (docs EN, site EN,
site ES):
- New subsection on the image source behind the ground effect, with the
ground-reflection diagram: path difference, interference phase, the hard
-3 dB result and the porous-ground notch that Table 3 parameterizes.
- New closing section on scope and pitfalls: what the favourable propagation
conditions of Clause 5 mean and why the method predicts the audible case;
barrier fine print (the 20/25 dB caps, the Kmet erosion over distance, the
modest double-diffraction bonus, the Abar = Dz - Agr fold-in and the
Clause 7.4 qualification rules); and an ISO 9613-2 vs CNOSSOS-EU
comparison covering scope, methodology and why the two frameworks disagree
on the same geometry.
- References section with verified entries: Salomons, Attenborough & Van
Renterghem, Maekawa 1968, the CNOSSOS-EU JRC report and the ISO 9613-1/-2
catalogue pages.
* docs: impulse-prominence context: category adjustments, ISO/PAS 1996-3 and logging caveats
Add a short standards-context section to the impulse-prominence guide in the
three trees: the fixed ISO 1996-1:2016 Table A.1 category adjustments (5 dB
regular, 12 dB highly impulsive) that the measured prominence replaces with
a graduated KI, the ISO/PAS 1996-3:2022 successor built on the same
onset-rate prominence, and two practical caveats (time-weighting-F smoothing
of very short impulses and prominence-not-energy). References section with
the Nordtest method page and the ISO 1996-1 / ISO/PAS 1996-3 catalogue
pages, all verified.
* docs: wind-turbine-noise didactics: measurement geometry, apparent power and wind-speed binning
Expand the wind-turbine-noise guide in the three trees:
- Embed the IEC 61400-11 measurement-geometry diagram (ground-board
microphone at R0 = H + D/2, slant distance R1, met mast, plan-view
position pattern).
- New subsection on why the apparent sound power is not a true LW: an
equivalent point source at the rotor centre matched to one downwind
position, with directivity folded in, comparable across turbines because
the geometry scales with the machine.
- New subsection on wind-speed bins and standardized conditions: 0.5 m/s
bins centred on integer and half-integer hub-height speeds, wind speed
derived from electric power through the power curve, the 0.8 to 1.3 times
85 %-power range, background-margin rules, and the Formula (29) conversion
to 10 m height over the 0.05 m reference roughness length.
- References section: IEC 61400-11:2012+AMD1:2018 CSV, IEC TS 61400-14:2005
and ISO 1996-2:2017, all verified.
* docs: outdoor and environmental sound group in the global bibliography
Add the Outdoor and environmental sound section to the bibliography in the
three trees, with back-links to the citing guides: Salomons, Attenborough &
Van Renterghem, Maekawa 1968, the CNOSSOS-EU JRC report, ISO 9613-1/-2,
ISO 1996-1/-2, NT ACOU 112, ISO/PAS 1996-3 and IEC 61400-11/-14. The
ISO 1996-2 entry also back-fills the tone-audibility citation that was
missing from the global list.
* docs: review fixes for the outdoor and environmental wave
- Bind the tonal-audibility criterion IEC 61400-11 reuses to the Annex C of
the 2007 edition of ISO 1996-2 (the 2017 edition carries the tonal methods
in Annexes J and K), in the wind-turbine References and the bibliography.
- ISO 3744 samples the pressure field over the enveloping surface; intensity
integration is ISO 9614 territory.
- IEC 61400-11 background rule: a margin of 3 dB or less voids the bin (the
boundary case included).
- Ground-reflection diagram: parenthesise the reflection-coefficient note so
SVG whitespace collapsing cannot glue it to the formula; move the
wind-turbine ground-board label clear of the R1 ray.
- Spanish polish: unify onset rate as tasa de crecimiento, replace the
recomprar calque with compensar.
* docs: review refinements in the outdoor and environmental guides
---------
Co-authored-by: José M. Requena Plens <jmrplens@icloud.com>
docs: outdoor and environmental didactics, measurement-geometry diagrams and verified references (#199)
* docs: IEC 61400-11 measurement-geometry and ground-reflection setup diagrams
Two new deterministic SVG diagrams (4 variants each, EN/ES x light/dark):
- diagram_wind_turbine_iec61400: side view of the turbine with the downwind
ground-board microphone at R0 = H + D/2, the slant distance R1 to the
rotor centre, the met mast, the board inclination angle and the Figure 3
plan-view position pattern (reference position downwind, optional
positions at +/-60 degrees and upwind).
- diagram_ground_reflection: source and receiver over a reflecting plane
with the direct ray, the specular reflection unfolded through the image
source, the path difference delta = r2 - r1 and the interference phase.
* docs: outdoor-propagation didactics: image source, favourable conditions, barrier pitfalls, CNOSSOS-EU
Expand the outdoor-propagation guide in the three trees (docs EN, site EN,
site ES):
- New subsection on the image source behind the ground effect, with the
ground-reflection diagram: path difference, interference phase, the hard
-3 dB result and the porous-ground notch that Table 3 parameterizes.
- New closing section on scope and pitfalls: what the favourable propagation
conditions of Clause 5 mean and why the method predicts the audible case;
barrier fine print (the 20/25 dB caps, the Kmet erosion over distance, the
modest double-diffraction bonus, the Abar = Dz - Agr fold-in and the
Clause 7.4 qualification rules); and an ISO 9613-2 vs CNOSSOS-EU
comparison covering scope, methodology and why the two frameworks disagree
on the same geometry.
- References section with verified entries: Salomons, Attenborough & Van
Renterghem, Maekawa 1968, the CNOSSOS-EU JRC report and the ISO 9613-1/-2
catalogue pages.
* docs: impulse-prominence context: category adjustments, ISO/PAS 1996-3 and logging caveats
Add a short standards-context section to the impulse-prominence guide in the
three trees: the fixed ISO 1996-1:2016 Table A.1 category adjustments (5 dB
regular, 12 dB highly impulsive) that the measured prominence replaces with
a graduated KI, the ISO/PAS 1996-3:2022 successor built on the same
onset-rate prominence, and two practical caveats (time-weighting-F smoothing
of very short impulses and prominence-not-energy). References section with
the Nordtest method page and the ISO 1996-1 / ISO/PAS 1996-3 catalogue
pages, all verified.
* docs: wind-turbine-noise didactics: measurement geometry, apparent power and wind-speed binning
Expand the wind-turbine-noise guide in the three trees:
- Embed the IEC 61400-11 measurement-geometry diagram (ground-board
microphone at R0 = H + D/2, slant distance R1, met mast, plan-view
position pattern).
- New subsection on why the apparent sound power is not a true LW: an
equivalent point source at the rotor centre matched to one downwind
position, with directivity folded in, comparable across turbines because
the geometry scales with the machine.
- New subsection on wind-speed bins and standardized conditions: 0.5 m/s
bins centred on integer and half-integer hub-height speeds, wind speed
derived from electric power through the power curve, the 0.8 to 1.3 times
85 %-power range, background-margin rules, and the Formula (29) conversion
to 10 m height over the 0.05 m reference roughness length.
- References section: IEC 61400-11:2012+AMD1:2018 CSV, IEC TS 61400-14:2005
and ISO 1996-2:2017, all verified.
* docs: outdoor and environmental sound group in the global bibliography
Add the Outdoor and environmental sound section to the bibliography in the
three trees, with back-links to the citing guides: Salomons, Attenborough &
Van Renterghem, Maekawa 1968, the CNOSSOS-EU JRC report, ISO 9613-1/-2,
ISO 1996-1/-2, NT ACOU 112, ISO/PAS 1996-3 and IEC 61400-11/-14. The
ISO 1996-2 entry also back-fills the tone-audibility citation that was
missing from the global list.
* docs: review fixes for the outdoor and environmental wave
- Bind the tonal-audibility criterion IEC 61400-11 reuses to the Annex C of
the 2007 edition of ISO 1996-2 (the 2017 edition carries the tonal methods
in Annexes J and K), in the wind-turbine References and the bibliography.
- ISO 3744 samples the pressure field over the enveloping surface; intensity
integration is ISO 9614 territory.
- IEC 61400-11 background rule: a margin of 3 dB or less voids the bin (the
boundary case included).
- Ground-reflection diagram: parenthesise the reflection-coefficient note so
SVG whitespace collapsing cannot glue it to the formula; move the
wind-turbine ground-board label clear of the R1 ray.
- Spanish polish: unify onset rate as tasa de crecimiento, replace the
recomprar calque with compensar.
* docs: review refinements in the outdoor and environmental guides
---------
Co-authored-by: José M. Requena Plens <jmrplens@icloud.com>
Audit pass 11a: seven new documentation diagrams (#121)
* Audit pass 11a: seven new documentation diagrams
Add SVG flow diagrams for the seven topics the audit flagged as having no
schematic: the exponential-detector chain of the time weightings
(IEC 61672-1), stateful vs reset block processing, the multichannel
array-shape flow, the open-plan spatial-decay line (ISO 3382-3), the
ISO 12999-1 uncertainty pipeline, the ISO 11654 absorption-rating flow and
the Zwicker loudness-model chain (ISO 532-1).
Each is generated deterministically by generate_diagrams.py in the four
EN/ES x light/dark variants, with every Spanish label added to the _ES
table (decimals localised to commas), and embedded in the repo docs and
both site trees beside the existing worked-example plots.
* Fix ISO 532-1 table citations in the Zwicker diagram
Review of the diagram against loudness_zwicker.py found two mislabelled
tables: the equal-loudness correction and lower-critical-band grouping is
Table A.3 (not A.4), and the threshold in quiet LTQ is Table A.6 (not A.3).
Reassign the a0/DDF/LTQ corrections to the core-loudness step (Tables
A.4-A.7) where they belong, update the Spanish labels, and align the ES
psychoacoustics alt text with the guide's own term "sonos" (was "sonios").
Audit pass 11a: seven new documentation diagrams (#121)
* Audit pass 11a: seven new documentation diagrams
Add SVG flow diagrams for the seven topics the audit flagged as having no
schematic: the exponential-detector chain of the time weightings
(IEC 61672-1), stateful vs reset block processing, the multichannel
array-shape flow, the open-plan spatial-decay line (ISO 3382-3), the
ISO 12999-1 uncertainty pipeline, the ISO 11654 absorption-rating flow and
the Zwicker loudness-model chain (ISO 532-1).
Each is generated deterministically by generate_diagrams.py in the four
EN/ES x light/dark variants, with every Spanish label added to the _ES
table (decimals localised to commas), and embedded in the repo docs and
both site trees beside the existing worked-example plots.
* Fix ISO 532-1 table citations in the Zwicker diagram
Review of the diagram against loudness_zwicker.py found two mislabelled
tables: the equal-loudness correction and lower-critical-band grouping is
Table A.3 (not A.4), and the threshold in quiet LTQ is Table A.6 (not A.3).
Reassign the a0/DDF/LTQ corrections to the core-loudness step (Tables
A.4-A.7) where they belong, update the Spanish labels, and align the ES
psychoacoustics alt text with the guide's own term "sonos" (was "sonios").
Audit pass 11a: seven new documentation diagrams (#121)
* Audit pass 11a: seven new documentation diagrams
Add SVG flow diagrams for the seven topics the audit flagged as having no
schematic: the exponential-detector chain of the time weightings
(IEC 61672-1), stateful vs reset block processing, the multichannel
array-shape flow, the open-plan spatial-decay line (ISO 3382-3), the
ISO 12999-1 uncertainty pipeline, the ISO 11654 absorption-rating flow and
the Zwicker loudness-model chain (ISO 532-1).
Each is generated deterministically by generate_diagrams.py in the four
EN/ES x light/dark variants, with every Spanish label added to the _ES
table (decimals localised to commas), and embedded in the repo docs and
both site trees beside the existing worked-example plots.
* Fix ISO 532-1 table citations in the Zwicker diagram
Review of the diagram against loudness_zwicker.py found two mislabelled
tables: the equal-loudness correction and lower-critical-band grouping is
Table A.3 (not A.4), and the threshold in quiet LTQ is Table A.6 (not A.3).
Reassign the a0/DDF/LTQ corrections to the core-loudness step (Tables
A.4-A.7) where they belong, update the Spanish labels, and align the ES
psychoacoustics alt text with the guide's own term "sonos" (was "sonios").
Audit pass 11a: seven new documentation diagrams (#121)
* Audit pass 11a: seven new documentation diagrams
Add SVG flow diagrams for the seven topics the audit flagged as having no
schematic: the exponential-detector chain of the time weightings
(IEC 61672-1), stateful vs reset block processing, the multichannel
array-shape flow, the open-plan spatial-decay line (ISO 3382-3), the
ISO 12999-1 uncertainty pipeline, the ISO 11654 absorption-rating flow and
the Zwicker loudness-model chain (ISO 532-1).
Each is generated deterministically by generate_diagrams.py in the four
EN/ES x light/dark variants, with every Spanish label added to the _ES
table (decimals localised to commas), and embedded in the repo docs and
both site trees beside the existing worked-example plots.
* Fix ISO 532-1 table citations in the Zwicker diagram
Review of the diagram against loudness_zwicker.py found two mislabelled
tables: the equal-loudness correction and lower-critical-band grouping is
Table A.3 (not A.4), and the threshold in quiet LTQ is Table A.6 (not A.3).
Reassign the a0/DDF/LTQ corrections to the core-loudness step (Tables
A.4-A.7) where they belong, update the Spanish labels, and align the ES
psychoacoustics alt text with the guide's own term "sonos" (was "sonios").
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.
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.
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.
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.
Spanish docs: UNE terminology, decimal commas, localized snippets and theory figures (#365)
* Normalize Spanish docs prose to UNE acoustic terminology
Sweep the Spanish pages for the non-UNE forms "presion sonora",
"potencia sonora" and "intensidad sonora" and normalize the prose to
the wording used by the official Spanish editions of the standards:
"presion acustica" (UNE-EN ISO 16283-2:2016, UNE-EN ISO 10052:2005,
UNE-EN ISO 3746:2011, UNE-ISO 226:2013), "potencia acustica"
(UNE-EN ISO 3746:2011, UNE-EN ISO 4871:2010, UNE-EN ISO 9614-1:2010),
"intensidad acustica" (UNE-EN 61043:1999, UNE-EN ISO 9614-1:2010) and
"nivel de presion acustica de impactos" (UNE-EN ISO 12354-2:2018,
UNE-EN ISO 717-2:2013). 92 replacements across 32 pages, prose only:
code snippets keep the labels they share with the generated figures.
Rename the intensity guide to "Intensidad acustica (p-p)" and the
structure-borne power guide to "Potencia acustica estructural de
equipos (EN 15657)", updating every cross-link text and the theory
anchor intensidad-sonora-iec-61043 accordingly. The API sidebar group
label becomes "Potencia acustica e intensidad" via api_taxonomy.py
with the generated sidebar regenerated.
* Use decimal commas in Spanish docs prose quantities
Sweep every Spanish page for decimal points leaking into prose numbers
and switch them to the comma the locale convention calls for: the
rotorcraft validation prose (fourteen tolerances such as 0,08 dB(A) and
0,5 s), the insulation-prediction worked example (53,6 dB / 53,8 dB),
the tone-audibility Annex E tone (137,3 Hz), the Mackenzie check value
(1550,744 m/s), the EPNL, loudness and absorption fiche descriptions
(98,3 EPNdB; 8,2 sonos and 70,4 fonios; 0,60 y 0,55), the junction
constants table and the third-octave band-edge table in the signal
analysis theory page. Code snippets, inline code, math, clause numbers
and quoted source text keep their points.
* Pass language="es" in Spanish figure-reproduction snippets
The <details> blocks under each localized figure in the Spanish guides
are meant to reproduce the _es variant shown on the page, but 82 of the
one-line result .plot() calls omitted the language="es" argument and
would render English axis labels instead. Add the argument across 33
guides, matching the pattern the intensity field-indicators snippet
already used. The three lab-insulation results whose plot() does not
take a language argument (lab airborne, lab impact and the
element-normalized intensity difference) are left as they were.
* Extend the UNE terminology sweep to sound absorption
Normalize "absorción sonora" to "absorción acústica" across the
Spanish pages (36 occurrences in 14 pages, including the EN 12354-6
guide title and the theory headings), the wording of UNE-EN ISO
3746:2011 and of the equivalent absorption area in UNE-EN ISO
10140-3:2011, UNE-EN ISO 12354-2:2018 and UNE-EN ISO 16283-2:2016, and
the same term the accredited report strings already use. Also restore
the accent in the theory index anchor to the renamed intensity heading,
since heading slugs keep accented characters.
* Theory pages: illustrate each section family with existing result figures
The seven theory pages carried no figures at all. Embed sixteen of the
existing generated figures (light and dark variants, Spanish variants on
the Spanish mirrors) where the concept matches the prose: weighting
curves, time integration and the p-p intensity estimator in the signal
analysis page; equal-loudness contours, the specific-loudness pattern
and the hearing-threshold panels in perception; NC/RC rating, the
Schroeder decay and the ISO 717-1 shifted reference in rooms and
buildings; the Lden profile, ISO 9613-1 absorption and the three sound
power routes in environment and transport; the scattering coefficient
and ISO 11654 rating in materials and surfaces; and the Wk weighting and
the resonator mobility triplet in vibration. Each embed reuses the alt
text of the guide that owns the figure and adds a one-line caption.
Also give the wave-simulation section hub the reading-order paragraph
its siblings already have, linking the closed-form pages the FDTD solver
cross-checks, in both languages.
* Address review findings from the Spanish locale sweeps
Second pass fixes flagged by review: five terminology occurrences the
line-based sweep missed because the noun and adjective were split by a
line wrap or emphasis markup (sound-power, rotorcraft-noise and two
section hubs); six Spanish pages that still embedded the English figure
variant although the _es variant exists (junction-transmission,
aircraft-noise airport contour, miso-coherence,
objective-intelligibility, psychoacoustic-annoyance twice); and 19 more
language="es" arguments on figure-reproduction plot calls the first
pass missed, chained-call receivers such as room.noise_criterion(spl)
.plot() and the axes-creating first call of the two-profile
atmospheric-refraction snippet among them. The lab-insulation plot
wrappers forward keyword arguments to the rating plot, so the three
calls excluded earlier now take the argument too. All Spanish python
fences re-checked to compile and EN/ES parity re-verified.
* Carry the UNE terminology into the generated-asset Spanish strings
Apply the same evidence-based decisions to every Spanish string source
that feeds generated assets: the translation tables of
generate_graphs.py and generate_diagrams.py, the _STRINGS tables of the
plot modules and the report i18n values. 35 strings change: "presión
acústica" (UNE-EN ISO 16283-2:2016, 10052:2005, 3746:2011),
"potencia acústica" (UNE-EN ISO 3746:2011, 4871:2010, 9614-1:2010),
"intensidad acústica" (UNE-EN 61043:1999, 9614-1:2010), "absorción
acústica" (UNE-EN ISO 3746:2011) and "nivel de presión acústica de
impactos" (UNE-EN ISO 12354-2:2018). Strings the UNE editions keep are
untouched: "emisión sonora", "exposición sonora", "campo sonoro",
"fuente sonora". Only Spanish values change; the English keys stay.
The two plot-i18n test assertions that pin the axis label follow, and
the eight Spanish doc fences that deliberately mirrored the old figure
labels now mirror the new ones.
* Regenerate the Spanish figure variants with the UNE terminology
make graphs after the string-source change: 48 files, all of them _es
or _es_dark variants (24 figure/diagram pairs), picking up "presión
acústica", "potencia acústica", "intensidad acústica", "absorción
acústica" and "nivel de presión acústica de impactos" in titles and
axis labels. The English variants are untouched. The committed example
fiches need no regeneration: every example in generate_reports.py
renders in English, so no changed Spanish report string reaches them.
* Align the intensity-fiche Spanish assertions with the UNE terminology
Spanish docs: UNE terminology, decimal commas, localized snippets and theory figures (#365)
* Normalize Spanish docs prose to UNE acoustic terminology
Sweep the Spanish pages for the non-UNE forms "presion sonora",
"potencia sonora" and "intensidad sonora" and normalize the prose to
the wording used by the official Spanish editions of the standards:
"presion acustica" (UNE-EN ISO 16283-2:2016, UNE-EN ISO 10052:2005,
UNE-EN ISO 3746:2011, UNE-ISO 226:2013), "potencia acustica"
(UNE-EN ISO 3746:2011, UNE-EN ISO 4871:2010, UNE-EN ISO 9614-1:2010),
"intensidad acustica" (UNE-EN 61043:1999, UNE-EN ISO 9614-1:2010) and
"nivel de presion acustica de impactos" (UNE-EN ISO 12354-2:2018,
UNE-EN ISO 717-2:2013). 92 replacements across 32 pages, prose only:
code snippets keep the labels they share with the generated figures.
Rename the intensity guide to "Intensidad acustica (p-p)" and the
structure-borne power guide to "Potencia acustica estructural de
equipos (EN 15657)", updating every cross-link text and the theory
anchor intensidad-sonora-iec-61043 accordingly. The API sidebar group
label becomes "Potencia acustica e intensidad" via api_taxonomy.py
with the generated sidebar regenerated.
* Use decimal commas in Spanish docs prose quantities
Sweep every Spanish page for decimal points leaking into prose numbers
and switch them to the comma the locale convention calls for: the
rotorcraft validation prose (fourteen tolerances such as 0,08 dB(A) and
0,5 s), the insulation-prediction worked example (53,6 dB / 53,8 dB),
the tone-audibility Annex E tone (137,3 Hz), the Mackenzie check value
(1550,744 m/s), the EPNL, loudness and absorption fiche descriptions
(98,3 EPNdB; 8,2 sonos and 70,4 fonios; 0,60 y 0,55), the junction
constants table and the third-octave band-edge table in the signal
analysis theory page. Code snippets, inline code, math, clause numbers
and quoted source text keep their points.
* Pass language="es" in Spanish figure-reproduction snippets
The <details> blocks under each localized figure in the Spanish guides
are meant to reproduce the _es variant shown on the page, but 82 of the
one-line result .plot() calls omitted the language="es" argument and
would render English axis labels instead. Add the argument across 33
guides, matching the pattern the intensity field-indicators snippet
already used. The three lab-insulation results whose plot() does not
take a language argument (lab airborne, lab impact and the
element-normalized intensity difference) are left as they were.
* Extend the UNE terminology sweep to sound absorption
Normalize "absorción sonora" to "absorción acústica" across the
Spanish pages (36 occurrences in 14 pages, including the EN 12354-6
guide title and the theory headings), the wording of UNE-EN ISO
3746:2011 and of the equivalent absorption area in UNE-EN ISO
10140-3:2011, UNE-EN ISO 12354-2:2018 and UNE-EN ISO 16283-2:2016, and
the same term the accredited report strings already use. Also restore
the accent in the theory index anchor to the renamed intensity heading,
since heading slugs keep accented characters.
* Theory pages: illustrate each section family with existing result figures
The seven theory pages carried no figures at all. Embed sixteen of the
existing generated figures (light and dark variants, Spanish variants on
the Spanish mirrors) where the concept matches the prose: weighting
curves, time integration and the p-p intensity estimator in the signal
analysis page; equal-loudness contours, the specific-loudness pattern
and the hearing-threshold panels in perception; NC/RC rating, the
Schroeder decay and the ISO 717-1 shifted reference in rooms and
buildings; the Lden profile, ISO 9613-1 absorption and the three sound
power routes in environment and transport; the scattering coefficient
and ISO 11654 rating in materials and surfaces; and the Wk weighting and
the resonator mobility triplet in vibration. Each embed reuses the alt
text of the guide that owns the figure and adds a one-line caption.
Also give the wave-simulation section hub the reading-order paragraph
its siblings already have, linking the closed-form pages the FDTD solver
cross-checks, in both languages.
* Address review findings from the Spanish locale sweeps
Second pass fixes flagged by review: five terminology occurrences the
line-based sweep missed because the noun and adjective were split by a
line wrap or emphasis markup (sound-power, rotorcraft-noise and two
section hubs); six Spanish pages that still embedded the English figure
variant although the _es variant exists (junction-transmission,
aircraft-noise airport contour, miso-coherence,
objective-intelligibility, psychoacoustic-annoyance twice); and 19 more
language="es" arguments on figure-reproduction plot calls the first
pass missed, chained-call receivers such as room.noise_criterion(spl)
.plot() and the axes-creating first call of the two-profile
atmospheric-refraction snippet among them. The lab-insulation plot
wrappers forward keyword arguments to the rating plot, so the three
calls excluded earlier now take the argument too. All Spanish python
fences re-checked to compile and EN/ES parity re-verified.
* Carry the UNE terminology into the generated-asset Spanish strings
Apply the same evidence-based decisions to every Spanish string source
that feeds generated assets: the translation tables of
generate_graphs.py and generate_diagrams.py, the _STRINGS tables of the
plot modules and the report i18n values. 35 strings change: "presión
acústica" (UNE-EN ISO 16283-2:2016, 10052:2005, 3746:2011),
"potencia acústica" (UNE-EN ISO 3746:2011, 4871:2010, 9614-1:2010),
"intensidad acústica" (UNE-EN 61043:1999, 9614-1:2010), "absorción
acústica" (UNE-EN ISO 3746:2011) and "nivel de presión acústica de
impactos" (UNE-EN ISO 12354-2:2018). Strings the UNE editions keep are
untouched: "emisión sonora", "exposición sonora", "campo sonoro",
"fuente sonora". Only Spanish values change; the English keys stay.
The two plot-i18n test assertions that pin the axis label follow, and
the eight Spanish doc fences that deliberately mirrored the old figure
labels now mirror the new ones.
* Regenerate the Spanish figure variants with the UNE terminology
make graphs after the string-source change: 48 files, all of them _es
or _es_dark variants (24 figure/diagram pairs), picking up "presión
acústica", "potencia acústica", "intensidad acústica", "absorción
acústica" and "nivel de presión acústica de impactos" in titles and
axis labels. The English variants are untouched. The committed example
fiches need no regeneration: every example in generate_reports.py
renders in English, so no changed Spanish report string reaches them.
* Align the intensity-fiche Spanish assertions with the UNE terminology
Building and structure-borne guides: result figures, plot mentions and mirror sync (#360)
* Add .plot() to the ISO 717 enlarged-range rating results
ExtendedWeightedRatingResult and ExtendedImpactRatingResult now carry the
full enlarged-range band curve (band_centers, measured) and expose a
.plot() that draws the measured curve over the whole range against the
shifted ISO 717 reference on the 16 core bands, with the unfavourable
deviations shaded, the enlarged-range bands marked and every covered
Annex B / A.2.1 adaptation term in the title. EN/ES labels follow the
existing renderer conventions.
* Field insulation guide: enlarged-range, field-chain, facade and survey-impact figures
Four new deterministic figures (extended_insulation_rating,
field_airborne_insulation, facade_field_insulation,
survey_impact_insulation) generated in the four language/theme variants,
embedded next to their snippets in the EN guide, the ES mirror and the
docs mirror with the dual usage/hand-written code blocks. One-line
.plot() mentions added for the extended rating, the field airborne
result, the survey impact result and the ISO 12999-1 band uncertainty.
The docs mirror gains the previously missing ISO 10052 survey-reports
section, and the survey snippet now defines the li and l1_2m inputs it
uses. Multi-line figure info boxes are translated as whole artists, and
the review fixes (headroom, legend placement, proper unit and Greek
glyphs) are applied to the new generators.
* Laboratory insulation guide: ISO 10140, ISO 15186-1 element and ISO 10848 Dn,f figures
Embed the new lab_insulation_result, intensity_element_insulation and
flanking_level_difference figures next to their snippets in the EN guide,
the ES mirror and the docs mirror, each with the dual usage/hand-written
code blocks. Add the one-line .plot() mentions for the laboratory
airborne result, the element-normalized intensity result and the
floor-covering improvement result, and a note on when Dn,f plots (the
inline example uses 9 bands, below the 16/5-band rating threshold).
* EN 12354 prediction guide: impact-term and radiated-power figures
Embed the new impact_prediction_terms and radiated_power_outdoor figures
next to their snippets in the EN guide, the ES mirror and the docs
mirror, with the dual usage/hand-written code blocks, and add the
one-line .plot() mentions for the airborne prediction, the impact
prediction, the facade prediction and the radiated-power result.
* Panel insulation guide: rated Sharp prediction figure and plot mentions
Embed the new single_panel_rating figure (the 6 mm glass Sharp prediction
rated per ISO 717-1, coincidence dip marked) in the EN guide, the ES
mirror and the docs mirror with the dual code blocks, and add the
one-line .plot() mentions for the single-panel, double-wall and
radiation-efficiency results next to the existing concept figure.
* Junction transmission guide: Kij design chart, EN 12354 worked example and see-also
Add the junction_kij_thickness figure (wave-approach Kij versus the plate
thickness ratio for the X, T and L junctions, identical-plates value
marked) next to the coupling-loss-factor section, a res.plot() mention
in its snippet, a worked example that feeds the predicted K12 = 9.8 dB
of the 100/200 mm concrete X-junction into the EN 12354-1 flanking model
(R'w = 55.4 dB, direct path dominant), and a See-also section linking
the prediction, laboratory, structure-borne power and mobility guides.
EN guide, ES mirror and docs mirror in sync.
* Junction transmission docs mirror: sync the Kij chart, worked example and see-also
* Structure-borne power and installed-source guides: plot mentions, Hopkins citation and see-also
Add the one-line .plot() mentions for the reception-plate power result
(EN 15657) and the installed-source prediction (EN 12354-5) next to their
existing figures, add the one-line .plot() usage to both figures' code
blocks, cite Hopkins (2007) Section 2.8 for the point-excited-plate power
input behind the clause 4.4.3 coupling term with a prose paragraph
connecting the mobility chain, and give the EN 12354-5 page a proper
See-also linking the EN 15657, ISO 7626, junction and EN 12354 guides.
EN guides, ES mirrors and docs mirrors in sync.
* Vibration FRF guides: plot mentions and transfer-stiffness docs sync
Add the one-line .plot() usage and mentions for the ISO/TS 7849
sound-power-from-vibration result, the EN 29052-1 dynamic-stiffness
result and the ISO 10846 indirect transfer-stiffness result next to
their existing figures (EN guides, ES mirrors and docs mirrors), and
port the previously missing ISO 10846 test-report fiche section to the
transfer-stiffness docs mirror.
* Mechanical mobility guide: driving-point reading figure
Embed the new mobility_result_lines figure (|Y(f)| of the SDOF bundle
with the stiffness line, the mass line and the 1/c damping peak) next to
the MobilityResult snippet in the EN guide, the ES mirror and the docs
mirror, with the dual usage/hand-written code blocks and the one-line
res.plot() mention.
* Human vibration and multiple-shock guides: one-line plot mentions
Add the res.plot() one-liners next to the existing figures for the
ISO 8041-1 weighting response, the ISO 2631-1 weighted band spectrum, the
Directive 2002/44/EC daily exposure A(8) and the ISO 2631-5 multiple-shock
assessment, in the EN guides, the ES mirrors and the docs mirrors.
* Docs mirrors: restore missing report-fiche and concept sections
Sync the docs mirrors of the pages touched by this wave with their site
guides: the ISO 16283-3 facade report subsection on the field insulation
page, the EN 29052-1 and ISO 7626 fiche example snippets, and the panel
concept-figure code block.
* Changelog, API docs and llms regeneration; lint and typing fixes for the figure generators
* Fix nested emphasis in the survey-impact figure captions
* Restore the numerical-propagation rasters truncated by a mid-regeneration snapshot
* Reconcile the figure-script additions with the rooms and materials wave
* docs: regenerate the llms bundle after the figure-script reconciliation
Building and structure-borne guides: result figures, plot mentions and mirror sync (#360)
* Add .plot() to the ISO 717 enlarged-range rating results
ExtendedWeightedRatingResult and ExtendedImpactRatingResult now carry the
full enlarged-range band curve (band_centers, measured) and expose a
.plot() that draws the measured curve over the whole range against the
shifted ISO 717 reference on the 16 core bands, with the unfavourable
deviations shaded, the enlarged-range bands marked and every covered
Annex B / A.2.1 adaptation term in the title. EN/ES labels follow the
existing renderer conventions.
* Field insulation guide: enlarged-range, field-chain, facade and survey-impact figures
Four new deterministic figures (extended_insulation_rating,
field_airborne_insulation, facade_field_insulation,
survey_impact_insulation) generated in the four language/theme variants,
embedded next to their snippets in the EN guide, the ES mirror and the
docs mirror with the dual usage/hand-written code blocks. One-line
.plot() mentions added for the extended rating, the field airborne
result, the survey impact result and the ISO 12999-1 band uncertainty.
The docs mirror gains the previously missing ISO 10052 survey-reports
section, and the survey snippet now defines the li and l1_2m inputs it
uses. Multi-line figure info boxes are translated as whole artists, and
the review fixes (headroom, legend placement, proper unit and Greek
glyphs) are applied to the new generators.
* Laboratory insulation guide: ISO 10140, ISO 15186-1 element and ISO 10848 Dn,f figures
Embed the new lab_insulation_result, intensity_element_insulation and
flanking_level_difference figures next to their snippets in the EN guide,
the ES mirror and the docs mirror, each with the dual usage/hand-written
code blocks. Add the one-line .plot() mentions for the laboratory
airborne result, the element-normalized intensity result and the
floor-covering improvement result, and a note on when Dn,f plots (the
inline example uses 9 bands, below the 16/5-band rating threshold).
* EN 12354 prediction guide: impact-term and radiated-power figures
Embed the new impact_prediction_terms and radiated_power_outdoor figures
next to their snippets in the EN guide, the ES mirror and the docs
mirror, with the dual usage/hand-written code blocks, and add the
one-line .plot() mentions for the airborne prediction, the impact
prediction, the facade prediction and the radiated-power result.
* Panel insulation guide: rated Sharp prediction figure and plot mentions
Embed the new single_panel_rating figure (the 6 mm glass Sharp prediction
rated per ISO 717-1, coincidence dip marked) in the EN guide, the ES
mirror and the docs mirror with the dual code blocks, and add the
one-line .plot() mentions for the single-panel, double-wall and
radiation-efficiency results next to the existing concept figure.
* Junction transmission guide: Kij design chart, EN 12354 worked example and see-also
Add the junction_kij_thickness figure (wave-approach Kij versus the plate
thickness ratio for the X, T and L junctions, identical-plates value
marked) next to the coupling-loss-factor section, a res.plot() mention
in its snippet, a worked example that feeds the predicted K12 = 9.8 dB
of the 100/200 mm concrete X-junction into the EN 12354-1 flanking model
(R'w = 55.4 dB, direct path dominant), and a See-also section linking
the prediction, laboratory, structure-borne power and mobility guides.
EN guide, ES mirror and docs mirror in sync.
* Junction transmission docs mirror: sync the Kij chart, worked example and see-also
* Structure-borne power and installed-source guides: plot mentions, Hopkins citation and see-also
Add the one-line .plot() mentions for the reception-plate power result
(EN 15657) and the installed-source prediction (EN 12354-5) next to their
existing figures, add the one-line .plot() usage to both figures' code
blocks, cite Hopkins (2007) Section 2.8 for the point-excited-plate power
input behind the clause 4.4.3 coupling term with a prose paragraph
connecting the mobility chain, and give the EN 12354-5 page a proper
See-also linking the EN 15657, ISO 7626, junction and EN 12354 guides.
EN guides, ES mirrors and docs mirrors in sync.
* Vibration FRF guides: plot mentions and transfer-stiffness docs sync
Add the one-line .plot() usage and mentions for the ISO/TS 7849
sound-power-from-vibration result, the EN 29052-1 dynamic-stiffness
result and the ISO 10846 indirect transfer-stiffness result next to
their existing figures (EN guides, ES mirrors and docs mirrors), and
port the previously missing ISO 10846 test-report fiche section to the
transfer-stiffness docs mirror.
* Mechanical mobility guide: driving-point reading figure
Embed the new mobility_result_lines figure (|Y(f)| of the SDOF bundle
with the stiffness line, the mass line and the 1/c damping peak) next to
the MobilityResult snippet in the EN guide, the ES mirror and the docs
mirror, with the dual usage/hand-written code blocks and the one-line
res.plot() mention.
* Human vibration and multiple-shock guides: one-line plot mentions
Add the res.plot() one-liners next to the existing figures for the
ISO 8041-1 weighting response, the ISO 2631-1 weighted band spectrum, the
Directive 2002/44/EC daily exposure A(8) and the ISO 2631-5 multiple-shock
assessment, in the EN guides, the ES mirrors and the docs mirrors.
* Docs mirrors: restore missing report-fiche and concept sections
Sync the docs mirrors of the pages touched by this wave with their site
guides: the ISO 16283-3 facade report subsection on the field insulation
page, the EN 29052-1 and ISO 7626 fiche example snippets, and the panel
concept-figure code block.
* Changelog, API docs and llms regeneration; lint and typing fixes for the figure generators
* Fix nested emphasis in the survey-impact figure captions
* Restore the numerical-propagation rasters truncated by a mid-regeneration snapshot
* Reconcile the figure-script additions with the rooms and materials wave
* docs: regenerate the llms bundle after the figure-script reconciliation
Building and structure-borne guides: result figures, plot mentions and mirror sync (#360)
* Add .plot() to the ISO 717 enlarged-range rating results
ExtendedWeightedRatingResult and ExtendedImpactRatingResult now carry the
full enlarged-range band curve (band_centers, measured) and expose a
.plot() that draws the measured curve over the whole range against the
shifted ISO 717 reference on the 16 core bands, with the unfavourable
deviations shaded, the enlarged-range bands marked and every covered
Annex B / A.2.1 adaptation term in the title. EN/ES labels follow the
existing renderer conventions.
* Field insulation guide: enlarged-range, field-chain, facade and survey-impact figures
Four new deterministic figures (extended_insulation_rating,
field_airborne_insulation, facade_field_insulation,
survey_impact_insulation) generated in the four language/theme variants,
embedded next to their snippets in the EN guide, the ES mirror and the
docs mirror with the dual usage/hand-written code blocks. One-line
.plot() mentions added for the extended rating, the field airborne
result, the survey impact result and the ISO 12999-1 band uncertainty.
The docs mirror gains the previously missing ISO 10052 survey-reports
section, and the survey snippet now defines the li and l1_2m inputs it
uses. Multi-line figure info boxes are translated as whole artists, and
the review fixes (headroom, legend placement, proper unit and Greek
glyphs) are applied to the new generators.
* Laboratory insulation guide: ISO 10140, ISO 15186-1 element and ISO 10848 Dn,f figures
Embed the new lab_insulation_result, intensity_element_insulation and
flanking_level_difference figures next to their snippets in the EN guide,
the ES mirror and the docs mirror, each with the dual usage/hand-written
code blocks. Add the one-line .plot() mentions for the laboratory
airborne result, the element-normalized intensity result and the
floor-covering improvement result, and a note on when Dn,f plots (the
inline example uses 9 bands, below the 16/5-band rating threshold).
* EN 12354 prediction guide: impact-term and radiated-power figures
Embed the new impact_prediction_terms and radiated_power_outdoor figures
next to their snippets in the EN guide, the ES mirror and the docs
mirror, with the dual usage/hand-written code blocks, and add the
one-line .plot() mentions for the airborne prediction, the impact
prediction, the facade prediction and the radiated-power result.
* Panel insulation guide: rated Sharp prediction figure and plot mentions
Embed the new single_panel_rating figure (the 6 mm glass Sharp prediction
rated per ISO 717-1, coincidence dip marked) in the EN guide, the ES
mirror and the docs mirror with the dual code blocks, and add the
one-line .plot() mentions for the single-panel, double-wall and
radiation-efficiency results next to the existing concept figure.
* Junction transmission guide: Kij design chart, EN 12354 worked example and see-also
Add the junction_kij_thickness figure (wave-approach Kij versus the plate
thickness ratio for the X, T and L junctions, identical-plates value
marked) next to the coupling-loss-factor section, a res.plot() mention
in its snippet, a worked example that feeds the predicted K12 = 9.8 dB
of the 100/200 mm concrete X-junction into the EN 12354-1 flanking model
(R'w = 55.4 dB, direct path dominant), and a See-also section linking
the prediction, laboratory, structure-borne power and mobility guides.
EN guide, ES mirror and docs mirror in sync.
* Junction transmission docs mirror: sync the Kij chart, worked example and see-also
* Structure-borne power and installed-source guides: plot mentions, Hopkins citation and see-also
Add the one-line .plot() mentions for the reception-plate power result
(EN 15657) and the installed-source prediction (EN 12354-5) next to their
existing figures, add the one-line .plot() usage to both figures' code
blocks, cite Hopkins (2007) Section 2.8 for the point-excited-plate power
input behind the clause 4.4.3 coupling term with a prose paragraph
connecting the mobility chain, and give the EN 12354-5 page a proper
See-also linking the EN 15657, ISO 7626, junction and EN 12354 guides.
EN guides, ES mirrors and docs mirrors in sync.
* Vibration FRF guides: plot mentions and transfer-stiffness docs sync
Add the one-line .plot() usage and mentions for the ISO/TS 7849
sound-power-from-vibration result, the EN 29052-1 dynamic-stiffness
result and the ISO 10846 indirect transfer-stiffness result next to
their existing figures (EN guides, ES mirrors and docs mirrors), and
port the previously missing ISO 10846 test-report fiche section to the
transfer-stiffness docs mirror.
* Mechanical mobility guide: driving-point reading figure
Embed the new mobility_result_lines figure (|Y(f)| of the SDOF bundle
with the stiffness line, the mass line and the 1/c damping peak) next to
the MobilityResult snippet in the EN guide, the ES mirror and the docs
mirror, with the dual usage/hand-written code blocks and the one-line
res.plot() mention.
* Human vibration and multiple-shock guides: one-line plot mentions
Add the res.plot() one-liners next to the existing figures for the
ISO 8041-1 weighting response, the ISO 2631-1 weighted band spectrum, the
Directive 2002/44/EC daily exposure A(8) and the ISO 2631-5 multiple-shock
assessment, in the EN guides, the ES mirrors and the docs mirrors.
* Docs mirrors: restore missing report-fiche and concept sections
Sync the docs mirrors of the pages touched by this wave with their site
guides: the ISO 16283-3 facade report subsection on the field insulation
page, the EN 29052-1 and ISO 7626 fiche example snippets, and the panel
concept-figure code block.
* Changelog, API docs and llms regeneration; lint and typing fixes for the figure generators
* Fix nested emphasis in the survey-impact figure captions
* Restore the numerical-propagation rasters truncated by a mid-regeneration snapshot
* Reconcile the figure-script additions with the rooms and materials wave
* docs: regenerate the llms bundle after the figure-script reconciliation
Building and structure-borne guides: result figures, plot mentions and mirror sync (#360)
* Add .plot() to the ISO 717 enlarged-range rating results
ExtendedWeightedRatingResult and ExtendedImpactRatingResult now carry the
full enlarged-range band curve (band_centers, measured) and expose a
.plot() that draws the measured curve over the whole range against the
shifted ISO 717 reference on the 16 core bands, with the unfavourable
deviations shaded, the enlarged-range bands marked and every covered
Annex B / A.2.1 adaptation term in the title. EN/ES labels follow the
existing renderer conventions.
* Field insulation guide: enlarged-range, field-chain, facade and survey-impact figures
Four new deterministic figures (extended_insulation_rating,
field_airborne_insulation, facade_field_insulation,
survey_impact_insulation) generated in the four language/theme variants,
embedded next to their snippets in the EN guide, the ES mirror and the
docs mirror with the dual usage/hand-written code blocks. One-line
.plot() mentions added for the extended rating, the field airborne
result, the survey impact result and the ISO 12999-1 band uncertainty.
The docs mirror gains the previously missing ISO 10052 survey-reports
section, and the survey snippet now defines the li and l1_2m inputs it
uses. Multi-line figure info boxes are translated as whole artists, and
the review fixes (headroom, legend placement, proper unit and Greek
glyphs) are applied to the new generators.
* Laboratory insulation guide: ISO 10140, ISO 15186-1 element and ISO 10848 Dn,f figures
Embed the new lab_insulation_result, intensity_element_insulation and
flanking_level_difference figures next to their snippets in the EN guide,
the ES mirror and the docs mirror, each with the dual usage/hand-written
code blocks. Add the one-line .plot() mentions for the laboratory
airborne result, the element-normalized intensity result and the
floor-covering improvement result, and a note on when Dn,f plots (the
inline example uses 9 bands, below the 16/5-band rating threshold).
* EN 12354 prediction guide: impact-term and radiated-power figures
Embed the new impact_prediction_terms and radiated_power_outdoor figures
next to their snippets in the EN guide, the ES mirror and the docs
mirror, with the dual usage/hand-written code blocks, and add the
one-line .plot() mentions for the airborne prediction, the impact
prediction, the facade prediction and the radiated-power result.
* Panel insulation guide: rated Sharp prediction figure and plot mentions
Embed the new single_panel_rating figure (the 6 mm glass Sharp prediction
rated per ISO 717-1, coincidence dip marked) in the EN guide, the ES
mirror and the docs mirror with the dual code blocks, and add the
one-line .plot() mentions for the single-panel, double-wall and
radiation-efficiency results next to the existing concept figure.
* Junction transmission guide: Kij design chart, EN 12354 worked example and see-also
Add the junction_kij_thickness figure (wave-approach Kij versus the plate
thickness ratio for the X, T and L junctions, identical-plates value
marked) next to the coupling-loss-factor section, a res.plot() mention
in its snippet, a worked example that feeds the predicted K12 = 9.8 dB
of the 100/200 mm concrete X-junction into the EN 12354-1 flanking model
(R'w = 55.4 dB, direct path dominant), and a See-also section linking
the prediction, laboratory, structure-borne power and mobility guides.
EN guide, ES mirror and docs mirror in sync.
* Junction transmission docs mirror: sync the Kij chart, worked example and see-also
* Structure-borne power and installed-source guides: plot mentions, Hopkins citation and see-also
Add the one-line .plot() mentions for the reception-plate power result
(EN 15657) and the installed-source prediction (EN 12354-5) next to their
existing figures, add the one-line .plot() usage to both figures' code
blocks, cite Hopkins (2007) Section 2.8 for the point-excited-plate power
input behind the clause 4.4.3 coupling term with a prose paragraph
connecting the mobility chain, and give the EN 12354-5 page a proper
See-also linking the EN 15657, ISO 7626, junction and EN 12354 guides.
EN guides, ES mirrors and docs mirrors in sync.
* Vibration FRF guides: plot mentions and transfer-stiffness docs sync
Add the one-line .plot() usage and mentions for the ISO/TS 7849
sound-power-from-vibration result, the EN 29052-1 dynamic-stiffness
result and the ISO 10846 indirect transfer-stiffness result next to
their existing figures (EN guides, ES mirrors and docs mirrors), and
port the previously missing ISO 10846 test-report fiche section to the
transfer-stiffness docs mirror.
* Mechanical mobility guide: driving-point reading figure
Embed the new mobility_result_lines figure (|Y(f)| of the SDOF bundle
with the stiffness line, the mass line and the 1/c damping peak) next to
the MobilityResult snippet in the EN guide, the ES mirror and the docs
mirror, with the dual usage/hand-written code blocks and the one-line
res.plot() mention.
* Human vibration and multiple-shock guides: one-line plot mentions
Add the res.plot() one-liners next to the existing figures for the
ISO 8041-1 weighting response, the ISO 2631-1 weighted band spectrum, the
Directive 2002/44/EC daily exposure A(8) and the ISO 2631-5 multiple-shock
assessment, in the EN guides, the ES mirrors and the docs mirrors.
* Docs mirrors: restore missing report-fiche and concept sections
Sync the docs mirrors of the pages touched by this wave with their site
guides: the ISO 16283-3 facade report subsection on the field insulation
page, the EN 29052-1 and ISO 7626 fiche example snippets, and the panel
concept-figure code block.
* Changelog, API docs and llms regeneration; lint and typing fixes for the figure generators
* Fix nested emphasis in the survey-impact figure captions
* Restore the numerical-propagation rasters truncated by a mid-regeneration snapshot
* Reconcile the figure-script additions with the rooms and materials wave
* docs: regenerate the llms bundle after the figure-script reconciliation
Building and structure-borne guides: result figures, plot mentions and mirror sync (#360)
* Add .plot() to the ISO 717 enlarged-range rating results
ExtendedWeightedRatingResult and ExtendedImpactRatingResult now carry the
full enlarged-range band curve (band_centers, measured) and expose a
.plot() that draws the measured curve over the whole range against the
shifted ISO 717 reference on the 16 core bands, with the unfavourable
deviations shaded, the enlarged-range bands marked and every covered
Annex B / A.2.1 adaptation term in the title. EN/ES labels follow the
existing renderer conventions.
* Field insulation guide: enlarged-range, field-chain, facade and survey-impact figures
Four new deterministic figures (extended_insulation_rating,
field_airborne_insulation, facade_field_insulation,
survey_impact_insulation) generated in the four language/theme variants,
embedded next to their snippets in the EN guide, the ES mirror and the
docs mirror with the dual usage/hand-written code blocks. One-line
.plot() mentions added for the extended rating, the field airborne
result, the survey impact result and the ISO 12999-1 band uncertainty.
The docs mirror gains the previously missing ISO 10052 survey-reports
section, and the survey snippet now defines the li and l1_2m inputs it
uses. Multi-line figure info boxes are translated as whole artists, and
the review fixes (headroom, legend placement, proper unit and Greek
glyphs) are applied to the new generators.
* Laboratory insulation guide: ISO 10140, ISO 15186-1 element and ISO 10848 Dn,f figures
Embed the new lab_insulation_result, intensity_element_insulation and
flanking_level_difference figures next to their snippets in the EN guide,
the ES mirror and the docs mirror, each with the dual usage/hand-written
code blocks. Add the one-line .plot() mentions for the laboratory
airborne result, the element-normalized intensity result and the
floor-covering improvement result, and a note on when Dn,f plots (the
inline example uses 9 bands, below the 16/5-band rating threshold).
* EN 12354 prediction guide: impact-term and radiated-power figures
Embed the new impact_prediction_terms and radiated_power_outdoor figures
next to their snippets in the EN guide, the ES mirror and the docs
mirror, with the dual usage/hand-written code blocks, and add the
one-line .plot() mentions for the airborne prediction, the impact
prediction, the facade prediction and the radiated-power result.
* Panel insulation guide: rated Sharp prediction figure and plot mentions
Embed the new single_panel_rating figure (the 6 mm glass Sharp prediction
rated per ISO 717-1, coincidence dip marked) in the EN guide, the ES
mirror and the docs mirror with the dual code blocks, and add the
one-line .plot() mentions for the single-panel, double-wall and
radiation-efficiency results next to the existing concept figure.
* Junction transmission guide: Kij design chart, EN 12354 worked example and see-also
Add the junction_kij_thickness figure (wave-approach Kij versus the plate
thickness ratio for the X, T and L junctions, identical-plates value
marked) next to the coupling-loss-factor section, a res.plot() mention
in its snippet, a worked example that feeds the predicted K12 = 9.8 dB
of the 100/200 mm concrete X-junction into the EN 12354-1 flanking model
(R'w = 55.4 dB, direct path dominant), and a See-also section linking
the prediction, laboratory, structure-borne power and mobility guides.
EN guide, ES mirror and docs mirror in sync.
* Junction transmission docs mirror: sync the Kij chart, worked example and see-also
* Structure-borne power and installed-source guides: plot mentions, Hopkins citation and see-also
Add the one-line .plot() mentions for the reception-plate power result
(EN 15657) and the installed-source prediction (EN 12354-5) next to their
existing figures, add the one-line .plot() usage to both figures' code
blocks, cite Hopkins (2007) Section 2.8 for the point-excited-plate power
input behind the clause 4.4.3 coupling term with a prose paragraph
connecting the mobility chain, and give the EN 12354-5 page a proper
See-also linking the EN 15657, ISO 7626, junction and EN 12354 guides.
EN guides, ES mirrors and docs mirrors in sync.
* Vibration FRF guides: plot mentions and transfer-stiffness docs sync
Add the one-line .plot() usage and mentions for the ISO/TS 7849
sound-power-from-vibration result, the EN 29052-1 dynamic-stiffness
result and the ISO 10846 indirect transfer-stiffness result next to
their existing figures (EN guides, ES mirrors and docs mirrors), and
port the previously missing ISO 10846 test-report fiche section to the
transfer-stiffness docs mirror.
* Mechanical mobility guide: driving-point reading figure
Embed the new mobility_result_lines figure (|Y(f)| of the SDOF bundle
with the stiffness line, the mass line and the 1/c damping peak) next to
the MobilityResult snippet in the EN guide, the ES mirror and the docs
mirror, with the dual usage/hand-written code blocks and the one-line
res.plot() mention.
* Human vibration and multiple-shock guides: one-line plot mentions
Add the res.plot() one-liners next to the existing figures for the
ISO 8041-1 weighting response, the ISO 2631-1 weighted band spectrum, the
Directive 2002/44/EC daily exposure A(8) and the ISO 2631-5 multiple-shock
assessment, in the EN guides, the ES mirrors and the docs mirrors.
* Docs mirrors: restore missing report-fiche and concept sections
Sync the docs mirrors of the pages touched by this wave with their site
guides: the ISO 16283-3 facade report subsection on the field insulation
page, the EN 29052-1 and ISO 7626 fiche example snippets, and the panel
concept-figure code block.
* Changelog, API docs and llms regeneration; lint and typing fixes for the figure generators
* Fix nested emphasis in the survey-impact figure captions
* Restore the numerical-propagation rasters truncated by a mid-regeneration snapshot
* Reconcile the figure-script additions with the rooms and materials wave
* docs: regenerate the llms bundle after the figure-script reconciliation
Building and structure-borne guides: result figures, plot mentions and mirror sync (#360)
* Add .plot() to the ISO 717 enlarged-range rating results
ExtendedWeightedRatingResult and ExtendedImpactRatingResult now carry the
full enlarged-range band curve (band_centers, measured) and expose a
.plot() that draws the measured curve over the whole range against the
shifted ISO 717 reference on the 16 core bands, with the unfavourable
deviations shaded, the enlarged-range bands marked and every covered
Annex B / A.2.1 adaptation term in the title. EN/ES labels follow the
existing renderer conventions.
* Field insulation guide: enlarged-range, field-chain, facade and survey-impact figures
Four new deterministic figures (extended_insulation_rating,
field_airborne_insulation, facade_field_insulation,
survey_impact_insulation) generated in the four language/theme variants,
embedded next to their snippets in the EN guide, the ES mirror and the
docs mirror with the dual usage/hand-written code blocks. One-line
.plot() mentions added for the extended rating, the field airborne
result, the survey impact result and the ISO 12999-1 band uncertainty.
The docs mirror gains the previously missing ISO 10052 survey-reports
section, and the survey snippet now defines the li and l1_2m inputs it
uses. Multi-line figure info boxes are translated as whole artists, and
the review fixes (headroom, legend placement, proper unit and Greek
glyphs) are applied to the new generators.
* Laboratory insulation guide: ISO 10140, ISO 15186-1 element and ISO 10848 Dn,f figures
Embed the new lab_insulation_result, intensity_element_insulation and
flanking_level_difference figures next to their snippets in the EN guide,
the ES mirror and the docs mirror, each with the dual usage/hand-written
code blocks. Add the one-line .plot() mentions for the laboratory
airborne result, the element-normalized intensity result and the
floor-covering improvement result, and a note on when Dn,f plots (the
inline example uses 9 bands, below the 16/5-band rating threshold).
* EN 12354 prediction guide: impact-term and radiated-power figures
Embed the new impact_prediction_terms and radiated_power_outdoor figures
next to their snippets in the EN guide, the ES mirror and the docs
mirror, with the dual usage/hand-written code blocks, and add the
one-line .plot() mentions for the airborne prediction, the impact
prediction, the facade prediction and the radiated-power result.
* Panel insulation guide: rated Sharp prediction figure and plot mentions
Embed the new single_panel_rating figure (the 6 mm glass Sharp prediction
rated per ISO 717-1, coincidence dip marked) in the EN guide, the ES
mirror and the docs mirror with the dual code blocks, and add the
one-line .plot() mentions for the single-panel, double-wall and
radiation-efficiency results next to the existing concept figure.
* Junction transmission guide: Kij design chart, EN 12354 worked example and see-also
Add the junction_kij_thickness figure (wave-approach Kij versus the plate
thickness ratio for the X, T and L junctions, identical-plates value
marked) next to the coupling-loss-factor section, a res.plot() mention
in its snippet, a worked example that feeds the predicted K12 = 9.8 dB
of the 100/200 mm concrete X-junction into the EN 12354-1 flanking model
(R'w = 55.4 dB, direct path dominant), and a See-also section linking
the prediction, laboratory, structure-borne power and mobility guides.
EN guide, ES mirror and docs mirror in sync.
* Junction transmission docs mirror: sync the Kij chart, worked example and see-also
* Structure-borne power and installed-source guides: plot mentions, Hopkins citation and see-also
Add the one-line .plot() mentions for the reception-plate power result
(EN 15657) and the installed-source prediction (EN 12354-5) next to their
existing figures, add the one-line .plot() usage to both figures' code
blocks, cite Hopkins (2007) Section 2.8 for the point-excited-plate power
input behind the clause 4.4.3 coupling term with a prose paragraph
connecting the mobility chain, and give the EN 12354-5 page a proper
See-also linking the EN 15657, ISO 7626, junction and EN 12354 guides.
EN guides, ES mirrors and docs mirrors in sync.
* Vibration FRF guides: plot mentions and transfer-stiffness docs sync
Add the one-line .plot() usage and mentions for the ISO/TS 7849
sound-power-from-vibration result, the EN 29052-1 dynamic-stiffness
result and the ISO 10846 indirect transfer-stiffness result next to
their existing figures (EN guides, ES mirrors and docs mirrors), and
port the previously missing ISO 10846 test-report fiche section to the
transfer-stiffness docs mirror.
* Mechanical mobility guide: driving-point reading figure
Embed the new mobility_result_lines figure (|Y(f)| of the SDOF bundle
with the stiffness line, the mass line and the 1/c damping peak) next to
the MobilityResult snippet in the EN guide, the ES mirror and the docs
mirror, with the dual usage/hand-written code blocks and the one-line
res.plot() mention.
* Human vibration and multiple-shock guides: one-line plot mentions
Add the res.plot() one-liners next to the existing figures for the
ISO 8041-1 weighting response, the ISO 2631-1 weighted band spectrum, the
Directive 2002/44/EC daily exposure A(8) and the ISO 2631-5 multiple-shock
assessment, in the EN guides, the ES mirrors and the docs mirrors.
* Docs mirrors: restore missing report-fiche and concept sections
Sync the docs mirrors of the pages touched by this wave with their site
guides: the ISO 16283-3 facade report subsection on the field insulation
page, the EN 29052-1 and ISO 7626 fiche example snippets, and the panel
concept-figure code block.
* Changelog, API docs and llms regeneration; lint and typing fixes for the figure generators
* Fix nested emphasis in the survey-impact figure captions
* Restore the numerical-propagation rasters truncated by a mid-regeneration snapshot
* Reconcile the figure-script additions with the rooms and materials wave
* docs: regenerate the llms bundle after the figure-script reconciliation
Building and structure-borne guides: result figures, plot mentions and mirror sync (#360)
* Add .plot() to the ISO 717 enlarged-range rating results
ExtendedWeightedRatingResult and ExtendedImpactRatingResult now carry the
full enlarged-range band curve (band_centers, measured) and expose a
.plot() that draws the measured curve over the whole range against the
shifted ISO 717 reference on the 16 core bands, with the unfavourable
deviations shaded, the enlarged-range bands marked and every covered
Annex B / A.2.1 adaptation term in the title. EN/ES labels follow the
existing renderer conventions.
* Field insulation guide: enlarged-range, field-chain, facade and survey-impact figures
Four new deterministic figures (extended_insulation_rating,
field_airborne_insulation, facade_field_insulation,
survey_impact_insulation) generated in the four language/theme variants,
embedded next to their snippets in the EN guide, the ES mirror and the
docs mirror with the dual usage/hand-written code blocks. One-line
.plot() mentions added for the extended rating, the field airborne
result, the survey impact result and the ISO 12999-1 band uncertainty.
The docs mirror gains the previously missing ISO 10052 survey-reports
section, and the survey snippet now defines the li and l1_2m inputs it
uses. Multi-line figure info boxes are translated as whole artists, and
the review fixes (headroom, legend placement, proper unit and Greek
glyphs) are applied to the new generators.
* Laboratory insulation guide: ISO 10140, ISO 15186-1 element and ISO 10848 Dn,f figures
Embed the new lab_insulation_result, intensity_element_insulation and
flanking_level_difference figures next to their snippets in the EN guide,
the ES mirror and the docs mirror, each with the dual usage/hand-written
code blocks. Add the one-line .plot() mentions for the laboratory
airborne result, the element-normalized intensity result and the
floor-covering improvement result, and a note on when Dn,f plots (the
inline example uses 9 bands, below the 16/5-band rating threshold).
* EN 12354 prediction guide: impact-term and radiated-power figures
Embed the new impact_prediction_terms and radiated_power_outdoor figures
next to their snippets in the EN guide, the ES mirror and the docs
mirror, with the dual usage/hand-written code blocks, and add the
one-line .plot() mentions for the airborne prediction, the impact
prediction, the facade prediction and the radiated-power result.
* Panel insulation guide: rated Sharp prediction figure and plot mentions
Embed the new single_panel_rating figure (the 6 mm glass Sharp prediction
rated per ISO 717-1, coincidence dip marked) in the EN guide, the ES
mirror and the docs mirror with the dual code blocks, and add the
one-line .plot() mentions for the single-panel, double-wall and
radiation-efficiency results next to the existing concept figure.
* Junction transmission guide: Kij design chart, EN 12354 worked example and see-also
Add the junction_kij_thickness figure (wave-approach Kij versus the plate
thickness ratio for the X, T and L junctions, identical-plates value
marked) next to the coupling-loss-factor section, a res.plot() mention
in its snippet, a worked example that feeds the predicted K12 = 9.8 dB
of the 100/200 mm concrete X-junction into the EN 12354-1 flanking model
(R'w = 55.4 dB, direct path dominant), and a See-also section linking
the prediction, laboratory, structure-borne power and mobility guides.
EN guide, ES mirror and docs mirror in sync.
* Junction transmission docs mirror: sync the Kij chart, worked example and see-also
* Structure-borne power and installed-source guides: plot mentions, Hopkins citation and see-also
Add the one-line .plot() mentions for the reception-plate power result
(EN 15657) and the installed-source prediction (EN 12354-5) next to their
existing figures, add the one-line .plot() usage to both figures' code
blocks, cite Hopkins (2007) Section 2.8 for the point-excited-plate power
input behind the clause 4.4.3 coupling term with a prose paragraph
connecting the mobility chain, and give the EN 12354-5 page a proper
See-also linking the EN 15657, ISO 7626, junction and EN 12354 guides.
EN guides, ES mirrors and docs mirrors in sync.
* Vibration FRF guides: plot mentions and transfer-stiffness docs sync
Add the one-line .plot() usage and mentions for the ISO/TS 7849
sound-power-from-vibration result, the EN 29052-1 dynamic-stiffness
result and the ISO 10846 indirect transfer-stiffness result next to
their existing figures (EN guides, ES mirrors and docs mirrors), and
port the previously missing ISO 10846 test-report fiche section to the
transfer-stiffness docs mirror.
* Mechanical mobility guide: driving-point reading figure
Embed the new mobility_result_lines figure (|Y(f)| of the SDOF bundle
with the stiffness line, the mass line and the 1/c damping peak) next to
the MobilityResult snippet in the EN guide, the ES mirror and the docs
mirror, with the dual usage/hand-written code blocks and the one-line
res.plot() mention.
* Human vibration and multiple-shock guides: one-line plot mentions
Add the res.plot() one-liners next to the existing figures for the
ISO 8041-1 weighting response, the ISO 2631-1 weighted band spectrum, the
Directive 2002/44/EC daily exposure A(8) and the ISO 2631-5 multiple-shock
assessment, in the EN guides, the ES mirrors and the docs mirrors.
* Docs mirrors: restore missing report-fiche and concept sections
Sync the docs mirrors of the pages touched by this wave with their site
guides: the ISO 16283-3 facade report subsection on the field insulation
page, the EN 29052-1 and ISO 7626 fiche example snippets, and the panel
concept-figure code block.
* Changelog, API docs and llms regeneration; lint and typing fixes for the figure generators
* Fix nested emphasis in the survey-impact figure captions
* Restore the numerical-propagation rasters truncated by a mid-regeneration snapshot
* Reconcile the figure-script additions with the rooms and materials wave
* docs: regenerate the llms bundle after the figure-script reconciliation
Building and structure-borne guides: result figures, plot mentions and mirror sync (#360)
* Add .plot() to the ISO 717 enlarged-range rating results
ExtendedWeightedRatingResult and ExtendedImpactRatingResult now carry the
full enlarged-range band curve (band_centers, measured) and expose a
.plot() that draws the measured curve over the whole range against the
shifted ISO 717 reference on the 16 core bands, with the unfavourable
deviations shaded, the enlarged-range bands marked and every covered
Annex B / A.2.1 adaptation term in the title. EN/ES labels follow the
existing renderer conventions.
* Field insulation guide: enlarged-range, field-chain, facade and survey-impact figures
Four new deterministic figures (extended_insulation_rating,
field_airborne_insulation, facade_field_insulation,
survey_impact_insulation) generated in the four language/theme variants,
embedded next to their snippets in the EN guide, the ES mirror and the
docs mirror with the dual usage/hand-written code blocks. One-line
.plot() mentions added for the extended rating, the field airborne
result, the survey impact result and the ISO 12999-1 band uncertainty.
The docs mirror gains the previously missing ISO 10052 survey-reports
section, and the survey snippet now defines the li and l1_2m inputs it
uses. Multi-line figure info boxes are translated as whole artists, and
the review fixes (headroom, legend placement, proper unit and Greek
glyphs) are applied to the new generators.
* Laboratory insulation guide: ISO 10140, ISO 15186-1 element and ISO 10848 Dn,f figures
Embed the new lab_insulation_result, intensity_element_insulation and
flanking_level_difference figures next to their snippets in the EN guide,
the ES mirror and the docs mirror, each with the dual usage/hand-written
code blocks. Add the one-line .plot() mentions for the laboratory
airborne result, the element-normalized intensity result and the
floor-covering improvement result, and a note on when Dn,f plots (the
inline example uses 9 bands, below the 16/5-band rating threshold).
* EN 12354 prediction guide: impact-term and radiated-power figures
Embed the new impact_prediction_terms and radiated_power_outdoor figures
next to their snippets in the EN guide, the ES mirror and the docs
mirror, with the dual usage/hand-written code blocks, and add the
one-line .plot() mentions for the airborne prediction, the impact
prediction, the facade prediction and the radiated-power result.
* Panel insulation guide: rated Sharp prediction figure and plot mentions
Embed the new single_panel_rating figure (the 6 mm glass Sharp prediction
rated per ISO 717-1, coincidence dip marked) in the EN guide, the ES
mirror and the docs mirror with the dual code blocks, and add the
one-line .plot() mentions for the single-panel, double-wall and
radiation-efficiency results next to the existing concept figure.
* Junction transmission guide: Kij design chart, EN 12354 worked example and see-also
Add the junction_kij_thickness figure (wave-approach Kij versus the plate
thickness ratio for the X, T and L junctions, identical-plates value
marked) next to the coupling-loss-factor section, a res.plot() mention
in its snippet, a worked example that feeds the predicted K12 = 9.8 dB
of the 100/200 mm concrete X-junction into the EN 12354-1 flanking model
(R'w = 55.4 dB, direct path dominant), and a See-also section linking
the prediction, laboratory, structure-borne power and mobility guides.
EN guide, ES mirror and docs mirror in sync.
* Junction transmission docs mirror: sync the Kij chart, worked example and see-also
* Structure-borne power and installed-source guides: plot mentions, Hopkins citation and see-also
Add the one-line .plot() mentions for the reception-plate power result
(EN 15657) and the installed-source prediction (EN 12354-5) next to their
existing figures, add the one-line .plot() usage to both figures' code
blocks, cite Hopkins (2007) Section 2.8 for the point-excited-plate power
input behind the clause 4.4.3 coupling term with a prose paragraph
connecting the mobility chain, and give the EN 12354-5 page a proper
See-also linking the EN 15657, ISO 7626, junction and EN 12354 guides.
EN guides, ES mirrors and docs mirrors in sync.
* Vibration FRF guides: plot mentions and transfer-stiffness docs sync
Add the one-line .plot() usage and mentions for the ISO/TS 7849
sound-power-from-vibration result, the EN 29052-1 dynamic-stiffness
result and the ISO 10846 indirect transfer-stiffness result next to
their existing figures (EN guides, ES mirrors and docs mirrors), and
port the previously missing ISO 10846 test-report fiche section to the
transfer-stiffness docs mirror.
* Mechanical mobility guide: driving-point reading figure
Embed the new mobility_result_lines figure (|Y(f)| of the SDOF bundle
with the stiffness line, the mass line and the 1/c damping peak) next to
the MobilityResult snippet in the EN guide, the ES mirror and the docs
mirror, with the dual usage/hand-written code blocks and the one-line
res.plot() mention.
* Human vibration and multiple-shock guides: one-line plot mentions
Add the res.plot() one-liners next to the existing figures for the
ISO 8041-1 weighting response, the ISO 2631-1 weighted band spectrum, the
Directive 2002/44/EC daily exposure A(8) and the ISO 2631-5 multiple-shock
assessment, in the EN guides, the ES mirrors and the docs mirrors.
* Docs mirrors: restore missing report-fiche and concept sections
Sync the docs mirrors of the pages touched by this wave with their site
guides: the ISO 16283-3 facade report subsection on the field insulation
page, the EN 29052-1 and ISO 7626 fiche example snippets, and the panel
concept-figure code block.
* Changelog, API docs and llms regeneration; lint and typing fixes for the figure generators
* Fix nested emphasis in the survey-impact figure captions
* Restore the numerical-propagation rasters truncated by a mid-regeneration snapshot
* Reconcile the figure-script additions with the rooms and materials wave
* docs: regenerate the llms bundle after the figure-script reconciliation
Building and structure-borne guides: result figures, plot mentions and mirror sync (#360)
* Add .plot() to the ISO 717 enlarged-range rating results
ExtendedWeightedRatingResult and ExtendedImpactRatingResult now carry the
full enlarged-range band curve (band_centers, measured) and expose a
.plot() that draws the measured curve over the whole range against the
shifted ISO 717 reference on the 16 core bands, with the unfavourable
deviations shaded, the enlarged-range bands marked and every covered
Annex B / A.2.1 adaptation term in the title. EN/ES labels follow the
existing renderer conventions.
* Field insulation guide: enlarged-range, field-chain, facade and survey-impact figures
Four new deterministic figures (extended_insulation_rating,
field_airborne_insulation, facade_field_insulation,
survey_impact_insulation) generated in the four language/theme variants,
embedded next to their snippets in the EN guide, the ES mirror and the
docs mirror with the dual usage/hand-written code blocks. One-line
.plot() mentions added for the extended rating, the field airborne
result, the survey impact result and the ISO 12999-1 band uncertainty.
The docs mirror gains the previously missing ISO 10052 survey-reports
section, and the survey snippet now defines the li and l1_2m inputs it
uses. Multi-line figure info boxes are translated as whole artists, and
the review fixes (headroom, legend placement, proper unit and Greek
glyphs) are applied to the new generators.
* Laboratory insulation guide: ISO 10140, ISO 15186-1 element and ISO 10848 Dn,f figures
Embed the new lab_insulation_result, intensity_element_insulation and
flanking_level_difference figures next to their snippets in the EN guide,
the ES mirror and the docs mirror, each with the dual usage/hand-written
code blocks. Add the one-line .plot() mentions for the laboratory
airborne result, the element-normalized intensity result and the
floor-covering improvement result, and a note on when Dn,f plots (the
inline example uses 9 bands, below the 16/5-band rating threshold).
* EN 12354 prediction guide: impact-term and radiated-power figures
Embed the new impact_prediction_terms and radiated_power_outdoor figures
next to their snippets in the EN guide, the ES mirror and the docs
mirror, with the dual usage/hand-written code blocks, and add the
one-line .plot() mentions for the airborne prediction, the impact
prediction, the facade prediction and the radiated-power result.
* Panel insulation guide: rated Sharp prediction figure and plot mentions
Embed the new single_panel_rating figure (the 6 mm glass Sharp prediction
rated per ISO 717-1, coincidence dip marked) in the EN guide, the ES
mirror and the docs mirror with the dual code blocks, and add the
one-line .plot() mentions for the single-panel, double-wall and
radiation-efficiency results next to the existing concept figure.
* Junction transmission guide: Kij design chart, EN 12354 worked example and see-also
Add the junction_kij_thickness figure (wave-approach Kij versus the plate
thickness ratio for the X, T and L junctions, identical-plates value
marked) next to the coupling-loss-factor section, a res.plot() mention
in its snippet, a worked example that feeds the predicted K12 = 9.8 dB
of the 100/200 mm concrete X-junction into the EN 12354-1 flanking model
(R'w = 55.4 dB, direct path dominant), and a See-also section linking
the prediction, laboratory, structure-borne power and mobility guides.
EN guide, ES mirror and docs mirror in sync.
* Junction transmission docs mirror: sync the Kij chart, worked example and see-also
* Structure-borne power and installed-source guides: plot mentions, Hopkins citation and see-also
Add the one-line .plot() mentions for the reception-plate power result
(EN 15657) and the installed-source prediction (EN 12354-5) next to their
existing figures, add the one-line .plot() usage to both figures' code
blocks, cite Hopkins (2007) Section 2.8 for the point-excited-plate power
input behind the clause 4.4.3 coupling term with a prose paragraph
connecting the mobility chain, and give the EN 12354-5 page a proper
See-also linking the EN 15657, ISO 7626, junction and EN 12354 guides.
EN guides, ES mirrors and docs mirrors in sync.
* Vibration FRF guides: plot mentions and transfer-stiffness docs sync
Add the one-line .plot() usage and mentions for the ISO/TS 7849
sound-power-from-vibration result, the EN 29052-1 dynamic-stiffness
result and the ISO 10846 indirect transfer-stiffness result next to
their existing figures (EN guides, ES mirrors and docs mirrors), and
port the previously missing ISO 10846 test-report fiche section to the
transfer-stiffness docs mirror.
* Mechanical mobility guide: driving-point reading figure
Embed the new mobility_result_lines figure (|Y(f)| of the SDOF bundle
with the stiffness line, the mass line and the 1/c damping peak) next to
the MobilityResult snippet in the EN guide, the ES mirror and the docs
mirror, with the dual usage/hand-written code blocks and the one-line
res.plot() mention.
* Human vibration and multiple-shock guides: one-line plot mentions
Add the res.plot() one-liners next to the existing figures for the
ISO 8041-1 weighting response, the ISO 2631-1 weighted band spectrum, the
Directive 2002/44/EC daily exposure A(8) and the ISO 2631-5 multiple-shock
assessment, in the EN guides, the ES mirrors and the docs mirrors.
* Docs mirrors: restore missing report-fiche and concept sections
Sync the docs mirrors of the pages touched by this wave with their site
guides: the ISO 16283-3 facade report subsection on the field insulation
page, the EN 29052-1 and ISO 7626 fiche example snippets, and the panel
concept-figure code block.
* Changelog, API docs and llms regeneration; lint and typing fixes for the figure generators
* Fix nested emphasis in the survey-impact figure captions
* Restore the numerical-propagation rasters truncated by a mid-regeneration snapshot
* Reconcile the figure-script additions with the rooms and materials wave
* docs: regenerate the llms bundle after the figure-script reconciliation
Building and structure-borne guides: result figures, plot mentions and mirror sync (#360)
* Add .plot() to the ISO 717 enlarged-range rating results
ExtendedWeightedRatingResult and ExtendedImpactRatingResult now carry the
full enlarged-range band curve (band_centers, measured) and expose a
.plot() that draws the measured curve over the whole range against the
shifted ISO 717 reference on the 16 core bands, with the unfavourable
deviations shaded, the enlarged-range bands marked and every covered
Annex B / A.2.1 adaptation term in the title. EN/ES labels follow the
existing renderer conventions.
* Field insulation guide: enlarged-range, field-chain, facade and survey-impact figures
Four new deterministic figures (extended_insulation_rating,
field_airborne_insulation, facade_field_insulation,
survey_impact_insulation) generated in the four language/theme variants,
embedded next to their snippets in the EN guide, the ES mirror and the
docs mirror with the dual usage/hand-written code blocks. One-line
.plot() mentions added for the extended rating, the field airborne
result, the survey impact result and the ISO 12999-1 band uncertainty.
The docs mirror gains the previously missing ISO 10052 survey-reports
section, and the survey snippet now defines the li and l1_2m inputs it
uses. Multi-line figure info boxes are translated as whole artists, and
the review fixes (headroom, legend placement, proper unit and Greek
glyphs) are applied to the new generators.
* Laboratory insulation guide: ISO 10140, ISO 15186-1 element and ISO 10848 Dn,f figures
Embed the new lab_insulation_result, intensity_element_insulation and
flanking_level_difference figures next to their snippets in the EN guide,
the ES mirror and the docs mirror, each with the dual usage/hand-written
code blocks. Add the one-line .plot() mentions for the laboratory
airborne result, the element-normalized intensity result and the
floor-covering improvement result, and a note on when Dn,f plots (the
inline example uses 9 bands, below the 16/5-band rating threshold).
* EN 12354 prediction guide: impact-term and radiated-power figures
Embed the new impact_prediction_terms and radiated_power_outdoor figures
next to their snippets in the EN guide, the ES mirror and the docs
mirror, with the dual usage/hand-written code blocks, and add the
one-line .plot() mentions for the airborne prediction, the impact
prediction, the facade prediction and the radiated-power result.
* Panel insulation guide: rated Sharp prediction figure and plot mentions
Embed the new single_panel_rating figure (the 6 mm glass Sharp prediction
rated per ISO 717-1, coincidence dip marked) in the EN guide, the ES
mirror and the docs mirror with the dual code blocks, and add the
one-line .plot() mentions for the single-panel, double-wall and
radiation-efficiency results next to the existing concept figure.
* Junction transmission guide: Kij design chart, EN 12354 worked example and see-also
Add the junction_kij_thickness figure (wave-approach Kij versus the plate
thickness ratio for the X, T and L junctions, identical-plates value
marked) next to the coupling-loss-factor section, a res.plot() mention
in its snippet, a worked example that feeds the predicted K12 = 9.8 dB
of the 100/200 mm concrete X-junction into the EN 12354-1 flanking model
(R'w = 55.4 dB, direct path dominant), and a See-also section linking
the prediction, laboratory, structure-borne power and mobility guides.
EN guide, ES mirror and docs mirror in sync.
* Junction transmission docs mirror: sync the Kij chart, worked example and see-also
* Structure-borne power and installed-source guides: plot mentions, Hopkins citation and see-also
Add the one-line .plot() mentions for the reception-plate power result
(EN 15657) and the installed-source prediction (EN 12354-5) next to their
existing figures, add the one-line .plot() usage to both figures' code
blocks, cite Hopkins (2007) Section 2.8 for the point-excited-plate power
input behind the clause 4.4.3 coupling term with a prose paragraph
connecting the mobility chain, and give the EN 12354-5 page a proper
See-also linking the EN 15657, ISO 7626, junction and EN 12354 guides.
EN guides, ES mirrors and docs mirrors in sync.
* Vibration FRF guides: plot mentions and transfer-stiffness docs sync
Add the one-line .plot() usage and mentions for the ISO/TS 7849
sound-power-from-vibration result, the EN 29052-1 dynamic-stiffness
result and the ISO 10846 indirect transfer-stiffness result next to
their existing figures (EN guides, ES mirrors and docs mirrors), and
port the previously missing ISO 10846 test-report fiche section to the
transfer-stiffness docs mirror.
* Mechanical mobility guide: driving-point reading figure
Embed the new mobility_result_lines figure (|Y(f)| of the SDOF bundle
with the stiffness line, the mass line and the 1/c damping peak) next to
the MobilityResult snippet in the EN guide, the ES mirror and the docs
mirror, with the dual usage/hand-written code blocks and the one-line
res.plot() mention.
* Human vibration and multiple-shock guides: one-line plot mentions
Add the res.plot() one-liners next to the existing figures for the
ISO 8041-1 weighting response, the ISO 2631-1 weighted band spectrum, the
Directive 2002/44/EC daily exposure A(8) and the ISO 2631-5 multiple-shock
assessment, in the EN guides, the ES mirrors and the docs mirrors.
* Docs mirrors: restore missing report-fiche and concept sections
Sync the docs mirrors of the pages touched by this wave with their site
guides: the ISO 16283-3 facade report subsection on the field insulation
page, the EN 29052-1 and ISO 7626 fiche example snippets, and the panel
concept-figure code block.
* Changelog, API docs and llms regeneration; lint and typing fixes for the figure generators
* Fix nested emphasis in the survey-impact figure captions
* Restore the numerical-propagation rasters truncated by a mid-regeneration snapshot
* Reconcile the figure-script additions with the rooms and materials wave
* docs: regenerate the llms bundle after the figure-script reconciliation
Building and structure-borne guides: result figures, plot mentions and mirror sync (#360)
* Add .plot() to the ISO 717 enlarged-range rating results
ExtendedWeightedRatingResult and ExtendedImpactRatingResult now carry the
full enlarged-range band curve (band_centers, measured) and expose a
.plot() that draws the measured curve over the whole range against the
shifted ISO 717 reference on the 16 core bands, with the unfavourable
deviations shaded, the enlarged-range bands marked and every covered
Annex B / A.2.1 adaptation term in the title. EN/ES labels follow the
existing renderer conventions.
* Field insulation guide: enlarged-range, field-chain, facade and survey-impact figures
Four new deterministic figures (extended_insulation_rating,
field_airborne_insulation, facade_field_insulation,
survey_impact_insulation) generated in the four language/theme variants,
embedded next to their snippets in the EN guide, the ES mirror and the
docs mirror with the dual usage/hand-written code blocks. One-line
.plot() mentions added for the extended rating, the field airborne
result, the survey impact result and the ISO 12999-1 band uncertainty.
The docs mirror gains the previously missing ISO 10052 survey-reports
section, and the survey snippet now defines the li and l1_2m inputs it
uses. Multi-line figure info boxes are translated as whole artists, and
the review fixes (headroom, legend placement, proper unit and Greek
glyphs) are applied to the new generators.
* Laboratory insulation guide: ISO 10140, ISO 15186-1 element and ISO 10848 Dn,f figures
Embed the new lab_insulation_result, intensity_element_insulation and
flanking_level_difference figures next to their snippets in the EN guide,
the ES mirror and the docs mirror, each with the dual usage/hand-written
code blocks. Add the one-line .plot() mentions for the laboratory
airborne result, the element-normalized intensity result and the
floor-covering improvement result, and a note on when Dn,f plots (the
inline example uses 9 bands, below the 16/5-band rating threshold).
* EN 12354 prediction guide: impact-term and radiated-power figures
Embed the new impact_prediction_terms and radiated_power_outdoor figures
next to their snippets in the EN guide, the ES mirror and the docs
mirror, with the dual usage/hand-written code blocks, and add the
one-line .plot() mentions for the airborne prediction, the impact
prediction, the facade prediction and the radiated-power result.
* Panel insulation guide: rated Sharp prediction figure and plot mentions
Embed the new single_panel_rating figure (the 6 mm glass Sharp prediction
rated per ISO 717-1, coincidence dip marked) in the EN guide, the ES
mirror and the docs mirror with the dual code blocks, and add the
one-line .plot() mentions for the single-panel, double-wall and
radiation-efficiency results next to the existing concept figure.
* Junction transmission guide: Kij design chart, EN 12354 worked example and see-also
Add the junction_kij_thickness figure (wave-approach Kij versus the plate
thickness ratio for the X, T and L junctions, identical-plates value
marked) next to the coupling-loss-factor section, a res.plot() mention
in its snippet, a worked example that feeds the predicted K12 = 9.8 dB
of the 100/200 mm concrete X-junction into the EN 12354-1 flanking model
(R'w = 55.4 dB, direct path dominant), and a See-also section linking
the prediction, laboratory, structure-borne power and mobility guides.
EN guide, ES mirror and docs mirror in sync.
* Junction transmission docs mirror: sync the Kij chart, worked example and see-also
* Structure-borne power and installed-source guides: plot mentions, Hopkins citation and see-also
Add the one-line .plot() mentions for the reception-plate power result
(EN 15657) and the installed-source prediction (EN 12354-5) next to their
existing figures, add the one-line .plot() usage to both figures' code
blocks, cite Hopkins (2007) Section 2.8 for the point-excited-plate power
input behind the clause 4.4.3 coupling term with a prose paragraph
connecting the mobility chain, and give the EN 12354-5 page a proper
See-also linking the EN 15657, ISO 7626, junction and EN 12354 guides.
EN guides, ES mirrors and docs mirrors in sync.
* Vibration FRF guides: plot mentions and transfer-stiffness docs sync
Add the one-line .plot() usage and mentions for the ISO/TS 7849
sound-power-from-vibration result, the EN 29052-1 dynamic-stiffness
result and the ISO 10846 indirect transfer-stiffness result next to
their existing figures (EN guides, ES mirrors and docs mirrors), and
port the previously missing ISO 10846 test-report fiche section to the
transfer-stiffness docs mirror.
* Mechanical mobility guide: driving-point reading figure
Embed the new mobility_result_lines figure (|Y(f)| of the SDOF bundle
with the stiffness line, the mass line and the 1/c damping peak) next to
the MobilityResult snippet in the EN guide, the ES mirror and the docs
mirror, with the dual usage/hand-written code blocks and the one-line
res.plot() mention.
* Human vibration and multiple-shock guides: one-line plot mentions
Add the res.plot() one-liners next to the existing figures for the
ISO 8041-1 weighting response, the ISO 2631-1 weighted band spectrum, the
Directive 2002/44/EC daily exposure A(8) and the ISO 2631-5 multiple-shock
assessment, in the EN guides, the ES mirrors and the docs mirrors.
* Docs mirrors: restore missing report-fiche and concept sections
Sync the docs mirrors of the pages touched by this wave with their site
guides: the ISO 16283-3 facade report subsection on the field insulation
page, the EN 29052-1 and ISO 7626 fiche example snippets, and the panel
concept-figure code block.
* Changelog, API docs and llms regeneration; lint and typing fixes for the figure generators
* Fix nested emphasis in the survey-impact figure captions
* Restore the numerical-propagation rasters truncated by a mid-regeneration snapshot
* Reconcile the figure-script additions with the rooms and materials wave
* docs: regenerate the llms bundle after the figure-script reconciliation
Building and structure-borne guides: result figures, plot mentions and mirror sync (#360)
* Add .plot() to the ISO 717 enlarged-range rating results
ExtendedWeightedRatingResult and ExtendedImpactRatingResult now carry the
full enlarged-range band curve (band_centers, measured) and expose a
.plot() that draws the measured curve over the whole range against the
shifted ISO 717 reference on the 16 core bands, with the unfavourable
deviations shaded, the enlarged-range bands marked and every covered
Annex B / A.2.1 adaptation term in the title. EN/ES labels follow the
existing renderer conventions.
* Field insulation guide: enlarged-range, field-chain, facade and survey-impact figures
Four new deterministic figures (extended_insulation_rating,
field_airborne_insulation, facade_field_insulation,
survey_impact_insulation) generated in the four language/theme variants,
embedded next to their snippets in the EN guide, the ES mirror and the
docs mirror with the dual usage/hand-written code blocks. One-line
.plot() mentions added for the extended rating, the field airborne
result, the survey impact result and the ISO 12999-1 band uncertainty.
The docs mirror gains the previously missing ISO 10052 survey-reports
section, and the survey snippet now defines the li and l1_2m inputs it
uses. Multi-line figure info boxes are translated as whole artists, and
the review fixes (headroom, legend placement, proper unit and Greek
glyphs) are applied to the new generators.
* Laboratory insulation guide: ISO 10140, ISO 15186-1 element and ISO 10848 Dn,f figures
Embed the new lab_insulation_result, intensity_element_insulation and
flanking_level_difference figures next to their snippets in the EN guide,
the ES mirror and the docs mirror, each with the dual usage/hand-written
code blocks. Add the one-line .plot() mentions for the laboratory
airborne result, the element-normalized intensity result and the
floor-covering improvement result, and a note on when Dn,f plots (the
inline example uses 9 bands, below the 16/5-band rating threshold).
* EN 12354 prediction guide: impact-term and radiated-power figures
Embed the new impact_prediction_terms and radiated_power_outdoor figures
next to their snippets in the EN guide, the ES mirror and the docs
mirror, with the dual usage/hand-written code blocks, and add the
one-line .plot() mentions for the airborne prediction, the impact
prediction, the facade prediction and the radiated-power result.
* Panel insulation guide: rated Sharp prediction figure and plot mentions
Embed the new single_panel_rating figure (the 6 mm glass Sharp prediction
rated per ISO 717-1, coincidence dip marked) in the EN guide, the ES
mirror and the docs mirror with the dual code blocks, and add the
one-line .plot() mentions for the single-panel, double-wall and
radiation-efficiency results next to the existing concept figure.
* Junction transmission guide: Kij design chart, EN 12354 worked example and see-also
Add the junction_kij_thickness figure (wave-approach Kij versus the plate
thickness ratio for the X, T and L junctions, identical-plates value
marked) next to the coupling-loss-factor section, a res.plot() mention
in its snippet, a worked example that feeds the predicted K12 = 9.8 dB
of the 100/200 mm concrete X-junction into the EN 12354-1 flanking model
(R'w = 55.4 dB, direct path dominant), and a See-also section linking
the prediction, laboratory, structure-borne power and mobility guides.
EN guide, ES mirror and docs mirror in sync.
* Junction transmission docs mirror: sync the Kij chart, worked example and see-also
* Structure-borne power and installed-source guides: plot mentions, Hopkins citation and see-also
Add the one-line .plot() mentions for the reception-plate power result
(EN 15657) and the installed-source prediction (EN 12354-5) next to their
existing figures, add the one-line .plot() usage to both figures' code
blocks, cite Hopkins (2007) Section 2.8 for the point-excited-plate power
input behind the clause 4.4.3 coupling term with a prose paragraph
connecting the mobility chain, and give the EN 12354-5 page a proper
See-also linking the EN 15657, ISO 7626, junction and EN 12354 guides.
EN guides, ES mirrors and docs mirrors in sync.
* Vibration FRF guides: plot mentions and transfer-stiffness docs sync
Add the one-line .plot() usage and mentions for the ISO/TS 7849
sound-power-from-vibration result, the EN 29052-1 dynamic-stiffness
result and the ISO 10846 indirect transfer-stiffness result next to
their existing figures (EN guides, ES mirrors and docs mirrors), and
port the previously missing ISO 10846 test-report fiche section to the
transfer-stiffness docs mirror.
* Mechanical mobility guide: driving-point reading figure
Embed the new mobility_result_lines figure (|Y(f)| of the SDOF bundle
with the stiffness line, the mass line and the 1/c damping peak) next to
the MobilityResult snippet in the EN guide, the ES mirror and the docs
mirror, with the dual usage/hand-written code blocks and the one-line
res.plot() mention.
* Human vibration and multiple-shock guides: one-line plot mentions
Add the res.plot() one-liners next to the existing figures for the
ISO 8041-1 weighting response, the ISO 2631-1 weighted band spectrum, the
Directive 2002/44/EC daily exposure A(8) and the ISO 2631-5 multiple-shock
assessment, in the EN guides, the ES mirrors and the docs mirrors.
* Docs mirrors: restore missing report-fiche and concept sections
Sync the docs mirrors of the pages touched by this wave with their site
guides: the ISO 16283-3 facade report subsection on the field insulation
page, the EN 29052-1 and ISO 7626 fiche example snippets, and the panel
concept-figure code block.
* Changelog, API docs and llms regeneration; lint and typing fixes for the figure generators
* Fix nested emphasis in the survey-impact figure captions
* Restore the numerical-propagation rasters truncated by a mid-regeneration snapshot
* Reconcile the figure-script additions with the rooms and materials wave
* docs: regenerate the llms bundle after the figure-script reconciliation
Building and structure-borne guides: result figures, plot mentions and mirror sync (#360)
* Add .plot() to the ISO 717 enlarged-range rating results
ExtendedWeightedRatingResult and ExtendedImpactRatingResult now carry the
full enlarged-range band curve (band_centers, measured) and expose a
.plot() that draws the measured curve over the whole range against the
shifted ISO 717 reference on the 16 core bands, with the unfavourable
deviations shaded, the enlarged-range bands marked and every covered
Annex B / A.2.1 adaptation term in the title. EN/ES labels follow the
existing renderer conventions.
* Field insulation guide: enlarged-range, field-chain, facade and survey-impact figures
Four new deterministic figures (extended_insulation_rating,
field_airborne_insulation, facade_field_insulation,
survey_impact_insulation) generated in the four language/theme variants,
embedded next to their snippets in the EN guide, the ES mirror and the
docs mirror with the dual usage/hand-written code blocks. One-line
.plot() mentions added for the extended rating, the field airborne
result, the survey impact result and the ISO 12999-1 band uncertainty.
The docs mirror gains the previously missing ISO 10052 survey-reports
section, and the survey snippet now defines the li and l1_2m inputs it
uses. Multi-line figure info boxes are translated as whole artists, and
the review fixes (headroom, legend placement, proper unit and Greek
glyphs) are applied to the new generators.
* Laboratory insulation guide: ISO 10140, ISO 15186-1 element and ISO 10848 Dn,f figures
Embed the new lab_insulation_result, intensity_element_insulation and
flanking_level_difference figures next to their snippets in the EN guide,
the ES mirror and the docs mirror, each with the dual usage/hand-written
code blocks. Add the one-line .plot() mentions for the laboratory
airborne result, the element-normalized intensity result and the
floor-covering improvement result, and a note on when Dn,f plots (the
inline example uses 9 bands, below the 16/5-band rating threshold).
* EN 12354 prediction guide: impact-term and radiated-power figures
Embed the new impact_prediction_terms and radiated_power_outdoor figures
next to their snippets in the EN guide, the ES mirror and the docs
mirror, with the dual usage/hand-written code blocks, and add the
one-line .plot() mentions for the airborne prediction, the impact
prediction, the facade prediction and the radiated-power result.
* Panel insulation guide: rated Sharp prediction figure and plot mentions
Embed the new single_panel_rating figure (the 6 mm glass Sharp prediction
rated per ISO 717-1, coincidence dip marked) in the EN guide, the ES
mirror and the docs mirror with the dual code blocks, and add the
one-line .plot() mentions for the single-panel, double-wall and
radiation-efficiency results next to the existing concept figure.
* Junction transmission guide: Kij design chart, EN 12354 worked example and see-also
Add the junction_kij_thickness figure (wave-approach Kij versus the plate
thickness ratio for the X, T and L junctions, identical-plates value
marked) next to the coupling-loss-factor section, a res.plot() mention
in its snippet, a worked example that feeds the predicted K12 = 9.8 dB
of the 100/200 mm concrete X-junction into the EN 12354-1 flanking model
(R'w = 55.4 dB, direct path dominant), and a See-also section linking
the prediction, laboratory, structure-borne power and mobility guides.
EN guide, ES mirror and docs mirror in sync.
* Junction transmission docs mirror: sync the Kij chart, worked example and see-also
* Structure-borne power and installed-source guides: plot mentions, Hopkins citation and see-also
Add the one-line .plot() mentions for the reception-plate power result
(EN 15657) and the installed-source prediction (EN 12354-5) next to their
existing figures, add the one-line .plot() usage to both figures' code
blocks, cite Hopkins (2007) Section 2.8 for the point-excited-plate power
input behind the clause 4.4.3 coupling term with a prose paragraph
connecting the mobility chain, and give the EN 12354-5 page a proper
See-also linking the EN 15657, ISO 7626, junction and EN 12354 guides.
EN guides, ES mirrors and docs mirrors in sync.
* Vibration FRF guides: plot mentions and transfer-stiffness docs sync
Add the one-line .plot() usage and mentions for the ISO/TS 7849
sound-power-from-vibration result, the EN 29052-1 dynamic-stiffness
result and the ISO 10846 indirect transfer-stiffness result next to
their existing figures (EN guides, ES mirrors and docs mirrors), and
port the previously missing ISO 10846 test-report fiche section to the
transfer-stiffness docs mirror.
* Mechanical mobility guide: driving-point reading figure
Embed the new mobility_result_lines figure (|Y(f)| of the SDOF bundle
with the stiffness line, the mass line and the 1/c damping peak) next to
the MobilityResult snippet in the EN guide, the ES mirror and the docs
mirror, with the dual usage/hand-written code blocks and the one-line
res.plot() mention.
* Human vibration and multiple-shock guides: one-line plot mentions
Add the res.plot() one-liners next to the existing figures for the
ISO 8041-1 weighting response, the ISO 2631-1 weighted band spectrum, the
Directive 2002/44/EC daily exposure A(8) and the ISO 2631-5 multiple-shock
assessment, in the EN guides, the ES mirrors and the docs mirrors.
* Docs mirrors: restore missing report-fiche and concept sections
Sync the docs mirrors of the pages touched by this wave with their site
guides: the ISO 16283-3 facade report subsection on the field insulation
page, the EN 29052-1 and ISO 7626 fiche example snippets, and the panel
concept-figure code block.
* Changelog, API docs and llms regeneration; lint and typing fixes for the figure generators
* Fix nested emphasis in the survey-impact figure captions
* Restore the numerical-propagation rasters truncated by a mid-regeneration snapshot
* Reconcile the figure-script additions with the rooms and materials wave
* docs: regenerate the llms bundle after the figure-script reconciliation
Building and structure-borne guides: result figures, plot mentions and mirror sync (#360)
* Add .plot() to the ISO 717 enlarged-range rating results
ExtendedWeightedRatingResult and ExtendedImpactRatingResult now carry the
full enlarged-range band curve (band_centers, measured) and expose a
.plot() that draws the measured curve over the whole range against the
shifted ISO 717 reference on the 16 core bands, with the unfavourable
deviations shaded, the enlarged-range bands marked and every covered
Annex B / A.2.1 adaptation term in the title. EN/ES labels follow the
existing renderer conventions.
* Field insulation guide: enlarged-range, field-chain, facade and survey-impact figures
Four new deterministic figures (extended_insulation_rating,
field_airborne_insulation, facade_field_insulation,
survey_impact_insulation) generated in the four language/theme variants,
embedded next to their snippets in the EN guide, the ES mirror and the
docs mirror with the dual usage/hand-written code blocks. One-line
.plot() mentions added for the extended rating, the field airborne
result, the survey impact result and the ISO 12999-1 band uncertainty.
The docs mirror gains the previously missing ISO 10052 survey-reports
section, and the survey snippet now defines the li and l1_2m inputs it
uses. Multi-line figure info boxes are translated as whole artists, and
the review fixes (headroom, legend placement, proper unit and Greek
glyphs) are applied to the new generators.
* Laboratory insulation guide: ISO 10140, ISO 15186-1 element and ISO 10848 Dn,f figures
Embed the new lab_insulation_result, intensity_element_insulation and
flanking_level_difference figures next to their snippets in the EN guide,
the ES mirror and the docs mirror, each with the dual usage/hand-written
code blocks. Add the one-line .plot() mentions for the laboratory
airborne result, the element-normalized intensity result and the
floor-covering improvement result, and a note on when Dn,f plots (the
inline example uses 9 bands, below the 16/5-band rating threshold).
* EN 12354 prediction guide: impact-term and radiated-power figures
Embed the new impact_prediction_terms and radiated_power_outdoor figures
next to their snippets in the EN guide, the ES mirror and the docs
mirror, with the dual usage/hand-written code blocks, and add the
one-line .plot() mentions for the airborne prediction, the impact
prediction, the facade prediction and the radiated-power result.
* Panel insulation guide: rated Sharp prediction figure and plot mentions
Embed the new single_panel_rating figure (the 6 mm glass Sharp prediction
rated per ISO 717-1, coincidence dip marked) in the EN guide, the ES
mirror and the docs mirror with the dual code blocks, and add the
one-line .plot() mentions for the single-panel, double-wall and
radiation-efficiency results next to the existing concept figure.
* Junction transmission guide: Kij design chart, EN 12354 worked example and see-also
Add the junction_kij_thickness figure (wave-approach Kij versus the plate
thickness ratio for the X, T and L junctions, identical-plates value
marked) next to the coupling-loss-factor section, a res.plot() mention
in its snippet, a worked example that feeds the predicted K12 = 9.8 dB
of the 100/200 mm concrete X-junction into the EN 12354-1 flanking model
(R'w = 55.4 dB, direct path dominant), and a See-also section linking
the prediction, laboratory, structure-borne power and mobility guides.
EN guide, ES mirror and docs mirror in sync.
* Junction transmission docs mirror: sync the Kij chart, worked example and see-also
* Structure-borne power and installed-source guides: plot mentions, Hopkins citation and see-also
Add the one-line .plot() mentions for the reception-plate power result
(EN 15657) and the installed-source prediction (EN 12354-5) next to their
existing figures, add the one-line .plot() usage to both figures' code
blocks, cite Hopkins (2007) Section 2.8 for the point-excited-plate power
input behind the clause 4.4.3 coupling term with a prose paragraph
connecting the mobility chain, and give the EN 12354-5 page a proper
See-also linking the EN 15657, ISO 7626, junction and EN 12354 guides.
EN guides, ES mirrors and docs mirrors in sync.
* Vibration FRF guides: plot mentions and transfer-stiffness docs sync
Add the one-line .plot() usage and mentions for the ISO/TS 7849
sound-power-from-vibration result, the EN 29052-1 dynamic-stiffness
result and the ISO 10846 indirect transfer-stiffness result next to
their existing figures (EN guides, ES mirrors and docs mirrors), and
port the previously missing ISO 10846 test-report fiche section to the
transfer-stiffness docs mirror.
* Mechanical mobility guide: driving-point reading figure
Embed the new mobility_result_lines figure (|Y(f)| of the SDOF bundle
with the stiffness line, the mass line and the 1/c damping peak) next to
the MobilityResult snippet in the EN guide, the ES mirror and the docs
mirror, with the dual usage/hand-written code blocks and the one-line
res.plot() mention.
* Human vibration and multiple-shock guides: one-line plot mentions
Add the res.plot() one-liners next to the existing figures for the
ISO 8041-1 weighting response, the ISO 2631-1 weighted band spectrum, the
Directive 2002/44/EC daily exposure A(8) and the ISO 2631-5 multiple-shock
assessment, in the EN guides, the ES mirrors and the docs mirrors.
* Docs mirrors: restore missing report-fiche and concept sections
Sync the docs mirrors of the pages touched by this wave with their site
guides: the ISO 16283-3 facade report subsection on the field insulation
page, the EN 29052-1 and ISO 7626 fiche example snippets, and the panel
concept-figure code block.
* Changelog, API docs and llms regeneration; lint and typing fixes for the figure generators
* Fix nested emphasis in the survey-impact figure captions
* Restore the numerical-propagation rasters truncated by a mid-regeneration snapshot
* Reconcile the figure-script additions with the rooms and materials wave
* docs: regenerate the llms bundle after the figure-script reconciliation
Building and structure-borne guides: result figures, plot mentions and mirror sync (#360)
* Add .plot() to the ISO 717 enlarged-range rating results
ExtendedWeightedRatingResult and ExtendedImpactRatingResult now carry the
full enlarged-range band curve (band_centers, measured) and expose a
.plot() that draws the measured curve over the whole range against the
shifted ISO 717 reference on the 16 core bands, with the unfavourable
deviations shaded, the enlarged-range bands marked and every covered
Annex B / A.2.1 adaptation term in the title. EN/ES labels follow the
existing renderer conventions.
* Field insulation guide: enlarged-range, field-chain, facade and survey-impact figures
Four new deterministic figures (extended_insulation_rating,
field_airborne_insulation, facade_field_insulation,
survey_impact_insulation) generated in the four language/theme variants,
embedded next to their snippets in the EN guide, the ES mirror and the
docs mirror with the dual usage/hand-written code blocks. One-line
.plot() mentions added for the extended rating, the field airborne
result, the survey impact result and the ISO 12999-1 band uncertainty.
The docs mirror gains the previously missing ISO 10052 survey-reports
section, and the survey snippet now defines the li and l1_2m inputs it
uses. Multi-line figure info boxes are translated as whole artists, and
the review fixes (headroom, legend placement, proper unit and Greek
glyphs) are applied to the new generators.
* Laboratory insulation guide: ISO 10140, ISO 15186-1 element and ISO 10848 Dn,f figures
Embed the new lab_insulation_result, intensity_element_insulation and
flanking_level_difference figures next to their snippets in the EN guide,
the ES mirror and the docs mirror, each with the dual usage/hand-written
code blocks. Add the one-line .plot() mentions for the laboratory
airborne result, the element-normalized intensity result and the
floor-covering improvement result, and a note on when Dn,f plots (the
inline example uses 9 bands, below the 16/5-band rating threshold).
* EN 12354 prediction guide: impact-term and radiated-power figures
Embed the new impact_prediction_terms and radiated_power_outdoor figures
next to their snippets in the EN guide, the ES mirror and the docs
mirror, with the dual usage/hand-written code blocks, and add the
one-line .plot() mentions for the airborne prediction, the impact
prediction, the facade prediction and the radiated-power result.
* Panel insulation guide: rated Sharp prediction figure and plot mentions
Embed the new single_panel_rating figure (the 6 mm glass Sharp prediction
rated per ISO 717-1, coincidence dip marked) in the EN guide, the ES
mirror and the docs mirror with the dual code blocks, and add the
one-line .plot() mentions for the single-panel, double-wall and
radiation-efficiency results next to the existing concept figure.
* Junction transmission guide: Kij design chart, EN 12354 worked example and see-also
Add the junction_kij_thickness figure (wave-approach Kij versus the plate
thickness ratio for the X, T and L junctions, identical-plates value
marked) next to the coupling-loss-factor section, a res.plot() mention
in its snippet, a worked example that feeds the predicted K12 = 9.8 dB
of the 100/200 mm concrete X-junction into the EN 12354-1 flanking model
(R'w = 55.4 dB, direct path dominant), and a See-also section linking
the prediction, laboratory, structure-borne power and mobility guides.
EN guide, ES mirror and docs mirror in sync.
* Junction transmission docs mirror: sync the Kij chart, worked example and see-also
* Structure-borne power and installed-source guides: plot mentions, Hopkins citation and see-also
Add the one-line .plot() mentions for the reception-plate power result
(EN 15657) and the installed-source prediction (EN 12354-5) next to their
existing figures, add the one-line .plot() usage to both figures' code
blocks, cite Hopkins (2007) Section 2.8 for the point-excited-plate power
input behind the clause 4.4.3 coupling term with a prose paragraph
connecting the mobility chain, and give the EN 12354-5 page a proper
See-also linking the EN 15657, ISO 7626, junction and EN 12354 guides.
EN guides, ES mirrors and docs mirrors in sync.
* Vibration FRF guides: plot mentions and transfer-stiffness docs sync
Add the one-line .plot() usage and mentions for the ISO/TS 7849
sound-power-from-vibration result, the EN 29052-1 dynamic-stiffness
result and the ISO 10846 indirect transfer-stiffness result next to
their existing figures (EN guides, ES mirrors and docs mirrors), and
port the previously missing ISO 10846 test-report fiche section to the
transfer-stiffness docs mirror.
* Mechanical mobility guide: driving-point reading figure
Embed the new mobility_result_lines figure (|Y(f)| of the SDOF bundle
with the stiffness line, the mass line and the 1/c damping peak) next to
the MobilityResult snippet in the EN guide, the ES mirror and the docs
mirror, with the dual usage/hand-written code blocks and the one-line
res.plot() mention.
* Human vibration and multiple-shock guides: one-line plot mentions
Add the res.plot() one-liners next to the existing figures for the
ISO 8041-1 weighting response, the ISO 2631-1 weighted band spectrum, the
Directive 2002/44/EC daily exposure A(8) and the ISO 2631-5 multiple-shock
assessment, in the EN guides, the ES mirrors and the docs mirrors.
* Docs mirrors: restore missing report-fiche and concept sections
Sync the docs mirrors of the pages touched by this wave with their site
guides: the ISO 16283-3 facade report subsection on the field insulation
page, the EN 29052-1 and ISO 7626 fiche example snippets, and the panel
concept-figure code block.
* Changelog, API docs and llms regeneration; lint and typing fixes for the figure generators
* Fix nested emphasis in the survey-impact figure captions
* Restore the numerical-propagation rasters truncated by a mid-regeneration snapshot
* Reconcile the figure-script additions with the rooms and materials wave
* docs: regenerate the llms bundle after the figure-script reconciliation
Building and structure-borne guides: result figures, plot mentions and mirror sync (#360)
* Add .plot() to the ISO 717 enlarged-range rating results
ExtendedWeightedRatingResult and ExtendedImpactRatingResult now carry the
full enlarged-range band curve (band_centers, measured) and expose a
.plot() that draws the measured curve over the whole range against the
shifted ISO 717 reference on the 16 core bands, with the unfavourable
deviations shaded, the enlarged-range bands marked and every covered
Annex B / A.2.1 adaptation term in the title. EN/ES labels follow the
existing renderer conventions.
* Field insulation guide: enlarged-range, field-chain, facade and survey-impact figures
Four new deterministic figures (extended_insulation_rating,
field_airborne_insulation, facade_field_insulation,
survey_impact_insulation) generated in the four language/theme variants,
embedded next to their snippets in the EN guide, the ES mirror and the
docs mirror with the dual usage/hand-written code blocks. One-line
.plot() mentions added for the extended rating, the field airborne
result, the survey impact result and the ISO 12999-1 band uncertainty.
The docs mirror gains the previously missing ISO 10052 survey-reports
section, and the survey snippet now defines the li and l1_2m inputs it
uses. Multi-line figure info boxes are translated as whole artists, and
the review fixes (headroom, legend placement, proper unit and Greek
glyphs) are applied to the new generators.
* Laboratory insulation guide: ISO 10140, ISO 15186-1 element and ISO 10848 Dn,f figures
Embed the new lab_insulation_result, intensity_element_insulation and
flanking_level_difference figures next to their snippets in the EN guide,
the ES mirror and the docs mirror, each with the dual usage/hand-written
code blocks. Add the one-line .plot() mentions for the laboratory
airborne result, the element-normalized intensity result and the
floor-covering improvement result, and a note on when Dn,f plots (the
inline example uses 9 bands, below the 16/5-band rating threshold).
* EN 12354 prediction guide: impact-term and radiated-power figures
Embed the new impact_prediction_terms and radiated_power_outdoor figures
next to their snippets in the EN guide, the ES mirror and the docs
mirror, with the dual usage/hand-written code blocks, and add the
one-line .plot() mentions for the airborne prediction, the impact
prediction, the facade prediction and the radiated-power result.
* Panel insulation guide: rated Sharp prediction figure and plot mentions
Embed the new single_panel_rating figure (the 6 mm glass Sharp prediction
rated per ISO 717-1, coincidence dip marked) in the EN guide, the ES
mirror and the docs mirror with the dual code blocks, and add the
one-line .plot() mentions for the single-panel, double-wall and
radiation-efficiency results next to the existing concept figure.
* Junction transmission guide: Kij design chart, EN 12354 worked example and see-also
Add the junction_kij_thickness figure (wave-approach Kij versus the plate
thickness ratio for the X, T and L junctions, identical-plates value
marked) next to the coupling-loss-factor section, a res.plot() mention
in its snippet, a worked example that feeds the predicted K12 = 9.8 dB
of the 100/200 mm concrete X-junction into the EN 12354-1 flanking model
(R'w = 55.4 dB, direct path dominant), and a See-also section linking
the prediction, laboratory, structure-borne power and mobility guides.
EN guide, ES mirror and docs mirror in sync.
* Junction transmission docs mirror: sync the Kij chart, worked example and see-also
* Structure-borne power and installed-source guides: plot mentions, Hopkins citation and see-also
Add the one-line .plot() mentions for the reception-plate power result
(EN 15657) and the installed-source prediction (EN 12354-5) next to their
existing figures, add the one-line .plot() usage to both figures' code
blocks, cite Hopkins (2007) Section 2.8 for the point-excited-plate power
input behind the clause 4.4.3 coupling term with a prose paragraph
connecting the mobility chain, and give the EN 12354-5 page a proper
See-also linking the EN 15657, ISO 7626, junction and EN 12354 guides.
EN guides, ES mirrors and docs mirrors in sync.
* Vibration FRF guides: plot mentions and transfer-stiffness docs sync
Add the one-line .plot() usage and mentions for the ISO/TS 7849
sound-power-from-vibration result, the EN 29052-1 dynamic-stiffness
result and the ISO 10846 indirect transfer-stiffness result next to
their existing figures (EN guides, ES mirrors and docs mirrors), and
port the previously missing ISO 10846 test-report fiche section to the
transfer-stiffness docs mirror.
* Mechanical mobility guide: driving-point reading figure
Embed the new mobility_result_lines figure (|Y(f)| of the SDOF bundle
with the stiffness line, the mass line and the 1/c damping peak) next to
the MobilityResult snippet in the EN guide, the ES mirror and the docs
mirror, with the dual usage/hand-written code blocks and the one-line
res.plot() mention.
* Human vibration and multiple-shock guides: one-line plot mentions
Add the res.plot() one-liners next to the existing figures for the
ISO 8041-1 weighting response, the ISO 2631-1 weighted band spectrum, the
Directive 2002/44/EC daily exposure A(8) and the ISO 2631-5 multiple-shock
assessment, in the EN guides, the ES mirrors and the docs mirrors.
* Docs mirrors: restore missing report-fiche and concept sections
Sync the docs mirrors of the pages touched by this wave with their site
guides: the ISO 16283-3 facade report subsection on the field insulation
page, the EN 29052-1 and ISO 7626 fiche example snippets, and the panel
concept-figure code block.
* Changelog, API docs and llms regeneration; lint and typing fixes for the figure generators
* Fix nested emphasis in the survey-impact figure captions
* Restore the numerical-propagation rasters truncated by a mid-regeneration snapshot
* Reconcile the figure-script additions with the rooms and materials wave
* docs: regenerate the llms bundle after the figure-script reconciliation
Perception, hearing and speech guides: result figures and when-to-use prose (#361)
* Perception, hearing and speech guides: result figures and when-to-use prose
Add ToneAssessment.plot(), which draws an ECMA-418-1 tone against the
prominence criterion of its own method (recovered from criterion_db) over the
whole range of interest, with the deciding margin marked, and a
view="levels" option on ToneAudibilityResult.plot() that exposes the
level-versus-frequency view the ISO 1996-2 fiche already embedded.
Add eleven single-concept figures to the perception, hearing and speech
guides, each a realistic result drawn by its own .plot(): the tone prominence
verdict, the ISO/PAS 20065 tone levels, the ISO/PAS 1996-3 onset detection,
the ISO 532-2 specific loudness, the ECMA-418-2 specific tonality, the
specific fluctuation strength, the SII band audibility under a hearing loss,
the ISO 7029 fractile band, the ISO 1999 NIPTS audiogram, the STOI per-band
correlation and the IEC 60268-16 per-band MTI. Every figure is embedded in
the English guide, the Spanish mirror and the docs mirror with the dual
snippet block, and every plottable snippet on those pages now names its
.plot().
Prose: the tone-prominence guide gains a comparison of the four tonality
assessments the library implements and when each applies, the
hearing-threshold guide explains how the ISO 7029 fractiles feed the ISO 1999
age component and gains a See-also section, and the objective-intelligibility
guide gains the "which measure, and when" section that existed only in the
docs mirror, extended with the STOI/ESTOI, STI and SII choice.
Also label the STOI band axis at whole-hertz resolution and let the shaded
critical band of the tone-audibility levels plot follow the figure
background, so it reads on the white report page and on dark figures alike.
* Correct two figure alt texts against the plotted values
The ISO 7029 fractile figure describes the median and the 90 % fractile with
the values it actually draws (10 to 50 dB and 22 to 74 dB), and the
ECMA-418-2 specific tonality peak is at 9 Bark_HMS.
Perception, hearing and speech guides: result figures and when-to-use prose (#361)
* Perception, hearing and speech guides: result figures and when-to-use prose
Add ToneAssessment.plot(), which draws an ECMA-418-1 tone against the
prominence criterion of its own method (recovered from criterion_db) over the
whole range of interest, with the deciding margin marked, and a
view="levels" option on ToneAudibilityResult.plot() that exposes the
level-versus-frequency view the ISO 1996-2 fiche already embedded.
Add eleven single-concept figures to the perception, hearing and speech
guides, each a realistic result drawn by its own .plot(): the tone prominence
verdict, the ISO/PAS 20065 tone levels, the ISO/PAS 1996-3 onset detection,
the ISO 532-2 specific loudness, the ECMA-418-2 specific tonality, the
specific fluctuation strength, the SII band audibility under a hearing loss,
the ISO 7029 fractile band, the ISO 1999 NIPTS audiogram, the STOI per-band
correlation and the IEC 60268-16 per-band MTI. Every figure is embedded in
the English guide, the Spanish mirror and the docs mirror with the dual
snippet block, and every plottable snippet on those pages now names its
.plot().
Prose: the tone-prominence guide gains a comparison of the four tonality
assessments the library implements and when each applies, the
hearing-threshold guide explains how the ISO 7029 fractiles feed the ISO 1999
age component and gains a See-also section, and the objective-intelligibility
guide gains the "which measure, and when" section that existed only in the
docs mirror, extended with the STOI/ESTOI, STI and SII choice.
Also label the STOI band axis at whole-hertz resolution and let the shaded
critical band of the tone-audibility levels plot follow the figure
background, so it reads on the white report page and on dark figures alike.
* Correct two figure alt texts against the plotted values
The ISO 7029 fractile figure describes the median and the 90 % fractile with
the values it actually draws (10 to 50 dB and 22 to 74 dB), and the
ECMA-418-2 specific tonality peak is at 9 Bark_HMS.
Perception, hearing and speech guides: result figures and when-to-use prose (#361)
* Perception, hearing and speech guides: result figures and when-to-use prose
Add ToneAssessment.plot(), which draws an ECMA-418-1 tone against the
prominence criterion of its own method (recovered from criterion_db) over the
whole range of interest, with the deciding margin marked, and a
view="levels" option on ToneAudibilityResult.plot() that exposes the
level-versus-frequency view the ISO 1996-2 fiche already embedded.
Add eleven single-concept figures to the perception, hearing and speech
guides, each a realistic result drawn by its own .plot(): the tone prominence
verdict, the ISO/PAS 20065 tone levels, the ISO/PAS 1996-3 onset detection,
the ISO 532-2 specific loudness, the ECMA-418-2 specific tonality, the
specific fluctuation strength, the SII band audibility under a hearing loss,
the ISO 7029 fractile band, the ISO 1999 NIPTS audiogram, the STOI per-band
correlation and the IEC 60268-16 per-band MTI. Every figure is embedded in
the English guide, the Spanish mirror and the docs mirror with the dual
snippet block, and every plottable snippet on those pages now names its
.plot().
Prose: the tone-prominence guide gains a comparison of the four tonality
assessments the library implements and when each applies, the
hearing-threshold guide explains how the ISO 7029 fractiles feed the ISO 1999
age component and gains a See-also section, and the objective-intelligibility
guide gains the "which measure, and when" section that existed only in the
docs mirror, extended with the STOI/ESTOI, STI and SII choice.
Also label the STOI band axis at whole-hertz resolution and let the shaded
critical band of the tone-audibility levels plot follow the figure
background, so it reads on the white report page and on dark figures alike.
* Correct two figure alt texts against the plotted values
The ISO 7029 fractile figure describes the median and the 90 % fractile with
the values it actually draws (10 to 50 dB and 22 to 74 dB), and the
ECMA-418-2 specific tonality peak is at 9 Bark_HMS.
Perception, hearing and speech guides: result figures and when-to-use prose (#361)
* Perception, hearing and speech guides: result figures and when-to-use prose
Add ToneAssessment.plot(), which draws an ECMA-418-1 tone against the
prominence criterion of its own method (recovered from criterion_db) over the
whole range of interest, with the deciding margin marked, and a
view="levels" option on ToneAudibilityResult.plot() that exposes the
level-versus-frequency view the ISO 1996-2 fiche already embedded.
Add eleven single-concept figures to the perception, hearing and speech
guides, each a realistic result drawn by its own .plot(): the tone prominence
verdict, the ISO/PAS 20065 tone levels, the ISO/PAS 1996-3 onset detection,
the ISO 532-2 specific loudness, the ECMA-418-2 specific tonality, the
specific fluctuation strength, the SII band audibility under a hearing loss,
the ISO 7029 fractile band, the ISO 1999 NIPTS audiogram, the STOI per-band
correlation and the IEC 60268-16 per-band MTI. Every figure is embedded in
the English guide, the Spanish mirror and the docs mirror with the dual
snippet block, and every plottable snippet on those pages now names its
.plot().
Prose: the tone-prominence guide gains a comparison of the four tonality
assessments the library implements and when each applies, the
hearing-threshold guide explains how the ISO 7029 fractiles feed the ISO 1999
age component and gains a See-also section, and the objective-intelligibility
guide gains the "which measure, and when" section that existed only in the
docs mirror, extended with the STOI/ESTOI, STI and SII choice.
Also label the STOI band axis at whole-hertz resolution and let the shaded
critical band of the tone-audibility levels plot follow the figure
background, so it reads on the white report page and on dark figures alike.
* Correct two figure alt texts against the plotted values
The ISO 7029 fractile figure describes the median and the 90 % fractile with
the values it actually draws (10 to 50 dB and 22 to 74 dB), and the
ECMA-418-2 specific tonality peak is at 9 Bark_HMS.
Core metrology guides: result figures, ResampledSignalResult.plot() and real introductions (#364)
* Add ResampledSignalResult.plot(): the delivered anti-alias filter against its design spec
* Rewrite the multichannel guide intro: concrete use cases, per-channel guarantees, Bendat & Piersol citations
* Give the levels page a real introduction: descriptor families, when-to-use guidance and survey references
* Time weighting: framing intro with detector history, ANSI S1.4/Bies references and sibling links
* Calibration: proper introduction (SPL vs dBFS choice, workflow framing) with Bies reference and sibling links
* Add eleven core-metrology figures: resampling spec, cepstrum variants, liftering, correlation, IR alignment, Hilbert envelope, cross-spectra, Golay recovery, TSA noise law, runs test
* Test signals: anti-alias figure with dual snippet, res.plot() mention, See also, docs mirror sync
* Cepstrum guide: variants and liftering figures with dual snippets, complex-cepstrum plot mention
* Correlation guide: normalization, IR-alignment and Hilbert-envelope figures with dual snippets
* Spectral analysis: cross-spectral density and coherent-output-SNR figures with dual snippets
* System measurement: Golay exact-recovery figure and plot mentions for the inversion workflow
* Synchronous averaging: sqrt(N) figure, diagnostics-tool guidance, See also, recording naming
* Data qualification: runs-test figure with dual snippet and peak-statistics plot mention
* MISO coherence: conditioning-order snippet, practical pitfalls and See also across the three trees
* Time-frequency: Harris window reference and See also across the three trees
* GUM uncertainty: map the domain pages that consume the clause-5 machinery, expand See also
* Filter banks: compliance plot mentions and recording naming in the crossover snippet
* Changelog entry for the core-metrology documentation figures and prose
* Regenerate llms-full.txt for the core-metrology documentation
* Drop the duplicated phase-axis translation key
Core metrology guides: result figures, ResampledSignalResult.plot() and real introductions (#364)
* Add ResampledSignalResult.plot(): the delivered anti-alias filter against its design spec
* Rewrite the multichannel guide intro: concrete use cases, per-channel guarantees, Bendat & Piersol citations
* Give the levels page a real introduction: descriptor families, when-to-use guidance and survey references
* Time weighting: framing intro with detector history, ANSI S1.4/Bies references and sibling links
* Calibration: proper introduction (SPL vs dBFS choice, workflow framing) with Bies reference and sibling links
* Add eleven core-metrology figures: resampling spec, cepstrum variants, liftering, correlation, IR alignment, Hilbert envelope, cross-spectra, Golay recovery, TSA noise law, runs test
* Test signals: anti-alias figure with dual snippet, res.plot() mention, See also, docs mirror sync
* Cepstrum guide: variants and liftering figures with dual snippets, complex-cepstrum plot mention
* Correlation guide: normalization, IR-alignment and Hilbert-envelope figures with dual snippets
* Spectral analysis: cross-spectral density and coherent-output-SNR figures with dual snippets
* System measurement: Golay exact-recovery figure and plot mentions for the inversion workflow
* Synchronous averaging: sqrt(N) figure, diagnostics-tool guidance, See also, recording naming
* Data qualification: runs-test figure with dual snippet and peak-statistics plot mention
* MISO coherence: conditioning-order snippet, practical pitfalls and See also across the three trees
* Time-frequency: Harris window reference and See also across the three trees
* GUM uncertainty: map the domain pages that consume the clause-5 machinery, expand See also
* Filter banks: compliance plot mentions and recording naming in the crossover snippet
* Changelog entry for the core-metrology documentation figures and prose
* Regenerate llms-full.txt for the core-metrology documentation
* Drop the duplicated phase-axis translation key
Core metrology guides: result figures, ResampledSignalResult.plot() and real introductions (#364)
* Add ResampledSignalResult.plot(): the delivered anti-alias filter against its design spec
* Rewrite the multichannel guide intro: concrete use cases, per-channel guarantees, Bendat & Piersol citations
* Give the levels page a real introduction: descriptor families, when-to-use guidance and survey references
* Time weighting: framing intro with detector history, ANSI S1.4/Bies references and sibling links
* Calibration: proper introduction (SPL vs dBFS choice, workflow framing) with Bies reference and sibling links
* Add eleven core-metrology figures: resampling spec, cepstrum variants, liftering, correlation, IR alignment, Hilbert envelope, cross-spectra, Golay recovery, TSA noise law, runs test
* Test signals: anti-alias figure with dual snippet, res.plot() mention, See also, docs mirror sync
* Cepstrum guide: variants and liftering figures with dual snippets, complex-cepstrum plot mention
* Correlation guide: normalization, IR-alignment and Hilbert-envelope figures with dual snippets
* Spectral analysis: cross-spectral density and coherent-output-SNR figures with dual snippets
* System measurement: Golay exact-recovery figure and plot mentions for the inversion workflow
* Synchronous averaging: sqrt(N) figure, diagnostics-tool guidance, See also, recording naming
* Data qualification: runs-test figure with dual snippet and peak-statistics plot mention
* MISO coherence: conditioning-order snippet, practical pitfalls and See also across the three trees
* Time-frequency: Harris window reference and See also across the three trees
* GUM uncertainty: map the domain pages that consume the clause-5 machinery, expand See also
* Filter banks: compliance plot mentions and recording naming in the crossover snippet
* Changelog entry for the core-metrology documentation figures and prose
* Regenerate llms-full.txt for the core-metrology documentation
* Drop the duplicated phase-axis translation key
Core metrology guides: result figures, ResampledSignalResult.plot() and real introductions (#364)
* Add ResampledSignalResult.plot(): the delivered anti-alias filter against its design spec
* Rewrite the multichannel guide intro: concrete use cases, per-channel guarantees, Bendat & Piersol citations
* Give the levels page a real introduction: descriptor families, when-to-use guidance and survey references
* Time weighting: framing intro with detector history, ANSI S1.4/Bies references and sibling links
* Calibration: proper introduction (SPL vs dBFS choice, workflow framing) with Bies reference and sibling links
* Add eleven core-metrology figures: resampling spec, cepstrum variants, liftering, correlation, IR alignment, Hilbert envelope, cross-spectra, Golay recovery, TSA noise law, runs test
* Test signals: anti-alias figure with dual snippet, res.plot() mention, See also, docs mirror sync
* Cepstrum guide: variants and liftering figures with dual snippets, complex-cepstrum plot mention
* Correlation guide: normalization, IR-alignment and Hilbert-envelope figures with dual snippets
* Spectral analysis: cross-spectral density and coherent-output-SNR figures with dual snippets
* System measurement: Golay exact-recovery figure and plot mentions for the inversion workflow
* Synchronous averaging: sqrt(N) figure, diagnostics-tool guidance, See also, recording naming
* Data qualification: runs-test figure with dual snippet and peak-statistics plot mention
* MISO coherence: conditioning-order snippet, practical pitfalls and See also across the three trees
* Time-frequency: Harris window reference and See also across the three trees
* GUM uncertainty: map the domain pages that consume the clause-5 machinery, expand See also
* Filter banks: compliance plot mentions and recording naming in the crossover snippet
* Changelog entry for the core-metrology documentation figures and prose
* Regenerate llms-full.txt for the core-metrology documentation
* Drop the duplicated phase-axis translation key
Core metrology guides: result figures, ResampledSignalResult.plot() and real introductions (#364)
* Add ResampledSignalResult.plot(): the delivered anti-alias filter against its design spec
* Rewrite the multichannel guide intro: concrete use cases, per-channel guarantees, Bendat & Piersol citations
* Give the levels page a real introduction: descriptor families, when-to-use guidance and survey references
* Time weighting: framing intro with detector history, ANSI S1.4/Bies references and sibling links
* Calibration: proper introduction (SPL vs dBFS choice, workflow framing) with Bies reference and sibling links
* Add eleven core-metrology figures: resampling spec, cepstrum variants, liftering, correlation, IR alignment, Hilbert envelope, cross-spectra, Golay recovery, TSA noise law, runs test
* Test signals: anti-alias figure with dual snippet, res.plot() mention, See also, docs mirror sync
* Cepstrum guide: variants and liftering figures with dual snippets, complex-cepstrum plot mention
* Correlation guide: normalization, IR-alignment and Hilbert-envelope figures with dual snippets
* Spectral analysis: cross-spectral density and coherent-output-SNR figures with dual snippets
* System measurement: Golay exact-recovery figure and plot mentions for the inversion workflow
* Synchronous averaging: sqrt(N) figure, diagnostics-tool guidance, See also, recording naming
* Data qualification: runs-test figure with dual snippet and peak-statistics plot mention
* MISO coherence: conditioning-order snippet, practical pitfalls and See also across the three trees
* Time-frequency: Harris window reference and See also across the three trees
* GUM uncertainty: map the domain pages that consume the clause-5 machinery, expand See also
* Filter banks: compliance plot mentions and recording naming in the crossover snippet
* Changelog entry for the core-metrology documentation figures and prose
* Regenerate llms-full.txt for the core-metrology documentation
* Drop the duplicated phase-axis translation key
Core metrology guides: result figures, ResampledSignalResult.plot() and real introductions (#364)
* Add ResampledSignalResult.plot(): the delivered anti-alias filter against its design spec
* Rewrite the multichannel guide intro: concrete use cases, per-channel guarantees, Bendat & Piersol citations
* Give the levels page a real introduction: descriptor families, when-to-use guidance and survey references
* Time weighting: framing intro with detector history, ANSI S1.4/Bies references and sibling links
* Calibration: proper introduction (SPL vs dBFS choice, workflow framing) with Bies reference and sibling links
* Add eleven core-metrology figures: resampling spec, cepstrum variants, liftering, correlation, IR alignment, Hilbert envelope, cross-spectra, Golay recovery, TSA noise law, runs test
* Test signals: anti-alias figure with dual snippet, res.plot() mention, See also, docs mirror sync
* Cepstrum guide: variants and liftering figures with dual snippets, complex-cepstrum plot mention
* Correlation guide: normalization, IR-alignment and Hilbert-envelope figures with dual snippets
* Spectral analysis: cross-spectral density and coherent-output-SNR figures with dual snippets
* System measurement: Golay exact-recovery figure and plot mentions for the inversion workflow
* Synchronous averaging: sqrt(N) figure, diagnostics-tool guidance, See also, recording naming
* Data qualification: runs-test figure with dual snippet and peak-statistics plot mention
* MISO coherence: conditioning-order snippet, practical pitfalls and See also across the three trees
* Time-frequency: Harris window reference and See also across the three trees
* GUM uncertainty: map the domain pages that consume the clause-5 machinery, expand See also
* Filter banks: compliance plot mentions and recording naming in the crossover snippet
* Changelog entry for the core-metrology documentation figures and prose
* Regenerate llms-full.txt for the core-metrology documentation
* Drop the duplicated phase-axis translation key
Core metrology guides: result figures, ResampledSignalResult.plot() and real introductions (#364)
* Add ResampledSignalResult.plot(): the delivered anti-alias filter against its design spec
* Rewrite the multichannel guide intro: concrete use cases, per-channel guarantees, Bendat & Piersol citations
* Give the levels page a real introduction: descriptor families, when-to-use guidance and survey references
* Time weighting: framing intro with detector history, ANSI S1.4/Bies references and sibling links
* Calibration: proper introduction (SPL vs dBFS choice, workflow framing) with Bies reference and sibling links
* Add eleven core-metrology figures: resampling spec, cepstrum variants, liftering, correlation, IR alignment, Hilbert envelope, cross-spectra, Golay recovery, TSA noise law, runs test
* Test signals: anti-alias figure with dual snippet, res.plot() mention, See also, docs mirror sync
* Cepstrum guide: variants and liftering figures with dual snippets, complex-cepstrum plot mention
* Correlation guide: normalization, IR-alignment and Hilbert-envelope figures with dual snippets
* Spectral analysis: cross-spectral density and coherent-output-SNR figures with dual snippets
* System measurement: Golay exact-recovery figure and plot mentions for the inversion workflow
* Synchronous averaging: sqrt(N) figure, diagnostics-tool guidance, See also, recording naming
* Data qualification: runs-test figure with dual snippet and peak-statistics plot mention
* MISO coherence: conditioning-order snippet, practical pitfalls and See also across the three trees
* Time-frequency: Harris window reference and See also across the three trees
* GUM uncertainty: map the domain pages that consume the clause-5 machinery, expand See also
* Filter banks: compliance plot mentions and recording naming in the crossover snippet
* Changelog entry for the core-metrology documentation figures and prose
* Regenerate llms-full.txt for the core-metrology documentation
* Drop the duplicated phase-axis translation key
Core metrology guides: result figures, ResampledSignalResult.plot() and real introductions (#364)
* Add ResampledSignalResult.plot(): the delivered anti-alias filter against its design spec
* Rewrite the multichannel guide intro: concrete use cases, per-channel guarantees, Bendat & Piersol citations
* Give the levels page a real introduction: descriptor families, when-to-use guidance and survey references
* Time weighting: framing intro with detector history, ANSI S1.4/Bies references and sibling links
* Calibration: proper introduction (SPL vs dBFS choice, workflow framing) with Bies reference and sibling links
* Add eleven core-metrology figures: resampling spec, cepstrum variants, liftering, correlation, IR alignment, Hilbert envelope, cross-spectra, Golay recovery, TSA noise law, runs test
* Test signals: anti-alias figure with dual snippet, res.plot() mention, See also, docs mirror sync
* Cepstrum guide: variants and liftering figures with dual snippets, complex-cepstrum plot mention
* Correlation guide: normalization, IR-alignment and Hilbert-envelope figures with dual snippets
* Spectral analysis: cross-spectral density and coherent-output-SNR figures with dual snippets
* System measurement: Golay exact-recovery figure and plot mentions for the inversion workflow
* Synchronous averaging: sqrt(N) figure, diagnostics-tool guidance, See also, recording naming
* Data qualification: runs-test figure with dual snippet and peak-statistics plot mention
* MISO coherence: conditioning-order snippet, practical pitfalls and See also across the three trees
* Time-frequency: Harris window reference and See also across the three trees
* GUM uncertainty: map the domain pages that consume the clause-5 machinery, expand See also
* Filter banks: compliance plot mentions and recording naming in the crossover snippet
* Changelog entry for the core-metrology documentation figures and prose
* Regenerate llms-full.txt for the core-metrology documentation
* Drop the duplicated phase-axis translation key
Building and structure-borne guides: result figures, plot mentions and mirror sync (#360)
* Add .plot() to the ISO 717 enlarged-range rating results
ExtendedWeightedRatingResult and ExtendedImpactRatingResult now carry the
full enlarged-range band curve (band_centers, measured) and expose a
.plot() that draws the measured curve over the whole range against the
shifted ISO 717 reference on the 16 core bands, with the unfavourable
deviations shaded, the enlarged-range bands marked and every covered
Annex B / A.2.1 adaptation term in the title. EN/ES labels follow the
existing renderer conventions.
* Field insulation guide: enlarged-range, field-chain, facade and survey-impact figures
Four new deterministic figures (extended_insulation_rating,
field_airborne_insulation, facade_field_insulation,
survey_impact_insulation) generated in the four language/theme variants,
embedded next to their snippets in the EN guide, the ES mirror and the
docs mirror with the dual usage/hand-written code blocks. One-line
.plot() mentions added for the extended rating, the field airborne
result, the survey impact result and the ISO 12999-1 band uncertainty.
The docs mirror gains the previously missing ISO 10052 survey-reports
section, and the survey snippet now defines the li and l1_2m inputs it
uses. Multi-line figure info boxes are translated as whole artists, and
the review fixes (headroom, legend placement, proper unit and Greek
glyphs) are applied to the new generators.
* Laboratory insulation guide: ISO 10140, ISO 15186-1 element and ISO 10848 Dn,f figures
Embed the new lab_insulation_result, intensity_element_insulation and
flanking_level_difference figures next to their snippets in the EN guide,
the ES mirror and the docs mirror, each with the dual usage/hand-written
code blocks. Add the one-line .plot() mentions for the laboratory
airborne result, the element-normalized intensity result and the
floor-covering improvement result, and a note on when Dn,f plots (the
inline example uses 9 bands, below the 16/5-band rating threshold).
* EN 12354 prediction guide: impact-term and radiated-power figures
Embed the new impact_prediction_terms and radiated_power_outdoor figures
next to their snippets in the EN guide, the ES mirror and the docs
mirror, with the dual usage/hand-written code blocks, and add the
one-line .plot() mentions for the airborne prediction, the impact
prediction, the facade prediction and the radiated-power result.
* Panel insulation guide: rated Sharp prediction figure and plot mentions
Embed the new single_panel_rating figure (the 6 mm glass Sharp prediction
rated per ISO 717-1, coincidence dip marked) in the EN guide, the ES
mirror and the docs mirror with the dual code blocks, and add the
one-line .plot() mentions for the single-panel, double-wall and
radiation-efficiency results next to the existing concept figure.
* Junction transmission guide: Kij design chart, EN 12354 worked example and see-also
Add the junction_kij_thickness figure (wave-approach Kij versus the plate
thickness ratio for the X, T and L junctions, identical-plates value
marked) next to the coupling-loss-factor section, a res.plot() mention
in its snippet, a worked example that feeds the predicted K12 = 9.8 dB
of the 100/200 mm concrete X-junction into the EN 12354-1 flanking model
(R'w = 55.4 dB, direct path dominant), and a See-also section linking
the prediction, laboratory, structure-borne power and mobility guides.
EN guide, ES mirror and docs mirror in sync.
* Junction transmission docs mirror: sync the Kij chart, worked example and see-also
* Structure-borne power and installed-source guides: plot mentions, Hopkins citation and see-also
Add the one-line .plot() mentions for the reception-plate power result
(EN 15657) and the installed-source prediction (EN 12354-5) next to their
existing figures, add the one-line .plot() usage to both figures' code
blocks, cite Hopkins (2007) Section 2.8 for the point-excited-plate power
input behind the clause 4.4.3 coupling term with a prose paragraph
connecting the mobility chain, and give the EN 12354-5 page a proper
See-also linking the EN 15657, ISO 7626, junction and EN 12354 guides.
EN guides, ES mirrors and docs mirrors in sync.
* Vibration FRF guides: plot mentions and transfer-stiffness docs sync
Add the one-line .plot() usage and mentions for the ISO/TS 7849
sound-power-from-vibration result, the EN 29052-1 dynamic-stiffness
result and the ISO 10846 indirect transfer-stiffness result next to
their existing figures (EN guides, ES mirrors and docs mirrors), and
port the previously missing ISO 10846 test-report fiche section to the
transfer-stiffness docs mirror.
* Mechanical mobility guide: driving-point reading figure
Embed the new mobility_result_lines figure (|Y(f)| of the SDOF bundle
with the stiffness line, the mass line and the 1/c damping peak) next to
the MobilityResult snippet in the EN guide, the ES mirror and the docs
mirror, with the dual usage/hand-written code blocks and the one-line
res.plot() mention.
* Human vibration and multiple-shock guides: one-line plot mentions
Add the res.plot() one-liners next to the existing figures for the
ISO 8041-1 weighting response, the ISO 2631-1 weighted band spectrum, the
Directive 2002/44/EC daily exposure A(8) and the ISO 2631-5 multiple-shock
assessment, in the EN guides, the ES mirrors and the docs mirrors.
* Docs mirrors: restore missing report-fiche and concept sections
Sync the docs mirrors of the pages touched by this wave with their site
guides: the ISO 16283-3 facade report subsection on the field insulation
page, the EN 29052-1 and ISO 7626 fiche example snippets, and the panel
concept-figure code block.
* Changelog, API docs and llms regeneration; lint and typing fixes for the figure generators
* Fix nested emphasis in the survey-impact figure captions
* Restore the numerical-propagation rasters truncated by a mid-regeneration snapshot
* Reconcile the figure-script additions with the rooms and materials wave
* docs: regenerate the llms bundle after the figure-script reconciliation
Building and structure-borne guides: result figures, plot mentions and mirror sync (#360)
* Add .plot() to the ISO 717 enlarged-range rating results
ExtendedWeightedRatingResult and ExtendedImpactRatingResult now carry the
full enlarged-range band curve (band_centers, measured) and expose a
.plot() that draws the measured curve over the whole range against the
shifted ISO 717 reference on the 16 core bands, with the unfavourable
deviations shaded, the enlarged-range bands marked and every covered
Annex B / A.2.1 adaptation term in the title. EN/ES labels follow the
existing renderer conventions.
* Field insulation guide: enlarged-range, field-chain, facade and survey-impact figures
Four new deterministic figures (extended_insulation_rating,
field_airborne_insulation, facade_field_insulation,
survey_impact_insulation) generated in the four language/theme variants,
embedded next to their snippets in the EN guide, the ES mirror and the
docs mirror with the dual usage/hand-written code blocks. One-line
.plot() mentions added for the extended rating, the field airborne
result, the survey impact result and the ISO 12999-1 band uncertainty.
The docs mirror gains the previously missing ISO 10052 survey-reports
section, and the survey snippet now defines the li and l1_2m inputs it
uses. Multi-line figure info boxes are translated as whole artists, and
the review fixes (headroom, legend placement, proper unit and Greek
glyphs) are applied to the new generators.
* Laboratory insulation guide: ISO 10140, ISO 15186-1 element and ISO 10848 Dn,f figures
Embed the new lab_insulation_result, intensity_element_insulation and
flanking_level_difference figures next to their snippets in the EN guide,
the ES mirror and the docs mirror, each with the dual usage/hand-written
code blocks. Add the one-line .plot() mentions for the laboratory
airborne result, the element-normalized intensity result and the
floor-covering improvement result, and a note on when Dn,f plots (the
inline example uses 9 bands, below the 16/5-band rating threshold).
* EN 12354 prediction guide: impact-term and radiated-power figures
Embed the new impact_prediction_terms and radiated_power_outdoor figures
next to their snippets in the EN guide, the ES mirror and the docs
mirror, with the dual usage/hand-written code blocks, and add the
one-line .plot() mentions for the airborne prediction, the impact
prediction, the facade prediction and the radiated-power result.
* Panel insulation guide: rated Sharp prediction figure and plot mentions
Embed the new single_panel_rating figure (the 6 mm glass Sharp prediction
rated per ISO 717-1, coincidence dip marked) in the EN guide, the ES
mirror and the docs mirror with the dual code blocks, and add the
one-line .plot() mentions for the single-panel, double-wall and
radiation-efficiency results next to the existing concept figure.
* Junction transmission guide: Kij design chart, EN 12354 worked example and see-also
Add the junction_kij_thickness figure (wave-approach Kij versus the plate
thickness ratio for the X, T and L junctions, identical-plates value
marked) next to the coupling-loss-factor section, a res.plot() mention
in its snippet, a worked example that feeds the predicted K12 = 9.8 dB
of the 100/200 mm concrete X-junction into the EN 12354-1 flanking model
(R'w = 55.4 dB, direct path dominant), and a See-also section linking
the prediction, laboratory, structure-borne power and mobility guides.
EN guide, ES mirror and docs mirror in sync.
* Junction transmission docs mirror: sync the Kij chart, worked example and see-also
* Structure-borne power and installed-source guides: plot mentions, Hopkins citation and see-also
Add the one-line .plot() mentions for the reception-plate power result
(EN 15657) and the installed-source prediction (EN 12354-5) next to their
existing figures, add the one-line .plot() usage to both figures' code
blocks, cite Hopkins (2007) Section 2.8 for the point-excited-plate power
input behind the clause 4.4.3 coupling term with a prose paragraph
connecting the mobility chain, and give the EN 12354-5 page a proper
See-also linking the EN 15657, ISO 7626, junction and EN 12354 guides.
EN guides, ES mirrors and docs mirrors in sync.
* Vibration FRF guides: plot mentions and transfer-stiffness docs sync
Add the one-line .plot() usage and mentions for the ISO/TS 7849
sound-power-from-vibration result, the EN 29052-1 dynamic-stiffness
result and the ISO 10846 indirect transfer-stiffness result next to
their existing figures (EN guides, ES mirrors and docs mirrors), and
port the previously missing ISO 10846 test-report fiche section to the
transfer-stiffness docs mirror.
* Mechanical mobility guide: driving-point reading figure
Embed the new mobility_result_lines figure (|Y(f)| of the SDOF bundle
with the stiffness line, the mass line and the 1/c damping peak) next to
the MobilityResult snippet in the EN guide, the ES mirror and the docs
mirror, with the dual usage/hand-written code blocks and the one-line
res.plot() mention.
* Human vibration and multiple-shock guides: one-line plot mentions
Add the res.plot() one-liners next to the existing figures for the
ISO 8041-1 weighting response, the ISO 2631-1 weighted band spectrum, the
Directive 2002/44/EC daily exposure A(8) and the ISO 2631-5 multiple-shock
assessment, in the EN guides, the ES mirrors and the docs mirrors.
* Docs mirrors: restore missing report-fiche and concept sections
Sync the docs mirrors of the pages touched by this wave with their site
guides: the ISO 16283-3 facade report subsection on the field insulation
page, the EN 29052-1 and ISO 7626 fiche example snippets, and the panel
concept-figure code block.
* Changelog, API docs and llms regeneration; lint and typing fixes for the figure generators
* Fix nested emphasis in the survey-impact figure captions
* Restore the numerical-propagation rasters truncated by a mid-regeneration snapshot
* Reconcile the figure-script additions with the rooms and materials wave
* docs: regenerate the llms bundle after the figure-script reconciliation
Building and structure-borne guides: result figures, plot mentions and mirror sync (#360)
* Add .plot() to the ISO 717 enlarged-range rating results
ExtendedWeightedRatingResult and ExtendedImpactRatingResult now carry the
full enlarged-range band curve (band_centers, measured) and expose a
.plot() that draws the measured curve over the whole range against the
shifted ISO 717 reference on the 16 core bands, with the unfavourable
deviations shaded, the enlarged-range bands marked and every covered
Annex B / A.2.1 adaptation term in the title. EN/ES labels follow the
existing renderer conventions.
* Field insulation guide: enlarged-range, field-chain, facade and survey-impact figures
Four new deterministic figures (extended_insulation_rating,
field_airborne_insulation, facade_field_insulation,
survey_impact_insulation) generated in the four language/theme variants,
embedded next to their snippets in the EN guide, the ES mirror and the
docs mirror with the dual usage/hand-written code blocks. One-line
.plot() mentions added for the extended rating, the field airborne
result, the survey impact result and the ISO 12999-1 band uncertainty.
The docs mirror gains the previously missing ISO 10052 survey-reports
section, and the survey snippet now defines the li and l1_2m inputs it
uses. Multi-line figure info boxes are translated as whole artists, and
the review fixes (headroom, legend placement, proper unit and Greek
glyphs) are applied to the new generators.
* Laboratory insulation guide: ISO 10140, ISO 15186-1 element and ISO 10848 Dn,f figures
Embed the new lab_insulation_result, intensity_element_insulation and
flanking_level_difference figures next to their snippets in the EN guide,
the ES mirror and the docs mirror, each with the dual usage/hand-written
code blocks. Add the one-line .plot() mentions for the laboratory
airborne result, the element-normalized intensity result and the
floor-covering improvement result, and a note on when Dn,f plots (the
inline example uses 9 bands, below the 16/5-band rating threshold).
* EN 12354 prediction guide: impact-term and radiated-power figures
Embed the new impact_prediction_terms and radiated_power_outdoor figures
next to their snippets in the EN guide, the ES mirror and the docs
mirror, with the dual usage/hand-written code blocks, and add the
one-line .plot() mentions for the airborne prediction, the impact
prediction, the facade prediction and the radiated-power result.
* Panel insulation guide: rated Sharp prediction figure and plot mentions
Embed the new single_panel_rating figure (the 6 mm glass Sharp prediction
rated per ISO 717-1, coincidence dip marked) in the EN guide, the ES
mirror and the docs mirror with the dual code blocks, and add the
one-line .plot() mentions for the single-panel, double-wall and
radiation-efficiency results next to the existing concept figure.
* Junction transmission guide: Kij design chart, EN 12354 worked example and see-also
Add the junction_kij_thickness figure (wave-approach Kij versus the plate
thickness ratio for the X, T and L junctions, identical-plates value
marked) next to the coupling-loss-factor section, a res.plot() mention
in its snippet, a worked example that feeds the predicted K12 = 9.8 dB
of the 100/200 mm concrete X-junction into the EN 12354-1 flanking model
(R'w = 55.4 dB, direct path dominant), and a See-also section linking
the prediction, laboratory, structure-borne power and mobility guides.
EN guide, ES mirror and docs mirror in sync.
* Junction transmission docs mirror: sync the Kij chart, worked example and see-also
* Structure-borne power and installed-source guides: plot mentions, Hopkins citation and see-also
Add the one-line .plot() mentions for the reception-plate power result
(EN 15657) and the installed-source prediction (EN 12354-5) next to their
existing figures, add the one-line .plot() usage to both figures' code
blocks, cite Hopkins (2007) Section 2.8 for the point-excited-plate power
input behind the clause 4.4.3 coupling term with a prose paragraph
connecting the mobility chain, and give the EN 12354-5 page a proper
See-also linking the EN 15657, ISO 7626, junction and EN 12354 guides.
EN guides, ES mirrors and docs mirrors in sync.
* Vibration FRF guides: plot mentions and transfer-stiffness docs sync
Add the one-line .plot() usage and mentions for the ISO/TS 7849
sound-power-from-vibration result, the EN 29052-1 dynamic-stiffness
result and the ISO 10846 indirect transfer-stiffness result next to
their existing figures (EN guides, ES mirrors and docs mirrors), and
port the previously missing ISO 10846 test-report fiche section to the
transfer-stiffness docs mirror.
* Mechanical mobility guide: driving-point reading figure
Embed the new mobility_result_lines figure (|Y(f)| of the SDOF bundle
with the stiffness line, the mass line and the 1/c damping peak) next to
the MobilityResult snippet in the EN guide, the ES mirror and the docs
mirror, with the dual usage/hand-written code blocks and the one-line
res.plot() mention.
* Human vibration and multiple-shock guides: one-line plot mentions
Add the res.plot() one-liners next to the existing figures for the
ISO 8041-1 weighting response, the ISO 2631-1 weighted band spectrum, the
Directive 2002/44/EC daily exposure A(8) and the ISO 2631-5 multiple-shock
assessment, in the EN guides, the ES mirrors and the docs mirrors.
* Docs mirrors: restore missing report-fiche and concept sections
Sync the docs mirrors of the pages touched by this wave with their site
guides: the ISO 16283-3 facade report subsection on the field insulation
page, the EN 29052-1 and ISO 7626 fiche example snippets, and the panel
concept-figure code block.
* Changelog, API docs and llms regeneration; lint and typing fixes for the figure generators
* Fix nested emphasis in the survey-impact figure captions
* Restore the numerical-propagation rasters truncated by a mid-regeneration snapshot
* Reconcile the figure-script additions with the rooms and materials wave
* docs: regenerate the llms bundle after the figure-script reconciliation
Building and structure-borne guides: result figures, plot mentions and mirror sync (#360)
* Add .plot() to the ISO 717 enlarged-range rating results
ExtendedWeightedRatingResult and ExtendedImpactRatingResult now carry the
full enlarged-range band curve (band_centers, measured) and expose a
.plot() that draws the measured curve over the whole range against the
shifted ISO 717 reference on the 16 core bands, with the unfavourable
deviations shaded, the enlarged-range bands marked and every covered
Annex B / A.2.1 adaptation term in the title. EN/ES labels follow the
existing renderer conventions.
* Field insulation guide: enlarged-range, field-chain, facade and survey-impact figures
Four new deterministic figures (extended_insulation_rating,
field_airborne_insulation, facade_field_insulation,
survey_impact_insulation) generated in the four language/theme variants,
embedded next to their snippets in the EN guide, the ES mirror and the
docs mirror with the dual usage/hand-written code blocks. One-line
.plot() mentions added for the extended rating, the field airborne
result, the survey impact result and the ISO 12999-1 band uncertainty.
The docs mirror gains the previously missing ISO 10052 survey-reports
section, and the survey snippet now defines the li and l1_2m inputs it
uses. Multi-line figure info boxes are translated as whole artists, and
the review fixes (headroom, legend placement, proper unit and Greek
glyphs) are applied to the new generators.
* Laboratory insulation guide: ISO 10140, ISO 15186-1 element and ISO 10848 Dn,f figures
Embed the new lab_insulation_result, intensity_element_insulation and
flanking_level_difference figures next to their snippets in the EN guide,
the ES mirror and the docs mirror, each with the dual usage/hand-written
code blocks. Add the one-line .plot() mentions for the laboratory
airborne result, the element-normalized intensity result and the
floor-covering improvement result, and a note on when Dn,f plots (the
inline example uses 9 bands, below the 16/5-band rating threshold).
* EN 12354 prediction guide: impact-term and radiated-power figures
Embed the new impact_prediction_terms and radiated_power_outdoor figures
next to their snippets in the EN guide, the ES mirror and the docs
mirror, with the dual usage/hand-written code blocks, and add the
one-line .plot() mentions for the airborne prediction, the impact
prediction, the facade prediction and the radiated-power result.
* Panel insulation guide: rated Sharp prediction figure and plot mentions
Embed the new single_panel_rating figure (the 6 mm glass Sharp prediction
rated per ISO 717-1, coincidence dip marked) in the EN guide, the ES
mirror and the docs mirror with the dual code blocks, and add the
one-line .plot() mentions for the single-panel, double-wall and
radiation-efficiency results next to the existing concept figure.
* Junction transmission guide: Kij design chart, EN 12354 worked example and see-also
Add the junction_kij_thickness figure (wave-approach Kij versus the plate
thickness ratio for the X, T and L junctions, identical-plates value
marked) next to the coupling-loss-factor section, a res.plot() mention
in its snippet, a worked example that feeds the predicted K12 = 9.8 dB
of the 100/200 mm concrete X-junction into the EN 12354-1 flanking model
(R'w = 55.4 dB, direct path dominant), and a See-also section linking
the prediction, laboratory, structure-borne power and mobility guides.
EN guide, ES mirror and docs mirror in sync.
* Junction transmission docs mirror: sync the Kij chart, worked example and see-also
* Structure-borne power and installed-source guides: plot mentions, Hopkins citation and see-also
Add the one-line .plot() mentions for the reception-plate power result
(EN 15657) and the installed-source prediction (EN 12354-5) next to their
existing figures, add the one-line .plot() usage to both figures' code
blocks, cite Hopkins (2007) Section 2.8 for the point-excited-plate power
input behind the clause 4.4.3 coupling term with a prose paragraph
connecting the mobility chain, and give the EN 12354-5 page a proper
See-also linking the EN 15657, ISO 7626, junction and EN 12354 guides.
EN guides, ES mirrors and docs mirrors in sync.
* Vibration FRF guides: plot mentions and transfer-stiffness docs sync
Add the one-line .plot() usage and mentions for the ISO/TS 7849
sound-power-from-vibration result, the EN 29052-1 dynamic-stiffness
result and the ISO 10846 indirect transfer-stiffness result next to
their existing figures (EN guides, ES mirrors and docs mirrors), and
port the previously missing ISO 10846 test-report fiche section to the
transfer-stiffness docs mirror.
* Mechanical mobility guide: driving-point reading figure
Embed the new mobility_result_lines figure (|Y(f)| of the SDOF bundle
with the stiffness line, the mass line and the 1/c damping peak) next to
the MobilityResult snippet in the EN guide, the ES mirror and the docs
mirror, with the dual usage/hand-written code blocks and the one-line
res.plot() mention.
* Human vibration and multiple-shock guides: one-line plot mentions
Add the res.plot() one-liners next to the existing figures for the
ISO 8041-1 weighting response, the ISO 2631-1 weighted band spectrum, the
Directive 2002/44/EC daily exposure A(8) and the ISO 2631-5 multiple-shock
assessment, in the EN guides, the ES mirrors and the docs mirrors.
* Docs mirrors: restore missing report-fiche and concept sections
Sync the docs mirrors of the pages touched by this wave with their site
guides: the ISO 16283-3 facade report subsection on the field insulation
page, the EN 29052-1 and ISO 7626 fiche example snippets, and the panel
concept-figure code block.
* Changelog, API docs and llms regeneration; lint and typing fixes for the figure generators
* Fix nested emphasis in the survey-impact figure captions
* Restore the numerical-propagation rasters truncated by a mid-regeneration snapshot
* Reconcile the figure-script additions with the rooms and materials wave
* docs: regenerate the llms bundle after the figure-script reconciliation
Spanish docs: UNE terminology, decimal commas, localized snippets and theory figures (#365)
* Normalize Spanish docs prose to UNE acoustic terminology
Sweep the Spanish pages for the non-UNE forms "presion sonora",
"potencia sonora" and "intensidad sonora" and normalize the prose to
the wording used by the official Spanish editions of the standards:
"presion acustica" (UNE-EN ISO 16283-2:2016, UNE-EN ISO 10052:2005,
UNE-EN ISO 3746:2011, UNE-ISO 226:2013), "potencia acustica"
(UNE-EN ISO 3746:2011, UNE-EN ISO 4871:2010, UNE-EN ISO 9614-1:2010),
"intensidad acustica" (UNE-EN 61043:1999, UNE-EN ISO 9614-1:2010) and
"nivel de presion acustica de impactos" (UNE-EN ISO 12354-2:2018,
UNE-EN ISO 717-2:2013). 92 replacements across 32 pages, prose only:
code snippets keep the labels they share with the generated figures.
Rename the intensity guide to "Intensidad acustica (p-p)" and the
structure-borne power guide to "Potencia acustica estructural de
equipos (EN 15657)", updating every cross-link text and the theory
anchor intensidad-sonora-iec-61043 accordingly. The API sidebar group
label becomes "Potencia acustica e intensidad" via api_taxonomy.py
with the generated sidebar regenerated.
* Use decimal commas in Spanish docs prose quantities
Sweep every Spanish page for decimal points leaking into prose numbers
and switch them to the comma the locale convention calls for: the
rotorcraft validation prose (fourteen tolerances such as 0,08 dB(A) and
0,5 s), the insulation-prediction worked example (53,6 dB / 53,8 dB),
the tone-audibility Annex E tone (137,3 Hz), the Mackenzie check value
(1550,744 m/s), the EPNL, loudness and absorption fiche descriptions
(98,3 EPNdB; 8,2 sonos and 70,4 fonios; 0,60 y 0,55), the junction
constants table and the third-octave band-edge table in the signal
analysis theory page. Code snippets, inline code, math, clause numbers
and quoted source text keep their points.
* Pass language="es" in Spanish figure-reproduction snippets
The <details> blocks under each localized figure in the Spanish guides
are meant to reproduce the _es variant shown on the page, but 82 of the
one-line result .plot() calls omitted the language="es" argument and
would render English axis labels instead. Add the argument across 33
guides, matching the pattern the intensity field-indicators snippet
already used. The three lab-insulation results whose plot() does not
take a language argument (lab airborne, lab impact and the
element-normalized intensity difference) are left as they were.
* Extend the UNE terminology sweep to sound absorption
Normalize "absorción sonora" to "absorción acústica" across the
Spanish pages (36 occurrences in 14 pages, including the EN 12354-6
guide title and the theory headings), the wording of UNE-EN ISO
3746:2011 and of the equivalent absorption area in UNE-EN ISO
10140-3:2011, UNE-EN ISO 12354-2:2018 and UNE-EN ISO 16283-2:2016, and
the same term the accredited report strings already use. Also restore
the accent in the theory index anchor to the renamed intensity heading,
since heading slugs keep accented characters.
* Theory pages: illustrate each section family with existing result figures
The seven theory pages carried no figures at all. Embed sixteen of the
existing generated figures (light and dark variants, Spanish variants on
the Spanish mirrors) where the concept matches the prose: weighting
curves, time integration and the p-p intensity estimator in the signal
analysis page; equal-loudness contours, the specific-loudness pattern
and the hearing-threshold panels in perception; NC/RC rating, the
Schroeder decay and the ISO 717-1 shifted reference in rooms and
buildings; the Lden profile, ISO 9613-1 absorption and the three sound
power routes in environment and transport; the scattering coefficient
and ISO 11654 rating in materials and surfaces; and the Wk weighting and
the resonator mobility triplet in vibration. Each embed reuses the alt
text of the guide that owns the figure and adds a one-line caption.
Also give the wave-simulation section hub the reading-order paragraph
its siblings already have, linking the closed-form pages the FDTD solver
cross-checks, in both languages.
* Address review findings from the Spanish locale sweeps
Second pass fixes flagged by review: five terminology occurrences the
line-based sweep missed because the noun and adjective were split by a
line wrap or emphasis markup (sound-power, rotorcraft-noise and two
section hubs); six Spanish pages that still embedded the English figure
variant although the _es variant exists (junction-transmission,
aircraft-noise airport contour, miso-coherence,
objective-intelligibility, psychoacoustic-annoyance twice); and 19 more
language="es" arguments on figure-reproduction plot calls the first
pass missed, chained-call receivers such as room.noise_criterion(spl)
.plot() and the axes-creating first call of the two-profile
atmospheric-refraction snippet among them. The lab-insulation plot
wrappers forward keyword arguments to the rating plot, so the three
calls excluded earlier now take the argument too. All Spanish python
fences re-checked to compile and EN/ES parity re-verified.
* Carry the UNE terminology into the generated-asset Spanish strings
Apply the same evidence-based decisions to every Spanish string source
that feeds generated assets: the translation tables of
generate_graphs.py and generate_diagrams.py, the _STRINGS tables of the
plot modules and the report i18n values. 35 strings change: "presión
acústica" (UNE-EN ISO 16283-2:2016, 10052:2005, 3746:2011),
"potencia acústica" (UNE-EN ISO 3746:2011, 4871:2010, 9614-1:2010),
"intensidad acústica" (UNE-EN 61043:1999, 9614-1:2010), "absorción
acústica" (UNE-EN ISO 3746:2011) and "nivel de presión acústica de
impactos" (UNE-EN ISO 12354-2:2018). Strings the UNE editions keep are
untouched: "emisión sonora", "exposición sonora", "campo sonoro",
"fuente sonora". Only Spanish values change; the English keys stay.
The two plot-i18n test assertions that pin the axis label follow, and
the eight Spanish doc fences that deliberately mirrored the old figure
labels now mirror the new ones.
* Regenerate the Spanish figure variants with the UNE terminology
make graphs after the string-source change: 48 files, all of them _es
or _es_dark variants (24 figure/diagram pairs), picking up "presión
acústica", "potencia acústica", "intensidad acústica", "absorción
acústica" and "nivel de presión acústica de impactos" in titles and
axis labels. The English variants are untouched. The committed example
fiches need no regeneration: every example in generate_reports.py
renders in English, so no changed Spanish report string reaches them.
* Align the intensity-fiche Spanish assertions with the UNE terminology
Spanish docs: UNE terminology, decimal commas, localized snippets and theory figures (#365)
* Normalize Spanish docs prose to UNE acoustic terminology
Sweep the Spanish pages for the non-UNE forms "presion sonora",
"potencia sonora" and "intensidad sonora" and normalize the prose to
the wording used by the official Spanish editions of the standards:
"presion acustica" (UNE-EN ISO 16283-2:2016, UNE-EN ISO 10052:2005,
UNE-EN ISO 3746:2011, UNE-ISO 226:2013), "potencia acustica"
(UNE-EN ISO 3746:2011, UNE-EN ISO 4871:2010, UNE-EN ISO 9614-1:2010),
"intensidad acustica" (UNE-EN 61043:1999, UNE-EN ISO 9614-1:2010) and
"nivel de presion acustica de impactos" (UNE-EN ISO 12354-2:2018,
UNE-EN ISO 717-2:2013). 92 replacements across 32 pages, prose only:
code snippets keep the labels they share with the generated figures.
Rename the intensity guide to "Intensidad acustica (p-p)" and the
structure-borne power guide to "Potencia acustica estructural de
equipos (EN 15657)", updating every cross-link text and the theory
anchor intensidad-sonora-iec-61043 accordingly. The API sidebar group
label becomes "Potencia acustica e intensidad" via api_taxonomy.py
with the generated sidebar regenerated.
* Use decimal commas in Spanish docs prose quantities
Sweep every Spanish page for decimal points leaking into prose numbers
and switch them to the comma the locale convention calls for: the
rotorcraft validation prose (fourteen tolerances such as 0,08 dB(A) and
0,5 s), the insulation-prediction worked example (53,6 dB / 53,8 dB),
the tone-audibility Annex E tone (137,3 Hz), the Mackenzie check value
(1550,744 m/s), the EPNL, loudness and absorption fiche descriptions
(98,3 EPNdB; 8,2 sonos and 70,4 fonios; 0,60 y 0,55), the junction
constants table and the third-octave band-edge table in the signal
analysis theory page. Code snippets, inline code, math, clause numbers
and quoted source text keep their points.
* Pass language="es" in Spanish figure-reproduction snippets
The <details> blocks under each localized figure in the Spanish guides
are meant to reproduce the _es variant shown on the page, but 82 of the
one-line result .plot() calls omitted the language="es" argument and
would render English axis labels instead. Add the argument across 33
guides, matching the pattern the intensity field-indicators snippet
already used. The three lab-insulation results whose plot() does not
take a language argument (lab airborne, lab impact and the
element-normalized intensity difference) are left as they were.
* Extend the UNE terminology sweep to sound absorption
Normalize "absorción sonora" to "absorción acústica" across the
Spanish pages (36 occurrences in 14 pages, including the EN 12354-6
guide title and the theory headings), the wording of UNE-EN ISO
3746:2011 and of the equivalent absorption area in UNE-EN ISO
10140-3:2011, UNE-EN ISO 12354-2:2018 and UNE-EN ISO 16283-2:2016, and
the same term the accredited report strings already use. Also restore
the accent in the theory index anchor to the renamed intensity heading,
since heading slugs keep accented characters.
* Theory pages: illustrate each section family with existing result figures
The seven theory pages carried no figures at all. Embed sixteen of the
existing generated figures (light and dark variants, Spanish variants on
the Spanish mirrors) where the concept matches the prose: weighting
curves, time integration and the p-p intensity estimator in the signal
analysis page; equal-loudness contours, the specific-loudness pattern
and the hearing-threshold panels in perception; NC/RC rating, the
Schroeder decay and the ISO 717-1 shifted reference in rooms and
buildings; the Lden profile, ISO 9613-1 absorption and the three sound
power routes in environment and transport; the scattering coefficient
and ISO 11654 rating in materials and surfaces; and the Wk weighting and
the resonator mobility triplet in vibration. Each embed reuses the alt
text of the guide that owns the figure and adds a one-line caption.
Also give the wave-simulation section hub the reading-order paragraph
its siblings already have, linking the closed-form pages the FDTD solver
cross-checks, in both languages.
* Address review findings from the Spanish locale sweeps
Second pass fixes flagged by review: five terminology occurrences the
line-based sweep missed because the noun and adjective were split by a
line wrap or emphasis markup (sound-power, rotorcraft-noise and two
section hubs); six Spanish pages that still embedded the English figure
variant although the _es variant exists (junction-transmission,
aircraft-noise airport contour, miso-coherence,
objective-intelligibility, psychoacoustic-annoyance twice); and 19 more
language="es" arguments on figure-reproduction plot calls the first
pass missed, chained-call receivers such as room.noise_criterion(spl)
.plot() and the axes-creating first call of the two-profile
atmospheric-refraction snippet among them. The lab-insulation plot
wrappers forward keyword arguments to the rating plot, so the three
calls excluded earlier now take the argument too. All Spanish python
fences re-checked to compile and EN/ES parity re-verified.
* Carry the UNE terminology into the generated-asset Spanish strings
Apply the same evidence-based decisions to every Spanish string source
that feeds generated assets: the translation tables of
generate_graphs.py and generate_diagrams.py, the _STRINGS tables of the
plot modules and the report i18n values. 35 strings change: "presión
acústica" (UNE-EN ISO 16283-2:2016, 10052:2005, 3746:2011),
"potencia acústica" (UNE-EN ISO 3746:2011, 4871:2010, 9614-1:2010),
"intensidad acústica" (UNE-EN 61043:1999, 9614-1:2010), "absorción
acústica" (UNE-EN ISO 3746:2011) and "nivel de presión acústica de
impactos" (UNE-EN ISO 12354-2:2018). Strings the UNE editions keep are
untouched: "emisión sonora", "exposición sonora", "campo sonoro",
"fuente sonora". Only Spanish values change; the English keys stay.
The two plot-i18n test assertions that pin the axis label follow, and
the eight Spanish doc fences that deliberately mirrored the old figure
labels now mirror the new ones.
* Regenerate the Spanish figure variants with the UNE terminology
make graphs after the string-source change: 48 files, all of them _es
or _es_dark variants (24 figure/diagram pairs), picking up "presión
acústica", "potencia acústica", "intensidad acústica", "absorción
acústica" and "nivel de presión acústica de impactos" in titles and
axis labels. The English variants are untouched. The committed example
fiches need no regeneration: every example in generate_reports.py
renders in English, so no changed Spanish report string reaches them.
* Align the intensity-fiche Spanish assertions with the UNE terminology
Spanish docs: UNE terminology, decimal commas, localized snippets and theory figures (#365)
* Normalize Spanish docs prose to UNE acoustic terminology
Sweep the Spanish pages for the non-UNE forms "presion sonora",
"potencia sonora" and "intensidad sonora" and normalize the prose to
the wording used by the official Spanish editions of the standards:
"presion acustica" (UNE-EN ISO 16283-2:2016, UNE-EN ISO 10052:2005,
UNE-EN ISO 3746:2011, UNE-ISO 226:2013), "potencia acustica"
(UNE-EN ISO 3746:2011, UNE-EN ISO 4871:2010, UNE-EN ISO 9614-1:2010),
"intensidad acustica" (UNE-EN 61043:1999, UNE-EN ISO 9614-1:2010) and
"nivel de presion acustica de impactos" (UNE-EN ISO 12354-2:2018,
UNE-EN ISO 717-2:2013). 92 replacements across 32 pages, prose only:
code snippets keep the labels they share with the generated figures.
Rename the intensity guide to "Intensidad acustica (p-p)" and the
structure-borne power guide to "Potencia acustica estructural de
equipos (EN 15657)", updating every cross-link text and the theory
anchor intensidad-sonora-iec-61043 accordingly. The API sidebar group
label becomes "Potencia acustica e intensidad" via api_taxonomy.py
with the generated sidebar regenerated.
* Use decimal commas in Spanish docs prose quantities
Sweep every Spanish page for decimal points leaking into prose numbers
and switch them to the comma the locale convention calls for: the
rotorcraft validation prose (fourteen tolerances such as 0,08 dB(A) and
0,5 s), the insulation-prediction worked example (53,6 dB / 53,8 dB),
the tone-audibility Annex E tone (137,3 Hz), the Mackenzie check value
(1550,744 m/s), the EPNL, loudness and absorption fiche descriptions
(98,3 EPNdB; 8,2 sonos and 70,4 fonios; 0,60 y 0,55), the junction
constants table and the third-octave band-edge table in the signal
analysis theory page. Code snippets, inline code, math, clause numbers
and quoted source text keep their points.
* Pass language="es" in Spanish figure-reproduction snippets
The <details> blocks under each localized figure in the Spanish guides
are meant to reproduce the _es variant shown on the page, but 82 of the
one-line result .plot() calls omitted the language="es" argument and
would render English axis labels instead. Add the argument across 33
guides, matching the pattern the intensity field-indicators snippet
already used. The three lab-insulation results whose plot() does not
take a language argument (lab airborne, lab impact and the
element-normalized intensity difference) are left as they were.
* Extend the UNE terminology sweep to sound absorption
Normalize "absorción sonora" to "absorción acústica" across the
Spanish pages (36 occurrences in 14 pages, including the EN 12354-6
guide title and the theory headings), the wording of UNE-EN ISO
3746:2011 and of the equivalent absorption area in UNE-EN ISO
10140-3:2011, UNE-EN ISO 12354-2:2018 and UNE-EN ISO 16283-2:2016, and
the same term the accredited report strings already use. Also restore
the accent in the theory index anchor to the renamed intensity heading,
since heading slugs keep accented characters.
* Theory pages: illustrate each section family with existing result figures
The seven theory pages carried no figures at all. Embed sixteen of the
existing generated figures (light and dark variants, Spanish variants on
the Spanish mirrors) where the concept matches the prose: weighting
curves, time integration and the p-p intensity estimator in the signal
analysis page; equal-loudness contours, the specific-loudness pattern
and the hearing-threshold panels in perception; NC/RC rating, the
Schroeder decay and the ISO 717-1 shifted reference in rooms and
buildings; the Lden profile, ISO 9613-1 absorption and the three sound
power routes in environment and transport; the scattering coefficient
and ISO 11654 rating in materials and surfaces; and the Wk weighting and
the resonator mobility triplet in vibration. Each embed reuses the alt
text of the guide that owns the figure and adds a one-line caption.
Also give the wave-simulation section hub the reading-order paragraph
its siblings already have, linking the closed-form pages the FDTD solver
cross-checks, in both languages.
* Address review findings from the Spanish locale sweeps
Second pass fixes flagged by review: five terminology occurrences the
line-based sweep missed because the noun and adjective were split by a
line wrap or emphasis markup (sound-power, rotorcraft-noise and two
section hubs); six Spanish pages that still embedded the English figure
variant although the _es variant exists (junction-transmission,
aircraft-noise airport contour, miso-coherence,
objective-intelligibility, psychoacoustic-annoyance twice); and 19 more
language="es" arguments on figure-reproduction plot calls the first
pass missed, chained-call receivers such as room.noise_criterion(spl)
.plot() and the axes-creating first call of the two-profile
atmospheric-refraction snippet among them. The lab-insulation plot
wrappers forward keyword arguments to the rating plot, so the three
calls excluded earlier now take the argument too. All Spanish python
fences re-checked to compile and EN/ES parity re-verified.
* Carry the UNE terminology into the generated-asset Spanish strings
Apply the same evidence-based decisions to every Spanish string source
that feeds generated assets: the translation tables of
generate_graphs.py and generate_diagrams.py, the _STRINGS tables of the
plot modules and the report i18n values. 35 strings change: "presión
acústica" (UNE-EN ISO 16283-2:2016, 10052:2005, 3746:2011),
"potencia acústica" (UNE-EN ISO 3746:2011, 4871:2010, 9614-1:2010),
"intensidad acústica" (UNE-EN 61043:1999, 9614-1:2010), "absorción
acústica" (UNE-EN ISO 3746:2011) and "nivel de presión acústica de
impactos" (UNE-EN ISO 12354-2:2018). Strings the UNE editions keep are
untouched: "emisión sonora", "exposición sonora", "campo sonoro",
"fuente sonora". Only Spanish values change; the English keys stay.
The two plot-i18n test assertions that pin the axis label follow, and
the eight Spanish doc fences that deliberately mirrored the old figure
labels now mirror the new ones.
* Regenerate the Spanish figure variants with the UNE terminology
make graphs after the string-source change: 48 files, all of them _es
or _es_dark variants (24 figure/diagram pairs), picking up "presión
acústica", "potencia acústica", "intensidad acústica", "absorción
acústica" and "nivel de presión acústica de impactos" in titles and
axis labels. The English variants are untouched. The committed example
fiches need no regeneration: every example in generate_reports.py
renders in English, so no changed Spanish report string reaches them.
* Align the intensity-fiche Spanish assertions with the UNE terminology
Spanish docs: UNE terminology, decimal commas, localized snippets and theory figures (#365)
* Normalize Spanish docs prose to UNE acoustic terminology
Sweep the Spanish pages for the non-UNE forms "presion sonora",
"potencia sonora" and "intensidad sonora" and normalize the prose to
the wording used by the official Spanish editions of the standards:
"presion acustica" (UNE-EN ISO 16283-2:2016, UNE-EN ISO 10052:2005,
UNE-EN ISO 3746:2011, UNE-ISO 226:2013), "potencia acustica"
(UNE-EN ISO 3746:2011, UNE-EN ISO 4871:2010, UNE-EN ISO 9614-1:2010),
"intensidad acustica" (UNE-EN 61043:1999, UNE-EN ISO 9614-1:2010) and
"nivel de presion acustica de impactos" (UNE-EN ISO 12354-2:2018,
UNE-EN ISO 717-2:2013). 92 replacements across 32 pages, prose only:
code snippets keep the labels they share with the generated figures.
Rename the intensity guide to "Intensidad acustica (p-p)" and the
structure-borne power guide to "Potencia acustica estructural de
equipos (EN 15657)", updating every cross-link text and the theory
anchor intensidad-sonora-iec-61043 accordingly. The API sidebar group
label becomes "Potencia acustica e intensidad" via api_taxonomy.py
with the generated sidebar regenerated.
* Use decimal commas in Spanish docs prose quantities
Sweep every Spanish page for decimal points leaking into prose numbers
and switch them to the comma the locale convention calls for: the
rotorcraft validation prose (fourteen tolerances such as 0,08 dB(A) and
0,5 s), the insulation-prediction worked example (53,6 dB / 53,8 dB),
the tone-audibility Annex E tone (137,3 Hz), the Mackenzie check value
(1550,744 m/s), the EPNL, loudness and absorption fiche descriptions
(98,3 EPNdB; 8,2 sonos and 70,4 fonios; 0,60 y 0,55), the junction
constants table and the third-octave band-edge table in the signal
analysis theory page. Code snippets, inline code, math, clause numbers
and quoted source text keep their points.
* Pass language="es" in Spanish figure-reproduction snippets
The <details> blocks under each localized figure in the Spanish guides
are meant to reproduce the _es variant shown on the page, but 82 of the
one-line result .plot() calls omitted the language="es" argument and
would render English axis labels instead. Add the argument across 33
guides, matching the pattern the intensity field-indicators snippet
already used. The three lab-insulation results whose plot() does not
take a language argument (lab airborne, lab impact and the
element-normalized intensity difference) are left as they were.
* Extend the UNE terminology sweep to sound absorption
Normalize "absorción sonora" to "absorción acústica" across the
Spanish pages (36 occurrences in 14 pages, including the EN 12354-6
guide title and the theory headings), the wording of UNE-EN ISO
3746:2011 and of the equivalent absorption area in UNE-EN ISO
10140-3:2011, UNE-EN ISO 12354-2:2018 and UNE-EN ISO 16283-2:2016, and
the same term the accredited report strings already use. Also restore
the accent in the theory index anchor to the renamed intensity heading,
since heading slugs keep accented characters.
* Theory pages: illustrate each section family with existing result figures
The seven theory pages carried no figures at all. Embed sixteen of the
existing generated figures (light and dark variants, Spanish variants on
the Spanish mirrors) where the concept matches the prose: weighting
curves, time integration and the p-p intensity estimator in the signal
analysis page; equal-loudness contours, the specific-loudness pattern
and the hearing-threshold panels in perception; NC/RC rating, the
Schroeder decay and the ISO 717-1 shifted reference in rooms and
buildings; the Lden profile, ISO 9613-1 absorption and the three sound
power routes in environment and transport; the scattering coefficient
and ISO 11654 rating in materials and surfaces; and the Wk weighting and
the resonator mobility triplet in vibration. Each embed reuses the alt
text of the guide that owns the figure and adds a one-line caption.
Also give the wave-simulation section hub the reading-order paragraph
its siblings already have, linking the closed-form pages the FDTD solver
cross-checks, in both languages.
* Address review findings from the Spanish locale sweeps
Second pass fixes flagged by review: five terminology occurrences the
line-based sweep missed because the noun and adjective were split by a
line wrap or emphasis markup (sound-power, rotorcraft-noise and two
section hubs); six Spanish pages that still embedded the English figure
variant although the _es variant exists (junction-transmission,
aircraft-noise airport contour, miso-coherence,
objective-intelligibility, psychoacoustic-annoyance twice); and 19 more
language="es" arguments on figure-reproduction plot calls the first
pass missed, chained-call receivers such as room.noise_criterion(spl)
.plot() and the axes-creating first call of the two-profile
atmospheric-refraction snippet among them. The lab-insulation plot
wrappers forward keyword arguments to the rating plot, so the three
calls excluded earlier now take the argument too. All Spanish python
fences re-checked to compile and EN/ES parity re-verified.
* Carry the UNE terminology into the generated-asset Spanish strings
Apply the same evidence-based decisions to every Spanish string source
that feeds generated assets: the translation tables of
generate_graphs.py and generate_diagrams.py, the _STRINGS tables of the
plot modules and the report i18n values. 35 strings change: "presión
acústica" (UNE-EN ISO 16283-2:2016, 10052:2005, 3746:2011),
"potencia acústica" (UNE-EN ISO 3746:2011, 4871:2010, 9614-1:2010),
"intensidad acústica" (UNE-EN 61043:1999, 9614-1:2010), "absorción
acústica" (UNE-EN ISO 3746:2011) and "nivel de presión acústica de
impactos" (UNE-EN ISO 12354-2:2018). Strings the UNE editions keep are
untouched: "emisión sonora", "exposición sonora", "campo sonoro",
"fuente sonora". Only Spanish values change; the English keys stay.
The two plot-i18n test assertions that pin the axis label follow, and
the eight Spanish doc fences that deliberately mirrored the old figure
labels now mirror the new ones.
* Regenerate the Spanish figure variants with the UNE terminology
make graphs after the string-source change: 48 files, all of them _es
or _es_dark variants (24 figure/diagram pairs), picking up "presión
acústica", "potencia acústica", "intensidad acústica", "absorción
acústica" and "nivel de presión acústica de impactos" in titles and
axis labels. The English variants are untouched. The committed example
fiches need no regeneration: every example in generate_reports.py
renders in English, so no changed Spanish report string reaches them.
* Align the intensity-fiche Spanish assertions with the UNE terminology
Perception, hearing and speech guides: result figures and when-to-use prose (#361)
* Perception, hearing and speech guides: result figures and when-to-use prose
Add ToneAssessment.plot(), which draws an ECMA-418-1 tone against the
prominence criterion of its own method (recovered from criterion_db) over the
whole range of interest, with the deciding margin marked, and a
view="levels" option on ToneAudibilityResult.plot() that exposes the
level-versus-frequency view the ISO 1996-2 fiche already embedded.
Add eleven single-concept figures to the perception, hearing and speech
guides, each a realistic result drawn by its own .plot(): the tone prominence
verdict, the ISO/PAS 20065 tone levels, the ISO/PAS 1996-3 onset detection,
the ISO 532-2 specific loudness, the ECMA-418-2 specific tonality, the
specific fluctuation strength, the SII band audibility under a hearing loss,
the ISO 7029 fractile band, the ISO 1999 NIPTS audiogram, the STOI per-band
correlation and the IEC 60268-16 per-band MTI. Every figure is embedded in
the English guide, the Spanish mirror and the docs mirror with the dual
snippet block, and every plottable snippet on those pages now names its
.plot().
Prose: the tone-prominence guide gains a comparison of the four tonality
assessments the library implements and when each applies, the
hearing-threshold guide explains how the ISO 7029 fractiles feed the ISO 1999
age component and gains a See-also section, and the objective-intelligibility
guide gains the "which measure, and when" section that existed only in the
docs mirror, extended with the STOI/ESTOI, STI and SII choice.
Also label the STOI band axis at whole-hertz resolution and let the shaded
critical band of the tone-audibility levels plot follow the figure
background, so it reads on the white report page and on dark figures alike.
* Correct two figure alt texts against the plotted values
The ISO 7029 fractile figure describes the median and the 90 % fractile with
the values it actually draws (10 to 50 dB and 22 to 74 dB), and the
ECMA-418-2 specific tonality peak is at 9 Bark_HMS.
Perception, hearing and speech guides: result figures and when-to-use prose (#361)
* Perception, hearing and speech guides: result figures and when-to-use prose
Add ToneAssessment.plot(), which draws an ECMA-418-1 tone against the
prominence criterion of its own method (recovered from criterion_db) over the
whole range of interest, with the deciding margin marked, and a
view="levels" option on ToneAudibilityResult.plot() that exposes the
level-versus-frequency view the ISO 1996-2 fiche already embedded.
Add eleven single-concept figures to the perception, hearing and speech
guides, each a realistic result drawn by its own .plot(): the tone prominence
verdict, the ISO/PAS 20065 tone levels, the ISO/PAS 1996-3 onset detection,
the ISO 532-2 specific loudness, the ECMA-418-2 specific tonality, the
specific fluctuation strength, the SII band audibility under a hearing loss,
the ISO 7029 fractile band, the ISO 1999 NIPTS audiogram, the STOI per-band
correlation and the IEC 60268-16 per-band MTI. Every figure is embedded in
the English guide, the Spanish mirror and the docs mirror with the dual
snippet block, and every plottable snippet on those pages now names its
.plot().
Prose: the tone-prominence guide gains a comparison of the four tonality
assessments the library implements and when each applies, the
hearing-threshold guide explains how the ISO 7029 fractiles feed the ISO 1999
age component and gains a See-also section, and the objective-intelligibility
guide gains the "which measure, and when" section that existed only in the
docs mirror, extended with the STOI/ESTOI, STI and SII choice.
Also label the STOI band axis at whole-hertz resolution and let the shaded
critical band of the tone-audibility levels plot follow the figure
background, so it reads on the white report page and on dark figures alike.
* Correct two figure alt texts against the plotted values
The ISO 7029 fractile figure describes the median and the 90 % fractile with
the values it actually draws (10 to 50 dB and 22 to 74 dB), and the
ECMA-418-2 specific tonality peak is at 9 Bark_HMS.
Perception, hearing and speech guides: result figures and when-to-use prose (#361)
* Perception, hearing and speech guides: result figures and when-to-use prose
Add ToneAssessment.plot(), which draws an ECMA-418-1 tone against the
prominence criterion of its own method (recovered from criterion_db) over the
whole range of interest, with the deciding margin marked, and a
view="levels" option on ToneAudibilityResult.plot() that exposes the
level-versus-frequency view the ISO 1996-2 fiche already embedded.
Add eleven single-concept figures to the perception, hearing and speech
guides, each a realistic result drawn by its own .plot(): the tone prominence
verdict, the ISO/PAS 20065 tone levels, the ISO/PAS 1996-3 onset detection,
the ISO 532-2 specific loudness, the ECMA-418-2 specific tonality, the
specific fluctuation strength, the SII band audibility under a hearing loss,
the ISO 7029 fractile band, the ISO 1999 NIPTS audiogram, the STOI per-band
correlation and the IEC 60268-16 per-band MTI. Every figure is embedded in
the English guide, the Spanish mirror and the docs mirror with the dual
snippet block, and every plottable snippet on those pages now names its
.plot().
Prose: the tone-prominence guide gains a comparison of the four tonality
assessments the library implements and when each applies, the
hearing-threshold guide explains how the ISO 7029 fractiles feed the ISO 1999
age component and gains a See-also section, and the objective-intelligibility
guide gains the "which measure, and when" section that existed only in the
docs mirror, extended with the STOI/ESTOI, STI and SII choice.
Also label the STOI band axis at whole-hertz resolution and let the shaded
critical band of the tone-audibility levels plot follow the figure
background, so it reads on the white report page and on dark figures alike.
* Correct two figure alt texts against the plotted values
The ISO 7029 fractile figure describes the median and the 90 % fractile with
the values it actually draws (10 to 50 dB and 22 to 74 dB), and the
ECMA-418-2 specific tonality peak is at 9 Bark_HMS.
Perception, hearing and speech guides: result figures and when-to-use prose (#361)
* Perception, hearing and speech guides: result figures and when-to-use prose
Add ToneAssessment.plot(), which draws an ECMA-418-1 tone against the
prominence criterion of its own method (recovered from criterion_db) over the
whole range of interest, with the deciding margin marked, and a
view="levels" option on ToneAudibilityResult.plot() that exposes the
level-versus-frequency view the ISO 1996-2 fiche already embedded.
Add eleven single-concept figures to the perception, hearing and speech
guides, each a realistic result drawn by its own .plot(): the tone prominence
verdict, the ISO/PAS 20065 tone levels, the ISO/PAS 1996-3 onset detection,
the ISO 532-2 specific loudness, the ECMA-418-2 specific tonality, the
specific fluctuation strength, the SII band audibility under a hearing loss,
the ISO 7029 fractile band, the ISO 1999 NIPTS audiogram, the STOI per-band
correlation and the IEC 60268-16 per-band MTI. Every figure is embedded in
the English guide, the Spanish mirror and the docs mirror with the dual
snippet block, and every plottable snippet on those pages now names its
.plot().
Prose: the tone-prominence guide gains a comparison of the four tonality
assessments the library implements and when each applies, the
hearing-threshold guide explains how the ISO 7029 fractiles feed the ISO 1999
age component and gains a See-also section, and the objective-intelligibility
guide gains the "which measure, and when" section that existed only in the
docs mirror, extended with the STOI/ESTOI, STI and SII choice.
Also label the STOI band axis at whole-hertz resolution and let the shaded
critical band of the tone-audibility levels plot follow the figure
background, so it reads on the white report page and on dark figures alike.
* Correct two figure alt texts against the plotted values
The ISO 7029 fractile figure describes the median and the 90 % fractile with
the values it actually draws (10 to 50 dB and 22 to 74 dB), and the
ECMA-418-2 specific tonality peak is at 9 Bark_HMS.
Spanish docs: UNE terminology, decimal commas, localized snippets and theory figures (#365)
* Normalize Spanish docs prose to UNE acoustic terminology
Sweep the Spanish pages for the non-UNE forms "presion sonora",
"potencia sonora" and "intensidad sonora" and normalize the prose to
the wording used by the official Spanish editions of the standards:
"presion acustica" (UNE-EN ISO 16283-2:2016, UNE-EN ISO 10052:2005,
UNE-EN ISO 3746:2011, UNE-ISO 226:2013), "potencia acustica"
(UNE-EN ISO 3746:2011, UNE-EN ISO 4871:2010, UNE-EN ISO 9614-1:2010),
"intensidad acustica" (UNE-EN 61043:1999, UNE-EN ISO 9614-1:2010) and
"nivel de presion acustica de impactos" (UNE-EN ISO 12354-2:2018,
UNE-EN ISO 717-2:2013). 92 replacements across 32 pages, prose only:
code snippets keep the labels they share with the generated figures.
Rename the intensity guide to "Intensidad acustica (p-p)" and the
structure-borne power guide to "Potencia acustica estructural de
equipos (EN 15657)", updating every cross-link text and the theory
anchor intensidad-sonora-iec-61043 accordingly. The API sidebar group
label becomes "Potencia acustica e intensidad" via api_taxonomy.py
with the generated sidebar regenerated.
* Use decimal commas in Spanish docs prose quantities
Sweep every Spanish page for decimal points leaking into prose numbers
and switch them to the comma the locale convention calls for: the
rotorcraft validation prose (fourteen tolerances such as 0,08 dB(A) and
0,5 s), the insulation-prediction worked example (53,6 dB / 53,8 dB),
the tone-audibility Annex E tone (137,3 Hz), the Mackenzie check value
(1550,744 m/s), the EPNL, loudness and absorption fiche descriptions
(98,3 EPNdB; 8,2 sonos and 70,4 fonios; 0,60 y 0,55), the junction
constants table and the third-octave band-edge table in the signal
analysis theory page. Code snippets, inline code, math, clause numbers
and quoted source text keep their points.
* Pass language="es" in Spanish figure-reproduction snippets
The <details> blocks under each localized figure in the Spanish guides
are meant to reproduce the _es variant shown on the page, but 82 of the
one-line result .plot() calls omitted the language="es" argument and
would render English axis labels instead. Add the argument across 33
guides, matching the pattern the intensity field-indicators snippet
already used. The three lab-insulation results whose plot() does not
take a language argument (lab airborne, lab impact and the
element-normalized intensity difference) are left as they were.
* Extend the UNE terminology sweep to sound absorption
Normalize "absorción sonora" to "absorción acústica" across the
Spanish pages (36 occurrences in 14 pages, including the EN 12354-6
guide title and the theory headings), the wording of UNE-EN ISO
3746:2011 and of the equivalent absorption area in UNE-EN ISO
10140-3:2011, UNE-EN ISO 12354-2:2018 and UNE-EN ISO 16283-2:2016, and
the same term the accredited report strings already use. Also restore
the accent in the theory index anchor to the renamed intensity heading,
since heading slugs keep accented characters.
* Theory pages: illustrate each section family with existing result figures
The seven theory pages carried no figures at all. Embed sixteen of the
existing generated figures (light and dark variants, Spanish variants on
the Spanish mirrors) where the concept matches the prose: weighting
curves, time integration and the p-p intensity estimator in the signal
analysis page; equal-loudness contours, the specific-loudness pattern
and the hearing-threshold panels in perception; NC/RC rating, the
Schroeder decay and the ISO 717-1 shifted reference in rooms and
buildings; the Lden profile, ISO 9613-1 absorption and the three sound
power routes in environment and transport; the scattering coefficient
and ISO 11654 rating in materials and surfaces; and the Wk weighting and
the resonator mobility triplet in vibration. Each embed reuses the alt
text of the guide that owns the figure and adds a one-line caption.
Also give the wave-simulation section hub the reading-order paragraph
its siblings already have, linking the closed-form pages the FDTD solver
cross-checks, in both languages.
* Address review findings from the Spanish locale sweeps
Second pass fixes flagged by review: five terminology occurrences the
line-based sweep missed because the noun and adjective were split by a
line wrap or emphasis markup (sound-power, rotorcraft-noise and two
section hubs); six Spanish pages that still embedded the English figure
variant although the _es variant exists (junction-transmission,
aircraft-noise airport contour, miso-coherence,
objective-intelligibility, psychoacoustic-annoyance twice); and 19 more
language="es" arguments on figure-reproduction plot calls the first
pass missed, chained-call receivers such as room.noise_criterion(spl)
.plot() and the axes-creating first call of the two-profile
atmospheric-refraction snippet among them. The lab-insulation plot
wrappers forward keyword arguments to the rating plot, so the three
calls excluded earlier now take the argument too. All Spanish python
fences re-checked to compile and EN/ES parity re-verified.
* Carry the UNE terminology into the generated-asset Spanish strings
Apply the same evidence-based decisions to every Spanish string source
that feeds generated assets: the translation tables of
generate_graphs.py and generate_diagrams.py, the _STRINGS tables of the
plot modules and the report i18n values. 35 strings change: "presión
acústica" (UNE-EN ISO 16283-2:2016, 10052:2005, 3746:2011),
"potencia acústica" (UNE-EN ISO 3746:2011, 4871:2010, 9614-1:2010),
"intensidad acústica" (UNE-EN 61043:1999, 9614-1:2010), "absorción
acústica" (UNE-EN ISO 3746:2011) and "nivel de presión acústica de
impactos" (UNE-EN ISO 12354-2:2018). Strings the UNE editions keep are
untouched: "emisión sonora", "exposición sonora", "campo sonoro",
"fuente sonora". Only Spanish values change; the English keys stay.
The two plot-i18n test assertions that pin the axis label follow, and
the eight Spanish doc fences that deliberately mirrored the old figure
labels now mirror the new ones.
* Regenerate the Spanish figure variants with the UNE terminology
make graphs after the string-source change: 48 files, all of them _es
or _es_dark variants (24 figure/diagram pairs), picking up "presión
acústica", "potencia acústica", "intensidad acústica", "absorción
acústica" and "nivel de presión acústica de impactos" in titles and
axis labels. The English variants are untouched. The committed example
fiches need no regeneration: every example in generate_reports.py
renders in English, so no changed Spanish report string reaches them.
* Align the intensity-fiche Spanish assertions with the UNE terminology
Spanish docs: UNE terminology, decimal commas, localized snippets and theory figures (#365)
* Normalize Spanish docs prose to UNE acoustic terminology
Sweep the Spanish pages for the non-UNE forms "presion sonora",
"potencia sonora" and "intensidad sonora" and normalize the prose to
the wording used by the official Spanish editions of the standards:
"presion acustica" (UNE-EN ISO 16283-2:2016, UNE-EN ISO 10052:2005,
UNE-EN ISO 3746:2011, UNE-ISO 226:2013), "potencia acustica"
(UNE-EN ISO 3746:2011, UNE-EN ISO 4871:2010, UNE-EN ISO 9614-1:2010),
"intensidad acustica" (UNE-EN 61043:1999, UNE-EN ISO 9614-1:2010) and
"nivel de presion acustica de impactos" (UNE-EN ISO 12354-2:2018,
UNE-EN ISO 717-2:2013). 92 replacements across 32 pages, prose only:
code snippets keep the labels they share with the generated figures.
Rename the intensity guide to "Intensidad acustica (p-p)" and the
structure-borne power guide to "Potencia acustica estructural de
equipos (EN 15657)", updating every cross-link text and the theory
anchor intensidad-sonora-iec-61043 accordingly. The API sidebar group
label becomes "Potencia acustica e intensidad" via api_taxonomy.py
with the generated sidebar regenerated.
* Use decimal commas in Spanish docs prose quantities
Sweep every Spanish page for decimal points leaking into prose numbers
and switch them to the comma the locale convention calls for: the
rotorcraft validation prose (fourteen tolerances such as 0,08 dB(A) and
0,5 s), the insulation-prediction worked example (53,6 dB / 53,8 dB),
the tone-audibility Annex E tone (137,3 Hz), the Mackenzie check value
(1550,744 m/s), the EPNL, loudness and absorption fiche descriptions
(98,3 EPNdB; 8,2 sonos and 70,4 fonios; 0,60 y 0,55), the junction
constants table and the third-octave band-edge table in the signal
analysis theory page. Code snippets, inline code, math, clause numbers
and quoted source text keep their points.
* Pass language="es" in Spanish figure-reproduction snippets
The <details> blocks under each localized figure in the Spanish guides
are meant to reproduce the _es variant shown on the page, but 82 of the
one-line result .plot() calls omitted the language="es" argument and
would render English axis labels instead. Add the argument across 33
guides, matching the pattern the intensity field-indicators snippet
already used. The three lab-insulation results whose plot() does not
take a language argument (lab airborne, lab impact and the
element-normalized intensity difference) are left as they were.
* Extend the UNE terminology sweep to sound absorption
Normalize "absorción sonora" to "absorción acústica" across the
Spanish pages (36 occurrences in 14 pages, including the EN 12354-6
guide title and the theory headings), the wording of UNE-EN ISO
3746:2011 and of the equivalent absorption area in UNE-EN ISO
10140-3:2011, UNE-EN ISO 12354-2:2018 and UNE-EN ISO 16283-2:2016, and
the same term the accredited report strings already use. Also restore
the accent in the theory index anchor to the renamed intensity heading,
since heading slugs keep accented characters.
* Theory pages: illustrate each section family with existing result figures
The seven theory pages carried no figures at all. Embed sixteen of the
existing generated figures (light and dark variants, Spanish variants on
the Spanish mirrors) where the concept matches the prose: weighting
curves, time integration and the p-p intensity estimator in the signal
analysis page; equal-loudness contours, the specific-loudness pattern
and the hearing-threshold panels in perception; NC/RC rating, the
Schroeder decay and the ISO 717-1 shifted reference in rooms and
buildings; the Lden profile, ISO 9613-1 absorption and the three sound
power routes in environment and transport; the scattering coefficient
and ISO 11654 rating in materials and surfaces; and the Wk weighting and
the resonator mobility triplet in vibration. Each embed reuses the alt
text of the guide that owns the figure and adds a one-line caption.
Also give the wave-simulation section hub the reading-order paragraph
its siblings already have, linking the closed-form pages the FDTD solver
cross-checks, in both languages.
* Address review findings from the Spanish locale sweeps
Second pass fixes flagged by review: five terminology occurrences the
line-based sweep missed because the noun and adjective were split by a
line wrap or emphasis markup (sound-power, rotorcraft-noise and two
section hubs); six Spanish pages that still embedded the English figure
variant although the _es variant exists (junction-transmission,
aircraft-noise airport contour, miso-coherence,
objective-intelligibility, psychoacoustic-annoyance twice); and 19 more
language="es" arguments on figure-reproduction plot calls the first
pass missed, chained-call receivers such as room.noise_criterion(spl)
.plot() and the axes-creating first call of the two-profile
atmospheric-refraction snippet among them. The lab-insulation plot
wrappers forward keyword arguments to the rating plot, so the three
calls excluded earlier now take the argument too. All Spanish python
fences re-checked to compile and EN/ES parity re-verified.
* Carry the UNE terminology into the generated-asset Spanish strings
Apply the same evidence-based decisions to every Spanish string source
that feeds generated assets: the translation tables of
generate_graphs.py and generate_diagrams.py, the _STRINGS tables of the
plot modules and the report i18n values. 35 strings change: "presión
acústica" (UNE-EN ISO 16283-2:2016, 10052:2005, 3746:2011),
"potencia acústica" (UNE-EN ISO 3746:2011, 4871:2010, 9614-1:2010),
"intensidad acústica" (UNE-EN 61043:1999, 9614-1:2010), "absorción
acústica" (UNE-EN ISO 3746:2011) and "nivel de presión acústica de
impactos" (UNE-EN ISO 12354-2:2018). Strings the UNE editions keep are
untouched: "emisión sonora", "exposición sonora", "campo sonoro",
"fuente sonora". Only Spanish values change; the English keys stay.
The two plot-i18n test assertions that pin the axis label follow, and
the eight Spanish doc fences that deliberately mirrored the old figure
labels now mirror the new ones.
* Regenerate the Spanish figure variants with the UNE terminology
make graphs after the string-source change: 48 files, all of them _es
or _es_dark variants (24 figure/diagram pairs), picking up "presión
acústica", "potencia acústica", "intensidad acústica", "absorción
acústica" and "nivel de presión acústica de impactos" in titles and
axis labels. The English variants are untouched. The committed example
fiches need no regeneration: every example in generate_reports.py
renders in English, so no changed Spanish report string reaches them.
* Align the intensity-fiche Spanish assertions with the UNE terminology
Building and structure-borne guides: result figures, plot mentions and mirror sync (#360)
* Add .plot() to the ISO 717 enlarged-range rating results
ExtendedWeightedRatingResult and ExtendedImpactRatingResult now carry the
full enlarged-range band curve (band_centers, measured) and expose a
.plot() that draws the measured curve over the whole range against the
shifted ISO 717 reference on the 16 core bands, with the unfavourable
deviations shaded, the enlarged-range bands marked and every covered
Annex B / A.2.1 adaptation term in the title. EN/ES labels follow the
existing renderer conventions.
* Field insulation guide: enlarged-range, field-chain, facade and survey-impact figures
Four new deterministic figures (extended_insulation_rating,
field_airborne_insulation, facade_field_insulation,
survey_impact_insulation) generated in the four language/theme variants,
embedded next to their snippets in the EN guide, the ES mirror and the
docs mirror with the dual usage/hand-written code blocks. One-line
.plot() mentions added for the extended rating, the field airborne
result, the survey impact result and the ISO 12999-1 band uncertainty.
The docs mirror gains the previously missing ISO 10052 survey-reports
section, and the survey snippet now defines the li and l1_2m inputs it
uses. Multi-line figure info boxes are translated as whole artists, and
the review fixes (headroom, legend placement, proper unit and Greek
glyphs) are applied to the new generators.
* Laboratory insulation guide: ISO 10140, ISO 15186-1 element and ISO 10848 Dn,f figures
Embed the new lab_insulation_result, intensity_element_insulation and
flanking_level_difference figures next to their snippets in the EN guide,
the ES mirror and the docs mirror, each with the dual usage/hand-written
code blocks. Add the one-line .plot() mentions for the laboratory
airborne result, the element-normalized intensity result and the
floor-covering improvement result, and a note on when Dn,f plots (the
inline example uses 9 bands, below the 16/5-band rating threshold).
* EN 12354 prediction guide: impact-term and radiated-power figures
Embed the new impact_prediction_terms and radiated_power_outdoor figures
next to their snippets in the EN guide, the ES mirror and the docs
mirror, with the dual usage/hand-written code blocks, and add the
one-line .plot() mentions for the airborne prediction, the impact
prediction, the facade prediction and the radiated-power result.
* Panel insulation guide: rated Sharp prediction figure and plot mentions
Embed the new single_panel_rating figure (the 6 mm glass Sharp prediction
rated per ISO 717-1, coincidence dip marked) in the EN guide, the ES
mirror and the docs mirror with the dual code blocks, and add the
one-line .plot() mentions for the single-panel, double-wall and
radiation-efficiency results next to the existing concept figure.
* Junction transmission guide: Kij design chart, EN 12354 worked example and see-also
Add the junction_kij_thickness figure (wave-approach Kij versus the plate
thickness ratio for the X, T and L junctions, identical-plates value
marked) next to the coupling-loss-factor section, a res.plot() mention
in its snippet, a worked example that feeds the predicted K12 = 9.8 dB
of the 100/200 mm concrete X-junction into the EN 12354-1 flanking model
(R'w = 55.4 dB, direct path dominant), and a See-also section linking
the prediction, laboratory, structure-borne power and mobility guides.
EN guide, ES mirror and docs mirror in sync.
* Junction transmission docs mirror: sync the Kij chart, worked example and see-also
* Structure-borne power and installed-source guides: plot mentions, Hopkins citation and see-also
Add the one-line .plot() mentions for the reception-plate power result
(EN 15657) and the installed-source prediction (EN 12354-5) next to their
existing figures, add the one-line .plot() usage to both figures' code
blocks, cite Hopkins (2007) Section 2.8 for the point-excited-plate power
input behind the clause 4.4.3 coupling term with a prose paragraph
connecting the mobility chain, and give the EN 12354-5 page a proper
See-also linking the EN 15657, ISO 7626, junction and EN 12354 guides.
EN guides, ES mirrors and docs mirrors in sync.
* Vibration FRF guides: plot mentions and transfer-stiffness docs sync
Add the one-line .plot() usage and mentions for the ISO/TS 7849
sound-power-from-vibration result, the EN 29052-1 dynamic-stiffness
result and the ISO 10846 indirect transfer-stiffness result next to
their existing figures (EN guides, ES mirrors and docs mirrors), and
port the previously missing ISO 10846 test-report fiche section to the
transfer-stiffness docs mirror.
* Mechanical mobility guide: driving-point reading figure
Embed the new mobility_result_lines figure (|Y(f)| of the SDOF bundle
with the stiffness line, the mass line and the 1/c damping peak) next to
the MobilityResult snippet in the EN guide, the ES mirror and the docs
mirror, with the dual usage/hand-written code blocks and the one-line
res.plot() mention.
* Human vibration and multiple-shock guides: one-line plot mentions
Add the res.plot() one-liners next to the existing figures for the
ISO 8041-1 weighting response, the ISO 2631-1 weighted band spectrum, the
Directive 2002/44/EC daily exposure A(8) and the ISO 2631-5 multiple-shock
assessment, in the EN guides, the ES mirrors and the docs mirrors.
* Docs mirrors: restore missing report-fiche and concept sections
Sync the docs mirrors of the pages touched by this wave with their site
guides: the ISO 16283-3 facade report subsection on the field insulation
page, the EN 29052-1 and ISO 7626 fiche example snippets, and the panel
concept-figure code block.
* Changelog, API docs and llms regeneration; lint and typing fixes for the figure generators
* Fix nested emphasis in the survey-impact figure captions
* Restore the numerical-propagation rasters truncated by a mid-regeneration snapshot
* Reconcile the figure-script additions with the rooms and materials wave
* docs: regenerate the llms bundle after the figure-script reconciliation
Building and structure-borne guides: result figures, plot mentions and mirror sync (#360)
* Add .plot() to the ISO 717 enlarged-range rating results
ExtendedWeightedRatingResult and ExtendedImpactRatingResult now carry the
full enlarged-range band curve (band_centers, measured) and expose a
.plot() that draws the measured curve over the whole range against the
shifted ISO 717 reference on the 16 core bands, with the unfavourable
deviations shaded, the enlarged-range bands marked and every covered
Annex B / A.2.1 adaptation term in the title. EN/ES labels follow the
existing renderer conventions.
* Field insulation guide: enlarged-range, field-chain, facade and survey-impact figures
Four new deterministic figures (extended_insulation_rating,
field_airborne_insulation, facade_field_insulation,
survey_impact_insulation) generated in the four language/theme variants,
embedded next to their snippets in the EN guide, the ES mirror and the
docs mirror with the dual usage/hand-written code blocks. One-line
.plot() mentions added for the extended rating, the field airborne
result, the survey impact result and the ISO 12999-1 band uncertainty.
The docs mirror gains the previously missing ISO 10052 survey-reports
section, and the survey snippet now defines the li and l1_2m inputs it
uses. Multi-line figure info boxes are translated as whole artists, and
the review fixes (headroom, legend placement, proper unit and Greek
glyphs) are applied to the new generators.
* Laboratory insulation guide: ISO 10140, ISO 15186-1 element and ISO 10848 Dn,f figures
Embed the new lab_insulation_result, intensity_element_insulation and
flanking_level_difference figures next to their snippets in the EN guide,
the ES mirror and the docs mirror, each with the dual usage/hand-written
code blocks. Add the one-line .plot() mentions for the laboratory
airborne result, the element-normalized intensity result and the
floor-covering improvement result, and a note on when Dn,f plots (the
inline example uses 9 bands, below the 16/5-band rating threshold).
* EN 12354 prediction guide: impact-term and radiated-power figures
Embed the new impact_prediction_terms and radiated_power_outdoor figures
next to their snippets in the EN guide, the ES mirror and the docs
mirror, with the dual usage/hand-written code blocks, and add the
one-line .plot() mentions for the airborne prediction, the impact
prediction, the facade prediction and the radiated-power result.
* Panel insulation guide: rated Sharp prediction figure and plot mentions
Embed the new single_panel_rating figure (the 6 mm glass Sharp prediction
rated per ISO 717-1, coincidence dip marked) in the EN guide, the ES
mirror and the docs mirror with the dual code blocks, and add the
one-line .plot() mentions for the single-panel, double-wall and
radiation-efficiency results next to the existing concept figure.
* Junction transmission guide: Kij design chart, EN 12354 worked example and see-also
Add the junction_kij_thickness figure (wave-approach Kij versus the plate
thickness ratio for the X, T and L junctions, identical-plates value
marked) next to the coupling-loss-factor section, a res.plot() mention
in its snippet, a worked example that feeds the predicted K12 = 9.8 dB
of the 100/200 mm concrete X-junction into the EN 12354-1 flanking model
(R'w = 55.4 dB, direct path dominant), and a See-also section linking
the prediction, laboratory, structure-borne power and mobility guides.
EN guide, ES mirror and docs mirror in sync.
* Junction transmission docs mirror: sync the Kij chart, worked example and see-also
* Structure-borne power and installed-source guides: plot mentions, Hopkins citation and see-also
Add the one-line .plot() mentions for the reception-plate power result
(EN 15657) and the installed-source prediction (EN 12354-5) next to their
existing figures, add the one-line .plot() usage to both figures' code
blocks, cite Hopkins (2007) Section 2.8 for the point-excited-plate power
input behind the clause 4.4.3 coupling term with a prose paragraph
connecting the mobility chain, and give the EN 12354-5 page a proper
See-also linking the EN 15657, ISO 7626, junction and EN 12354 guides.
EN guides, ES mirrors and docs mirrors in sync.
* Vibration FRF guides: plot mentions and transfer-stiffness docs sync
Add the one-line .plot() usage and mentions for the ISO/TS 7849
sound-power-from-vibration result, the EN 29052-1 dynamic-stiffness
result and the ISO 10846 indirect transfer-stiffness result next to
their existing figures (EN guides, ES mirrors and docs mirrors), and
port the previously missing ISO 10846 test-report fiche section to the
transfer-stiffness docs mirror.
* Mechanical mobility guide: driving-point reading figure
Embed the new mobility_result_lines figure (|Y(f)| of the SDOF bundle
with the stiffness line, the mass line and the 1/c damping peak) next to
the MobilityResult snippet in the EN guide, the ES mirror and the docs
mirror, with the dual usage/hand-written code blocks and the one-line
res.plot() mention.
* Human vibration and multiple-shock guides: one-line plot mentions
Add the res.plot() one-liners next to the existing figures for the
ISO 8041-1 weighting response, the ISO 2631-1 weighted band spectrum, the
Directive 2002/44/EC daily exposure A(8) and the ISO 2631-5 multiple-shock
assessment, in the EN guides, the ES mirrors and the docs mirrors.
* Docs mirrors: restore missing report-fiche and concept sections
Sync the docs mirrors of the pages touched by this wave with their site
guides: the ISO 16283-3 facade report subsection on the field insulation
page, the EN 29052-1 and ISO 7626 fiche example snippets, and the panel
concept-figure code block.
* Changelog, API docs and llms regeneration; lint and typing fixes for the figure generators
* Fix nested emphasis in the survey-impact figure captions
* Restore the numerical-propagation rasters truncated by a mid-regeneration snapshot
* Reconcile the figure-script additions with the rooms and materials wave
* docs: regenerate the llms bundle after the figure-script reconciliation
Building and structure-borne guides: result figures, plot mentions and mirror sync (#360)
* Add .plot() to the ISO 717 enlarged-range rating results
ExtendedWeightedRatingResult and ExtendedImpactRatingResult now carry the
full enlarged-range band curve (band_centers, measured) and expose a
.plot() that draws the measured curve over the whole range against the
shifted ISO 717 reference on the 16 core bands, with the unfavourable
deviations shaded, the enlarged-range bands marked and every covered
Annex B / A.2.1 adaptation term in the title. EN/ES labels follow the
existing renderer conventions.
* Field insulation guide: enlarged-range, field-chain, facade and survey-impact figures
Four new deterministic figures (extended_insulation_rating,
field_airborne_insulation, facade_field_insulation,
survey_impact_insulation) generated in the four language/theme variants,
embedded next to their snippets in the EN guide, the ES mirror and the
docs mirror with the dual usage/hand-written code blocks. One-line
.plot() mentions added for the extended rating, the field airborne
result, the survey impact result and the ISO 12999-1 band uncertainty.
The docs mirror gains the previously missing ISO 10052 survey-reports
section, and the survey snippet now defines the li and l1_2m inputs it
uses. Multi-line figure info boxes are translated as whole artists, and
the review fixes (headroom, legend placement, proper unit and Greek
glyphs) are applied to the new generators.
* Laboratory insulation guide: ISO 10140, ISO 15186-1 element and ISO 10848 Dn,f figures
Embed the new lab_insulation_result, intensity_element_insulation and
flanking_level_difference figures next to their snippets in the EN guide,
the ES mirror and the docs mirror, each with the dual usage/hand-written
code blocks. Add the one-line .plot() mentions for the laboratory
airborne result, the element-normalized intensity result and the
floor-covering improvement result, and a note on when Dn,f plots (the
inline example uses 9 bands, below the 16/5-band rating threshold).
* EN 12354 prediction guide: impact-term and radiated-power figures
Embed the new impact_prediction_terms and radiated_power_outdoor figures
next to their snippets in the EN guide, the ES mirror and the docs
mirror, with the dual usage/hand-written code blocks, and add the
one-line .plot() mentions for the airborne prediction, the impact
prediction, the facade prediction and the radiated-power result.
* Panel insulation guide: rated Sharp prediction figure and plot mentions
Embed the new single_panel_rating figure (the 6 mm glass Sharp prediction
rated per ISO 717-1, coincidence dip marked) in the EN guide, the ES
mirror and the docs mirror with the dual code blocks, and add the
one-line .plot() mentions for the single-panel, double-wall and
radiation-efficiency results next to the existing concept figure.
* Junction transmission guide: Kij design chart, EN 12354 worked example and see-also
Add the junction_kij_thickness figure (wave-approach Kij versus the plate
thickness ratio for the X, T and L junctions, identical-plates value
marked) next to the coupling-loss-factor section, a res.plot() mention
in its snippet, a worked example that feeds the predicted K12 = 9.8 dB
of the 100/200 mm concrete X-junction into the EN 12354-1 flanking model
(R'w = 55.4 dB, direct path dominant), and a See-also section linking
the prediction, laboratory, structure-borne power and mobility guides.
EN guide, ES mirror and docs mirror in sync.
* Junction transmission docs mirror: sync the Kij chart, worked example and see-also
* Structure-borne power and installed-source guides: plot mentions, Hopkins citation and see-also
Add the one-line .plot() mentions for the reception-plate power result
(EN 15657) and the installed-source prediction (EN 12354-5) next to their
existing figures, add the one-line .plot() usage to both figures' code
blocks, cite Hopkins (2007) Section 2.8 for the point-excited-plate power
input behind the clause 4.4.3 coupling term with a prose paragraph
connecting the mobility chain, and give the EN 12354-5 page a proper
See-also linking the EN 15657, ISO 7626, junction and EN 12354 guides.
EN guides, ES mirrors and docs mirrors in sync.
* Vibration FRF guides: plot mentions and transfer-stiffness docs sync
Add the one-line .plot() usage and mentions for the ISO/TS 7849
sound-power-from-vibration result, the EN 29052-1 dynamic-stiffness
result and the ISO 10846 indirect transfer-stiffness result next to
their existing figures (EN guides, ES mirrors and docs mirrors), and
port the previously missing ISO 10846 test-report fiche section to the
transfer-stiffness docs mirror.
* Mechanical mobility guide: driving-point reading figure
Embed the new mobility_result_lines figure (|Y(f)| of the SDOF bundle
with the stiffness line, the mass line and the 1/c damping peak) next to
the MobilityResult snippet in the EN guide, the ES mirror and the docs
mirror, with the dual usage/hand-written code blocks and the one-line
res.plot() mention.
* Human vibration and multiple-shock guides: one-line plot mentions
Add the res.plot() one-liners next to the existing figures for the
ISO 8041-1 weighting response, the ISO 2631-1 weighted band spectrum, the
Directive 2002/44/EC daily exposure A(8) and the ISO 2631-5 multiple-shock
assessment, in the EN guides, the ES mirrors and the docs mirrors.
* Docs mirrors: restore missing report-fiche and concept sections
Sync the docs mirrors of the pages touched by this wave with their site
guides: the ISO 16283-3 facade report subsection on the field insulation
page, the EN 29052-1 and ISO 7626 fiche example snippets, and the panel
concept-figure code block.
* Changelog, API docs and llms regeneration; lint and typing fixes for the figure generators
* Fix nested emphasis in the survey-impact figure captions
* Restore the numerical-propagation rasters truncated by a mid-regeneration snapshot
* Reconcile the figure-script additions with the rooms and materials wave
* docs: regenerate the llms bundle after the figure-script reconciliation
Building and structure-borne guides: result figures, plot mentions and mirror sync (#360)
* Add .plot() to the ISO 717 enlarged-range rating results
ExtendedWeightedRatingResult and ExtendedImpactRatingResult now carry the
full enlarged-range band curve (band_centers, measured) and expose a
.plot() that draws the measured curve over the whole range against the
shifted ISO 717 reference on the 16 core bands, with the unfavourable
deviations shaded, the enlarged-range bands marked and every covered
Annex B / A.2.1 adaptation term in the title. EN/ES labels follow the
existing renderer conventions.
* Field insulation guide: enlarged-range, field-chain, facade and survey-impact figures
Four new deterministic figures (extended_insulation_rating,
field_airborne_insulation, facade_field_insulation,
survey_impact_insulation) generated in the four language/theme variants,
embedded next to their snippets in the EN guide, the ES mirror and the
docs mirror with the dual usage/hand-written code blocks. One-line
.plot() mentions added for the extended rating, the field airborne
result, the survey impact result and the ISO 12999-1 band uncertainty.
The docs mirror gains the previously missing ISO 10052 survey-reports
section, and the survey snippet now defines the li and l1_2m inputs it
uses. Multi-line figure info boxes are translated as whole artists, and
the review fixes (headroom, legend placement, proper unit and Greek
glyphs) are applied to the new generators.
* Laboratory insulation guide: ISO 10140, ISO 15186-1 element and ISO 10848 Dn,f figures
Embed the new lab_insulation_result, intensity_element_insulation and
flanking_level_difference figures next to their snippets in the EN guide,
the ES mirror and the docs mirror, each with the dual usage/hand-written
code blocks. Add the one-line .plot() mentions for the laboratory
airborne result, the element-normalized intensity result and the
floor-covering improvement result, and a note on when Dn,f plots (the
inline example uses 9 bands, below the 16/5-band rating threshold).
* EN 12354 prediction guide: impact-term and radiated-power figures
Embed the new impact_prediction_terms and radiated_power_outdoor figures
next to their snippets in the EN guide, the ES mirror and the docs
mirror, with the dual usage/hand-written code blocks, and add the
one-line .plot() mentions for the airborne prediction, the impact
prediction, the facade prediction and the radiated-power result.
* Panel insulation guide: rated Sharp prediction figure and plot mentions
Embed the new single_panel_rating figure (the 6 mm glass Sharp prediction
rated per ISO 717-1, coincidence dip marked) in the EN guide, the ES
mirror and the docs mirror with the dual code blocks, and add the
one-line .plot() mentions for the single-panel, double-wall and
radiation-efficiency results next to the existing concept figure.
* Junction transmission guide: Kij design chart, EN 12354 worked example and see-also
Add the junction_kij_thickness figure (wave-approach Kij versus the plate
thickness ratio for the X, T and L junctions, identical-plates value
marked) next to the coupling-loss-factor section, a res.plot() mention
in its snippet, a worked example that feeds the predicted K12 = 9.8 dB
of the 100/200 mm concrete X-junction into the EN 12354-1 flanking model
(R'w = 55.4 dB, direct path dominant), and a See-also section linking
the prediction, laboratory, structure-borne power and mobility guides.
EN guide, ES mirror and docs mirror in sync.
* Junction transmission docs mirror: sync the Kij chart, worked example and see-also
* Structure-borne power and installed-source guides: plot mentions, Hopkins citation and see-also
Add the one-line .plot() mentions for the reception-plate power result
(EN 15657) and the installed-source prediction (EN 12354-5) next to their
existing figures, add the one-line .plot() usage to both figures' code
blocks, cite Hopkins (2007) Section 2.8 for the point-excited-plate power
input behind the clause 4.4.3 coupling term with a prose paragraph
connecting the mobility chain, and give the EN 12354-5 page a proper
See-also linking the EN 15657, ISO 7626, junction and EN 12354 guides.
EN guides, ES mirrors and docs mirrors in sync.
* Vibration FRF guides: plot mentions and transfer-stiffness docs sync
Add the one-line .plot() usage and mentions for the ISO/TS 7849
sound-power-from-vibration result, the EN 29052-1 dynamic-stiffness
result and the ISO 10846 indirect transfer-stiffness result next to
their existing figures (EN guides, ES mirrors and docs mirrors), and
port the previously missing ISO 10846 test-report fiche section to the
transfer-stiffness docs mirror.
* Mechanical mobility guide: driving-point reading figure
Embed the new mobility_result_lines figure (|Y(f)| of the SDOF bundle
with the stiffness line, the mass line and the 1/c damping peak) next to
the MobilityResult snippet in the EN guide, the ES mirror and the docs
mirror, with the dual usage/hand-written code blocks and the one-line
res.plot() mention.
* Human vibration and multiple-shock guides: one-line plot mentions
Add the res.plot() one-liners next to the existing figures for the
ISO 8041-1 weighting response, the ISO 2631-1 weighted band spectrum, the
Directive 2002/44/EC daily exposure A(8) and the ISO 2631-5 multiple-shock
assessment, in the EN guides, the ES mirrors and the docs mirrors.
* Docs mirrors: restore missing report-fiche and concept sections
Sync the docs mirrors of the pages touched by this wave with their site
guides: the ISO 16283-3 facade report subsection on the field insulation
page, the EN 29052-1 and ISO 7626 fiche example snippets, and the panel
concept-figure code block.
* Changelog, API docs and llms regeneration; lint and typing fixes for the figure generators
* Fix nested emphasis in the survey-impact figure captions
* Restore the numerical-propagation rasters truncated by a mid-regeneration snapshot
* Reconcile the figure-script additions with the rooms and materials wave
* docs: regenerate the llms bundle after the figure-script reconciliation
Core metrology guides: result figures, ResampledSignalResult.plot() and real introductions (#364)
* Add ResampledSignalResult.plot(): the delivered anti-alias filter against its design spec
* Rewrite the multichannel guide intro: concrete use cases, per-channel guarantees, Bendat & Piersol citations
* Give the levels page a real introduction: descriptor families, when-to-use guidance and survey references
* Time weighting: framing intro with detector history, ANSI S1.4/Bies references and sibling links
* Calibration: proper introduction (SPL vs dBFS choice, workflow framing) with Bies reference and sibling links
* Add eleven core-metrology figures: resampling spec, cepstrum variants, liftering, correlation, IR alignment, Hilbert envelope, cross-spectra, Golay recovery, TSA noise law, runs test
* Test signals: anti-alias figure with dual snippet, res.plot() mention, See also, docs mirror sync
* Cepstrum guide: variants and liftering figures with dual snippets, complex-cepstrum plot mention
* Correlation guide: normalization, IR-alignment and Hilbert-envelope figures with dual snippets
* Spectral analysis: cross-spectral density and coherent-output-SNR figures with dual snippets
* System measurement: Golay exact-recovery figure and plot mentions for the inversion workflow
* Synchronous averaging: sqrt(N) figure, diagnostics-tool guidance, See also, recording naming
* Data qualification: runs-test figure with dual snippet and peak-statistics plot mention
* MISO coherence: conditioning-order snippet, practical pitfalls and See also across the three trees
* Time-frequency: Harris window reference and See also across the three trees
* GUM uncertainty: map the domain pages that consume the clause-5 machinery, expand See also
* Filter banks: compliance plot mentions and recording naming in the crossover snippet
* Changelog entry for the core-metrology documentation figures and prose
* Regenerate llms-full.txt for the core-metrology documentation
* Drop the duplicated phase-axis translation key
Core metrology guides: result figures, ResampledSignalResult.plot() and real introductions (#364)
* Add ResampledSignalResult.plot(): the delivered anti-alias filter against its design spec
* Rewrite the multichannel guide intro: concrete use cases, per-channel guarantees, Bendat & Piersol citations
* Give the levels page a real introduction: descriptor families, when-to-use guidance and survey references
* Time weighting: framing intro with detector history, ANSI S1.4/Bies references and sibling links
* Calibration: proper introduction (SPL vs dBFS choice, workflow framing) with Bies reference and sibling links
* Add eleven core-metrology figures: resampling spec, cepstrum variants, liftering, correlation, IR alignment, Hilbert envelope, cross-spectra, Golay recovery, TSA noise law, runs test
* Test signals: anti-alias figure with dual snippet, res.plot() mention, See also, docs mirror sync
* Cepstrum guide: variants and liftering figures with dual snippets, complex-cepstrum plot mention
* Correlation guide: normalization, IR-alignment and Hilbert-envelope figures with dual snippets
* Spectral analysis: cross-spectral density and coherent-output-SNR figures with dual snippets
* System measurement: Golay exact-recovery figure and plot mentions for the inversion workflow
* Synchronous averaging: sqrt(N) figure, diagnostics-tool guidance, See also, recording naming
* Data qualification: runs-test figure with dual snippet and peak-statistics plot mention
* MISO coherence: conditioning-order snippet, practical pitfalls and See also across the three trees
* Time-frequency: Harris window reference and See also across the three trees
* GUM uncertainty: map the domain pages that consume the clause-5 machinery, expand See also
* Filter banks: compliance plot mentions and recording naming in the crossover snippet
* Changelog entry for the core-metrology documentation figures and prose
* Regenerate llms-full.txt for the core-metrology documentation
* Drop the duplicated phase-axis translation key
Core metrology guides: result figures, ResampledSignalResult.plot() and real introductions (#364)
* Add ResampledSignalResult.plot(): the delivered anti-alias filter against its design spec
* Rewrite the multichannel guide intro: concrete use cases, per-channel guarantees, Bendat & Piersol citations
* Give the levels page a real introduction: descriptor families, when-to-use guidance and survey references
* Time weighting: framing intro with detector history, ANSI S1.4/Bies references and sibling links
* Calibration: proper introduction (SPL vs dBFS choice, workflow framing) with Bies reference and sibling links
* Add eleven core-metrology figures: resampling spec, cepstrum variants, liftering, correlation, IR alignment, Hilbert envelope, cross-spectra, Golay recovery, TSA noise law, runs test
* Test signals: anti-alias figure with dual snippet, res.plot() mention, See also, docs mirror sync
* Cepstrum guide: variants and liftering figures with dual snippets, complex-cepstrum plot mention
* Correlation guide: normalization, IR-alignment and Hilbert-envelope figures with dual snippets
* Spectral analysis: cross-spectral density and coherent-output-SNR figures with dual snippets
* System measurement: Golay exact-recovery figure and plot mentions for the inversion workflow
* Synchronous averaging: sqrt(N) figure, diagnostics-tool guidance, See also, recording naming
* Data qualification: runs-test figure with dual snippet and peak-statistics plot mention
* MISO coherence: conditioning-order snippet, practical pitfalls and See also across the three trees
* Time-frequency: Harris window reference and See also across the three trees
* GUM uncertainty: map the domain pages that consume the clause-5 machinery, expand See also
* Filter banks: compliance plot mentions and recording naming in the crossover snippet
* Changelog entry for the core-metrology documentation figures and prose
* Regenerate llms-full.txt for the core-metrology documentation
* Drop the duplicated phase-axis translation key
Core metrology guides: result figures, ResampledSignalResult.plot() and real introductions (#364)
* Add ResampledSignalResult.plot(): the delivered anti-alias filter against its design spec
* Rewrite the multichannel guide intro: concrete use cases, per-channel guarantees, Bendat & Piersol citations
* Give the levels page a real introduction: descriptor families, when-to-use guidance and survey references
* Time weighting: framing intro with detector history, ANSI S1.4/Bies references and sibling links
* Calibration: proper introduction (SPL vs dBFS choice, workflow framing) with Bies reference and sibling links
* Add eleven core-metrology figures: resampling spec, cepstrum variants, liftering, correlation, IR alignment, Hilbert envelope, cross-spectra, Golay recovery, TSA noise law, runs test
* Test signals: anti-alias figure with dual snippet, res.plot() mention, See also, docs mirror sync
* Cepstrum guide: variants and liftering figures with dual snippets, complex-cepstrum plot mention
* Correlation guide: normalization, IR-alignment and Hilbert-envelope figures with dual snippets
* Spectral analysis: cross-spectral density and coherent-output-SNR figures with dual snippets
* System measurement: Golay exact-recovery figure and plot mentions for the inversion workflow
* Synchronous averaging: sqrt(N) figure, diagnostics-tool guidance, See also, recording naming
* Data qualification: runs-test figure with dual snippet and peak-statistics plot mention
* MISO coherence: conditioning-order snippet, practical pitfalls and See also across the three trees
* Time-frequency: Harris window reference and See also across the three trees
* GUM uncertainty: map the domain pages that consume the clause-5 machinery, expand See also
* Filter banks: compliance plot mentions and recording naming in the crossover snippet
* Changelog entry for the core-metrology documentation figures and prose
* Regenerate llms-full.txt for the core-metrology documentation
* Drop the duplicated phase-axis translation key
Building and structure-borne guides: result figures, plot mentions and mirror sync (#360)
* Add .plot() to the ISO 717 enlarged-range rating results
ExtendedWeightedRatingResult and ExtendedImpactRatingResult now carry the
full enlarged-range band curve (band_centers, measured) and expose a
.plot() that draws the measured curve over the whole range against the
shifted ISO 717 reference on the 16 core bands, with the unfavourable
deviations shaded, the enlarged-range bands marked and every covered
Annex B / A.2.1 adaptation term in the title. EN/ES labels follow the
existing renderer conventions.
* Field insulation guide: enlarged-range, field-chain, facade and survey-impact figures
Four new deterministic figures (extended_insulation_rating,
field_airborne_insulation, facade_field_insulation,
survey_impact_insulation) generated in the four language/theme variants,
embedded next to their snippets in the EN guide, the ES mirror and the
docs mirror with the dual usage/hand-written code blocks. One-line
.plot() mentions added for the extended rating, the field airborne
result, the survey impact result and the ISO 12999-1 band uncertainty.
The docs mirror gains the previously missing ISO 10052 survey-reports
section, and the survey snippet now defines the li and l1_2m inputs it
uses. Multi-line figure info boxes are translated as whole artists, and
the review fixes (headroom, legend placement, proper unit and Greek
glyphs) are applied to the new generators.
* Laboratory insulation guide: ISO 10140, ISO 15186-1 element and ISO 10848 Dn,f figures
Embed the new lab_insulation_result, intensity_element_insulation and
flanking_level_difference figures next to their snippets in the EN guide,
the ES mirror and the docs mirror, each with the dual usage/hand-written
code blocks. Add the one-line .plot() mentions for the laboratory
airborne result, the element-normalized intensity result and the
floor-covering improvement result, and a note on when Dn,f plots (the
inline example uses 9 bands, below the 16/5-band rating threshold).
* EN 12354 prediction guide: impact-term and radiated-power figures
Embed the new impact_prediction_terms and radiated_power_outdoor figures
next to their snippets in the EN guide, the ES mirror and the docs
mirror, with the dual usage/hand-written code blocks, and add the
one-line .plot() mentions for the airborne prediction, the impact
prediction, the facade prediction and the radiated-power result.
* Panel insulation guide: rated Sharp prediction figure and plot mentions
Embed the new single_panel_rating figure (the 6 mm glass Sharp prediction
rated per ISO 717-1, coincidence dip marked) in the EN guide, the ES
mirror and the docs mirror with the dual code blocks, and add the
one-line .plot() mentions for the single-panel, double-wall and
radiation-efficiency results next to the existing concept figure.
* Junction transmission guide: Kij design chart, EN 12354 worked example and see-also
Add the junction_kij_thickness figure (wave-approach Kij versus the plate
thickness ratio for the X, T and L junctions, identical-plates value
marked) next to the coupling-loss-factor section, a res.plot() mention
in its snippet, a worked example that feeds the predicted K12 = 9.8 dB
of the 100/200 mm concrete X-junction into the EN 12354-1 flanking model
(R'w = 55.4 dB, direct path dominant), and a See-also section linking
the prediction, laboratory, structure-borne power and mobility guides.
EN guide, ES mirror and docs mirror in sync.
* Junction transmission docs mirror: sync the Kij chart, worked example and see-also
* Structure-borne power and installed-source guides: plot mentions, Hopkins citation and see-also
Add the one-line .plot() mentions for the reception-plate power result
(EN 15657) and the installed-source prediction (EN 12354-5) next to their
existing figures, add the one-line .plot() usage to both figures' code
blocks, cite Hopkins (2007) Section 2.8 for the point-excited-plate power
input behind the clause 4.4.3 coupling term with a prose paragraph
connecting the mobility chain, and give the EN 12354-5 page a proper
See-also linking the EN 15657, ISO 7626, junction and EN 12354 guides.
EN guides, ES mirrors and docs mirrors in sync.
* Vibration FRF guides: plot mentions and transfer-stiffness docs sync
Add the one-line .plot() usage and mentions for the ISO/TS 7849
sound-power-from-vibration result, the EN 29052-1 dynamic-stiffness
result and the ISO 10846 indirect transfer-stiffness result next to
their existing figures (EN guides, ES mirrors and docs mirrors), and
port the previously missing ISO 10846 test-report fiche section to the
transfer-stiffness docs mirror.
* Mechanical mobility guide: driving-point reading figure
Embed the new mobility_result_lines figure (|Y(f)| of the SDOF bundle
with the stiffness line, the mass line and the 1/c damping peak) next to
the MobilityResult snippet in the EN guide, the ES mirror and the docs
mirror, with the dual usage/hand-written code blocks and the one-line
res.plot() mention.
* Human vibration and multiple-shock guides: one-line plot mentions
Add the res.plot() one-liners next to the existing figures for the
ISO 8041-1 weighting response, the ISO 2631-1 weighted band spectrum, the
Directive 2002/44/EC daily exposure A(8) and the ISO 2631-5 multiple-shock
assessment, in the EN guides, the ES mirrors and the docs mirrors.
* Docs mirrors: restore missing report-fiche and concept sections
Sync the docs mirrors of the pages touched by this wave with their site
guides: the ISO 16283-3 facade report subsection on the field insulation
page, the EN 29052-1 and ISO 7626 fiche example snippets, and the panel
concept-figure code block.
* Changelog, API docs and llms regeneration; lint and typing fixes for the figure generators
* Fix nested emphasis in the survey-impact figure captions
* Restore the numerical-propagation rasters truncated by a mid-regeneration snapshot
* Reconcile the figure-script additions with the rooms and materials wave
* docs: regenerate the llms bundle after the figure-script reconciliation
Building and structure-borne guides: result figures, plot mentions and mirror sync (#360)
* Add .plot() to the ISO 717 enlarged-range rating results
ExtendedWeightedRatingResult and ExtendedImpactRatingResult now carry the
full enlarged-range band curve (band_centers, measured) and expose a
.plot() that draws the measured curve over the whole range against the
shifted ISO 717 reference on the 16 core bands, with the unfavourable
deviations shaded, the enlarged-range bands marked and every covered
Annex B / A.2.1 adaptation term in the title. EN/ES labels follow the
existing renderer conventions.
* Field insulation guide: enlarged-range, field-chain, facade and survey-impact figures
Four new deterministic figures (extended_insulation_rating,
field_airborne_insulation, facade_field_insulation,
survey_impact_insulation) generated in the four language/theme variants,
embedded next to their snippets in the EN guide, the ES mirror and the
docs mirror with the dual usage/hand-written code blocks. One-line
.plot() mentions added for the extended rating, the field airborne
result, the survey impact result and the ISO 12999-1 band uncertainty.
The docs mirror gains the previously missing ISO 10052 survey-reports
section, and the survey snippet now defines the li and l1_2m inputs it
uses. Multi-line figure info boxes are translated as whole artists, and
the review fixes (headroom, legend placement, proper unit and Greek
glyphs) are applied to the new generators.
* Laboratory insulation guide: ISO 10140, ISO 15186-1 element and ISO 10848 Dn,f figures
Embed the new lab_insulation_result, intensity_element_insulation and
flanking_level_difference figures next to their snippets in the EN guide,
the ES mirror and the docs mirror, each with the dual usage/hand-written
code blocks. Add the one-line .plot() mentions for the laboratory
airborne result, the element-normalized intensity result and the
floor-covering improvement result, and a note on when Dn,f plots (the
inline example uses 9 bands, below the 16/5-band rating threshold).
* EN 12354 prediction guide: impact-term and radiated-power figures
Embed the new impact_prediction_terms and radiated_power_outdoor figures
next to their snippets in the EN guide, the ES mirror and the docs
mirror, with the dual usage/hand-written code blocks, and add the
one-line .plot() mentions for the airborne prediction, the impact
prediction, the facade prediction and the radiated-power result.
* Panel insulation guide: rated Sharp prediction figure and plot mentions
Embed the new single_panel_rating figure (the 6 mm glass Sharp prediction
rated per ISO 717-1, coincidence dip marked) in the EN guide, the ES
mirror and the docs mirror with the dual code blocks, and add the
one-line .plot() mentions for the single-panel, double-wall and
radiation-efficiency results next to the existing concept figure.
* Junction transmission guide: Kij design chart, EN 12354 worked example and see-also
Add the junction_kij_thickness figure (wave-approach Kij versus the plate
thickness ratio for the X, T and L junctions, identical-plates value
marked) next to the coupling-loss-factor section, a res.plot() mention
in its snippet, a worked example that feeds the predicted K12 = 9.8 dB
of the 100/200 mm concrete X-junction into the EN 12354-1 flanking model
(R'w = 55.4 dB, direct path dominant), and a See-also section linking
the prediction, laboratory, structure-borne power and mobility guides.
EN guide, ES mirror and docs mirror in sync.
* Junction transmission docs mirror: sync the Kij chart, worked example and see-also
* Structure-borne power and installed-source guides: plot mentions, Hopkins citation and see-also
Add the one-line .plot() mentions for the reception-plate power result
(EN 15657) and the installed-source prediction (EN 12354-5) next to their
existing figures, add the one-line .plot() usage to both figures' code
blocks, cite Hopkins (2007) Section 2.8 for the point-excited-plate power
input behind the clause 4.4.3 coupling term with a prose paragraph
connecting the mobility chain, and give the EN 12354-5 page a proper
See-also linking the EN 15657, ISO 7626, junction and EN 12354 guides.
EN guides, ES mirrors and docs mirrors in sync.
* Vibration FRF guides: plot mentions and transfer-stiffness docs sync
Add the one-line .plot() usage and mentions for the ISO/TS 7849
sound-power-from-vibration result, the EN 29052-1 dynamic-stiffness
result and the ISO 10846 indirect transfer-stiffness result next to
their existing figures (EN guides, ES mirrors and docs mirrors), and
port the previously missing ISO 10846 test-report fiche section to the
transfer-stiffness docs mirror.
* Mechanical mobility guide: driving-point reading figure
Embed the new mobility_result_lines figure (|Y(f)| of the SDOF bundle
with the stiffness line, the mass line and the 1/c damping peak) next to
the MobilityResult snippet in the EN guide, the ES mirror and the docs
mirror, with the dual usage/hand-written code blocks and the one-line
res.plot() mention.
* Human vibration and multiple-shock guides: one-line plot mentions
Add the res.plot() one-liners next to the existing figures for the
ISO 8041-1 weighting response, the ISO 2631-1 weighted band spectrum, the
Directive 2002/44/EC daily exposure A(8) and the ISO 2631-5 multiple-shock
assessment, in the EN guides, the ES mirrors and the docs mirrors.
* Docs mirrors: restore missing report-fiche and concept sections
Sync the docs mirrors of the pages touched by this wave with their site
guides: the ISO 16283-3 facade report subsection on the field insulation
page, the EN 29052-1 and ISO 7626 fiche example snippets, and the panel
concept-figure code block.
* Changelog, API docs and llms regeneration; lint and typing fixes for the figure generators
* Fix nested emphasis in the survey-impact figure captions
* Restore the numerical-propagation rasters truncated by a mid-regeneration snapshot
* Reconcile the figure-script additions with the rooms and materials wave
* docs: regenerate the llms bundle after the figure-script reconciliation
Building and structure-borne guides: result figures, plot mentions and mirror sync (#360)
* Add .plot() to the ISO 717 enlarged-range rating results
ExtendedWeightedRatingResult and ExtendedImpactRatingResult now carry the
full enlarged-range band curve (band_centers, measured) and expose a
.plot() that draws the measured curve over the whole range against the
shifted ISO 717 reference on the 16 core bands, with the unfavourable
deviations shaded, the enlarged-range bands marked and every covered
Annex B / A.2.1 adaptation term in the title. EN/ES labels follow the
existing renderer conventions.
* Field insulation guide: enlarged-range, field-chain, facade and survey-impact figures
Four new deterministic figures (extended_insulation_rating,
field_airborne_insulation, facade_field_insulation,
survey_impact_insulation) generated in the four language/theme variants,
embedded next to their snippets in the EN guide, the ES mirror and the
docs mirror with the dual usage/hand-written code blocks. One-line
.plot() mentions added for the extended rating, the field airborne
result, the survey impact result and the ISO 12999-1 band uncertainty.
The docs mirror gains the previously missing ISO 10052 survey-reports
section, and the survey snippet now defines the li and l1_2m inputs it
uses. Multi-line figure info boxes are translated as whole artists, and
the review fixes (headroom, legend placement, proper unit and Greek
glyphs) are applied to the new generators.
* Laboratory insulation guide: ISO 10140, ISO 15186-1 element and ISO 10848 Dn,f figures
Embed the new lab_insulation_result, intensity_element_insulation and
flanking_level_difference figures next to their snippets in the EN guide,
the ES mirror and the docs mirror, each with the dual usage/hand-written
code blocks. Add the one-line .plot() mentions for the laboratory
airborne result, the element-normalized intensity result and the
floor-covering improvement result, and a note on when Dn,f plots (the
inline example uses 9 bands, below the 16/5-band rating threshold).
* EN 12354 prediction guide: impact-term and radiated-power figures
Embed the new impact_prediction_terms and radiated_power_outdoor figures
next to their snippets in the EN guide, the ES mirror and the docs
mirror, with the dual usage/hand-written code blocks, and add the
one-line .plot() mentions for the airborne prediction, the impact
prediction, the facade prediction and the radiated-power result.
* Panel insulation guide: rated Sharp prediction figure and plot mentions
Embed the new single_panel_rating figure (the 6 mm glass Sharp prediction
rated per ISO 717-1, coincidence dip marked) in the EN guide, the ES
mirror and the docs mirror with the dual code blocks, and add the
one-line .plot() mentions for the single-panel, double-wall and
radiation-efficiency results next to the existing concept figure.
* Junction transmission guide: Kij design chart, EN 12354 worked example and see-also
Add the junction_kij_thickness figure (wave-approach Kij versus the plate
thickness ratio for the X, T and L junctions, identical-plates value
marked) next to the coupling-loss-factor section, a res.plot() mention
in its snippet, a worked example that feeds the predicted K12 = 9.8 dB
of the 100/200 mm concrete X-junction into the EN 12354-1 flanking model
(R'w = 55.4 dB, direct path dominant), and a See-also section linking
the prediction, laboratory, structure-borne power and mobility guides.
EN guide, ES mirror and docs mirror in sync.
* Junction transmission docs mirror: sync the Kij chart, worked example and see-also
* Structure-borne power and installed-source guides: plot mentions, Hopkins citation and see-also
Add the one-line .plot() mentions for the reception-plate power result
(EN 15657) and the installed-source prediction (EN 12354-5) next to their
existing figures, add the one-line .plot() usage to both figures' code
blocks, cite Hopkins (2007) Section 2.8 for the point-excited-plate power
input behind the clause 4.4.3 coupling term with a prose paragraph
connecting the mobility chain, and give the EN 12354-5 page a proper
See-also linking the EN 15657, ISO 7626, junction and EN 12354 guides.
EN guides, ES mirrors and docs mirrors in sync.
* Vibration FRF guides: plot mentions and transfer-stiffness docs sync
Add the one-line .plot() usage and mentions for the ISO/TS 7849
sound-power-from-vibration result, the EN 29052-1 dynamic-stiffness
result and the ISO 10846 indirect transfer-stiffness result next to
their existing figures (EN guides, ES mirrors and docs mirrors), and
port the previously missing ISO 10846 test-report fiche section to the
transfer-stiffness docs mirror.
* Mechanical mobility guide: driving-point reading figure
Embed the new mobility_result_lines figure (|Y(f)| of the SDOF bundle
with the stiffness line, the mass line and the 1/c damping peak) next to
the MobilityResult snippet in the EN guide, the ES mirror and the docs
mirror, with the dual usage/hand-written code blocks and the one-line
res.plot() mention.
* Human vibration and multiple-shock guides: one-line plot mentions
Add the res.plot() one-liners next to the existing figures for the
ISO 8041-1 weighting response, the ISO 2631-1 weighted band spectrum, the
Directive 2002/44/EC daily exposure A(8) and the ISO 2631-5 multiple-shock
assessment, in the EN guides, the ES mirrors and the docs mirrors.
* Docs mirrors: restore missing report-fiche and concept sections
Sync the docs mirrors of the pages touched by this wave with their site
guides: the ISO 16283-3 facade report subsection on the field insulation
page, the EN 29052-1 and ISO 7626 fiche example snippets, and the panel
concept-figure code block.
* Changelog, API docs and llms regeneration; lint and typing fixes for the figure generators
* Fix nested emphasis in the survey-impact figure captions
* Restore the numerical-propagation rasters truncated by a mid-regeneration snapshot
* Reconcile the figure-script additions with the rooms and materials wave
* docs: regenerate the llms bundle after the figure-script reconciliation
Building and structure-borne guides: result figures, plot mentions and mirror sync (#360)
* Add .plot() to the ISO 717 enlarged-range rating results
ExtendedWeightedRatingResult and ExtendedImpactRatingResult now carry the
full enlarged-range band curve (band_centers, measured) and expose a
.plot() that draws the measured curve over the whole range against the
shifted ISO 717 reference on the 16 core bands, with the unfavourable
deviations shaded, the enlarged-range bands marked and every covered
Annex B / A.2.1 adaptation term in the title. EN/ES labels follow the
existing renderer conventions.
* Field insulation guide: enlarged-range, field-chain, facade and survey-impact figures
Four new deterministic figures (extended_insulation_rating,
field_airborne_insulation, facade_field_insulation,
survey_impact_insulation) generated in the four language/theme variants,
embedded next to their snippets in the EN guide, the ES mirror and the
docs mirror with the dual usage/hand-written code blocks. One-line
.plot() mentions added for the extended rating, the field airborne
result, the survey impact result and the ISO 12999-1 band uncertainty.
The docs mirror gains the previously missing ISO 10052 survey-reports
section, and the survey snippet now defines the li and l1_2m inputs it
uses. Multi-line figure info boxes are translated as whole artists, and
the review fixes (headroom, legend placement, proper unit and Greek
glyphs) are applied to the new generators.
* Laboratory insulation guide: ISO 10140, ISO 15186-1 element and ISO 10848 Dn,f figures
Embed the new lab_insulation_result, intensity_element_insulation and
flanking_level_difference figures next to their snippets in the EN guide,
the ES mirror and the docs mirror, each with the dual usage/hand-written
code blocks. Add the one-line .plot() mentions for the laboratory
airborne result, the element-normalized intensity result and the
floor-covering improvement result, and a note on when Dn,f plots (the
inline example uses 9 bands, below the 16/5-band rating threshold).
* EN 12354 prediction guide: impact-term and radiated-power figures
Embed the new impact_prediction_terms and radiated_power_outdoor figures
next to their snippets in the EN guide, the ES mirror and the docs
mirror, with the dual usage/hand-written code blocks, and add the
one-line .plot() mentions for the airborne prediction, the impact
prediction, the facade prediction and the radiated-power result.
* Panel insulation guide: rated Sharp prediction figure and plot mentions
Embed the new single_panel_rating figure (the 6 mm glass Sharp prediction
rated per ISO 717-1, coincidence dip marked) in the EN guide, the ES
mirror and the docs mirror with the dual code blocks, and add the
one-line .plot() mentions for the single-panel, double-wall and
radiation-efficiency results next to the existing concept figure.
* Junction transmission guide: Kij design chart, EN 12354 worked example and see-also
Add the junction_kij_thickness figure (wave-approach Kij versus the plate
thickness ratio for the X, T and L junctions, identical-plates value
marked) next to the coupling-loss-factor section, a res.plot() mention
in its snippet, a worked example that feeds the predicted K12 = 9.8 dB
of the 100/200 mm concrete X-junction into the EN 12354-1 flanking model
(R'w = 55.4 dB, direct path dominant), and a See-also section linking
the prediction, laboratory, structure-borne power and mobility guides.
EN guide, ES mirror and docs mirror in sync.
* Junction transmission docs mirror: sync the Kij chart, worked example and see-also
* Structure-borne power and installed-source guides: plot mentions, Hopkins citation and see-also
Add the one-line .plot() mentions for the reception-plate power result
(EN 15657) and the installed-source prediction (EN 12354-5) next to their
existing figures, add the one-line .plot() usage to both figures' code
blocks, cite Hopkins (2007) Section 2.8 for the point-excited-plate power
input behind the clause 4.4.3 coupling term with a prose paragraph
connecting the mobility chain, and give the EN 12354-5 page a proper
See-also linking the EN 15657, ISO 7626, junction and EN 12354 guides.
EN guides, ES mirrors and docs mirrors in sync.
* Vibration FRF guides: plot mentions and transfer-stiffness docs sync
Add the one-line .plot() usage and mentions for the ISO/TS 7849
sound-power-from-vibration result, the EN 29052-1 dynamic-stiffness
result and the ISO 10846 indirect transfer-stiffness result next to
their existing figures (EN guides, ES mirrors and docs mirrors), and
port the previously missing ISO 10846 test-report fiche section to the
transfer-stiffness docs mirror.
* Mechanical mobility guide: driving-point reading figure
Embed the new mobility_result_lines figure (|Y(f)| of the SDOF bundle
with the stiffness line, the mass line and the 1/c damping peak) next to
the MobilityResult snippet in the EN guide, the ES mirror and the docs
mirror, with the dual usage/hand-written code blocks and the one-line
res.plot() mention.
* Human vibration and multiple-shock guides: one-line plot mentions
Add the res.plot() one-liners next to the existing figures for the
ISO 8041-1 weighting response, the ISO 2631-1 weighted band spectrum, the
Directive 2002/44/EC daily exposure A(8) and the ISO 2631-5 multiple-shock
assessment, in the EN guides, the ES mirrors and the docs mirrors.
* Docs mirrors: restore missing report-fiche and concept sections
Sync the docs mirrors of the pages touched by this wave with their site
guides: the ISO 16283-3 facade report subsection on the field insulation
page, the EN 29052-1 and ISO 7626 fiche example snippets, and the panel
concept-figure code block.
* Changelog, API docs and llms regeneration; lint and typing fixes for the figure generators
* Fix nested emphasis in the survey-impact figure captions
* Restore the numerical-propagation rasters truncated by a mid-regeneration snapshot
* Reconcile the figure-script additions with the rooms and materials wave
* docs: regenerate the llms bundle after the figure-script reconciliation
Building and structure-borne guides: result figures, plot mentions and mirror sync (#360)
* Add .plot() to the ISO 717 enlarged-range rating results
ExtendedWeightedRatingResult and ExtendedImpactRatingResult now carry the
full enlarged-range band curve (band_centers, measured) and expose a
.plot() that draws the measured curve over the whole range against the
shifted ISO 717 reference on the 16 core bands, with the unfavourable
deviations shaded, the enlarged-range bands marked and every covered
Annex B / A.2.1 adaptation term in the title. EN/ES labels follow the
existing renderer conventions.
* Field insulation guide: enlarged-range, field-chain, facade and survey-impact figures
Four new deterministic figures (extended_insulation_rating,
field_airborne_insulation, facade_field_insulation,
survey_impact_insulation) generated in the four language/theme variants,
embedded next to their snippets in the EN guide, the ES mirror and the
docs mirror with the dual usage/hand-written code blocks. One-line
.plot() mentions added for the extended rating, the field airborne
result, the survey impact result and the ISO 12999-1 band uncertainty.
The docs mirror gains the previously missing ISO 10052 survey-reports
section, and the survey snippet now defines the li and l1_2m inputs it
uses. Multi-line figure info boxes are translated as whole artists, and
the review fixes (headroom, legend placement, proper unit and Greek
glyphs) are applied to the new generators.
* Laboratory insulation guide: ISO 10140, ISO 15186-1 element and ISO 10848 Dn,f figures
Embed the new lab_insulation_result, intensity_element_insulation and
flanking_level_difference figures next to their snippets in the EN guide,
the ES mirror and the docs mirror, each with the dual usage/hand-written
code blocks. Add the one-line .plot() mentions for the laboratory
airborne result, the element-normalized intensity result and the
floor-covering improvement result, and a note on when Dn,f plots (the
inline example uses 9 bands, below the 16/5-band rating threshold).
* EN 12354 prediction guide: impact-term and radiated-power figures
Embed the new impact_prediction_terms and radiated_power_outdoor figures
next to their snippets in the EN guide, the ES mirror and the docs
mirror, with the dual usage/hand-written code blocks, and add the
one-line .plot() mentions for the airborne prediction, the impact
prediction, the facade prediction and the radiated-power result.
* Panel insulation guide: rated Sharp prediction figure and plot mentions
Embed the new single_panel_rating figure (the 6 mm glass Sharp prediction
rated per ISO 717-1, coincidence dip marked) in the EN guide, the ES
mirror and the docs mirror with the dual code blocks, and add the
one-line .plot() mentions for the single-panel, double-wall and
radiation-efficiency results next to the existing concept figure.
* Junction transmission guide: Kij design chart, EN 12354 worked example and see-also
Add the junction_kij_thickness figure (wave-approach Kij versus the plate
thickness ratio for the X, T and L junctions, identical-plates value
marked) next to the coupling-loss-factor section, a res.plot() mention
in its snippet, a worked example that feeds the predicted K12 = 9.8 dB
of the 100/200 mm concrete X-junction into the EN 12354-1 flanking model
(R'w = 55.4 dB, direct path dominant), and a See-also section linking
the prediction, laboratory, structure-borne power and mobility guides.
EN guide, ES mirror and docs mirror in sync.
* Junction transmission docs mirror: sync the Kij chart, worked example and see-also
* Structure-borne power and installed-source guides: plot mentions, Hopkins citation and see-also
Add the one-line .plot() mentions for the reception-plate power result
(EN 15657) and the installed-source prediction (EN 12354-5) next to their
existing figures, add the one-line .plot() usage to both figures' code
blocks, cite Hopkins (2007) Section 2.8 for the point-excited-plate power
input behind the clause 4.4.3 coupling term with a prose paragraph
connecting the mobility chain, and give the EN 12354-5 page a proper
See-also linking the EN 15657, ISO 7626, junction and EN 12354 guides.
EN guides, ES mirrors and docs mirrors in sync.
* Vibration FRF guides: plot mentions and transfer-stiffness docs sync
Add the one-line .plot() usage and mentions for the ISO/TS 7849
sound-power-from-vibration result, the EN 29052-1 dynamic-stiffness
result and the ISO 10846 indirect transfer-stiffness result next to
their existing figures (EN guides, ES mirrors and docs mirrors), and
port the previously missing ISO 10846 test-report fiche section to the
transfer-stiffness docs mirror.
* Mechanical mobility guide: driving-point reading figure
Embed the new mobility_result_lines figure (|Y(f)| of the SDOF bundle
with the stiffness line, the mass line and the 1/c damping peak) next to
the MobilityResult snippet in the EN guide, the ES mirror and the docs
mirror, with the dual usage/hand-written code blocks and the one-line
res.plot() mention.
* Human vibration and multiple-shock guides: one-line plot mentions
Add the res.plot() one-liners next to the existing figures for the
ISO 8041-1 weighting response, the ISO 2631-1 weighted band spectrum, the
Directive 2002/44/EC daily exposure A(8) and the ISO 2631-5 multiple-shock
assessment, in the EN guides, the ES mirrors and the docs mirrors.
* Docs mirrors: restore missing report-fiche and concept sections
Sync the docs mirrors of the pages touched by this wave with their site
guides: the ISO 16283-3 facade report subsection on the field insulation
page, the EN 29052-1 and ISO 7626 fiche example snippets, and the panel
concept-figure code block.
* Changelog, API docs and llms regeneration; lint and typing fixes for the figure generators
* Fix nested emphasis in the survey-impact figure captions
* Restore the numerical-propagation rasters truncated by a mid-regeneration snapshot
* Reconcile the figure-script additions with the rooms and materials wave
* docs: regenerate the llms bundle after the figure-script reconciliation
Building and structure-borne guides: result figures, plot mentions and mirror sync (#360)
* Add .plot() to the ISO 717 enlarged-range rating results
ExtendedWeightedRatingResult and ExtendedImpactRatingResult now carry the
full enlarged-range band curve (band_centers, measured) and expose a
.plot() that draws the measured curve over the whole range against the
shifted ISO 717 reference on the 16 core bands, with the unfavourable
deviations shaded, the enlarged-range bands marked and every covered
Annex B / A.2.1 adaptation term in the title. EN/ES labels follow the
existing renderer conventions.
* Field insulation guide: enlarged-range, field-chain, facade and survey-impact figures
Four new deterministic figures (extended_insulation_rating,
field_airborne_insulation, facade_field_insulation,
survey_impact_insulation) generated in the four language/theme variants,
embedded next to their snippets in the EN guide, the ES mirror and the
docs mirror with the dual usage/hand-written code blocks. One-line
.plot() mentions added for the extended rating, the field airborne
result, the survey impact result and the ISO 12999-1 band uncertainty.
The docs mirror gains the previously missing ISO 10052 survey-reports
section, and the survey snippet now defines the li and l1_2m inputs it
uses. Multi-line figure info boxes are translated as whole artists, and
the review fixes (headroom, legend placement, proper unit and Greek
glyphs) are applied to the new generators.
* Laboratory insulation guide: ISO 10140, ISO 15186-1 element and ISO 10848 Dn,f figures
Embed the new lab_insulation_result, intensity_element_insulation and
flanking_level_difference figures next to their snippets in the EN guide,
the ES mirror and the docs mirror, each with the dual usage/hand-written
code blocks. Add the one-line .plot() mentions for the laboratory
airborne result, the element-normalized intensity result and the
floor-covering improvement result, and a note on when Dn,f plots (the
inline example uses 9 bands, below the 16/5-band rating threshold).
* EN 12354 prediction guide: impact-term and radiated-power figures
Embed the new impact_prediction_terms and radiated_power_outdoor figures
next to their snippets in the EN guide, the ES mirror and the docs
mirror, with the dual usage/hand-written code blocks, and add the
one-line .plot() mentions for the airborne prediction, the impact
prediction, the facade prediction and the radiated-power result.
* Panel insulation guide: rated Sharp prediction figure and plot mentions
Embed the new single_panel_rating figure (the 6 mm glass Sharp prediction
rated per ISO 717-1, coincidence dip marked) in the EN guide, the ES
mirror and the docs mirror with the dual code blocks, and add the
one-line .plot() mentions for the single-panel, double-wall and
radiation-efficiency results next to the existing concept figure.
* Junction transmission guide: Kij design chart, EN 12354 worked example and see-also
Add the junction_kij_thickness figure (wave-approach Kij versus the plate
thickness ratio for the X, T and L junctions, identical-plates value
marked) next to the coupling-loss-factor section, a res.plot() mention
in its snippet, a worked example that feeds the predicted K12 = 9.8 dB
of the 100/200 mm concrete X-junction into the EN 12354-1 flanking model
(R'w = 55.4 dB, direct path dominant), and a See-also section linking
the prediction, laboratory, structure-borne power and mobility guides.
EN guide, ES mirror and docs mirror in sync.
* Junction transmission docs mirror: sync the Kij chart, worked example and see-also
* Structure-borne power and installed-source guides: plot mentions, Hopkins citation and see-also
Add the one-line .plot() mentions for the reception-plate power result
(EN 15657) and the installed-source prediction (EN 12354-5) next to their
existing figures, add the one-line .plot() usage to both figures' code
blocks, cite Hopkins (2007) Section 2.8 for the point-excited-plate power
input behind the clause 4.4.3 coupling term with a prose paragraph
connecting the mobility chain, and give the EN 12354-5 page a proper
See-also linking the EN 15657, ISO 7626, junction and EN 12354 guides.
EN guides, ES mirrors and docs mirrors in sync.
* Vibration FRF guides: plot mentions and transfer-stiffness docs sync
Add the one-line .plot() usage and mentions for the ISO/TS 7849
sound-power-from-vibration result, the EN 29052-1 dynamic-stiffness
result and the ISO 10846 indirect transfer-stiffness result next to
their existing figures (EN guides, ES mirrors and docs mirrors), and
port the previously missing ISO 10846 test-report fiche section to the
transfer-stiffness docs mirror.
* Mechanical mobility guide: driving-point reading figure
Embed the new mobility_result_lines figure (|Y(f)| of the SDOF bundle
with the stiffness line, the mass line and the 1/c damping peak) next to
the MobilityResult snippet in the EN guide, the ES mirror and the docs
mirror, with the dual usage/hand-written code blocks and the one-line
res.plot() mention.
* Human vibration and multiple-shock guides: one-line plot mentions
Add the res.plot() one-liners next to the existing figures for the
ISO 8041-1 weighting response, the ISO 2631-1 weighted band spectrum, the
Directive 2002/44/EC daily exposure A(8) and the ISO 2631-5 multiple-shock
assessment, in the EN guides, the ES mirrors and the docs mirrors.
* Docs mirrors: restore missing report-fiche and concept sections
Sync the docs mirrors of the pages touched by this wave with their site
guides: the ISO 16283-3 facade report subsection on the field insulation
page, the EN 29052-1 and ISO 7626 fiche example snippets, and the panel
concept-figure code block.
* Changelog, API docs and llms regeneration; lint and typing fixes for the figure generators
* Fix nested emphasis in the survey-impact figure captions
* Restore the numerical-propagation rasters truncated by a mid-regeneration snapshot
* Reconcile the figure-script additions with the rooms and materials wave
* docs: regenerate the llms bundle after the figure-script reconciliation
Spanish docs: UNE terminology, decimal commas, localized snippets and theory figures (#365)
* Normalize Spanish docs prose to UNE acoustic terminology
Sweep the Spanish pages for the non-UNE forms "presion sonora",
"potencia sonora" and "intensidad sonora" and normalize the prose to
the wording used by the official Spanish editions of the standards:
"presion acustica" (UNE-EN ISO 16283-2:2016, UNE-EN ISO 10052:2005,
UNE-EN ISO 3746:2011, UNE-ISO 226:2013), "potencia acustica"
(UNE-EN ISO 3746:2011, UNE-EN ISO 4871:2010, UNE-EN ISO 9614-1:2010),
"intensidad acustica" (UNE-EN 61043:1999, UNE-EN ISO 9614-1:2010) and
"nivel de presion acustica de impactos" (UNE-EN ISO 12354-2:2018,
UNE-EN ISO 717-2:2013). 92 replacements across 32 pages, prose only:
code snippets keep the labels they share with the generated figures.
Rename the intensity guide to "Intensidad acustica (p-p)" and the
structure-borne power guide to "Potencia acustica estructural de
equipos (EN 15657)", updating every cross-link text and the theory
anchor intensidad-sonora-iec-61043 accordingly. The API sidebar group
label becomes "Potencia acustica e intensidad" via api_taxonomy.py
with the generated sidebar regenerated.
* Use decimal commas in Spanish docs prose quantities
Sweep every Spanish page for decimal points leaking into prose numbers
and switch them to the comma the locale convention calls for: the
rotorcraft validation prose (fourteen tolerances such as 0,08 dB(A) and
0,5 s), the insulation-prediction worked example (53,6 dB / 53,8 dB),
the tone-audibility Annex E tone (137,3 Hz), the Mackenzie check value
(1550,744 m/s), the EPNL, loudness and absorption fiche descriptions
(98,3 EPNdB; 8,2 sonos and 70,4 fonios; 0,60 y 0,55), the junction
constants table and the third-octave band-edge table in the signal
analysis theory page. Code snippets, inline code, math, clause numbers
and quoted source text keep their points.
* Pass language="es" in Spanish figure-reproduction snippets
The <details> blocks under each localized figure in the Spanish guides
are meant to reproduce the _es variant shown on the page, but 82 of the
one-line result .plot() calls omitted the language="es" argument and
would render English axis labels instead. Add the argument across 33
guides, matching the pattern the intensity field-indicators snippet
already used. The three lab-insulation results whose plot() does not
take a language argument (lab airborne, lab impact and the
element-normalized intensity difference) are left as they were.
* Extend the UNE terminology sweep to sound absorption
Normalize "absorción sonora" to "absorción acústica" across the
Spanish pages (36 occurrences in 14 pages, including the EN 12354-6
guide title and the theory headings), the wording of UNE-EN ISO
3746:2011 and of the equivalent absorption area in UNE-EN ISO
10140-3:2011, UNE-EN ISO 12354-2:2018 and UNE-EN ISO 16283-2:2016, and
the same term the accredited report strings already use. Also restore
the accent in the theory index anchor to the renamed intensity heading,
since heading slugs keep accented characters.
* Theory pages: illustrate each section family with existing result figures
The seven theory pages carried no figures at all. Embed sixteen of the
existing generated figures (light and dark variants, Spanish variants on
the Spanish mirrors) where the concept matches the prose: weighting
curves, time integration and the p-p intensity estimator in the signal
analysis page; equal-loudness contours, the specific-loudness pattern
and the hearing-threshold panels in perception; NC/RC rating, the
Schroeder decay and the ISO 717-1 shifted reference in rooms and
buildings; the Lden profile, ISO 9613-1 absorption and the three sound
power routes in environment and transport; the scattering coefficient
and ISO 11654 rating in materials and surfaces; and the Wk weighting and
the resonator mobility triplet in vibration. Each embed reuses the alt
text of the guide that owns the figure and adds a one-line caption.
Also give the wave-simulation section hub the reading-order paragraph
its siblings already have, linking the closed-form pages the FDTD solver
cross-checks, in both languages.
* Address review findings from the Spanish locale sweeps
Second pass fixes flagged by review: five terminology occurrences the
line-based sweep missed because the noun and adjective were split by a
line wrap or emphasis markup (sound-power, rotorcraft-noise and two
section hubs); six Spanish pages that still embedded the English figure
variant although the _es variant exists (junction-transmission,
aircraft-noise airport contour, miso-coherence,
objective-intelligibility, psychoacoustic-annoyance twice); and 19 more
language="es" arguments on figure-reproduction plot calls the first
pass missed, chained-call receivers such as room.noise_criterion(spl)
.plot() and the axes-creating first call of the two-profile
atmospheric-refraction snippet among them. The lab-insulation plot
wrappers forward keyword arguments to the rating plot, so the three
calls excluded earlier now take the argument too. All Spanish python
fences re-checked to compile and EN/ES parity re-verified.
* Carry the UNE terminology into the generated-asset Spanish strings
Apply the same evidence-based decisions to every Spanish string source
that feeds generated assets: the translation tables of
generate_graphs.py and generate_diagrams.py, the _STRINGS tables of the
plot modules and the report i18n values. 35 strings change: "presión
acústica" (UNE-EN ISO 16283-2:2016, 10052:2005, 3746:2011),
"potencia acústica" (UNE-EN ISO 3746:2011, 4871:2010, 9614-1:2010),
"intensidad acústica" (UNE-EN 61043:1999, 9614-1:2010), "absorción
acústica" (UNE-EN ISO 3746:2011) and "nivel de presión acústica de
impactos" (UNE-EN ISO 12354-2:2018). Strings the UNE editions keep are
untouched: "emisión sonora", "exposición sonora", "campo sonoro",
"fuente sonora". Only Spanish values change; the English keys stay.
The two plot-i18n test assertions that pin the axis label follow, and
the eight Spanish doc fences that deliberately mirrored the old figure
labels now mirror the new ones.
* Regenerate the Spanish figure variants with the UNE terminology
make graphs after the string-source change: 48 files, all of them _es
or _es_dark variants (24 figure/diagram pairs), picking up "presión
acústica", "potencia acústica", "intensidad acústica", "absorción
acústica" and "nivel de presión acústica de impactos" in titles and
axis labels. The English variants are untouched. The committed example
fiches need no regeneration: every example in generate_reports.py
renders in English, so no changed Spanish report string reaches them.
* Align the intensity-fiche Spanish assertions with the UNE terminology
Spanish docs: UNE terminology, decimal commas, localized snippets and theory figures (#365)
* Normalize Spanish docs prose to UNE acoustic terminology
Sweep the Spanish pages for the non-UNE forms "presion sonora",
"potencia sonora" and "intensidad sonora" and normalize the prose to
the wording used by the official Spanish editions of the standards:
"presion acustica" (UNE-EN ISO 16283-2:2016, UNE-EN ISO 10052:2005,
UNE-EN ISO 3746:2011, UNE-ISO 226:2013), "potencia acustica"
(UNE-EN ISO 3746:2011, UNE-EN ISO 4871:2010, UNE-EN ISO 9614-1:2010),
"intensidad acustica" (UNE-EN 61043:1999, UNE-EN ISO 9614-1:2010) and
"nivel de presion acustica de impactos" (UNE-EN ISO 12354-2:2018,
UNE-EN ISO 717-2:2013). 92 replacements across 32 pages, prose only:
code snippets keep the labels they share with the generated figures.
Rename the intensity guide to "Intensidad acustica (p-p)" and the
structure-borne power guide to "Potencia acustica estructural de
equipos (EN 15657)", updating every cross-link text and the theory
anchor intensidad-sonora-iec-61043 accordingly. The API sidebar group
label becomes "Potencia acustica e intensidad" via api_taxonomy.py
with the generated sidebar regenerated.
* Use decimal commas in Spanish docs prose quantities
Sweep every Spanish page for decimal points leaking into prose numbers
and switch them to the comma the locale convention calls for: the
rotorcraft validation prose (fourteen tolerances such as 0,08 dB(A) and
0,5 s), the insulation-prediction worked example (53,6 dB / 53,8 dB),
the tone-audibility Annex E tone (137,3 Hz), the Mackenzie check value
(1550,744 m/s), the EPNL, loudness and absorption fiche descriptions
(98,3 EPNdB; 8,2 sonos and 70,4 fonios; 0,60 y 0,55), the junction
constants table and the third-octave band-edge table in the signal
analysis theory page. Code snippets, inline code, math, clause numbers
and quoted source text keep their points.
* Pass language="es" in Spanish figure-reproduction snippets
The <details> blocks under each localized figure in the Spanish guides
are meant to reproduce the _es variant shown on the page, but 82 of the
one-line result .plot() calls omitted the language="es" argument and
would render English axis labels instead. Add the argument across 33
guides, matching the pattern the intensity field-indicators snippet
already used. The three lab-insulation results whose plot() does not
take a language argument (lab airborne, lab impact and the
element-normalized intensity difference) are left as they were.
* Extend the UNE terminology sweep to sound absorption
Normalize "absorción sonora" to "absorción acústica" across the
Spanish pages (36 occurrences in 14 pages, including the EN 12354-6
guide title and the theory headings), the wording of UNE-EN ISO
3746:2011 and of the equivalent absorption area in UNE-EN ISO
10140-3:2011, UNE-EN ISO 12354-2:2018 and UNE-EN ISO 16283-2:2016, and
the same term the accredited report strings already use. Also restore
the accent in the theory index anchor to the renamed intensity heading,
since heading slugs keep accented characters.
* Theory pages: illustrate each section family with existing result figures
The seven theory pages carried no figures at all. Embed sixteen of the
existing generated figures (light and dark variants, Spanish variants on
the Spanish mirrors) where the concept matches the prose: weighting
curves, time integration and the p-p intensity estimator in the signal
analysis page; equal-loudness contours, the specific-loudness pattern
and the hearing-threshold panels in perception; NC/RC rating, the
Schroeder decay and the ISO 717-1 shifted reference in rooms and
buildings; the Lden profile, ISO 9613-1 absorption and the three sound
power routes in environment and transport; the scattering coefficient
and ISO 11654 rating in materials and surfaces; and the Wk weighting and
the resonator mobility triplet in vibration. Each embed reuses the alt
text of the guide that owns the figure and adds a one-line caption.
Also give the wave-simulation section hub the reading-order paragraph
its siblings already have, linking the closed-form pages the FDTD solver
cross-checks, in both languages.
* Address review findings from the Spanish locale sweeps
Second pass fixes flagged by review: five terminology occurrences the
line-based sweep missed because the noun and adjective were split by a
line wrap or emphasis markup (sound-power, rotorcraft-noise and two
section hubs); six Spanish pages that still embedded the English figure
variant although the _es variant exists (junction-transmission,
aircraft-noise airport contour, miso-coherence,
objective-intelligibility, psychoacoustic-annoyance twice); and 19 more
language="es" arguments on figure-reproduction plot calls the first
pass missed, chained-call receivers such as room.noise_criterion(spl)
.plot() and the axes-creating first call of the two-profile
atmospheric-refraction snippet among them. The lab-insulation plot
wrappers forward keyword arguments to the rating plot, so the three
calls excluded earlier now take the argument too. All Spanish python
fences re-checked to compile and EN/ES parity re-verified.
* Carry the UNE terminology into the generated-asset Spanish strings
Apply the same evidence-based decisions to every Spanish string source
that feeds generated assets: the translation tables of
generate_graphs.py and generate_diagrams.py, the _STRINGS tables of the
plot modules and the report i18n values. 35 strings change: "presión
acústica" (UNE-EN ISO 16283-2:2016, 10052:2005, 3746:2011),
"potencia acústica" (UNE-EN ISO 3746:2011, 4871:2010, 9614-1:2010),
"intensidad acústica" (UNE-EN 61043:1999, 9614-1:2010), "absorción
acústica" (UNE-EN ISO 3746:2011) and "nivel de presión acústica de
impactos" (UNE-EN ISO 12354-2:2018). Strings the UNE editions keep are
untouched: "emisión sonora", "exposición sonora", "campo sonoro",
"fuente sonora". Only Spanish values change; the English keys stay.
The two plot-i18n test assertions that pin the axis label follow, and
the eight Spanish doc fences that deliberately mirrored the old figure
labels now mirror the new ones.
* Regenerate the Spanish figure variants with the UNE terminology
make graphs after the string-source change: 48 files, all of them _es
or _es_dark variants (24 figure/diagram pairs), picking up "presión
acústica", "potencia acústica", "intensidad acústica", "absorción
acústica" and "nivel de presión acústica de impactos" in titles and
axis labels. The English variants are untouched. The committed example
fiches need no regeneration: every example in generate_reports.py
renders in English, so no changed Spanish report string reaches them.
* Align the intensity-fiche Spanish assertions with the UNE terminology
Core metrology guides: result figures, ResampledSignalResult.plot() and real introductions (#364)
* Add ResampledSignalResult.plot(): the delivered anti-alias filter against its design spec
* Rewrite the multichannel guide intro: concrete use cases, per-channel guarantees, Bendat & Piersol citations
* Give the levels page a real introduction: descriptor families, when-to-use guidance and survey references
* Time weighting: framing intro with detector history, ANSI S1.4/Bies references and sibling links
* Calibration: proper introduction (SPL vs dBFS choice, workflow framing) with Bies reference and sibling links
* Add eleven core-metrology figures: resampling spec, cepstrum variants, liftering, correlation, IR alignment, Hilbert envelope, cross-spectra, Golay recovery, TSA noise law, runs test
* Test signals: anti-alias figure with dual snippet, res.plot() mention, See also, docs mirror sync
* Cepstrum guide: variants and liftering figures with dual snippets, complex-cepstrum plot mention
* Correlation guide: normalization, IR-alignment and Hilbert-envelope figures with dual snippets
* Spectral analysis: cross-spectral density and coherent-output-SNR figures with dual snippets
* System measurement: Golay exact-recovery figure and plot mentions for the inversion workflow
* Synchronous averaging: sqrt(N) figure, diagnostics-tool guidance, See also, recording naming
* Data qualification: runs-test figure with dual snippet and peak-statistics plot mention
* MISO coherence: conditioning-order snippet, practical pitfalls and See also across the three trees
* Time-frequency: Harris window reference and See also across the three trees
* GUM uncertainty: map the domain pages that consume the clause-5 machinery, expand See also
* Filter banks: compliance plot mentions and recording naming in the crossover snippet
* Changelog entry for the core-metrology documentation figures and prose
* Regenerate llms-full.txt for the core-metrology documentation
* Drop the duplicated phase-axis translation key
Core metrology guides: result figures, ResampledSignalResult.plot() and real introductions (#364)
* Add ResampledSignalResult.plot(): the delivered anti-alias filter against its design spec
* Rewrite the multichannel guide intro: concrete use cases, per-channel guarantees, Bendat & Piersol citations
* Give the levels page a real introduction: descriptor families, when-to-use guidance and survey references
* Time weighting: framing intro with detector history, ANSI S1.4/Bies references and sibling links
* Calibration: proper introduction (SPL vs dBFS choice, workflow framing) with Bies reference and sibling links
* Add eleven core-metrology figures: resampling spec, cepstrum variants, liftering, correlation, IR alignment, Hilbert envelope, cross-spectra, Golay recovery, TSA noise law, runs test
* Test signals: anti-alias figure with dual snippet, res.plot() mention, See also, docs mirror sync
* Cepstrum guide: variants and liftering figures with dual snippets, complex-cepstrum plot mention
* Correlation guide: normalization, IR-alignment and Hilbert-envelope figures with dual snippets
* Spectral analysis: cross-spectral density and coherent-output-SNR figures with dual snippets
* System measurement: Golay exact-recovery figure and plot mentions for the inversion workflow
* Synchronous averaging: sqrt(N) figure, diagnostics-tool guidance, See also, recording naming
* Data qualification: runs-test figure with dual snippet and peak-statistics plot mention
* MISO coherence: conditioning-order snippet, practical pitfalls and See also across the three trees
* Time-frequency: Harris window reference and See also across the three trees
* GUM uncertainty: map the domain pages that consume the clause-5 machinery, expand See also
* Filter banks: compliance plot mentions and recording naming in the crossover snippet
* Changelog entry for the core-metrology documentation figures and prose
* Regenerate llms-full.txt for the core-metrology documentation
* Drop the duplicated phase-axis translation key
Core metrology guides: result figures, ResampledSignalResult.plot() and real introductions (#364)
* Add ResampledSignalResult.plot(): the delivered anti-alias filter against its design spec
* Rewrite the multichannel guide intro: concrete use cases, per-channel guarantees, Bendat & Piersol citations
* Give the levels page a real introduction: descriptor families, when-to-use guidance and survey references
* Time weighting: framing intro with detector history, ANSI S1.4/Bies references and sibling links
* Calibration: proper introduction (SPL vs dBFS choice, workflow framing) with Bies reference and sibling links
* Add eleven core-metrology figures: resampling spec, cepstrum variants, liftering, correlation, IR alignment, Hilbert envelope, cross-spectra, Golay recovery, TSA noise law, runs test
* Test signals: anti-alias figure with dual snippet, res.plot() mention, See also, docs mirror sync
* Cepstrum guide: variants and liftering figures with dual snippets, complex-cepstrum plot mention
* Correlation guide: normalization, IR-alignment and Hilbert-envelope figures with dual snippets
* Spectral analysis: cross-spectral density and coherent-output-SNR figures with dual snippets
* System measurement: Golay exact-recovery figure and plot mentions for the inversion workflow
* Synchronous averaging: sqrt(N) figure, diagnostics-tool guidance, See also, recording naming
* Data qualification: runs-test figure with dual snippet and peak-statistics plot mention
* MISO coherence: conditioning-order snippet, practical pitfalls and See also across the three trees
* Time-frequency: Harris window reference and See also across the three trees
* GUM uncertainty: map the domain pages that consume the clause-5 machinery, expand See also
* Filter banks: compliance plot mentions and recording naming in the crossover snippet
* Changelog entry for the core-metrology documentation figures and prose
* Regenerate llms-full.txt for the core-metrology documentation
* Drop the duplicated phase-axis translation key
Core metrology guides: result figures, ResampledSignalResult.plot() and real introductions (#364)
* Add ResampledSignalResult.plot(): the delivered anti-alias filter against its design spec
* Rewrite the multichannel guide intro: concrete use cases, per-channel guarantees, Bendat & Piersol citations
* Give the levels page a real introduction: descriptor families, when-to-use guidance and survey references
* Time weighting: framing intro with detector history, ANSI S1.4/Bies references and sibling links
* Calibration: proper introduction (SPL vs dBFS choice, workflow framing) with Bies reference and sibling links
* Add eleven core-metrology figures: resampling spec, cepstrum variants, liftering, correlation, IR alignment, Hilbert envelope, cross-spectra, Golay recovery, TSA noise law, runs test
* Test signals: anti-alias figure with dual snippet, res.plot() mention, See also, docs mirror sync
* Cepstrum guide: variants and liftering figures with dual snippets, complex-cepstrum plot mention
* Correlation guide: normalization, IR-alignment and Hilbert-envelope figures with dual snippets
* Spectral analysis: cross-spectral density and coherent-output-SNR figures with dual snippets
* System measurement: Golay exact-recovery figure and plot mentions for the inversion workflow
* Synchronous averaging: sqrt(N) figure, diagnostics-tool guidance, See also, recording naming
* Data qualification: runs-test figure with dual snippet and peak-statistics plot mention
* MISO coherence: conditioning-order snippet, practical pitfalls and See also across the three trees
* Time-frequency: Harris window reference and See also across the three trees
* GUM uncertainty: map the domain pages that consume the clause-5 machinery, expand See also
* Filter banks: compliance plot mentions and recording naming in the crossover snippet
* Changelog entry for the core-metrology documentation figures and prose
* Regenerate llms-full.txt for the core-metrology documentation
* Drop the duplicated phase-axis translation key
Spanish docs: UNE terminology, decimal commas, localized snippets and theory figures (#365)
* Normalize Spanish docs prose to UNE acoustic terminology
Sweep the Spanish pages for the non-UNE forms "presion sonora",
"potencia sonora" and "intensidad sonora" and normalize the prose to
the wording used by the official Spanish editions of the standards:
"presion acustica" (UNE-EN ISO 16283-2:2016, UNE-EN ISO 10052:2005,
UNE-EN ISO 3746:2011, UNE-ISO 226:2013), "potencia acustica"
(UNE-EN ISO 3746:2011, UNE-EN ISO 4871:2010, UNE-EN ISO 9614-1:2010),
"intensidad acustica" (UNE-EN 61043:1999, UNE-EN ISO 9614-1:2010) and
"nivel de presion acustica de impactos" (UNE-EN ISO 12354-2:2018,
UNE-EN ISO 717-2:2013). 92 replacements across 32 pages, prose only:
code snippets keep the labels they share with the generated figures.
Rename the intensity guide to "Intensidad acustica (p-p)" and the
structure-borne power guide to "Potencia acustica estructural de
equipos (EN 15657)", updating every cross-link text and the theory
anchor intensidad-sonora-iec-61043 accordingly. The API sidebar group
label becomes "Potencia acustica e intensidad" via api_taxonomy.py
with the generated sidebar regenerated.
* Use decimal commas in Spanish docs prose quantities
Sweep every Spanish page for decimal points leaking into prose numbers
and switch them to the comma the locale convention calls for: the
rotorcraft validation prose (fourteen tolerances such as 0,08 dB(A) and
0,5 s), the insulation-prediction worked example (53,6 dB / 53,8 dB),
the tone-audibility Annex E tone (137,3 Hz), the Mackenzie check value
(1550,744 m/s), the EPNL, loudness and absorption fiche descriptions
(98,3 EPNdB; 8,2 sonos and 70,4 fonios; 0,60 y 0,55), the junction
constants table and the third-octave band-edge table in the signal
analysis theory page. Code snippets, inline code, math, clause numbers
and quoted source text keep their points.
* Pass language="es" in Spanish figure-reproduction snippets
The <details> blocks under each localized figure in the Spanish guides
are meant to reproduce the _es variant shown on the page, but 82 of the
one-line result .plot() calls omitted the language="es" argument and
would render English axis labels instead. Add the argument across 33
guides, matching the pattern the intensity field-indicators snippet
already used. The three lab-insulation results whose plot() does not
take a language argument (lab airborne, lab impact and the
element-normalized intensity difference) are left as they were.
* Extend the UNE terminology sweep to sound absorption
Normalize "absorción sonora" to "absorción acústica" across the
Spanish pages (36 occurrences in 14 pages, including the EN 12354-6
guide title and the theory headings), the wording of UNE-EN ISO
3746:2011 and of the equivalent absorption area in UNE-EN ISO
10140-3:2011, UNE-EN ISO 12354-2:2018 and UNE-EN ISO 16283-2:2016, and
the same term the accredited report strings already use. Also restore
the accent in the theory index anchor to the renamed intensity heading,
since heading slugs keep accented characters.
* Theory pages: illustrate each section family with existing result figures
The seven theory pages carried no figures at all. Embed sixteen of the
existing generated figures (light and dark variants, Spanish variants on
the Spanish mirrors) where the concept matches the prose: weighting
curves, time integration and the p-p intensity estimator in the signal
analysis page; equal-loudness contours, the specific-loudness pattern
and the hearing-threshold panels in perception; NC/RC rating, the
Schroeder decay and the ISO 717-1 shifted reference in rooms and
buildings; the Lden profile, ISO 9613-1 absorption and the three sound
power routes in environment and transport; the scattering coefficient
and ISO 11654 rating in materials and surfaces; and the Wk weighting and
the resonator mobility triplet in vibration. Each embed reuses the alt
text of the guide that owns the figure and adds a one-line caption.
Also give the wave-simulation section hub the reading-order paragraph
its siblings already have, linking the closed-form pages the FDTD solver
cross-checks, in both languages.
* Address review findings from the Spanish locale sweeps
Second pass fixes flagged by review: five terminology occurrences the
line-based sweep missed because the noun and adjective were split by a
line wrap or emphasis markup (sound-power, rotorcraft-noise and two
section hubs); six Spanish pages that still embedded the English figure
variant although the _es variant exists (junction-transmission,
aircraft-noise airport contour, miso-coherence,
objective-intelligibility, psychoacoustic-annoyance twice); and 19 more
language="es" arguments on figure-reproduction plot calls the first
pass missed, chained-call receivers such as room.noise_criterion(spl)
.plot() and the axes-creating first call of the two-profile
atmospheric-refraction snippet among them. The lab-insulation plot
wrappers forward keyword arguments to the rating plot, so the three
calls excluded earlier now take the argument too. All Spanish python
fences re-checked to compile and EN/ES parity re-verified.
* Carry the UNE terminology into the generated-asset Spanish strings
Apply the same evidence-based decisions to every Spanish string source
that feeds generated assets: the translation tables of
generate_graphs.py and generate_diagrams.py, the _STRINGS tables of the
plot modules and the report i18n values. 35 strings change: "presión
acústica" (UNE-EN ISO 16283-2:2016, 10052:2005, 3746:2011),
"potencia acústica" (UNE-EN ISO 3746:2011, 4871:2010, 9614-1:2010),
"intensidad acústica" (UNE-EN 61043:1999, 9614-1:2010), "absorción
acústica" (UNE-EN ISO 3746:2011) and "nivel de presión acústica de
impactos" (UNE-EN ISO 12354-2:2018). Strings the UNE editions keep are
untouched: "emisión sonora", "exposición sonora", "campo sonoro",
"fuente sonora". Only Spanish values change; the English keys stay.
The two plot-i18n test assertions that pin the axis label follow, and
the eight Spanish doc fences that deliberately mirrored the old figure
labels now mirror the new ones.
* Regenerate the Spanish figure variants with the UNE terminology
make graphs after the string-source change: 48 files, all of them _es
or _es_dark variants (24 figure/diagram pairs), picking up "presión
acústica", "potencia acústica", "intensidad acústica", "absorción
acústica" and "nivel de presión acústica de impactos" in titles and
axis labels. The English variants are untouched. The committed example
fiches need no regeneration: every example in generate_reports.py
renders in English, so no changed Spanish report string reaches them.
* Align the intensity-fiche Spanish assertions with the UNE terminology
Spanish docs: UNE terminology, decimal commas, localized snippets and theory figures (#365)
* Normalize Spanish docs prose to UNE acoustic terminology
Sweep the Spanish pages for the non-UNE forms "presion sonora",
"potencia sonora" and "intensidad sonora" and normalize the prose to
the wording used by the official Spanish editions of the standards:
"presion acustica" (UNE-EN ISO 16283-2:2016, UNE-EN ISO 10052:2005,
UNE-EN ISO 3746:2011, UNE-ISO 226:2013), "potencia acustica"
(UNE-EN ISO 3746:2011, UNE-EN ISO 4871:2010, UNE-EN ISO 9614-1:2010),
"intensidad acustica" (UNE-EN 61043:1999, UNE-EN ISO 9614-1:2010) and
"nivel de presion acustica de impactos" (UNE-EN ISO 12354-2:2018,
UNE-EN ISO 717-2:2013). 92 replacements across 32 pages, prose only:
code snippets keep the labels they share with the generated figures.
Rename the intensity guide to "Intensidad acustica (p-p)" and the
structure-borne power guide to "Potencia acustica estructural de
equipos (EN 15657)", updating every cross-link text and the theory
anchor intensidad-sonora-iec-61043 accordingly. The API sidebar group
label becomes "Potencia acustica e intensidad" via api_taxonomy.py
with the generated sidebar regenerated.
* Use decimal commas in Spanish docs prose quantities
Sweep every Spanish page for decimal points leaking into prose numbers
and switch them to the comma the locale convention calls for: the
rotorcraft validation prose (fourteen tolerances such as 0,08 dB(A) and
0,5 s), the insulation-prediction worked example (53,6 dB / 53,8 dB),
the tone-audibility Annex E tone (137,3 Hz), the Mackenzie check value
(1550,744 m/s), the EPNL, loudness and absorption fiche descriptions
(98,3 EPNdB; 8,2 sonos and 70,4 fonios; 0,60 y 0,55), the junction
constants table and the third-octave band-edge table in the signal
analysis theory page. Code snippets, inline code, math, clause numbers
and quoted source text keep their points.
* Pass language="es" in Spanish figure-reproduction snippets
The <details> blocks under each localized figure in the Spanish guides
are meant to reproduce the _es variant shown on the page, but 82 of the
one-line result .plot() calls omitted the language="es" argument and
would render English axis labels instead. Add the argument across 33
guides, matching the pattern the intensity field-indicators snippet
already used. The three lab-insulation results whose plot() does not
take a language argument (lab airborne, lab impact and the
element-normalized intensity difference) are left as they were.
* Extend the UNE terminology sweep to sound absorption
Normalize "absorción sonora" to "absorción acústica" across the
Spanish pages (36 occurrences in 14 pages, including the EN 12354-6
guide title and the theory headings), the wording of UNE-EN ISO
3746:2011 and of the equivalent absorption area in UNE-EN ISO
10140-3:2011, UNE-EN ISO 12354-2:2018 and UNE-EN ISO 16283-2:2016, and
the same term the accredited report strings already use. Also restore
the accent in the theory index anchor to the renamed intensity heading,
since heading slugs keep accented characters.
* Theory pages: illustrate each section family with existing result figures
The seven theory pages carried no figures at all. Embed sixteen of the
existing generated figures (light and dark variants, Spanish variants on
the Spanish mirrors) where the concept matches the prose: weighting
curves, time integration and the p-p intensity estimator in the signal
analysis page; equal-loudness contours, the specific-loudness pattern
and the hearing-threshold panels in perception; NC/RC rating, the
Schroeder decay and the ISO 717-1 shifted reference in rooms and
buildings; the Lden profile, ISO 9613-1 absorption and the three sound
power routes in environment and transport; the scattering coefficient
and ISO 11654 rating in materials and surfaces; and the Wk weighting and
the resonator mobility triplet in vibration. Each embed reuses the alt
text of the guide that owns the figure and adds a one-line caption.
Also give the wave-simulation section hub the reading-order paragraph
its siblings already have, linking the closed-form pages the FDTD solver
cross-checks, in both languages.
* Address review findings from the Spanish locale sweeps
Second pass fixes flagged by review: five terminology occurrences the
line-based sweep missed because the noun and adjective were split by a
line wrap or emphasis markup (sound-power, rotorcraft-noise and two
section hubs); six Spanish pages that still embedded the English figure
variant although the _es variant exists (junction-transmission,
aircraft-noise airport contour, miso-coherence,
objective-intelligibility, psychoacoustic-annoyance twice); and 19 more
language="es" arguments on figure-reproduction plot calls the first
pass missed, chained-call receivers such as room.noise_criterion(spl)
.plot() and the axes-creating first call of the two-profile
atmospheric-refraction snippet among them. The lab-insulation plot
wrappers forward keyword arguments to the rating plot, so the three
calls excluded earlier now take the argument too. All Spanish python
fences re-checked to compile and EN/ES parity re-verified.
* Carry the UNE terminology into the generated-asset Spanish strings
Apply the same evidence-based decisions to every Spanish string source
that feeds generated assets: the translation tables of
generate_graphs.py and generate_diagrams.py, the _STRINGS tables of the
plot modules and the report i18n values. 35 strings change: "presión
acústica" (UNE-EN ISO 16283-2:2016, 10052:2005, 3746:2011),
"potencia acústica" (UNE-EN ISO 3746:2011, 4871:2010, 9614-1:2010),
"intensidad acústica" (UNE-EN 61043:1999, 9614-1:2010), "absorción
acústica" (UNE-EN ISO 3746:2011) and "nivel de presión acústica de
impactos" (UNE-EN ISO 12354-2:2018). Strings the UNE editions keep are
untouched: "emisión sonora", "exposición sonora", "campo sonoro",
"fuente sonora". Only Spanish values change; the English keys stay.
The two plot-i18n test assertions that pin the axis label follow, and
the eight Spanish doc fences that deliberately mirrored the old figure
labels now mirror the new ones.
* Regenerate the Spanish figure variants with the UNE terminology
make graphs after the string-source change: 48 files, all of them _es
or _es_dark variants (24 figure/diagram pairs), picking up "presión
acústica", "potencia acústica", "intensidad acústica", "absorción
acústica" and "nivel de presión acústica de impactos" in titles and
axis labels. The English variants are untouched. The committed example
fiches need no regeneration: every example in generate_reports.py
renders in English, so no changed Spanish report string reaches them.
* Align the intensity-fiche Spanish assertions with the UNE terminology
Spanish docs: UNE terminology, decimal commas, localized snippets and theory figures (#365)
* Normalize Spanish docs prose to UNE acoustic terminology
Sweep the Spanish pages for the non-UNE forms "presion sonora",
"potencia sonora" and "intensidad sonora" and normalize the prose to
the wording used by the official Spanish editions of the standards:
"presion acustica" (UNE-EN ISO 16283-2:2016, UNE-EN ISO 10052:2005,
UNE-EN ISO 3746:2011, UNE-ISO 226:2013), "potencia acustica"
(UNE-EN ISO 3746:2011, UNE-EN ISO 4871:2010, UNE-EN ISO 9614-1:2010),
"intensidad acustica" (UNE-EN 61043:1999, UNE-EN ISO 9614-1:2010) and
"nivel de presion acustica de impactos" (UNE-EN ISO 12354-2:2018,
UNE-EN ISO 717-2:2013). 92 replacements across 32 pages, prose only:
code snippets keep the labels they share with the generated figures.
Rename the intensity guide to "Intensidad acustica (p-p)" and the
structure-borne power guide to "Potencia acustica estructural de
equipos (EN 15657)", updating every cross-link text and the theory
anchor intensidad-sonora-iec-61043 accordingly. The API sidebar group
label becomes "Potencia acustica e intensidad" via api_taxonomy.py
with the generated sidebar regenerated.
* Use decimal commas in Spanish docs prose quantities
Sweep every Spanish page for decimal points leaking into prose numbers
and switch them to the comma the locale convention calls for: the
rotorcraft validation prose (fourteen tolerances such as 0,08 dB(A) and
0,5 s), the insulation-prediction worked example (53,6 dB / 53,8 dB),
the tone-audibility Annex E tone (137,3 Hz), the Mackenzie check value
(1550,744 m/s), the EPNL, loudness and absorption fiche descriptions
(98,3 EPNdB; 8,2 sonos and 70,4 fonios; 0,60 y 0,55), the junction
constants table and the third-octave band-edge table in the signal
analysis theory page. Code snippets, inline code, math, clause numbers
and quoted source text keep their points.
* Pass language="es" in Spanish figure-reproduction snippets
The <details> blocks under each localized figure in the Spanish guides
are meant to reproduce the _es variant shown on the page, but 82 of the
one-line result .plot() calls omitted the language="es" argument and
would render English axis labels instead. Add the argument across 33
guides, matching the pattern the intensity field-indicators snippet
already used. The three lab-insulation results whose plot() does not
take a language argument (lab airborne, lab impact and the
element-normalized intensity difference) are left as they were.
* Extend the UNE terminology sweep to sound absorption
Normalize "absorción sonora" to "absorción acústica" across the
Spanish pages (36 occurrences in 14 pages, including the EN 12354-6
guide title and the theory headings), the wording of UNE-EN ISO
3746:2011 and of the equivalent absorption area in UNE-EN ISO
10140-3:2011, UNE-EN ISO 12354-2:2018 and UNE-EN ISO 16283-2:2016, and
the same term the accredited report strings already use. Also restore
the accent in the theory index anchor to the renamed intensity heading,
since heading slugs keep accented characters.
* Theory pages: illustrate each section family with existing result figures
The seven theory pages carried no figures at all. Embed sixteen of the
existing generated figures (light and dark variants, Spanish variants on
the Spanish mirrors) where the concept matches the prose: weighting
curves, time integration and the p-p intensity estimator in the signal
analysis page; equal-loudness contours, the specific-loudness pattern
and the hearing-threshold panels in perception; NC/RC rating, the
Schroeder decay and the ISO 717-1 shifted reference in rooms and
buildings; the Lden profile, ISO 9613-1 absorption and the three sound
power routes in environment and transport; the scattering coefficient
and ISO 11654 rating in materials and surfaces; and the Wk weighting and
the resonator mobility triplet in vibration. Each embed reuses the alt
text of the guide that owns the figure and adds a one-line caption.
Also give the wave-simulation section hub the reading-order paragraph
its siblings already have, linking the closed-form pages the FDTD solver
cross-checks, in both languages.
* Address review findings from the Spanish locale sweeps
Second pass fixes flagged by review: five terminology occurrences the
line-based sweep missed because the noun and adjective were split by a
line wrap or emphasis markup (sound-power, rotorcraft-noise and two
section hubs); six Spanish pages that still embedded the English figure
variant although the _es variant exists (junction-transmission,
aircraft-noise airport contour, miso-coherence,
objective-intelligibility, psychoacoustic-annoyance twice); and 19 more
language="es" arguments on figure-reproduction plot calls the first
pass missed, chained-call receivers such as room.noise_criterion(spl)
.plot() and the axes-creating first call of the two-profile
atmospheric-refraction snippet among them. The lab-insulation plot
wrappers forward keyword arguments to the rating plot, so the three
calls excluded earlier now take the argument too. All Spanish python
fences re-checked to compile and EN/ES parity re-verified.
* Carry the UNE terminology into the generated-asset Spanish strings
Apply the same evidence-based decisions to every Spanish string source
that feeds generated assets: the translation tables of
generate_graphs.py and generate_diagrams.py, the _STRINGS tables of the
plot modules and the report i18n values. 35 strings change: "presión
acústica" (UNE-EN ISO 16283-2:2016, 10052:2005, 3746:2011),
"potencia acústica" (UNE-EN ISO 3746:2011, 4871:2010, 9614-1:2010),
"intensidad acústica" (UNE-EN 61043:1999, 9614-1:2010), "absorción
acústica" (UNE-EN ISO 3746:2011) and "nivel de presión acústica de
impactos" (UNE-EN ISO 12354-2:2018). Strings the UNE editions keep are
untouched: "emisión sonora", "exposición sonora", "campo sonoro",
"fuente sonora". Only Spanish values change; the English keys stay.
The two plot-i18n test assertions that pin the axis label follow, and
the eight Spanish doc fences that deliberately mirrored the old figure
labels now mirror the new ones.
* Regenerate the Spanish figure variants with the UNE terminology
make graphs after the string-source change: 48 files, all of them _es
or _es_dark variants (24 figure/diagram pairs), picking up "presión
acústica", "potencia acústica", "intensidad acústica", "absorción
acústica" and "nivel de presión acústica de impactos" in titles and
axis labels. The English variants are untouched. The committed example
fiches need no regeneration: every example in generate_reports.py
renders in English, so no changed Spanish report string reaches them.
* Align the intensity-fiche Spanish assertions with the UNE terminology
Spanish docs: UNE terminology, decimal commas, localized snippets and theory figures (#365)
* Normalize Spanish docs prose to UNE acoustic terminology
Sweep the Spanish pages for the non-UNE forms "presion sonora",
"potencia sonora" and "intensidad sonora" and normalize the prose to
the wording used by the official Spanish editions of the standards:
"presion acustica" (UNE-EN ISO 16283-2:2016, UNE-EN ISO 10052:2005,
UNE-EN ISO 3746:2011, UNE-ISO 226:2013), "potencia acustica"
(UNE-EN ISO 3746:2011, UNE-EN ISO 4871:2010, UNE-EN ISO 9614-1:2010),
"intensidad acustica" (UNE-EN 61043:1999, UNE-EN ISO 9614-1:2010) and
"nivel de presion acustica de impactos" (UNE-EN ISO 12354-2:2018,
UNE-EN ISO 717-2:2013). 92 replacements across 32 pages, prose only:
code snippets keep the labels they share with the generated figures.
Rename the intensity guide to "Intensidad acustica (p-p)" and the
structure-borne power guide to "Potencia acustica estructural de
equipos (EN 15657)", updating every cross-link text and the theory
anchor intensidad-sonora-iec-61043 accordingly. The API sidebar group
label becomes "Potencia acustica e intensidad" via api_taxonomy.py
with the generated sidebar regenerated.
* Use decimal commas in Spanish docs prose quantities
Sweep every Spanish page for decimal points leaking into prose numbers
and switch them to the comma the locale convention calls for: the
rotorcraft validation prose (fourteen tolerances such as 0,08 dB(A) and
0,5 s), the insulation-prediction worked example (53,6 dB / 53,8 dB),
the tone-audibility Annex E tone (137,3 Hz), the Mackenzie check value
(1550,744 m/s), the EPNL, loudness and absorption fiche descriptions
(98,3 EPNdB; 8,2 sonos and 70,4 fonios; 0,60 y 0,55), the junction
constants table and the third-octave band-edge table in the signal
analysis theory page. Code snippets, inline code, math, clause numbers
and quoted source text keep their points.
* Pass language="es" in Spanish figure-reproduction snippets
The <details> blocks under each localized figure in the Spanish guides
are meant to reproduce the _es variant shown on the page, but 82 of the
one-line result .plot() calls omitted the language="es" argument and
would render English axis labels instead. Add the argument across 33
guides, matching the pattern the intensity field-indicators snippet
already used. The three lab-insulation results whose plot() does not
take a language argument (lab airborne, lab impact and the
element-normalized intensity difference) are left as they were.
* Extend the UNE terminology sweep to sound absorption
Normalize "absorción sonora" to "absorción acústica" across the
Spanish pages (36 occurrences in 14 pages, including the EN 12354-6
guide title and the theory headings), the wording of UNE-EN ISO
3746:2011 and of the equivalent absorption area in UNE-EN ISO
10140-3:2011, UNE-EN ISO 12354-2:2018 and UNE-EN ISO 16283-2:2016, and
the same term the accredited report strings already use. Also restore
the accent in the theory index anchor to the renamed intensity heading,
since heading slugs keep accented characters.
* Theory pages: illustrate each section family with existing result figures
The seven theory pages carried no figures at all. Embed sixteen of the
existing generated figures (light and dark variants, Spanish variants on
the Spanish mirrors) where the concept matches the prose: weighting
curves, time integration and the p-p intensity estimator in the signal
analysis page; equal-loudness contours, the specific-loudness pattern
and the hearing-threshold panels in perception; NC/RC rating, the
Schroeder decay and the ISO 717-1 shifted reference in rooms and
buildings; the Lden profile, ISO 9613-1 absorption and the three sound
power routes in environment and transport; the scattering coefficient
and ISO 11654 rating in materials and surfaces; and the Wk weighting and
the resonator mobility triplet in vibration. Each embed reuses the alt
text of the guide that owns the figure and adds a one-line caption.
Also give the wave-simulation section hub the reading-order paragraph
its siblings already have, linking the closed-form pages the FDTD solver
cross-checks, in both languages.
* Address review findings from the Spanish locale sweeps
Second pass fixes flagged by review: five terminology occurrences the
line-based sweep missed because the noun and adjective were split by a
line wrap or emphasis markup (sound-power, rotorcraft-noise and two
section hubs); six Spanish pages that still embedded the English figure
variant although the _es variant exists (junction-transmission,
aircraft-noise airport contour, miso-coherence,
objective-intelligibility, psychoacoustic-annoyance twice); and 19 more
language="es" arguments on figure-reproduction plot calls the first
pass missed, chained-call receivers such as room.noise_criterion(spl)
.plot() and the axes-creating first call of the two-profile
atmospheric-refraction snippet among them. The lab-insulation plot
wrappers forward keyword arguments to the rating plot, so the three
calls excluded earlier now take the argument too. All Spanish python
fences re-checked to compile and EN/ES parity re-verified.
* Carry the UNE terminology into the generated-asset Spanish strings
Apply the same evidence-based decisions to every Spanish string source
that feeds generated assets: the translation tables of
generate_graphs.py and generate_diagrams.py, the _STRINGS tables of the
plot modules and the report i18n values. 35 strings change: "presión
acústica" (UNE-EN ISO 16283-2:2016, 10052:2005, 3746:2011),
"potencia acústica" (UNE-EN ISO 3746:2011, 4871:2010, 9614-1:2010),
"intensidad acústica" (UNE-EN 61043:1999, 9614-1:2010), "absorción
acústica" (UNE-EN ISO 3746:2011) and "nivel de presión acústica de
impactos" (UNE-EN ISO 12354-2:2018). Strings the UNE editions keep are
untouched: "emisión sonora", "exposición sonora", "campo sonoro",
"fuente sonora". Only Spanish values change; the English keys stay.
The two plot-i18n test assertions that pin the axis label follow, and
the eight Spanish doc fences that deliberately mirrored the old figure
labels now mirror the new ones.
* Regenerate the Spanish figure variants with the UNE terminology
make graphs after the string-source change: 48 files, all of them _es
or _es_dark variants (24 figure/diagram pairs), picking up "presión
acústica", "potencia acústica", "intensidad acústica", "absorción
acústica" and "nivel de presión acústica de impactos" in titles and
axis labels. The English variants are untouched. The committed example
fiches need no regeneration: every example in generate_reports.py
renders in English, so no changed Spanish report string reaches them.
* Align the intensity-fiche Spanish assertions with the UNE terminology
Spanish docs: UNE terminology, decimal commas, localized snippets and theory figures (#365)
* Normalize Spanish docs prose to UNE acoustic terminology
Sweep the Spanish pages for the non-UNE forms "presion sonora",
"potencia sonora" and "intensidad sonora" and normalize the prose to
the wording used by the official Spanish editions of the standards:
"presion acustica" (UNE-EN ISO 16283-2:2016, UNE-EN ISO 10052:2005,
UNE-EN ISO 3746:2011, UNE-ISO 226:2013), "potencia acustica"
(UNE-EN ISO 3746:2011, UNE-EN ISO 4871:2010, UNE-EN ISO 9614-1:2010),
"intensidad acustica" (UNE-EN 61043:1999, UNE-EN ISO 9614-1:2010) and
"nivel de presion acustica de impactos" (UNE-EN ISO 12354-2:2018,
UNE-EN ISO 717-2:2013). 92 replacements across 32 pages, prose only:
code snippets keep the labels they share with the generated figures.
Rename the intensity guide to "Intensidad acustica (p-p)" and the
structure-borne power guide to "Potencia acustica estructural de
equipos (EN 15657)", updating every cross-link text and the theory
anchor intensidad-sonora-iec-61043 accordingly. The API sidebar group
label becomes "Potencia acustica e intensidad" via api_taxonomy.py
with the generated sidebar regenerated.
* Use decimal commas in Spanish docs prose quantities
Sweep every Spanish page for decimal points leaking into prose numbers
and switch them to the comma the locale convention calls for: the
rotorcraft validation prose (fourteen tolerances such as 0,08 dB(A) and
0,5 s), the insulation-prediction worked example (53,6 dB / 53,8 dB),
the tone-audibility Annex E tone (137,3 Hz), the Mackenzie check value
(1550,744 m/s), the EPNL, loudness and absorption fiche descriptions
(98,3 EPNdB; 8,2 sonos and 70,4 fonios; 0,60 y 0,55), the junction
constants table and the third-octave band-edge table in the signal
analysis theory page. Code snippets, inline code, math, clause numbers
and quoted source text keep their points.
* Pass language="es" in Spanish figure-reproduction snippets
The <details> blocks under each localized figure in the Spanish guides
are meant to reproduce the _es variant shown on the page, but 82 of the
one-line result .plot() calls omitted the language="es" argument and
would render English axis labels instead. Add the argument across 33
guides, matching the pattern the intensity field-indicators snippet
already used. The three lab-insulation results whose plot() does not
take a language argument (lab airborne, lab impact and the
element-normalized intensity difference) are left as they were.
* Extend the UNE terminology sweep to sound absorption
Normalize "absorción sonora" to "absorción acústica" across the
Spanish pages (36 occurrences in 14 pages, including the EN 12354-6
guide title and the theory headings), the wording of UNE-EN ISO
3746:2011 and of the equivalent absorption area in UNE-EN ISO
10140-3:2011, UNE-EN ISO 12354-2:2018 and UNE-EN ISO 16283-2:2016, and
the same term the accredited report strings already use. Also restore
the accent in the theory index anchor to the renamed intensity heading,
since heading slugs keep accented characters.
* Theory pages: illustrate each section family with existing result figures
The seven theory pages carried no figures at all. Embed sixteen of the
existing generated figures (light and dark variants, Spanish variants on
the Spanish mirrors) where the concept matches the prose: weighting
curves, time integration and the p-p intensity estimator in the signal
analysis page; equal-loudness contours, the specific-loudness pattern
and the hearing-threshold panels in perception; NC/RC rating, the
Schroeder decay and the ISO 717-1 shifted reference in rooms and
buildings; the Lden profile, ISO 9613-1 absorption and the three sound
power routes in environment and transport; the scattering coefficient
and ISO 11654 rating in materials and surfaces; and the Wk weighting and
the resonator mobility triplet in vibration. Each embed reuses the alt
text of the guide that owns the figure and adds a one-line caption.
Also give the wave-simulation section hub the reading-order paragraph
its siblings already have, linking the closed-form pages the FDTD solver
cross-checks, in both languages.
* Address review findings from the Spanish locale sweeps
Second pass fixes flagged by review: five terminology occurrences the
line-based sweep missed because the noun and adjective were split by a
line wrap or emphasis markup (sound-power, rotorcraft-noise and two
section hubs); six Spanish pages that still embedded the English figure
variant although the _es variant exists (junction-transmission,
aircraft-noise airport contour, miso-coherence,
objective-intelligibility, psychoacoustic-annoyance twice); and 19 more
language="es" arguments on figure-reproduction plot calls the first
pass missed, chained-call receivers such as room.noise_criterion(spl)
.plot() and the axes-creating first call of the two-profile
atmospheric-refraction snippet among them. The lab-insulation plot
wrappers forward keyword arguments to the rating plot, so the three
calls excluded earlier now take the argument too. All Spanish python
fences re-checked to compile and EN/ES parity re-verified.
* Carry the UNE terminology into the generated-asset Spanish strings
Apply the same evidence-based decisions to every Spanish string source
that feeds generated assets: the translation tables of
generate_graphs.py and generate_diagrams.py, the _STRINGS tables of the
plot modules and the report i18n values. 35 strings change: "presión
acústica" (UNE-EN ISO 16283-2:2016, 10052:2005, 3746:2011),
"potencia acústica" (UNE-EN ISO 3746:2011, 4871:2010, 9614-1:2010),
"intensidad acústica" (UNE-EN 61043:1999, 9614-1:2010), "absorción
acústica" (UNE-EN ISO 3746:2011) and "nivel de presión acústica de
impactos" (UNE-EN ISO 12354-2:2018). Strings the UNE editions keep are
untouched: "emisión sonora", "exposición sonora", "campo sonoro",
"fuente sonora". Only Spanish values change; the English keys stay.
The two plot-i18n test assertions that pin the axis label follow, and
the eight Spanish doc fences that deliberately mirrored the old figure
labels now mirror the new ones.
* Regenerate the Spanish figure variants with the UNE terminology
make graphs after the string-source change: 48 files, all of them _es
or _es_dark variants (24 figure/diagram pairs), picking up "presión
acústica", "potencia acústica", "intensidad acústica", "absorción
acústica" and "nivel de presión acústica de impactos" in titles and
axis labels. The English variants are untouched. The committed example
fiches need no regeneration: every example in generate_reports.py
renders in English, so no changed Spanish report string reaches them.
* Align the intensity-fiche Spanish assertions with the UNE terminology
Spanish docs: UNE terminology, decimal commas, localized snippets and theory figures (#365)
* Normalize Spanish docs prose to UNE acoustic terminology
Sweep the Spanish pages for the non-UNE forms "presion sonora",
"potencia sonora" and "intensidad sonora" and normalize the prose to
the wording used by the official Spanish editions of the standards:
"presion acustica" (UNE-EN ISO 16283-2:2016, UNE-EN ISO 10052:2005,
UNE-EN ISO 3746:2011, UNE-ISO 226:2013), "potencia acustica"
(UNE-EN ISO 3746:2011, UNE-EN ISO 4871:2010, UNE-EN ISO 9614-1:2010),
"intensidad acustica" (UNE-EN 61043:1999, UNE-EN ISO 9614-1:2010) and
"nivel de presion acustica de impactos" (UNE-EN ISO 12354-2:2018,
UNE-EN ISO 717-2:2013). 92 replacements across 32 pages, prose only:
code snippets keep the labels they share with the generated figures.
Rename the intensity guide to "Intensidad acustica (p-p)" and the
structure-borne power guide to "Potencia acustica estructural de
equipos (EN 15657)", updating every cross-link text and the theory
anchor intensidad-sonora-iec-61043 accordingly. The API sidebar group
label becomes "Potencia acustica e intensidad" via api_taxonomy.py
with the generated sidebar regenerated.
* Use decimal commas in Spanish docs prose quantities
Sweep every Spanish page for decimal points leaking into prose numbers
and switch them to the comma the locale convention calls for: the
rotorcraft validation prose (fourteen tolerances such as 0,08 dB(A) and
0,5 s), the insulation-prediction worked example (53,6 dB / 53,8 dB),
the tone-audibility Annex E tone (137,3 Hz), the Mackenzie check value
(1550,744 m/s), the EPNL, loudness and absorption fiche descriptions
(98,3 EPNdB; 8,2 sonos and 70,4 fonios; 0,60 y 0,55), the junction
constants table and the third-octave band-edge table in the signal
analysis theory page. Code snippets, inline code, math, clause numbers
and quoted source text keep their points.
* Pass language="es" in Spanish figure-reproduction snippets
The <details> blocks under each localized figure in the Spanish guides
are meant to reproduce the _es variant shown on the page, but 82 of the
one-line result .plot() calls omitted the language="es" argument and
would render English axis labels instead. Add the argument across 33
guides, matching the pattern the intensity field-indicators snippet
already used. The three lab-insulation results whose plot() does not
take a language argument (lab airborne, lab impact and the
element-normalized intensity difference) are left as they were.
* Extend the UNE terminology sweep to sound absorption
Normalize "absorción sonora" to "absorción acústica" across the
Spanish pages (36 occurrences in 14 pages, including the EN 12354-6
guide title and the theory headings), the wording of UNE-EN ISO
3746:2011 and of the equivalent absorption area in UNE-EN ISO
10140-3:2011, UNE-EN ISO 12354-2:2018 and UNE-EN ISO 16283-2:2016, and
the same term the accredited report strings already use. Also restore
the accent in the theory index anchor to the renamed intensity heading,
since heading slugs keep accented characters.
* Theory pages: illustrate each section family with existing result figures
The seven theory pages carried no figures at all. Embed sixteen of the
existing generated figures (light and dark variants, Spanish variants on
the Spanish mirrors) where the concept matches the prose: weighting
curves, time integration and the p-p intensity estimator in the signal
analysis page; equal-loudness contours, the specific-loudness pattern
and the hearing-threshold panels in perception; NC/RC rating, the
Schroeder decay and the ISO 717-1 shifted reference in rooms and
buildings; the Lden profile, ISO 9613-1 absorption and the three sound
power routes in environment and transport; the scattering coefficient
and ISO 11654 rating in materials and surfaces; and the Wk weighting and
the resonator mobility triplet in vibration. Each embed reuses the alt
text of the guide that owns the figure and adds a one-line caption.
Also give the wave-simulation section hub the reading-order paragraph
its siblings already have, linking the closed-form pages the FDTD solver
cross-checks, in both languages.
* Address review findings from the Spanish locale sweeps
Second pass fixes flagged by review: five terminology occurrences the
line-based sweep missed because the noun and adjective were split by a
line wrap or emphasis markup (sound-power, rotorcraft-noise and two
section hubs); six Spanish pages that still embedded the English figure
variant although the _es variant exists (junction-transmission,
aircraft-noise airport contour, miso-coherence,
objective-intelligibility, psychoacoustic-annoyance twice); and 19 more
language="es" arguments on figure-reproduction plot calls the first
pass missed, chained-call receivers such as room.noise_criterion(spl)
.plot() and the axes-creating first call of the two-profile
atmospheric-refraction snippet among them. The lab-insulation plot
wrappers forward keyword arguments to the rating plot, so the three
calls excluded earlier now take the argument too. All Spanish python
fences re-checked to compile and EN/ES parity re-verified.
* Carry the UNE terminology into the generated-asset Spanish strings
Apply the same evidence-based decisions to every Spanish string source
that feeds generated assets: the translation tables of
generate_graphs.py and generate_diagrams.py, the _STRINGS tables of the
plot modules and the report i18n values. 35 strings change: "presión
acústica" (UNE-EN ISO 16283-2:2016, 10052:2005, 3746:2011),
"potencia acústica" (UNE-EN ISO 3746:2011, 4871:2010, 9614-1:2010),
"intensidad acústica" (UNE-EN 61043:1999, 9614-1:2010), "absorción
acústica" (UNE-EN ISO 3746:2011) and "nivel de presión acústica de
impactos" (UNE-EN ISO 12354-2:2018). Strings the UNE editions keep are
untouched: "emisión sonora", "exposición sonora", "campo sonoro",
"fuente sonora". Only Spanish values change; the English keys stay.
The two plot-i18n test assertions that pin the axis label follow, and
the eight Spanish doc fences that deliberately mirrored the old figure
labels now mirror the new ones.
* Regenerate the Spanish figure variants with the UNE terminology
make graphs after the string-source change: 48 files, all of them _es
or _es_dark variants (24 figure/diagram pairs), picking up "presión
acústica", "potencia acústica", "intensidad acústica", "absorción
acústica" and "nivel de presión acústica de impactos" in titles and
axis labels. The English variants are untouched. The committed example
fiches need no regeneration: every example in generate_reports.py
renders in English, so no changed Spanish report string reaches them.
* Align the intensity-fiche Spanish assertions with the UNE terminology
Multiple and partial coherence for MISO systems (Bendat & Piersol) (#295)
* Multiple and partial coherence for MISO systems (Bendat & Piersol)
Add miso_coherence for the multiple-input/single-output coherence
functions of Bendat & Piersol, Random Data 4e, Chapter 7. From the Welch
cross-spectral matrix of two or three partially correlated inputs and one
output it reports:
- the ordinary coherence of each input with the output (Eq. 7.109);
- the multiple coherence explained by all inputs jointly (Eq. 7.35), equal
to SNR/(1+SNR) for additive output noise of known level;
- the partial coherences (Eq. 7.87, 4th-edition total-output denominator)
obtained by the Gaussian-elimination conditioning of Section 7.3
(Eq. 7.94), so a source that only correlates with the true cause is no
longer credited for it;
- the partial coherent output spectra that decompose the output power
source by source (Eq. 7.86, with the shares plus the residual noise
reconstructing the output exactly), and a dominant_input() helper for the
strongest source per band.
The frozen MISOCoherenceResult also carries the Section 9.3 random errors
(the i-th ordered input keeps nd-(i-1) effective averages) and an EN/ES
.plot(). The estimators reuse the Welch core of spectra.py, so a MISO
coherence and a power_spectral_density taken with the same segment length
are consistent bin by bin.
The conditioning is pinned to the exact rational values of Problem 7.2
(G22.1 = 4/3, G2y.1 = 4/3, Gyy.1 = 13/3, partial coherence 2/15, multiple
coherence 0.7), and the identities are checked against the SNR relation and
the uncorrelated-input case where the partial coherences reduce to the
ordinary ones and their sum is the multiple coherence. Five conformance
rows, a test suite, an EN/ES guide with a worked figure, and the API
reference, bibliography and taxonomy entries accompany the module.
* Address MISO coherence review findings
- Give the coherent-output fills a fixed dB baseline derived once from the
finite dynamic range of the panel (new _finite_db_floor), clip the plotted
levels to it and set the y-limits explicitly, so a coherent output that
dips to zero no longer drags the axis through get_ylim() inside the loop.
- Share one pivot-safety mask between the coherent-output accumulation and
the Schur update (new _pivot_safe): a near-singular conditioned pivot is
now gated identically in both places, so the power decomposition
(sum of contributions + residual = Gyy) closes bin by bin. Add a singular
(perfectly collinear) and a near-collinear test covering the invariant.
- Reword the conformance description that contained literal pipe characters
("abs(G2y.1)^2/G22.1") so the generated CONFORMANCE.md table is not
corrupted; regenerate the report.
Multiple and partial coherence for MISO systems (Bendat & Piersol) (#295)
* Multiple and partial coherence for MISO systems (Bendat & Piersol)
Add miso_coherence for the multiple-input/single-output coherence
functions of Bendat & Piersol, Random Data 4e, Chapter 7. From the Welch
cross-spectral matrix of two or three partially correlated inputs and one
output it reports:
- the ordinary coherence of each input with the output (Eq. 7.109);
- the multiple coherence explained by all inputs jointly (Eq. 7.35), equal
to SNR/(1+SNR) for additive output noise of known level;
- the partial coherences (Eq. 7.87, 4th-edition total-output denominator)
obtained by the Gaussian-elimination conditioning of Section 7.3
(Eq. 7.94), so a source that only correlates with the true cause is no
longer credited for it;
- the partial coherent output spectra that decompose the output power
source by source (Eq. 7.86, with the shares plus the residual noise
reconstructing the output exactly), and a dominant_input() helper for the
strongest source per band.
The frozen MISOCoherenceResult also carries the Section 9.3 random errors
(the i-th ordered input keeps nd-(i-1) effective averages) and an EN/ES
.plot(). The estimators reuse the Welch core of spectra.py, so a MISO
coherence and a power_spectral_density taken with the same segment length
are consistent bin by bin.
The conditioning is pinned to the exact rational values of Problem 7.2
(G22.1 = 4/3, G2y.1 = 4/3, Gyy.1 = 13/3, partial coherence 2/15, multiple
coherence 0.7), and the identities are checked against the SNR relation and
the uncorrelated-input case where the partial coherences reduce to the
ordinary ones and their sum is the multiple coherence. Five conformance
rows, a test suite, an EN/ES guide with a worked figure, and the API
reference, bibliography and taxonomy entries accompany the module.
* Address MISO coherence review findings
- Give the coherent-output fills a fixed dB baseline derived once from the
finite dynamic range of the panel (new _finite_db_floor), clip the plotted
levels to it and set the y-limits explicitly, so a coherent output that
dips to zero no longer drags the axis through get_ylim() inside the loop.
- Share one pivot-safety mask between the coherent-output accumulation and
the Schur update (new _pivot_safe): a near-singular conditioned pivot is
now gated identically in both places, so the power decomposition
(sum of contributions + residual = Gyy) closes bin by bin. Add a singular
(perfectly collinear) and a near-collinear test covering the invariant.
- Reword the conformance description that contained literal pipe characters
("abs(G2y.1)^2/G22.1") so the generated CONFORMANCE.md table is not
corrupted; regenerate the report.
Multiple and partial coherence for MISO systems (Bendat & Piersol) (#295)
* Multiple and partial coherence for MISO systems (Bendat & Piersol)
Add miso_coherence for the multiple-input/single-output coherence
functions of Bendat & Piersol, Random Data 4e, Chapter 7. From the Welch
cross-spectral matrix of two or three partially correlated inputs and one
output it reports:
- the ordinary coherence of each input with the output (Eq. 7.109);
- the multiple coherence explained by all inputs jointly (Eq. 7.35), equal
to SNR/(1+SNR) for additive output noise of known level;
- the partial coherences (Eq. 7.87, 4th-edition total-output denominator)
obtained by the Gaussian-elimination conditioning of Section 7.3
(Eq. 7.94), so a source that only correlates with the true cause is no
longer credited for it;
- the partial coherent output spectra that decompose the output power
source by source (Eq. 7.86, with the shares plus the residual noise
reconstructing the output exactly), and a dominant_input() helper for the
strongest source per band.
The frozen MISOCoherenceResult also carries the Section 9.3 random errors
(the i-th ordered input keeps nd-(i-1) effective averages) and an EN/ES
.plot(). The estimators reuse the Welch core of spectra.py, so a MISO
coherence and a power_spectral_density taken with the same segment length
are consistent bin by bin.
The conditioning is pinned to the exact rational values of Problem 7.2
(G22.1 = 4/3, G2y.1 = 4/3, Gyy.1 = 13/3, partial coherence 2/15, multiple
coherence 0.7), and the identities are checked against the SNR relation and
the uncorrelated-input case where the partial coherences reduce to the
ordinary ones and their sum is the multiple coherence. Five conformance
rows, a test suite, an EN/ES guide with a worked figure, and the API
reference, bibliography and taxonomy entries accompany the module.
* Address MISO coherence review findings
- Give the coherent-output fills a fixed dB baseline derived once from the
finite dynamic range of the panel (new _finite_db_floor), clip the plotted
levels to it and set the y-limits explicitly, so a coherent output that
dips to zero no longer drags the axis through get_ylim() inside the loop.
- Share one pivot-safety mask between the coherent-output accumulation and
the Schur update (new _pivot_safe): a near-singular conditioned pivot is
now gated identically in both places, so the power decomposition
(sum of contributions + residual = Gyy) closes bin by bin. Add a singular
(perfectly collinear) and a near-collinear test covering the invariant.
- Reword the conformance description that contained literal pipe characters
("abs(G2y.1)^2/G22.1") so the generated CONFORMANCE.md table is not
corrupted; regenerate the report.
Multiple and partial coherence for MISO systems (Bendat & Piersol) (#295)
* Multiple and partial coherence for MISO systems (Bendat & Piersol)
Add miso_coherence for the multiple-input/single-output coherence
functions of Bendat & Piersol, Random Data 4e, Chapter 7. From the Welch
cross-spectral matrix of two or three partially correlated inputs and one
output it reports:
- the ordinary coherence of each input with the output (Eq. 7.109);
- the multiple coherence explained by all inputs jointly (Eq. 7.35), equal
to SNR/(1+SNR) for additive output noise of known level;
- the partial coherences (Eq. 7.87, 4th-edition total-output denominator)
obtained by the Gaussian-elimination conditioning of Section 7.3
(Eq. 7.94), so a source that only correlates with the true cause is no
longer credited for it;
- the partial coherent output spectra that decompose the output power
source by source (Eq. 7.86, with the shares plus the residual noise
reconstructing the output exactly), and a dominant_input() helper for the
strongest source per band.
The frozen MISOCoherenceResult also carries the Section 9.3 random errors
(the i-th ordered input keeps nd-(i-1) effective averages) and an EN/ES
.plot(). The estimators reuse the Welch core of spectra.py, so a MISO
coherence and a power_spectral_density taken with the same segment length
are consistent bin by bin.
The conditioning is pinned to the exact rational values of Problem 7.2
(G22.1 = 4/3, G2y.1 = 4/3, Gyy.1 = 13/3, partial coherence 2/15, multiple
coherence 0.7), and the identities are checked against the SNR relation and
the uncorrelated-input case where the partial coherences reduce to the
ordinary ones and their sum is the multiple coherence. Five conformance
rows, a test suite, an EN/ES guide with a worked figure, and the API
reference, bibliography and taxonomy entries accompany the module.
* Address MISO coherence review findings
- Give the coherent-output fills a fixed dB baseline derived once from the
finite dynamic range of the panel (new _finite_db_floor), clip the plotted
levels to it and set the y-limits explicitly, so a coherent output that
dips to zero no longer drags the axis through get_ylim() inside the loop.
- Share one pivot-safety mask between the coherent-output accumulation and
the Schur update (new _pivot_safe): a near-singular conditioned pivot is
now gated identically in both places, so the power decomposition
(sum of contributions + residual = Gyy) closes bin by bin. Add a singular
(perfectly collinear) and a near-collinear test covering the invariant.
- Reword the conformance description that contained literal pipe characters
("abs(G2y.1)^2/G22.1") so the generated CONFORMANCE.md table is not
corrupted; regenerate the report.
Building and structure-borne guides: result figures, plot mentions and mirror sync (#360)
* Add .plot() to the ISO 717 enlarged-range rating results
ExtendedWeightedRatingResult and ExtendedImpactRatingResult now carry the
full enlarged-range band curve (band_centers, measured) and expose a
.plot() that draws the measured curve over the whole range against the
shifted ISO 717 reference on the 16 core bands, with the unfavourable
deviations shaded, the enlarged-range bands marked and every covered
Annex B / A.2.1 adaptation term in the title. EN/ES labels follow the
existing renderer conventions.
* Field insulation guide: enlarged-range, field-chain, facade and survey-impact figures
Four new deterministic figures (extended_insulation_rating,
field_airborne_insulation, facade_field_insulation,
survey_impact_insulation) generated in the four language/theme variants,
embedded next to their snippets in the EN guide, the ES mirror and the
docs mirror with the dual usage/hand-written code blocks. One-line
.plot() mentions added for the extended rating, the field airborne
result, the survey impact result and the ISO 12999-1 band uncertainty.
The docs mirror gains the previously missing ISO 10052 survey-reports
section, and the survey snippet now defines the li and l1_2m inputs it
uses. Multi-line figure info boxes are translated as whole artists, and
the review fixes (headroom, legend placement, proper unit and Greek
glyphs) are applied to the new generators.
* Laboratory insulation guide: ISO 10140, ISO 15186-1 element and ISO 10848 Dn,f figures
Embed the new lab_insulation_result, intensity_element_insulation and
flanking_level_difference figures next to their snippets in the EN guide,
the ES mirror and the docs mirror, each with the dual usage/hand-written
code blocks. Add the one-line .plot() mentions for the laboratory
airborne result, the element-normalized intensity result and the
floor-covering improvement result, and a note on when Dn,f plots (the
inline example uses 9 bands, below the 16/5-band rating threshold).
* EN 12354 prediction guide: impact-term and radiated-power figures
Embed the new impact_prediction_terms and radiated_power_outdoor figures
next to their snippets in the EN guide, the ES mirror and the docs
mirror, with the dual usage/hand-written code blocks, and add the
one-line .plot() mentions for the airborne prediction, the impact
prediction, the facade prediction and the radiated-power result.
* Panel insulation guide: rated Sharp prediction figure and plot mentions
Embed the new single_panel_rating figure (the 6 mm glass Sharp prediction
rated per ISO 717-1, coincidence dip marked) in the EN guide, the ES
mirror and the docs mirror with the dual code blocks, and add the
one-line .plot() mentions for the single-panel, double-wall and
radiation-efficiency results next to the existing concept figure.
* Junction transmission guide: Kij design chart, EN 12354 worked example and see-also
Add the junction_kij_thickness figure (wave-approach Kij versus the plate
thickness ratio for the X, T and L junctions, identical-plates value
marked) next to the coupling-loss-factor section, a res.plot() mention
in its snippet, a worked example that feeds the predicted K12 = 9.8 dB
of the 100/200 mm concrete X-junction into the EN 12354-1 flanking model
(R'w = 55.4 dB, direct path dominant), and a See-also section linking
the prediction, laboratory, structure-borne power and mobility guides.
EN guide, ES mirror and docs mirror in sync.
* Junction transmission docs mirror: sync the Kij chart, worked example and see-also
* Structure-borne power and installed-source guides: plot mentions, Hopkins citation and see-also
Add the one-line .plot() mentions for the reception-plate power result
(EN 15657) and the installed-source prediction (EN 12354-5) next to their
existing figures, add the one-line .plot() usage to both figures' code
blocks, cite Hopkins (2007) Section 2.8 for the point-excited-plate power
input behind the clause 4.4.3 coupling term with a prose paragraph
connecting the mobility chain, and give the EN 12354-5 page a proper
See-also linking the EN 15657, ISO 7626, junction and EN 12354 guides.
EN guides, ES mirrors and docs mirrors in sync.
* Vibration FRF guides: plot mentions and transfer-stiffness docs sync
Add the one-line .plot() usage and mentions for the ISO/TS 7849
sound-power-from-vibration result, the EN 29052-1 dynamic-stiffness
result and the ISO 10846 indirect transfer-stiffness result next to
their existing figures (EN guides, ES mirrors and docs mirrors), and
port the previously missing ISO 10846 test-report fiche section to the
transfer-stiffness docs mirror.
* Mechanical mobility guide: driving-point reading figure
Embed the new mobility_result_lines figure (|Y(f)| of the SDOF bundle
with the stiffness line, the mass line and the 1/c damping peak) next to
the MobilityResult snippet in the EN guide, the ES mirror and the docs
mirror, with the dual usage/hand-written code blocks and the one-line
res.plot() mention.
* Human vibration and multiple-shock guides: one-line plot mentions
Add the res.plot() one-liners next to the existing figures for the
ISO 8041-1 weighting response, the ISO 2631-1 weighted band spectrum, the
Directive 2002/44/EC daily exposure A(8) and the ISO 2631-5 multiple-shock
assessment, in the EN guides, the ES mirrors and the docs mirrors.
* Docs mirrors: restore missing report-fiche and concept sections
Sync the docs mirrors of the pages touched by this wave with their site
guides: the ISO 16283-3 facade report subsection on the field insulation
page, the EN 29052-1 and ISO 7626 fiche example snippets, and the panel
concept-figure code block.
* Changelog, API docs and llms regeneration; lint and typing fixes for the figure generators
* Fix nested emphasis in the survey-impact figure captions
* Restore the numerical-propagation rasters truncated by a mid-regeneration snapshot
* Reconcile the figure-script additions with the rooms and materials wave
* docs: regenerate the llms bundle after the figure-script reconciliation
Building and structure-borne guides: result figures, plot mentions and mirror sync (#360)
* Add .plot() to the ISO 717 enlarged-range rating results
ExtendedWeightedRatingResult and ExtendedImpactRatingResult now carry the
full enlarged-range band curve (band_centers, measured) and expose a
.plot() that draws the measured curve over the whole range against the
shifted ISO 717 reference on the 16 core bands, with the unfavourable
deviations shaded, the enlarged-range bands marked and every covered
Annex B / A.2.1 adaptation term in the title. EN/ES labels follow the
existing renderer conventions.
* Field insulation guide: enlarged-range, field-chain, facade and survey-impact figures
Four new deterministic figures (extended_insulation_rating,
field_airborne_insulation, facade_field_insulation,
survey_impact_insulation) generated in the four language/theme variants,
embedded next to their snippets in the EN guide, the ES mirror and the
docs mirror with the dual usage/hand-written code blocks. One-line
.plot() mentions added for the extended rating, the field airborne
result, the survey impact result and the ISO 12999-1 band uncertainty.
The docs mirror gains the previously missing ISO 10052 survey-reports
section, and the survey snippet now defines the li and l1_2m inputs it
uses. Multi-line figure info boxes are translated as whole artists, and
the review fixes (headroom, legend placement, proper unit and Greek
glyphs) are applied to the new generators.
* Laboratory insulation guide: ISO 10140, ISO 15186-1 element and ISO 10848 Dn,f figures
Embed the new lab_insulation_result, intensity_element_insulation and
flanking_level_difference figures next to their snippets in the EN guide,
the ES mirror and the docs mirror, each with the dual usage/hand-written
code blocks. Add the one-line .plot() mentions for the laboratory
airborne result, the element-normalized intensity result and the
floor-covering improvement result, and a note on when Dn,f plots (the
inline example uses 9 bands, below the 16/5-band rating threshold).
* EN 12354 prediction guide: impact-term and radiated-power figures
Embed the new impact_prediction_terms and radiated_power_outdoor figures
next to their snippets in the EN guide, the ES mirror and the docs
mirror, with the dual usage/hand-written code blocks, and add the
one-line .plot() mentions for the airborne prediction, the impact
prediction, the facade prediction and the radiated-power result.
* Panel insulation guide: rated Sharp prediction figure and plot mentions
Embed the new single_panel_rating figure (the 6 mm glass Sharp prediction
rated per ISO 717-1, coincidence dip marked) in the EN guide, the ES
mirror and the docs mirror with the dual code blocks, and add the
one-line .plot() mentions for the single-panel, double-wall and
radiation-efficiency results next to the existing concept figure.
* Junction transmission guide: Kij design chart, EN 12354 worked example and see-also
Add the junction_kij_thickness figure (wave-approach Kij versus the plate
thickness ratio for the X, T and L junctions, identical-plates value
marked) next to the coupling-loss-factor section, a res.plot() mention
in its snippet, a worked example that feeds the predicted K12 = 9.8 dB
of the 100/200 mm concrete X-junction into the EN 12354-1 flanking model
(R'w = 55.4 dB, direct path dominant), and a See-also section linking
the prediction, laboratory, structure-borne power and mobility guides.
EN guide, ES mirror and docs mirror in sync.
* Junction transmission docs mirror: sync the Kij chart, worked example and see-also
* Structure-borne power and installed-source guides: plot mentions, Hopkins citation and see-also
Add the one-line .plot() mentions for the reception-plate power result
(EN 15657) and the installed-source prediction (EN 12354-5) next to their
existing figures, add the one-line .plot() usage to both figures' code
blocks, cite Hopkins (2007) Section 2.8 for the point-excited-plate power
input behind the clause 4.4.3 coupling term with a prose paragraph
connecting the mobility chain, and give the EN 12354-5 page a proper
See-also linking the EN 15657, ISO 7626, junction and EN 12354 guides.
EN guides, ES mirrors and docs mirrors in sync.
* Vibration FRF guides: plot mentions and transfer-stiffness docs sync
Add the one-line .plot() usage and mentions for the ISO/TS 7849
sound-power-from-vibration result, the EN 29052-1 dynamic-stiffness
result and the ISO 10846 indirect transfer-stiffness result next to
their existing figures (EN guides, ES mirrors and docs mirrors), and
port the previously missing ISO 10846 test-report fiche section to the
transfer-stiffness docs mirror.
* Mechanical mobility guide: driving-point reading figure
Embed the new mobility_result_lines figure (|Y(f)| of the SDOF bundle
with the stiffness line, the mass line and the 1/c damping peak) next to
the MobilityResult snippet in the EN guide, the ES mirror and the docs
mirror, with the dual usage/hand-written code blocks and the one-line
res.plot() mention.
* Human vibration and multiple-shock guides: one-line plot mentions
Add the res.plot() one-liners next to the existing figures for the
ISO 8041-1 weighting response, the ISO 2631-1 weighted band spectrum, the
Directive 2002/44/EC daily exposure A(8) and the ISO 2631-5 multiple-shock
assessment, in the EN guides, the ES mirrors and the docs mirrors.
* Docs mirrors: restore missing report-fiche and concept sections
Sync the docs mirrors of the pages touched by this wave with their site
guides: the ISO 16283-3 facade report subsection on the field insulation
page, the EN 29052-1 and ISO 7626 fiche example snippets, and the panel
concept-figure code block.
* Changelog, API docs and llms regeneration; lint and typing fixes for the figure generators
* Fix nested emphasis in the survey-impact figure captions
* Restore the numerical-propagation rasters truncated by a mid-regeneration snapshot
* Reconcile the figure-script additions with the rooms and materials wave
* docs: regenerate the llms bundle after the figure-script reconciliation
Building and structure-borne guides: result figures, plot mentions and mirror sync (#360)
* Add .plot() to the ISO 717 enlarged-range rating results
ExtendedWeightedRatingResult and ExtendedImpactRatingResult now carry the
full enlarged-range band curve (band_centers, measured) and expose a
.plot() that draws the measured curve over the whole range against the
shifted ISO 717 reference on the 16 core bands, with the unfavourable
deviations shaded, the enlarged-range bands marked and every covered
Annex B / A.2.1 adaptation term in the title. EN/ES labels follow the
existing renderer conventions.
* Field insulation guide: enlarged-range, field-chain, facade and survey-impact figures
Four new deterministic figures (extended_insulation_rating,
field_airborne_insulation, facade_field_insulation,
survey_impact_insulation) generated in the four language/theme variants,
embedded next to their snippets in the EN guide, the ES mirror and the
docs mirror with the dual usage/hand-written code blocks. One-line
.plot() mentions added for the extended rating, the field airborne
result, the survey impact result and the ISO 12999-1 band uncertainty.
The docs mirror gains the previously missing ISO 10052 survey-reports
section, and the survey snippet now defines the li and l1_2m inputs it
uses. Multi-line figure info boxes are translated as whole artists, and
the review fixes (headroom, legend placement, proper unit and Greek
glyphs) are applied to the new generators.
* Laboratory insulation guide: ISO 10140, ISO 15186-1 element and ISO 10848 Dn,f figures
Embed the new lab_insulation_result, intensity_element_insulation and
flanking_level_difference figures next to their snippets in the EN guide,
the ES mirror and the docs mirror, each with the dual usage/hand-written
code blocks. Add the one-line .plot() mentions for the laboratory
airborne result, the element-normalized intensity result and the
floor-covering improvement result, and a note on when Dn,f plots (the
inline example uses 9 bands, below the 16/5-band rating threshold).
* EN 12354 prediction guide: impact-term and radiated-power figures
Embed the new impact_prediction_terms and radiated_power_outdoor figures
next to their snippets in the EN guide, the ES mirror and the docs
mirror, with the dual usage/hand-written code blocks, and add the
one-line .plot() mentions for the airborne prediction, the impact
prediction, the facade prediction and the radiated-power result.
* Panel insulation guide: rated Sharp prediction figure and plot mentions
Embed the new single_panel_rating figure (the 6 mm glass Sharp prediction
rated per ISO 717-1, coincidence dip marked) in the EN guide, the ES
mirror and the docs mirror with the dual code blocks, and add the
one-line .plot() mentions for the single-panel, double-wall and
radiation-efficiency results next to the existing concept figure.
* Junction transmission guide: Kij design chart, EN 12354 worked example and see-also
Add the junction_kij_thickness figure (wave-approach Kij versus the plate
thickness ratio for the X, T and L junctions, identical-plates value
marked) next to the coupling-loss-factor section, a res.plot() mention
in its snippet, a worked example that feeds the predicted K12 = 9.8 dB
of the 100/200 mm concrete X-junction into the EN 12354-1 flanking model
(R'w = 55.4 dB, direct path dominant), and a See-also section linking
the prediction, laboratory, structure-borne power and mobility guides.
EN guide, ES mirror and docs mirror in sync.
* Junction transmission docs mirror: sync the Kij chart, worked example and see-also
* Structure-borne power and installed-source guides: plot mentions, Hopkins citation and see-also
Add the one-line .plot() mentions for the reception-plate power result
(EN 15657) and the installed-source prediction (EN 12354-5) next to their
existing figures, add the one-line .plot() usage to both figures' code
blocks, cite Hopkins (2007) Section 2.8 for the point-excited-plate power
input behind the clause 4.4.3 coupling term with a prose paragraph
connecting the mobility chain, and give the EN 12354-5 page a proper
See-also linking the EN 15657, ISO 7626, junction and EN 12354 guides.
EN guides, ES mirrors and docs mirrors in sync.
* Vibration FRF guides: plot mentions and transfer-stiffness docs sync
Add the one-line .plot() usage and mentions for the ISO/TS 7849
sound-power-from-vibration result, the EN 29052-1 dynamic-stiffness
result and the ISO 10846 indirect transfer-stiffness result next to
their existing figures (EN guides, ES mirrors and docs mirrors), and
port the previously missing ISO 10846 test-report fiche section to the
transfer-stiffness docs mirror.
* Mechanical mobility guide: driving-point reading figure
Embed the new mobility_result_lines figure (|Y(f)| of the SDOF bundle
with the stiffness line, the mass line and the 1/c damping peak) next to
the MobilityResult snippet in the EN guide, the ES mirror and the docs
mirror, with the dual usage/hand-written code blocks and the one-line
res.plot() mention.
* Human vibration and multiple-shock guides: one-line plot mentions
Add the res.plot() one-liners next to the existing figures for the
ISO 8041-1 weighting response, the ISO 2631-1 weighted band spectrum, the
Directive 2002/44/EC daily exposure A(8) and the ISO 2631-5 multiple-shock
assessment, in the EN guides, the ES mirrors and the docs mirrors.
* Docs mirrors: restore missing report-fiche and concept sections
Sync the docs mirrors of the pages touched by this wave with their site
guides: the ISO 16283-3 facade report subsection on the field insulation
page, the EN 29052-1 and ISO 7626 fiche example snippets, and the panel
concept-figure code block.
* Changelog, API docs and llms regeneration; lint and typing fixes for the figure generators
* Fix nested emphasis in the survey-impact figure captions
* Restore the numerical-propagation rasters truncated by a mid-regeneration snapshot
* Reconcile the figure-script additions with the rooms and materials wave
* docs: regenerate the llms bundle after the figure-script reconciliation
Building and structure-borne guides: result figures, plot mentions and mirror sync (#360)
* Add .plot() to the ISO 717 enlarged-range rating results
ExtendedWeightedRatingResult and ExtendedImpactRatingResult now carry the
full enlarged-range band curve (band_centers, measured) and expose a
.plot() that draws the measured curve over the whole range against the
shifted ISO 717 reference on the 16 core bands, with the unfavourable
deviations shaded, the enlarged-range bands marked and every covered
Annex B / A.2.1 adaptation term in the title. EN/ES labels follow the
existing renderer conventions.
* Field insulation guide: enlarged-range, field-chain, facade and survey-impact figures
Four new deterministic figures (extended_insulation_rating,
field_airborne_insulation, facade_field_insulation,
survey_impact_insulation) generated in the four language/theme variants,
embedded next to their snippets in the EN guide, the ES mirror and the
docs mirror with the dual usage/hand-written code blocks. One-line
.plot() mentions added for the extended rating, the field airborne
result, the survey impact result and the ISO 12999-1 band uncertainty.
The docs mirror gains the previously missing ISO 10052 survey-reports
section, and the survey snippet now defines the li and l1_2m inputs it
uses. Multi-line figure info boxes are translated as whole artists, and
the review fixes (headroom, legend placement, proper unit and Greek
glyphs) are applied to the new generators.
* Laboratory insulation guide: ISO 10140, ISO 15186-1 element and ISO 10848 Dn,f figures
Embed the new lab_insulation_result, intensity_element_insulation and
flanking_level_difference figures next to their snippets in the EN guide,
the ES mirror and the docs mirror, each with the dual usage/hand-written
code blocks. Add the one-line .plot() mentions for the laboratory
airborne result, the element-normalized intensity result and the
floor-covering improvement result, and a note on when Dn,f plots (the
inline example uses 9 bands, below the 16/5-band rating threshold).
* EN 12354 prediction guide: impact-term and radiated-power figures
Embed the new impact_prediction_terms and radiated_power_outdoor figures
next to their snippets in the EN guide, the ES mirror and the docs
mirror, with the dual usage/hand-written code blocks, and add the
one-line .plot() mentions for the airborne prediction, the impact
prediction, the facade prediction and the radiated-power result.
* Panel insulation guide: rated Sharp prediction figure and plot mentions
Embed the new single_panel_rating figure (the 6 mm glass Sharp prediction
rated per ISO 717-1, coincidence dip marked) in the EN guide, the ES
mirror and the docs mirror with the dual code blocks, and add the
one-line .plot() mentions for the single-panel, double-wall and
radiation-efficiency results next to the existing concept figure.
* Junction transmission guide: Kij design chart, EN 12354 worked example and see-also
Add the junction_kij_thickness figure (wave-approach Kij versus the plate
thickness ratio for the X, T and L junctions, identical-plates value
marked) next to the coupling-loss-factor section, a res.plot() mention
in its snippet, a worked example that feeds the predicted K12 = 9.8 dB
of the 100/200 mm concrete X-junction into the EN 12354-1 flanking model
(R'w = 55.4 dB, direct path dominant), and a See-also section linking
the prediction, laboratory, structure-borne power and mobility guides.
EN guide, ES mirror and docs mirror in sync.
* Junction transmission docs mirror: sync the Kij chart, worked example and see-also
* Structure-borne power and installed-source guides: plot mentions, Hopkins citation and see-also
Add the one-line .plot() mentions for the reception-plate power result
(EN 15657) and the installed-source prediction (EN 12354-5) next to their
existing figures, add the one-line .plot() usage to both figures' code
blocks, cite Hopkins (2007) Section 2.8 for the point-excited-plate power
input behind the clause 4.4.3 coupling term with a prose paragraph
connecting the mobility chain, and give the EN 12354-5 page a proper
See-also linking the EN 15657, ISO 7626, junction and EN 12354 guides.
EN guides, ES mirrors and docs mirrors in sync.
* Vibration FRF guides: plot mentions and transfer-stiffness docs sync
Add the one-line .plot() usage and mentions for the ISO/TS 7849
sound-power-from-vibration result, the EN 29052-1 dynamic-stiffness
result and the ISO 10846 indirect transfer-stiffness result next to
their existing figures (EN guides, ES mirrors and docs mirrors), and
port the previously missing ISO 10846 test-report fiche section to the
transfer-stiffness docs mirror.
* Mechanical mobility guide: driving-point reading figure
Embed the new mobility_result_lines figure (|Y(f)| of the SDOF bundle
with the stiffness line, the mass line and the 1/c damping peak) next to
the MobilityResult snippet in the EN guide, the ES mirror and the docs
mirror, with the dual usage/hand-written code blocks and the one-line
res.plot() mention.
* Human vibration and multiple-shock guides: one-line plot mentions
Add the res.plot() one-liners next to the existing figures for the
ISO 8041-1 weighting response, the ISO 2631-1 weighted band spectrum, the
Directive 2002/44/EC daily exposure A(8) and the ISO 2631-5 multiple-shock
assessment, in the EN guides, the ES mirrors and the docs mirrors.
* Docs mirrors: restore missing report-fiche and concept sections
Sync the docs mirrors of the pages touched by this wave with their site
guides: the ISO 16283-3 facade report subsection on the field insulation
page, the EN 29052-1 and ISO 7626 fiche example snippets, and the panel
concept-figure code block.
* Changelog, API docs and llms regeneration; lint and typing fixes for the figure generators
* Fix nested emphasis in the survey-impact figure captions
* Restore the numerical-propagation rasters truncated by a mid-regeneration snapshot
* Reconcile the figure-script additions with the rooms and materials wave
* docs: regenerate the llms bundle after the figure-script reconciliation
Perception, hearing and speech guides: result figures and when-to-use prose (#361)
* Perception, hearing and speech guides: result figures and when-to-use prose
Add ToneAssessment.plot(), which draws an ECMA-418-1 tone against the
prominence criterion of its own method (recovered from criterion_db) over the
whole range of interest, with the deciding margin marked, and a
view="levels" option on ToneAudibilityResult.plot() that exposes the
level-versus-frequency view the ISO 1996-2 fiche already embedded.
Add eleven single-concept figures to the perception, hearing and speech
guides, each a realistic result drawn by its own .plot(): the tone prominence
verdict, the ISO/PAS 20065 tone levels, the ISO/PAS 1996-3 onset detection,
the ISO 532-2 specific loudness, the ECMA-418-2 specific tonality, the
specific fluctuation strength, the SII band audibility under a hearing loss,
the ISO 7029 fractile band, the ISO 1999 NIPTS audiogram, the STOI per-band
correlation and the IEC 60268-16 per-band MTI. Every figure is embedded in
the English guide, the Spanish mirror and the docs mirror with the dual
snippet block, and every plottable snippet on those pages now names its
.plot().
Prose: the tone-prominence guide gains a comparison of the four tonality
assessments the library implements and when each applies, the
hearing-threshold guide explains how the ISO 7029 fractiles feed the ISO 1999
age component and gains a See-also section, and the objective-intelligibility
guide gains the "which measure, and when" section that existed only in the
docs mirror, extended with the STOI/ESTOI, STI and SII choice.
Also label the STOI band axis at whole-hertz resolution and let the shaded
critical band of the tone-audibility levels plot follow the figure
background, so it reads on the white report page and on dark figures alike.
* Correct two figure alt texts against the plotted values
The ISO 7029 fractile figure describes the median and the 90 % fractile with
the values it actually draws (10 to 50 dB and 22 to 74 dB), and the
ECMA-418-2 specific tonality peak is at 9 Bark_HMS.
Perception, hearing and speech guides: result figures and when-to-use prose (#361)
* Perception, hearing and speech guides: result figures and when-to-use prose
Add ToneAssessment.plot(), which draws an ECMA-418-1 tone against the
prominence criterion of its own method (recovered from criterion_db) over the
whole range of interest, with the deciding margin marked, and a
view="levels" option on ToneAudibilityResult.plot() that exposes the
level-versus-frequency view the ISO 1996-2 fiche already embedded.
Add eleven single-concept figures to the perception, hearing and speech
guides, each a realistic result drawn by its own .plot(): the tone prominence
verdict, the ISO/PAS 20065 tone levels, the ISO/PAS 1996-3 onset detection,
the ISO 532-2 specific loudness, the ECMA-418-2 specific tonality, the
specific fluctuation strength, the SII band audibility under a hearing loss,
the ISO 7029 fractile band, the ISO 1999 NIPTS audiogram, the STOI per-band
correlation and the IEC 60268-16 per-band MTI. Every figure is embedded in
the English guide, the Spanish mirror and the docs mirror with the dual
snippet block, and every plottable snippet on those pages now names its
.plot().
Prose: the tone-prominence guide gains a comparison of the four tonality
assessments the library implements and when each applies, the
hearing-threshold guide explains how the ISO 7029 fractiles feed the ISO 1999
age component and gains a See-also section, and the objective-intelligibility
guide gains the "which measure, and when" section that existed only in the
docs mirror, extended with the STOI/ESTOI, STI and SII choice.
Also label the STOI band axis at whole-hertz resolution and let the shaded
critical band of the tone-audibility levels plot follow the figure
background, so it reads on the white report page and on dark figures alike.
* Correct two figure alt texts against the plotted values
The ISO 7029 fractile figure describes the median and the 90 % fractile with
the values it actually draws (10 to 50 dB and 22 to 74 dB), and the
ECMA-418-2 specific tonality peak is at 9 Bark_HMS.
Perception, hearing and speech guides: result figures and when-to-use prose (#361)
* Perception, hearing and speech guides: result figures and when-to-use prose
Add ToneAssessment.plot(), which draws an ECMA-418-1 tone against the
prominence criterion of its own method (recovered from criterion_db) over the
whole range of interest, with the deciding margin marked, and a
view="levels" option on ToneAudibilityResult.plot() that exposes the
level-versus-frequency view the ISO 1996-2 fiche already embedded.
Add eleven single-concept figures to the perception, hearing and speech
guides, each a realistic result drawn by its own .plot(): the tone prominence
verdict, the ISO/PAS 20065 tone levels, the ISO/PAS 1996-3 onset detection,
the ISO 532-2 specific loudness, the ECMA-418-2 specific tonality, the
specific fluctuation strength, the SII band audibility under a hearing loss,
the ISO 7029 fractile band, the ISO 1999 NIPTS audiogram, the STOI per-band
correlation and the IEC 60268-16 per-band MTI. Every figure is embedded in
the English guide, the Spanish mirror and the docs mirror with the dual
snippet block, and every plottable snippet on those pages now names its
.plot().
Prose: the tone-prominence guide gains a comparison of the four tonality
assessments the library implements and when each applies, the
hearing-threshold guide explains how the ISO 7029 fractiles feed the ISO 1999
age component and gains a See-also section, and the objective-intelligibility
guide gains the "which measure, and when" section that existed only in the
docs mirror, extended with the STOI/ESTOI, STI and SII choice.
Also label the STOI band axis at whole-hertz resolution and let the shaded
critical band of the tone-audibility levels plot follow the figure
background, so it reads on the white report page and on dark figures alike.
* Correct two figure alt texts against the plotted values
The ISO 7029 fractile figure describes the median and the 90 % fractile with
the values it actually draws (10 to 50 dB and 22 to 74 dB), and the
ECMA-418-2 specific tonality peak is at 9 Bark_HMS.
Perception, hearing and speech guides: result figures and when-to-use prose (#361)
* Perception, hearing and speech guides: result figures and when-to-use prose
Add ToneAssessment.plot(), which draws an ECMA-418-1 tone against the
prominence criterion of its own method (recovered from criterion_db) over the
whole range of interest, with the deciding margin marked, and a
view="levels" option on ToneAudibilityResult.plot() that exposes the
level-versus-frequency view the ISO 1996-2 fiche already embedded.
Add eleven single-concept figures to the perception, hearing and speech
guides, each a realistic result drawn by its own .plot(): the tone prominence
verdict, the ISO/PAS 20065 tone levels, the ISO/PAS 1996-3 onset detection,
the ISO 532-2 specific loudness, the ECMA-418-2 specific tonality, the
specific fluctuation strength, the SII band audibility under a hearing loss,
the ISO 7029 fractile band, the ISO 1999 NIPTS audiogram, the STOI per-band
correlation and the IEC 60268-16 per-band MTI. Every figure is embedded in
the English guide, the Spanish mirror and the docs mirror with the dual
snippet block, and every plottable snippet on those pages now names its
.plot().
Prose: the tone-prominence guide gains a comparison of the four tonality
assessments the library implements and when each applies, the
hearing-threshold guide explains how the ISO 7029 fractiles feed the ISO 1999
age component and gains a See-also section, and the objective-intelligibility
guide gains the "which measure, and when" section that existed only in the
docs mirror, extended with the STOI/ESTOI, STI and SII choice.
Also label the STOI band axis at whole-hertz resolution and let the shaded
critical band of the tone-audibility levels plot follow the figure
background, so it reads on the white report page and on dark figures alike.
* Correct two figure alt texts against the plotted values
The ISO 7029 fractile figure describes the median and the 90 % fractile with
the values it actually draws (10 to 50 dB and 22 to 74 dB), and the
ECMA-418-2 specific tonality peak is at 9 Bark_HMS.
Perception, hearing and speech guides: result figures and when-to-use prose (#361)
* Perception, hearing and speech guides: result figures and when-to-use prose
Add ToneAssessment.plot(), which draws an ECMA-418-1 tone against the
prominence criterion of its own method (recovered from criterion_db) over the
whole range of interest, with the deciding margin marked, and a
view="levels" option on ToneAudibilityResult.plot() that exposes the
level-versus-frequency view the ISO 1996-2 fiche already embedded.
Add eleven single-concept figures to the perception, hearing and speech
guides, each a realistic result drawn by its own .plot(): the tone prominence
verdict, the ISO/PAS 20065 tone levels, the ISO/PAS 1996-3 onset detection,
the ISO 532-2 specific loudness, the ECMA-418-2 specific tonality, the
specific fluctuation strength, the SII band audibility under a hearing loss,
the ISO 7029 fractile band, the ISO 1999 NIPTS audiogram, the STOI per-band
correlation and the IEC 60268-16 per-band MTI. Every figure is embedded in
the English guide, the Spanish mirror and the docs mirror with the dual
snippet block, and every plottable snippet on those pages now names its
.plot().
Prose: the tone-prominence guide gains a comparison of the four tonality
assessments the library implements and when each applies, the
hearing-threshold guide explains how the ISO 7029 fractiles feed the ISO 1999
age component and gains a See-also section, and the objective-intelligibility
guide gains the "which measure, and when" section that existed only in the
docs mirror, extended with the STOI/ESTOI, STI and SII choice.
Also label the STOI band axis at whole-hertz resolution and let the shaded
critical band of the tone-audibility levels plot follow the figure
background, so it reads on the white report page and on dark figures alike.
* Correct two figure alt texts against the plotted values
The ISO 7029 fractile figure describes the median and the 90 % fractile with
the values it actually draws (10 to 50 dB and 22 to 74 dB), and the
ECMA-418-2 specific tonality peak is at 9 Bark_HMS.
Perception, hearing and speech guides: result figures and when-to-use prose (#361)
* Perception, hearing and speech guides: result figures and when-to-use prose
Add ToneAssessment.plot(), which draws an ECMA-418-1 tone against the
prominence criterion of its own method (recovered from criterion_db) over the
whole range of interest, with the deciding margin marked, and a
view="levels" option on ToneAudibilityResult.plot() that exposes the
level-versus-frequency view the ISO 1996-2 fiche already embedded.
Add eleven single-concept figures to the perception, hearing and speech
guides, each a realistic result drawn by its own .plot(): the tone prominence
verdict, the ISO/PAS 20065 tone levels, the ISO/PAS 1996-3 onset detection,
the ISO 532-2 specific loudness, the ECMA-418-2 specific tonality, the
specific fluctuation strength, the SII band audibility under a hearing loss,
the ISO 7029 fractile band, the ISO 1999 NIPTS audiogram, the STOI per-band
correlation and the IEC 60268-16 per-band MTI. Every figure is embedded in
the English guide, the Spanish mirror and the docs mirror with the dual
snippet block, and every plottable snippet on those pages now names its
.plot().
Prose: the tone-prominence guide gains a comparison of the four tonality
assessments the library implements and when each applies, the
hearing-threshold guide explains how the ISO 7029 fractiles feed the ISO 1999
age component and gains a See-also section, and the objective-intelligibility
guide gains the "which measure, and when" section that existed only in the
docs mirror, extended with the STOI/ESTOI, STI and SII choice.
Also label the STOI band axis at whole-hertz resolution and let the shaded
critical band of the tone-audibility levels plot follow the figure
background, so it reads on the white report page and on dark figures alike.
* Correct two figure alt texts against the plotted values
The ISO 7029 fractile figure describes the median and the 90 % fractile with
the values it actually draws (10 to 50 dB and 22 to 74 dB), and the
ECMA-418-2 specific tonality peak is at 9 Bark_HMS.
Perception, hearing and speech guides: result figures and when-to-use prose (#361)
* Perception, hearing and speech guides: result figures and when-to-use prose
Add ToneAssessment.plot(), which draws an ECMA-418-1 tone against the
prominence criterion of its own method (recovered from criterion_db) over the
whole range of interest, with the deciding margin marked, and a
view="levels" option on ToneAudibilityResult.plot() that exposes the
level-versus-frequency view the ISO 1996-2 fiche already embedded.
Add eleven single-concept figures to the perception, hearing and speech
guides, each a realistic result drawn by its own .plot(): the tone prominence
verdict, the ISO/PAS 20065 tone levels, the ISO/PAS 1996-3 onset detection,
the ISO 532-2 specific loudness, the ECMA-418-2 specific tonality, the
specific fluctuation strength, the SII band audibility under a hearing loss,
the ISO 7029 fractile band, the ISO 1999 NIPTS audiogram, the STOI per-band
correlation and the IEC 60268-16 per-band MTI. Every figure is embedded in
the English guide, the Spanish mirror and the docs mirror with the dual
snippet block, and every plottable snippet on those pages now names its
.plot().
Prose: the tone-prominence guide gains a comparison of the four tonality
assessments the library implements and when each applies, the
hearing-threshold guide explains how the ISO 7029 fractiles feed the ISO 1999
age component and gains a See-also section, and the objective-intelligibility
guide gains the "which measure, and when" section that existed only in the
docs mirror, extended with the STOI/ESTOI, STI and SII choice.
Also label the STOI band axis at whole-hertz resolution and let the shaded
critical band of the tone-audibility levels plot follow the figure
background, so it reads on the white report page and on dark figures alike.
* Correct two figure alt texts against the plotted values
The ISO 7029 fractile figure describes the median and the 90 % fractile with
the values it actually draws (10 to 50 dB and 22 to 74 dB), and the
ECMA-418-2 specific tonality peak is at 9 Bark_HMS.
Perception, hearing and speech guides: result figures and when-to-use prose (#361)
* Perception, hearing and speech guides: result figures and when-to-use prose
Add ToneAssessment.plot(), which draws an ECMA-418-1 tone against the
prominence criterion of its own method (recovered from criterion_db) over the
whole range of interest, with the deciding margin marked, and a
view="levels" option on ToneAudibilityResult.plot() that exposes the
level-versus-frequency view the ISO 1996-2 fiche already embedded.
Add eleven single-concept figures to the perception, hearing and speech
guides, each a realistic result drawn by its own .plot(): the tone prominence
verdict, the ISO/PAS 20065 tone levels, the ISO/PAS 1996-3 onset detection,
the ISO 532-2 specific loudness, the ECMA-418-2 specific tonality, the
specific fluctuation strength, the SII band audibility under a hearing loss,
the ISO 7029 fractile band, the ISO 1999 NIPTS audiogram, the STOI per-band
correlation and the IEC 60268-16 per-band MTI. Every figure is embedded in
the English guide, the Spanish mirror and the docs mirror with the dual
snippet block, and every plottable snippet on those pages now names its
.plot().
Prose: the tone-prominence guide gains a comparison of the four tonality
assessments the library implements and when each applies, the
hearing-threshold guide explains how the ISO 7029 fractiles feed the ISO 1999
age component and gains a See-also section, and the objective-intelligibility
guide gains the "which measure, and when" section that existed only in the
docs mirror, extended with the STOI/ESTOI, STI and SII choice.
Also label the STOI band axis at whole-hertz resolution and let the shaded
critical band of the tone-audibility levels plot follow the figure
background, so it reads on the white report page and on dark figures alike.
* Correct two figure alt texts against the plotted values
The ISO 7029 fractile figure describes the median and the 90 % fractile with
the values it actually draws (10 to 50 dB and 22 to 74 dB), and the
ECMA-418-2 specific tonality peak is at 9 Bark_HMS.
Spanish docs: UNE terminology, decimal commas, localized snippets and theory figures (#365)
* Normalize Spanish docs prose to UNE acoustic terminology
Sweep the Spanish pages for the non-UNE forms "presion sonora",
"potencia sonora" and "intensidad sonora" and normalize the prose to
the wording used by the official Spanish editions of the standards:
"presion acustica" (UNE-EN ISO 16283-2:2016, UNE-EN ISO 10052:2005,
UNE-EN ISO 3746:2011, UNE-ISO 226:2013), "potencia acustica"
(UNE-EN ISO 3746:2011, UNE-EN ISO 4871:2010, UNE-EN ISO 9614-1:2010),
"intensidad acustica" (UNE-EN 61043:1999, UNE-EN ISO 9614-1:2010) and
"nivel de presion acustica de impactos" (UNE-EN ISO 12354-2:2018,
UNE-EN ISO 717-2:2013). 92 replacements across 32 pages, prose only:
code snippets keep the labels they share with the generated figures.
Rename the intensity guide to "Intensidad acustica (p-p)" and the
structure-borne power guide to "Potencia acustica estructural de
equipos (EN 15657)", updating every cross-link text and the theory
anchor intensidad-sonora-iec-61043 accordingly. The API sidebar group
label becomes "Potencia acustica e intensidad" via api_taxonomy.py
with the generated sidebar regenerated.
* Use decimal commas in Spanish docs prose quantities
Sweep every Spanish page for decimal points leaking into prose numbers
and switch them to the comma the locale convention calls for: the
rotorcraft validation prose (fourteen tolerances such as 0,08 dB(A) and
0,5 s), the insulation-prediction worked example (53,6 dB / 53,8 dB),
the tone-audibility Annex E tone (137,3 Hz), the Mackenzie check value
(1550,744 m/s), the EPNL, loudness and absorption fiche descriptions
(98,3 EPNdB; 8,2 sonos and 70,4 fonios; 0,60 y 0,55), the junction
constants table and the third-octave band-edge table in the signal
analysis theory page. Code snippets, inline code, math, clause numbers
and quoted source text keep their points.
* Pass language="es" in Spanish figure-reproduction snippets
The <details> blocks under each localized figure in the Spanish guides
are meant to reproduce the _es variant shown on the page, but 82 of the
one-line result .plot() calls omitted the language="es" argument and
would render English axis labels instead. Add the argument across 33
guides, matching the pattern the intensity field-indicators snippet
already used. The three lab-insulation results whose plot() does not
take a language argument (lab airborne, lab impact and the
element-normalized intensity difference) are left as they were.
* Extend the UNE terminology sweep to sound absorption
Normalize "absorción sonora" to "absorción acústica" across the
Spanish pages (36 occurrences in 14 pages, including the EN 12354-6
guide title and the theory headings), the wording of UNE-EN ISO
3746:2011 and of the equivalent absorption area in UNE-EN ISO
10140-3:2011, UNE-EN ISO 12354-2:2018 and UNE-EN ISO 16283-2:2016, and
the same term the accredited report strings already use. Also restore
the accent in the theory index anchor to the renamed intensity heading,
since heading slugs keep accented characters.
* Theory pages: illustrate each section family with existing result figures
The seven theory pages carried no figures at all. Embed sixteen of the
existing generated figures (light and dark variants, Spanish variants on
the Spanish mirrors) where the concept matches the prose: weighting
curves, time integration and the p-p intensity estimator in the signal
analysis page; equal-loudness contours, the specific-loudness pattern
and the hearing-threshold panels in perception; NC/RC rating, the
Schroeder decay and the ISO 717-1 shifted reference in rooms and
buildings; the Lden profile, ISO 9613-1 absorption and the three sound
power routes in environment and transport; the scattering coefficient
and ISO 11654 rating in materials and surfaces; and the Wk weighting and
the resonator mobility triplet in vibration. Each embed reuses the alt
text of the guide that owns the figure and adds a one-line caption.
Also give the wave-simulation section hub the reading-order paragraph
its siblings already have, linking the closed-form pages the FDTD solver
cross-checks, in both languages.
* Address review findings from the Spanish locale sweeps
Second pass fixes flagged by review: five terminology occurrences the
line-based sweep missed because the noun and adjective were split by a
line wrap or emphasis markup (sound-power, rotorcraft-noise and two
section hubs); six Spanish pages that still embedded the English figure
variant although the _es variant exists (junction-transmission,
aircraft-noise airport contour, miso-coherence,
objective-intelligibility, psychoacoustic-annoyance twice); and 19 more
language="es" arguments on figure-reproduction plot calls the first
pass missed, chained-call receivers such as room.noise_criterion(spl)
.plot() and the axes-creating first call of the two-profile
atmospheric-refraction snippet among them. The lab-insulation plot
wrappers forward keyword arguments to the rating plot, so the three
calls excluded earlier now take the argument too. All Spanish python
fences re-checked to compile and EN/ES parity re-verified.
* Carry the UNE terminology into the generated-asset Spanish strings
Apply the same evidence-based decisions to every Spanish string source
that feeds generated assets: the translation tables of
generate_graphs.py and generate_diagrams.py, the _STRINGS tables of the
plot modules and the report i18n values. 35 strings change: "presión
acústica" (UNE-EN ISO 16283-2:2016, 10052:2005, 3746:2011),
"potencia acústica" (UNE-EN ISO 3746:2011, 4871:2010, 9614-1:2010),
"intensidad acústica" (UNE-EN 61043:1999, 9614-1:2010), "absorción
acústica" (UNE-EN ISO 3746:2011) and "nivel de presión acústica de
impactos" (UNE-EN ISO 12354-2:2018). Strings the UNE editions keep are
untouched: "emisión sonora", "exposición sonora", "campo sonoro",
"fuente sonora". Only Spanish values change; the English keys stay.
The two plot-i18n test assertions that pin the axis label follow, and
the eight Spanish doc fences that deliberately mirrored the old figure
labels now mirror the new ones.
* Regenerate the Spanish figure variants with the UNE terminology
make graphs after the string-source change: 48 files, all of them _es
or _es_dark variants (24 figure/diagram pairs), picking up "presión
acústica", "potencia acústica", "intensidad acústica", "absorción
acústica" and "nivel de presión acústica de impactos" in titles and
axis labels. The English variants are untouched. The committed example
fiches need no regeneration: every example in generate_reports.py
renders in English, so no changed Spanish report string reaches them.
* Align the intensity-fiche Spanish assertions with the UNE terminology
Spanish docs: UNE terminology, decimal commas, localized snippets and theory figures (#365)
* Normalize Spanish docs prose to UNE acoustic terminology
Sweep the Spanish pages for the non-UNE forms "presion sonora",
"potencia sonora" and "intensidad sonora" and normalize the prose to
the wording used by the official Spanish editions of the standards:
"presion acustica" (UNE-EN ISO 16283-2:2016, UNE-EN ISO 10052:2005,
UNE-EN ISO 3746:2011, UNE-ISO 226:2013), "potencia acustica"
(UNE-EN ISO 3746:2011, UNE-EN ISO 4871:2010, UNE-EN ISO 9614-1:2010),
"intensidad acustica" (UNE-EN 61043:1999, UNE-EN ISO 9614-1:2010) and
"nivel de presion acustica de impactos" (UNE-EN ISO 12354-2:2018,
UNE-EN ISO 717-2:2013). 92 replacements across 32 pages, prose only:
code snippets keep the labels they share with the generated figures.
Rename the intensity guide to "Intensidad acustica (p-p)" and the
structure-borne power guide to "Potencia acustica estructural de
equipos (EN 15657)", updating every cross-link text and the theory
anchor intensidad-sonora-iec-61043 accordingly. The API sidebar group
label becomes "Potencia acustica e intensidad" via api_taxonomy.py
with the generated sidebar regenerated.
* Use decimal commas in Spanish docs prose quantities
Sweep every Spanish page for decimal points leaking into prose numbers
and switch them to the comma the locale convention calls for: the
rotorcraft validation prose (fourteen tolerances such as 0,08 dB(A) and
0,5 s), the insulation-prediction worked example (53,6 dB / 53,8 dB),
the tone-audibility Annex E tone (137,3 Hz), the Mackenzie check value
(1550,744 m/s), the EPNL, loudness and absorption fiche descriptions
(98,3 EPNdB; 8,2 sonos and 70,4 fonios; 0,60 y 0,55), the junction
constants table and the third-octave band-edge table in the signal
analysis theory page. Code snippets, inline code, math, clause numbers
and quoted source text keep their points.
* Pass language="es" in Spanish figure-reproduction snippets
The <details> blocks under each localized figure in the Spanish guides
are meant to reproduce the _es variant shown on the page, but 82 of the
one-line result .plot() calls omitted the language="es" argument and
would render English axis labels instead. Add the argument across 33
guides, matching the pattern the intensity field-indicators snippet
already used. The three lab-insulation results whose plot() does not
take a language argument (lab airborne, lab impact and the
element-normalized intensity difference) are left as they were.
* Extend the UNE terminology sweep to sound absorption
Normalize "absorción sonora" to "absorción acústica" across the
Spanish pages (36 occurrences in 14 pages, including the EN 12354-6
guide title and the theory headings), the wording of UNE-EN ISO
3746:2011 and of the equivalent absorption area in UNE-EN ISO
10140-3:2011, UNE-EN ISO 12354-2:2018 and UNE-EN ISO 16283-2:2016, and
the same term the accredited report strings already use. Also restore
the accent in the theory index anchor to the renamed intensity heading,
since heading slugs keep accented characters.
* Theory pages: illustrate each section family with existing result figures
The seven theory pages carried no figures at all. Embed sixteen of the
existing generated figures (light and dark variants, Spanish variants on
the Spanish mirrors) where the concept matches the prose: weighting
curves, time integration and the p-p intensity estimator in the signal
analysis page; equal-loudness contours, the specific-loudness pattern
and the hearing-threshold panels in perception; NC/RC rating, the
Schroeder decay and the ISO 717-1 shifted reference in rooms and
buildings; the Lden profile, ISO 9613-1 absorption and the three sound
power routes in environment and transport; the scattering coefficient
and ISO 11654 rating in materials and surfaces; and the Wk weighting and
the resonator mobility triplet in vibration. Each embed reuses the alt
text of the guide that owns the figure and adds a one-line caption.
Also give the wave-simulation section hub the reading-order paragraph
its siblings already have, linking the closed-form pages the FDTD solver
cross-checks, in both languages.
* Address review findings from the Spanish locale sweeps
Second pass fixes flagged by review: five terminology occurrences the
line-based sweep missed because the noun and adjective were split by a
line wrap or emphasis markup (sound-power, rotorcraft-noise and two
section hubs); six Spanish pages that still embedded the English figure
variant although the _es variant exists (junction-transmission,
aircraft-noise airport contour, miso-coherence,
objective-intelligibility, psychoacoustic-annoyance twice); and 19 more
language="es" arguments on figure-reproduction plot calls the first
pass missed, chained-call receivers such as room.noise_criterion(spl)
.plot() and the axes-creating first call of the two-profile
atmospheric-refraction snippet among them. The lab-insulation plot
wrappers forward keyword arguments to the rating plot, so the three
calls excluded earlier now take the argument too. All Spanish python
fences re-checked to compile and EN/ES parity re-verified.
* Carry the UNE terminology into the generated-asset Spanish strings
Apply the same evidence-based decisions to every Spanish string source
that feeds generated assets: the translation tables of
generate_graphs.py and generate_diagrams.py, the _STRINGS tables of the
plot modules and the report i18n values. 35 strings change: "presión
acústica" (UNE-EN ISO 16283-2:2016, 10052:2005, 3746:2011),
"potencia acústica" (UNE-EN ISO 3746:2011, 4871:2010, 9614-1:2010),
"intensidad acústica" (UNE-EN 61043:1999, 9614-1:2010), "absorción
acústica" (UNE-EN ISO 3746:2011) and "nivel de presión acústica de
impactos" (UNE-EN ISO 12354-2:2018). Strings the UNE editions keep are
untouched: "emisión sonora", "exposición sonora", "campo sonoro",
"fuente sonora". Only Spanish values change; the English keys stay.
The two plot-i18n test assertions that pin the axis label follow, and
the eight Spanish doc fences that deliberately mirrored the old figure
labels now mirror the new ones.
* Regenerate the Spanish figure variants with the UNE terminology
make graphs after the string-source change: 48 files, all of them _es
or _es_dark variants (24 figure/diagram pairs), picking up "presión
acústica", "potencia acústica", "intensidad acústica", "absorción
acústica" and "nivel de presión acústica de impactos" in titles and
axis labels. The English variants are untouched. The committed example
fiches need no regeneration: every example in generate_reports.py
renders in English, so no changed Spanish report string reaches them.
* Align the intensity-fiche Spanish assertions with the UNE terminology
Building and structure-borne guides: result figures, plot mentions and mirror sync (#360)
* Add .plot() to the ISO 717 enlarged-range rating results
ExtendedWeightedRatingResult and ExtendedImpactRatingResult now carry the
full enlarged-range band curve (band_centers, measured) and expose a
.plot() that draws the measured curve over the whole range against the
shifted ISO 717 reference on the 16 core bands, with the unfavourable
deviations shaded, the enlarged-range bands marked and every covered
Annex B / A.2.1 adaptation term in the title. EN/ES labels follow the
existing renderer conventions.
* Field insulation guide: enlarged-range, field-chain, facade and survey-impact figures
Four new deterministic figures (extended_insulation_rating,
field_airborne_insulation, facade_field_insulation,
survey_impact_insulation) generated in the four language/theme variants,
embedded next to their snippets in the EN guide, the ES mirror and the
docs mirror with the dual usage/hand-written code blocks. One-line
.plot() mentions added for the extended rating, the field airborne
result, the survey impact result and the ISO 12999-1 band uncertainty.
The docs mirror gains the previously missing ISO 10052 survey-reports
section, and the survey snippet now defines the li and l1_2m inputs it
uses. Multi-line figure info boxes are translated as whole artists, and
the review fixes (headroom, legend placement, proper unit and Greek
glyphs) are applied to the new generators.
* Laboratory insulation guide: ISO 10140, ISO 15186-1 element and ISO 10848 Dn,f figures
Embed the new lab_insulation_result, intensity_element_insulation and
flanking_level_difference figures next to their snippets in the EN guide,
the ES mirror and the docs mirror, each with the dual usage/hand-written
code blocks. Add the one-line .plot() mentions for the laboratory
airborne result, the element-normalized intensity result and the
floor-covering improvement result, and a note on when Dn,f plots (the
inline example uses 9 bands, below the 16/5-band rating threshold).
* EN 12354 prediction guide: impact-term and radiated-power figures
Embed the new impact_prediction_terms and radiated_power_outdoor figures
next to their snippets in the EN guide, the ES mirror and the docs
mirror, with the dual usage/hand-written code blocks, and add the
one-line .plot() mentions for the airborne prediction, the impact
prediction, the facade prediction and the radiated-power result.
* Panel insulation guide: rated Sharp prediction figure and plot mentions
Embed the new single_panel_rating figure (the 6 mm glass Sharp prediction
rated per ISO 717-1, coincidence dip marked) in the EN guide, the ES
mirror and the docs mirror with the dual code blocks, and add the
one-line .plot() mentions for the single-panel, double-wall and
radiation-efficiency results next to the existing concept figure.
* Junction transmission guide: Kij design chart, EN 12354 worked example and see-also
Add the junction_kij_thickness figure (wave-approach Kij versus the plate
thickness ratio for the X, T and L junctions, identical-plates value
marked) next to the coupling-loss-factor section, a res.plot() mention
in its snippet, a worked example that feeds the predicted K12 = 9.8 dB
of the 100/200 mm concrete X-junction into the EN 12354-1 flanking model
(R'w = 55.4 dB, direct path dominant), and a See-also section linking
the prediction, laboratory, structure-borne power and mobility guides.
EN guide, ES mirror and docs mirror in sync.
* Junction transmission docs mirror: sync the Kij chart, worked example and see-also
* Structure-borne power and installed-source guides: plot mentions, Hopkins citation and see-also
Add the one-line .plot() mentions for the reception-plate power result
(EN 15657) and the installed-source prediction (EN 12354-5) next to their
existing figures, add the one-line .plot() usage to both figures' code
blocks, cite Hopkins (2007) Section 2.8 for the point-excited-plate power
input behind the clause 4.4.3 coupling term with a prose paragraph
connecting the mobility chain, and give the EN 12354-5 page a proper
See-also linking the EN 15657, ISO 7626, junction and EN 12354 guides.
EN guides, ES mirrors and docs mirrors in sync.
* Vibration FRF guides: plot mentions and transfer-stiffness docs sync
Add the one-line .plot() usage and mentions for the ISO/TS 7849
sound-power-from-vibration result, the EN 29052-1 dynamic-stiffness
result and the ISO 10846 indirect transfer-stiffness result next to
their existing figures (EN guides, ES mirrors and docs mirrors), and
port the previously missing ISO 10846 test-report fiche section to the
transfer-stiffness docs mirror.
* Mechanical mobility guide: driving-point reading figure
Embed the new mobility_result_lines figure (|Y(f)| of the SDOF bundle
with the stiffness line, the mass line and the 1/c damping peak) next to
the MobilityResult snippet in the EN guide, the ES mirror and the docs
mirror, with the dual usage/hand-written code blocks and the one-line
res.plot() mention.
* Human vibration and multiple-shock guides: one-line plot mentions
Add the res.plot() one-liners next to the existing figures for the
ISO 8041-1 weighting response, the ISO 2631-1 weighted band spectrum, the
Directive 2002/44/EC daily exposure A(8) and the ISO 2631-5 multiple-shock
assessment, in the EN guides, the ES mirrors and the docs mirrors.
* Docs mirrors: restore missing report-fiche and concept sections
Sync the docs mirrors of the pages touched by this wave with their site
guides: the ISO 16283-3 facade report subsection on the field insulation
page, the EN 29052-1 and ISO 7626 fiche example snippets, and the panel
concept-figure code block.
* Changelog, API docs and llms regeneration; lint and typing fixes for the figure generators
* Fix nested emphasis in the survey-impact figure captions
* Restore the numerical-propagation rasters truncated by a mid-regeneration snapshot
* Reconcile the figure-script additions with the rooms and materials wave
* docs: regenerate the llms bundle after the figure-script reconciliation
Building and structure-borne guides: result figures, plot mentions and mirror sync (#360)
* Add .plot() to the ISO 717 enlarged-range rating results
ExtendedWeightedRatingResult and ExtendedImpactRatingResult now carry the
full enlarged-range band curve (band_centers, measured) and expose a
.plot() that draws the measured curve over the whole range against the
shifted ISO 717 reference on the 16 core bands, with the unfavourable
deviations shaded, the enlarged-range bands marked and every covered
Annex B / A.2.1 adaptation term in the title. EN/ES labels follow the
existing renderer conventions.
* Field insulation guide: enlarged-range, field-chain, facade and survey-impact figures
Four new deterministic figures (extended_insulation_rating,
field_airborne_insulation, facade_field_insulation,
survey_impact_insulation) generated in the four language/theme variants,
embedded next to their snippets in the EN guide, the ES mirror and the
docs mirror with the dual usage/hand-written code blocks. One-line
.plot() mentions added for the extended rating, the field airborne
result, the survey impact result and the ISO 12999-1 band uncertainty.
The docs mirror gains the previously missing ISO 10052 survey-reports
section, and the survey snippet now defines the li and l1_2m inputs it
uses. Multi-line figure info boxes are translated as whole artists, and
the review fixes (headroom, legend placement, proper unit and Greek
glyphs) are applied to the new generators.
* Laboratory insulation guide: ISO 10140, ISO 15186-1 element and ISO 10848 Dn,f figures
Embed the new lab_insulation_result, intensity_element_insulation and
flanking_level_difference figures next to their snippets in the EN guide,
the ES mirror and the docs mirror, each with the dual usage/hand-written
code blocks. Add the one-line .plot() mentions for the laboratory
airborne result, the element-normalized intensity result and the
floor-covering improvement result, and a note on when Dn,f plots (the
inline example uses 9 bands, below the 16/5-band rating threshold).
* EN 12354 prediction guide: impact-term and radiated-power figures
Embed the new impact_prediction_terms and radiated_power_outdoor figures
next to their snippets in the EN guide, the ES mirror and the docs
mirror, with the dual usage/hand-written code blocks, and add the
one-line .plot() mentions for the airborne prediction, the impact
prediction, the facade prediction and the radiated-power result.
* Panel insulation guide: rated Sharp prediction figure and plot mentions
Embed the new single_panel_rating figure (the 6 mm glass Sharp prediction
rated per ISO 717-1, coincidence dip marked) in the EN guide, the ES
mirror and the docs mirror with the dual code blocks, and add the
one-line .plot() mentions for the single-panel, double-wall and
radiation-efficiency results next to the existing concept figure.
* Junction transmission guide: Kij design chart, EN 12354 worked example and see-also
Add the junction_kij_thickness figure (wave-approach Kij versus the plate
thickness ratio for the X, T and L junctions, identical-plates value
marked) next to the coupling-loss-factor section, a res.plot() mention
in its snippet, a worked example that feeds the predicted K12 = 9.8 dB
of the 100/200 mm concrete X-junction into the EN 12354-1 flanking model
(R'w = 55.4 dB, direct path dominant), and a See-also section linking
the prediction, laboratory, structure-borne power and mobility guides.
EN guide, ES mirror and docs mirror in sync.
* Junction transmission docs mirror: sync the Kij chart, worked example and see-also
* Structure-borne power and installed-source guides: plot mentions, Hopkins citation and see-also
Add the one-line .plot() mentions for the reception-plate power result
(EN 15657) and the installed-source prediction (EN 12354-5) next to their
existing figures, add the one-line .plot() usage to both figures' code
blocks, cite Hopkins (2007) Section 2.8 for the point-excited-plate power
input behind the clause 4.4.3 coupling term with a prose paragraph
connecting the mobility chain, and give the EN 12354-5 page a proper
See-also linking the EN 15657, ISO 7626, junction and EN 12354 guides.
EN guides, ES mirrors and docs mirrors in sync.
* Vibration FRF guides: plot mentions and transfer-stiffness docs sync
Add the one-line .plot() usage and mentions for the ISO/TS 7849
sound-power-from-vibration result, the EN 29052-1 dynamic-stiffness
result and the ISO 10846 indirect transfer-stiffness result next to
their existing figures (EN guides, ES mirrors and docs mirrors), and
port the previously missing ISO 10846 test-report fiche section to the
transfer-stiffness docs mirror.
* Mechanical mobility guide: driving-point reading figure
Embed the new mobility_result_lines figure (|Y(f)| of the SDOF bundle
with the stiffness line, the mass line and the 1/c damping peak) next to
the MobilityResult snippet in the EN guide, the ES mirror and the docs
mirror, with the dual usage/hand-written code blocks and the one-line
res.plot() mention.
* Human vibration and multiple-shock guides: one-line plot mentions
Add the res.plot() one-liners next to the existing figures for the
ISO 8041-1 weighting response, the ISO 2631-1 weighted band spectrum, the
Directive 2002/44/EC daily exposure A(8) and the ISO 2631-5 multiple-shock
assessment, in the EN guides, the ES mirrors and the docs mirrors.
* Docs mirrors: restore missing report-fiche and concept sections
Sync the docs mirrors of the pages touched by this wave with their site
guides: the ISO 16283-3 facade report subsection on the field insulation
page, the EN 29052-1 and ISO 7626 fiche example snippets, and the panel
concept-figure code block.
* Changelog, API docs and llms regeneration; lint and typing fixes for the figure generators
* Fix nested emphasis in the survey-impact figure captions
* Restore the numerical-propagation rasters truncated by a mid-regeneration snapshot
* Reconcile the figure-script additions with the rooms and materials wave
* docs: regenerate the llms bundle after the figure-script reconciliation
Spanish docs: UNE terminology, decimal commas, localized snippets and theory figures (#365)
* Normalize Spanish docs prose to UNE acoustic terminology
Sweep the Spanish pages for the non-UNE forms "presion sonora",
"potencia sonora" and "intensidad sonora" and normalize the prose to
the wording used by the official Spanish editions of the standards:
"presion acustica" (UNE-EN ISO 16283-2:2016, UNE-EN ISO 10052:2005,
UNE-EN ISO 3746:2011, UNE-ISO 226:2013), "potencia acustica"
(UNE-EN ISO 3746:2011, UNE-EN ISO 4871:2010, UNE-EN ISO 9614-1:2010),
"intensidad acustica" (UNE-EN 61043:1999, UNE-EN ISO 9614-1:2010) and
"nivel de presion acustica de impactos" (UNE-EN ISO 12354-2:2018,
UNE-EN ISO 717-2:2013). 92 replacements across 32 pages, prose only:
code snippets keep the labels they share with the generated figures.
Rename the intensity guide to "Intensidad acustica (p-p)" and the
structure-borne power guide to "Potencia acustica estructural de
equipos (EN 15657)", updating every cross-link text and the theory
anchor intensidad-sonora-iec-61043 accordingly. The API sidebar group
label becomes "Potencia acustica e intensidad" via api_taxonomy.py
with the generated sidebar regenerated.
* Use decimal commas in Spanish docs prose quantities
Sweep every Spanish page for decimal points leaking into prose numbers
and switch them to the comma the locale convention calls for: the
rotorcraft validation prose (fourteen tolerances such as 0,08 dB(A) and
0,5 s), the insulation-prediction worked example (53,6 dB / 53,8 dB),
the tone-audibility Annex E tone (137,3 Hz), the Mackenzie check value
(1550,744 m/s), the EPNL, loudness and absorption fiche descriptions
(98,3 EPNdB; 8,2 sonos and 70,4 fonios; 0,60 y 0,55), the junction
constants table and the third-octave band-edge table in the signal
analysis theory page. Code snippets, inline code, math, clause numbers
and quoted source text keep their points.
* Pass language="es" in Spanish figure-reproduction snippets
The <details> blocks under each localized figure in the Spanish guides
are meant to reproduce the _es variant shown on the page, but 82 of the
one-line result .plot() calls omitted the language="es" argument and
would render English axis labels instead. Add the argument across 33
guides, matching the pattern the intensity field-indicators snippet
already used. The three lab-insulation results whose plot() does not
take a language argument (lab airborne, lab impact and the
element-normalized intensity difference) are left as they were.
* Extend the UNE terminology sweep to sound absorption
Normalize "absorción sonora" to "absorción acústica" across the
Spanish pages (36 occurrences in 14 pages, including the EN 12354-6
guide title and the theory headings), the wording of UNE-EN ISO
3746:2011 and of the equivalent absorption area in UNE-EN ISO
10140-3:2011, UNE-EN ISO 12354-2:2018 and UNE-EN ISO 16283-2:2016, and
the same term the accredited report strings already use. Also restore
the accent in the theory index anchor to the renamed intensity heading,
since heading slugs keep accented characters.
* Theory pages: illustrate each section family with existing result figures
The seven theory pages carried no figures at all. Embed sixteen of the
existing generated figures (light and dark variants, Spanish variants on
the Spanish mirrors) where the concept matches the prose: weighting
curves, time integration and the p-p intensity estimator in the signal
analysis page; equal-loudness contours, the specific-loudness pattern
and the hearing-threshold panels in perception; NC/RC rating, the
Schroeder decay and the ISO 717-1 shifted reference in rooms and
buildings; the Lden profile, ISO 9613-1 absorption and the three sound
power routes in environment and transport; the scattering coefficient
and ISO 11654 rating in materials and surfaces; and the Wk weighting and
the resonator mobility triplet in vibration. Each embed reuses the alt
text of the guide that owns the figure and adds a one-line caption.
Also give the wave-simulation section hub the reading-order paragraph
its siblings already have, linking the closed-form pages the FDTD solver
cross-checks, in both languages.
* Address review findings from the Spanish locale sweeps
Second pass fixes flagged by review: five terminology occurrences the
line-based sweep missed because the noun and adjective were split by a
line wrap or emphasis markup (sound-power, rotorcraft-noise and two
section hubs); six Spanish pages that still embedded the English figure
variant although the _es variant exists (junction-transmission,
aircraft-noise airport contour, miso-coherence,
objective-intelligibility, psychoacoustic-annoyance twice); and 19 more
language="es" arguments on figure-reproduction plot calls the first
pass missed, chained-call receivers such as room.noise_criterion(spl)
.plot() and the axes-creating first call of the two-profile
atmospheric-refraction snippet among them. The lab-insulation plot
wrappers forward keyword arguments to the rating plot, so the three
calls excluded earlier now take the argument too. All Spanish python
fences re-checked to compile and EN/ES parity re-verified.
* Carry the UNE terminology into the generated-asset Spanish strings
Apply the same evidence-based decisions to every Spanish string source
that feeds generated assets: the translation tables of
generate_graphs.py and generate_diagrams.py, the _STRINGS tables of the
plot modules and the report i18n values. 35 strings change: "presión
acústica" (UNE-EN ISO 16283-2:2016, 10052:2005, 3746:2011),
"potencia acústica" (UNE-EN ISO 3746:2011, 4871:2010, 9614-1:2010),
"intensidad acústica" (UNE-EN 61043:1999, 9614-1:2010), "absorción
acústica" (UNE-EN ISO 3746:2011) and "nivel de presión acústica de
impactos" (UNE-EN ISO 12354-2:2018). Strings the UNE editions keep are
untouched: "emisión sonora", "exposición sonora", "campo sonoro",
"fuente sonora". Only Spanish values change; the English keys stay.
The two plot-i18n test assertions that pin the axis label follow, and
the eight Spanish doc fences that deliberately mirrored the old figure
labels now mirror the new ones.
* Regenerate the Spanish figure variants with the UNE terminology
make graphs after the string-source change: 48 files, all of them _es
or _es_dark variants (24 figure/diagram pairs), picking up "presión
acústica", "potencia acústica", "intensidad acústica", "absorción
acústica" and "nivel de presión acústica de impactos" in titles and
axis labels. The English variants are untouched. The committed example
fiches need no regeneration: every example in generate_reports.py
renders in English, so no changed Spanish report string reaches them.
* Align the intensity-fiche Spanish assertions with the UNE terminology
Spanish docs: UNE terminology, decimal commas, localized snippets and theory figures (#365)
* Normalize Spanish docs prose to UNE acoustic terminology
Sweep the Spanish pages for the non-UNE forms "presion sonora",
"potencia sonora" and "intensidad sonora" and normalize the prose to
the wording used by the official Spanish editions of the standards:
"presion acustica" (UNE-EN ISO 16283-2:2016, UNE-EN ISO 10052:2005,
UNE-EN ISO 3746:2011, UNE-ISO 226:2013), "potencia acustica"
(UNE-EN ISO 3746:2011, UNE-EN ISO 4871:2010, UNE-EN ISO 9614-1:2010),
"intensidad acustica" (UNE-EN 61043:1999, UNE-EN ISO 9614-1:2010) and
"nivel de presion acustica de impactos" (UNE-EN ISO 12354-2:2018,
UNE-EN ISO 717-2:2013). 92 replacements across 32 pages, prose only:
code snippets keep the labels they share with the generated figures.
Rename the intensity guide to "Intensidad acustica (p-p)" and the
structure-borne power guide to "Potencia acustica estructural de
equipos (EN 15657)", updating every cross-link text and the theory
anchor intensidad-sonora-iec-61043 accordingly. The API sidebar group
label becomes "Potencia acustica e intensidad" via api_taxonomy.py
with the generated sidebar regenerated.
* Use decimal commas in Spanish docs prose quantities
Sweep every Spanish page for decimal points leaking into prose numbers
and switch them to the comma the locale convention calls for: the
rotorcraft validation prose (fourteen tolerances such as 0,08 dB(A) and
0,5 s), the insulation-prediction worked example (53,6 dB / 53,8 dB),
the tone-audibility Annex E tone (137,3 Hz), the Mackenzie check value
(1550,744 m/s), the EPNL, loudness and absorption fiche descriptions
(98,3 EPNdB; 8,2 sonos and 70,4 fonios; 0,60 y 0,55), the junction
constants table and the third-octave band-edge table in the signal
analysis theory page. Code snippets, inline code, math, clause numbers
and quoted source text keep their points.
* Pass language="es" in Spanish figure-reproduction snippets
The <details> blocks under each localized figure in the Spanish guides
are meant to reproduce the _es variant shown on the page, but 82 of the
one-line result .plot() calls omitted the language="es" argument and
would render English axis labels instead. Add the argument across 33
guides, matching the pattern the intensity field-indicators snippet
already used. The three lab-insulation results whose plot() does not
take a language argument (lab airborne, lab impact and the
element-normalized intensity difference) are left as they were.
* Extend the UNE terminology sweep to sound absorption
Normalize "absorción sonora" to "absorción acústica" across the
Spanish pages (36 occurrences in 14 pages, including the EN 12354-6
guide title and the theory headings), the wording of UNE-EN ISO
3746:2011 and of the equivalent absorption area in UNE-EN ISO
10140-3:2011, UNE-EN ISO 12354-2:2018 and UNE-EN ISO 16283-2:2016, and
the same term the accredited report strings already use. Also restore
the accent in the theory index anchor to the renamed intensity heading,
since heading slugs keep accented characters.
* Theory pages: illustrate each section family with existing result figures
The seven theory pages carried no figures at all. Embed sixteen of the
existing generated figures (light and dark variants, Spanish variants on
the Spanish mirrors) where the concept matches the prose: weighting
curves, time integration and the p-p intensity estimator in the signal
analysis page; equal-loudness contours, the specific-loudness pattern
and the hearing-threshold panels in perception; NC/RC rating, the
Schroeder decay and the ISO 717-1 shifted reference in rooms and
buildings; the Lden profile, ISO 9613-1 absorption and the three sound
power routes in environment and transport; the scattering coefficient
and ISO 11654 rating in materials and surfaces; and the Wk weighting and
the resonator mobility triplet in vibration. Each embed reuses the alt
text of the guide that owns the figure and adds a one-line caption.
Also give the wave-simulation section hub the reading-order paragraph
its siblings already have, linking the closed-form pages the FDTD solver
cross-checks, in both languages.
* Address review findings from the Spanish locale sweeps
Second pass fixes flagged by review: five terminology occurrences the
line-based sweep missed because the noun and adjective were split by a
line wrap or emphasis markup (sound-power, rotorcraft-noise and two
section hubs); six Spanish pages that still embedded the English figure
variant although the _es variant exists (junction-transmission,
aircraft-noise airport contour, miso-coherence,
objective-intelligibility, psychoacoustic-annoyance twice); and 19 more
language="es" arguments on figure-reproduction plot calls the first
pass missed, chained-call receivers such as room.noise_criterion(spl)
.plot() and the axes-creating first call of the two-profile
atmospheric-refraction snippet among them. The lab-insulation plot
wrappers forward keyword arguments to the rating plot, so the three
calls excluded earlier now take the argument too. All Spanish python
fences re-checked to compile and EN/ES parity re-verified.
* Carry the UNE terminology into the generated-asset Spanish strings
Apply the same evidence-based decisions to every Spanish string source
that feeds generated assets: the translation tables of
generate_graphs.py and generate_diagrams.py, the _STRINGS tables of the
plot modules and the report i18n values. 35 strings change: "presión
acústica" (UNE-EN ISO 16283-2:2016, 10052:2005, 3746:2011),
"potencia acústica" (UNE-EN ISO 3746:2011, 4871:2010, 9614-1:2010),
"intensidad acústica" (UNE-EN 61043:1999, 9614-1:2010), "absorción
acústica" (UNE-EN ISO 3746:2011) and "nivel de presión acústica de
impactos" (UNE-EN ISO 12354-2:2018). Strings the UNE editions keep are
untouched: "emisión sonora", "exposición sonora", "campo sonoro",
"fuente sonora". Only Spanish values change; the English keys stay.
The two plot-i18n test assertions that pin the axis label follow, and
the eight Spanish doc fences that deliberately mirrored the old figure
labels now mirror the new ones.
* Regenerate the Spanish figure variants with the UNE terminology
make graphs after the string-source change: 48 files, all of them _es
or _es_dark variants (24 figure/diagram pairs), picking up "presión
acústica", "potencia acústica", "intensidad acústica", "absorción
acústica" and "nivel de presión acústica de impactos" in titles and
axis labels. The English variants are untouched. The committed example
fiches need no regeneration: every example in generate_reports.py
renders in English, so no changed Spanish report string reaches them.
* Align the intensity-fiche Spanish assertions with the UNE terminology
Core metrology guides: result figures, ResampledSignalResult.plot() and real introductions (#364)
* Add ResampledSignalResult.plot(): the delivered anti-alias filter against its design spec
* Rewrite the multichannel guide intro: concrete use cases, per-channel guarantees, Bendat & Piersol citations
* Give the levels page a real introduction: descriptor families, when-to-use guidance and survey references
* Time weighting: framing intro with detector history, ANSI S1.4/Bies references and sibling links
* Calibration: proper introduction (SPL vs dBFS choice, workflow framing) with Bies reference and sibling links
* Add eleven core-metrology figures: resampling spec, cepstrum variants, liftering, correlation, IR alignment, Hilbert envelope, cross-spectra, Golay recovery, TSA noise law, runs test
* Test signals: anti-alias figure with dual snippet, res.plot() mention, See also, docs mirror sync
* Cepstrum guide: variants and liftering figures with dual snippets, complex-cepstrum plot mention
* Correlation guide: normalization, IR-alignment and Hilbert-envelope figures with dual snippets
* Spectral analysis: cross-spectral density and coherent-output-SNR figures with dual snippets
* System measurement: Golay exact-recovery figure and plot mentions for the inversion workflow
* Synchronous averaging: sqrt(N) figure, diagnostics-tool guidance, See also, recording naming
* Data qualification: runs-test figure with dual snippet and peak-statistics plot mention
* MISO coherence: conditioning-order snippet, practical pitfalls and See also across the three trees
* Time-frequency: Harris window reference and See also across the three trees
* GUM uncertainty: map the domain pages that consume the clause-5 machinery, expand See also
* Filter banks: compliance plot mentions and recording naming in the crossover snippet
* Changelog entry for the core-metrology documentation figures and prose
* Regenerate llms-full.txt for the core-metrology documentation
* Drop the duplicated phase-axis translation key
Core metrology guides: result figures, ResampledSignalResult.plot() and real introductions (#364)
* Add ResampledSignalResult.plot(): the delivered anti-alias filter against its design spec
* Rewrite the multichannel guide intro: concrete use cases, per-channel guarantees, Bendat & Piersol citations
* Give the levels page a real introduction: descriptor families, when-to-use guidance and survey references
* Time weighting: framing intro with detector history, ANSI S1.4/Bies references and sibling links
* Calibration: proper introduction (SPL vs dBFS choice, workflow framing) with Bies reference and sibling links
* Add eleven core-metrology figures: resampling spec, cepstrum variants, liftering, correlation, IR alignment, Hilbert envelope, cross-spectra, Golay recovery, TSA noise law, runs test
* Test signals: anti-alias figure with dual snippet, res.plot() mention, See also, docs mirror sync
* Cepstrum guide: variants and liftering figures with dual snippets, complex-cepstrum plot mention
* Correlation guide: normalization, IR-alignment and Hilbert-envelope figures with dual snippets
* Spectral analysis: cross-spectral density and coherent-output-SNR figures with dual snippets
* System measurement: Golay exact-recovery figure and plot mentions for the inversion workflow
* Synchronous averaging: sqrt(N) figure, diagnostics-tool guidance, See also, recording naming
* Data qualification: runs-test figure with dual snippet and peak-statistics plot mention
* MISO coherence: conditioning-order snippet, practical pitfalls and See also across the three trees
* Time-frequency: Harris window reference and See also across the three trees
* GUM uncertainty: map the domain pages that consume the clause-5 machinery, expand See also
* Filter banks: compliance plot mentions and recording naming in the crossover snippet
* Changelog entry for the core-metrology documentation figures and prose
* Regenerate llms-full.txt for the core-metrology documentation
* Drop the duplicated phase-axis translation key
Core metrology guides: result figures, ResampledSignalResult.plot() and real introductions (#364)
* Add ResampledSignalResult.plot(): the delivered anti-alias filter against its design spec
* Rewrite the multichannel guide intro: concrete use cases, per-channel guarantees, Bendat & Piersol citations
* Give the levels page a real introduction: descriptor families, when-to-use guidance and survey references
* Time weighting: framing intro with detector history, ANSI S1.4/Bies references and sibling links
* Calibration: proper introduction (SPL vs dBFS choice, workflow framing) with Bies reference and sibling links
* Add eleven core-metrology figures: resampling spec, cepstrum variants, liftering, correlation, IR alignment, Hilbert envelope, cross-spectra, Golay recovery, TSA noise law, runs test
* Test signals: anti-alias figure with dual snippet, res.plot() mention, See also, docs mirror sync
* Cepstrum guide: variants and liftering figures with dual snippets, complex-cepstrum plot mention
* Correlation guide: normalization, IR-alignment and Hilbert-envelope figures with dual snippets
* Spectral analysis: cross-spectral density and coherent-output-SNR figures with dual snippets
* System measurement: Golay exact-recovery figure and plot mentions for the inversion workflow
* Synchronous averaging: sqrt(N) figure, diagnostics-tool guidance, See also, recording naming
* Data qualification: runs-test figure with dual snippet and peak-statistics plot mention
* MISO coherence: conditioning-order snippet, practical pitfalls and See also across the three trees
* Time-frequency: Harris window reference and See also across the three trees
* GUM uncertainty: map the domain pages that consume the clause-5 machinery, expand See also
* Filter banks: compliance plot mentions and recording naming in the crossover snippet
* Changelog entry for the core-metrology documentation figures and prose
* Regenerate llms-full.txt for the core-metrology documentation
* Drop the duplicated phase-axis translation key
Core metrology guides: result figures, ResampledSignalResult.plot() and real introductions (#364)
* Add ResampledSignalResult.plot(): the delivered anti-alias filter against its design spec
* Rewrite the multichannel guide intro: concrete use cases, per-channel guarantees, Bendat & Piersol citations
* Give the levels page a real introduction: descriptor families, when-to-use guidance and survey references
* Time weighting: framing intro with detector history, ANSI S1.4/Bies references and sibling links
* Calibration: proper introduction (SPL vs dBFS choice, workflow framing) with Bies reference and sibling links
* Add eleven core-metrology figures: resampling spec, cepstrum variants, liftering, correlation, IR alignment, Hilbert envelope, cross-spectra, Golay recovery, TSA noise law, runs test
* Test signals: anti-alias figure with dual snippet, res.plot() mention, See also, docs mirror sync
* Cepstrum guide: variants and liftering figures with dual snippets, complex-cepstrum plot mention
* Correlation guide: normalization, IR-alignment and Hilbert-envelope figures with dual snippets
* Spectral analysis: cross-spectral density and coherent-output-SNR figures with dual snippets
* System measurement: Golay exact-recovery figure and plot mentions for the inversion workflow
* Synchronous averaging: sqrt(N) figure, diagnostics-tool guidance, See also, recording naming
* Data qualification: runs-test figure with dual snippet and peak-statistics plot mention
* MISO coherence: conditioning-order snippet, practical pitfalls and See also across the three trees
* Time-frequency: Harris window reference and See also across the three trees
* GUM uncertainty: map the domain pages that consume the clause-5 machinery, expand See also
* Filter banks: compliance plot mentions and recording naming in the crossover snippet
* Changelog entry for the core-metrology documentation figures and prose
* Regenerate llms-full.txt for the core-metrology documentation
* Drop the duplicated phase-axis translation key
Spanish docs: UNE terminology, decimal commas, localized snippets and theory figures (#365)
* Normalize Spanish docs prose to UNE acoustic terminology
Sweep the Spanish pages for the non-UNE forms "presion sonora",
"potencia sonora" and "intensidad sonora" and normalize the prose to
the wording used by the official Spanish editions of the standards:
"presion acustica" (UNE-EN ISO 16283-2:2016, UNE-EN ISO 10052:2005,
UNE-EN ISO 3746:2011, UNE-ISO 226:2013), "potencia acustica"
(UNE-EN ISO 3746:2011, UNE-EN ISO 4871:2010, UNE-EN ISO 9614-1:2010),
"intensidad acustica" (UNE-EN 61043:1999, UNE-EN ISO 9614-1:2010) and
"nivel de presion acustica de impactos" (UNE-EN ISO 12354-2:2018,
UNE-EN ISO 717-2:2013). 92 replacements across 32 pages, prose only:
code snippets keep the labels they share with the generated figures.
Rename the intensity guide to "Intensidad acustica (p-p)" and the
structure-borne power guide to "Potencia acustica estructural de
equipos (EN 15657)", updating every cross-link text and the theory
anchor intensidad-sonora-iec-61043 accordingly. The API sidebar group
label becomes "Potencia acustica e intensidad" via api_taxonomy.py
with the generated sidebar regenerated.
* Use decimal commas in Spanish docs prose quantities
Sweep every Spanish page for decimal points leaking into prose numbers
and switch them to the comma the locale convention calls for: the
rotorcraft validation prose (fourteen tolerances such as 0,08 dB(A) and
0,5 s), the insulation-prediction worked example (53,6 dB / 53,8 dB),
the tone-audibility Annex E tone (137,3 Hz), the Mackenzie check value
(1550,744 m/s), the EPNL, loudness and absorption fiche descriptions
(98,3 EPNdB; 8,2 sonos and 70,4 fonios; 0,60 y 0,55), the junction
constants table and the third-octave band-edge table in the signal
analysis theory page. Code snippets, inline code, math, clause numbers
and quoted source text keep their points.
* Pass language="es" in Spanish figure-reproduction snippets
The <details> blocks under each localized figure in the Spanish guides
are meant to reproduce the _es variant shown on the page, but 82 of the
one-line result .plot() calls omitted the language="es" argument and
would render English axis labels instead. Add the argument across 33
guides, matching the pattern the intensity field-indicators snippet
already used. The three lab-insulation results whose plot() does not
take a language argument (lab airborne, lab impact and the
element-normalized intensity difference) are left as they were.
* Extend the UNE terminology sweep to sound absorption
Normalize "absorción sonora" to "absorción acústica" across the
Spanish pages (36 occurrences in 14 pages, including the EN 12354-6
guide title and the theory headings), the wording of UNE-EN ISO
3746:2011 and of the equivalent absorption area in UNE-EN ISO
10140-3:2011, UNE-EN ISO 12354-2:2018 and UNE-EN ISO 16283-2:2016, and
the same term the accredited report strings already use. Also restore
the accent in the theory index anchor to the renamed intensity heading,
since heading slugs keep accented characters.
* Theory pages: illustrate each section family with existing result figures
The seven theory pages carried no figures at all. Embed sixteen of the
existing generated figures (light and dark variants, Spanish variants on
the Spanish mirrors) where the concept matches the prose: weighting
curves, time integration and the p-p intensity estimator in the signal
analysis page; equal-loudness contours, the specific-loudness pattern
and the hearing-threshold panels in perception; NC/RC rating, the
Schroeder decay and the ISO 717-1 shifted reference in rooms and
buildings; the Lden profile, ISO 9613-1 absorption and the three sound
power routes in environment and transport; the scattering coefficient
and ISO 11654 rating in materials and surfaces; and the Wk weighting and
the resonator mobility triplet in vibration. Each embed reuses the alt
text of the guide that owns the figure and adds a one-line caption.
Also give the wave-simulation section hub the reading-order paragraph
its siblings already have, linking the closed-form pages the FDTD solver
cross-checks, in both languages.
* Address review findings from the Spanish locale sweeps
Second pass fixes flagged by review: five terminology occurrences the
line-based sweep missed because the noun and adjective were split by a
line wrap or emphasis markup (sound-power, rotorcraft-noise and two
section hubs); six Spanish pages that still embedded the English figure
variant although the _es variant exists (junction-transmission,
aircraft-noise airport contour, miso-coherence,
objective-intelligibility, psychoacoustic-annoyance twice); and 19 more
language="es" arguments on figure-reproduction plot calls the first
pass missed, chained-call receivers such as room.noise_criterion(spl)
.plot() and the axes-creating first call of the two-profile
atmospheric-refraction snippet among them. The lab-insulation plot
wrappers forward keyword arguments to the rating plot, so the three
calls excluded earlier now take the argument too. All Spanish python
fences re-checked to compile and EN/ES parity re-verified.
* Carry the UNE terminology into the generated-asset Spanish strings
Apply the same evidence-based decisions to every Spanish string source
that feeds generated assets: the translation tables of
generate_graphs.py and generate_diagrams.py, the _STRINGS tables of the
plot modules and the report i18n values. 35 strings change: "presión
acústica" (UNE-EN ISO 16283-2:2016, 10052:2005, 3746:2011),
"potencia acústica" (UNE-EN ISO 3746:2011, 4871:2010, 9614-1:2010),
"intensidad acústica" (UNE-EN 61043:1999, 9614-1:2010), "absorción
acústica" (UNE-EN ISO 3746:2011) and "nivel de presión acústica de
impactos" (UNE-EN ISO 12354-2:2018). Strings the UNE editions keep are
untouched: "emisión sonora", "exposición sonora", "campo sonoro",
"fuente sonora". Only Spanish values change; the English keys stay.
The two plot-i18n test assertions that pin the axis label follow, and
the eight Spanish doc fences that deliberately mirrored the old figure
labels now mirror the new ones.
* Regenerate the Spanish figure variants with the UNE terminology
make graphs after the string-source change: 48 files, all of them _es
or _es_dark variants (24 figure/diagram pairs), picking up "presión
acústica", "potencia acústica", "intensidad acústica", "absorción
acústica" and "nivel de presión acústica de impactos" in titles and
axis labels. The English variants are untouched. The committed example
fiches need no regeneration: every example in generate_reports.py
renders in English, so no changed Spanish report string reaches them.
* Align the intensity-fiche Spanish assertions with the UNE terminology
Spanish docs: UNE terminology, decimal commas, localized snippets and theory figures (#365)
* Normalize Spanish docs prose to UNE acoustic terminology
Sweep the Spanish pages for the non-UNE forms "presion sonora",
"potencia sonora" and "intensidad sonora" and normalize the prose to
the wording used by the official Spanish editions of the standards:
"presion acustica" (UNE-EN ISO 16283-2:2016, UNE-EN ISO 10052:2005,
UNE-EN ISO 3746:2011, UNE-ISO 226:2013), "potencia acustica"
(UNE-EN ISO 3746:2011, UNE-EN ISO 4871:2010, UNE-EN ISO 9614-1:2010),
"intensidad acustica" (UNE-EN 61043:1999, UNE-EN ISO 9614-1:2010) and
"nivel de presion acustica de impactos" (UNE-EN ISO 12354-2:2018,
UNE-EN ISO 717-2:2013). 92 replacements across 32 pages, prose only:
code snippets keep the labels they share with the generated figures.
Rename the intensity guide to "Intensidad acustica (p-p)" and the
structure-borne power guide to "Potencia acustica estructural de
equipos (EN 15657)", updating every cross-link text and the theory
anchor intensidad-sonora-iec-61043 accordingly. The API sidebar group
label becomes "Potencia acustica e intensidad" via api_taxonomy.py
with the generated sidebar regenerated.
* Use decimal commas in Spanish docs prose quantities
Sweep every Spanish page for decimal points leaking into prose numbers
and switch them to the comma the locale convention calls for: the
rotorcraft validation prose (fourteen tolerances such as 0,08 dB(A) and
0,5 s), the insulation-prediction worked example (53,6 dB / 53,8 dB),
the tone-audibility Annex E tone (137,3 Hz), the Mackenzie check value
(1550,744 m/s), the EPNL, loudness and absorption fiche descriptions
(98,3 EPNdB; 8,2 sonos and 70,4 fonios; 0,60 y 0,55), the junction
constants table and the third-octave band-edge table in the signal
analysis theory page. Code snippets, inline code, math, clause numbers
and quoted source text keep their points.
* Pass language="es" in Spanish figure-reproduction snippets
The <details> blocks under each localized figure in the Spanish guides
are meant to reproduce the _es variant shown on the page, but 82 of the
one-line result .plot() calls omitted the language="es" argument and
would render English axis labels instead. Add the argument across 33
guides, matching the pattern the intensity field-indicators snippet
already used. The three lab-insulation results whose plot() does not
take a language argument (lab airborne, lab impact and the
element-normalized intensity difference) are left as they were.
* Extend the UNE terminology sweep to sound absorption
Normalize "absorción sonora" to "absorción acústica" across the
Spanish pages (36 occurrences in 14 pages, including the EN 12354-6
guide title and the theory headings), the wording of UNE-EN ISO
3746:2011 and of the equivalent absorption area in UNE-EN ISO
10140-3:2011, UNE-EN ISO 12354-2:2018 and UNE-EN ISO 16283-2:2016, and
the same term the accredited report strings already use. Also restore
the accent in the theory index anchor to the renamed intensity heading,
since heading slugs keep accented characters.
* Theory pages: illustrate each section family with existing result figures
The seven theory pages carried no figures at all. Embed sixteen of the
existing generated figures (light and dark variants, Spanish variants on
the Spanish mirrors) where the concept matches the prose: weighting
curves, time integration and the p-p intensity estimator in the signal
analysis page; equal-loudness contours, the specific-loudness pattern
and the hearing-threshold panels in perception; NC/RC rating, the
Schroeder decay and the ISO 717-1 shifted reference in rooms and
buildings; the Lden profile, ISO 9613-1 absorption and the three sound
power routes in environment and transport; the scattering coefficient
and ISO 11654 rating in materials and surfaces; and the Wk weighting and
the resonator mobility triplet in vibration. Each embed reuses the alt
text of the guide that owns the figure and adds a one-line caption.
Also give the wave-simulation section hub the reading-order paragraph
its siblings already have, linking the closed-form pages the FDTD solver
cross-checks, in both languages.
* Address review findings from the Spanish locale sweeps
Second pass fixes flagged by review: five terminology occurrences the
line-based sweep missed because the noun and adjective were split by a
line wrap or emphasis markup (sound-power, rotorcraft-noise and two
section hubs); six Spanish pages that still embedded the English figure
variant although the _es variant exists (junction-transmission,
aircraft-noise airport contour, miso-coherence,
objective-intelligibility, psychoacoustic-annoyance twice); and 19 more
language="es" arguments on figure-reproduction plot calls the first
pass missed, chained-call receivers such as room.noise_criterion(spl)
.plot() and the axes-creating first call of the two-profile
atmospheric-refraction snippet among them. The lab-insulation plot
wrappers forward keyword arguments to the rating plot, so the three
calls excluded earlier now take the argument too. All Spanish python
fences re-checked to compile and EN/ES parity re-verified.
* Carry the UNE terminology into the generated-asset Spanish strings
Apply the same evidence-based decisions to every Spanish string source
that feeds generated assets: the translation tables of
generate_graphs.py and generate_diagrams.py, the _STRINGS tables of the
plot modules and the report i18n values. 35 strings change: "presión
acústica" (UNE-EN ISO 16283-2:2016, 10052:2005, 3746:2011),
"potencia acústica" (UNE-EN ISO 3746:2011, 4871:2010, 9614-1:2010),
"intensidad acústica" (UNE-EN 61043:1999, 9614-1:2010), "absorción
acústica" (UNE-EN ISO 3746:2011) and "nivel de presión acústica de
impactos" (UNE-EN ISO 12354-2:2018). Strings the UNE editions keep are
untouched: "emisión sonora", "exposición sonora", "campo sonoro",
"fuente sonora". Only Spanish values change; the English keys stay.
The two plot-i18n test assertions that pin the axis label follow, and
the eight Spanish doc fences that deliberately mirrored the old figure
labels now mirror the new ones.
* Regenerate the Spanish figure variants with the UNE terminology
make graphs after the string-source change: 48 files, all of them _es
or _es_dark variants (24 figure/diagram pairs), picking up "presión
acústica", "potencia acústica", "intensidad acústica", "absorción
acústica" and "nivel de presión acústica de impactos" in titles and
axis labels. The English variants are untouched. The committed example
fiches need no regeneration: every example in generate_reports.py
renders in English, so no changed Spanish report string reaches them.
* Align the intensity-fiche Spanish assertions with the UNE terminology
Spanish docs: UNE terminology, decimal commas, localized snippets and theory figures (#365)
* Normalize Spanish docs prose to UNE acoustic terminology
Sweep the Spanish pages for the non-UNE forms "presion sonora",
"potencia sonora" and "intensidad sonora" and normalize the prose to
the wording used by the official Spanish editions of the standards:
"presion acustica" (UNE-EN ISO 16283-2:2016, UNE-EN ISO 10052:2005,
UNE-EN ISO 3746:2011, UNE-ISO 226:2013), "potencia acustica"
(UNE-EN ISO 3746:2011, UNE-EN ISO 4871:2010, UNE-EN ISO 9614-1:2010),
"intensidad acustica" (UNE-EN 61043:1999, UNE-EN ISO 9614-1:2010) and
"nivel de presion acustica de impactos" (UNE-EN ISO 12354-2:2018,
UNE-EN ISO 717-2:2013). 92 replacements across 32 pages, prose only:
code snippets keep the labels they share with the generated figures.
Rename the intensity guide to "Intensidad acustica (p-p)" and the
structure-borne power guide to "Potencia acustica estructural de
equipos (EN 15657)", updating every cross-link text and the theory
anchor intensidad-sonora-iec-61043 accordingly. The API sidebar group
label becomes "Potencia acustica e intensidad" via api_taxonomy.py
with the generated sidebar regenerated.
* Use decimal commas in Spanish docs prose quantities
Sweep every Spanish page for decimal points leaking into prose numbers
and switch them to the comma the locale convention calls for: the
rotorcraft validation prose (fourteen tolerances such as 0,08 dB(A) and
0,5 s), the insulation-prediction worked example (53,6 dB / 53,8 dB),
the tone-audibility Annex E tone (137,3 Hz), the Mackenzie check value
(1550,744 m/s), the EPNL, loudness and absorption fiche descriptions
(98,3 EPNdB; 8,2 sonos and 70,4 fonios; 0,60 y 0,55), the junction
constants table and the third-octave band-edge table in the signal
analysis theory page. Code snippets, inline code, math, clause numbers
and quoted source text keep their points.
* Pass language="es" in Spanish figure-reproduction snippets
The <details> blocks under each localized figure in the Spanish guides
are meant to reproduce the _es variant shown on the page, but 82 of the
one-line result .plot() calls omitted the language="es" argument and
would render English axis labels instead. Add the argument across 33
guides, matching the pattern the intensity field-indicators snippet
already used. The three lab-insulation results whose plot() does not
take a language argument (lab airborne, lab impact and the
element-normalized intensity difference) are left as they were.
* Extend the UNE terminology sweep to sound absorption
Normalize "absorción sonora" to "absorción acústica" across the
Spanish pages (36 occurrences in 14 pages, including the EN 12354-6
guide title and the theory headings), the wording of UNE-EN ISO
3746:2011 and of the equivalent absorption area in UNE-EN ISO
10140-3:2011, UNE-EN ISO 12354-2:2018 and UNE-EN ISO 16283-2:2016, and
the same term the accredited report strings already use. Also restore
the accent in the theory index anchor to the renamed intensity heading,
since heading slugs keep accented characters.
* Theory pages: illustrate each section family with existing result figures
The seven theory pages carried no figures at all. Embed sixteen of the
existing generated figures (light and dark variants, Spanish variants on
the Spanish mirrors) where the concept matches the prose: weighting
curves, time integration and the p-p intensity estimator in the signal
analysis page; equal-loudness contours, the specific-loudness pattern
and the hearing-threshold panels in perception; NC/RC rating, the
Schroeder decay and the ISO 717-1 shifted reference in rooms and
buildings; the Lden profile, ISO 9613-1 absorption and the three sound
power routes in environment and transport; the scattering coefficient
and ISO 11654 rating in materials and surfaces; and the Wk weighting and
the resonator mobility triplet in vibration. Each embed reuses the alt
text of the guide that owns the figure and adds a one-line caption.
Also give the wave-simulation section hub the reading-order paragraph
its siblings already have, linking the closed-form pages the FDTD solver
cross-checks, in both languages.
* Address review findings from the Spanish locale sweeps
Second pass fixes flagged by review: five terminology occurrences the
line-based sweep missed because the noun and adjective were split by a
line wrap or emphasis markup (sound-power, rotorcraft-noise and two
section hubs); six Spanish pages that still embedded the English figure
variant although the _es variant exists (junction-transmission,
aircraft-noise airport contour, miso-coherence,
objective-intelligibility, psychoacoustic-annoyance twice); and 19 more
language="es" arguments on figure-reproduction plot calls the first
pass missed, chained-call receivers such as room.noise_criterion(spl)
.plot() and the axes-creating first call of the two-profile
atmospheric-refraction snippet among them. The lab-insulation plot
wrappers forward keyword arguments to the rating plot, so the three
calls excluded earlier now take the argument too. All Spanish python
fences re-checked to compile and EN/ES parity re-verified.
* Carry the UNE terminology into the generated-asset Spanish strings
Apply the same evidence-based decisions to every Spanish string source
that feeds generated assets: the translation tables of
generate_graphs.py and generate_diagrams.py, the _STRINGS tables of the
plot modules and the report i18n values. 35 strings change: "presión
acústica" (UNE-EN ISO 16283-2:2016, 10052:2005, 3746:2011),
"potencia acústica" (UNE-EN ISO 3746:2011, 4871:2010, 9614-1:2010),
"intensidad acústica" (UNE-EN 61043:1999, 9614-1:2010), "absorción
acústica" (UNE-EN ISO 3746:2011) and "nivel de presión acústica de
impactos" (UNE-EN ISO 12354-2:2018). Strings the UNE editions keep are
untouched: "emisión sonora", "exposición sonora", "campo sonoro",
"fuente sonora". Only Spanish values change; the English keys stay.
The two plot-i18n test assertions that pin the axis label follow, and
the eight Spanish doc fences that deliberately mirrored the old figure
labels now mirror the new ones.
* Regenerate the Spanish figure variants with the UNE terminology
make graphs after the string-source change: 48 files, all of them _es
or _es_dark variants (24 figure/diagram pairs), picking up "presión
acústica", "potencia acústica", "intensidad acústica", "absorción
acústica" and "nivel de presión acústica de impactos" in titles and
axis labels. The English variants are untouched. The committed example
fiches need no regeneration: every example in generate_reports.py
renders in English, so no changed Spanish report string reaches them.
* Align the intensity-fiche Spanish assertions with the UNE terminology
Spanish docs: UNE terminology, decimal commas, localized snippets and theory figures (#365)
* Normalize Spanish docs prose to UNE acoustic terminology
Sweep the Spanish pages for the non-UNE forms "presion sonora",
"potencia sonora" and "intensidad sonora" and normalize the prose to
the wording used by the official Spanish editions of the standards:
"presion acustica" (UNE-EN ISO 16283-2:2016, UNE-EN ISO 10052:2005,
UNE-EN ISO 3746:2011, UNE-ISO 226:2013), "potencia acustica"
(UNE-EN ISO 3746:2011, UNE-EN ISO 4871:2010, UNE-EN ISO 9614-1:2010),
"intensidad acustica" (UNE-EN 61043:1999, UNE-EN ISO 9614-1:2010) and
"nivel de presion acustica de impactos" (UNE-EN ISO 12354-2:2018,
UNE-EN ISO 717-2:2013). 92 replacements across 32 pages, prose only:
code snippets keep the labels they share with the generated figures.
Rename the intensity guide to "Intensidad acustica (p-p)" and the
structure-borne power guide to "Potencia acustica estructural de
equipos (EN 15657)", updating every cross-link text and the theory
anchor intensidad-sonora-iec-61043 accordingly. The API sidebar group
label becomes "Potencia acustica e intensidad" via api_taxonomy.py
with the generated sidebar regenerated.
* Use decimal commas in Spanish docs prose quantities
Sweep every Spanish page for decimal points leaking into prose numbers
and switch them to the comma the locale convention calls for: the
rotorcraft validation prose (fourteen tolerances such as 0,08 dB(A) and
0,5 s), the insulation-prediction worked example (53,6 dB / 53,8 dB),
the tone-audibility Annex E tone (137,3 Hz), the Mackenzie check value
(1550,744 m/s), the EPNL, loudness and absorption fiche descriptions
(98,3 EPNdB; 8,2 sonos and 70,4 fonios; 0,60 y 0,55), the junction
constants table and the third-octave band-edge table in the signal
analysis theory page. Code snippets, inline code, math, clause numbers
and quoted source text keep their points.
* Pass language="es" in Spanish figure-reproduction snippets
The <details> blocks under each localized figure in the Spanish guides
are meant to reproduce the _es variant shown on the page, but 82 of the
one-line result .plot() calls omitted the language="es" argument and
would render English axis labels instead. Add the argument across 33
guides, matching the pattern the intensity field-indicators snippet
already used. The three lab-insulation results whose plot() does not
take a language argument (lab airborne, lab impact and the
element-normalized intensity difference) are left as they were.
* Extend the UNE terminology sweep to sound absorption
Normalize "absorción sonora" to "absorción acústica" across the
Spanish pages (36 occurrences in 14 pages, including the EN 12354-6
guide title and the theory headings), the wording of UNE-EN ISO
3746:2011 and of the equivalent absorption area in UNE-EN ISO
10140-3:2011, UNE-EN ISO 12354-2:2018 and UNE-EN ISO 16283-2:2016, and
the same term the accredited report strings already use. Also restore
the accent in the theory index anchor to the renamed intensity heading,
since heading slugs keep accented characters.
* Theory pages: illustrate each section family with existing result figures
The seven theory pages carried no figures at all. Embed sixteen of the
existing generated figures (light and dark variants, Spanish variants on
the Spanish mirrors) where the concept matches the prose: weighting
curves, time integration and the p-p intensity estimator in the signal
analysis page; equal-loudness contours, the specific-loudness pattern
and the hearing-threshold panels in perception; NC/RC rating, the
Schroeder decay and the ISO 717-1 shifted reference in rooms and
buildings; the Lden profile, ISO 9613-1 absorption and the three sound
power routes in environment and transport; the scattering coefficient
and ISO 11654 rating in materials and surfaces; and the Wk weighting and
the resonator mobility triplet in vibration. Each embed reuses the alt
text of the guide that owns the figure and adds a one-line caption.
Also give the wave-simulation section hub the reading-order paragraph
its siblings already have, linking the closed-form pages the FDTD solver
cross-checks, in both languages.
* Address review findings from the Spanish locale sweeps
Second pass fixes flagged by review: five terminology occurrences the
line-based sweep missed because the noun and adjective were split by a
line wrap or emphasis markup (sound-power, rotorcraft-noise and two
section hubs); six Spanish pages that still embedded the English figure
variant although the _es variant exists (junction-transmission,
aircraft-noise airport contour, miso-coherence,
objective-intelligibility, psychoacoustic-annoyance twice); and 19 more
language="es" arguments on figure-reproduction plot calls the first
pass missed, chained-call receivers such as room.noise_criterion(spl)
.plot() and the axes-creating first call of the two-profile
atmospheric-refraction snippet among them. The lab-insulation plot
wrappers forward keyword arguments to the rating plot, so the three
calls excluded earlier now take the argument too. All Spanish python
fences re-checked to compile and EN/ES parity re-verified.
* Carry the UNE terminology into the generated-asset Spanish strings
Apply the same evidence-based decisions to every Spanish string source
that feeds generated assets: the translation tables of
generate_graphs.py and generate_diagrams.py, the _STRINGS tables of the
plot modules and the report i18n values. 35 strings change: "presión
acústica" (UNE-EN ISO 16283-2:2016, 10052:2005, 3746:2011),
"potencia acústica" (UNE-EN ISO 3746:2011, 4871:2010, 9614-1:2010),
"intensidad acústica" (UNE-EN 61043:1999, 9614-1:2010), "absorción
acústica" (UNE-EN ISO 3746:2011) and "nivel de presión acústica de
impactos" (UNE-EN ISO 12354-2:2018). Strings the UNE editions keep are
untouched: "emisión sonora", "exposición sonora", "campo sonoro",
"fuente sonora". Only Spanish values change; the English keys stay.
The two plot-i18n test assertions that pin the axis label follow, and
the eight Spanish doc fences that deliberately mirrored the old figure
labels now mirror the new ones.
* Regenerate the Spanish figure variants with the UNE terminology
make graphs after the string-source change: 48 files, all of them _es
or _es_dark variants (24 figure/diagram pairs), picking up "presión
acústica", "potencia acústica", "intensidad acústica", "absorción
acústica" and "nivel de presión acústica de impactos" in titles and
axis labels. The English variants are untouched. The committed example
fiches need no regeneration: every example in generate_reports.py
renders in English, so no changed Spanish report string reaches them.
* Align the intensity-fiche Spanish assertions with the UNE terminology
Core metrology guides: result figures, ResampledSignalResult.plot() and real introductions (#364)
* Add ResampledSignalResult.plot(): the delivered anti-alias filter against its design spec
* Rewrite the multichannel guide intro: concrete use cases, per-channel guarantees, Bendat & Piersol citations
* Give the levels page a real introduction: descriptor families, when-to-use guidance and survey references
* Time weighting: framing intro with detector history, ANSI S1.4/Bies references and sibling links
* Calibration: proper introduction (SPL vs dBFS choice, workflow framing) with Bies reference and sibling links
* Add eleven core-metrology figures: resampling spec, cepstrum variants, liftering, correlation, IR alignment, Hilbert envelope, cross-spectra, Golay recovery, TSA noise law, runs test
* Test signals: anti-alias figure with dual snippet, res.plot() mention, See also, docs mirror sync
* Cepstrum guide: variants and liftering figures with dual snippets, complex-cepstrum plot mention
* Correlation guide: normalization, IR-alignment and Hilbert-envelope figures with dual snippets
* Spectral analysis: cross-spectral density and coherent-output-SNR figures with dual snippets
* System measurement: Golay exact-recovery figure and plot mentions for the inversion workflow
* Synchronous averaging: sqrt(N) figure, diagnostics-tool guidance, See also, recording naming
* Data qualification: runs-test figure with dual snippet and peak-statistics plot mention
* MISO coherence: conditioning-order snippet, practical pitfalls and See also across the three trees
* Time-frequency: Harris window reference and See also across the three trees
* GUM uncertainty: map the domain pages that consume the clause-5 machinery, expand See also
* Filter banks: compliance plot mentions and recording naming in the crossover snippet
* Changelog entry for the core-metrology documentation figures and prose
* Regenerate llms-full.txt for the core-metrology documentation
* Drop the duplicated phase-axis translation key
Core metrology guides: result figures, ResampledSignalResult.plot() and real introductions (#364)
* Add ResampledSignalResult.plot(): the delivered anti-alias filter against its design spec
* Rewrite the multichannel guide intro: concrete use cases, per-channel guarantees, Bendat & Piersol citations
* Give the levels page a real introduction: descriptor families, when-to-use guidance and survey references
* Time weighting: framing intro with detector history, ANSI S1.4/Bies references and sibling links
* Calibration: proper introduction (SPL vs dBFS choice, workflow framing) with Bies reference and sibling links
* Add eleven core-metrology figures: resampling spec, cepstrum variants, liftering, correlation, IR alignment, Hilbert envelope, cross-spectra, Golay recovery, TSA noise law, runs test
* Test signals: anti-alias figure with dual snippet, res.plot() mention, See also, docs mirror sync
* Cepstrum guide: variants and liftering figures with dual snippets, complex-cepstrum plot mention
* Correlation guide: normalization, IR-alignment and Hilbert-envelope figures with dual snippets
* Spectral analysis: cross-spectral density and coherent-output-SNR figures with dual snippets
* System measurement: Golay exact-recovery figure and plot mentions for the inversion workflow
* Synchronous averaging: sqrt(N) figure, diagnostics-tool guidance, See also, recording naming
* Data qualification: runs-test figure with dual snippet and peak-statistics plot mention
* MISO coherence: conditioning-order snippet, practical pitfalls and See also across the three trees
* Time-frequency: Harris window reference and See also across the three trees
* GUM uncertainty: map the domain pages that consume the clause-5 machinery, expand See also
* Filter banks: compliance plot mentions and recording naming in the crossover snippet
* Changelog entry for the core-metrology documentation figures and prose
* Regenerate llms-full.txt for the core-metrology documentation
* Drop the duplicated phase-axis translation key
Core metrology guides: result figures, ResampledSignalResult.plot() and real introductions (#364)
* Add ResampledSignalResult.plot(): the delivered anti-alias filter against its design spec
* Rewrite the multichannel guide intro: concrete use cases, per-channel guarantees, Bendat & Piersol citations
* Give the levels page a real introduction: descriptor families, when-to-use guidance and survey references
* Time weighting: framing intro with detector history, ANSI S1.4/Bies references and sibling links
* Calibration: proper introduction (SPL vs dBFS choice, workflow framing) with Bies reference and sibling links
* Add eleven core-metrology figures: resampling spec, cepstrum variants, liftering, correlation, IR alignment, Hilbert envelope, cross-spectra, Golay recovery, TSA noise law, runs test
* Test signals: anti-alias figure with dual snippet, res.plot() mention, See also, docs mirror sync
* Cepstrum guide: variants and liftering figures with dual snippets, complex-cepstrum plot mention
* Correlation guide: normalization, IR-alignment and Hilbert-envelope figures with dual snippets
* Spectral analysis: cross-spectral density and coherent-output-SNR figures with dual snippets
* System measurement: Golay exact-recovery figure and plot mentions for the inversion workflow
* Synchronous averaging: sqrt(N) figure, diagnostics-tool guidance, See also, recording naming
* Data qualification: runs-test figure with dual snippet and peak-statistics plot mention
* MISO coherence: conditioning-order snippet, practical pitfalls and See also across the three trees
* Time-frequency: Harris window reference and See also across the three trees
* GUM uncertainty: map the domain pages that consume the clause-5 machinery, expand See also
* Filter banks: compliance plot mentions and recording naming in the crossover snippet
* Changelog entry for the core-metrology documentation figures and prose
* Regenerate llms-full.txt for the core-metrology documentation
* Drop the duplicated phase-axis translation key
Core metrology guides: result figures, ResampledSignalResult.plot() and real introductions (#364)
* Add ResampledSignalResult.plot(): the delivered anti-alias filter against its design spec
* Rewrite the multichannel guide intro: concrete use cases, per-channel guarantees, Bendat & Piersol citations
* Give the levels page a real introduction: descriptor families, when-to-use guidance and survey references
* Time weighting: framing intro with detector history, ANSI S1.4/Bies references and sibling links
* Calibration: proper introduction (SPL vs dBFS choice, workflow framing) with Bies reference and sibling links
* Add eleven core-metrology figures: resampling spec, cepstrum variants, liftering, correlation, IR alignment, Hilbert envelope, cross-spectra, Golay recovery, TSA noise law, runs test
* Test signals: anti-alias figure with dual snippet, res.plot() mention, See also, docs mirror sync
* Cepstrum guide: variants and liftering figures with dual snippets, complex-cepstrum plot mention
* Correlation guide: normalization, IR-alignment and Hilbert-envelope figures with dual snippets
* Spectral analysis: cross-spectral density and coherent-output-SNR figures with dual snippets
* System measurement: Golay exact-recovery figure and plot mentions for the inversion workflow
* Synchronous averaging: sqrt(N) figure, diagnostics-tool guidance, See also, recording naming
* Data qualification: runs-test figure with dual snippet and peak-statistics plot mention
* MISO coherence: conditioning-order snippet, practical pitfalls and See also across the three trees
* Time-frequency: Harris window reference and See also across the three trees
* GUM uncertainty: map the domain pages that consume the clause-5 machinery, expand See also
* Filter banks: compliance plot mentions and recording naming in the crossover snippet
* Changelog entry for the core-metrology documentation figures and prose
* Regenerate llms-full.txt for the core-metrology documentation
* Drop the duplicated phase-axis translation key
Perception, hearing and speech guides: result figures and when-to-use prose (#361)
* Perception, hearing and speech guides: result figures and when-to-use prose
Add ToneAssessment.plot(), which draws an ECMA-418-1 tone against the
prominence criterion of its own method (recovered from criterion_db) over the
whole range of interest, with the deciding margin marked, and a
view="levels" option on ToneAudibilityResult.plot() that exposes the
level-versus-frequency view the ISO 1996-2 fiche already embedded.
Add eleven single-concept figures to the perception, hearing and speech
guides, each a realistic result drawn by its own .plot(): the tone prominence
verdict, the ISO/PAS 20065 tone levels, the ISO/PAS 1996-3 onset detection,
the ISO 532-2 specific loudness, the ECMA-418-2 specific tonality, the
specific fluctuation strength, the SII band audibility under a hearing loss,
the ISO 7029 fractile band, the ISO 1999 NIPTS audiogram, the STOI per-band
correlation and the IEC 60268-16 per-band MTI. Every figure is embedded in
the English guide, the Spanish mirror and the docs mirror with the dual
snippet block, and every plottable snippet on those pages now names its
.plot().
Prose: the tone-prominence guide gains a comparison of the four tonality
assessments the library implements and when each applies, the
hearing-threshold guide explains how the ISO 7029 fractiles feed the ISO 1999
age component and gains a See-also section, and the objective-intelligibility
guide gains the "which measure, and when" section that existed only in the
docs mirror, extended with the STOI/ESTOI, STI and SII choice.
Also label the STOI band axis at whole-hertz resolution and let the shaded
critical band of the tone-audibility levels plot follow the figure
background, so it reads on the white report page and on dark figures alike.
* Correct two figure alt texts against the plotted values
The ISO 7029 fractile figure describes the median and the 90 % fractile with
the values it actually draws (10 to 50 dB and 22 to 74 dB), and the
ECMA-418-2 specific tonality peak is at 9 Bark_HMS.
Perception, hearing and speech guides: result figures and when-to-use prose (#361)
* Perception, hearing and speech guides: result figures and when-to-use prose
Add ToneAssessment.plot(), which draws an ECMA-418-1 tone against the
prominence criterion of its own method (recovered from criterion_db) over the
whole range of interest, with the deciding margin marked, and a
view="levels" option on ToneAudibilityResult.plot() that exposes the
level-versus-frequency view the ISO 1996-2 fiche already embedded.
Add eleven single-concept figures to the perception, hearing and speech
guides, each a realistic result drawn by its own .plot(): the tone prominence
verdict, the ISO/PAS 20065 tone levels, the ISO/PAS 1996-3 onset detection,
the ISO 532-2 specific loudness, the ECMA-418-2 specific tonality, the
specific fluctuation strength, the SII band audibility under a hearing loss,
the ISO 7029 fractile band, the ISO 1999 NIPTS audiogram, the STOI per-band
correlation and the IEC 60268-16 per-band MTI. Every figure is embedded in
the English guide, the Spanish mirror and the docs mirror with the dual
snippet block, and every plottable snippet on those pages now names its
.plot().
Prose: the tone-prominence guide gains a comparison of the four tonality
assessments the library implements and when each applies, the
hearing-threshold guide explains how the ISO 7029 fractiles feed the ISO 1999
age component and gains a See-also section, and the objective-intelligibility
guide gains the "which measure, and when" section that existed only in the
docs mirror, extended with the STOI/ESTOI, STI and SII choice.
Also label the STOI band axis at whole-hertz resolution and let the shaded
critical band of the tone-audibility levels plot follow the figure
background, so it reads on the white report page and on dark figures alike.
* Correct two figure alt texts against the plotted values
The ISO 7029 fractile figure describes the median and the 90 % fractile with
the values it actually draws (10 to 50 dB and 22 to 74 dB), and the
ECMA-418-2 specific tonality peak is at 9 Bark_HMS.
Perception, hearing and speech guides: result figures and when-to-use prose (#361)
* Perception, hearing and speech guides: result figures and when-to-use prose
Add ToneAssessment.plot(), which draws an ECMA-418-1 tone against the
prominence criterion of its own method (recovered from criterion_db) over the
whole range of interest, with the deciding margin marked, and a
view="levels" option on ToneAudibilityResult.plot() that exposes the
level-versus-frequency view the ISO 1996-2 fiche already embedded.
Add eleven single-concept figures to the perception, hearing and speech
guides, each a realistic result drawn by its own .plot(): the tone prominence
verdict, the ISO/PAS 20065 tone levels, the ISO/PAS 1996-3 onset detection,
the ISO 532-2 specific loudness, the ECMA-418-2 specific tonality, the
specific fluctuation strength, the SII band audibility under a hearing loss,
the ISO 7029 fractile band, the ISO 1999 NIPTS audiogram, the STOI per-band
correlation and the IEC 60268-16 per-band MTI. Every figure is embedded in
the English guide, the Spanish mirror and the docs mirror with the dual
snippet block, and every plottable snippet on those pages now names its
.plot().
Prose: the tone-prominence guide gains a comparison of the four tonality
assessments the library implements and when each applies, the
hearing-threshold guide explains how the ISO 7029 fractiles feed the ISO 1999
age component and gains a See-also section, and the objective-intelligibility
guide gains the "which measure, and when" section that existed only in the
docs mirror, extended with the STOI/ESTOI, STI and SII choice.
Also label the STOI band axis at whole-hertz resolution and let the shaded
critical band of the tone-audibility levels plot follow the figure
background, so it reads on the white report page and on dark figures alike.
* Correct two figure alt texts against the plotted values
The ISO 7029 fractile figure describes the median and the 90 % fractile with
the values it actually draws (10 to 50 dB and 22 to 74 dB), and the
ECMA-418-2 specific tonality peak is at 9 Bark_HMS.
Perception, hearing and speech guides: result figures and when-to-use prose (#361)
* Perception, hearing and speech guides: result figures and when-to-use prose
Add ToneAssessment.plot(), which draws an ECMA-418-1 tone against the
prominence criterion of its own method (recovered from criterion_db) over the
whole range of interest, with the deciding margin marked, and a
view="levels" option on ToneAudibilityResult.plot() that exposes the
level-versus-frequency view the ISO 1996-2 fiche already embedded.
Add eleven single-concept figures to the perception, hearing and speech
guides, each a realistic result drawn by its own .plot(): the tone prominence
verdict, the ISO/PAS 20065 tone levels, the ISO/PAS 1996-3 onset detection,
the ISO 532-2 specific loudness, the ECMA-418-2 specific tonality, the
specific fluctuation strength, the SII band audibility under a hearing loss,
the ISO 7029 fractile band, the ISO 1999 NIPTS audiogram, the STOI per-band
correlation and the IEC 60268-16 per-band MTI. Every figure is embedded in
the English guide, the Spanish mirror and the docs mirror with the dual
snippet block, and every plottable snippet on those pages now names its
.plot().
Prose: the tone-prominence guide gains a comparison of the four tonality
assessments the library implements and when each applies, the
hearing-threshold guide explains how the ISO 7029 fractiles feed the ISO 1999
age component and gains a See-also section, and the objective-intelligibility
guide gains the "which measure, and when" section that existed only in the
docs mirror, extended with the STOI/ESTOI, STI and SII choice.
Also label the STOI band axis at whole-hertz resolution and let the shaded
critical band of the tone-audibility levels plot follow the figure
background, so it reads on the white report page and on dark figures alike.
* Correct two figure alt texts against the plotted values
The ISO 7029 fractile figure describes the median and the 90 % fractile with
the values it actually draws (10 to 50 dB and 22 to 74 dB), and the
ECMA-418-2 specific tonality peak is at 9 Bark_HMS.
Building and structure-borne guides: result figures, plot mentions and mirror sync (#360)
* Add .plot() to the ISO 717 enlarged-range rating results
ExtendedWeightedRatingResult and ExtendedImpactRatingResult now carry the
full enlarged-range band curve (band_centers, measured) and expose a
.plot() that draws the measured curve over the whole range against the
shifted ISO 717 reference on the 16 core bands, with the unfavourable
deviations shaded, the enlarged-range bands marked and every covered
Annex B / A.2.1 adaptation term in the title. EN/ES labels follow the
existing renderer conventions.
* Field insulation guide: enlarged-range, field-chain, facade and survey-impact figures
Four new deterministic figures (extended_insulation_rating,
field_airborne_insulation, facade_field_insulation,
survey_impact_insulation) generated in the four language/theme variants,
embedded next to their snippets in the EN guide, the ES mirror and the
docs mirror with the dual usage/hand-written code blocks. One-line
.plot() mentions added for the extended rating, the field airborne
result, the survey impact result and the ISO 12999-1 band uncertainty.
The docs mirror gains the previously missing ISO 10052 survey-reports
section, and the survey snippet now defines the li and l1_2m inputs it
uses. Multi-line figure info boxes are translated as whole artists, and
the review fixes (headroom, legend placement, proper unit and Greek
glyphs) are applied to the new generators.
* Laboratory insulation guide: ISO 10140, ISO 15186-1 element and ISO 10848 Dn,f figures
Embed the new lab_insulation_result, intensity_element_insulation and
flanking_level_difference figures next to their snippets in the EN guide,
the ES mirror and the docs mirror, each with the dual usage/hand-written
code blocks. Add the one-line .plot() mentions for the laboratory
airborne result, the element-normalized intensity result and the
floor-covering improvement result, and a note on when Dn,f plots (the
inline example uses 9 bands, below the 16/5-band rating threshold).
* EN 12354 prediction guide: impact-term and radiated-power figures
Embed the new impact_prediction_terms and radiated_power_outdoor figures
next to their snippets in the EN guide, the ES mirror and the docs
mirror, with the dual usage/hand-written code blocks, and add the
one-line .plot() mentions for the airborne prediction, the impact
prediction, the facade prediction and the radiated-power result.
* Panel insulation guide: rated Sharp prediction figure and plot mentions
Embed the new single_panel_rating figure (the 6 mm glass Sharp prediction
rated per ISO 717-1, coincidence dip marked) in the EN guide, the ES
mirror and the docs mirror with the dual code blocks, and add the
one-line .plot() mentions for the single-panel, double-wall and
radiation-efficiency results next to the existing concept figure.
* Junction transmission guide: Kij design chart, EN 12354 worked example and see-also
Add the junction_kij_thickness figure (wave-approach Kij versus the plate
thickness ratio for the X, T and L junctions, identical-plates value
marked) next to the coupling-loss-factor section, a res.plot() mention
in its snippet, a worked example that feeds the predicted K12 = 9.8 dB
of the 100/200 mm concrete X-junction into the EN 12354-1 flanking model
(R'w = 55.4 dB, direct path dominant), and a See-also section linking
the prediction, laboratory, structure-borne power and mobility guides.
EN guide, ES mirror and docs mirror in sync.
* Junction transmission docs mirror: sync the Kij chart, worked example and see-also
* Structure-borne power and installed-source guides: plot mentions, Hopkins citation and see-also
Add the one-line .plot() mentions for the reception-plate power result
(EN 15657) and the installed-source prediction (EN 12354-5) next to their
existing figures, add the one-line .plot() usage to both figures' code
blocks, cite Hopkins (2007) Section 2.8 for the point-excited-plate power
input behind the clause 4.4.3 coupling term with a prose paragraph
connecting the mobility chain, and give the EN 12354-5 page a proper
See-also linking the EN 15657, ISO 7626, junction and EN 12354 guides.
EN guides, ES mirrors and docs mirrors in sync.
* Vibration FRF guides: plot mentions and transfer-stiffness docs sync
Add the one-line .plot() usage and mentions for the ISO/TS 7849
sound-power-from-vibration result, the EN 29052-1 dynamic-stiffness
result and the ISO 10846 indirect transfer-stiffness result next to
their existing figures (EN guides, ES mirrors and docs mirrors), and
port the previously missing ISO 10846 test-report fiche section to the
transfer-stiffness docs mirror.
* Mechanical mobility guide: driving-point reading figure
Embed the new mobility_result_lines figure (|Y(f)| of the SDOF bundle
with the stiffness line, the mass line and the 1/c damping peak) next to
the MobilityResult snippet in the EN guide, the ES mirror and the docs
mirror, with the dual usage/hand-written code blocks and the one-line
res.plot() mention.
* Human vibration and multiple-shock guides: one-line plot mentions
Add the res.plot() one-liners next to the existing figures for the
ISO 8041-1 weighting response, the ISO 2631-1 weighted band spectrum, the
Directive 2002/44/EC daily exposure A(8) and the ISO 2631-5 multiple-shock
assessment, in the EN guides, the ES mirrors and the docs mirrors.
* Docs mirrors: restore missing report-fiche and concept sections
Sync the docs mirrors of the pages touched by this wave with their site
guides: the ISO 16283-3 facade report subsection on the field insulation
page, the EN 29052-1 and ISO 7626 fiche example snippets, and the panel
concept-figure code block.
* Changelog, API docs and llms regeneration; lint and typing fixes for the figure generators
* Fix nested emphasis in the survey-impact figure captions
* Restore the numerical-propagation rasters truncated by a mid-regeneration snapshot
* Reconcile the figure-script additions with the rooms and materials wave
* docs: regenerate the llms bundle after the figure-script reconciliation
Building and structure-borne guides: result figures, plot mentions and mirror sync (#360)
* Add .plot() to the ISO 717 enlarged-range rating results
ExtendedWeightedRatingResult and ExtendedImpactRatingResult now carry the
full enlarged-range band curve (band_centers, measured) and expose a
.plot() that draws the measured curve over the whole range against the
shifted ISO 717 reference on the 16 core bands, with the unfavourable
deviations shaded, the enlarged-range bands marked and every covered
Annex B / A.2.1 adaptation term in the title. EN/ES labels follow the
existing renderer conventions.
* Field insulation guide: enlarged-range, field-chain, facade and survey-impact figures
Four new deterministic figures (extended_insulation_rating,
field_airborne_insulation, facade_field_insulation,
survey_impact_insulation) generated in the four language/theme variants,
embedded next to their snippets in the EN guide, the ES mirror and the
docs mirror with the dual usage/hand-written code blocks. One-line
.plot() mentions added for the extended rating, the field airborne
result, the survey impact result and the ISO 12999-1 band uncertainty.
The docs mirror gains the previously missing ISO 10052 survey-reports
section, and the survey snippet now defines the li and l1_2m inputs it
uses. Multi-line figure info boxes are translated as whole artists, and
the review fixes (headroom, legend placement, proper unit and Greek
glyphs) are applied to the new generators.
* Laboratory insulation guide: ISO 10140, ISO 15186-1 element and ISO 10848 Dn,f figures
Embed the new lab_insulation_result, intensity_element_insulation and
flanking_level_difference figures next to their snippets in the EN guide,
the ES mirror and the docs mirror, each with the dual usage/hand-written
code blocks. Add the one-line .plot() mentions for the laboratory
airborne result, the element-normalized intensity result and the
floor-covering improvement result, and a note on when Dn,f plots (the
inline example uses 9 bands, below the 16/5-band rating threshold).
* EN 12354 prediction guide: impact-term and radiated-power figures
Embed the new impact_prediction_terms and radiated_power_outdoor figures
next to their snippets in the EN guide, the ES mirror and the docs
mirror, with the dual usage/hand-written code blocks, and add the
one-line .plot() mentions for the airborne prediction, the impact
prediction, the facade prediction and the radiated-power result.
* Panel insulation guide: rated Sharp prediction figure and plot mentions
Embed the new single_panel_rating figure (the 6 mm glass Sharp prediction
rated per ISO 717-1, coincidence dip marked) in the EN guide, the ES
mirror and the docs mirror with the dual code blocks, and add the
one-line .plot() mentions for the single-panel, double-wall and
radiation-efficiency results next to the existing concept figure.
* Junction transmission guide: Kij design chart, EN 12354 worked example and see-also
Add the junction_kij_thickness figure (wave-approach Kij versus the plate
thickness ratio for the X, T and L junctions, identical-plates value
marked) next to the coupling-loss-factor section, a res.plot() mention
in its snippet, a worked example that feeds the predicted K12 = 9.8 dB
of the 100/200 mm concrete X-junction into the EN 12354-1 flanking model
(R'w = 55.4 dB, direct path dominant), and a See-also section linking
the prediction, laboratory, structure-borne power and mobility guides.
EN guide, ES mirror and docs mirror in sync.
* Junction transmission docs mirror: sync the Kij chart, worked example and see-also
* Structure-borne power and installed-source guides: plot mentions, Hopkins citation and see-also
Add the one-line .plot() mentions for the reception-plate power result
(EN 15657) and the installed-source prediction (EN 12354-5) next to their
existing figures, add the one-line .plot() usage to both figures' code
blocks, cite Hopkins (2007) Section 2.8 for the point-excited-plate power
input behind the clause 4.4.3 coupling term with a prose paragraph
connecting the mobility chain, and give the EN 12354-5 page a proper
See-also linking the EN 15657, ISO 7626, junction and EN 12354 guides.
EN guides, ES mirrors and docs mirrors in sync.
* Vibration FRF guides: plot mentions and transfer-stiffness docs sync
Add the one-line .plot() usage and mentions for the ISO/TS 7849
sound-power-from-vibration result, the EN 29052-1 dynamic-stiffness
result and the ISO 10846 indirect transfer-stiffness result next to
their existing figures (EN guides, ES mirrors and docs mirrors), and
port the previously missing ISO 10846 test-report fiche section to the
transfer-stiffness docs mirror.
* Mechanical mobility guide: driving-point reading figure
Embed the new mobility_result_lines figure (|Y(f)| of the SDOF bundle
with the stiffness line, the mass line and the 1/c damping peak) next to
the MobilityResult snippet in the EN guide, the ES mirror and the docs
mirror, with the dual usage/hand-written code blocks and the one-line
res.plot() mention.
* Human vibration and multiple-shock guides: one-line plot mentions
Add the res.plot() one-liners next to the existing figures for the
ISO 8041-1 weighting response, the ISO 2631-1 weighted band spectrum, the
Directive 2002/44/EC daily exposure A(8) and the ISO 2631-5 multiple-shock
assessment, in the EN guides, the ES mirrors and the docs mirrors.
* Docs mirrors: restore missing report-fiche and concept sections
Sync the docs mirrors of the pages touched by this wave with their site
guides: the ISO 16283-3 facade report subsection on the field insulation
page, the EN 29052-1 and ISO 7626 fiche example snippets, and the panel
concept-figure code block.
* Changelog, API docs and llms regeneration; lint and typing fixes for the figure generators
* Fix nested emphasis in the survey-impact figure captions
* Restore the numerical-propagation rasters truncated by a mid-regeneration snapshot
* Reconcile the figure-script additions with the rooms and materials wave
* docs: regenerate the llms bundle after the figure-script reconciliation
Building and structure-borne guides: result figures, plot mentions and mirror sync (#360)
* Add .plot() to the ISO 717 enlarged-range rating results
ExtendedWeightedRatingResult and ExtendedImpactRatingResult now carry the
full enlarged-range band curve (band_centers, measured) and expose a
.plot() that draws the measured curve over the whole range against the
shifted ISO 717 reference on the 16 core bands, with the unfavourable
deviations shaded, the enlarged-range bands marked and every covered
Annex B / A.2.1 adaptation term in the title. EN/ES labels follow the
existing renderer conventions.
* Field insulation guide: enlarged-range, field-chain, facade and survey-impact figures
Four new deterministic figures (extended_insulation_rating,
field_airborne_insulation, facade_field_insulation,
survey_impact_insulation) generated in the four language/theme variants,
embedded next to their snippets in the EN guide, the ES mirror and the
docs mirror with the dual usage/hand-written code blocks. One-line
.plot() mentions added for the extended rating, the field airborne
result, the survey impact result and the ISO 12999-1 band uncertainty.
The docs mirror gains the previously missing ISO 10052 survey-reports
section, and the survey snippet now defines the li and l1_2m inputs it
uses. Multi-line figure info boxes are translated as whole artists, and
the review fixes (headroom, legend placement, proper unit and Greek
glyphs) are applied to the new generators.
* Laboratory insulation guide: ISO 10140, ISO 15186-1 element and ISO 10848 Dn,f figures
Embed the new lab_insulation_result, intensity_element_insulation and
flanking_level_difference figures next to their snippets in the EN guide,
the ES mirror and the docs mirror, each with the dual usage/hand-written
code blocks. Add the one-line .plot() mentions for the laboratory
airborne result, the element-normalized intensity result and the
floor-covering improvement result, and a note on when Dn,f plots (the
inline example uses 9 bands, below the 16/5-band rating threshold).
* EN 12354 prediction guide: impact-term and radiated-power figures
Embed the new impact_prediction_terms and radiated_power_outdoor figures
next to their snippets in the EN guide, the ES mirror and the docs
mirror, with the dual usage/hand-written code blocks, and add the
one-line .plot() mentions for the airborne prediction, the impact
prediction, the facade prediction and the radiated-power result.
* Panel insulation guide: rated Sharp prediction figure and plot mentions
Embed the new single_panel_rating figure (the 6 mm glass Sharp prediction
rated per ISO 717-1, coincidence dip marked) in the EN guide, the ES
mirror and the docs mirror with the dual code blocks, and add the
one-line .plot() mentions for the single-panel, double-wall and
radiation-efficiency results next to the existing concept figure.
* Junction transmission guide: Kij design chart, EN 12354 worked example and see-also
Add the junction_kij_thickness figure (wave-approach Kij versus the plate
thickness ratio for the X, T and L junctions, identical-plates value
marked) next to the coupling-loss-factor section, a res.plot() mention
in its snippet, a worked example that feeds the predicted K12 = 9.8 dB
of the 100/200 mm concrete X-junction into the EN 12354-1 flanking model
(R'w = 55.4 dB, direct path dominant), and a See-also section linking
the prediction, laboratory, structure-borne power and mobility guides.
EN guide, ES mirror and docs mirror in sync.
* Junction transmission docs mirror: sync the Kij chart, worked example and see-also
* Structure-borne power and installed-source guides: plot mentions, Hopkins citation and see-also
Add the one-line .plot() mentions for the reception-plate power result
(EN 15657) and the installed-source prediction (EN 12354-5) next to their
existing figures, add the one-line .plot() usage to both figures' code
blocks, cite Hopkins (2007) Section 2.8 for the point-excited-plate power
input behind the clause 4.4.3 coupling term with a prose paragraph
connecting the mobility chain, and give the EN 12354-5 page a proper
See-also linking the EN 15657, ISO 7626, junction and EN 12354 guides.
EN guides, ES mirrors and docs mirrors in sync.
* Vibration FRF guides: plot mentions and transfer-stiffness docs sync
Add the one-line .plot() usage and mentions for the ISO/TS 7849
sound-power-from-vibration result, the EN 29052-1 dynamic-stiffness
result and the ISO 10846 indirect transfer-stiffness result next to
their existing figures (EN guides, ES mirrors and docs mirrors), and
port the previously missing ISO 10846 test-report fiche section to the
transfer-stiffness docs mirror.
* Mechanical mobility guide: driving-point reading figure
Embed the new mobility_result_lines figure (|Y(f)| of the SDOF bundle
with the stiffness line, the mass line and the 1/c damping peak) next to
the MobilityResult snippet in the EN guide, the ES mirror and the docs
mirror, with the dual usage/hand-written code blocks and the one-line
res.plot() mention.
* Human vibration and multiple-shock guides: one-line plot mentions
Add the res.plot() one-liners next to the existing figures for the
ISO 8041-1 weighting response, the ISO 2631-1 weighted band spectrum, the
Directive 2002/44/EC daily exposure A(8) and the ISO 2631-5 multiple-shock
assessment, in the EN guides, the ES mirrors and the docs mirrors.
* Docs mirrors: restore missing report-fiche and concept sections
Sync the docs mirrors of the pages touched by this wave with their site
guides: the ISO 16283-3 facade report subsection on the field insulation
page, the EN 29052-1 and ISO 7626 fiche example snippets, and the panel
concept-figure code block.
* Changelog, API docs and llms regeneration; lint and typing fixes for the figure generators
* Fix nested emphasis in the survey-impact figure captions
* Restore the numerical-propagation rasters truncated by a mid-regeneration snapshot
* Reconcile the figure-script additions with the rooms and materials wave
* docs: regenerate the llms bundle after the figure-script reconciliation
Building and structure-borne guides: result figures, plot mentions and mirror sync (#360)
* Add .plot() to the ISO 717 enlarged-range rating results
ExtendedWeightedRatingResult and ExtendedImpactRatingResult now carry the
full enlarged-range band curve (band_centers, measured) and expose a
.plot() that draws the measured curve over the whole range against the
shifted ISO 717 reference on the 16 core bands, with the unfavourable
deviations shaded, the enlarged-range bands marked and every covered
Annex B / A.2.1 adaptation term in the title. EN/ES labels follow the
existing renderer conventions.
* Field insulation guide: enlarged-range, field-chain, facade and survey-impact figures
Four new deterministic figures (extended_insulation_rating,
field_airborne_insulation, facade_field_insulation,
survey_impact_insulation) generated in the four language/theme variants,
embedded next to their snippets in the EN guide, the ES mirror and the
docs mirror with the dual usage/hand-written code blocks. One-line
.plot() mentions added for the extended rating, the field airborne
result, the survey impact result and the ISO 12999-1 band uncertainty.
The docs mirror gains the previously missing ISO 10052 survey-reports
section, and the survey snippet now defines the li and l1_2m inputs it
uses. Multi-line figure info boxes are translated as whole artists, and
the review fixes (headroom, legend placement, proper unit and Greek
glyphs) are applied to the new generators.
* Laboratory insulation guide: ISO 10140, ISO 15186-1 element and ISO 10848 Dn,f figures
Embed the new lab_insulation_result, intensity_element_insulation and
flanking_level_difference figures next to their snippets in the EN guide,
the ES mirror and the docs mirror, each with the dual usage/hand-written
code blocks. Add the one-line .plot() mentions for the laboratory
airborne result, the element-normalized intensity result and the
floor-covering improvement result, and a note on when Dn,f plots (the
inline example uses 9 bands, below the 16/5-band rating threshold).
* EN 12354 prediction guide: impact-term and radiated-power figures
Embed the new impact_prediction_terms and radiated_power_outdoor figures
next to their snippets in the EN guide, the ES mirror and the docs
mirror, with the dual usage/hand-written code blocks, and add the
one-line .plot() mentions for the airborne prediction, the impact
prediction, the facade prediction and the radiated-power result.
* Panel insulation guide: rated Sharp prediction figure and plot mentions
Embed the new single_panel_rating figure (the 6 mm glass Sharp prediction
rated per ISO 717-1, coincidence dip marked) in the EN guide, the ES
mirror and the docs mirror with the dual code blocks, and add the
one-line .plot() mentions for the single-panel, double-wall and
radiation-efficiency results next to the existing concept figure.
* Junction transmission guide: Kij design chart, EN 12354 worked example and see-also
Add the junction_kij_thickness figure (wave-approach Kij versus the plate
thickness ratio for the X, T and L junctions, identical-plates value
marked) next to the coupling-loss-factor section, a res.plot() mention
in its snippet, a worked example that feeds the predicted K12 = 9.8 dB
of the 100/200 mm concrete X-junction into the EN 12354-1 flanking model
(R'w = 55.4 dB, direct path dominant), and a See-also section linking
the prediction, laboratory, structure-borne power and mobility guides.
EN guide, ES mirror and docs mirror in sync.
* Junction transmission docs mirror: sync the Kij chart, worked example and see-also
* Structure-borne power and installed-source guides: plot mentions, Hopkins citation and see-also
Add the one-line .plot() mentions for the reception-plate power result
(EN 15657) and the installed-source prediction (EN 12354-5) next to their
existing figures, add the one-line .plot() usage to both figures' code
blocks, cite Hopkins (2007) Section 2.8 for the point-excited-plate power
input behind the clause 4.4.3 coupling term with a prose paragraph
connecting the mobility chain, and give the EN 12354-5 page a proper
See-also linking the EN 15657, ISO 7626, junction and EN 12354 guides.
EN guides, ES mirrors and docs mirrors in sync.
* Vibration FRF guides: plot mentions and transfer-stiffness docs sync
Add the one-line .plot() usage and mentions for the ISO/TS 7849
sound-power-from-vibration result, the EN 29052-1 dynamic-stiffness
result and the ISO 10846 indirect transfer-stiffness result next to
their existing figures (EN guides, ES mirrors and docs mirrors), and
port the previously missing ISO 10846 test-report fiche section to the
transfer-stiffness docs mirror.
* Mechanical mobility guide: driving-point reading figure
Embed the new mobility_result_lines figure (|Y(f)| of the SDOF bundle
with the stiffness line, the mass line and the 1/c damping peak) next to
the MobilityResult snippet in the EN guide, the ES mirror and the docs
mirror, with the dual usage/hand-written code blocks and the one-line
res.plot() mention.
* Human vibration and multiple-shock guides: one-line plot mentions
Add the res.plot() one-liners next to the existing figures for the
ISO 8041-1 weighting response, the ISO 2631-1 weighted band spectrum, the
Directive 2002/44/EC daily exposure A(8) and the ISO 2631-5 multiple-shock
assessment, in the EN guides, the ES mirrors and the docs mirrors.
* Docs mirrors: restore missing report-fiche and concept sections
Sync the docs mirrors of the pages touched by this wave with their site
guides: the ISO 16283-3 facade report subsection on the field insulation
page, the EN 29052-1 and ISO 7626 fiche example snippets, and the panel
concept-figure code block.
* Changelog, API docs and llms regeneration; lint and typing fixes for the figure generators
* Fix nested emphasis in the survey-impact figure captions
* Restore the numerical-propagation rasters truncated by a mid-regeneration snapshot
* Reconcile the figure-script additions with the rooms and materials wave
* docs: regenerate the llms bundle after the figure-script reconciliation
Correct the slit-radiation sign in the slow-sound absorber and generalize the diffuser obliquity factor (#349)
* Fix slit-radiation sign, generalize Kirchhoff obliquity, record paper errata
The slit-to-free-air radiation correction of the slow-sound absorber was
transcribed with the papers' printed -iw sign, which in the e^{+jwt}
convention of the library acts as a negative mass and raises the slit-panel
resonance (378.6 to 386.8 Hz for the documented base geometry) where an
added radiation mass must lower it (370.8 Hz). The term is now conjugated
like the Stinson duct series of the same model, with the direction and the
shifted peak pinned by a regression test, and both source misprints (the
sign and the 4-vs-64 duct-series constant) are recorded in the errata
registry. The committed slow-sound figures are regenerated; the
critical-coupling design they show self-compensates to alpha = 1, but the
solved cavity length moves from 48.3 mm to 44.7 mm.
The diffuser far-field predictor now uses the symmetric Kirchhoff obliquity
factor (cos theta + cos psi)/2 for oblique sources, which reduces exactly
to the Cox and D'Antonio Eq. (9.32) normal-incidence form at psi = 0, so
all normal-incidence anchors are unchanged.
Also: the EN 29052-1 low-resistivity warning now echoes the clause 8.2
requirement to state the estimated error in the test report, and the
ISO 9053-2 volume-flow helper documents the normative 6.2 form against the
Annex A.2 rms variant.
* Update the porous-absorbers misprint count for the new errata entries
The page's sources now have five recorded misprints (Maa Eq. (5b), two in
Attenborough & Van Renterghem 2e, and the two Jimenez et al. entries); the
English and Spanish guides are kept in step.
Correct the slit-radiation sign in the slow-sound absorber and generalize the diffuser obliquity factor (#349)
* Fix slit-radiation sign, generalize Kirchhoff obliquity, record paper errata
The slit-to-free-air radiation correction of the slow-sound absorber was
transcribed with the papers' printed -iw sign, which in the e^{+jwt}
convention of the library acts as a negative mass and raises the slit-panel
resonance (378.6 to 386.8 Hz for the documented base geometry) where an
added radiation mass must lower it (370.8 Hz). The term is now conjugated
like the Stinson duct series of the same model, with the direction and the
shifted peak pinned by a regression test, and both source misprints (the
sign and the 4-vs-64 duct-series constant) are recorded in the errata
registry. The committed slow-sound figures are regenerated; the
critical-coupling design they show self-compensates to alpha = 1, but the
solved cavity length moves from 48.3 mm to 44.7 mm.
The diffuser far-field predictor now uses the symmetric Kirchhoff obliquity
factor (cos theta + cos psi)/2 for oblique sources, which reduces exactly
to the Cox and D'Antonio Eq. (9.32) normal-incidence form at psi = 0, so
all normal-incidence anchors are unchanged.
Also: the EN 29052-1 low-resistivity warning now echoes the clause 8.2
requirement to state the estimated error in the test report, and the
ISO 9053-2 volume-flow helper documents the normative 6.2 form against the
Annex A.2 rms variant.
* Update the porous-absorbers misprint count for the new errata entries
The page's sources now have five recorded misprints (Maa Eq. (5b), two in
Attenborough & Van Renterghem 2e, and the two Jimenez et al. entries); the
English and Spanish guides are kept in step.
Spanish docs: UNE terminology, decimal commas, localized snippets and theory figures (#365)
* Normalize Spanish docs prose to UNE acoustic terminology
Sweep the Spanish pages for the non-UNE forms "presion sonora",
"potencia sonora" and "intensidad sonora" and normalize the prose to
the wording used by the official Spanish editions of the standards:
"presion acustica" (UNE-EN ISO 16283-2:2016, UNE-EN ISO 10052:2005,
UNE-EN ISO 3746:2011, UNE-ISO 226:2013), "potencia acustica"
(UNE-EN ISO 3746:2011, UNE-EN ISO 4871:2010, UNE-EN ISO 9614-1:2010),
"intensidad acustica" (UNE-EN 61043:1999, UNE-EN ISO 9614-1:2010) and
"nivel de presion acustica de impactos" (UNE-EN ISO 12354-2:2018,
UNE-EN ISO 717-2:2013). 92 replacements across 32 pages, prose only:
code snippets keep the labels they share with the generated figures.
Rename the intensity guide to "Intensidad acustica (p-p)" and the
structure-borne power guide to "Potencia acustica estructural de
equipos (EN 15657)", updating every cross-link text and the theory
anchor intensidad-sonora-iec-61043 accordingly. The API sidebar group
label becomes "Potencia acustica e intensidad" via api_taxonomy.py
with the generated sidebar regenerated.
* Use decimal commas in Spanish docs prose quantities
Sweep every Spanish page for decimal points leaking into prose numbers
and switch them to the comma the locale convention calls for: the
rotorcraft validation prose (fourteen tolerances such as 0,08 dB(A) and
0,5 s), the insulation-prediction worked example (53,6 dB / 53,8 dB),
the tone-audibility Annex E tone (137,3 Hz), the Mackenzie check value
(1550,744 m/s), the EPNL, loudness and absorption fiche descriptions
(98,3 EPNdB; 8,2 sonos and 70,4 fonios; 0,60 y 0,55), the junction
constants table and the third-octave band-edge table in the signal
analysis theory page. Code snippets, inline code, math, clause numbers
and quoted source text keep their points.
* Pass language="es" in Spanish figure-reproduction snippets
The <details> blocks under each localized figure in the Spanish guides
are meant to reproduce the _es variant shown on the page, but 82 of the
one-line result .plot() calls omitted the language="es" argument and
would render English axis labels instead. Add the argument across 33
guides, matching the pattern the intensity field-indicators snippet
already used. The three lab-insulation results whose plot() does not
take a language argument (lab airborne, lab impact and the
element-normalized intensity difference) are left as they were.
* Extend the UNE terminology sweep to sound absorption
Normalize "absorción sonora" to "absorción acústica" across the
Spanish pages (36 occurrences in 14 pages, including the EN 12354-6
guide title and the theory headings), the wording of UNE-EN ISO
3746:2011 and of the equivalent absorption area in UNE-EN ISO
10140-3:2011, UNE-EN ISO 12354-2:2018 and UNE-EN ISO 16283-2:2016, and
the same term the accredited report strings already use. Also restore
the accent in the theory index anchor to the renamed intensity heading,
since heading slugs keep accented characters.
* Theory pages: illustrate each section family with existing result figures
The seven theory pages carried no figures at all. Embed sixteen of the
existing generated figures (light and dark variants, Spanish variants on
the Spanish mirrors) where the concept matches the prose: weighting
curves, time integration and the p-p intensity estimator in the signal
analysis page; equal-loudness contours, the specific-loudness pattern
and the hearing-threshold panels in perception; NC/RC rating, the
Schroeder decay and the ISO 717-1 shifted reference in rooms and
buildings; the Lden profile, ISO 9613-1 absorption and the three sound
power routes in environment and transport; the scattering coefficient
and ISO 11654 rating in materials and surfaces; and the Wk weighting and
the resonator mobility triplet in vibration. Each embed reuses the alt
text of the guide that owns the figure and adds a one-line caption.
Also give the wave-simulation section hub the reading-order paragraph
its siblings already have, linking the closed-form pages the FDTD solver
cross-checks, in both languages.
* Address review findings from the Spanish locale sweeps
Second pass fixes flagged by review: five terminology occurrences the
line-based sweep missed because the noun and adjective were split by a
line wrap or emphasis markup (sound-power, rotorcraft-noise and two
section hubs); six Spanish pages that still embedded the English figure
variant although the _es variant exists (junction-transmission,
aircraft-noise airport contour, miso-coherence,
objective-intelligibility, psychoacoustic-annoyance twice); and 19 more
language="es" arguments on figure-reproduction plot calls the first
pass missed, chained-call receivers such as room.noise_criterion(spl)
.plot() and the axes-creating first call of the two-profile
atmospheric-refraction snippet among them. The lab-insulation plot
wrappers forward keyword arguments to the rating plot, so the three
calls excluded earlier now take the argument too. All Spanish python
fences re-checked to compile and EN/ES parity re-verified.
* Carry the UNE terminology into the generated-asset Spanish strings
Apply the same evidence-based decisions to every Spanish string source
that feeds generated assets: the translation tables of
generate_graphs.py and generate_diagrams.py, the _STRINGS tables of the
plot modules and the report i18n values. 35 strings change: "presión
acústica" (UNE-EN ISO 16283-2:2016, 10052:2005, 3746:2011),
"potencia acústica" (UNE-EN ISO 3746:2011, 4871:2010, 9614-1:2010),
"intensidad acústica" (UNE-EN 61043:1999, 9614-1:2010), "absorción
acústica" (UNE-EN ISO 3746:2011) and "nivel de presión acústica de
impactos" (UNE-EN ISO 12354-2:2018). Strings the UNE editions keep are
untouched: "emisión sonora", "exposición sonora", "campo sonoro",
"fuente sonora". Only Spanish values change; the English keys stay.
The two plot-i18n test assertions that pin the axis label follow, and
the eight Spanish doc fences that deliberately mirrored the old figure
labels now mirror the new ones.
* Regenerate the Spanish figure variants with the UNE terminology
make graphs after the string-source change: 48 files, all of them _es
or _es_dark variants (24 figure/diagram pairs), picking up "presión
acústica", "potencia acústica", "intensidad acústica", "absorción
acústica" and "nivel de presión acústica de impactos" in titles and
axis labels. The English variants are untouched. The committed example
fiches need no regeneration: every example in generate_reports.py
renders in English, so no changed Spanish report string reaches them.
* Align the intensity-fiche Spanish assertions with the UNE terminology
Spanish docs: UNE terminology, decimal commas, localized snippets and theory figures (#365)
* Normalize Spanish docs prose to UNE acoustic terminology
Sweep the Spanish pages for the non-UNE forms "presion sonora",
"potencia sonora" and "intensidad sonora" and normalize the prose to
the wording used by the official Spanish editions of the standards:
"presion acustica" (UNE-EN ISO 16283-2:2016, UNE-EN ISO 10052:2005,
UNE-EN ISO 3746:2011, UNE-ISO 226:2013), "potencia acustica"
(UNE-EN ISO 3746:2011, UNE-EN ISO 4871:2010, UNE-EN ISO 9614-1:2010),
"intensidad acustica" (UNE-EN 61043:1999, UNE-EN ISO 9614-1:2010) and
"nivel de presion acustica de impactos" (UNE-EN ISO 12354-2:2018,
UNE-EN ISO 717-2:2013). 92 replacements across 32 pages, prose only:
code snippets keep the labels they share with the generated figures.
Rename the intensity guide to "Intensidad acustica (p-p)" and the
structure-borne power guide to "Potencia acustica estructural de
equipos (EN 15657)", updating every cross-link text and the theory
anchor intensidad-sonora-iec-61043 accordingly. The API sidebar group
label becomes "Potencia acustica e intensidad" via api_taxonomy.py
with the generated sidebar regenerated.
* Use decimal commas in Spanish docs prose quantities
Sweep every Spanish page for decimal points leaking into prose numbers
and switch them to the comma the locale convention calls for: the
rotorcraft validation prose (fourteen tolerances such as 0,08 dB(A) and
0,5 s), the insulation-prediction worked example (53,6 dB / 53,8 dB),
the tone-audibility Annex E tone (137,3 Hz), the Mackenzie check value
(1550,744 m/s), the EPNL, loudness and absorption fiche descriptions
(98,3 EPNdB; 8,2 sonos and 70,4 fonios; 0,60 y 0,55), the junction
constants table and the third-octave band-edge table in the signal
analysis theory page. Code snippets, inline code, math, clause numbers
and quoted source text keep their points.
* Pass language="es" in Spanish figure-reproduction snippets
The <details> blocks under each localized figure in the Spanish guides
are meant to reproduce the _es variant shown on the page, but 82 of the
one-line result .plot() calls omitted the language="es" argument and
would render English axis labels instead. Add the argument across 33
guides, matching the pattern the intensity field-indicators snippet
already used. The three lab-insulation results whose plot() does not
take a language argument (lab airborne, lab impact and the
element-normalized intensity difference) are left as they were.
* Extend the UNE terminology sweep to sound absorption
Normalize "absorción sonora" to "absorción acústica" across the
Spanish pages (36 occurrences in 14 pages, including the EN 12354-6
guide title and the theory headings), the wording of UNE-EN ISO
3746:2011 and of the equivalent absorption area in UNE-EN ISO
10140-3:2011, UNE-EN ISO 12354-2:2018 and UNE-EN ISO 16283-2:2016, and
the same term the accredited report strings already use. Also restore
the accent in the theory index anchor to the renamed intensity heading,
since heading slugs keep accented characters.
* Theory pages: illustrate each section family with existing result figures
The seven theory pages carried no figures at all. Embed sixteen of the
existing generated figures (light and dark variants, Spanish variants on
the Spanish mirrors) where the concept matches the prose: weighting
curves, time integration and the p-p intensity estimator in the signal
analysis page; equal-loudness contours, the specific-loudness pattern
and the hearing-threshold panels in perception; NC/RC rating, the
Schroeder decay and the ISO 717-1 shifted reference in rooms and
buildings; the Lden profile, ISO 9613-1 absorption and the three sound
power routes in environment and transport; the scattering coefficient
and ISO 11654 rating in materials and surfaces; and the Wk weighting and
the resonator mobility triplet in vibration. Each embed reuses the alt
text of the guide that owns the figure and adds a one-line caption.
Also give the wave-simulation section hub the reading-order paragraph
its siblings already have, linking the closed-form pages the FDTD solver
cross-checks, in both languages.
* Address review findings from the Spanish locale sweeps
Second pass fixes flagged by review: five terminology occurrences the
line-based sweep missed because the noun and adjective were split by a
line wrap or emphasis markup (sound-power, rotorcraft-noise and two
section hubs); six Spanish pages that still embedded the English figure
variant although the _es variant exists (junction-transmission,
aircraft-noise airport contour, miso-coherence,
objective-intelligibility, psychoacoustic-annoyance twice); and 19 more
language="es" arguments on figure-reproduction plot calls the first
pass missed, chained-call receivers such as room.noise_criterion(spl)
.plot() and the axes-creating first call of the two-profile
atmospheric-refraction snippet among them. The lab-insulation plot
wrappers forward keyword arguments to the rating plot, so the three
calls excluded earlier now take the argument too. All Spanish python
fences re-checked to compile and EN/ES parity re-verified.
* Carry the UNE terminology into the generated-asset Spanish strings
Apply the same evidence-based decisions to every Spanish string source
that feeds generated assets: the translation tables of
generate_graphs.py and generate_diagrams.py, the _STRINGS tables of the
plot modules and the report i18n values. 35 strings change: "presión
acústica" (UNE-EN ISO 16283-2:2016, 10052:2005, 3746:2011),
"potencia acústica" (UNE-EN ISO 3746:2011, 4871:2010, 9614-1:2010),
"intensidad acústica" (UNE-EN 61043:1999, 9614-1:2010), "absorción
acústica" (UNE-EN ISO 3746:2011) and "nivel de presión acústica de
impactos" (UNE-EN ISO 12354-2:2018). Strings the UNE editions keep are
untouched: "emisión sonora", "exposición sonora", "campo sonoro",
"fuente sonora". Only Spanish values change; the English keys stay.
The two plot-i18n test assertions that pin the axis label follow, and
the eight Spanish doc fences that deliberately mirrored the old figure
labels now mirror the new ones.
* Regenerate the Spanish figure variants with the UNE terminology
make graphs after the string-source change: 48 files, all of them _es
or _es_dark variants (24 figure/diagram pairs), picking up "presión
acústica", "potencia acústica", "intensidad acústica", "absorción
acústica" and "nivel de presión acústica de impactos" in titles and
axis labels. The English variants are untouched. The committed example
fiches need no regeneration: every example in generate_reports.py
renders in English, so no changed Spanish report string reaches them.
* Align the intensity-fiche Spanish assertions with the UNE terminology
Perception, hearing and speech guides: result figures and when-to-use prose (#361)
* Perception, hearing and speech guides: result figures and when-to-use prose
Add ToneAssessment.plot(), which draws an ECMA-418-1 tone against the
prominence criterion of its own method (recovered from criterion_db) over the
whole range of interest, with the deciding margin marked, and a
view="levels" option on ToneAudibilityResult.plot() that exposes the
level-versus-frequency view the ISO 1996-2 fiche already embedded.
Add eleven single-concept figures to the perception, hearing and speech
guides, each a realistic result drawn by its own .plot(): the tone prominence
verdict, the ISO/PAS 20065 tone levels, the ISO/PAS 1996-3 onset detection,
the ISO 532-2 specific loudness, the ECMA-418-2 specific tonality, the
specific fluctuation strength, the SII band audibility under a hearing loss,
the ISO 7029 fractile band, the ISO 1999 NIPTS audiogram, the STOI per-band
correlation and the IEC 60268-16 per-band MTI. Every figure is embedded in
the English guide, the Spanish mirror and the docs mirror with the dual
snippet block, and every plottable snippet on those pages now names its
.plot().
Prose: the tone-prominence guide gains a comparison of the four tonality
assessments the library implements and when each applies, the
hearing-threshold guide explains how the ISO 7029 fractiles feed the ISO 1999
age component and gains a See-also section, and the objective-intelligibility
guide gains the "which measure, and when" section that existed only in the
docs mirror, extended with the STOI/ESTOI, STI and SII choice.
Also label the STOI band axis at whole-hertz resolution and let the shaded
critical band of the tone-audibility levels plot follow the figure
background, so it reads on the white report page and on dark figures alike.
* Correct two figure alt texts against the plotted values
The ISO 7029 fractile figure describes the median and the 90 % fractile with
the values it actually draws (10 to 50 dB and 22 to 74 dB), and the
ECMA-418-2 specific tonality peak is at 9 Bark_HMS.
Perception, hearing and speech guides: result figures and when-to-use prose (#361)
* Perception, hearing and speech guides: result figures and when-to-use prose
Add ToneAssessment.plot(), which draws an ECMA-418-1 tone against the
prominence criterion of its own method (recovered from criterion_db) over the
whole range of interest, with the deciding margin marked, and a
view="levels" option on ToneAudibilityResult.plot() that exposes the
level-versus-frequency view the ISO 1996-2 fiche already embedded.
Add eleven single-concept figures to the perception, hearing and speech
guides, each a realistic result drawn by its own .plot(): the tone prominence
verdict, the ISO/PAS 20065 tone levels, the ISO/PAS 1996-3 onset detection,
the ISO 532-2 specific loudness, the ECMA-418-2 specific tonality, the
specific fluctuation strength, the SII band audibility under a hearing loss,
the ISO 7029 fractile band, the ISO 1999 NIPTS audiogram, the STOI per-band
correlation and the IEC 60268-16 per-band MTI. Every figure is embedded in
the English guide, the Spanish mirror and the docs mirror with the dual
snippet block, and every plottable snippet on those pages now names its
.plot().
Prose: the tone-prominence guide gains a comparison of the four tonality
assessments the library implements and when each applies, the
hearing-threshold guide explains how the ISO 7029 fractiles feed the ISO 1999
age component and gains a See-also section, and the objective-intelligibility
guide gains the "which measure, and when" section that existed only in the
docs mirror, extended with the STOI/ESTOI, STI and SII choice.
Also label the STOI band axis at whole-hertz resolution and let the shaded
critical band of the tone-audibility levels plot follow the figure
background, so it reads on the white report page and on dark figures alike.
* Correct two figure alt texts against the plotted values
The ISO 7029 fractile figure describes the median and the 90 % fractile with
the values it actually draws (10 to 50 dB and 22 to 74 dB), and the
ECMA-418-2 specific tonality peak is at 9 Bark_HMS.
Perception, hearing and speech guides: result figures and when-to-use prose (#361)
* Perception, hearing and speech guides: result figures and when-to-use prose
Add ToneAssessment.plot(), which draws an ECMA-418-1 tone against the
prominence criterion of its own method (recovered from criterion_db) over the
whole range of interest, with the deciding margin marked, and a
view="levels" option on ToneAudibilityResult.plot() that exposes the
level-versus-frequency view the ISO 1996-2 fiche already embedded.
Add eleven single-concept figures to the perception, hearing and speech
guides, each a realistic result drawn by its own .plot(): the tone prominence
verdict, the ISO/PAS 20065 tone levels, the ISO/PAS 1996-3 onset detection,
the ISO 532-2 specific loudness, the ECMA-418-2 specific tonality, the
specific fluctuation strength, the SII band audibility under a hearing loss,
the ISO 7029 fractile band, the ISO 1999 NIPTS audiogram, the STOI per-band
correlation and the IEC 60268-16 per-band MTI. Every figure is embedded in
the English guide, the Spanish mirror and the docs mirror with the dual
snippet block, and every plottable snippet on those pages now names its
.plot().
Prose: the tone-prominence guide gains a comparison of the four tonality
assessments the library implements and when each applies, the
hearing-threshold guide explains how the ISO 7029 fractiles feed the ISO 1999
age component and gains a See-also section, and the objective-intelligibility
guide gains the "which measure, and when" section that existed only in the
docs mirror, extended with the STOI/ESTOI, STI and SII choice.
Also label the STOI band axis at whole-hertz resolution and let the shaded
critical band of the tone-audibility levels plot follow the figure
background, so it reads on the white report page and on dark figures alike.
* Correct two figure alt texts against the plotted values
The ISO 7029 fractile figure describes the median and the 90 % fractile with
the values it actually draws (10 to 50 dB and 22 to 74 dB), and the
ECMA-418-2 specific tonality peak is at 9 Bark_HMS.
Perception, hearing and speech guides: result figures and when-to-use prose (#361)
* Perception, hearing and speech guides: result figures and when-to-use prose
Add ToneAssessment.plot(), which draws an ECMA-418-1 tone against the
prominence criterion of its own method (recovered from criterion_db) over the
whole range of interest, with the deciding margin marked, and a
view="levels" option on ToneAudibilityResult.plot() that exposes the
level-versus-frequency view the ISO 1996-2 fiche already embedded.
Add eleven single-concept figures to the perception, hearing and speech
guides, each a realistic result drawn by its own .plot(): the tone prominence
verdict, the ISO/PAS 20065 tone levels, the ISO/PAS 1996-3 onset detection,
the ISO 532-2 specific loudness, the ECMA-418-2 specific tonality, the
specific fluctuation strength, the SII band audibility under a hearing loss,
the ISO 7029 fractile band, the ISO 1999 NIPTS audiogram, the STOI per-band
correlation and the IEC 60268-16 per-band MTI. Every figure is embedded in
the English guide, the Spanish mirror and the docs mirror with the dual
snippet block, and every plottable snippet on those pages now names its
.plot().
Prose: the tone-prominence guide gains a comparison of the four tonality
assessments the library implements and when each applies, the
hearing-threshold guide explains how the ISO 7029 fractiles feed the ISO 1999
age component and gains a See-also section, and the objective-intelligibility
guide gains the "which measure, and when" section that existed only in the
docs mirror, extended with the STOI/ESTOI, STI and SII choice.
Also label the STOI band axis at whole-hertz resolution and let the shaded
critical band of the tone-audibility levels plot follow the figure
background, so it reads on the white report page and on dark figures alike.
* Correct two figure alt texts against the plotted values
The ISO 7029 fractile figure describes the median and the 90 % fractile with
the values it actually draws (10 to 50 dB and 22 to 74 dB), and the
ECMA-418-2 specific tonality peak is at 9 Bark_HMS.
Sound power determination and building acoustics II: ISO 3744/3746, ISO 3741, ISO 9614-2, ISO 16283-2 + ISO 717-2, ISO 354 (#84)
* feat: ISO 3744/3746 sound power from pressure measurements
Add sound_power.py: sound power level of a noise source from sound
pressure levels over an enveloping measurement surface, ISO 3744:2010
(engineering, grade 2) and ISO 3746:2010 (survey, grade 3).
- sound_power_pressure(): per-band LW and A-weighted LWA from an
(NM, NB) level array over a hemisphere (radius) or parallelepiped
(dimensions + distance); surface area from the standard's closed forms
for 1/2/3 reflecting planes; energy average (Eq. 12), background K1
(Eq. 16), environmental K2 (Eq. A.2), apparent directivity index
(Eq. 7), expanded uncertainty.
- measurement_positions(): normative Annex B coordinates
(Tables B.1/B.2/B.3), grade- and plane-dependent subsets.
- background_noise_correction(): K1 with engineering/survey criteria.
- environmental_correction(): K2 from A, Sabine T+V, or alpha*Sv.
- SoundPowerResult (frozen dataclass), SoundPowerWarning.
Tests: 24 cases incl. monopole-over-plane exact LW recovery, radius
independence, K1/K2 closed forms, LWA via Annex E, and validations.
make check green (543 passed, 12 skipped); ruff/bandit/mypy --strict clean.
Claude-Session: https://claude.ai/code/session_013kkVt3nxi9svp1an28uHxf
* fix: directivity index under background correction, citation hygiene
Broadband K1 for the apparent directivity index was collapsing to the
surface-area term 10*lg(S/S0) (~+22 dB inflation with background
correction). Compute the true energy-based broadband K1 (per-band Eq. 16
aggregated over bands) so DI is correct in both paths.
Also: multi-band sound_power_level_a without frequencies now returns NaN
(A-weighting needs band centres); dropped PDF page-number citations from
Annex B/E table comments; corrected the survey parallelepiped position
citation to ISO 3746 clause C.1 / Figure C.7.
Claude-Session: https://claude.ai/code/session_013kkVt3nxi9svp1an28uHxf
* feat: ISO 3741 reverberation-room sound power
Add the ISO 3741:2010 precision (grade 1) methods for determining sound
power in a reverberation test room, in a new sound_power_reverberation
module:
- sound_power_reverberation() — direct method (Eq. 20): LW from the mean
room SPL and the Sabine equivalent absorption area A = (55,26/c)(V/T60),
with the full normative bracket: 10 lg(A/A0), 4,34*(A/S), the Waterhouse
boundary term 10 lg(1 + S c/(8 V f)), the reference-quantity (C1) and
radiation-impedance (C2) meteorological corrections and the -6 dB
constant. Speed of sound c = 20,05*sqrt(273 + theta).
- sound_power_comparison() — comparison method (Eq. 21) with a reference
sound source: LW = LW(RSS) + (Lp(ST) - Lp(RSS) + C2).
- ReverberationSoundPowerResult frozen dataclass; frequency-dependent
background correction K1 (Eq. 14, same formula as ISO 3744) with the
precision-grade 6/10 dB criteria; A-weighted total via Annex F.
Reuses the ISO 3744 energy-average and A-weighting helpers. Tests cover
exact inversion of Eq. (20), the Waterhouse term vanishing at high
frequency, the comparison method exact by construction, and synergy with
room_parameters T30 feeding the direct method.
Claude-Session: https://claude.ai/code/session_013kkVt3nxi9svp1an28uHxf
* fix: ISO 3741 room-qualification advisories and validation ordering
Claude-Session: https://claude.ai/code/session_013kkVt3nxi9svp1an28uHxf
* feat: ISO 9614-2 sound power by intensity scanning
Add sound_power_intensity() computing per-band LW = 10lg(sum Pi/P0) from
per-segment signed normal intensity and areas (partial power Pi = <In,i>*Si),
the scanning-method field indicators FpI (Eq. A.1) and F+/- (Eq. A.2), the
repeatability criterion 3, and the achieved engineering/survey grade per band
(Annex B criteria 1-3). Negative total power flags bands as non-determinable
(clause 9.2); negative partial power raises SoundPowerWarning. Reuses
dynamic_capability_index for Ld = dpI0 - K (Table 1).
Claude-Session: https://claude.ai/code/session_013kkVt3nxi9svp1an28uHxf
* feat: ISO 16283-2 impact sound insulation and ISO 717-2 ratings
Add field impact sound insulation (ISO 16283-2, tapping machine) and the
ISO 717-2 single-number weighted impact rating with the CI spectrum
adaptation term, reusing the verified reference-curve shift engine.
- impact_insulation(li, t2, *, volume=None, t0=0.5): per-band
L'nT = Li - 10 lg(T/T0) (Formula (1)) and L'n = Li + 10 lg(A/A0) with
A = 0,16 V/T, A0 = 10 m2 (Formula (2)); positions energy-averaged.
- weighted_impact_rating(values_by_band, bands=None): Ln,w / L'n,w /
L'nT,w (Clause 4.3, octave -5 dB rule) and CI (Clause A.2.1, energetic
sum 100-2500 / 125-2000). Impact unfavourable deviations (measurement
exceeds reference, sign opposite to airborne) reduce to the airborne
search on negated curves, so _best_shift is reused verbatim.
- _best_shift: tolerance absorbs float noise at the exact bound (sums are
true multiples of 0,1 dB); airborne behaviour unchanged.
Verified against ISO 717-2 Annex C worked examples (Table C.1 Ln,w=79,
CI=-11; Table C.3 octave Ln,w=54, CI=0) and an independent brute-force
shift search on 10 000 random curves per band set. 2013 and 2020 editions
are identical for all implemented maths (2020 only adds Annex D rubber
ball, out of scope).
Claude-Session: https://claude.ai/code/session_013kkVt3nxi9svp1an28uHxf
* feat: ISO 354 sound absorption in a reverberation room
Add phonometry.sound_absorption implementing BS EN ISO 354:2003:
- absorption_area(t60, volume, ...): equivalent sound absorption area
A = 55,3*V/(c*T) - 4*V*m (Eq. 5/7), speed of sound from Eq. (6).
- absorption_coefficient(t1, t2, volume, sample_area, ...): alpha_s =
(A2-A1)/S built from Eq. (8)/(9), per-measurement c1/c2, unclamped
(alpha_s > 1 valid, clause 3.7 NOTE 2); warns when T2 >= T1.
- attenuation_from_alpha: ISO-354 conversion m = alpha/(10 lg e) from an
ISO 9613-1 attenuation coefficient (m deferred to ISO 9613-1, default 0).
Composes directly with room_parameters() T20/T30 outputs. 25 tests
(exact T->A->T inversion, synthetic-alpha recovery, zero-m air term,
two-temperature Eq. (8), range validation, room_parameters synergy).
Claude-Session: https://claude.ai/code/session_013kkVt3nxi9svp1an28uHxf
* fix: ISO 354 room and sample-size advisories
Add advisory AbsorptionWarning (never raising; result still returned) for
setup conditions outside ISO 354:2003 limits:
- Room volume below the 150 m3 minimum of clause 6.1.1, in both
absorption_area and absorption_coefficient.
- Sample area outside the clause 6.2.1.1 range 10 <= S <= 12 m2, with the
upper limit scaled by (V/200)^(2/3) when V > 200 m3, in
absorption_coefficient.
The volume advisory is emitted once by absorption_coefficient and suppressed
in its internal absorption_area calls to avoid duplicate warnings.
Claude-Session: https://claude.ai/code/session_013kkVt3nxi9svp1an28uHxf
* fix: deferred review minors — airborne brute-force net, advisory consistency, labels
Claude-Session: https://claude.ai/code/session_013kkVt3nxi9svp1an28uHxf
* docs: sound power guide, impact and absorption sections, theory and API (EN)
Add a "Sound Power" guide covering the three LW routes (ISO 3744/3746
enveloping surface, ISO 3741 reverberation room with Waterhouse/C1/C2,
ISO 9614-2 intensity scanning), with a method-comparison table, executed
snippets and parameter tables. Extend the Room & Building Acoustics guide
with impact sound insulation (ISO 16283-2 + ISO 717-2, L'nT/L'n, tapping
machine, CI) and sound absorption in a reverberation room (ISO 354).
Add the matching theory sections (K1/K2, Waterhouse, C1/C2 derivations;
impact sign conventions; Sabine absorption) and API-reference rows for all
new public names. Update the landing standards count to 26, the sidebar,
README highlights/table, CHANGELOG and llms-full.txt.
Claude-Session: https://claude.ai/code/session_013kkVt3nxi9svp1an28uHxf
* docs: sound-power and impact figures and diagrams
Claude-Session: https://claude.ai/code/session_013kkVt3nxi9svp1an28uHxf
* docs: include the sound-power guide in llms coverage
Claude-Session: https://claude.ai/code/session_013kkVt3nxi9svp1an28uHxf
* docs: reposition Ln,w annotation in the impact figure
Claude-Session: https://claude.ai/code/session_013kkVt3nxi9svp1an28uHxf
* docs: gemelas ES de potencia sonora, impacto y absorción
Claude-Session: https://claude.ai/code/session_013kkVt3nxi9svp1an28uHxf
* fix: final-review findings — comparison K1 reporting, citations, knee unification, docs attribution
- sound_power_comparison now reports the test-source K1 actually applied
per band (zero when no background), matching the dataclass docstring;
LW unchanged.
- Replace gitignored notes-iso3744-3746.md citation in the DI comment with
the standard reference (ISO 3744:2010, 3.24 / Eq. 7 context).
- Unify the K1 zeroing knee to the >= form (ΔLp >= 15 -> no correction).
- Broaden SoundPowerWarning docstring to name all emitters (ISO 3744/3746,
ISO 3741, ISO 9614-2).
- Fix docs misattributing K2 to ISO 3741 (ISO 3744 K2 vs ISO 3741 absorption
term) across EN/ES room-acoustics guides.
- EN impact-setup diagram uses dot decimals (0.16); regenerate the 4 variants.
- CHANGELOG: label the ISO 717-2 Annex C value Ln,w = 79.
- Warn-after-validate in sound_power_comparison; "is raised" -> "is emitted".
Claude-Session: https://claude.ai/code/session_013kkVt3nxi9svp1an28uHxf
* fix: PR 84 review round 1 — per-band DI and K2, sweep-reversal repeatability, validation and broadcast ergonomics
Claude-Session: https://claude.ai/code/session_013kkVt3nxi9svp1an28uHxf
* fix: PR 84 round 2 — partial room-data validation, result-field docs
Raise a clear ValueError in environmental_correction (and its
sound_power_pressure pass-through) when exactly one member of a
room-data pair (reverberation_time/room_volume or
mean_absorption_coefficient/room_surface) is supplied, instead of
silently returning K2=0 as if free field. All-None remains the
legitimate free-field K2=0 path.
Document frequencies on the ReverberationSoundPowerResult row and
negative_band as a standalone per-band boolean field on the
SoundPowerIntensityResult row across docs/api-reference.md and the
EN/ES site twins.
Claude-Session: https://claude.ai/code/session_013kkVt3nxi9svp1an28uHxf
Sound power determination and building acoustics II: ISO 3744/3746, ISO 3741, ISO 9614-2, ISO 16283-2 + ISO 717-2, ISO 354 (#84)
* feat: ISO 3744/3746 sound power from pressure measurements
Add sound_power.py: sound power level of a noise source from sound
pressure levels over an enveloping measurement surface, ISO 3744:2010
(engineering, grade 2) and ISO 3746:2010 (survey, grade 3).
- sound_power_pressure(): per-band LW and A-weighted LWA from an
(NM, NB) level array over a hemisphere (radius) or parallelepiped
(dimensions + distance); surface area from the standard's closed forms
for 1/2/3 reflecting planes; energy average (Eq. 12), background K1
(Eq. 16), environmental K2 (Eq. A.2), apparent directivity index
(Eq. 7), expanded uncertainty.
- measurement_positions(): normative Annex B coordinates
(Tables B.1/B.2/B.3), grade- and plane-dependent subsets.
- background_noise_correction(): K1 with engineering/survey criteria.
- environmental_correction(): K2 from A, Sabine T+V, or alpha*Sv.
- SoundPowerResult (frozen dataclass), SoundPowerWarning.
Tests: 24 cases incl. monopole-over-plane exact LW recovery, radius
independence, K1/K2 closed forms, LWA via Annex E, and validations.
make check green (543 passed, 12 skipped); ruff/bandit/mypy --strict clean.
Claude-Session: https://claude.ai/code/session_013kkVt3nxi9svp1an28uHxf
* fix: directivity index under background correction, citation hygiene
Broadband K1 for the apparent directivity index was collapsing to the
surface-area term 10*lg(S/S0) (~+22 dB inflation with background
correction). Compute the true energy-based broadband K1 (per-band Eq. 16
aggregated over bands) so DI is correct in both paths.
Also: multi-band sound_power_level_a without frequencies now returns NaN
(A-weighting needs band centres); dropped PDF page-number citations from
Annex B/E table comments; corrected the survey parallelepiped position
citation to ISO 3746 clause C.1 / Figure C.7.
Claude-Session: https://claude.ai/code/session_013kkVt3nxi9svp1an28uHxf
* feat: ISO 3741 reverberation-room sound power
Add the ISO 3741:2010 precision (grade 1) methods for determining sound
power in a reverberation test room, in a new sound_power_reverberation
module:
- sound_power_reverberation() — direct method (Eq. 20): LW from the mean
room SPL and the Sabine equivalent absorption area A = (55,26/c)(V/T60),
with the full normative bracket: 10 lg(A/A0), 4,34*(A/S), the Waterhouse
boundary term 10 lg(1 + S c/(8 V f)), the reference-quantity (C1) and
radiation-impedance (C2) meteorological corrections and the -6 dB
constant. Speed of sound c = 20,05*sqrt(273 + theta).
- sound_power_comparison() — comparison method (Eq. 21) with a reference
sound source: LW = LW(RSS) + (Lp(ST) - Lp(RSS) + C2).
- ReverberationSoundPowerResult frozen dataclass; frequency-dependent
background correction K1 (Eq. 14, same formula as ISO 3744) with the
precision-grade 6/10 dB criteria; A-weighted total via Annex F.
Reuses the ISO 3744 energy-average and A-weighting helpers. Tests cover
exact inversion of Eq. (20), the Waterhouse term vanishing at high
frequency, the comparison method exact by construction, and synergy with
room_parameters T30 feeding the direct method.
Claude-Session: https://claude.ai/code/session_013kkVt3nxi9svp1an28uHxf
* fix: ISO 3741 room-qualification advisories and validation ordering
Claude-Session: https://claude.ai/code/session_013kkVt3nxi9svp1an28uHxf
* feat: ISO 9614-2 sound power by intensity scanning
Add sound_power_intensity() computing per-band LW = 10lg(sum Pi/P0) from
per-segment signed normal intensity and areas (partial power Pi = <In,i>*Si),
the scanning-method field indicators FpI (Eq. A.1) and F+/- (Eq. A.2), the
repeatability criterion 3, and the achieved engineering/survey grade per band
(Annex B criteria 1-3). Negative total power flags bands as non-determinable
(clause 9.2); negative partial power raises SoundPowerWarning. Reuses
dynamic_capability_index for Ld = dpI0 - K (Table 1).
Claude-Session: https://claude.ai/code/session_013kkVt3nxi9svp1an28uHxf
* feat: ISO 16283-2 impact sound insulation and ISO 717-2 ratings
Add field impact sound insulation (ISO 16283-2, tapping machine) and the
ISO 717-2 single-number weighted impact rating with the CI spectrum
adaptation term, reusing the verified reference-curve shift engine.
- impact_insulation(li, t2, *, volume=None, t0=0.5): per-band
L'nT = Li - 10 lg(T/T0) (Formula (1)) and L'n = Li + 10 lg(A/A0) with
A = 0,16 V/T, A0 = 10 m2 (Formula (2)); positions energy-averaged.
- weighted_impact_rating(values_by_band, bands=None): Ln,w / L'n,w /
L'nT,w (Clause 4.3, octave -5 dB rule) and CI (Clause A.2.1, energetic
sum 100-2500 / 125-2000). Impact unfavourable deviations (measurement
exceeds reference, sign opposite to airborne) reduce to the airborne
search on negated curves, so _best_shift is reused verbatim.
- _best_shift: tolerance absorbs float noise at the exact bound (sums are
true multiples of 0,1 dB); airborne behaviour unchanged.
Verified against ISO 717-2 Annex C worked examples (Table C.1 Ln,w=79,
CI=-11; Table C.3 octave Ln,w=54, CI=0) and an independent brute-force
shift search on 10 000 random curves per band set. 2013 and 2020 editions
are identical for all implemented maths (2020 only adds Annex D rubber
ball, out of scope).
Claude-Session: https://claude.ai/code/session_013kkVt3nxi9svp1an28uHxf
* feat: ISO 354 sound absorption in a reverberation room
Add phonometry.sound_absorption implementing BS EN ISO 354:2003:
- absorption_area(t60, volume, ...): equivalent sound absorption area
A = 55,3*V/(c*T) - 4*V*m (Eq. 5/7), speed of sound from Eq. (6).
- absorption_coefficient(t1, t2, volume, sample_area, ...): alpha_s =
(A2-A1)/S built from Eq. (8)/(9), per-measurement c1/c2, unclamped
(alpha_s > 1 valid, clause 3.7 NOTE 2); warns when T2 >= T1.
- attenuation_from_alpha: ISO-354 conversion m = alpha/(10 lg e) from an
ISO 9613-1 attenuation coefficient (m deferred to ISO 9613-1, default 0).
Composes directly with room_parameters() T20/T30 outputs. 25 tests
(exact T->A->T inversion, synthetic-alpha recovery, zero-m air term,
two-temperature Eq. (8), range validation, room_parameters synergy).
Claude-Session: https://claude.ai/code/session_013kkVt3nxi9svp1an28uHxf
* fix: ISO 354 room and sample-size advisories
Add advisory AbsorptionWarning (never raising; result still returned) for
setup conditions outside ISO 354:2003 limits:
- Room volume below the 150 m3 minimum of clause 6.1.1, in both
absorption_area and absorption_coefficient.
- Sample area outside the clause 6.2.1.1 range 10 <= S <= 12 m2, with the
upper limit scaled by (V/200)^(2/3) when V > 200 m3, in
absorption_coefficient.
The volume advisory is emitted once by absorption_coefficient and suppressed
in its internal absorption_area calls to avoid duplicate warnings.
Claude-Session: https://claude.ai/code/session_013kkVt3nxi9svp1an28uHxf
* fix: deferred review minors — airborne brute-force net, advisory consistency, labels
Claude-Session: https://claude.ai/code/session_013kkVt3nxi9svp1an28uHxf
* docs: sound power guide, impact and absorption sections, theory and API (EN)
Add a "Sound Power" guide covering the three LW routes (ISO 3744/3746
enveloping surface, ISO 3741 reverberation room with Waterhouse/C1/C2,
ISO 9614-2 intensity scanning), with a method-comparison table, executed
snippets and parameter tables. Extend the Room & Building Acoustics guide
with impact sound insulation (ISO 16283-2 + ISO 717-2, L'nT/L'n, tapping
machine, CI) and sound absorption in a reverberation room (ISO 354).
Add the matching theory sections (K1/K2, Waterhouse, C1/C2 derivations;
impact sign conventions; Sabine absorption) and API-reference rows for all
new public names. Update the landing standards count to 26, the sidebar,
README highlights/table, CHANGELOG and llms-full.txt.
Claude-Session: https://claude.ai/code/session_013kkVt3nxi9svp1an28uHxf
* docs: sound-power and impact figures and diagrams
Claude-Session: https://claude.ai/code/session_013kkVt3nxi9svp1an28uHxf
* docs: include the sound-power guide in llms coverage
Claude-Session: https://claude.ai/code/session_013kkVt3nxi9svp1an28uHxf
* docs: reposition Ln,w annotation in the impact figure
Claude-Session: https://claude.ai/code/session_013kkVt3nxi9svp1an28uHxf
* docs: gemelas ES de potencia sonora, impacto y absorción
Claude-Session: https://claude.ai/code/session_013kkVt3nxi9svp1an28uHxf
* fix: final-review findings — comparison K1 reporting, citations, knee unification, docs attribution
- sound_power_comparison now reports the test-source K1 actually applied
per band (zero when no background), matching the dataclass docstring;
LW unchanged.
- Replace gitignored notes-iso3744-3746.md citation in the DI comment with
the standard reference (ISO 3744:2010, 3.24 / Eq. 7 context).
- Unify the K1 zeroing knee to the >= form (ΔLp >= 15 -> no correction).
- Broaden SoundPowerWarning docstring to name all emitters (ISO 3744/3746,
ISO 3741, ISO 9614-2).
- Fix docs misattributing K2 to ISO 3741 (ISO 3744 K2 vs ISO 3741 absorption
term) across EN/ES room-acoustics guides.
- EN impact-setup diagram uses dot decimals (0.16); regenerate the 4 variants.
- CHANGELOG: label the ISO 717-2 Annex C value Ln,w = 79.
- Warn-after-validate in sound_power_comparison; "is raised" -> "is emitted".
Claude-Session: https://claude.ai/code/session_013kkVt3nxi9svp1an28uHxf
* fix: PR 84 review round 1 — per-band DI and K2, sweep-reversal repeatability, validation and broadcast ergonomics
Claude-Session: https://claude.ai/code/session_013kkVt3nxi9svp1an28uHxf
* fix: PR 84 round 2 — partial room-data validation, result-field docs
Raise a clear ValueError in environmental_correction (and its
sound_power_pressure pass-through) when exactly one member of a
room-data pair (reverberation_time/room_volume or
mean_absorption_coefficient/room_surface) is supplied, instead of
silently returning K2=0 as if free field. All-None remains the
legitimate free-field K2=0 path.
Document frequencies on the ReverberationSoundPowerResult row and
negative_band as a standalone per-band boolean field on the
SoundPowerIntensityResult row across docs/api-reference.md and the
EN/ES site twins.
Claude-Session: https://claude.ai/code/session_013kkVt3nxi9svp1an28uHxf
Spanish docs: UNE terminology, decimal commas, localized snippets and theory figures (#365)
* Normalize Spanish docs prose to UNE acoustic terminology
Sweep the Spanish pages for the non-UNE forms "presion sonora",
"potencia sonora" and "intensidad sonora" and normalize the prose to
the wording used by the official Spanish editions of the standards:
"presion acustica" (UNE-EN ISO 16283-2:2016, UNE-EN ISO 10052:2005,
UNE-EN ISO 3746:2011, UNE-ISO 226:2013), "potencia acustica"
(UNE-EN ISO 3746:2011, UNE-EN ISO 4871:2010, UNE-EN ISO 9614-1:2010),
"intensidad acustica" (UNE-EN 61043:1999, UNE-EN ISO 9614-1:2010) and
"nivel de presion acustica de impactos" (UNE-EN ISO 12354-2:2018,
UNE-EN ISO 717-2:2013). 92 replacements across 32 pages, prose only:
code snippets keep the labels they share with the generated figures.
Rename the intensity guide to "Intensidad acustica (p-p)" and the
structure-borne power guide to "Potencia acustica estructural de
equipos (EN 15657)", updating every cross-link text and the theory
anchor intensidad-sonora-iec-61043 accordingly. The API sidebar group
label becomes "Potencia acustica e intensidad" via api_taxonomy.py
with the generated sidebar regenerated.
* Use decimal commas in Spanish docs prose quantities
Sweep every Spanish page for decimal points leaking into prose numbers
and switch them to the comma the locale convention calls for: the
rotorcraft validation prose (fourteen tolerances such as 0,08 dB(A) and
0,5 s), the insulation-prediction worked example (53,6 dB / 53,8 dB),
the tone-audibility Annex E tone (137,3 Hz), the Mackenzie check value
(1550,744 m/s), the EPNL, loudness and absorption fiche descriptions
(98,3 EPNdB; 8,2 sonos and 70,4 fonios; 0,60 y 0,55), the junction
constants table and the third-octave band-edge table in the signal
analysis theory page. Code snippets, inline code, math, clause numbers
and quoted source text keep their points.
* Pass language="es" in Spanish figure-reproduction snippets
The <details> blocks under each localized figure in the Spanish guides
are meant to reproduce the _es variant shown on the page, but 82 of the
one-line result .plot() calls omitted the language="es" argument and
would render English axis labels instead. Add the argument across 33
guides, matching the pattern the intensity field-indicators snippet
already used. The three lab-insulation results whose plot() does not
take a language argument (lab airborne, lab impact and the
element-normalized intensity difference) are left as they were.
* Extend the UNE terminology sweep to sound absorption
Normalize "absorción sonora" to "absorción acústica" across the
Spanish pages (36 occurrences in 14 pages, including the EN 12354-6
guide title and the theory headings), the wording of UNE-EN ISO
3746:2011 and of the equivalent absorption area in UNE-EN ISO
10140-3:2011, UNE-EN ISO 12354-2:2018 and UNE-EN ISO 16283-2:2016, and
the same term the accredited report strings already use. Also restore
the accent in the theory index anchor to the renamed intensity heading,
since heading slugs keep accented characters.
* Theory pages: illustrate each section family with existing result figures
The seven theory pages carried no figures at all. Embed sixteen of the
existing generated figures (light and dark variants, Spanish variants on
the Spanish mirrors) where the concept matches the prose: weighting
curves, time integration and the p-p intensity estimator in the signal
analysis page; equal-loudness contours, the specific-loudness pattern
and the hearing-threshold panels in perception; NC/RC rating, the
Schroeder decay and the ISO 717-1 shifted reference in rooms and
buildings; the Lden profile, ISO 9613-1 absorption and the three sound
power routes in environment and transport; the scattering coefficient
and ISO 11654 rating in materials and surfaces; and the Wk weighting and
the resonator mobility triplet in vibration. Each embed reuses the alt
text of the guide that owns the figure and adds a one-line caption.
Also give the wave-simulation section hub the reading-order paragraph
its siblings already have, linking the closed-form pages the FDTD solver
cross-checks, in both languages.
* Address review findings from the Spanish locale sweeps
Second pass fixes flagged by review: five terminology occurrences the
line-based sweep missed because the noun and adjective were split by a
line wrap or emphasis markup (sound-power, rotorcraft-noise and two
section hubs); six Spanish pages that still embedded the English figure
variant although the _es variant exists (junction-transmission,
aircraft-noise airport contour, miso-coherence,
objective-intelligibility, psychoacoustic-annoyance twice); and 19 more
language="es" arguments on figure-reproduction plot calls the first
pass missed, chained-call receivers such as room.noise_criterion(spl)
.plot() and the axes-creating first call of the two-profile
atmospheric-refraction snippet among them. The lab-insulation plot
wrappers forward keyword arguments to the rating plot, so the three
calls excluded earlier now take the argument too. All Spanish python
fences re-checked to compile and EN/ES parity re-verified.
* Carry the UNE terminology into the generated-asset Spanish strings
Apply the same evidence-based decisions to every Spanish string source
that feeds generated assets: the translation tables of
generate_graphs.py and generate_diagrams.py, the _STRINGS tables of the
plot modules and the report i18n values. 35 strings change: "presión
acústica" (UNE-EN ISO 16283-2:2016, 10052:2005, 3746:2011),
"potencia acústica" (UNE-EN ISO 3746:2011, 4871:2010, 9614-1:2010),
"intensidad acústica" (UNE-EN 61043:1999, 9614-1:2010), "absorción
acústica" (UNE-EN ISO 3746:2011) and "nivel de presión acústica de
impactos" (UNE-EN ISO 12354-2:2018). Strings the UNE editions keep are
untouched: "emisión sonora", "exposición sonora", "campo sonoro",
"fuente sonora". Only Spanish values change; the English keys stay.
The two plot-i18n test assertions that pin the axis label follow, and
the eight Spanish doc fences that deliberately mirrored the old figure
labels now mirror the new ones.
* Regenerate the Spanish figure variants with the UNE terminology
make graphs after the string-source change: 48 files, all of them _es
or _es_dark variants (24 figure/diagram pairs), picking up "presión
acústica", "potencia acústica", "intensidad acústica", "absorción
acústica" and "nivel de presión acústica de impactos" in titles and
axis labels. The English variants are untouched. The committed example
fiches need no regeneration: every example in generate_reports.py
renders in English, so no changed Spanish report string reaches them.
* Align the intensity-fiche Spanish assertions with the UNE terminology
Spanish docs: UNE terminology, decimal commas, localized snippets and theory figures (#365)
* Normalize Spanish docs prose to UNE acoustic terminology
Sweep the Spanish pages for the non-UNE forms "presion sonora",
"potencia sonora" and "intensidad sonora" and normalize the prose to
the wording used by the official Spanish editions of the standards:
"presion acustica" (UNE-EN ISO 16283-2:2016, UNE-EN ISO 10052:2005,
UNE-EN ISO 3746:2011, UNE-ISO 226:2013), "potencia acustica"
(UNE-EN ISO 3746:2011, UNE-EN ISO 4871:2010, UNE-EN ISO 9614-1:2010),
"intensidad acustica" (UNE-EN 61043:1999, UNE-EN ISO 9614-1:2010) and
"nivel de presion acustica de impactos" (UNE-EN ISO 12354-2:2018,
UNE-EN ISO 717-2:2013). 92 replacements across 32 pages, prose only:
code snippets keep the labels they share with the generated figures.
Rename the intensity guide to "Intensidad acustica (p-p)" and the
structure-borne power guide to "Potencia acustica estructural de
equipos (EN 15657)", updating every cross-link text and the theory
anchor intensidad-sonora-iec-61043 accordingly. The API sidebar group
label becomes "Potencia acustica e intensidad" via api_taxonomy.py
with the generated sidebar regenerated.
* Use decimal commas in Spanish docs prose quantities
Sweep every Spanish page for decimal points leaking into prose numbers
and switch them to the comma the locale convention calls for: the
rotorcraft validation prose (fourteen tolerances such as 0,08 dB(A) and
0,5 s), the insulation-prediction worked example (53,6 dB / 53,8 dB),
the tone-audibility Annex E tone (137,3 Hz), the Mackenzie check value
(1550,744 m/s), the EPNL, loudness and absorption fiche descriptions
(98,3 EPNdB; 8,2 sonos and 70,4 fonios; 0,60 y 0,55), the junction
constants table and the third-octave band-edge table in the signal
analysis theory page. Code snippets, inline code, math, clause numbers
and quoted source text keep their points.
* Pass language="es" in Spanish figure-reproduction snippets
The <details> blocks under each localized figure in the Spanish guides
are meant to reproduce the _es variant shown on the page, but 82 of the
one-line result .plot() calls omitted the language="es" argument and
would render English axis labels instead. Add the argument across 33
guides, matching the pattern the intensity field-indicators snippet
already used. The three lab-insulation results whose plot() does not
take a language argument (lab airborne, lab impact and the
element-normalized intensity difference) are left as they were.
* Extend the UNE terminology sweep to sound absorption
Normalize "absorción sonora" to "absorción acústica" across the
Spanish pages (36 occurrences in 14 pages, including the EN 12354-6
guide title and the theory headings), the wording of UNE-EN ISO
3746:2011 and of the equivalent absorption area in UNE-EN ISO
10140-3:2011, UNE-EN ISO 12354-2:2018 and UNE-EN ISO 16283-2:2016, and
the same term the accredited report strings already use. Also restore
the accent in the theory index anchor to the renamed intensity heading,
since heading slugs keep accented characters.
* Theory pages: illustrate each section family with existing result figures
The seven theory pages carried no figures at all. Embed sixteen of the
existing generated figures (light and dark variants, Spanish variants on
the Spanish mirrors) where the concept matches the prose: weighting
curves, time integration and the p-p intensity estimator in the signal
analysis page; equal-loudness contours, the specific-loudness pattern
and the hearing-threshold panels in perception; NC/RC rating, the
Schroeder decay and the ISO 717-1 shifted reference in rooms and
buildings; the Lden profile, ISO 9613-1 absorption and the three sound
power routes in environment and transport; the scattering coefficient
and ISO 11654 rating in materials and surfaces; and the Wk weighting and
the resonator mobility triplet in vibration. Each embed reuses the alt
text of the guide that owns the figure and adds a one-line caption.
Also give the wave-simulation section hub the reading-order paragraph
its siblings already have, linking the closed-form pages the FDTD solver
cross-checks, in both languages.
* Address review findings from the Spanish locale sweeps
Second pass fixes flagged by review: five terminology occurrences the
line-based sweep missed because the noun and adjective were split by a
line wrap or emphasis markup (sound-power, rotorcraft-noise and two
section hubs); six Spanish pages that still embedded the English figure
variant although the _es variant exists (junction-transmission,
aircraft-noise airport contour, miso-coherence,
objective-intelligibility, psychoacoustic-annoyance twice); and 19 more
language="es" arguments on figure-reproduction plot calls the first
pass missed, chained-call receivers such as room.noise_criterion(spl)
.plot() and the axes-creating first call of the two-profile
atmospheric-refraction snippet among them. The lab-insulation plot
wrappers forward keyword arguments to the rating plot, so the three
calls excluded earlier now take the argument too. All Spanish python
fences re-checked to compile and EN/ES parity re-verified.
* Carry the UNE terminology into the generated-asset Spanish strings
Apply the same evidence-based decisions to every Spanish string source
that feeds generated assets: the translation tables of
generate_graphs.py and generate_diagrams.py, the _STRINGS tables of the
plot modules and the report i18n values. 35 strings change: "presión
acústica" (UNE-EN ISO 16283-2:2016, 10052:2005, 3746:2011),
"potencia acústica" (UNE-EN ISO 3746:2011, 4871:2010, 9614-1:2010),
"intensidad acústica" (UNE-EN 61043:1999, 9614-1:2010), "absorción
acústica" (UNE-EN ISO 3746:2011) and "nivel de presión acústica de
impactos" (UNE-EN ISO 12354-2:2018). Strings the UNE editions keep are
untouched: "emisión sonora", "exposición sonora", "campo sonoro",
"fuente sonora". Only Spanish values change; the English keys stay.
The two plot-i18n test assertions that pin the axis label follow, and
the eight Spanish doc fences that deliberately mirrored the old figure
labels now mirror the new ones.
* Regenerate the Spanish figure variants with the UNE terminology
make graphs after the string-source change: 48 files, all of them _es
or _es_dark variants (24 figure/diagram pairs), picking up "presión
acústica", "potencia acústica", "intensidad acústica", "absorción
acústica" and "nivel de presión acústica de impactos" in titles and
axis labels. The English variants are untouched. The committed example
fiches need no regeneration: every example in generate_reports.py
renders in English, so no changed Spanish report string reaches them.
* Align the intensity-fiche Spanish assertions with the UNE terminology
Spanish docs: UNE terminology, decimal commas, localized snippets and theory figures (#365)
* Normalize Spanish docs prose to UNE acoustic terminology
Sweep the Spanish pages for the non-UNE forms "presion sonora",
"potencia sonora" and "intensidad sonora" and normalize the prose to
the wording used by the official Spanish editions of the standards:
"presion acustica" (UNE-EN ISO 16283-2:2016, UNE-EN ISO 10052:2005,
UNE-EN ISO 3746:2011, UNE-ISO 226:2013), "potencia acustica"
(UNE-EN ISO 3746:2011, UNE-EN ISO 4871:2010, UNE-EN ISO 9614-1:2010),
"intensidad acustica" (UNE-EN 61043:1999, UNE-EN ISO 9614-1:2010) and
"nivel de presion acustica de impactos" (UNE-EN ISO 12354-2:2018,
UNE-EN ISO 717-2:2013). 92 replacements across 32 pages, prose only:
code snippets keep the labels they share with the generated figures.
Rename the intensity guide to "Intensidad acustica (p-p)" and the
structure-borne power guide to "Potencia acustica estructural de
equipos (EN 15657)", updating every cross-link text and the theory
anchor intensidad-sonora-iec-61043 accordingly. The API sidebar group
label becomes "Potencia acustica e intensidad" via api_taxonomy.py
with the generated sidebar regenerated.
* Use decimal commas in Spanish docs prose quantities
Sweep every Spanish page for decimal points leaking into prose numbers
and switch them to the comma the locale convention calls for: the
rotorcraft validation prose (fourteen tolerances such as 0,08 dB(A) and
0,5 s), the insulation-prediction worked example (53,6 dB / 53,8 dB),
the tone-audibility Annex E tone (137,3 Hz), the Mackenzie check value
(1550,744 m/s), the EPNL, loudness and absorption fiche descriptions
(98,3 EPNdB; 8,2 sonos and 70,4 fonios; 0,60 y 0,55), the junction
constants table and the third-octave band-edge table in the signal
analysis theory page. Code snippets, inline code, math, clause numbers
and quoted source text keep their points.
* Pass language="es" in Spanish figure-reproduction snippets
The <details> blocks under each localized figure in the Spanish guides
are meant to reproduce the _es variant shown on the page, but 82 of the
one-line result .plot() calls omitted the language="es" argument and
would render English axis labels instead. Add the argument across 33
guides, matching the pattern the intensity field-indicators snippet
already used. The three lab-insulation results whose plot() does not
take a language argument (lab airborne, lab impact and the
element-normalized intensity difference) are left as they were.
* Extend the UNE terminology sweep to sound absorption
Normalize "absorción sonora" to "absorción acústica" across the
Spanish pages (36 occurrences in 14 pages, including the EN 12354-6
guide title and the theory headings), the wording of UNE-EN ISO
3746:2011 and of the equivalent absorption area in UNE-EN ISO
10140-3:2011, UNE-EN ISO 12354-2:2018 and UNE-EN ISO 16283-2:2016, and
the same term the accredited report strings already use. Also restore
the accent in the theory index anchor to the renamed intensity heading,
since heading slugs keep accented characters.
* Theory pages: illustrate each section family with existing result figures
The seven theory pages carried no figures at all. Embed sixteen of the
existing generated figures (light and dark variants, Spanish variants on
the Spanish mirrors) where the concept matches the prose: weighting
curves, time integration and the p-p intensity estimator in the signal
analysis page; equal-loudness contours, the specific-loudness pattern
and the hearing-threshold panels in perception; NC/RC rating, the
Schroeder decay and the ISO 717-1 shifted reference in rooms and
buildings; the Lden profile, ISO 9613-1 absorption and the three sound
power routes in environment and transport; the scattering coefficient
and ISO 11654 rating in materials and surfaces; and the Wk weighting and
the resonator mobility triplet in vibration. Each embed reuses the alt
text of the guide that owns the figure and adds a one-line caption.
Also give the wave-simulation section hub the reading-order paragraph
its siblings already have, linking the closed-form pages the FDTD solver
cross-checks, in both languages.
* Address review findings from the Spanish locale sweeps
Second pass fixes flagged by review: five terminology occurrences the
line-based sweep missed because the noun and adjective were split by a
line wrap or emphasis markup (sound-power, rotorcraft-noise and two
section hubs); six Spanish pages that still embedded the English figure
variant although the _es variant exists (junction-transmission,
aircraft-noise airport contour, miso-coherence,
objective-intelligibility, psychoacoustic-annoyance twice); and 19 more
language="es" arguments on figure-reproduction plot calls the first
pass missed, chained-call receivers such as room.noise_criterion(spl)
.plot() and the axes-creating first call of the two-profile
atmospheric-refraction snippet among them. The lab-insulation plot
wrappers forward keyword arguments to the rating plot, so the three
calls excluded earlier now take the argument too. All Spanish python
fences re-checked to compile and EN/ES parity re-verified.
* Carry the UNE terminology into the generated-asset Spanish strings
Apply the same evidence-based decisions to every Spanish string source
that feeds generated assets: the translation tables of
generate_graphs.py and generate_diagrams.py, the _STRINGS tables of the
plot modules and the report i18n values. 35 strings change: "presión
acústica" (UNE-EN ISO 16283-2:2016, 10052:2005, 3746:2011),
"potencia acústica" (UNE-EN ISO 3746:2011, 4871:2010, 9614-1:2010),
"intensidad acústica" (UNE-EN 61043:1999, 9614-1:2010), "absorción
acústica" (UNE-EN ISO 3746:2011) and "nivel de presión acústica de
impactos" (UNE-EN ISO 12354-2:2018). Strings the UNE editions keep are
untouched: "emisión sonora", "exposición sonora", "campo sonoro",
"fuente sonora". Only Spanish values change; the English keys stay.
The two plot-i18n test assertions that pin the axis label follow, and
the eight Spanish doc fences that deliberately mirrored the old figure
labels now mirror the new ones.
* Regenerate the Spanish figure variants with the UNE terminology
make graphs after the string-source change: 48 files, all of them _es
or _es_dark variants (24 figure/diagram pairs), picking up "presión
acústica", "potencia acústica", "intensidad acústica", "absorción
acústica" and "nivel de presión acústica de impactos" in titles and
axis labels. The English variants are untouched. The committed example
fiches need no regeneration: every example in generate_reports.py
renders in English, so no changed Spanish report string reaches them.
* Align the intensity-fiche Spanish assertions with the UNE terminology
Spanish docs: UNE terminology, decimal commas, localized snippets and theory figures (#365)
* Normalize Spanish docs prose to UNE acoustic terminology
Sweep the Spanish pages for the non-UNE forms "presion sonora",
"potencia sonora" and "intensidad sonora" and normalize the prose to
the wording used by the official Spanish editions of the standards:
"presion acustica" (UNE-EN ISO 16283-2:2016, UNE-EN ISO 10052:2005,
UNE-EN ISO 3746:2011, UNE-ISO 226:2013), "potencia acustica"
(UNE-EN ISO 3746:2011, UNE-EN ISO 4871:2010, UNE-EN ISO 9614-1:2010),
"intensidad acustica" (UNE-EN 61043:1999, UNE-EN ISO 9614-1:2010) and
"nivel de presion acustica de impactos" (UNE-EN ISO 12354-2:2018,
UNE-EN ISO 717-2:2013). 92 replacements across 32 pages, prose only:
code snippets keep the labels they share with the generated figures.
Rename the intensity guide to "Intensidad acustica (p-p)" and the
structure-borne power guide to "Potencia acustica estructural de
equipos (EN 15657)", updating every cross-link text and the theory
anchor intensidad-sonora-iec-61043 accordingly. The API sidebar group
label becomes "Potencia acustica e intensidad" via api_taxonomy.py
with the generated sidebar regenerated.
* Use decimal commas in Spanish docs prose quantities
Sweep every Spanish page for decimal points leaking into prose numbers
and switch them to the comma the locale convention calls for: the
rotorcraft validation prose (fourteen tolerances such as 0,08 dB(A) and
0,5 s), the insulation-prediction worked example (53,6 dB / 53,8 dB),
the tone-audibility Annex E tone (137,3 Hz), the Mackenzie check value
(1550,744 m/s), the EPNL, loudness and absorption fiche descriptions
(98,3 EPNdB; 8,2 sonos and 70,4 fonios; 0,60 y 0,55), the junction
constants table and the third-octave band-edge table in the signal
analysis theory page. Code snippets, inline code, math, clause numbers
and quoted source text keep their points.
* Pass language="es" in Spanish figure-reproduction snippets
The <details> blocks under each localized figure in the Spanish guides
are meant to reproduce the _es variant shown on the page, but 82 of the
one-line result .plot() calls omitted the language="es" argument and
would render English axis labels instead. Add the argument across 33
guides, matching the pattern the intensity field-indicators snippet
already used. The three lab-insulation results whose plot() does not
take a language argument (lab airborne, lab impact and the
element-normalized intensity difference) are left as they were.
* Extend the UNE terminology sweep to sound absorption
Normalize "absorción sonora" to "absorción acústica" across the
Spanish pages (36 occurrences in 14 pages, including the EN 12354-6
guide title and the theory headings), the wording of UNE-EN ISO
3746:2011 and of the equivalent absorption area in UNE-EN ISO
10140-3:2011, UNE-EN ISO 12354-2:2018 and UNE-EN ISO 16283-2:2016, and
the same term the accredited report strings already use. Also restore
the accent in the theory index anchor to the renamed intensity heading,
since heading slugs keep accented characters.
* Theory pages: illustrate each section family with existing result figures
The seven theory pages carried no figures at all. Embed sixteen of the
existing generated figures (light and dark variants, Spanish variants on
the Spanish mirrors) where the concept matches the prose: weighting
curves, time integration and the p-p intensity estimator in the signal
analysis page; equal-loudness contours, the specific-loudness pattern
and the hearing-threshold panels in perception; NC/RC rating, the
Schroeder decay and the ISO 717-1 shifted reference in rooms and
buildings; the Lden profile, ISO 9613-1 absorption and the three sound
power routes in environment and transport; the scattering coefficient
and ISO 11654 rating in materials and surfaces; and the Wk weighting and
the resonator mobility triplet in vibration. Each embed reuses the alt
text of the guide that owns the figure and adds a one-line caption.
Also give the wave-simulation section hub the reading-order paragraph
its siblings already have, linking the closed-form pages the FDTD solver
cross-checks, in both languages.
* Address review findings from the Spanish locale sweeps
Second pass fixes flagged by review: five terminology occurrences the
line-based sweep missed because the noun and adjective were split by a
line wrap or emphasis markup (sound-power, rotorcraft-noise and two
section hubs); six Spanish pages that still embedded the English figure
variant although the _es variant exists (junction-transmission,
aircraft-noise airport contour, miso-coherence,
objective-intelligibility, psychoacoustic-annoyance twice); and 19 more
language="es" arguments on figure-reproduction plot calls the first
pass missed, chained-call receivers such as room.noise_criterion(spl)
.plot() and the axes-creating first call of the two-profile
atmospheric-refraction snippet among them. The lab-insulation plot
wrappers forward keyword arguments to the rating plot, so the three
calls excluded earlier now take the argument too. All Spanish python
fences re-checked to compile and EN/ES parity re-verified.
* Carry the UNE terminology into the generated-asset Spanish strings
Apply the same evidence-based decisions to every Spanish string source
that feeds generated assets: the translation tables of
generate_graphs.py and generate_diagrams.py, the _STRINGS tables of the
plot modules and the report i18n values. 35 strings change: "presión
acústica" (UNE-EN ISO 16283-2:2016, 10052:2005, 3746:2011),
"potencia acústica" (UNE-EN ISO 3746:2011, 4871:2010, 9614-1:2010),
"intensidad acústica" (UNE-EN 61043:1999, 9614-1:2010), "absorción
acústica" (UNE-EN ISO 3746:2011) and "nivel de presión acústica de
impactos" (UNE-EN ISO 12354-2:2018). Strings the UNE editions keep are
untouched: "emisión sonora", "exposición sonora", "campo sonoro",
"fuente sonora". Only Spanish values change; the English keys stay.
The two plot-i18n test assertions that pin the axis label follow, and
the eight Spanish doc fences that deliberately mirrored the old figure
labels now mirror the new ones.
* Regenerate the Spanish figure variants with the UNE terminology
make graphs after the string-source change: 48 files, all of them _es
or _es_dark variants (24 figure/diagram pairs), picking up "presión
acústica", "potencia acústica", "intensidad acústica", "absorción
acústica" and "nivel de presión acústica de impactos" in titles and
axis labels. The English variants are untouched. The committed example
fiches need no regeneration: every example in generate_reports.py
renders in English, so no changed Spanish report string reaches them.
* Align the intensity-fiche Spanish assertions with the UNE terminology
Perception, hearing and speech guides: result figures and when-to-use prose (#361)
* Perception, hearing and speech guides: result figures and when-to-use prose
Add ToneAssessment.plot(), which draws an ECMA-418-1 tone against the
prominence criterion of its own method (recovered from criterion_db) over the
whole range of interest, with the deciding margin marked, and a
view="levels" option on ToneAudibilityResult.plot() that exposes the
level-versus-frequency view the ISO 1996-2 fiche already embedded.
Add eleven single-concept figures to the perception, hearing and speech
guides, each a realistic result drawn by its own .plot(): the tone prominence
verdict, the ISO/PAS 20065 tone levels, the ISO/PAS 1996-3 onset detection,
the ISO 532-2 specific loudness, the ECMA-418-2 specific tonality, the
specific fluctuation strength, the SII band audibility under a hearing loss,
the ISO 7029 fractile band, the ISO 1999 NIPTS audiogram, the STOI per-band
correlation and the IEC 60268-16 per-band MTI. Every figure is embedded in
the English guide, the Spanish mirror and the docs mirror with the dual
snippet block, and every plottable snippet on those pages now names its
.plot().
Prose: the tone-prominence guide gains a comparison of the four tonality
assessments the library implements and when each applies, the
hearing-threshold guide explains how the ISO 7029 fractiles feed the ISO 1999
age component and gains a See-also section, and the objective-intelligibility
guide gains the "which measure, and when" section that existed only in the
docs mirror, extended with the STOI/ESTOI, STI and SII choice.
Also label the STOI band axis at whole-hertz resolution and let the shaded
critical band of the tone-audibility levels plot follow the figure
background, so it reads on the white report page and on dark figures alike.
* Correct two figure alt texts against the plotted values
The ISO 7029 fractile figure describes the median and the 90 % fractile with
the values it actually draws (10 to 50 dB and 22 to 74 dB), and the
ECMA-418-2 specific tonality peak is at 9 Bark_HMS.
Perception, hearing and speech guides: result figures and when-to-use prose (#361)
* Perception, hearing and speech guides: result figures and when-to-use prose
Add ToneAssessment.plot(), which draws an ECMA-418-1 tone against the
prominence criterion of its own method (recovered from criterion_db) over the
whole range of interest, with the deciding margin marked, and a
view="levels" option on ToneAudibilityResult.plot() that exposes the
level-versus-frequency view the ISO 1996-2 fiche already embedded.
Add eleven single-concept figures to the perception, hearing and speech
guides, each a realistic result drawn by its own .plot(): the tone prominence
verdict, the ISO/PAS 20065 tone levels, the ISO/PAS 1996-3 onset detection,
the ISO 532-2 specific loudness, the ECMA-418-2 specific tonality, the
specific fluctuation strength, the SII band audibility under a hearing loss,
the ISO 7029 fractile band, the ISO 1999 NIPTS audiogram, the STOI per-band
correlation and the IEC 60268-16 per-band MTI. Every figure is embedded in
the English guide, the Spanish mirror and the docs mirror with the dual
snippet block, and every plottable snippet on those pages now names its
.plot().
Prose: the tone-prominence guide gains a comparison of the four tonality
assessments the library implements and when each applies, the
hearing-threshold guide explains how the ISO 7029 fractiles feed the ISO 1999
age component and gains a See-also section, and the objective-intelligibility
guide gains the "which measure, and when" section that existed only in the
docs mirror, extended with the STOI/ESTOI, STI and SII choice.
Also label the STOI band axis at whole-hertz resolution and let the shaded
critical band of the tone-audibility levels plot follow the figure
background, so it reads on the white report page and on dark figures alike.
* Correct two figure alt texts against the plotted values
The ISO 7029 fractile figure describes the median and the 90 % fractile with
the values it actually draws (10 to 50 dB and 22 to 74 dB), and the
ECMA-418-2 specific tonality peak is at 9 Bark_HMS.
Perception, hearing and speech guides: result figures and when-to-use prose (#361)
* Perception, hearing and speech guides: result figures and when-to-use prose
Add ToneAssessment.plot(), which draws an ECMA-418-1 tone against the
prominence criterion of its own method (recovered from criterion_db) over the
whole range of interest, with the deciding margin marked, and a
view="levels" option on ToneAudibilityResult.plot() that exposes the
level-versus-frequency view the ISO 1996-2 fiche already embedded.
Add eleven single-concept figures to the perception, hearing and speech
guides, each a realistic result drawn by its own .plot(): the tone prominence
verdict, the ISO/PAS 20065 tone levels, the ISO/PAS 1996-3 onset detection,
the ISO 532-2 specific loudness, the ECMA-418-2 specific tonality, the
specific fluctuation strength, the SII band audibility under a hearing loss,
the ISO 7029 fractile band, the ISO 1999 NIPTS audiogram, the STOI per-band
correlation and the IEC 60268-16 per-band MTI. Every figure is embedded in
the English guide, the Spanish mirror and the docs mirror with the dual
snippet block, and every plottable snippet on those pages now names its
.plot().
Prose: the tone-prominence guide gains a comparison of the four tonality
assessments the library implements and when each applies, the
hearing-threshold guide explains how the ISO 7029 fractiles feed the ISO 1999
age component and gains a See-also section, and the objective-intelligibility
guide gains the "which measure, and when" section that existed only in the
docs mirror, extended with the STOI/ESTOI, STI and SII choice.
Also label the STOI band axis at whole-hertz resolution and let the shaded
critical band of the tone-audibility levels plot follow the figure
background, so it reads on the white report page and on dark figures alike.
* Correct two figure alt texts against the plotted values
The ISO 7029 fractile figure describes the median and the 90 % fractile with
the values it actually draws (10 to 50 dB and 22 to 74 dB), and the
ECMA-418-2 specific tonality peak is at 9 Bark_HMS.
Perception, hearing and speech guides: result figures and when-to-use prose (#361)
* Perception, hearing and speech guides: result figures and when-to-use prose
Add ToneAssessment.plot(), which draws an ECMA-418-1 tone against the
prominence criterion of its own method (recovered from criterion_db) over the
whole range of interest, with the deciding margin marked, and a
view="levels" option on ToneAudibilityResult.plot() that exposes the
level-versus-frequency view the ISO 1996-2 fiche already embedded.
Add eleven single-concept figures to the perception, hearing and speech
guides, each a realistic result drawn by its own .plot(): the tone prominence
verdict, the ISO/PAS 20065 tone levels, the ISO/PAS 1996-3 onset detection,
the ISO 532-2 specific loudness, the ECMA-418-2 specific tonality, the
specific fluctuation strength, the SII band audibility under a hearing loss,
the ISO 7029 fractile band, the ISO 1999 NIPTS audiogram, the STOI per-band
correlation and the IEC 60268-16 per-band MTI. Every figure is embedded in
the English guide, the Spanish mirror and the docs mirror with the dual
snippet block, and every plottable snippet on those pages now names its
.plot().
Prose: the tone-prominence guide gains a comparison of the four tonality
assessments the library implements and when each applies, the
hearing-threshold guide explains how the ISO 7029 fractiles feed the ISO 1999
age component and gains a See-also section, and the objective-intelligibility
guide gains the "which measure, and when" section that existed only in the
docs mirror, extended with the STOI/ESTOI, STI and SII choice.
Also label the STOI band axis at whole-hertz resolution and let the shaded
critical band of the tone-audibility levels plot follow the figure
background, so it reads on the white report page and on dark figures alike.
* Correct two figure alt texts against the plotted values
The ISO 7029 fractile figure describes the median and the 90 % fractile with
the values it actually draws (10 to 50 dB and 22 to 74 dB), and the
ECMA-418-2 specific tonality peak is at 9 Bark_HMS.
Perception, hearing and speech guides: result figures and when-to-use prose (#361)
* Perception, hearing and speech guides: result figures and when-to-use prose
Add ToneAssessment.plot(), which draws an ECMA-418-1 tone against the
prominence criterion of its own method (recovered from criterion_db) over the
whole range of interest, with the deciding margin marked, and a
view="levels" option on ToneAudibilityResult.plot() that exposes the
level-versus-frequency view the ISO 1996-2 fiche already embedded.
Add eleven single-concept figures to the perception, hearing and speech
guides, each a realistic result drawn by its own .plot(): the tone prominence
verdict, the ISO/PAS 20065 tone levels, the ISO/PAS 1996-3 onset detection,
the ISO 532-2 specific loudness, the ECMA-418-2 specific tonality, the
specific fluctuation strength, the SII band audibility under a hearing loss,
the ISO 7029 fractile band, the ISO 1999 NIPTS audiogram, the STOI per-band
correlation and the IEC 60268-16 per-band MTI. Every figure is embedded in
the English guide, the Spanish mirror and the docs mirror with the dual
snippet block, and every plottable snippet on those pages now names its
.plot().
Prose: the tone-prominence guide gains a comparison of the four tonality
assessments the library implements and when each applies, the
hearing-threshold guide explains how the ISO 7029 fractiles feed the ISO 1999
age component and gains a See-also section, and the objective-intelligibility
guide gains the "which measure, and when" section that existed only in the
docs mirror, extended with the STOI/ESTOI, STI and SII choice.
Also label the STOI band axis at whole-hertz resolution and let the shaded
critical band of the tone-audibility levels plot follow the figure
background, so it reads on the white report page and on dark figures alike.
* Correct two figure alt texts against the plotted values
The ISO 7029 fractile figure describes the median and the 90 % fractile with
the values it actually draws (10 to 50 dB and 22 to 74 dB), and the
ECMA-418-2 specific tonality peak is at 9 Bark_HMS.
Perception, hearing and speech guides: result figures and when-to-use prose (#361)
* Perception, hearing and speech guides: result figures and when-to-use prose
Add ToneAssessment.plot(), which draws an ECMA-418-1 tone against the
prominence criterion of its own method (recovered from criterion_db) over the
whole range of interest, with the deciding margin marked, and a
view="levels" option on ToneAudibilityResult.plot() that exposes the
level-versus-frequency view the ISO 1996-2 fiche already embedded.
Add eleven single-concept figures to the perception, hearing and speech
guides, each a realistic result drawn by its own .plot(): the tone prominence
verdict, the ISO/PAS 20065 tone levels, the ISO/PAS 1996-3 onset detection,
the ISO 532-2 specific loudness, the ECMA-418-2 specific tonality, the
specific fluctuation strength, the SII band audibility under a hearing loss,
the ISO 7029 fractile band, the ISO 1999 NIPTS audiogram, the STOI per-band
correlation and the IEC 60268-16 per-band MTI. Every figure is embedded in
the English guide, the Spanish mirror and the docs mirror with the dual
snippet block, and every plottable snippet on those pages now names its
.plot().
Prose: the tone-prominence guide gains a comparison of the four tonality
assessments the library implements and when each applies, the
hearing-threshold guide explains how the ISO 7029 fractiles feed the ISO 1999
age component and gains a See-also section, and the objective-intelligibility
guide gains the "which measure, and when" section that existed only in the
docs mirror, extended with the STOI/ESTOI, STI and SII choice.
Also label the STOI band axis at whole-hertz resolution and let the shaded
critical band of the tone-audibility levels plot follow the figure
background, so it reads on the white report page and on dark figures alike.
* Correct two figure alt texts against the plotted values
The ISO 7029 fractile figure describes the median and the 90 % fractile with
the values it actually draws (10 to 50 dB and 22 to 74 dB), and the
ECMA-418-2 specific tonality peak is at 9 Bark_HMS.
Perception, hearing and speech guides: result figures and when-to-use prose (#361)
* Perception, hearing and speech guides: result figures and when-to-use prose
Add ToneAssessment.plot(), which draws an ECMA-418-1 tone against the
prominence criterion of its own method (recovered from criterion_db) over the
whole range of interest, with the deciding margin marked, and a
view="levels" option on ToneAudibilityResult.plot() that exposes the
level-versus-frequency view the ISO 1996-2 fiche already embedded.
Add eleven single-concept figures to the perception, hearing and speech
guides, each a realistic result drawn by its own .plot(): the tone prominence
verdict, the ISO/PAS 20065 tone levels, the ISO/PAS 1996-3 onset detection,
the ISO 532-2 specific loudness, the ECMA-418-2 specific tonality, the
specific fluctuation strength, the SII band audibility under a hearing loss,
the ISO 7029 fractile band, the ISO 1999 NIPTS audiogram, the STOI per-band
correlation and the IEC 60268-16 per-band MTI. Every figure is embedded in
the English guide, the Spanish mirror and the docs mirror with the dual
snippet block, and every plottable snippet on those pages now names its
.plot().
Prose: the tone-prominence guide gains a comparison of the four tonality
assessments the library implements and when each applies, the
hearing-threshold guide explains how the ISO 7029 fractiles feed the ISO 1999
age component and gains a See-also section, and the objective-intelligibility
guide gains the "which measure, and when" section that existed only in the
docs mirror, extended with the STOI/ESTOI, STI and SII choice.
Also label the STOI band axis at whole-hertz resolution and let the shaded
critical band of the tone-audibility levels plot follow the figure
background, so it reads on the white report page and on dark figures alike.
* Correct two figure alt texts against the plotted values
The ISO 7029 fractile figure describes the median and the 90 % fractile with
the values it actually draws (10 to 50 dB and 22 to 74 dB), and the
ECMA-418-2 specific tonality peak is at 9 Bark_HMS.
Perception, hearing and speech guides: result figures and when-to-use prose (#361)
* Perception, hearing and speech guides: result figures and when-to-use prose
Add ToneAssessment.plot(), which draws an ECMA-418-1 tone against the
prominence criterion of its own method (recovered from criterion_db) over the
whole range of interest, with the deciding margin marked, and a
view="levels" option on ToneAudibilityResult.plot() that exposes the
level-versus-frequency view the ISO 1996-2 fiche already embedded.
Add eleven single-concept figures to the perception, hearing and speech
guides, each a realistic result drawn by its own .plot(): the tone prominence
verdict, the ISO/PAS 20065 tone levels, the ISO/PAS 1996-3 onset detection,
the ISO 532-2 specific loudness, the ECMA-418-2 specific tonality, the
specific fluctuation strength, the SII band audibility under a hearing loss,
the ISO 7029 fractile band, the ISO 1999 NIPTS audiogram, the STOI per-band
correlation and the IEC 60268-16 per-band MTI. Every figure is embedded in
the English guide, the Spanish mirror and the docs mirror with the dual
snippet block, and every plottable snippet on those pages now names its
.plot().
Prose: the tone-prominence guide gains a comparison of the four tonality
assessments the library implements and when each applies, the
hearing-threshold guide explains how the ISO 7029 fractiles feed the ISO 1999
age component and gains a See-also section, and the objective-intelligibility
guide gains the "which measure, and when" section that existed only in the
docs mirror, extended with the STOI/ESTOI, STI and SII choice.
Also label the STOI band axis at whole-hertz resolution and let the shaded
critical band of the tone-audibility levels plot follow the figure
background, so it reads on the white report page and on dark figures alike.
* Correct two figure alt texts against the plotted values
The ISO 7029 fractile figure describes the median and the 90 % fractile with
the values it actually draws (10 to 50 dB and 22 to 74 dB), and the
ECMA-418-2 specific tonality peak is at 9 Bark_HMS.
Spanish docs: UNE terminology, decimal commas, localized snippets and theory figures (#365)
* Normalize Spanish docs prose to UNE acoustic terminology
Sweep the Spanish pages for the non-UNE forms "presion sonora",
"potencia sonora" and "intensidad sonora" and normalize the prose to
the wording used by the official Spanish editions of the standards:
"presion acustica" (UNE-EN ISO 16283-2:2016, UNE-EN ISO 10052:2005,
UNE-EN ISO 3746:2011, UNE-ISO 226:2013), "potencia acustica"
(UNE-EN ISO 3746:2011, UNE-EN ISO 4871:2010, UNE-EN ISO 9614-1:2010),
"intensidad acustica" (UNE-EN 61043:1999, UNE-EN ISO 9614-1:2010) and
"nivel de presion acustica de impactos" (UNE-EN ISO 12354-2:2018,
UNE-EN ISO 717-2:2013). 92 replacements across 32 pages, prose only:
code snippets keep the labels they share with the generated figures.
Rename the intensity guide to "Intensidad acustica (p-p)" and the
structure-borne power guide to "Potencia acustica estructural de
equipos (EN 15657)", updating every cross-link text and the theory
anchor intensidad-sonora-iec-61043 accordingly. The API sidebar group
label becomes "Potencia acustica e intensidad" via api_taxonomy.py
with the generated sidebar regenerated.
* Use decimal commas in Spanish docs prose quantities
Sweep every Spanish page for decimal points leaking into prose numbers
and switch them to the comma the locale convention calls for: the
rotorcraft validation prose (fourteen tolerances such as 0,08 dB(A) and
0,5 s), the insulation-prediction worked example (53,6 dB / 53,8 dB),
the tone-audibility Annex E tone (137,3 Hz), the Mackenzie check value
(1550,744 m/s), the EPNL, loudness and absorption fiche descriptions
(98,3 EPNdB; 8,2 sonos and 70,4 fonios; 0,60 y 0,55), the junction
constants table and the third-octave band-edge table in the signal
analysis theory page. Code snippets, inline code, math, clause numbers
and quoted source text keep their points.
* Pass language="es" in Spanish figure-reproduction snippets
The <details> blocks under each localized figure in the Spanish guides
are meant to reproduce the _es variant shown on the page, but 82 of the
one-line result .plot() calls omitted the language="es" argument and
would render English axis labels instead. Add the argument across 33
guides, matching the pattern the intensity field-indicators snippet
already used. The three lab-insulation results whose plot() does not
take a language argument (lab airborne, lab impact and the
element-normalized intensity difference) are left as they were.
* Extend the UNE terminology sweep to sound absorption
Normalize "absorción sonora" to "absorción acústica" across the
Spanish pages (36 occurrences in 14 pages, including the EN 12354-6
guide title and the theory headings), the wording of UNE-EN ISO
3746:2011 and of the equivalent absorption area in UNE-EN ISO
10140-3:2011, UNE-EN ISO 12354-2:2018 and UNE-EN ISO 16283-2:2016, and
the same term the accredited report strings already use. Also restore
the accent in the theory index anchor to the renamed intensity heading,
since heading slugs keep accented characters.
* Theory pages: illustrate each section family with existing result figures
The seven theory pages carried no figures at all. Embed sixteen of the
existing generated figures (light and dark variants, Spanish variants on
the Spanish mirrors) where the concept matches the prose: weighting
curves, time integration and the p-p intensity estimator in the signal
analysis page; equal-loudness contours, the specific-loudness pattern
and the hearing-threshold panels in perception; NC/RC rating, the
Schroeder decay and the ISO 717-1 shifted reference in rooms and
buildings; the Lden profile, ISO 9613-1 absorption and the three sound
power routes in environment and transport; the scattering coefficient
and ISO 11654 rating in materials and surfaces; and the Wk weighting and
the resonator mobility triplet in vibration. Each embed reuses the alt
text of the guide that owns the figure and adds a one-line caption.
Also give the wave-simulation section hub the reading-order paragraph
its siblings already have, linking the closed-form pages the FDTD solver
cross-checks, in both languages.
* Address review findings from the Spanish locale sweeps
Second pass fixes flagged by review: five terminology occurrences the
line-based sweep missed because the noun and adjective were split by a
line wrap or emphasis markup (sound-power, rotorcraft-noise and two
section hubs); six Spanish pages that still embedded the English figure
variant although the _es variant exists (junction-transmission,
aircraft-noise airport contour, miso-coherence,
objective-intelligibility, psychoacoustic-annoyance twice); and 19 more
language="es" arguments on figure-reproduction plot calls the first
pass missed, chained-call receivers such as room.noise_criterion(spl)
.plot() and the axes-creating first call of the two-profile
atmospheric-refraction snippet among them. The lab-insulation plot
wrappers forward keyword arguments to the rating plot, so the three
calls excluded earlier now take the argument too. All Spanish python
fences re-checked to compile and EN/ES parity re-verified.
* Carry the UNE terminology into the generated-asset Spanish strings
Apply the same evidence-based decisions to every Spanish string source
that feeds generated assets: the translation tables of
generate_graphs.py and generate_diagrams.py, the _STRINGS tables of the
plot modules and the report i18n values. 35 strings change: "presión
acústica" (UNE-EN ISO 16283-2:2016, 10052:2005, 3746:2011),
"potencia acústica" (UNE-EN ISO 3746:2011, 4871:2010, 9614-1:2010),
"intensidad acústica" (UNE-EN 61043:1999, 9614-1:2010), "absorción
acústica" (UNE-EN ISO 3746:2011) and "nivel de presión acústica de
impactos" (UNE-EN ISO 12354-2:2018). Strings the UNE editions keep are
untouched: "emisión sonora", "exposición sonora", "campo sonoro",
"fuente sonora". Only Spanish values change; the English keys stay.
The two plot-i18n test assertions that pin the axis label follow, and
the eight Spanish doc fences that deliberately mirrored the old figure
labels now mirror the new ones.
* Regenerate the Spanish figure variants with the UNE terminology
make graphs after the string-source change: 48 files, all of them _es
or _es_dark variants (24 figure/diagram pairs), picking up "presión
acústica", "potencia acústica", "intensidad acústica", "absorción
acústica" and "nivel de presión acústica de impactos" in titles and
axis labels. The English variants are untouched. The committed example
fiches need no regeneration: every example in generate_reports.py
renders in English, so no changed Spanish report string reaches them.
* Align the intensity-fiche Spanish assertions with the UNE terminology
Spanish docs: UNE terminology, decimal commas, localized snippets and theory figures (#365)
* Normalize Spanish docs prose to UNE acoustic terminology
Sweep the Spanish pages for the non-UNE forms "presion sonora",
"potencia sonora" and "intensidad sonora" and normalize the prose to
the wording used by the official Spanish editions of the standards:
"presion acustica" (UNE-EN ISO 16283-2:2016, UNE-EN ISO 10052:2005,
UNE-EN ISO 3746:2011, UNE-ISO 226:2013), "potencia acustica"
(UNE-EN ISO 3746:2011, UNE-EN ISO 4871:2010, UNE-EN ISO 9614-1:2010),
"intensidad acustica" (UNE-EN 61043:1999, UNE-EN ISO 9614-1:2010) and
"nivel de presion acustica de impactos" (UNE-EN ISO 12354-2:2018,
UNE-EN ISO 717-2:2013). 92 replacements across 32 pages, prose only:
code snippets keep the labels they share with the generated figures.
Rename the intensity guide to "Intensidad acustica (p-p)" and the
structure-borne power guide to "Potencia acustica estructural de
equipos (EN 15657)", updating every cross-link text and the theory
anchor intensidad-sonora-iec-61043 accordingly. The API sidebar group
label becomes "Potencia acustica e intensidad" via api_taxonomy.py
with the generated sidebar regenerated.
* Use decimal commas in Spanish docs prose quantities
Sweep every Spanish page for decimal points leaking into prose numbers
and switch them to the comma the locale convention calls for: the
rotorcraft validation prose (fourteen tolerances such as 0,08 dB(A) and
0,5 s), the insulation-prediction worked example (53,6 dB / 53,8 dB),
the tone-audibility Annex E tone (137,3 Hz), the Mackenzie check value
(1550,744 m/s), the EPNL, loudness and absorption fiche descriptions
(98,3 EPNdB; 8,2 sonos and 70,4 fonios; 0,60 y 0,55), the junction
constants table and the third-octave band-edge table in the signal
analysis theory page. Code snippets, inline code, math, clause numbers
and quoted source text keep their points.
* Pass language="es" in Spanish figure-reproduction snippets
The <details> blocks under each localized figure in the Spanish guides
are meant to reproduce the _es variant shown on the page, but 82 of the
one-line result .plot() calls omitted the language="es" argument and
would render English axis labels instead. Add the argument across 33
guides, matching the pattern the intensity field-indicators snippet
already used. The three lab-insulation results whose plot() does not
take a language argument (lab airborne, lab impact and the
element-normalized intensity difference) are left as they were.
* Extend the UNE terminology sweep to sound absorption
Normalize "absorción sonora" to "absorción acústica" across the
Spanish pages (36 occurrences in 14 pages, including the EN 12354-6
guide title and the theory headings), the wording of UNE-EN ISO
3746:2011 and of the equivalent absorption area in UNE-EN ISO
10140-3:2011, UNE-EN ISO 12354-2:2018 and UNE-EN ISO 16283-2:2016, and
the same term the accredited report strings already use. Also restore
the accent in the theory index anchor to the renamed intensity heading,
since heading slugs keep accented characters.
* Theory pages: illustrate each section family with existing result figures
The seven theory pages carried no figures at all. Embed sixteen of the
existing generated figures (light and dark variants, Spanish variants on
the Spanish mirrors) where the concept matches the prose: weighting
curves, time integration and the p-p intensity estimator in the signal
analysis page; equal-loudness contours, the specific-loudness pattern
and the hearing-threshold panels in perception; NC/RC rating, the
Schroeder decay and the ISO 717-1 shifted reference in rooms and
buildings; the Lden profile, ISO 9613-1 absorption and the three sound
power routes in environment and transport; the scattering coefficient
and ISO 11654 rating in materials and surfaces; and the Wk weighting and
the resonator mobility triplet in vibration. Each embed reuses the alt
text of the guide that owns the figure and adds a one-line caption.
Also give the wave-simulation section hub the reading-order paragraph
its siblings already have, linking the closed-form pages the FDTD solver
cross-checks, in both languages.
* Address review findings from the Spanish locale sweeps
Second pass fixes flagged by review: five terminology occurrences the
line-based sweep missed because the noun and adjective were split by a
line wrap or emphasis markup (sound-power, rotorcraft-noise and two
section hubs); six Spanish pages that still embedded the English figure
variant although the _es variant exists (junction-transmission,
aircraft-noise airport contour, miso-coherence,
objective-intelligibility, psychoacoustic-annoyance twice); and 19 more
language="es" arguments on figure-reproduction plot calls the first
pass missed, chained-call receivers such as room.noise_criterion(spl)
.plot() and the axes-creating first call of the two-profile
atmospheric-refraction snippet among them. The lab-insulation plot
wrappers forward keyword arguments to the rating plot, so the three
calls excluded earlier now take the argument too. All Spanish python
fences re-checked to compile and EN/ES parity re-verified.
* Carry the UNE terminology into the generated-asset Spanish strings
Apply the same evidence-based decisions to every Spanish string source
that feeds generated assets: the translation tables of
generate_graphs.py and generate_diagrams.py, the _STRINGS tables of the
plot modules and the report i18n values. 35 strings change: "presión
acústica" (UNE-EN ISO 16283-2:2016, 10052:2005, 3746:2011),
"potencia acústica" (UNE-EN ISO 3746:2011, 4871:2010, 9614-1:2010),
"intensidad acústica" (UNE-EN 61043:1999, 9614-1:2010), "absorción
acústica" (UNE-EN ISO 3746:2011) and "nivel de presión acústica de
impactos" (UNE-EN ISO 12354-2:2018). Strings the UNE editions keep are
untouched: "emisión sonora", "exposición sonora", "campo sonoro",
"fuente sonora". Only Spanish values change; the English keys stay.
The two plot-i18n test assertions that pin the axis label follow, and
the eight Spanish doc fences that deliberately mirrored the old figure
labels now mirror the new ones.
* Regenerate the Spanish figure variants with the UNE terminology
make graphs after the string-source change: 48 files, all of them _es
or _es_dark variants (24 figure/diagram pairs), picking up "presión
acústica", "potencia acústica", "intensidad acústica", "absorción
acústica" and "nivel de presión acústica de impactos" in titles and
axis labels. The English variants are untouched. The committed example
fiches need no regeneration: every example in generate_reports.py
renders in English, so no changed Spanish report string reaches them.
* Align the intensity-fiche Spanish assertions with the UNE terminology
Building and structure-borne guides: result figures, plot mentions and mirror sync (#360)
* Add .plot() to the ISO 717 enlarged-range rating results
ExtendedWeightedRatingResult and ExtendedImpactRatingResult now carry the
full enlarged-range band curve (band_centers, measured) and expose a
.plot() that draws the measured curve over the whole range against the
shifted ISO 717 reference on the 16 core bands, with the unfavourable
deviations shaded, the enlarged-range bands marked and every covered
Annex B / A.2.1 adaptation term in the title. EN/ES labels follow the
existing renderer conventions.
* Field insulation guide: enlarged-range, field-chain, facade and survey-impact figures
Four new deterministic figures (extended_insulation_rating,
field_airborne_insulation, facade_field_insulation,
survey_impact_insulation) generated in the four language/theme variants,
embedded next to their snippets in the EN guide, the ES mirror and the
docs mirror with the dual usage/hand-written code blocks. One-line
.plot() mentions added for the extended rating, the field airborne
result, the survey impact result and the ISO 12999-1 band uncertainty.
The docs mirror gains the previously missing ISO 10052 survey-reports
section, and the survey snippet now defines the li and l1_2m inputs it
uses. Multi-line figure info boxes are translated as whole artists, and
the review fixes (headroom, legend placement, proper unit and Greek
glyphs) are applied to the new generators.
* Laboratory insulation guide: ISO 10140, ISO 15186-1 element and ISO 10848 Dn,f figures
Embed the new lab_insulation_result, intensity_element_insulation and
flanking_level_difference figures next to their snippets in the EN guide,
the ES mirror and the docs mirror, each with the dual usage/hand-written
code blocks. Add the one-line .plot() mentions for the laboratory
airborne result, the element-normalized intensity result and the
floor-covering improvement result, and a note on when Dn,f plots (the
inline example uses 9 bands, below the 16/5-band rating threshold).
* EN 12354 prediction guide: impact-term and radiated-power figures
Embed the new impact_prediction_terms and radiated_power_outdoor figures
next to their snippets in the EN guide, the ES mirror and the docs
mirror, with the dual usage/hand-written code blocks, and add the
one-line .plot() mentions for the airborne prediction, the impact
prediction, the facade prediction and the radiated-power result.
* Panel insulation guide: rated Sharp prediction figure and plot mentions
Embed the new single_panel_rating figure (the 6 mm glass Sharp prediction
rated per ISO 717-1, coincidence dip marked) in the EN guide, the ES
mirror and the docs mirror with the dual code blocks, and add the
one-line .plot() mentions for the single-panel, double-wall and
radiation-efficiency results next to the existing concept figure.
* Junction transmission guide: Kij design chart, EN 12354 worked example and see-also
Add the junction_kij_thickness figure (wave-approach Kij versus the plate
thickness ratio for the X, T and L junctions, identical-plates value
marked) next to the coupling-loss-factor section, a res.plot() mention
in its snippet, a worked example that feeds the predicted K12 = 9.8 dB
of the 100/200 mm concrete X-junction into the EN 12354-1 flanking model
(R'w = 55.4 dB, direct path dominant), and a See-also section linking
the prediction, laboratory, structure-borne power and mobility guides.
EN guide, ES mirror and docs mirror in sync.
* Junction transmission docs mirror: sync the Kij chart, worked example and see-also
* Structure-borne power and installed-source guides: plot mentions, Hopkins citation and see-also
Add the one-line .plot() mentions for the reception-plate power result
(EN 15657) and the installed-source prediction (EN 12354-5) next to their
existing figures, add the one-line .plot() usage to both figures' code
blocks, cite Hopkins (2007) Section 2.8 for the point-excited-plate power
input behind the clause 4.4.3 coupling term with a prose paragraph
connecting the mobility chain, and give the EN 12354-5 page a proper
See-also linking the EN 15657, ISO 7626, junction and EN 12354 guides.
EN guides, ES mirrors and docs mirrors in sync.
* Vibration FRF guides: plot mentions and transfer-stiffness docs sync
Add the one-line .plot() usage and mentions for the ISO/TS 7849
sound-power-from-vibration result, the EN 29052-1 dynamic-stiffness
result and the ISO 10846 indirect transfer-stiffness result next to
their existing figures (EN guides, ES mirrors and docs mirrors), and
port the previously missing ISO 10846 test-report fiche section to the
transfer-stiffness docs mirror.
* Mechanical mobility guide: driving-point reading figure
Embed the new mobility_result_lines figure (|Y(f)| of the SDOF bundle
with the stiffness line, the mass line and the 1/c damping peak) next to
the MobilityResult snippet in the EN guide, the ES mirror and the docs
mirror, with the dual usage/hand-written code blocks and the one-line
res.plot() mention.
* Human vibration and multiple-shock guides: one-line plot mentions
Add the res.plot() one-liners next to the existing figures for the
ISO 8041-1 weighting response, the ISO 2631-1 weighted band spectrum, the
Directive 2002/44/EC daily exposure A(8) and the ISO 2631-5 multiple-shock
assessment, in the EN guides, the ES mirrors and the docs mirrors.
* Docs mirrors: restore missing report-fiche and concept sections
Sync the docs mirrors of the pages touched by this wave with their site
guides: the ISO 16283-3 facade report subsection on the field insulation
page, the EN 29052-1 and ISO 7626 fiche example snippets, and the panel
concept-figure code block.
* Changelog, API docs and llms regeneration; lint and typing fixes for the figure generators
* Fix nested emphasis in the survey-impact figure captions
* Restore the numerical-propagation rasters truncated by a mid-regeneration snapshot
* Reconcile the figure-script additions with the rooms and materials wave
* docs: regenerate the llms bundle after the figure-script reconciliation
Building and structure-borne guides: result figures, plot mentions and mirror sync (#360)
* Add .plot() to the ISO 717 enlarged-range rating results
ExtendedWeightedRatingResult and ExtendedImpactRatingResult now carry the
full enlarged-range band curve (band_centers, measured) and expose a
.plot() that draws the measured curve over the whole range against the
shifted ISO 717 reference on the 16 core bands, with the unfavourable
deviations shaded, the enlarged-range bands marked and every covered
Annex B / A.2.1 adaptation term in the title. EN/ES labels follow the
existing renderer conventions.
* Field insulation guide: enlarged-range, field-chain, facade and survey-impact figures
Four new deterministic figures (extended_insulation_rating,
field_airborne_insulation, facade_field_insulation,
survey_impact_insulation) generated in the four language/theme variants,
embedded next to their snippets in the EN guide, the ES mirror and the
docs mirror with the dual usage/hand-written code blocks. One-line
.plot() mentions added for the extended rating, the field airborne
result, the survey impact result and the ISO 12999-1 band uncertainty.
The docs mirror gains the previously missing ISO 10052 survey-reports
section, and the survey snippet now defines the li and l1_2m inputs it
uses. Multi-line figure info boxes are translated as whole artists, and
the review fixes (headroom, legend placement, proper unit and Greek
glyphs) are applied to the new generators.
* Laboratory insulation guide: ISO 10140, ISO 15186-1 element and ISO 10848 Dn,f figures
Embed the new lab_insulation_result, intensity_element_insulation and
flanking_level_difference figures next to their snippets in the EN guide,
the ES mirror and the docs mirror, each with the dual usage/hand-written
code blocks. Add the one-line .plot() mentions for the laboratory
airborne result, the element-normalized intensity result and the
floor-covering improvement result, and a note on when Dn,f plots (the
inline example uses 9 bands, below the 16/5-band rating threshold).
* EN 12354 prediction guide: impact-term and radiated-power figures
Embed the new impact_prediction_terms and radiated_power_outdoor figures
next to their snippets in the EN guide, the ES mirror and the docs
mirror, with the dual usage/hand-written code blocks, and add the
one-line .plot() mentions for the airborne prediction, the impact
prediction, the facade prediction and the radiated-power result.
* Panel insulation guide: rated Sharp prediction figure and plot mentions
Embed the new single_panel_rating figure (the 6 mm glass Sharp prediction
rated per ISO 717-1, coincidence dip marked) in the EN guide, the ES
mirror and the docs mirror with the dual code blocks, and add the
one-line .plot() mentions for the single-panel, double-wall and
radiation-efficiency results next to the existing concept figure.
* Junction transmission guide: Kij design chart, EN 12354 worked example and see-also
Add the junction_kij_thickness figure (wave-approach Kij versus the plate
thickness ratio for the X, T and L junctions, identical-plates value
marked) next to the coupling-loss-factor section, a res.plot() mention
in its snippet, a worked example that feeds the predicted K12 = 9.8 dB
of the 100/200 mm concrete X-junction into the EN 12354-1 flanking model
(R'w = 55.4 dB, direct path dominant), and a See-also section linking
the prediction, laboratory, structure-borne power and mobility guides.
EN guide, ES mirror and docs mirror in sync.
* Junction transmission docs mirror: sync the Kij chart, worked example and see-also
* Structure-borne power and installed-source guides: plot mentions, Hopkins citation and see-also
Add the one-line .plot() mentions for the reception-plate power result
(EN 15657) and the installed-source prediction (EN 12354-5) next to their
existing figures, add the one-line .plot() usage to both figures' code
blocks, cite Hopkins (2007) Section 2.8 for the point-excited-plate power
input behind the clause 4.4.3 coupling term with a prose paragraph
connecting the mobility chain, and give the EN 12354-5 page a proper
See-also linking the EN 15657, ISO 7626, junction and EN 12354 guides.
EN guides, ES mirrors and docs mirrors in sync.
* Vibration FRF guides: plot mentions and transfer-stiffness docs sync
Add the one-line .plot() usage and mentions for the ISO/TS 7849
sound-power-from-vibration result, the EN 29052-1 dynamic-stiffness
result and the ISO 10846 indirect transfer-stiffness result next to
their existing figures (EN guides, ES mirrors and docs mirrors), and
port the previously missing ISO 10846 test-report fiche section to the
transfer-stiffness docs mirror.
* Mechanical mobility guide: driving-point reading figure
Embed the new mobility_result_lines figure (|Y(f)| of the SDOF bundle
with the stiffness line, the mass line and the 1/c damping peak) next to
the MobilityResult snippet in the EN guide, the ES mirror and the docs
mirror, with the dual usage/hand-written code blocks and the one-line
res.plot() mention.
* Human vibration and multiple-shock guides: one-line plot mentions
Add the res.plot() one-liners next to the existing figures for the
ISO 8041-1 weighting response, the ISO 2631-1 weighted band spectrum, the
Directive 2002/44/EC daily exposure A(8) and the ISO 2631-5 multiple-shock
assessment, in the EN guides, the ES mirrors and the docs mirrors.
* Docs mirrors: restore missing report-fiche and concept sections
Sync the docs mirrors of the pages touched by this wave with their site
guides: the ISO 16283-3 facade report subsection on the field insulation
page, the EN 29052-1 and ISO 7626 fiche example snippets, and the panel
concept-figure code block.
* Changelog, API docs and llms regeneration; lint and typing fixes for the figure generators
* Fix nested emphasis in the survey-impact figure captions
* Restore the numerical-propagation rasters truncated by a mid-regeneration snapshot
* Reconcile the figure-script additions with the rooms and materials wave
* docs: regenerate the llms bundle after the figure-script reconciliation
Spanish docs: UNE terminology, decimal commas, localized snippets and theory figures (#365)
* Normalize Spanish docs prose to UNE acoustic terminology
Sweep the Spanish pages for the non-UNE forms "presion sonora",
"potencia sonora" and "intensidad sonora" and normalize the prose to
the wording used by the official Spanish editions of the standards:
"presion acustica" (UNE-EN ISO 16283-2:2016, UNE-EN ISO 10052:2005,
UNE-EN ISO 3746:2011, UNE-ISO 226:2013), "potencia acustica"
(UNE-EN ISO 3746:2011, UNE-EN ISO 4871:2010, UNE-EN ISO 9614-1:2010),
"intensidad acustica" (UNE-EN 61043:1999, UNE-EN ISO 9614-1:2010) and
"nivel de presion acustica de impactos" (UNE-EN ISO 12354-2:2018,
UNE-EN ISO 717-2:2013). 92 replacements across 32 pages, prose only:
code snippets keep the labels they share with the generated figures.
Rename the intensity guide to "Intensidad acustica (p-p)" and the
structure-borne power guide to "Potencia acustica estructural de
equipos (EN 15657)", updating every cross-link text and the theory
anchor intensidad-sonora-iec-61043 accordingly. The API sidebar group
label becomes "Potencia acustica e intensidad" via api_taxonomy.py
with the generated sidebar regenerated.
* Use decimal commas in Spanish docs prose quantities
Sweep every Spanish page for decimal points leaking into prose numbers
and switch them to the comma the locale convention calls for: the
rotorcraft validation prose (fourteen tolerances such as 0,08 dB(A) and
0,5 s), the insulation-prediction worked example (53,6 dB / 53,8 dB),
the tone-audibility Annex E tone (137,3 Hz), the Mackenzie check value
(1550,744 m/s), the EPNL, loudness and absorption fiche descriptions
(98,3 EPNdB; 8,2 sonos and 70,4 fonios; 0,60 y 0,55), the junction
constants table and the third-octave band-edge table in the signal
analysis theory page. Code snippets, inline code, math, clause numbers
and quoted source text keep their points.
* Pass language="es" in Spanish figure-reproduction snippets
The <details> blocks under each localized figure in the Spanish guides
are meant to reproduce the _es variant shown on the page, but 82 of the
one-line result .plot() calls omitted the language="es" argument and
would render English axis labels instead. Add the argument across 33
guides, matching the pattern the intensity field-indicators snippet
already used. The three lab-insulation results whose plot() does not
take a language argument (lab airborne, lab impact and the
element-normalized intensity difference) are left as they were.
* Extend the UNE terminology sweep to sound absorption
Normalize "absorción sonora" to "absorción acústica" across the
Spanish pages (36 occurrences in 14 pages, including the EN 12354-6
guide title and the theory headings), the wording of UNE-EN ISO
3746:2011 and of the equivalent absorption area in UNE-EN ISO
10140-3:2011, UNE-EN ISO 12354-2:2018 and UNE-EN ISO 16283-2:2016, and
the same term the accredited report strings already use. Also restore
the accent in the theory index anchor to the renamed intensity heading,
since heading slugs keep accented characters.
* Theory pages: illustrate each section family with existing result figures
The seven theory pages carried no figures at all. Embed sixteen of the
existing generated figures (light and dark variants, Spanish variants on
the Spanish mirrors) where the concept matches the prose: weighting
curves, time integration and the p-p intensity estimator in the signal
analysis page; equal-loudness contours, the specific-loudness pattern
and the hearing-threshold panels in perception; NC/RC rating, the
Schroeder decay and the ISO 717-1 shifted reference in rooms and
buildings; the Lden profile, ISO 9613-1 absorption and the three sound
power routes in environment and transport; the scattering coefficient
and ISO 11654 rating in materials and surfaces; and the Wk weighting and
the resonator mobility triplet in vibration. Each embed reuses the alt
text of the guide that owns the figure and adds a one-line caption.
Also give the wave-simulation section hub the reading-order paragraph
its siblings already have, linking the closed-form pages the FDTD solver
cross-checks, in both languages.
* Address review findings from the Spanish locale sweeps
Second pass fixes flagged by review: five terminology occurrences the
line-based sweep missed because the noun and adjective were split by a
line wrap or emphasis markup (sound-power, rotorcraft-noise and two
section hubs); six Spanish pages that still embedded the English figure
variant although the _es variant exists (junction-transmission,
aircraft-noise airport contour, miso-coherence,
objective-intelligibility, psychoacoustic-annoyance twice); and 19 more
language="es" arguments on figure-reproduction plot calls the first
pass missed, chained-call receivers such as room.noise_criterion(spl)
.plot() and the axes-creating first call of the two-profile
atmospheric-refraction snippet among them. The lab-insulation plot
wrappers forward keyword arguments to the rating plot, so the three
calls excluded earlier now take the argument too. All Spanish python
fences re-checked to compile and EN/ES parity re-verified.
* Carry the UNE terminology into the generated-asset Spanish strings
Apply the same evidence-based decisions to every Spanish string source
that feeds generated assets: the translation tables of
generate_graphs.py and generate_diagrams.py, the _STRINGS tables of the
plot modules and the report i18n values. 35 strings change: "presión
acústica" (UNE-EN ISO 16283-2:2016, 10052:2005, 3746:2011),
"potencia acústica" (UNE-EN ISO 3746:2011, 4871:2010, 9614-1:2010),
"intensidad acústica" (UNE-EN 61043:1999, 9614-1:2010), "absorción
acústica" (UNE-EN ISO 3746:2011) and "nivel de presión acústica de
impactos" (UNE-EN ISO 12354-2:2018). Strings the UNE editions keep are
untouched: "emisión sonora", "exposición sonora", "campo sonoro",
"fuente sonora". Only Spanish values change; the English keys stay.
The two plot-i18n test assertions that pin the axis label follow, and
the eight Spanish doc fences that deliberately mirrored the old figure
labels now mirror the new ones.
* Regenerate the Spanish figure variants with the UNE terminology
make graphs after the string-source change: 48 files, all of them _es
or _es_dark variants (24 figure/diagram pairs), picking up "presión
acústica", "potencia acústica", "intensidad acústica", "absorción
acústica" and "nivel de presión acústica de impactos" in titles and
axis labels. The English variants are untouched. The committed example
fiches need no regeneration: every example in generate_reports.py
renders in English, so no changed Spanish report string reaches them.
* Align the intensity-fiche Spanish assertions with the UNE terminology
Spanish docs: UNE terminology, decimal commas, localized snippets and theory figures (#365)
* Normalize Spanish docs prose to UNE acoustic terminology
Sweep the Spanish pages for the non-UNE forms "presion sonora",
"potencia sonora" and "intensidad sonora" and normalize the prose to
the wording used by the official Spanish editions of the standards:
"presion acustica" (UNE-EN ISO 16283-2:2016, UNE-EN ISO 10052:2005,
UNE-EN ISO 3746:2011, UNE-ISO 226:2013), "potencia acustica"
(UNE-EN ISO 3746:2011, UNE-EN ISO 4871:2010, UNE-EN ISO 9614-1:2010),
"intensidad acustica" (UNE-EN 61043:1999, UNE-EN ISO 9614-1:2010) and
"nivel de presion acustica de impactos" (UNE-EN ISO 12354-2:2018,
UNE-EN ISO 717-2:2013). 92 replacements across 32 pages, prose only:
code snippets keep the labels they share with the generated figures.
Rename the intensity guide to "Intensidad acustica (p-p)" and the
structure-borne power guide to "Potencia acustica estructural de
equipos (EN 15657)", updating every cross-link text and the theory
anchor intensidad-sonora-iec-61043 accordingly. The API sidebar group
label becomes "Potencia acustica e intensidad" via api_taxonomy.py
with the generated sidebar regenerated.
* Use decimal commas in Spanish docs prose quantities
Sweep every Spanish page for decimal points leaking into prose numbers
and switch them to the comma the locale convention calls for: the
rotorcraft validation prose (fourteen tolerances such as 0,08 dB(A) and
0,5 s), the insulation-prediction worked example (53,6 dB / 53,8 dB),
the tone-audibility Annex E tone (137,3 Hz), the Mackenzie check value
(1550,744 m/s), the EPNL, loudness and absorption fiche descriptions
(98,3 EPNdB; 8,2 sonos and 70,4 fonios; 0,60 y 0,55), the junction
constants table and the third-octave band-edge table in the signal
analysis theory page. Code snippets, inline code, math, clause numbers
and quoted source text keep their points.
* Pass language="es" in Spanish figure-reproduction snippets
The <details> blocks under each localized figure in the Spanish guides
are meant to reproduce the _es variant shown on the page, but 82 of the
one-line result .plot() calls omitted the language="es" argument and
would render English axis labels instead. Add the argument across 33
guides, matching the pattern the intensity field-indicators snippet
already used. The three lab-insulation results whose plot() does not
take a language argument (lab airborne, lab impact and the
element-normalized intensity difference) are left as they were.
* Extend the UNE terminology sweep to sound absorption
Normalize "absorción sonora" to "absorción acústica" across the
Spanish pages (36 occurrences in 14 pages, including the EN 12354-6
guide title and the theory headings), the wording of UNE-EN ISO
3746:2011 and of the equivalent absorption area in UNE-EN ISO
10140-3:2011, UNE-EN ISO 12354-2:2018 and UNE-EN ISO 16283-2:2016, and
the same term the accredited report strings already use. Also restore
the accent in the theory index anchor to the renamed intensity heading,
since heading slugs keep accented characters.
* Theory pages: illustrate each section family with existing result figures
The seven theory pages carried no figures at all. Embed sixteen of the
existing generated figures (light and dark variants, Spanish variants on
the Spanish mirrors) where the concept matches the prose: weighting
curves, time integration and the p-p intensity estimator in the signal
analysis page; equal-loudness contours, the specific-loudness pattern
and the hearing-threshold panels in perception; NC/RC rating, the
Schroeder decay and the ISO 717-1 shifted reference in rooms and
buildings; the Lden profile, ISO 9613-1 absorption and the three sound
power routes in environment and transport; the scattering coefficient
and ISO 11654 rating in materials and surfaces; and the Wk weighting and
the resonator mobility triplet in vibration. Each embed reuses the alt
text of the guide that owns the figure and adds a one-line caption.
Also give the wave-simulation section hub the reading-order paragraph
its siblings already have, linking the closed-form pages the FDTD solver
cross-checks, in both languages.
* Address review findings from the Spanish locale sweeps
Second pass fixes flagged by review: five terminology occurrences the
line-based sweep missed because the noun and adjective were split by a
line wrap or emphasis markup (sound-power, rotorcraft-noise and two
section hubs); six Spanish pages that still embedded the English figure
variant although the _es variant exists (junction-transmission,
aircraft-noise airport contour, miso-coherence,
objective-intelligibility, psychoacoustic-annoyance twice); and 19 more
language="es" arguments on figure-reproduction plot calls the first
pass missed, chained-call receivers such as room.noise_criterion(spl)
.plot() and the axes-creating first call of the two-profile
atmospheric-refraction snippet among them. The lab-insulation plot
wrappers forward keyword arguments to the rating plot, so the three
calls excluded earlier now take the argument too. All Spanish python
fences re-checked to compile and EN/ES parity re-verified.
* Carry the UNE terminology into the generated-asset Spanish strings
Apply the same evidence-based decisions to every Spanish string source
that feeds generated assets: the translation tables of
generate_graphs.py and generate_diagrams.py, the _STRINGS tables of the
plot modules and the report i18n values. 35 strings change: "presión
acústica" (UNE-EN ISO 16283-2:2016, 10052:2005, 3746:2011),
"potencia acústica" (UNE-EN ISO 3746:2011, 4871:2010, 9614-1:2010),
"intensidad acústica" (UNE-EN 61043:1999, 9614-1:2010), "absorción
acústica" (UNE-EN ISO 3746:2011) and "nivel de presión acústica de
impactos" (UNE-EN ISO 12354-2:2018). Strings the UNE editions keep are
untouched: "emisión sonora", "exposición sonora", "campo sonoro",
"fuente sonora". Only Spanish values change; the English keys stay.
The two plot-i18n test assertions that pin the axis label follow, and
the eight Spanish doc fences that deliberately mirrored the old figure
labels now mirror the new ones.
* Regenerate the Spanish figure variants with the UNE terminology
make graphs after the string-source change: 48 files, all of them _es
or _es_dark variants (24 figure/diagram pairs), picking up "presión
acústica", "potencia acústica", "intensidad acústica", "absorción
acústica" and "nivel de presión acústica de impactos" in titles and
axis labels. The English variants are untouched. The committed example
fiches need no regeneration: every example in generate_reports.py
renders in English, so no changed Spanish report string reaches them.
* Align the intensity-fiche Spanish assertions with the UNE terminology
Perception, hearing and speech guides: result figures and when-to-use prose (#361)
* Perception, hearing and speech guides: result figures and when-to-use prose
Add ToneAssessment.plot(), which draws an ECMA-418-1 tone against the
prominence criterion of its own method (recovered from criterion_db) over the
whole range of interest, with the deciding margin marked, and a
view="levels" option on ToneAudibilityResult.plot() that exposes the
level-versus-frequency view the ISO 1996-2 fiche already embedded.
Add eleven single-concept figures to the perception, hearing and speech
guides, each a realistic result drawn by its own .plot(): the tone prominence
verdict, the ISO/PAS 20065 tone levels, the ISO/PAS 1996-3 onset detection,
the ISO 532-2 specific loudness, the ECMA-418-2 specific tonality, the
specific fluctuation strength, the SII band audibility under a hearing loss,
the ISO 7029 fractile band, the ISO 1999 NIPTS audiogram, the STOI per-band
correlation and the IEC 60268-16 per-band MTI. Every figure is embedded in
the English guide, the Spanish mirror and the docs mirror with the dual
snippet block, and every plottable snippet on those pages now names its
.plot().
Prose: the tone-prominence guide gains a comparison of the four tonality
assessments the library implements and when each applies, the
hearing-threshold guide explains how the ISO 7029 fractiles feed the ISO 1999
age component and gains a See-also section, and the objective-intelligibility
guide gains the "which measure, and when" section that existed only in the
docs mirror, extended with the STOI/ESTOI, STI and SII choice.
Also label the STOI band axis at whole-hertz resolution and let the shaded
critical band of the tone-audibility levels plot follow the figure
background, so it reads on the white report page and on dark figures alike.
* Correct two figure alt texts against the plotted values
The ISO 7029 fractile figure describes the median and the 90 % fractile with
the values it actually draws (10 to 50 dB and 22 to 74 dB), and the
ECMA-418-2 specific tonality peak is at 9 Bark_HMS.
Perception, hearing and speech guides: result figures and when-to-use prose (#361)
* Perception, hearing and speech guides: result figures and when-to-use prose
Add ToneAssessment.plot(), which draws an ECMA-418-1 tone against the
prominence criterion of its own method (recovered from criterion_db) over the
whole range of interest, with the deciding margin marked, and a
view="levels" option on ToneAudibilityResult.plot() that exposes the
level-versus-frequency view the ISO 1996-2 fiche already embedded.
Add eleven single-concept figures to the perception, hearing and speech
guides, each a realistic result drawn by its own .plot(): the tone prominence
verdict, the ISO/PAS 20065 tone levels, the ISO/PAS 1996-3 onset detection,
the ISO 532-2 specific loudness, the ECMA-418-2 specific tonality, the
specific fluctuation strength, the SII band audibility under a hearing loss,
the ISO 7029 fractile band, the ISO 1999 NIPTS audiogram, the STOI per-band
correlation and the IEC 60268-16 per-band MTI. Every figure is embedded in
the English guide, the Spanish mirror and the docs mirror with the dual
snippet block, and every plottable snippet on those pages now names its
.plot().
Prose: the tone-prominence guide gains a comparison of the four tonality
assessments the library implements and when each applies, the
hearing-threshold guide explains how the ISO 7029 fractiles feed the ISO 1999
age component and gains a See-also section, and the objective-intelligibility
guide gains the "which measure, and when" section that existed only in the
docs mirror, extended with the STOI/ESTOI, STI and SII choice.
Also label the STOI band axis at whole-hertz resolution and let the shaded
critical band of the tone-audibility levels plot follow the figure
background, so it reads on the white report page and on dark figures alike.
* Correct two figure alt texts against the plotted values
The ISO 7029 fractile figure describes the median and the 90 % fractile with
the values it actually draws (10 to 50 dB and 22 to 74 dB), and the
ECMA-418-2 specific tonality peak is at 9 Bark_HMS.
Spanish docs: UNE terminology, decimal commas, localized snippets and theory figures (#365)
* Normalize Spanish docs prose to UNE acoustic terminology
Sweep the Spanish pages for the non-UNE forms "presion sonora",
"potencia sonora" and "intensidad sonora" and normalize the prose to
the wording used by the official Spanish editions of the standards:
"presion acustica" (UNE-EN ISO 16283-2:2016, UNE-EN ISO 10052:2005,
UNE-EN ISO 3746:2011, UNE-ISO 226:2013), "potencia acustica"
(UNE-EN ISO 3746:2011, UNE-EN ISO 4871:2010, UNE-EN ISO 9614-1:2010),
"intensidad acustica" (UNE-EN 61043:1999, UNE-EN ISO 9614-1:2010) and
"nivel de presion acustica de impactos" (UNE-EN ISO 12354-2:2018,
UNE-EN ISO 717-2:2013). 92 replacements across 32 pages, prose only:
code snippets keep the labels they share with the generated figures.
Rename the intensity guide to "Intensidad acustica (p-p)" and the
structure-borne power guide to "Potencia acustica estructural de
equipos (EN 15657)", updating every cross-link text and the theory
anchor intensidad-sonora-iec-61043 accordingly. The API sidebar group
label becomes "Potencia acustica e intensidad" via api_taxonomy.py
with the generated sidebar regenerated.
* Use decimal commas in Spanish docs prose quantities
Sweep every Spanish page for decimal points leaking into prose numbers
and switch them to the comma the locale convention calls for: the
rotorcraft validation prose (fourteen tolerances such as 0,08 dB(A) and
0,5 s), the insulation-prediction worked example (53,6 dB / 53,8 dB),
the tone-audibility Annex E tone (137,3 Hz), the Mackenzie check value
(1550,744 m/s), the EPNL, loudness and absorption fiche descriptions
(98,3 EPNdB; 8,2 sonos and 70,4 fonios; 0,60 y 0,55), the junction
constants table and the third-octave band-edge table in the signal
analysis theory page. Code snippets, inline code, math, clause numbers
and quoted source text keep their points.
* Pass language="es" in Spanish figure-reproduction snippets
The <details> blocks under each localized figure in the Spanish guides
are meant to reproduce the _es variant shown on the page, but 82 of the
one-line result .plot() calls omitted the language="es" argument and
would render English axis labels instead. Add the argument across 33
guides, matching the pattern the intensity field-indicators snippet
already used. The three lab-insulation results whose plot() does not
take a language argument (lab airborne, lab impact and the
element-normalized intensity difference) are left as they were.
* Extend the UNE terminology sweep to sound absorption
Normalize "absorción sonora" to "absorción acústica" across the
Spanish pages (36 occurrences in 14 pages, including the EN 12354-6
guide title and the theory headings), the wording of UNE-EN ISO
3746:2011 and of the equivalent absorption area in UNE-EN ISO
10140-3:2011, UNE-EN ISO 12354-2:2018 and UNE-EN ISO 16283-2:2016, and
the same term the accredited report strings already use. Also restore
the accent in the theory index anchor to the renamed intensity heading,
since heading slugs keep accented characters.
* Theory pages: illustrate each section family with existing result figures
The seven theory pages carried no figures at all. Embed sixteen of the
existing generated figures (light and dark variants, Spanish variants on
the Spanish mirrors) where the concept matches the prose: weighting
curves, time integration and the p-p intensity estimator in the signal
analysis page; equal-loudness contours, the specific-loudness pattern
and the hearing-threshold panels in perception; NC/RC rating, the
Schroeder decay and the ISO 717-1 shifted reference in rooms and
buildings; the Lden profile, ISO 9613-1 absorption and the three sound
power routes in environment and transport; the scattering coefficient
and ISO 11654 rating in materials and surfaces; and the Wk weighting and
the resonator mobility triplet in vibration. Each embed reuses the alt
text of the guide that owns the figure and adds a one-line caption.
Also give the wave-simulation section hub the reading-order paragraph
its siblings already have, linking the closed-form pages the FDTD solver
cross-checks, in both languages.
* Address review findings from the Spanish locale sweeps
Second pass fixes flagged by review: five terminology occurrences the
line-based sweep missed because the noun and adjective were split by a
line wrap or emphasis markup (sound-power, rotorcraft-noise and two
section hubs); six Spanish pages that still embedded the English figure
variant although the _es variant exists (junction-transmission,
aircraft-noise airport contour, miso-coherence,
objective-intelligibility, psychoacoustic-annoyance twice); and 19 more
language="es" arguments on figure-reproduction plot calls the first
pass missed, chained-call receivers such as room.noise_criterion(spl)
.plot() and the axes-creating first call of the two-profile
atmospheric-refraction snippet among them. The lab-insulation plot
wrappers forward keyword arguments to the rating plot, so the three
calls excluded earlier now take the argument too. All Spanish python
fences re-checked to compile and EN/ES parity re-verified.
* Carry the UNE terminology into the generated-asset Spanish strings
Apply the same evidence-based decisions to every Spanish string source
that feeds generated assets: the translation tables of
generate_graphs.py and generate_diagrams.py, the _STRINGS tables of the
plot modules and the report i18n values. 35 strings change: "presión
acústica" (UNE-EN ISO 16283-2:2016, 10052:2005, 3746:2011),
"potencia acústica" (UNE-EN ISO 3746:2011, 4871:2010, 9614-1:2010),
"intensidad acústica" (UNE-EN 61043:1999, 9614-1:2010), "absorción
acústica" (UNE-EN ISO 3746:2011) and "nivel de presión acústica de
impactos" (UNE-EN ISO 12354-2:2018). Strings the UNE editions keep are
untouched: "emisión sonora", "exposición sonora", "campo sonoro",
"fuente sonora". Only Spanish values change; the English keys stay.
The two plot-i18n test assertions that pin the axis label follow, and
the eight Spanish doc fences that deliberately mirrored the old figure
labels now mirror the new ones.
* Regenerate the Spanish figure variants with the UNE terminology
make graphs after the string-source change: 48 files, all of them _es
or _es_dark variants (24 figure/diagram pairs), picking up "presión
acústica", "potencia acústica", "intensidad acústica", "absorción
acústica" and "nivel de presión acústica de impactos" in titles and
axis labels. The English variants are untouched. The committed example
fiches need no regeneration: every example in generate_reports.py
renders in English, so no changed Spanish report string reaches them.
* Align the intensity-fiche Spanish assertions with the UNE terminology
Spanish docs: UNE terminology, decimal commas, localized snippets and theory figures (#365)
* Normalize Spanish docs prose to UNE acoustic terminology
Sweep the Spanish pages for the non-UNE forms "presion sonora",
"potencia sonora" and "intensidad sonora" and normalize the prose to
the wording used by the official Spanish editions of the standards:
"presion acustica" (UNE-EN ISO 16283-2:2016, UNE-EN ISO 10052:2005,
UNE-EN ISO 3746:2011, UNE-ISO 226:2013), "potencia acustica"
(UNE-EN ISO 3746:2011, UNE-EN ISO 4871:2010, UNE-EN ISO 9614-1:2010),
"intensidad acustica" (UNE-EN 61043:1999, UNE-EN ISO 9614-1:2010) and
"nivel de presion acustica de impactos" (UNE-EN ISO 12354-2:2018,
UNE-EN ISO 717-2:2013). 92 replacements across 32 pages, prose only:
code snippets keep the labels they share with the generated figures.
Rename the intensity guide to "Intensidad acustica (p-p)" and the
structure-borne power guide to "Potencia acustica estructural de
equipos (EN 15657)", updating every cross-link text and the theory
anchor intensidad-sonora-iec-61043 accordingly. The API sidebar group
label becomes "Potencia acustica e intensidad" via api_taxonomy.py
with the generated sidebar regenerated.
* Use decimal commas in Spanish docs prose quantities
Sweep every Spanish page for decimal points leaking into prose numbers
and switch them to the comma the locale convention calls for: the
rotorcraft validation prose (fourteen tolerances such as 0,08 dB(A) and
0,5 s), the insulation-prediction worked example (53,6 dB / 53,8 dB),
the tone-audibility Annex E tone (137,3 Hz), the Mackenzie check value
(1550,744 m/s), the EPNL, loudness and absorption fiche descriptions
(98,3 EPNdB; 8,2 sonos and 70,4 fonios; 0,60 y 0,55), the junction
constants table and the third-octave band-edge table in the signal
analysis theory page. Code snippets, inline code, math, clause numbers
and quoted source text keep their points.
* Pass language="es" in Spanish figure-reproduction snippets
The <details> blocks under each localized figure in the Spanish guides
are meant to reproduce the _es variant shown on the page, but 82 of the
one-line result .plot() calls omitted the language="es" argument and
would render English axis labels instead. Add the argument across 33
guides, matching the pattern the intensity field-indicators snippet
already used. The three lab-insulation results whose plot() does not
take a language argument (lab airborne, lab impact and the
element-normalized intensity difference) are left as they were.
* Extend the UNE terminology sweep to sound absorption
Normalize "absorción sonora" to "absorción acústica" across the
Spanish pages (36 occurrences in 14 pages, including the EN 12354-6
guide title and the theory headings), the wording of UNE-EN ISO
3746:2011 and of the equivalent absorption area in UNE-EN ISO
10140-3:2011, UNE-EN ISO 12354-2:2018 and UNE-EN ISO 16283-2:2016, and
the same term the accredited report strings already use. Also restore
the accent in the theory index anchor to the renamed intensity heading,
since heading slugs keep accented characters.
* Theory pages: illustrate each section family with existing result figures
The seven theory pages carried no figures at all. Embed sixteen of the
existing generated figures (light and dark variants, Spanish variants on
the Spanish mirrors) where the concept matches the prose: weighting
curves, time integration and the p-p intensity estimator in the signal
analysis page; equal-loudness contours, the specific-loudness pattern
and the hearing-threshold panels in perception; NC/RC rating, the
Schroeder decay and the ISO 717-1 shifted reference in rooms and
buildings; the Lden profile, ISO 9613-1 absorption and the three sound
power routes in environment and transport; the scattering coefficient
and ISO 11654 rating in materials and surfaces; and the Wk weighting and
the resonator mobility triplet in vibration. Each embed reuses the alt
text of the guide that owns the figure and adds a one-line caption.
Also give the wave-simulation section hub the reading-order paragraph
its siblings already have, linking the closed-form pages the FDTD solver
cross-checks, in both languages.
* Address review findings from the Spanish locale sweeps
Second pass fixes flagged by review: five terminology occurrences the
line-based sweep missed because the noun and adjective were split by a
line wrap or emphasis markup (sound-power, rotorcraft-noise and two
section hubs); six Spanish pages that still embedded the English figure
variant although the _es variant exists (junction-transmission,
aircraft-noise airport contour, miso-coherence,
objective-intelligibility, psychoacoustic-annoyance twice); and 19 more
language="es" arguments on figure-reproduction plot calls the first
pass missed, chained-call receivers such as room.noise_criterion(spl)
.plot() and the axes-creating first call of the two-profile
atmospheric-refraction snippet among them. The lab-insulation plot
wrappers forward keyword arguments to the rating plot, so the three
calls excluded earlier now take the argument too. All Spanish python
fences re-checked to compile and EN/ES parity re-verified.
* Carry the UNE terminology into the generated-asset Spanish strings
Apply the same evidence-based decisions to every Spanish string source
that feeds generated assets: the translation tables of
generate_graphs.py and generate_diagrams.py, the _STRINGS tables of the
plot modules and the report i18n values. 35 strings change: "presión
acústica" (UNE-EN ISO 16283-2:2016, 10052:2005, 3746:2011),
"potencia acústica" (UNE-EN ISO 3746:2011, 4871:2010, 9614-1:2010),
"intensidad acústica" (UNE-EN 61043:1999, 9614-1:2010), "absorción
acústica" (UNE-EN ISO 3746:2011) and "nivel de presión acústica de
impactos" (UNE-EN ISO 12354-2:2018). Strings the UNE editions keep are
untouched: "emisión sonora", "exposición sonora", "campo sonoro",
"fuente sonora". Only Spanish values change; the English keys stay.
The two plot-i18n test assertions that pin the axis label follow, and
the eight Spanish doc fences that deliberately mirrored the old figure
labels now mirror the new ones.
* Regenerate the Spanish figure variants with the UNE terminology
make graphs after the string-source change: 48 files, all of them _es
or _es_dark variants (24 figure/diagram pairs), picking up "presión
acústica", "potencia acústica", "intensidad acústica", "absorción
acústica" and "nivel de presión acústica de impactos" in titles and
axis labels. The English variants are untouched. The committed example
fiches need no regeneration: every example in generate_reports.py
renders in English, so no changed Spanish report string reaches them.
* Align the intensity-fiche Spanish assertions with the UNE terminology
Perception, hearing and speech guides: result figures and when-to-use prose (#361)
* Perception, hearing and speech guides: result figures and when-to-use prose
Add ToneAssessment.plot(), which draws an ECMA-418-1 tone against the
prominence criterion of its own method (recovered from criterion_db) over the
whole range of interest, with the deciding margin marked, and a
view="levels" option on ToneAudibilityResult.plot() that exposes the
level-versus-frequency view the ISO 1996-2 fiche already embedded.
Add eleven single-concept figures to the perception, hearing and speech
guides, each a realistic result drawn by its own .plot(): the tone prominence
verdict, the ISO/PAS 20065 tone levels, the ISO/PAS 1996-3 onset detection,
the ISO 532-2 specific loudness, the ECMA-418-2 specific tonality, the
specific fluctuation strength, the SII band audibility under a hearing loss,
the ISO 7029 fractile band, the ISO 1999 NIPTS audiogram, the STOI per-band
correlation and the IEC 60268-16 per-band MTI. Every figure is embedded in
the English guide, the Spanish mirror and the docs mirror with the dual
snippet block, and every plottable snippet on those pages now names its
.plot().
Prose: the tone-prominence guide gains a comparison of the four tonality
assessments the library implements and when each applies, the
hearing-threshold guide explains how the ISO 7029 fractiles feed the ISO 1999
age component and gains a See-also section, and the objective-intelligibility
guide gains the "which measure, and when" section that existed only in the
docs mirror, extended with the STOI/ESTOI, STI and SII choice.
Also label the STOI band axis at whole-hertz resolution and let the shaded
critical band of the tone-audibility levels plot follow the figure
background, so it reads on the white report page and on dark figures alike.
* Correct two figure alt texts against the plotted values
The ISO 7029 fractile figure describes the median and the 90 % fractile with
the values it actually draws (10 to 50 dB and 22 to 74 dB), and the
ECMA-418-2 specific tonality peak is at 9 Bark_HMS.
Perception, hearing and speech guides: result figures and when-to-use prose (#361)
* Perception, hearing and speech guides: result figures and when-to-use prose
Add ToneAssessment.plot(), which draws an ECMA-418-1 tone against the
prominence criterion of its own method (recovered from criterion_db) over the
whole range of interest, with the deciding margin marked, and a
view="levels" option on ToneAudibilityResult.plot() that exposes the
level-versus-frequency view the ISO 1996-2 fiche already embedded.
Add eleven single-concept figures to the perception, hearing and speech
guides, each a realistic result drawn by its own .plot(): the tone prominence
verdict, the ISO/PAS 20065 tone levels, the ISO/PAS 1996-3 onset detection,
the ISO 532-2 specific loudness, the ECMA-418-2 specific tonality, the
specific fluctuation strength, the SII band audibility under a hearing loss,
the ISO 7029 fractile band, the ISO 1999 NIPTS audiogram, the STOI per-band
correlation and the IEC 60268-16 per-band MTI. Every figure is embedded in
the English guide, the Spanish mirror and the docs mirror with the dual
snippet block, and every plottable snippet on those pages now names its
.plot().
Prose: the tone-prominence guide gains a comparison of the four tonality
assessments the library implements and when each applies, the
hearing-threshold guide explains how the ISO 7029 fractiles feed the ISO 1999
age component and gains a See-also section, and the objective-intelligibility
guide gains the "which measure, and when" section that existed only in the
docs mirror, extended with the STOI/ESTOI, STI and SII choice.
Also label the STOI band axis at whole-hertz resolution and let the shaded
critical band of the tone-audibility levels plot follow the figure
background, so it reads on the white report page and on dark figures alike.
* Correct two figure alt texts against the plotted values
The ISO 7029 fractile figure describes the median and the 90 % fractile with
the values it actually draws (10 to 50 dB and 22 to 74 dB), and the
ECMA-418-2 specific tonality peak is at 9 Bark_HMS.
Perception, hearing and speech guides: result figures and when-to-use prose (#361)
* Perception, hearing and speech guides: result figures and when-to-use prose
Add ToneAssessment.plot(), which draws an ECMA-418-1 tone against the
prominence criterion of its own method (recovered from criterion_db) over the
whole range of interest, with the deciding margin marked, and a
view="levels" option on ToneAudibilityResult.plot() that exposes the
level-versus-frequency view the ISO 1996-2 fiche already embedded.
Add eleven single-concept figures to the perception, hearing and speech
guides, each a realistic result drawn by its own .plot(): the tone prominence
verdict, the ISO/PAS 20065 tone levels, the ISO/PAS 1996-3 onset detection,
the ISO 532-2 specific loudness, the ECMA-418-2 specific tonality, the
specific fluctuation strength, the SII band audibility under a hearing loss,
the ISO 7029 fractile band, the ISO 1999 NIPTS audiogram, the STOI per-band
correlation and the IEC 60268-16 per-band MTI. Every figure is embedded in
the English guide, the Spanish mirror and the docs mirror with the dual
snippet block, and every plottable snippet on those pages now names its
.plot().
Prose: the tone-prominence guide gains a comparison of the four tonality
assessments the library implements and when each applies, the
hearing-threshold guide explains how the ISO 7029 fractiles feed the ISO 1999
age component and gains a See-also section, and the objective-intelligibility
guide gains the "which measure, and when" section that existed only in the
docs mirror, extended with the STOI/ESTOI, STI and SII choice.
Also label the STOI band axis at whole-hertz resolution and let the shaded
critical band of the tone-audibility levels plot follow the figure
background, so it reads on the white report page and on dark figures alike.
* Correct two figure alt texts against the plotted values
The ISO 7029 fractile figure describes the median and the 90 % fractile with
the values it actually draws (10 to 50 dB and 22 to 74 dB), and the
ECMA-418-2 specific tonality peak is at 9 Bark_HMS.
Perception, hearing and speech guides: result figures and when-to-use prose (#361)
* Perception, hearing and speech guides: result figures and when-to-use prose
Add ToneAssessment.plot(), which draws an ECMA-418-1 tone against the
prominence criterion of its own method (recovered from criterion_db) over the
whole range of interest, with the deciding margin marked, and a
view="levels" option on ToneAudibilityResult.plot() that exposes the
level-versus-frequency view the ISO 1996-2 fiche already embedded.
Add eleven single-concept figures to the perception, hearing and speech
guides, each a realistic result drawn by its own .plot(): the tone prominence
verdict, the ISO/PAS 20065 tone levels, the ISO/PAS 1996-3 onset detection,
the ISO 532-2 specific loudness, the ECMA-418-2 specific tonality, the
specific fluctuation strength, the SII band audibility under a hearing loss,
the ISO 7029 fractile band, the ISO 1999 NIPTS audiogram, the STOI per-band
correlation and the IEC 60268-16 per-band MTI. Every figure is embedded in
the English guide, the Spanish mirror and the docs mirror with the dual
snippet block, and every plottable snippet on those pages now names its
.plot().
Prose: the tone-prominence guide gains a comparison of the four tonality
assessments the library implements and when each applies, the
hearing-threshold guide explains how the ISO 7029 fractiles feed the ISO 1999
age component and gains a See-also section, and the objective-intelligibility
guide gains the "which measure, and when" section that existed only in the
docs mirror, extended with the STOI/ESTOI, STI and SII choice.
Also label the STOI band axis at whole-hertz resolution and let the shaded
critical band of the tone-audibility levels plot follow the figure
background, so it reads on the white report page and on dark figures alike.
* Correct two figure alt texts against the plotted values
The ISO 7029 fractile figure describes the median and the 90 % fractile with
the values it actually draws (10 to 50 dB and 22 to 74 dB), and the
ECMA-418-2 specific tonality peak is at 9 Bark_HMS.
Core metrology guides: result figures, ResampledSignalResult.plot() and real introductions (#364)
* Add ResampledSignalResult.plot(): the delivered anti-alias filter against its design spec
* Rewrite the multichannel guide intro: concrete use cases, per-channel guarantees, Bendat & Piersol citations
* Give the levels page a real introduction: descriptor families, when-to-use guidance and survey references
* Time weighting: framing intro with detector history, ANSI S1.4/Bies references and sibling links
* Calibration: proper introduction (SPL vs dBFS choice, workflow framing) with Bies reference and sibling links
* Add eleven core-metrology figures: resampling spec, cepstrum variants, liftering, correlation, IR alignment, Hilbert envelope, cross-spectra, Golay recovery, TSA noise law, runs test
* Test signals: anti-alias figure with dual snippet, res.plot() mention, See also, docs mirror sync
* Cepstrum guide: variants and liftering figures with dual snippets, complex-cepstrum plot mention
* Correlation guide: normalization, IR-alignment and Hilbert-envelope figures with dual snippets
* Spectral analysis: cross-spectral density and coherent-output-SNR figures with dual snippets
* System measurement: Golay exact-recovery figure and plot mentions for the inversion workflow
* Synchronous averaging: sqrt(N) figure, diagnostics-tool guidance, See also, recording naming
* Data qualification: runs-test figure with dual snippet and peak-statistics plot mention
* MISO coherence: conditioning-order snippet, practical pitfalls and See also across the three trees
* Time-frequency: Harris window reference and See also across the three trees
* GUM uncertainty: map the domain pages that consume the clause-5 machinery, expand See also
* Filter banks: compliance plot mentions and recording naming in the crossover snippet
* Changelog entry for the core-metrology documentation figures and prose
* Regenerate llms-full.txt for the core-metrology documentation
* Drop the duplicated phase-axis translation key
Core metrology guides: result figures, ResampledSignalResult.plot() and real introductions (#364)
* Add ResampledSignalResult.plot(): the delivered anti-alias filter against its design spec
* Rewrite the multichannel guide intro: concrete use cases, per-channel guarantees, Bendat & Piersol citations
* Give the levels page a real introduction: descriptor families, when-to-use guidance and survey references
* Time weighting: framing intro with detector history, ANSI S1.4/Bies references and sibling links
* Calibration: proper introduction (SPL vs dBFS choice, workflow framing) with Bies reference and sibling links
* Add eleven core-metrology figures: resampling spec, cepstrum variants, liftering, correlation, IR alignment, Hilbert envelope, cross-spectra, Golay recovery, TSA noise law, runs test
* Test signals: anti-alias figure with dual snippet, res.plot() mention, See also, docs mirror sync
* Cepstrum guide: variants and liftering figures with dual snippets, complex-cepstrum plot mention
* Correlation guide: normalization, IR-alignment and Hilbert-envelope figures with dual snippets
* Spectral analysis: cross-spectral density and coherent-output-SNR figures with dual snippets
* System measurement: Golay exact-recovery figure and plot mentions for the inversion workflow
* Synchronous averaging: sqrt(N) figure, diagnostics-tool guidance, See also, recording naming
* Data qualification: runs-test figure with dual snippet and peak-statistics plot mention
* MISO coherence: conditioning-order snippet, practical pitfalls and See also across the three trees
* Time-frequency: Harris window reference and See also across the three trees
* GUM uncertainty: map the domain pages that consume the clause-5 machinery, expand See also
* Filter banks: compliance plot mentions and recording naming in the crossover snippet
* Changelog entry for the core-metrology documentation figures and prose
* Regenerate llms-full.txt for the core-metrology documentation
* Drop the duplicated phase-axis translation key
Core metrology guides: result figures, ResampledSignalResult.plot() and real introductions (#364)
* Add ResampledSignalResult.plot(): the delivered anti-alias filter against its design spec
* Rewrite the multichannel guide intro: concrete use cases, per-channel guarantees, Bendat & Piersol citations
* Give the levels page a real introduction: descriptor families, when-to-use guidance and survey references
* Time weighting: framing intro with detector history, ANSI S1.4/Bies references and sibling links
* Calibration: proper introduction (SPL vs dBFS choice, workflow framing) with Bies reference and sibling links
* Add eleven core-metrology figures: resampling spec, cepstrum variants, liftering, correlation, IR alignment, Hilbert envelope, cross-spectra, Golay recovery, TSA noise law, runs test
* Test signals: anti-alias figure with dual snippet, res.plot() mention, See also, docs mirror sync
* Cepstrum guide: variants and liftering figures with dual snippets, complex-cepstrum plot mention
* Correlation guide: normalization, IR-alignment and Hilbert-envelope figures with dual snippets
* Spectral analysis: cross-spectral density and coherent-output-SNR figures with dual snippets
* System measurement: Golay exact-recovery figure and plot mentions for the inversion workflow
* Synchronous averaging: sqrt(N) figure, diagnostics-tool guidance, See also, recording naming
* Data qualification: runs-test figure with dual snippet and peak-statistics plot mention
* MISO coherence: conditioning-order snippet, practical pitfalls and See also across the three trees
* Time-frequency: Harris window reference and See also across the three trees
* GUM uncertainty: map the domain pages that consume the clause-5 machinery, expand See also
* Filter banks: compliance plot mentions and recording naming in the crossover snippet
* Changelog entry for the core-metrology documentation figures and prose
* Regenerate llms-full.txt for the core-metrology documentation
* Drop the duplicated phase-axis translation key
Core metrology guides: result figures, ResampledSignalResult.plot() and real introductions (#364)
* Add ResampledSignalResult.plot(): the delivered anti-alias filter against its design spec
* Rewrite the multichannel guide intro: concrete use cases, per-channel guarantees, Bendat & Piersol citations
* Give the levels page a real introduction: descriptor families, when-to-use guidance and survey references
* Time weighting: framing intro with detector history, ANSI S1.4/Bies references and sibling links
* Calibration: proper introduction (SPL vs dBFS choice, workflow framing) with Bies reference and sibling links
* Add eleven core-metrology figures: resampling spec, cepstrum variants, liftering, correlation, IR alignment, Hilbert envelope, cross-spectra, Golay recovery, TSA noise law, runs test
* Test signals: anti-alias figure with dual snippet, res.plot() mention, See also, docs mirror sync
* Cepstrum guide: variants and liftering figures with dual snippets, complex-cepstrum plot mention
* Correlation guide: normalization, IR-alignment and Hilbert-envelope figures with dual snippets
* Spectral analysis: cross-spectral density and coherent-output-SNR figures with dual snippets
* System measurement: Golay exact-recovery figure and plot mentions for the inversion workflow
* Synchronous averaging: sqrt(N) figure, diagnostics-tool guidance, See also, recording naming
* Data qualification: runs-test figure with dual snippet and peak-statistics plot mention
* MISO coherence: conditioning-order snippet, practical pitfalls and See also across the three trees
* Time-frequency: Harris window reference and See also across the three trees
* GUM uncertainty: map the domain pages that consume the clause-5 machinery, expand See also
* Filter banks: compliance plot mentions and recording naming in the crossover snippet
* Changelog entry for the core-metrology documentation figures and prose
* Regenerate llms-full.txt for the core-metrology documentation
* Drop the duplicated phase-axis translation key
