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 insulation: formula, fiche and citation fixes against the source standards (#357)
* Correct the ISO 15186-1 Formula (8) N-term and complete the fiche's Clause 8 content
The printed Formula (8) subtracts its 10 lg(N) term, which cannot be
derived: ISO 10140-2:2010 Formula (6) adds the multi-unit correction and
ISO 15186-2:2010 Formula (12) prints the same relation without an N term.
intensity_element_normalized_difference() now returns the derivable
per-unit value (+10 lg N), warns whenever n > 1 deviates from the print,
and the defect is registered in docs/ERRATA.md.
Clause 8 completeness of the intensity fiches: the method statement now
states the test-object and measurement-surface areas S / Sm carried by
the result (Clause 8 g), and report() accepts optional per-band FpI and
pressure-residual intensity index spectra annexed as table columns
(Clause 8 i). The 6.4.2 qualification wording is corrected to 'must not
exceed 10 dB' (the clause flags FpI > 10 dB), the band-set captions now
cite ISO 717-1:2020 Clause 5.3 (statement of results) instead of 4.4,
and the Table B.1 Kc oracle gains the three printed rows 3150/4000/5000
Hz (0,1 dB each) so all 21 rows are pinned.
* Label the road-traffic facade fiche R'tr,s instead of R'45
FacadeInsulationResult now carries the measurement method
(loudspeaker or road_traffic), and the ISO 16283-3 r_prime fiche
selects its labels from it: the road-traffic apparent index is the
distinct quantity R'tr,s (Clause 3.13, -3 dB all-angle correction),
so its report no longer prints the R'45 loudspeaker basis line
(Clause 3.12) over road-traffic numbers.
* Make the ISO 10848 fiche part selectable and register the Formula (20) misprint
The Dn,f / Ln,f quantities are defined in the ISO 10848-1:2006 frame
document (Formulas (4)/(5)); which part governs a measurement depends on
the construction under test, so hardcoding 'ISO 10848-2:2006' in the
basis line mislabelled Part 3 and Part 4 measurements. report() now
accepts part=2/3/4 (default 2) and names ISO 10848-2:2006,
ISO 10848-3:2006 or ISO 10848-4:2010 accordingly, in both languages.
ISO 10848-1:2006 Clause 8.1.1 Formula (20) prints the thin-plate
critical frequency with a spurious extra pi in the denominator (the 1,8
constant already carries 2 pi / sqrt(12)); the implementation was
already pi-free, and the defect is now registered in docs/ERRATA.md
with a misprint note in the critical_frequency docstring, corroborated
by ISO 12354-1:2017 and Hopkins Eq. 2.201.
* Normalize the K24 mass-ratio convention and correct the K24 errata entry
EN 12354-1:2000 prints its two K24 lines in two different mass-ratio
conventions without saying so: the E.5 line follows the annex's own
per-path definition M = lg(m'perp,i/m'i), while the Figure E.9 (E.7)
line is stated in the figure-axis variable lg(m2/m1). Read with the
declared per-path M, the E.9 print contradicts its own curve;
ISO 12354-1:2017 E.3.5 prints the same relation consistently in the
per-path convention (+14,1 M). Re-deriving both editions against the
figures shows the earlier errata entry misread this recast as a 2017
sign misprint; the entry is rewritten accordingly.
junction_vibration_reduction() now applies the documented per-path
mass_ratio = m'perp,i/m'i to every branch: the E.7 double-leaf branch
takes leaf-over-homogeneous ratios (validity m2/m1 > 3 reads
mass_ratio < 1/3) and evaluates 3,0 + 14,1 M + 5,7 M^2, numerically
identical to the 2000 figure. Also cites Kij,min as Formula (29)
(Clause 4.4.2) and documents the ISO 12354-1:2017 both-negative
lining-combination rule next to the 2000 form combine_linings()
implements.
* Broadcast a single-number source level across the EN 12354-5 path bands
installed_source_prediction() derived its band count from the source
levels alone, so a single-number characteristic power with per-band
path data either raised a spurious band-count error or produced a
one-element installed_power_level that crashed the fiche table with an
IndexError. The band count is now the widest per-band input, every
per-band input is validated against it (one value broadcasts), and the
result's installed_power_level is broadcast to the band axis; a fiche
regression test covers the scalar-source case.
Also corrects the coupling-term docstrings: D_C is not guaranteed
non-negative, since near a mounting resonance with comparable,
opposite-phase source and receiver mobilities the |Ys + Yi|^2 numerator
collapses (counterexample in the docstring).
* Use a prediction-aware footer disclaimer on the EN 12354 fiches
The shared footer printed 'The results relate only to the tested
specimen.' on every fiche, including prediction sheets that have no
tested specimen. footer_flow() now takes predicted=True (also exposed
through the shared sound-power renderer) and prints 'Predicted result:
the values relate only to the modelled configuration, not to a tested
specimen.' instead; the EN 12354-1/-2/-3 and EN 12354-5 prediction
fiches use it, in both languages.
Also corrects the dated designations on the prediction basis lines:
the 2000 editions are EN 12354-1/-2/-3:2000 (there was no ISO 12354 in
2000), so 'EN/ISO 12354-x:2000' is replaced by 'EN 12354-x:2000'.
* Declare the actual band set on the ISO 10052 basis line and align ES impact terms
The survey fiches accept both the octave and the one-third-octave band
sets, but their standard-basis lines hardcoded '(survey method, octave
bands)'; the line now follows the band set the reported curve actually
carries, in both languages (ISO 717-1:2020 Clause 5.3 / ISO 717-2:2020
Clause 4.4 require stating it). The remaining comments citing the
band-set statement as ISO 717-1 Clause 4.4 now cite 5.3 (717-2 keeps
4.4), and the ISO 10140 fiche docstring cites the test-report clause as
Clause 9 (Clause 6 is the test arrangement).
Spanish terminology of the field impact quantities is aligned with the
UNE editions: UNE-EN ISO 16283-2:2016 defines 'nivel de presión
acústica estandarizado/normalizado de ruido de impactos' (3.13/3.14),
now used by the ISO 16283-2 and ISO 10052 basis lines; the ISO 10140-3
and ISO 12354-2 strings already match their own UNE editions
(UNE-EN ISO 10140-3:2011 3.2, UNE-EN ISO 12354-2:2018 3.1.1/3.1.2) and
stay unchanged.
* Qualify a background-limited ISO 16251-1 result as a lower bound
When any band sits at the 1,3 dB limit of measurement (Formula (2), the
per-band values already reported as > delta-L), the fiche now prints
the boxed delta-Lw with a >= qualifier and a note stating it is a lower
bound, in both languages. A manually built result without CI,delta
prints the bare delta-Lw instead of fabricating a (+0) adaptation term.
The ISO 717-2:2020 Annex C.2 errata entry is extended with the second,
independent print defect: the example's 'Ln,sum = 75,2527 = 75 dB'
reproduces to all printed digits only as the energy sum of the wrong
column over the wrong range (the measured floor with covering, 16 bands
100-3150 Hz), while the A.2.1 sum of the covered reference floor over
100-2500 Hz rounds to 76 dB with either 800 Hz value, so CI,r = -2,
CI,delta = -9 and delta-Llin = 6 dB; the earlier claim that the 800 Hz
misprint alone shifted the CI chain is corrected.
* Regenerate the conformance report, API docs and affected fiche examples
The Kc Table B.1 conformance row now covers all 21 printed rows, the
building API pages pick up the revised docstrings, and the EN 12354
prediction and ISO 15186-1 example fiches are re-rendered with the
prediction footer, the corrected designations and the Clause 8 areas
statement (kept to one page). CHANGELOG entries under [Unreleased].
* Validate the frequency axis and the facade method on the building results
The installed structure-borne prediction now rejects a frequency axis whose
length differs from the resolved band count, so a result can no longer carry
an inconsistent per-band table. FacadeInsulationResult validates its method
on construction, closing the direct-construction path that would render an
unknown method as the loudspeaker quantity. The band-count note also names
the characteristic level and coupling term as width-setting inputs.
Correct the framing and the guards of the perception and noise-control fiches (#355)
A review pass over the psychoacoustics, hearing, speech, environmental and
noise-control fiches. The numerics held up; what did not were the statements
printed around them, plus one wrong table lookup.
ISO 1999 validated domain. nipts()/htlan() applied Formula (2) wherever they
were asked to: L_EX,8h = 130 dB over 60 years at the 0,99 fractile returned a
357,9 dB threshold shift with nothing marking it as an extrapolation. Since the
formula is quadratic in (L_EX,8h - L0) that number is meaningless, not merely
uncertain. Both now warn (NoiseInducedHearingLossWarning) outside the stated
ranges while still computing: durations outside 1-40 years (clause 6.3.1
validates Formula (2) over 10-40 and Formula (3) over 1-10), fractiles in the
tails clause 6.3.2 says "should not be estimated" (Q below 5 % or above 95 %),
and levels above the 100 dB of Annex D that the Scope's NOTE 4 restricts
validity to. The fiches print the caveat when the conditions sit outside.
ISO 1999 Q. The fiches printed the library's fractile under ISO 1999's symbol,
inverting its meaning: in Formulae (4)/(5) Q is the percentage with worse
hearing, so the most-susceptible tenth is Q = 10 %, not the "Q = 0.9" the fiche
showed while citing 6.3.2. They now print ISO's Q as ISO defines it; the guides
note the difference from the fractile argument. Two further disclosures on the
same fiches: the age component H is evaluated from ISO 7029:2017 (the edition
ISO 1999 references undated in 6.2.2), which departs from the illustrative
Table A.3 selection by up to about 7 dB at the median, and the 2/3/4 kHz
average is the user's own choice, the Scope's NOTE 1 specifying no frequency
combination. The footer states a population scope rather than "the results
relate only to the tested specimen", which describes a laboratory specimen.
ISO 1999 Annex C is wired in as an independent oracle: its worked example (male
population aged 50, 90 dB for 30 years, 1/2/4 kHz at Q = 10 %) reproduces the
Table D.2 shifts it consumes (0, 9, 19 dB), the 13,3 dB left of the 4 kHz shift
after the Formula (1) compression (C.5) and the 31,1 dB combined threshold
(C.11). The composition it exercises is now exposed as combine_age_and_noise(),
which clause 6.2 wants available on its own: 6.2.3 recommends a database B
collected on a control population of the country under consideration, and this
applies Formula (1) to whichever database the user brings.
Verdict precision. The STI and SII fiches printed the requirement with one
decimal beside a measured value at full precision, so a verdict could contradict
itself: "STI = 0.50, required >= 0.5 -> FAIL" against a 0,52 requirement, and an
SII minimum of 0,75 printed as "0.8" (the committed example said so). Both now
print the requirement at the quantity's own precision. IEC 60268-16 Annex M
joins the conformance report as an end-to-end oracle: its printed MTF matrix,
speech spectrum and ambient noise give back its published MTI row and
STI = 0,76, exercising the whole A.5.3 to A.5.8 chain.
Noise-control prediction framing. The enclosure, silencer and HVAC fiches
compute design models but read as measurements: no prediction statement,
measurement headers, a footer scoped to a tested specimen, and committed
examples citing instrumentation that never existed ("Two-microphone
transfer-matrix bench"). They now follow the EN/ISO 12354 prediction exemplar
already in the repo, with a prediction-basis line, a statement naming what each
model does not represent, and a prediction footer. Their verdicts also decided
on the half-away-from-zero display rounding while printing Python's
round-half-to-even, so 0,25 printed 0.2 against a verdict taken on 0,3; both
now use the display rounding.
ISO/PAS 1996-3. With every onset rate at or below 10 dB/s the fiche withheld
the adjustment on the onset-rate gate (clauses 4.5/8) but justified it with "no
prominent impulse is present (governing P = 6.01 <= 5)", contradicting its own
boxed P. The note now states whichever gate governs. The assessment period is
read from the result instead of being hardcoded: 30 min is the Clause 5
*default*, now the default of the new assessment_period_min argument.
Smaller corrections:
- the HVAC elbow insertion loss took the wrong row of Bies Table 8.11 for a
W/lambda exactly on a bin edge; the rows read "a <= W/lambda < b", so an edge
opens its row (1 dB at 0,14, not 0 dB);
- the wind-turbine tonality fiche cited "subclauses 9.5.2-9.5.5" of
IEC 61400-11 for a chain running through 9.5.6 to 9.5.8 (Formulae 31-34);
- the ISO 1996-2 tonal fiche notes that Table J.1 keys on the mean audibility
of the J assessed spectra (ISO/PAS 20065 Clause 5.3.9), which a
single-spectrum assessment stands in for;
- the shared 10-90 % fractile band carried a hardcoded English legend in
Spanish figures, and the Spanish silencer and HVAC fiches printed the device
kind and duct-element label in English.
docs/ERRATA.md records two more source defects found on the way: ISO/PAS
1996-3:2022 Clause 5 swaps the 3.4/3.5 cross-references of the onset rate and
the level difference (its own units contradict the clause numbers printed with
them), and ISO 9613-2:1996 Table 2 prints 4,1 dB/km at 15 C / 80 % / 1 kHz
where ISO 9613-1 gives 4,1511, the neighbouring cells rounding correctly. The
library computes that coefficient from ISO 9613-1 directly, so it is unaffected.
Committed example fiches, the conformance report, the API reference and the
llms files are regenerated.
Correct the framing and the guards of the perception and noise-control fiches (#355)
A review pass over the psychoacoustics, hearing, speech, environmental and
noise-control fiches. The numerics held up; what did not were the statements
printed around them, plus one wrong table lookup.
ISO 1999 validated domain. nipts()/htlan() applied Formula (2) wherever they
were asked to: L_EX,8h = 130 dB over 60 years at the 0,99 fractile returned a
357,9 dB threshold shift with nothing marking it as an extrapolation. Since the
formula is quadratic in (L_EX,8h - L0) that number is meaningless, not merely
uncertain. Both now warn (NoiseInducedHearingLossWarning) outside the stated
ranges while still computing: durations outside 1-40 years (clause 6.3.1
validates Formula (2) over 10-40 and Formula (3) over 1-10), fractiles in the
tails clause 6.3.2 says "should not be estimated" (Q below 5 % or above 95 %),
and levels above the 100 dB of Annex D that the Scope's NOTE 4 restricts
validity to. The fiches print the caveat when the conditions sit outside.
ISO 1999 Q. The fiches printed the library's fractile under ISO 1999's symbol,
inverting its meaning: in Formulae (4)/(5) Q is the percentage with worse
hearing, so the most-susceptible tenth is Q = 10 %, not the "Q = 0.9" the fiche
showed while citing 6.3.2. They now print ISO's Q as ISO defines it; the guides
note the difference from the fractile argument. Two further disclosures on the
same fiches: the age component H is evaluated from ISO 7029:2017 (the edition
ISO 1999 references undated in 6.2.2), which departs from the illustrative
Table A.3 selection by up to about 7 dB at the median, and the 2/3/4 kHz
average is the user's own choice, the Scope's NOTE 1 specifying no frequency
combination. The footer states a population scope rather than "the results
relate only to the tested specimen", which describes a laboratory specimen.
ISO 1999 Annex C is wired in as an independent oracle: its worked example (male
population aged 50, 90 dB for 30 years, 1/2/4 kHz at Q = 10 %) reproduces the
Table D.2 shifts it consumes (0, 9, 19 dB), the 13,3 dB left of the 4 kHz shift
after the Formula (1) compression (C.5) and the 31,1 dB combined threshold
(C.11). The composition it exercises is now exposed as combine_age_and_noise(),
which clause 6.2 wants available on its own: 6.2.3 recommends a database B
collected on a control population of the country under consideration, and this
applies Formula (1) to whichever database the user brings.
Verdict precision. The STI and SII fiches printed the requirement with one
decimal beside a measured value at full precision, so a verdict could contradict
itself: "STI = 0.50, required >= 0.5 -> FAIL" against a 0,52 requirement, and an
SII minimum of 0,75 printed as "0.8" (the committed example said so). Both now
print the requirement at the quantity's own precision. IEC 60268-16 Annex M
joins the conformance report as an end-to-end oracle: its printed MTF matrix,
speech spectrum and ambient noise give back its published MTI row and
STI = 0,76, exercising the whole A.5.3 to A.5.8 chain.
Noise-control prediction framing. The enclosure, silencer and HVAC fiches
compute design models but read as measurements: no prediction statement,
measurement headers, a footer scoped to a tested specimen, and committed
examples citing instrumentation that never existed ("Two-microphone
transfer-matrix bench"). They now follow the EN/ISO 12354 prediction exemplar
already in the repo, with a prediction-basis line, a statement naming what each
model does not represent, and a prediction footer. Their verdicts also decided
on the half-away-from-zero display rounding while printing Python's
round-half-to-even, so 0,25 printed 0.2 against a verdict taken on 0,3; both
now use the display rounding.
ISO/PAS 1996-3. With every onset rate at or below 10 dB/s the fiche withheld
the adjustment on the onset-rate gate (clauses 4.5/8) but justified it with "no
prominent impulse is present (governing P = 6.01 <= 5)", contradicting its own
boxed P. The note now states whichever gate governs. The assessment period is
read from the result instead of being hardcoded: 30 min is the Clause 5
*default*, now the default of the new assessment_period_min argument.
Smaller corrections:
- the HVAC elbow insertion loss took the wrong row of Bies Table 8.11 for a
W/lambda exactly on a bin edge; the rows read "a <= W/lambda < b", so an edge
opens its row (1 dB at 0,14, not 0 dB);
- the wind-turbine tonality fiche cited "subclauses 9.5.2-9.5.5" of
IEC 61400-11 for a chain running through 9.5.6 to 9.5.8 (Formulae 31-34);
- the ISO 1996-2 tonal fiche notes that Table J.1 keys on the mean audibility
of the J assessed spectra (ISO/PAS 20065 Clause 5.3.9), which a
single-spectrum assessment stands in for;
- the shared 10-90 % fractile band carried a hardcoded English legend in
Spanish figures, and the Spanish silencer and HVAC fiches printed the device
kind and duct-element label in English.
docs/ERRATA.md records two more source defects found on the way: ISO/PAS
1996-3:2022 Clause 5 swaps the 3.4/3.5 cross-references of the onset rate and
the level difference (its own units contradict the clause numbers printed with
them), and ISO 9613-2:1996 Table 2 prints 4,1 dB/km at 15 C / 80 % / 1 kHz
where ISO 9613-1 gives 4,1511, the neighbouring cells rounding correctly. The
library computes that coefficient from ISO 9613-1 directly, so it is unaffected.
Committed example fiches, the conformance report, the API reference and the
llms files are regenerated.
Building insulation: formula, fiche and citation fixes against the source standards (#357)
* Correct the ISO 15186-1 Formula (8) N-term and complete the fiche's Clause 8 content
The printed Formula (8) subtracts its 10 lg(N) term, which cannot be
derived: ISO 10140-2:2010 Formula (6) adds the multi-unit correction and
ISO 15186-2:2010 Formula (12) prints the same relation without an N term.
intensity_element_normalized_difference() now returns the derivable
per-unit value (+10 lg N), warns whenever n > 1 deviates from the print,
and the defect is registered in docs/ERRATA.md.
Clause 8 completeness of the intensity fiches: the method statement now
states the test-object and measurement-surface areas S / Sm carried by
the result (Clause 8 g), and report() accepts optional per-band FpI and
pressure-residual intensity index spectra annexed as table columns
(Clause 8 i). The 6.4.2 qualification wording is corrected to 'must not
exceed 10 dB' (the clause flags FpI > 10 dB), the band-set captions now
cite ISO 717-1:2020 Clause 5.3 (statement of results) instead of 4.4,
and the Table B.1 Kc oracle gains the three printed rows 3150/4000/5000
Hz (0,1 dB each) so all 21 rows are pinned.
* Label the road-traffic facade fiche R'tr,s instead of R'45
FacadeInsulationResult now carries the measurement method
(loudspeaker or road_traffic), and the ISO 16283-3 r_prime fiche
selects its labels from it: the road-traffic apparent index is the
distinct quantity R'tr,s (Clause 3.13, -3 dB all-angle correction),
so its report no longer prints the R'45 loudspeaker basis line
(Clause 3.12) over road-traffic numbers.
* Make the ISO 10848 fiche part selectable and register the Formula (20) misprint
The Dn,f / Ln,f quantities are defined in the ISO 10848-1:2006 frame
document (Formulas (4)/(5)); which part governs a measurement depends on
the construction under test, so hardcoding 'ISO 10848-2:2006' in the
basis line mislabelled Part 3 and Part 4 measurements. report() now
accepts part=2/3/4 (default 2) and names ISO 10848-2:2006,
ISO 10848-3:2006 or ISO 10848-4:2010 accordingly, in both languages.
ISO 10848-1:2006 Clause 8.1.1 Formula (20) prints the thin-plate
critical frequency with a spurious extra pi in the denominator (the 1,8
constant already carries 2 pi / sqrt(12)); the implementation was
already pi-free, and the defect is now registered in docs/ERRATA.md
with a misprint note in the critical_frequency docstring, corroborated
by ISO 12354-1:2017 and Hopkins Eq. 2.201.
* Normalize the K24 mass-ratio convention and correct the K24 errata entry
EN 12354-1:2000 prints its two K24 lines in two different mass-ratio
conventions without saying so: the E.5 line follows the annex's own
per-path definition M = lg(m'perp,i/m'i), while the Figure E.9 (E.7)
line is stated in the figure-axis variable lg(m2/m1). Read with the
declared per-path M, the E.9 print contradicts its own curve;
ISO 12354-1:2017 E.3.5 prints the same relation consistently in the
per-path convention (+14,1 M). Re-deriving both editions against the
figures shows the earlier errata entry misread this recast as a 2017
sign misprint; the entry is rewritten accordingly.
junction_vibration_reduction() now applies the documented per-path
mass_ratio = m'perp,i/m'i to every branch: the E.7 double-leaf branch
takes leaf-over-homogeneous ratios (validity m2/m1 > 3 reads
mass_ratio < 1/3) and evaluates 3,0 + 14,1 M + 5,7 M^2, numerically
identical to the 2000 figure. Also cites Kij,min as Formula (29)
(Clause 4.4.2) and documents the ISO 12354-1:2017 both-negative
lining-combination rule next to the 2000 form combine_linings()
implements.
* Broadcast a single-number source level across the EN 12354-5 path bands
installed_source_prediction() derived its band count from the source
levels alone, so a single-number characteristic power with per-band
path data either raised a spurious band-count error or produced a
one-element installed_power_level that crashed the fiche table with an
IndexError. The band count is now the widest per-band input, every
per-band input is validated against it (one value broadcasts), and the
result's installed_power_level is broadcast to the band axis; a fiche
regression test covers the scalar-source case.
Also corrects the coupling-term docstrings: D_C is not guaranteed
non-negative, since near a mounting resonance with comparable,
opposite-phase source and receiver mobilities the |Ys + Yi|^2 numerator
collapses (counterexample in the docstring).
* Use a prediction-aware footer disclaimer on the EN 12354 fiches
The shared footer printed 'The results relate only to the tested
specimen.' on every fiche, including prediction sheets that have no
tested specimen. footer_flow() now takes predicted=True (also exposed
through the shared sound-power renderer) and prints 'Predicted result:
the values relate only to the modelled configuration, not to a tested
specimen.' instead; the EN 12354-1/-2/-3 and EN 12354-5 prediction
fiches use it, in both languages.
Also corrects the dated designations on the prediction basis lines:
the 2000 editions are EN 12354-1/-2/-3:2000 (there was no ISO 12354 in
2000), so 'EN/ISO 12354-x:2000' is replaced by 'EN 12354-x:2000'.
* Declare the actual band set on the ISO 10052 basis line and align ES impact terms
The survey fiches accept both the octave and the one-third-octave band
sets, but their standard-basis lines hardcoded '(survey method, octave
bands)'; the line now follows the band set the reported curve actually
carries, in both languages (ISO 717-1:2020 Clause 5.3 / ISO 717-2:2020
Clause 4.4 require stating it). The remaining comments citing the
band-set statement as ISO 717-1 Clause 4.4 now cite 5.3 (717-2 keeps
4.4), and the ISO 10140 fiche docstring cites the test-report clause as
Clause 9 (Clause 6 is the test arrangement).
Spanish terminology of the field impact quantities is aligned with the
UNE editions: UNE-EN ISO 16283-2:2016 defines 'nivel de presión
acústica estandarizado/normalizado de ruido de impactos' (3.13/3.14),
now used by the ISO 16283-2 and ISO 10052 basis lines; the ISO 10140-3
and ISO 12354-2 strings already match their own UNE editions
(UNE-EN ISO 10140-3:2011 3.2, UNE-EN ISO 12354-2:2018 3.1.1/3.1.2) and
stay unchanged.
* Qualify a background-limited ISO 16251-1 result as a lower bound
When any band sits at the 1,3 dB limit of measurement (Formula (2), the
per-band values already reported as > delta-L), the fiche now prints
the boxed delta-Lw with a >= qualifier and a note stating it is a lower
bound, in both languages. A manually built result without CI,delta
prints the bare delta-Lw instead of fabricating a (+0) adaptation term.
The ISO 717-2:2020 Annex C.2 errata entry is extended with the second,
independent print defect: the example's 'Ln,sum = 75,2527 = 75 dB'
reproduces to all printed digits only as the energy sum of the wrong
column over the wrong range (the measured floor with covering, 16 bands
100-3150 Hz), while the A.2.1 sum of the covered reference floor over
100-2500 Hz rounds to 76 dB with either 800 Hz value, so CI,r = -2,
CI,delta = -9 and delta-Llin = 6 dB; the earlier claim that the 800 Hz
misprint alone shifted the CI chain is corrected.
* Regenerate the conformance report, API docs and affected fiche examples
The Kc Table B.1 conformance row now covers all 21 printed rows, the
building API pages pick up the revised docstrings, and the EN 12354
prediction and ISO 15186-1 example fiches are re-rendered with the
prediction footer, the corrected designations and the Clause 8 areas
statement (kept to one page). CHANGELOG entries under [Unreleased].
* Validate the frequency axis and the facade method on the building results
The installed structure-borne prediction now rejects a frequency axis whose
length differs from the resolved band count, so a result can no longer carry
an inconsistent per-band table. FacadeInsulationResult validates its method
on construction, closing the direct-construction path that would render an
unknown method as the loudspeaker quantity. The band-count note also names
the characteristic level and coupling term as width-setting inputs.
Building insulation: formula, fiche and citation fixes against the source standards (#357)
* Correct the ISO 15186-1 Formula (8) N-term and complete the fiche's Clause 8 content
The printed Formula (8) subtracts its 10 lg(N) term, which cannot be
derived: ISO 10140-2:2010 Formula (6) adds the multi-unit correction and
ISO 15186-2:2010 Formula (12) prints the same relation without an N term.
intensity_element_normalized_difference() now returns the derivable
per-unit value (+10 lg N), warns whenever n > 1 deviates from the print,
and the defect is registered in docs/ERRATA.md.
Clause 8 completeness of the intensity fiches: the method statement now
states the test-object and measurement-surface areas S / Sm carried by
the result (Clause 8 g), and report() accepts optional per-band FpI and
pressure-residual intensity index spectra annexed as table columns
(Clause 8 i). The 6.4.2 qualification wording is corrected to 'must not
exceed 10 dB' (the clause flags FpI > 10 dB), the band-set captions now
cite ISO 717-1:2020 Clause 5.3 (statement of results) instead of 4.4,
and the Table B.1 Kc oracle gains the three printed rows 3150/4000/5000
Hz (0,1 dB each) so all 21 rows are pinned.
* Label the road-traffic facade fiche R'tr,s instead of R'45
FacadeInsulationResult now carries the measurement method
(loudspeaker or road_traffic), and the ISO 16283-3 r_prime fiche
selects its labels from it: the road-traffic apparent index is the
distinct quantity R'tr,s (Clause 3.13, -3 dB all-angle correction),
so its report no longer prints the R'45 loudspeaker basis line
(Clause 3.12) over road-traffic numbers.
* Make the ISO 10848 fiche part selectable and register the Formula (20) misprint
The Dn,f / Ln,f quantities are defined in the ISO 10848-1:2006 frame
document (Formulas (4)/(5)); which part governs a measurement depends on
the construction under test, so hardcoding 'ISO 10848-2:2006' in the
basis line mislabelled Part 3 and Part 4 measurements. report() now
accepts part=2/3/4 (default 2) and names ISO 10848-2:2006,
ISO 10848-3:2006 or ISO 10848-4:2010 accordingly, in both languages.
ISO 10848-1:2006 Clause 8.1.1 Formula (20) prints the thin-plate
critical frequency with a spurious extra pi in the denominator (the 1,8
constant already carries 2 pi / sqrt(12)); the implementation was
already pi-free, and the defect is now registered in docs/ERRATA.md
with a misprint note in the critical_frequency docstring, corroborated
by ISO 12354-1:2017 and Hopkins Eq. 2.201.
* Normalize the K24 mass-ratio convention and correct the K24 errata entry
EN 12354-1:2000 prints its two K24 lines in two different mass-ratio
conventions without saying so: the E.5 line follows the annex's own
per-path definition M = lg(m'perp,i/m'i), while the Figure E.9 (E.7)
line is stated in the figure-axis variable lg(m2/m1). Read with the
declared per-path M, the E.9 print contradicts its own curve;
ISO 12354-1:2017 E.3.5 prints the same relation consistently in the
per-path convention (+14,1 M). Re-deriving both editions against the
figures shows the earlier errata entry misread this recast as a 2017
sign misprint; the entry is rewritten accordingly.
junction_vibration_reduction() now applies the documented per-path
mass_ratio = m'perp,i/m'i to every branch: the E.7 double-leaf branch
takes leaf-over-homogeneous ratios (validity m2/m1 > 3 reads
mass_ratio < 1/3) and evaluates 3,0 + 14,1 M + 5,7 M^2, numerically
identical to the 2000 figure. Also cites Kij,min as Formula (29)
(Clause 4.4.2) and documents the ISO 12354-1:2017 both-negative
lining-combination rule next to the 2000 form combine_linings()
implements.
* Broadcast a single-number source level across the EN 12354-5 path bands
installed_source_prediction() derived its band count from the source
levels alone, so a single-number characteristic power with per-band
path data either raised a spurious band-count error or produced a
one-element installed_power_level that crashed the fiche table with an
IndexError. The band count is now the widest per-band input, every
per-band input is validated against it (one value broadcasts), and the
result's installed_power_level is broadcast to the band axis; a fiche
regression test covers the scalar-source case.
Also corrects the coupling-term docstrings: D_C is not guaranteed
non-negative, since near a mounting resonance with comparable,
opposite-phase source and receiver mobilities the |Ys + Yi|^2 numerator
collapses (counterexample in the docstring).
* Use a prediction-aware footer disclaimer on the EN 12354 fiches
The shared footer printed 'The results relate only to the tested
specimen.' on every fiche, including prediction sheets that have no
tested specimen. footer_flow() now takes predicted=True (also exposed
through the shared sound-power renderer) and prints 'Predicted result:
the values relate only to the modelled configuration, not to a tested
specimen.' instead; the EN 12354-1/-2/-3 and EN 12354-5 prediction
fiches use it, in both languages.
Also corrects the dated designations on the prediction basis lines:
the 2000 editions are EN 12354-1/-2/-3:2000 (there was no ISO 12354 in
2000), so 'EN/ISO 12354-x:2000' is replaced by 'EN 12354-x:2000'.
* Declare the actual band set on the ISO 10052 basis line and align ES impact terms
The survey fiches accept both the octave and the one-third-octave band
sets, but their standard-basis lines hardcoded '(survey method, octave
bands)'; the line now follows the band set the reported curve actually
carries, in both languages (ISO 717-1:2020 Clause 5.3 / ISO 717-2:2020
Clause 4.4 require stating it). The remaining comments citing the
band-set statement as ISO 717-1 Clause 4.4 now cite 5.3 (717-2 keeps
4.4), and the ISO 10140 fiche docstring cites the test-report clause as
Clause 9 (Clause 6 is the test arrangement).
Spanish terminology of the field impact quantities is aligned with the
UNE editions: UNE-EN ISO 16283-2:2016 defines 'nivel de presión
acústica estandarizado/normalizado de ruido de impactos' (3.13/3.14),
now used by the ISO 16283-2 and ISO 10052 basis lines; the ISO 10140-3
and ISO 12354-2 strings already match their own UNE editions
(UNE-EN ISO 10140-3:2011 3.2, UNE-EN ISO 12354-2:2018 3.1.1/3.1.2) and
stay unchanged.
* Qualify a background-limited ISO 16251-1 result as a lower bound
When any band sits at the 1,3 dB limit of measurement (Formula (2), the
per-band values already reported as > delta-L), the fiche now prints
the boxed delta-Lw with a >= qualifier and a note stating it is a lower
bound, in both languages. A manually built result without CI,delta
prints the bare delta-Lw instead of fabricating a (+0) adaptation term.
The ISO 717-2:2020 Annex C.2 errata entry is extended with the second,
independent print defect: the example's 'Ln,sum = 75,2527 = 75 dB'
reproduces to all printed digits only as the energy sum of the wrong
column over the wrong range (the measured floor with covering, 16 bands
100-3150 Hz), while the A.2.1 sum of the covered reference floor over
100-2500 Hz rounds to 76 dB with either 800 Hz value, so CI,r = -2,
CI,delta = -9 and delta-Llin = 6 dB; the earlier claim that the 800 Hz
misprint alone shifted the CI chain is corrected.
* Regenerate the conformance report, API docs and affected fiche examples
The Kc Table B.1 conformance row now covers all 21 printed rows, the
building API pages pick up the revised docstrings, and the EN 12354
prediction and ISO 15186-1 example fiches are re-rendered with the
prediction footer, the corrected designations and the Clause 8 areas
statement (kept to one page). CHANGELOG entries under [Unreleased].
* Validate the frequency axis and the facade method on the building results
The installed structure-borne prediction now rejects a frequency axis whose
length differs from the resolved band count, so a result can no longer carry
an inconsistent per-band table. FacadeInsulationResult validates its method
on construction, closing the direct-construction path that would render an
unknown method as the loudspeaker quantity. The band-count note also names
the characteristic level and coupling term as width-setting inputs.
Building insulation: formula, fiche and citation fixes against the source standards (#357)
* Correct the ISO 15186-1 Formula (8) N-term and complete the fiche's Clause 8 content
The printed Formula (8) subtracts its 10 lg(N) term, which cannot be
derived: ISO 10140-2:2010 Formula (6) adds the multi-unit correction and
ISO 15186-2:2010 Formula (12) prints the same relation without an N term.
intensity_element_normalized_difference() now returns the derivable
per-unit value (+10 lg N), warns whenever n > 1 deviates from the print,
and the defect is registered in docs/ERRATA.md.
Clause 8 completeness of the intensity fiches: the method statement now
states the test-object and measurement-surface areas S / Sm carried by
the result (Clause 8 g), and report() accepts optional per-band FpI and
pressure-residual intensity index spectra annexed as table columns
(Clause 8 i). The 6.4.2 qualification wording is corrected to 'must not
exceed 10 dB' (the clause flags FpI > 10 dB), the band-set captions now
cite ISO 717-1:2020 Clause 5.3 (statement of results) instead of 4.4,
and the Table B.1 Kc oracle gains the three printed rows 3150/4000/5000
Hz (0,1 dB each) so all 21 rows are pinned.
* Label the road-traffic facade fiche R'tr,s instead of R'45
FacadeInsulationResult now carries the measurement method
(loudspeaker or road_traffic), and the ISO 16283-3 r_prime fiche
selects its labels from it: the road-traffic apparent index is the
distinct quantity R'tr,s (Clause 3.13, -3 dB all-angle correction),
so its report no longer prints the R'45 loudspeaker basis line
(Clause 3.12) over road-traffic numbers.
* Make the ISO 10848 fiche part selectable and register the Formula (20) misprint
The Dn,f / Ln,f quantities are defined in the ISO 10848-1:2006 frame
document (Formulas (4)/(5)); which part governs a measurement depends on
the construction under test, so hardcoding 'ISO 10848-2:2006' in the
basis line mislabelled Part 3 and Part 4 measurements. report() now
accepts part=2/3/4 (default 2) and names ISO 10848-2:2006,
ISO 10848-3:2006 or ISO 10848-4:2010 accordingly, in both languages.
ISO 10848-1:2006 Clause 8.1.1 Formula (20) prints the thin-plate
critical frequency with a spurious extra pi in the denominator (the 1,8
constant already carries 2 pi / sqrt(12)); the implementation was
already pi-free, and the defect is now registered in docs/ERRATA.md
with a misprint note in the critical_frequency docstring, corroborated
by ISO 12354-1:2017 and Hopkins Eq. 2.201.
* Normalize the K24 mass-ratio convention and correct the K24 errata entry
EN 12354-1:2000 prints its two K24 lines in two different mass-ratio
conventions without saying so: the E.5 line follows the annex's own
per-path definition M = lg(m'perp,i/m'i), while the Figure E.9 (E.7)
line is stated in the figure-axis variable lg(m2/m1). Read with the
declared per-path M, the E.9 print contradicts its own curve;
ISO 12354-1:2017 E.3.5 prints the same relation consistently in the
per-path convention (+14,1 M). Re-deriving both editions against the
figures shows the earlier errata entry misread this recast as a 2017
sign misprint; the entry is rewritten accordingly.
junction_vibration_reduction() now applies the documented per-path
mass_ratio = m'perp,i/m'i to every branch: the E.7 double-leaf branch
takes leaf-over-homogeneous ratios (validity m2/m1 > 3 reads
mass_ratio < 1/3) and evaluates 3,0 + 14,1 M + 5,7 M^2, numerically
identical to the 2000 figure. Also cites Kij,min as Formula (29)
(Clause 4.4.2) and documents the ISO 12354-1:2017 both-negative
lining-combination rule next to the 2000 form combine_linings()
implements.
* Broadcast a single-number source level across the EN 12354-5 path bands
installed_source_prediction() derived its band count from the source
levels alone, so a single-number characteristic power with per-band
path data either raised a spurious band-count error or produced a
one-element installed_power_level that crashed the fiche table with an
IndexError. The band count is now the widest per-band input, every
per-band input is validated against it (one value broadcasts), and the
result's installed_power_level is broadcast to the band axis; a fiche
regression test covers the scalar-source case.
Also corrects the coupling-term docstrings: D_C is not guaranteed
non-negative, since near a mounting resonance with comparable,
opposite-phase source and receiver mobilities the |Ys + Yi|^2 numerator
collapses (counterexample in the docstring).
* Use a prediction-aware footer disclaimer on the EN 12354 fiches
The shared footer printed 'The results relate only to the tested
specimen.' on every fiche, including prediction sheets that have no
tested specimen. footer_flow() now takes predicted=True (also exposed
through the shared sound-power renderer) and prints 'Predicted result:
the values relate only to the modelled configuration, not to a tested
specimen.' instead; the EN 12354-1/-2/-3 and EN 12354-5 prediction
fiches use it, in both languages.
Also corrects the dated designations on the prediction basis lines:
the 2000 editions are EN 12354-1/-2/-3:2000 (there was no ISO 12354 in
2000), so 'EN/ISO 12354-x:2000' is replaced by 'EN 12354-x:2000'.
* Declare the actual band set on the ISO 10052 basis line and align ES impact terms
The survey fiches accept both the octave and the one-third-octave band
sets, but their standard-basis lines hardcoded '(survey method, octave
bands)'; the line now follows the band set the reported curve actually
carries, in both languages (ISO 717-1:2020 Clause 5.3 / ISO 717-2:2020
Clause 4.4 require stating it). The remaining comments citing the
band-set statement as ISO 717-1 Clause 4.4 now cite 5.3 (717-2 keeps
4.4), and the ISO 10140 fiche docstring cites the test-report clause as
Clause 9 (Clause 6 is the test arrangement).
Spanish terminology of the field impact quantities is aligned with the
UNE editions: UNE-EN ISO 16283-2:2016 defines 'nivel de presión
acústica estandarizado/normalizado de ruido de impactos' (3.13/3.14),
now used by the ISO 16283-2 and ISO 10052 basis lines; the ISO 10140-3
and ISO 12354-2 strings already match their own UNE editions
(UNE-EN ISO 10140-3:2011 3.2, UNE-EN ISO 12354-2:2018 3.1.1/3.1.2) and
stay unchanged.
* Qualify a background-limited ISO 16251-1 result as a lower bound
When any band sits at the 1,3 dB limit of measurement (Formula (2), the
per-band values already reported as > delta-L), the fiche now prints
the boxed delta-Lw with a >= qualifier and a note stating it is a lower
bound, in both languages. A manually built result without CI,delta
prints the bare delta-Lw instead of fabricating a (+0) adaptation term.
The ISO 717-2:2020 Annex C.2 errata entry is extended with the second,
independent print defect: the example's 'Ln,sum = 75,2527 = 75 dB'
reproduces to all printed digits only as the energy sum of the wrong
column over the wrong range (the measured floor with covering, 16 bands
100-3150 Hz), while the A.2.1 sum of the covered reference floor over
100-2500 Hz rounds to 76 dB with either 800 Hz value, so CI,r = -2,
CI,delta = -9 and delta-Llin = 6 dB; the earlier claim that the 800 Hz
misprint alone shifted the CI chain is corrected.
* Regenerate the conformance report, API docs and affected fiche examples
The Kc Table B.1 conformance row now covers all 21 printed rows, the
building API pages pick up the revised docstrings, and the EN 12354
prediction and ISO 15186-1 example fiches are re-rendered with the
prediction footer, the corrected designations and the Clause 8 areas
statement (kept to one page). CHANGELOG entries under [Unreleased].
* Validate the frequency axis and the facade method on the building results
The installed structure-borne prediction now rejects a frequency axis whose
length differs from the resolved band count, so a result can no longer carry
an inconsistent per-band table. FacadeInsulationResult validates its method
on construction, closing the direct-construction path that would render an
unknown method as the loudspeaker quantity. The band-count note also names
the characteristic level and coupling term as width-setting inputs.
Building insulation: formula, fiche and citation fixes against the source standards (#357)
* Correct the ISO 15186-1 Formula (8) N-term and complete the fiche's Clause 8 content
The printed Formula (8) subtracts its 10 lg(N) term, which cannot be
derived: ISO 10140-2:2010 Formula (6) adds the multi-unit correction and
ISO 15186-2:2010 Formula (12) prints the same relation without an N term.
intensity_element_normalized_difference() now returns the derivable
per-unit value (+10 lg N), warns whenever n > 1 deviates from the print,
and the defect is registered in docs/ERRATA.md.
Clause 8 completeness of the intensity fiches: the method statement now
states the test-object and measurement-surface areas S / Sm carried by
the result (Clause 8 g), and report() accepts optional per-band FpI and
pressure-residual intensity index spectra annexed as table columns
(Clause 8 i). The 6.4.2 qualification wording is corrected to 'must not
exceed 10 dB' (the clause flags FpI > 10 dB), the band-set captions now
cite ISO 717-1:2020 Clause 5.3 (statement of results) instead of 4.4,
and the Table B.1 Kc oracle gains the three printed rows 3150/4000/5000
Hz (0,1 dB each) so all 21 rows are pinned.
* Label the road-traffic facade fiche R'tr,s instead of R'45
FacadeInsulationResult now carries the measurement method
(loudspeaker or road_traffic), and the ISO 16283-3 r_prime fiche
selects its labels from it: the road-traffic apparent index is the
distinct quantity R'tr,s (Clause 3.13, -3 dB all-angle correction),
so its report no longer prints the R'45 loudspeaker basis line
(Clause 3.12) over road-traffic numbers.
* Make the ISO 10848 fiche part selectable and register the Formula (20) misprint
The Dn,f / Ln,f quantities are defined in the ISO 10848-1:2006 frame
document (Formulas (4)/(5)); which part governs a measurement depends on
the construction under test, so hardcoding 'ISO 10848-2:2006' in the
basis line mislabelled Part 3 and Part 4 measurements. report() now
accepts part=2/3/4 (default 2) and names ISO 10848-2:2006,
ISO 10848-3:2006 or ISO 10848-4:2010 accordingly, in both languages.
ISO 10848-1:2006 Clause 8.1.1 Formula (20) prints the thin-plate
critical frequency with a spurious extra pi in the denominator (the 1,8
constant already carries 2 pi / sqrt(12)); the implementation was
already pi-free, and the defect is now registered in docs/ERRATA.md
with a misprint note in the critical_frequency docstring, corroborated
by ISO 12354-1:2017 and Hopkins Eq. 2.201.
* Normalize the K24 mass-ratio convention and correct the K24 errata entry
EN 12354-1:2000 prints its two K24 lines in two different mass-ratio
conventions without saying so: the E.5 line follows the annex's own
per-path definition M = lg(m'perp,i/m'i), while the Figure E.9 (E.7)
line is stated in the figure-axis variable lg(m2/m1). Read with the
declared per-path M, the E.9 print contradicts its own curve;
ISO 12354-1:2017 E.3.5 prints the same relation consistently in the
per-path convention (+14,1 M). Re-deriving both editions against the
figures shows the earlier errata entry misread this recast as a 2017
sign misprint; the entry is rewritten accordingly.
junction_vibration_reduction() now applies the documented per-path
mass_ratio = m'perp,i/m'i to every branch: the E.7 double-leaf branch
takes leaf-over-homogeneous ratios (validity m2/m1 > 3 reads
mass_ratio < 1/3) and evaluates 3,0 + 14,1 M + 5,7 M^2, numerically
identical to the 2000 figure. Also cites Kij,min as Formula (29)
(Clause 4.4.2) and documents the ISO 12354-1:2017 both-negative
lining-combination rule next to the 2000 form combine_linings()
implements.
* Broadcast a single-number source level across the EN 12354-5 path bands
installed_source_prediction() derived its band count from the source
levels alone, so a single-number characteristic power with per-band
path data either raised a spurious band-count error or produced a
one-element installed_power_level that crashed the fiche table with an
IndexError. The band count is now the widest per-band input, every
per-band input is validated against it (one value broadcasts), and the
result's installed_power_level is broadcast to the band axis; a fiche
regression test covers the scalar-source case.
Also corrects the coupling-term docstrings: D_C is not guaranteed
non-negative, since near a mounting resonance with comparable,
opposite-phase source and receiver mobilities the |Ys + Yi|^2 numerator
collapses (counterexample in the docstring).
* Use a prediction-aware footer disclaimer on the EN 12354 fiches
The shared footer printed 'The results relate only to the tested
specimen.' on every fiche, including prediction sheets that have no
tested specimen. footer_flow() now takes predicted=True (also exposed
through the shared sound-power renderer) and prints 'Predicted result:
the values relate only to the modelled configuration, not to a tested
specimen.' instead; the EN 12354-1/-2/-3 and EN 12354-5 prediction
fiches use it, in both languages.
Also corrects the dated designations on the prediction basis lines:
the 2000 editions are EN 12354-1/-2/-3:2000 (there was no ISO 12354 in
2000), so 'EN/ISO 12354-x:2000' is replaced by 'EN 12354-x:2000'.
* Declare the actual band set on the ISO 10052 basis line and align ES impact terms
The survey fiches accept both the octave and the one-third-octave band
sets, but their standard-basis lines hardcoded '(survey method, octave
bands)'; the line now follows the band set the reported curve actually
carries, in both languages (ISO 717-1:2020 Clause 5.3 / ISO 717-2:2020
Clause 4.4 require stating it). The remaining comments citing the
band-set statement as ISO 717-1 Clause 4.4 now cite 5.3 (717-2 keeps
4.4), and the ISO 10140 fiche docstring cites the test-report clause as
Clause 9 (Clause 6 is the test arrangement).
Spanish terminology of the field impact quantities is aligned with the
UNE editions: UNE-EN ISO 16283-2:2016 defines 'nivel de presión
acústica estandarizado/normalizado de ruido de impactos' (3.13/3.14),
now used by the ISO 16283-2 and ISO 10052 basis lines; the ISO 10140-3
and ISO 12354-2 strings already match their own UNE editions
(UNE-EN ISO 10140-3:2011 3.2, UNE-EN ISO 12354-2:2018 3.1.1/3.1.2) and
stay unchanged.
* Qualify a background-limited ISO 16251-1 result as a lower bound
When any band sits at the 1,3 dB limit of measurement (Formula (2), the
per-band values already reported as > delta-L), the fiche now prints
the boxed delta-Lw with a >= qualifier and a note stating it is a lower
bound, in both languages. A manually built result without CI,delta
prints the bare delta-Lw instead of fabricating a (+0) adaptation term.
The ISO 717-2:2020 Annex C.2 errata entry is extended with the second,
independent print defect: the example's 'Ln,sum = 75,2527 = 75 dB'
reproduces to all printed digits only as the energy sum of the wrong
column over the wrong range (the measured floor with covering, 16 bands
100-3150 Hz), while the A.2.1 sum of the covered reference floor over
100-2500 Hz rounds to 76 dB with either 800 Hz value, so CI,r = -2,
CI,delta = -9 and delta-Llin = 6 dB; the earlier claim that the 800 Hz
misprint alone shifted the CI chain is corrected.
* Regenerate the conformance report, API docs and affected fiche examples
The Kc Table B.1 conformance row now covers all 21 printed rows, the
building API pages pick up the revised docstrings, and the EN 12354
prediction and ISO 15186-1 example fiches are re-rendered with the
prediction footer, the corrected designations and the Clause 8 areas
statement (kept to one page). CHANGELOG entries under [Unreleased].
* Validate the frequency axis and the facade method on the building results
The installed structure-borne prediction now rejects a frequency axis whose
length differs from the resolved band count, so a result can no longer carry
an inconsistent per-band table. FacadeInsulationResult validates its method
on construction, closing the direct-construction path that would render an
unknown method as the loudspeaker quantity. The band-count note also names
the characteristic level and coupling term as width-setting inputs.
Align the sound power determinations and noise declarations with their standards' clauses (#353)
- ISO 3741:2010, 9.1.2/9.1.3: apply the background correction at each
microphone position (K1i, Eq. 14), correct the position levels first
(Eq. 15) and only then energy-average (Eq. 16). Pre-averaged 1D spectra
keep the single-K1 path, documented as an approximation.
- ISO 9614-2:1996, 10.6 b: omit the bands failing criteria 1 and/or 2 from
the A-weighted total, flag them in the new a_weighting_omitted_bands field
and name them in the fiche basis strip (EN/ES); warn when the criteria
inputs are absent and the screening cannot run.
- ISO 9614-3:2002, C.1.6.2: a band satisfying criterion 5 qualifies as a
final result even if FS(2) >= 2.
- ISO 3745:2012: bands above 10 kHz no longer abort the determination; only
the A-weighted total (outside the ISO 3744 Annex E table) is NaN.
- ISO 3744:2010, 8.2.3 / ISO 3746:2010, 8.3.3: K1 = 0 only strictly above
the upper criterion; Equation (16) still applies at exactly 15 dB / 10 dB.
- ISO 4871:1996, 3.16/6.2: verify dual-number declarations against the sum
of the separately rounded declared values (verified_dual), and lay the
dual-number fiche out exactly as Annex B.2 (no derived L_WAd row).
- Cite clause 8.4 for the apparent directivity indices and note that the
4.3.2 validity limit concerns K2A (per-band check kept, conservative).
Hand-derived oracles cover each correction; the ISO 4871 and ISO 9614-2
example fiches, the API reference pages and the llms text are regenerated.
Correct the framing and the guards of the perception and noise-control fiches (#355)
A review pass over the psychoacoustics, hearing, speech, environmental and
noise-control fiches. The numerics held up; what did not were the statements
printed around them, plus one wrong table lookup.
ISO 1999 validated domain. nipts()/htlan() applied Formula (2) wherever they
were asked to: L_EX,8h = 130 dB over 60 years at the 0,99 fractile returned a
357,9 dB threshold shift with nothing marking it as an extrapolation. Since the
formula is quadratic in (L_EX,8h - L0) that number is meaningless, not merely
uncertain. Both now warn (NoiseInducedHearingLossWarning) outside the stated
ranges while still computing: durations outside 1-40 years (clause 6.3.1
validates Formula (2) over 10-40 and Formula (3) over 1-10), fractiles in the
tails clause 6.3.2 says "should not be estimated" (Q below 5 % or above 95 %),
and levels above the 100 dB of Annex D that the Scope's NOTE 4 restricts
validity to. The fiches print the caveat when the conditions sit outside.
ISO 1999 Q. The fiches printed the library's fractile under ISO 1999's symbol,
inverting its meaning: in Formulae (4)/(5) Q is the percentage with worse
hearing, so the most-susceptible tenth is Q = 10 %, not the "Q = 0.9" the fiche
showed while citing 6.3.2. They now print ISO's Q as ISO defines it; the guides
note the difference from the fractile argument. Two further disclosures on the
same fiches: the age component H is evaluated from ISO 7029:2017 (the edition
ISO 1999 references undated in 6.2.2), which departs from the illustrative
Table A.3 selection by up to about 7 dB at the median, and the 2/3/4 kHz
average is the user's own choice, the Scope's NOTE 1 specifying no frequency
combination. The footer states a population scope rather than "the results
relate only to the tested specimen", which describes a laboratory specimen.
ISO 1999 Annex C is wired in as an independent oracle: its worked example (male
population aged 50, 90 dB for 30 years, 1/2/4 kHz at Q = 10 %) reproduces the
Table D.2 shifts it consumes (0, 9, 19 dB), the 13,3 dB left of the 4 kHz shift
after the Formula (1) compression (C.5) and the 31,1 dB combined threshold
(C.11). The composition it exercises is now exposed as combine_age_and_noise(),
which clause 6.2 wants available on its own: 6.2.3 recommends a database B
collected on a control population of the country under consideration, and this
applies Formula (1) to whichever database the user brings.
Verdict precision. The STI and SII fiches printed the requirement with one
decimal beside a measured value at full precision, so a verdict could contradict
itself: "STI = 0.50, required >= 0.5 -> FAIL" against a 0,52 requirement, and an
SII minimum of 0,75 printed as "0.8" (the committed example said so). Both now
print the requirement at the quantity's own precision. IEC 60268-16 Annex M
joins the conformance report as an end-to-end oracle: its printed MTF matrix,
speech spectrum and ambient noise give back its published MTI row and
STI = 0,76, exercising the whole A.5.3 to A.5.8 chain.
Noise-control prediction framing. The enclosure, silencer and HVAC fiches
compute design models but read as measurements: no prediction statement,
measurement headers, a footer scoped to a tested specimen, and committed
examples citing instrumentation that never existed ("Two-microphone
transfer-matrix bench"). They now follow the EN/ISO 12354 prediction exemplar
already in the repo, with a prediction-basis line, a statement naming what each
model does not represent, and a prediction footer. Their verdicts also decided
on the half-away-from-zero display rounding while printing Python's
round-half-to-even, so 0,25 printed 0.2 against a verdict taken on 0,3; both
now use the display rounding.
ISO/PAS 1996-3. With every onset rate at or below 10 dB/s the fiche withheld
the adjustment on the onset-rate gate (clauses 4.5/8) but justified it with "no
prominent impulse is present (governing P = 6.01 <= 5)", contradicting its own
boxed P. The note now states whichever gate governs. The assessment period is
read from the result instead of being hardcoded: 30 min is the Clause 5
*default*, now the default of the new assessment_period_min argument.
Smaller corrections:
- the HVAC elbow insertion loss took the wrong row of Bies Table 8.11 for a
W/lambda exactly on a bin edge; the rows read "a <= W/lambda < b", so an edge
opens its row (1 dB at 0,14, not 0 dB);
- the wind-turbine tonality fiche cited "subclauses 9.5.2-9.5.5" of
IEC 61400-11 for a chain running through 9.5.6 to 9.5.8 (Formulae 31-34);
- the ISO 1996-2 tonal fiche notes that Table J.1 keys on the mean audibility
of the J assessed spectra (ISO/PAS 20065 Clause 5.3.9), which a
single-spectrum assessment stands in for;
- the shared 10-90 % fractile band carried a hardcoded English legend in
Spanish figures, and the Spanish silencer and HVAC fiches printed the device
kind and duct-element label in English.
docs/ERRATA.md records two more source defects found on the way: ISO/PAS
1996-3:2022 Clause 5 swaps the 3.4/3.5 cross-references of the onset rate and
the level difference (its own units contradict the clause numbers printed with
them), and ISO 9613-2:1996 Table 2 prints 4,1 dB/km at 15 C / 80 % / 1 kHz
where ISO 9613-1 gives 4,1511, the neighbouring cells rounding correctly. The
library computes that coefficient from ISO 9613-1 directly, so it is unaffected.
Committed example fiches, the conformance report, the API reference and the
llms files are regenerated.