Repository navigation
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