open_nl

print.prescription_target

summary.prescription_target

plot.prescription_target

Calculates experimental prescriptive insertion gain and SSPL90 targets for a given hearing loss, based on a rule-based WDRC heuristic.

Calculates the American National Standards Institute (ANSI) S3.5-1997
Speech Intelligibility Index (SII) (ANSI 1997,
(ANSI, 1997)), a standard
method for computing the intelligibility of speech from acoustical
measurements of speech, noise, and hearing thresholds. This package
includes data frames corresponding to Tables 1 - 4 in the ANSI standard as
well as functions utilizing these tables and user-provided hearing
threshold and noise level measurements to compute the SII score. The
methods implemented here extend the standard computations to allow
calculation of SII when the measured frequencies do not match those
required by the standard by applying interpolation. Furthermore, the
package now includes a native, highly optimized C++ implementation of the
canonical Moore & Glasberg (2004) specific loudness model for impaired
hearing, which structurally mirrors the bramslow2004 implementation from
the Auditory Modeling Toolbox (AMT) to calculate loudness in perceptual
sones. It also includes advanced methods to predict aided SII based on
hearing aid prescriptive rationales, introducing Open-NL (Open Non-Linear),
a novel theoretical optimization framework. Open-NL utilizes a Nelder-Mead
simplex algorithm to maximize the ANSI SII metric, subject to computational
physiological loudness penalties and simulated hardware Maximum Power
Output (MPO) constraints, to derive theoretical gain targets. The package
also provides functions to calculate real-ear insertion gains, estimate
maximum power output (SSPL90), and prescribe dynamic range compression.
NOTE: This package is explicitly flagged as a non-clinical academic tool
designed exclusively for theoretical modeling and simulation. It has not
undergone clinical validation and is strictly contraindicated for general
clinical fitting. Unapproved use for direct patient care is prohibited. Any
application of this tool to human subjects must occur exclusively within
the strictly controlled context of Institutional Review Board (IRB)
approved research studies. Development of this package was originally
funded by the Center for Bioscience Education and Technology (CBET) of the
Rochester Institute of Technology (RIT).

Mark Shaver

Calculate ANSI/ASA S3.5-1997 (R2024) Speech Intelligibility
Index

open_nl function

<dl><dt>speech</dt>
<dd>Input speech spectrum level at each frequency. If a single number is provided, it's assumed to be the overall broadband SPL.</dd>
<dt>threshold</dt>
<dd>Hearing threshold level at each frequency.</dd>
<dt>freq</dt>
<dd>Frequencies at which the thresholds are measured.</dd>
<dt>gender</dt>
<dd>Gender of the patient ("male", "female").</dd>
<dt>experience</dt>
<dd>Hearing aid experience ("new", "experienced").</dd>
<dt>config</dt>
<dd>Fitting configuration ("unilateral", "bilateral").</dd>
<dt>coupling</dt>
<dd>Acoustic coupling ("custom_occluded", "open_dome", "tulip_dome", "double_dome", "vent_1mm_solid", etc.).</dd>
<dt>module</dt>
<dd>Fitting module ("standard", "cin").</dd>
<dt>ldl</dt>
<dd>Loudness Discomfort Levels (optional).</dd>
<dt>loss</dt>
<dd>Conductive hearing loss component (optional).</dd>
<dt>distortion_category</dt>
<dd>Distortion category ("Normal", "Low", "Moderate", "High").</dd>
<dt>user_cr</dt>
<dd>User defined compression ratio (optional).</dd>
<dt>optimize</dt>
<dd>Optimization flag.</dd>
<dt>seed_noise</dt>
<dd>Random noise for optimizer seeding.</dd>
<dt>optim_method</dt>
<dd>Optimization method.</dd>
<dt>abg_fraction</dt>
<dd>Air-bone gap fraction to compensate.</dd>
<dt>enable_severe_booster</dt>
<dd>Logical flag to enable severe-loss booster.</dd>
<dt>booster_onset</dt>
<dd>Threshold for the severe-loss booster (default: 70).</dd>
<dt>disable_sdlfp</dt>
<dd>Logical flag to disable the Slope-Dependent Low-Frequency Penalty (SD-LFP).</dd>
<dt>x</dt>
<dd>A <code>prescription_target</code> object.</dd><dt>object</dt>
<dd>A <code>prescription_target</code> object.</dd>
<dt>...</dt>
<dd>Additional graphical or printing parameters.</dd></dl>

Arguments

Author

Open-NL WDRC Gain Prescription — open_nl

<dl>

<dt>speech</dt>
<dd>Input speech spectrum level at each frequency. If a single number is provided, it's assumed to be the overall broadband SPL.</dd>


<dt>threshold</dt>
<dd>Hearing threshold level at each frequency.</dd>


<dt>freq</dt>
<dd>Frequencies at which the thresholds are measured.</dd>


<dt>gender</dt>
<dd>Gender of the patient ("male", "female").</dd>


<dt>experience</dt>
<dd>Hearing aid experience ("new", "experienced").</dd>


<dt>config</dt>
<dd>Fitting configuration ("unilateral", "bilateral").</dd>


<dt>coupling</dt>
<dd>Acoustic coupling ("custom_occluded", "open_dome", "tulip_dome", "double_dome", "vent_1mm_solid", etc.).</dd>


<dt>module</dt>
<dd>Fitting module ("standard", "cin").</dd>


<dt>ldl</dt>
<dd>Loudness Discomfort Levels (optional).</dd>


<dt>loss</dt>
<dd>Conductive hearing loss component (optional).</dd>


<dt>distortion_category</dt>
<dd>Distortion category ("Normal", "Low", "Moderate", "High").</dd>


<dt>user_cr</dt>
<dd>User defined compression ratio (optional).</dd>


<dt>optimize</dt>
<dd>Optimization flag.</dd>


<dt>seed_noise</dt>
<dd>Random noise for optimizer seeding.</dd>


<dt>optim_method</dt>
<dd>Optimization method.</dd>


<dt>abg_fraction</dt>
<dd>Air-bone gap fraction to compensate.</dd>


<dt>enable_severe_booster</dt>
<dd>Logical flag to enable severe-loss booster.</dd>


<dt>booster_onset</dt>
<dd>Threshold for the severe-loss booster (default: 70).</dd>


<dt>disable_sdlfp</dt>
<dd>Logical flag to disable the Slope-Dependent Low-Frequency Penalty (SD-LFP).</dd>


<dt>x</dt>
<dd>A <code>prescription_target</code> object.</dd>

<dt>object</dt>
<dd>A <code>prescription_target</code> object.</dd>


<dt>...</dt>
<dd>Additional graphical or printing parameters.</dd>

</dl>

open_nl: Open-NL WDRC Gain Prescription

Description

Usage

Value

Arguments

Author

Details