chord_arpeggiate: Arpeggiate a chord

In tabr: Music Notation Syntax, Manipulation, Analysis and Transcription in R

Arpeggiate a chord

Description

Create an arpeggio from a chord.

Usage

chord_arpeggiate(
  chord,
  n = 0,
  by = c("note", "chord"),
  broken = FALSE,
  collapse = FALSE
)

Arguments

chord	character, a single chord.
n	integer, number of steps, negative indicates reverse direction (decreasing pitch).
by	whether each of the n steps refers to individual notes in the chord (an inversion) or raising the entire chord in its given position by one octave.
broken	logical, return result as an arpeggio of broken chords.
collapse	logical, collapse result into a single string ready for phrase construction.

Details

This function is based on chord_invert. If n = 0 then chord is returned immediately; other arguments are ignored.

Value

character

Examples

chord_arpeggiate("ce_gb_", 2)
chord_arpeggiate("ce_gb_", -2)
chord_arpeggiate("ce_gb_", 2, by = "chord")
chord_arpeggiate("ce_gb_", 1, broken = TRUE, collapse = TRUE)

tabr documentation built on Aug. 8, 2025, 7:30 p.m.