chord-filter {tabr}

Extract notes from chords

Description

Filter or slice chords to extract individual notes.

Usage

chord_root(notes)

chord_top(notes)

chord_slice(notes, index)

Arguments

notes

character, a noteworthy string.

index

integer, the order of a note in a chord by pitch (not scale degrees).

Details

These functions extract notes from chords such as the root note, the highest pitch, specific position among the notes by pitch, or trim chords to simplify them. They operate based only on ordered pitches.

For chord_slice(), any entry that is empty after slicing is dropped. An error is thrown is index is completely out of bounds for all chords.

Value

a noteworthy string

Examples

x <- "a_2 c#eg# e_gc egc,cc'"
chord_root(x)
chord_top(x)
identical(chord_slice(x, 1), chord_root(x))
chord_slice(x, 2)
chord_slice(x, 4)
chord_slice(x, 3:5)