PyOctaveBand/.github/ at study/toc-grouping · 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 study/toc-grouping 4 folders 2 files

José M. Requena Plens Spanish docs: UNE terminology, decimal commas, localized snippets and theory figures (#365) 2d ago

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

2 days ago

Fix vertical line collisions in fiche prose with sub/superscripts (#358) * Fix vertical line collisions in fiche prose with sub/superscripts reportlab shifts a <sub>/<super> fragment by half the font size but spaces paragraph lines by the style's fixed leading alone: its autoLeading modes compute line bounds from per-fragment font sizes and ignore the script rise entirely, so a wrapped fiche line ending in deep subscripts (e.g. the EN 12354-5 L_n,s,ij formula strip) overprinted the ascenders and superscripts of the next line. Clearing the default half-em shift with fixed leading alone would need 1.65x-em line spacing on every prose style, growing each block by about a third and breaking the dense one-page fiche layout. Instead, every fiche paragraph is now built through a shared _layout.fiche_paragraph factory (imported by the renderers as Paragraph) that rewrites the bare <sub>/<sup>/<super> openers to the typographic quarter-em rise; the worst-case line extent (deepest subscript directly above the tallest superscript) is then 1.24x the font size, inside the fixed leading of every fiche prose style, and the scripts sit closer to their base text as accredited lab reports typeset them. * Regenerate the example fiches with collision-safe sub/superscripts

2 days ago

Adopt ruff 0.16 and modernize the codebase to its default rules (#345) ruff 0.16 broadens the default rule set (pyupgrade, isort, comprehensions and more). Bump the dev pin to ruff>=0.16.0 and apply the resulting fixes across the tree: PEP 585 built-in generic annotations, unquoted annotations under from-future annotations, sorted imports and the assorted small lint fixes. A re-export shim that relied on redundant import aliases now declares __all__ explicitly. The api reference is regenerated for the modernized signatures. No runtime behavior changes; the full test suite passes.

3 days ago

Migrate committed raster doc assets from PNG to lossless WebP (#287) * Migrate committed raster doc assets from PNG to lossless WebP The 13 report-fiche previews under .github/reports and the 11 raster figures (44 files across the light/dark/EN/ES variants) under .github/images are now encoded as lossless WebP: pixel-identical to the previous PNGs at roughly half the size for the previews (1.67 MB to 0.82 MB) and two thirds for the figures (26.2 MB to 17.1 MB). Flat-color document pages and plots compress better lossless than lossy, and the Pillow method=6 encode is byte-stable across runs, so the committed bytes stay reproducible. SVG figures are untouched. scripts/generate_reports.py and scripts/generate_graphs.py write WebP directly (the oxipng PNG optimizer pass is gone, and the pyoxipng pin with it); scripts/check_figures.py compares WebP rasters with the same pixel tolerance it used for PNG. All documentation embeds (site EN+ES, docs/, ReportPreview) now point at the .webp assets. * review: close the render buffer with a context manager and reuse the width constant in tests

6 days ago

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

2 days 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

3 weeks ago