zmate: Twin set in the Z-relation (Z mate)

In musicMCT: Analyze the Structure of Musical Scales

Twin set in the Z-relation (Z mate)

Description

For the standard 12edo sets of Fortean pitch-class set theory, given one pitch-class set, finds a set class whose interval-class vector is the same as the input set but which does not include the input set. Not all set classes participate in the Z-relation, in which case the function returns NA.

Usage

zmate(set)

Arguments

set	Numeric vector of pitch-classes in the set

Details

These values are hard-coded from Forte's list for non-hexachords and only work for subsets of the standard chromatic scale. zmate() doesn't even give you an option to work in a different edo. If it were to do so, I can't see a better solution than calculating all the set classes of a given cardinality on the spot, which can be slow for higher edos.

Value

NA or numeric vector of same length as set

Examples

zmate(c(0, 4, 7))
zmate(c(0, 1, 4, 6))

musicMCT documentation built on June 21, 2026, 9:06 a.m.