parn94: Parncutt & Strasburger (1994)

In pmcharrison/incon: Computational Models of Simultaneous Consonance

Parncutt & Strasburger (1994)

Description

This function analyses a sonority using Richard Parncutt's psychoacoustic model of harmony, as described in \insertCiteParncutt1994;textualincon.

Usage

parn94(x, par = parn94_params(), ...)

## Default S3 method:
parn94(x, par = parn94_params(), ...)

## S3 method for class 'sparse_pi_spectrum'
parn94(x, par = parn94_params(), ...)

Arguments

x	Object to analyse, which will be coerced to an object of class sparse_pi_spectrum. Various input types are possible: Numeric vectors will be treated as vectors of MIDI note numbers, which will be expanded into their implied harmonics. A two-element list can be used to define a harmonic spectrum. The first element should be a vector of MIDI note numbers, the second a vector of amplitudes. The function also accepts classes from the hrep package, such as produced by pi_chord() and sparse_pi_spectrum().
par	Parameter list as created by parn94_params().
...	Parameters to pass to sparse_pi_spectrum. num_harmonics: Number of harmonics to use when expanding chord tones into their implied harmonics. roll_off: Rate of amplitude roll-off for the harmonics.

Value

An list of class parn94, comprising the following components:

pure_spectrum	A tibble describing the sonority's pure spectrum. The pure spectrum is a spectral representation of the input sound after auditory masking, but before pattern matching.
pure_spectrum	A tibble describing the sonority's complex spectrum. The complex spectrum is created from the pure spectrum through harmonic template matching.
combined_spectrum	A tibble describing the sonority's combined spectrum. The combined spectrum corresponds to the combination of the pure and complex spectra.
par	A list comprising the parameters used to perform the analysis, as created by parn94_params().

References

\insertAllCited

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