tabr (version 0.3.0)

dyad: Construct a dyad

Description

Construct a dyad given one note, an interval, and a direction.

Usage

dyad(notes, interval, reverse = FALSE, key = "c", collapse = FALSE)

Arguments

notes

character, vector of single notes (not a single space-delimited string).

interval

integer or character vector; semitones or interval ID, respectively. See details.

reverse

logical, reverse the transposition direction. Useful when interval is character.

key

character, key signature.

collapse

logical, collapse result into a single string ready for phrase construction.

Value

character

Details

The interval may be specified by semitones of by common interval name or abbreviation. See examples. For a complete list of valid interval names and abbreviations see mainIntervals. key enforces the use of sharps or flats. This function is based on transpose. notes and interval may be vectors, but must be equal length. Recycling occurs only if one argument is scalar.

See Also

mainIntervals

Examples

# NOT RUN {
dyad("a", 4)
x <- c("minor third", "m3", "augmented second", "A2")
sapply(x, function(x) dyad("a", x))
sapply(x, function(x) dyad("c'", x, reverse = TRUE))

x <- c("M3", "m3", "m3", "M3", "M3", "m3", "m3")
dyad(letters[c(3:7, 1, 2)], x)

x <- c("P1", "m3", "M3", "P4", "P5", "P8", "M9")
dyad("c", x)
dyad("c", x, reverse = TRUE)
# }