tabr (version 0.3.5)

pitch_freq: Pitch-frequency conversion

Description

Convert between pitch and frequency.

Usage

pitch_freq(notes, a4 = 440)
pitch_semitones(notes)
chord_freq(notes, a4 = 440)
chord_semitones(notes)
freq_pitch(freq, a4 = 440, collapse = FALSE, ...)
freq_semitones(freq, a4 = 440)

Arguments

notes

character, noteworthy string, space-delimited or vector of individual entries. See details.

a4

the fixed frequency of the A above middle C, typically 440 Hz.

freq

numeric vector, frequencies in Hz.

collapse

logical, collapse result into a single string.

...

other arguments passed to tranpose, specifically key and style.

Value

numeric vector

Details

Frequencies are in Hertz. Values are based on the 12-tone equal-tempered scale. When converting an arbitrary frequency to pitch, it is rounded to the nearest pitch. pitch_freq and pitch_semitones strictly accept single notes in noteworthy strings and return numeric vectors. chord_freq and chord_semitones accept any noteworthy string and always return a list. These are provided so that all functions are type-safe. See examples.

Examples

# NOT RUN {
x <- "a e4 a4 e5 a5"
y <- pitch_freq(x)
y

freq_pitch(y)

identical(as_noteworthy(x), freq_pitch(y, collapse = TRUE))
# }