parn94: Parncutt & Strasburger (1994)

Description Usage Arguments Value References

View source: R/parn94.R

Description

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

Usage

1
2
3
4
5
6
7
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/parn94 documentation built on April 10, 2021, 1:33 p.m.