milne_pc_spectrum: Milne pitch-class spectrum

View source: R/milne-pc-spectrum.R

milne_pc_spectrumR Documentation

Milne pitch-class spectrum

Description

This function represents an input object as a 'Milne pitch-class spectrum'. A Milne pitch-class spectrum defines 'perceptual weight' as a continuous function of 'pitch class'.

Usage

milne_pc_spectrum(x, ...)

## S3 method for class 'pc_set'
milne_pc_spectrum(
  x,
  weights = 1,
  num_harmonics = 12,
  rho = 0.75,
  sigma = 6.83,
  array_dim = 1200,
  ...
)

## Default S3 method:
milne_pc_spectrum(x, ...)

## S3 method for class 'milne_pc_spectrum'
milne_pc_spectrum(x, ...)

Arguments

x

Input sonority.

...

Provided for S3 method consistency.

weights

(Numeric vector) Vector of weights to assign to each pitch class. If a scalar value is provided, this value is assigned to all pitch classes.

num_harmonics

(Integerish scalar) Number of harmonics to use when expanding tones into their implied harmonics, and when defining the harmonic template (including the fundamental frequency). Defaults to 12, after \insertCiteMilne2016;textualhrep.

rho

(Numeric scalar) Roll-off parameter for harmonic expansion. Defaults to 0.75, after \insertCiteMilne2016;textualhrep.

sigma

(Numeric scalar) Standard deviation of the Gaussian smoothing distribution (cents). Defaults to 6.83, after \insertCiteMilne2016;textualhrep.

array_dim

(Integerish scalar) Dimensionality of the pitch-class spectrum array. Defaults to 1200, after \insertCiteMilne2016;textualhrep.

Details

This spectrum is typically constructed from musical chords by expanding each note into its implied harmonics and applying a Gaussian smoothing to account for perceptual uncertainties. See \insertCiteMilne2016;textualhrep for details.

Value

An object of class milne_pc_spectrum.

References

\insertAllCited \insertAllCited

See Also

.milne_pc_spectrum.


pmcharrison/hrep documentation built on Feb. 18, 2024, 2:33 a.m.