parn88: Parncutt (1988)

View source: R/model-parn88.R

parn88R Documentation

Parncutt (1988)

Description

Analyses a pitch-class set using the root-finding model of \insertCiteParncutt1988;textualincon.

Usage

parn88(x, root_support = "v2", exponent = 0.5)

## Default S3 method:
parn88(x, root_support = "v2", exponent = 0.5)

## S3 method for class 'pc_set'
parn88(x, root_support = "v2", exponent = 0.5)

Arguments

x

Sonority to analyse. This will be coerced to an object of class pc_set.

root_support

(Character scalar or data frame) Identifies the root support weights to use.

  • "v2" (default) uses the updated weights from \insertCiteParncutt2006;textualincon.

  • "v1" uses the original weights from \insertCiteParncutt2006;textualincon.

See root_support_weights for the values of these weights. Alternatively, root-support weights can be provided as a data frame, with one column (interval) identifying the ascending interval in semitones, and another column (weight) identifying the corresponding root support weight.

exponent

(Numeric scalar) Exponent to be used when computing root ambiguities. Defaults to 0.5, after \insertCiteParncutt1988;textualincon.

Value

A list with three values:

  • root, the estimated chord root (integer scalar);

  • root_ambiguity, the root ambiguity (numeric scalar),

  • pc_weight, a 12-dimensional vector of weights by pitch class.

References

\insertAllCited

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