open_nl: Open-NL WDRC Gain Prescription

View source: R/open_nl.R

open_nlR Documentation

Open-NL WDRC Gain Prescription

Description

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

Usage

open_nl(
  speech = 65,
  threshold,
  freq,
  ...,
  gender = "male",
  experience = "experienced",
  config = "bilateral",
  coupling = "custom_occluded",
  module = "standard",
  ldl = NULL,
  loss = NULL,
  distortion_category = NULL,
  user_cr = NULL,
  optimize = TRUE,
  seed_noise = NULL,
  optim_method = "Nelder-Mead",
  abg_fraction = 0.75,
  enable_severe_booster = FALSE,
  booster_onset = 70,
  disable_sdlfp = FALSE
)

## S3 method for class 'prescription_target'
print(x, ...)

## S3 method for class 'prescription_target'
summary(object, ...)

## S3 method for class 'prescription_target'
plot(x, ...)

Arguments

speech

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

threshold

Hearing threshold level at each frequency.

freq

Frequencies at which the thresholds are measured.

gender

Gender of the patient ("male", "female").

experience

Hearing aid experience ("new", "experienced").

config

Fitting configuration ("unilateral", "bilateral").

coupling

Acoustic coupling ("custom_occluded", "open_dome", "tulip_dome", "double_dome", "vent_1mm_solid", etc.).

module

Fitting module ("standard", "cin").

ldl

Loudness Discomfort Levels (optional).

loss

Conductive hearing loss component (optional).

distortion_category

Distortion category ("Normal", "Low", "Moderate", "High").

user_cr

User defined compression ratio (optional).

optimize

Optimization flag.

seed_noise

Random noise for optimizer seeding.

optim_method

Optimization method.

abg_fraction

Air-bone gap fraction to compensate.

enable_severe_booster

Logical flag to enable severe-loss booster.

booster_onset

Threshold for the severe-loss booster (default: 70).

disable_sdlfp

Logical flag to disable the Slope-Dependent Low-Frequency Penalty (SD-LFP).

x

A prescription_target object.

object

A prescription_target object.

...

Additional graphical or printing parameters.

Details

This experimental function generates non-linear prescriptive targets for research and modeling purposes. It is not intended for clinical use.

Value

An object of class prescription_target.

Author(s)

Mark Shaver


SII documentation built on Sept. 12, 2026, 5:08 p.m.