PyOctaveBand/.github/ at fix/deterministic-figures · 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 / .github /

at fix/deterministic-figures 3 folders 2 files

José M. Requena Plens feat: floor-covering impact improvement on a mock-up (ISO 16251-1:2014) (#130) 14d ago

feat: floor-covering impact improvement on a mock-up (ISO 16251-1:2014) (#130) Add the laboratory method for the improvement of impact sound insulation ΔL of soft, locally-reacting floor coverings (carpet, PVC, linoleum) measured on a small concrete mock-up via structure-borne acceleration levels, plus the ISO 717-2 weighted improvement ΔLw it feeds. - weighted_impact_improvement (insulation.py): ISO 717-2:2020 Clause 5 ΔLw = 78 - Ln,r,w using the heavyweight reference floor of Table 4, reusing the verified weighted_impact_rating engine - floor_covering_improvement.py (ISO 16251-1): - acceleration_level (Formula 1, a0 = 1e-6 m/s²) - background_corrected_level (Formula 2, three-branch rule with a limit-of-measurement flag) - impact_improvement: Formula (2) per position -> difference (3) -> mean over positions (4); accepts (bands,) or (positions, bands) levels - improvement_octave_bands (Formula 5) - FloorCoveringImprovementResult with ΔLw, the > ΔL limit mask and .plot() - Conformance checks: ISO 717-2 reference-floor rating (78 dB, CI -11) and the ΔL=0 -> ΔLw=0 identity (109/109). ISO 16251-1 has no worked numeric example (Annex B is a blank form), so the oracle is the ISO 717-2 reference floor. - generate_floor_covering_improvement figure (EN/ES × light/dark) - Building-acoustics guide §7 and API reference rows (EN + ES) - 20 tests covering all formulas, the per-position ordering and validation

2 weeks ago

Scattering/diffusion, in-situ road absorption & precision sound power (ISO 17497-1/-2, ISO 13472-1/-2, ISO 3745, ISO 9614-3) (#92) Clean-room ISO 17497-1/-2 (scattering & diffusion), ISO 13472-1/-2 (in-situ road absorption) and ISO 3745 / 9614-3 (precision sound power). Plottable result objects with .plot(), single-concept documentation figures with dual-snippet <details>, 12 new conformance checks (60/60), and 6 experimental-setup diagrams. All subagent-reviewed and visually validated. https://claude.ai/code/session_01JJLhQzF5hTdnEi3bfmqnqm

2 weeks ago

feat: IEC 61672-1:2013 frequency-weighting class verifier (#124) Add `verify_weighting_class(wf)` and `weighting_class_limits(class)`, the weighting-domain counterparts of the existing `verify_filter_class` / `class_limits`. The verifier evaluates a WeightingFilter's designed response at each Table 3 nominal frequency below Nyquist, subtracts the design-goal weighting and reports the per-frequency and overall performance class (1, 2 or None) with dB margins. The class 1 and class 2 acceptance masks and the A/C/Z design goals are transcribed from BS EN 61672-1:2013 Table 3 (standard page 22); the class 1 columns are cross-checked in the tests against the independent reference_data copy shared with the CI conformance report, and a second test cross-validates the deviations against a time-domain tone RMS. Includes a weighting_class_mask figure (A/C deviation threading the class 1 corridor with the wider class 2 limits) wired into `make graphs`, and docs in weighting.md + the site (EN/ES) and the API reference. Also harden the "Documentation figures up to date" CI job: pin the full render+compute stack (matplotlib/fonttools/pillow/numpy/scipy/...) in requirements-figures.txt instead of matplotlib alone. A newer numpy or fonttools silently shifts the computed path coordinates / text layout of a few figures, which flaked the byte check. Class 0 for filters is intentionally out of scope: IEC 61260-1:2014 dropped it, and the withdrawn IEC 61260:1995 / ANSI S1.11-2004 class-0 masks use class 1/2 limits that differ from the 2014 edition the filter verifier is built on, so they cannot be mixed in consistently.

2 weeks ago

feat: floor-covering impact improvement on a mock-up (ISO 16251-1:2014) (#130) Add the laboratory method for the improvement of impact sound insulation ΔL of soft, locally-reacting floor coverings (carpet, PVC, linoleum) measured on a small concrete mock-up via structure-borne acceleration levels, plus the ISO 717-2 weighted improvement ΔLw it feeds. - weighted_impact_improvement (insulation.py): ISO 717-2:2020 Clause 5 ΔLw = 78 - Ln,r,w using the heavyweight reference floor of Table 4, reusing the verified weighted_impact_rating engine - floor_covering_improvement.py (ISO 16251-1): - acceleration_level (Formula 1, a0 = 1e-6 m/s²) - background_corrected_level (Formula 2, three-branch rule with a limit-of-measurement flag) - impact_improvement: Formula (2) per position -> difference (3) -> mean over positions (4); accepts (bands,) or (positions, bands) levels - improvement_octave_bands (Formula 5) - FloorCoveringImprovementResult with ΔLw, the > ΔL limit mask and .plot() - Conformance checks: ISO 717-2 reference-floor rating (78 dB, CI -11) and the ΔL=0 -> ΔLw=0 identity (109/109). ISO 16251-1 has no worked numeric example (Annex B is a blank form), so the oracle is the ISO 717-2 reference floor. - generate_floor_covering_improvement figure (EN/ES × light/dark) - Building-acoustics guide §7 and API reference rows (EN + ES) - 20 tests covering all formulas, the per-position ordering and validation

2 weeks ago

docs: restructure into docs/, slim PyPI-safe README, bilingual Starlight site with theme-aware figures (#61) * docs: split README content into docs/ topic pages 11 topic pages under docs/ (guides + reference), including the new levels/spectrogram documentation and a Why PyOctaveBand page distilled from the issue #38 IEC 61672-1 compliance analysis. Claude-Session: https://claude.ai/code/session_013kkVt3nxi9svp1an28uHxf * docs: add auto-generated figures for levels/spectrogram/zero-phase docs Four new generate_* functions (spectrogram example, LN levels over the Fast envelope, zero-phase group-delay comparison, A-weighting HF accuracy), a 'make graphs' target, and a CONTRIBUTING section formalizing that every docs image must come from generate_graphs.py. Claude-Session: https://claude.ai/code/session_013kkVt3nxi9svp1an28uHxf * docs: slim README to hook + quick start with absolute links (PyPI-safe) The README is the PyPI landing page and PyPI does not resolve relative links, so every link (docs pages, website, CONTRIBUTING, LICENSE) is now absolute. The Documentation section sits right after installation with a per-page table. Full content lives in docs/ and on the website. Claude-Session: https://claude.ai/code/session_013kkVt3nxi9svp1an28uHxf * docs(site): scaffold Astro/Starlight with en/es i18n, KaTeX, and English content Starlight site under site/ with base /PyOctaveBand for GitHub Pages, locale-aware sidebar, KaTeX math rendering, and the 11 English pages ported from docs/ (links rewritten to site routes, GitHub alerts converted to Starlight asides). Claude-Session: https://claude.ai/code/session_013kkVt3nxi9svp1an28uHxf * docs: generate all figures in light and dark themes generate_graphs.py now renders every figure twice (light + _dark suffix) via a theme switch (dark_background style, foreground color swap). - docs/ (GitHub): <picture> with prefers-color-scheme sources. - site/ (Starlight): dual img.light-only/.dark-only following the theme toggle via [data-theme] CSS. - README keeps plain light images (PyPI sanitizes <picture>). Claude-Session: https://claude.ai/code/session_013kkVt3nxi9svp1an28uHxf * docs(site): add complete Spanish translation Full natural translation of all 12 pages (landing, getting started, 7 guides, 3 reference pages) with theme-aware images and es/ routes. Claude-Session: https://claude.ai/code/session_013kkVt3nxi9svp1an28uHxf * ci: deploy Starlight docs site to GitHub Pages Claude-Session: https://claude.ai/code/session_013kkVt3nxi9svp1an28uHxf * ci: bump actions to latest, dependabot cooldown 0, refresh all dependencies - Workflows: checkout v7; docs.yml to setup-node v6, pnpm/action-setup v6, upload-pages-artifact v5, deploy-pages v5 (pnpm stays 11.x). - Dependabot: cooldown 0 days on all ecosystems, stop ignoring pip minor/patch updates (grouped), add npm ecosystem for site/. - Python deps to latest: scipy 1.18, matplotlib 3.11, numba 0.66, mypy 2.1, ruff 0.15.20, pytest 9.1. numpy capped <2.5 in the dev/CI environment because numba 0.66 requires it (users without the [perf] extra are unaffected). - Site deps to latest: astro 7.0.6, starlight 0.41.3, katex 0.17, sharp 0.35. - Repo configured via API: homepage -> docs site URL, GitHub Pages enabled with build_type=workflow (no manual post-merge step needed anymore). Claude-Session: https://claude.ai/code/session_013kkVt3nxi9svp1an28uHxf * docs: address review feedback (dependabot schema, snippets, workflow hardening) - dependabot: remove cooldown blocks (default-days minimum is 1; no cooldown IS the zero-delay behavior). - docs.yml: scope pages/id-token permissions to the deploy job only and set persist-credentials: false on checkout (third-party install scripts run in the build job). - Snippets: add missing numpy import, define the bank in the zero-phase example, linspace endpoint=False (docs + site EN/ES + README). - tsconfig: exclude node_modules and .astro explicitly. - A-weighting +2.00 constant kept: verified numerically that 20*log10(RA(1000)) = -1.99986, so +2.00 yields 0.0001 dB at 1 kHz; the suggested +2.06 would introduce a +0.06 dB offset. Claude-Session: https://claude.ai/code/session_013kkVt3nxi9svp1an28uHxf

2 weeks ago