PyOctaveBand/site/src/content/docs/reference/api/psychoacoustics/ 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 / site / src / content / docs / reference / api / psychoacoustics /

at study/toc-grouping 13 files

José M. Requena Plens Perception, hearing and speech guides: result figures and when-to-use prose (#361) 8d ago

fluctuation-strength-ecma.md

Perception, hearing and speech guides: result figures and when-to-use prose (#361) * Perception, hearing and speech guides: result figures and when-to-use prose Add ToneAssessment.plot(), which draws an ECMA-418-1 tone against the prominence criterion of its own method (recovered from criterion_db) over the whole range of interest, with the deciding margin marked, and a view="levels" option on ToneAudibilityResult.plot() that exposes the level-versus-frequency view the ISO 1996-2 fiche already embedded. Add eleven single-concept figures to the perception, hearing and speech guides, each a realistic result drawn by its own .plot(): the tone prominence verdict, the ISO/PAS 20065 tone levels, the ISO/PAS 1996-3 onset detection, the ISO 532-2 specific loudness, the ECMA-418-2 specific tonality, the specific fluctuation strength, the SII band audibility under a hearing loss, the ISO 7029 fractile band, the ISO 1999 NIPTS audiogram, the STOI per-band correlation and the IEC 60268-16 per-band MTI. Every figure is embedded in the English guide, the Spanish mirror and the docs mirror with the dual snippet block, and every plottable snippet on those pages now names its .plot(). Prose: the tone-prominence guide gains a comparison of the four tonality assessments the library implements and when each applies, the hearing-threshold guide explains how the ISO 7029 fractiles feed the ISO 1999 age component and gains a See-also section, and the objective-intelligibility guide gains the "which measure, and when" section that existed only in the docs mirror, extended with the STOI/ESTOI, STI and SII choice. Also label the STOI band axis at whole-hertz resolution and let the shaded critical band of the tone-audibility levels plot follow the figure background, so it reads on the white report page and on dark figures alike. * Correct two figure alt texts against the plotted values The ISO 7029 fractile figure describes the median and the 90 % fractile with the values it actually draws (10 to 50 dB and 22 to 74 dB), and the ECMA-418-2 specific tonality peak is at 9 Bark_HMS.

1 week ago

fluctuation-strength.md

feat: EN/ES language option for the psychoacoustics/hearing/vibration plots (#253) Add a `language` keyword ("en" default, "es") to the `.plot()` methods of every psychoacoustics, hearing and vibration result. Spanish renders the axis labels, titles and legends in Spanish and switches the decimal separator to a comma; the English output is unchanged. - New `phonometry._i18n` module with the shared locale helpers (language validation, locale-aware number formatting and linear-axis tick localisation). - Each `_plot` renderer gains a module-level string table and localises its fixed text; the `_i18n` helpers are imported lazily inside the functions so the render leaves keep no module-level domain imports. - Per-domain tests covering a Spanish label and the unknown-language error. - Regenerated the API reference for the new `.plot()` signatures.

1 week ago

loudness-contours.md

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.

1 week ago

loudness-ecma.md

feat: EN/ES language option for the psychoacoustics/hearing/vibration plots (#253) Add a `language` keyword ("en" default, "es") to the `.plot()` methods of every psychoacoustics, hearing and vibration result. Spanish renders the axis labels, titles and legends in Spanish and switches the decimal separator to a comma; the English output is unchanged. - New `phonometry._i18n` module with the shared locale helpers (language validation, locale-aware number formatting and linear-axis tick localisation). - Each `_plot` renderer gains a module-level string table and localises its fixed text; the `_i18n` helpers are imported lazily inside the functions so the render leaves keep no module-level domain imports. - Per-domain tests covering a Spanish label and the unknown-language error. - Regenerated the API reference for the new `.plot()` signatures.

1 week ago

loudness-moore-glasberg-time.md

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.

1 week ago

loudness-moore-glasberg.md

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.

1 week ago

loudness-zwicker.md

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.

1 week ago

psychoacoustic-annoyance.md

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.

1 week ago

roughness-ecma.md

feat: EN/ES language option for the psychoacoustics/hearing/vibration plots (#253) Add a `language` keyword ("en" default, "es") to the `.plot()` methods of every psychoacoustics, hearing and vibration result. Spanish renders the axis labels, titles and legends in Spanish and switches the decimal separator to a comma; the English output is unchanged. - New `phonometry._i18n` module with the shared locale helpers (language validation, locale-aware number formatting and linear-axis tick localisation). - Each `_plot` renderer gains a module-level string table and localises its fixed text; the `_i18n` helpers are imported lazily inside the functions so the render leaves keep no module-level domain imports. - Per-domain tests covering a Spanish label and the unknown-language error. - Regenerated the API reference for the new `.plot()` signatures.

1 week 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.

1 week ago

tonality-ecma.md

feat: EN/ES language option for the psychoacoustics/hearing/vibration plots (#253) Add a `language` keyword ("en" default, "es") to the `.plot()` methods of every psychoacoustics, hearing and vibration result. Spanish renders the axis labels, titles and legends in Spanish and switches the decimal separator to a comma; the English output is unchanged. - New `phonometry._i18n` module with the shared locale helpers (language validation, locale-aware number formatting and linear-axis tick localisation). - Each `_plot` renderer gains a module-level string table and localises its fixed text; the `_i18n` helpers are imported lazily inside the functions so the render leaves keep no module-level domain imports. - Per-domain tests covering a Spanish label and the unknown-language error. - Regenerated the API reference for the new `.plot()` signatures.

1 week ago

Perception, hearing and speech guides: result figures and when-to-use prose (#361) * Perception, hearing and speech guides: result figures and when-to-use prose Add ToneAssessment.plot(), which draws an ECMA-418-1 tone against the prominence criterion of its own method (recovered from criterion_db) over the whole range of interest, with the deciding margin marked, and a view="levels" option on ToneAudibilityResult.plot() that exposes the level-versus-frequency view the ISO 1996-2 fiche already embedded. Add eleven single-concept figures to the perception, hearing and speech guides, each a realistic result drawn by its own .plot(): the tone prominence verdict, the ISO/PAS 20065 tone levels, the ISO/PAS 1996-3 onset detection, the ISO 532-2 specific loudness, the ECMA-418-2 specific tonality, the specific fluctuation strength, the SII band audibility under a hearing loss, the ISO 7029 fractile band, the ISO 1999 NIPTS audiogram, the STOI per-band correlation and the IEC 60268-16 per-band MTI. Every figure is embedded in the English guide, the Spanish mirror and the docs mirror with the dual snippet block, and every plottable snippet on those pages now names its .plot(). Prose: the tone-prominence guide gains a comparison of the four tonality assessments the library implements and when each applies, the hearing-threshold guide explains how the ISO 7029 fractiles feed the ISO 1999 age component and gains a See-also section, and the objective-intelligibility guide gains the "which measure, and when" section that existed only in the docs mirror, extended with the STOI/ESTOI, STI and SII choice. Also label the STOI band axis at whole-hertz resolution and let the shaded critical band of the tone-audibility levels plot follow the figure background, so it reads on the white report page and on dark figures alike. * Correct two figure alt texts against the plotted values The ISO 7029 fractile figure describes the median and the 90 % fractile with the values it actually draws (10 to 50 dB and 22 to 74 dB), and the ECMA-418-2 specific tonality peak is at 9 Bark_HMS.

1 week ago

tone-audibility.md

Perception, hearing and speech guides: result figures and when-to-use prose (#361) * Perception, hearing and speech guides: result figures and when-to-use prose Add ToneAssessment.plot(), which draws an ECMA-418-1 tone against the prominence criterion of its own method (recovered from criterion_db) over the whole range of interest, with the deciding margin marked, and a view="levels" option on ToneAudibilityResult.plot() that exposes the level-versus-frequency view the ISO 1996-2 fiche already embedded. Add eleven single-concept figures to the perception, hearing and speech guides, each a realistic result drawn by its own .plot(): the tone prominence verdict, the ISO/PAS 20065 tone levels, the ISO/PAS 1996-3 onset detection, the ISO 532-2 specific loudness, the ECMA-418-2 specific tonality, the specific fluctuation strength, the SII band audibility under a hearing loss, the ISO 7029 fractile band, the ISO 1999 NIPTS audiogram, the STOI per-band correlation and the IEC 60268-16 per-band MTI. Every figure is embedded in the English guide, the Spanish mirror and the docs mirror with the dual snippet block, and every plottable snippet on those pages now names its .plot(). Prose: the tone-prominence guide gains a comparison of the four tonality assessments the library implements and when each applies, the hearing-threshold guide explains how the ISO 7029 fractiles feed the ISO 1999 age component and gains a See-also section, and the objective-intelligibility guide gains the "which measure, and when" section that existed only in the docs mirror, extended with the STOI/ESTOI, STI and SII choice. Also label the STOI band axis at whole-hertz resolution and let the shaded critical band of the tone-audibility levels plot follow the figure background, so it reads on the white report page and on dark figures alike. * Correct two figure alt texts against the plotted values The ISO 7029 fractile figure describes the median and the 90 % fractile with the values it actually draws (10 to 50 dB and 22 to 74 dB), and the ECMA-418-2 specific tonality peak is at 9 Bark_HMS.

1 week ago