har_19_composite: Composite consonance model

View source: R/model-har-2019.R

har_19_compositeR Documentation

Composite consonance model

Description

This function computes the consonance of a chord according to Harrison & Pearce's (in preparation) composite consonance model.

Usage

har_19_composite(x, chord_size = FALSE, num_harmonics = 11L, roll_off = 1)

Arguments

x

Chord to analyse; passed to incon. All chord pitches must be integer-valued.

chord_size

(Boolean) Whether to include the chord size effect (see Details).

num_harmonics

(Integerish scalar) Number of harmonics in each tone; passed to incon.

roll_off

(Numeric scalar) Harmonic roll-off rate; passed to incon.

Details

The model combines several sub-models:

  • hutch_78_roughness, the roughness model of \insertCiteHutchinson1978;textualincon (see incon::roughness_hutch);

  • har_18_harmonicity, the harmonicity model of \insertCiteHarrison2018;textualincon (see incon::pc_harmonicity);

  • har_19_corpus: a corpus-based model of cultural familiarity (Harrison & Pearce, in preparation) (see incon::corpus_dissonance).

This model uses the regression coefficients provided in har_19_composite_coef, with one caveat: by default, the chord size effect is disabled, because it's thought that this effect came from a confound in the perceptual data of \insertCiteBowling2018;textualincon.

Value

Estimated consonance, as a numeric scalar.

References

\insertAllCited

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