parn94_params: Model parameters

View source: R/model-parn94.R

parn94_paramsR Documentation

Model parameters

Description

This function compiles parameters for Parncutt's psychoacoustic model. The parameters are defined with reference to \insertCiteParncutt1994;textualincon.

Usage

parn94_params(
  unit_amplitude_in_dB = 60,
  template_num_harmonics = 11,
  template_roll_off = 1,
  k_t = 3,
  k_p = 0.5,
  k_c = 0.2,
  k_s = 0.5,
  k_m = 12,
  al_0 = 15,
  min_midi = 0,
  max_midi = 120
)

Arguments

unit_amplitude_in_dB

(Numeric scalar) Describes the number of decibels to assign to a spectral component of amplitude 1. By default, amplitude 1 corresponds to the amplitude of each chord pitch's fundamental frequency (though this can be changed by expressing input chords as pitch-class sparse spectra, see sparse_pi_spectrum()).

template_num_harmonics

(Integerish scalar) Number of harmonics to include in the spectral template, including the fundamental frequency.

template_roll_off

(Numeric scalar) Roll-off rate for the harmonic template. This parameter is passed to sparse_pi_spectrum().

k_t

(Numeric scalar) Relative perceptual weighting of complex versus pure tones.

k_p

(Numeric scalar) Scaling coefficient for pure sonorousness.

k_c

(Numeric scalar) Scaling coefficient for complex sonorousness.

k_s

(Numeric scalar) Scaling coefficient for multiplicity.

k_m

(Numeric scalar) Gradient of a pure tone's masking pattern.

al_0

(Numeric scalar) Audibility saturation rate.

min_midi

(Numeric scalar) Lowest MIDI pitch considered by the model.

max_midi

(Numeric scalar) Highest MIDI pitch considered by the model.

Value

A list of parameters which can be passed to analysis functions such as parn94.

References

\insertAllCited

pmcharrison/incon documentation built on Feb. 12, 2024, 3:18 a.m.