Skip to content

v0.59.0: Several chord grips, ranked

Latest

Choose a tag to compare

@kennethreitz kennethreitz released this 10 Nov 01:28

Several voicings

Fretboard.chord(name, multiple=True) and NamedChord.fingering(..., multiple=True) return distinct playable grips for a chord in any tuning or with a capo: the open shape and the movable shapes up the neck. limit caps the list (default 8).

The default single fingering in standard tuning is unchanged, including the curated open and barre shapes. In every other tuning, that one shape is the first result of the same ranking.

A grip is kept only when a hand can play it: at most a four-fret stretch, at most four fretting fingers (a barre counts as one), every chord tone present (a perfect fifth may be omitted from a seventh or extension), and muted strings only at the edges. The same barre at two frets is kept once.

Ranking

Lower cost comes first. The weights are in pytheory.voicings:

  • stretch, with a little extra on the wide frets near the nut
  • fret height
  • finger count, plus a barre
  • open strings, which lower the cost
  • root in the bass
  • edge mutes, squared, and harsher on the treble side than the bass side
  • each omitted chord tone

The search follows the fretboard enumerator dxjqgc published while working on #64, in rhythm-template-library (chord_fingering).

Full Changelog: v0.58.1...v0.59.0