PyOctaveBand/site/src/components/ at chore/untrack-local-docs · jmrp.io/PyOctaveBand · Tangled

jmrp.io / PyOctaveBand

0

[READ-ONLY] Mirror of https://github.com/jmrplens/PyOctaveBand. [Python3] Octave-Band and Fractional Octave-Band filter. For signal in time domain. jmrplens.github.io/PyOctaveBand/

acoustics audio filter frequency frequency-analysis frequency-domain octave python3 signal time-domain

0

PyOctaveBand / site / src / components /

at chore/untrack-local-docs 3 files

José M. Requena Plens feat: wind-turbine noise — apparent sound power & tonal audibility (IEC 61400-11) (#146) 14d ago

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

2 weeks ago

Rename to phonometry (3.0.0): new identity, Python 3.13 floor, transition stub (#73) * feat!: rename PyOctaveBand to phonometry, require Python 3.13 BREAKING CHANGE: the package is now 'phonometry' (pip install phonometry, import phonometry). The API is unchanged; renaming the import is a complete migration. Python floor raised from 3.11 to 3.13; CI covers 3.13/3.14 and the 3.15 prerelease (experimental, ubuntu only). Migration support: - stub/: transition package PyOctaveBand 2.1.0 that depends on phonometry and re-exports the API under the legacy pyoctaveband name with a DeprecationWarning (published via the manual publish-stub workflow) - locked pyoctaveband-v2 branch preserves the last pre-rename state - README/CITATION/.zenodo.json note 'formerly PyOctaveBand' - SonarCloud project key kept (immutable); repo URLs switch to jmrplens/phonometry (GitHub redirects cover the old links) - site: new base /phonometry, regenerated og-image and llms.txt Claude-Session: https://claude.ai/code/session_013kkVt3nxi9svp1an28uHxf * fix: address rename PR review feedback - stub: FutureWarning instead of DeprecationWarning (visible by default, so users of the old name actually see the migration notice) - manual_verify_install: pass inputs.version through an env var (shell injection) and force bash for cross-OS env expansion - publish-stub: persist-credentials: false on checkout - drop Python 3.15 from CI and classifiers until it has a stable release Claude-Session: https://claude.ai/code/session_013kkVt3nxi9svp1an28uHxf

2 weeks ago

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

2 weeks ago