music21.tablature

Music21 representation of FretNote and FretBoard objects.

TODO: Chord from Figure Chord from FretBoard Object with tuning.

BassGuitarFretBoard

class music21.tablature.BassGuitarFretBoard(fretNotes=None, displayFrets=4)

A four-string fretboard tuned to E A D G

BassGuitarFretBoard bases

• FretBoard

• ProtoM21Object

BassGuitarFretBoard read-only properties

Read-only properties inherited from ProtoM21Object:

classSet

classes

BassGuitarFretBoard methods

Methods inherited from FretBoard:

fretNotesLowestFirst()

getFretNoteByString()

getPitches()

Methods inherited from ProtoM21Object:

isClassOrSubclass()

ChordWithFretBoard

class music21.tablature.ChordWithFretBoard(figure=None, numStrings=6, fretNotes=None, displayFrets=4, **keywords)

Music21Object subclass that combines a ChordSymbol with a FretBoard. Tuning must be set!

>>> fn4 = tablature.FretNote(string=4, fret=0)
>>> fn3 = tablature.FretNote(string=3, fret=2, fingering=2)
>>> fn2 = tablature.FretNote(string=2, fret=3, fingering=3)
>>> fn1 = tablature.FretNote(string=1, fret=2, fingering=4)
>>> cwf = tablature.ChordWithFretBoard('Dm', fretNotes=[fn1, fn2, fn3, fn4])

ChordWithFretBoard bases

• ChordSymbol

• Harmony

• Chord

• ChordBase

• NotRest

• GeneralNote

• Music21Object

• FretBoard

• ProtoM21Object

ChordWithFretBoard read-only properties

Read-only properties inherited from Chord:

chordTablesAddress commonName fifth forteClass forteClassNumber forteClassTn forteClassTnI fullName hasZRelation

intervalVector intervalVectorString isPrimeFormInversion multisetCardinality normalOrder normalOrderString orderedPitchClasses orderedPitchClassesString pitchClassCardinality

pitchClasses pitchedCommonName primeForm primeFormString quality scaleDegrees seventh third

Read-only properties inherited from Music21Object:

beat beatDuration beatStr

beatStrength hasEditorialInformation

hasStyleInformation measureNumber

Read-only properties inherited from ProtoM21Object:

classSet

classes

ChordWithFretBoard read/write properties

Read/write properties inherited from Harmony:

figure key

romanNumeral

writeAsChord

Read/write properties inherited from Chord:

duration notes

pitchNames

pitches

Read/write properties inherited from ChordBase:

tie

volume

Read/write properties inherited from NotRest:

notehead noteheadFill

noteheadParenthesis stemDirection

storedInstrument

Read/write properties inherited from GeneralNote:

lyric

Read/write properties inherited from Music21Object:

activeSite derivation editorial

id offset priority

quarterLength seconds style

ChordWithFretBoard methods

ChordWithFretBoard.getFretNotesFromFigure()

TODO: Given a chord with fret Figure, getFretNotesFromFigure returns each FretNote object within it.

Methods inherited from ChordSymbol:

findFigure()

inversionIsValid()

transpose()

Methods inherited from Harmony:

addChordStepModification()

getChordStepModifications()

Methods inherited from Chord:

__eq__() __getitem__() add() annotateIntervals() areZRelations() bass() canBeDominantV() canBeTonic() closedPosition() containsSeventh() containsTriad() formatVectorString() geometricNormalForm() getChordStep() getColor() getNotehead() getNoteheadFill() getStemDirection() getTie() getVolume() getZRelation() hasAnyEnharmonicSpelledPitches()

hasAnyRepeatedDiatonicNote() hasRepeatedChordStep() intervalFromChordStep() inversion() inversionName() inversionText() isAugmentedSixth() isAugmentedTriad() isConsonant() isDiminishedSeventh() isDiminishedTriad() isDominantSeventh() isFalseDiminishedSeventh() isFrenchAugmentedSixth() isGermanAugmentedSixth() isHalfDiminishedSeventh() isIncompleteMajorTriad() isIncompleteMinorTriad() isItalianAugmentedSixth() isMajorTriad() isMinorTriad() isNinth()

isSeventh() isSeventhOfType() isSwissAugmentedSixth() isTranspositionallySymmetrical() isTriad() removeRedundantPitchClasses() removeRedundantPitchNames() removeRedundantPitches() root() semiClosedPosition() semitonesFromChordStep() setColor() setNotehead() setNoteheadFill() setStemDirection() setTie() setVolume() simplifyEnharmonics() sortAscending() sortChromaticAscending() sortDiatonicAscending() sortFrequencyAscending()

Methods inherited from ChordBase:

hasComponentVolumes()

remove()

setVolumes()

Methods inherited from NotRest:

getInstrument()

hasVolumeInformation()

Methods inherited from GeneralNote:

addLyric() augmentOrDiminish()

getGrace()

insertLyric()

Methods inherited from Music21Object:

clearCache() containerHierarchy() contextSites() getAllContextsByClass() getContextByClass() getOffsetBySite() getOffsetInHierarchy()

getSpannerSites() informSites() mergeAttributes() next() previous() purgeLocations() purgeOrphans()

setOffsetBySite() show() sortTuple() splitAtDurations() splitAtQuarterLength() splitByQuarterLengths() write()

Methods inherited from FretBoard:

fretNotesLowestFirst()

getFretNoteByString()

getPitches()

Methods inherited from ProtoM21Object:

isClassOrSubclass()

ChordWithFretBoard instance variables

Instance variables inherited from Chord:

beams isChord

isNote

isRest

Instance variables inherited from ChordBase:

beams

isNote

isRest

Instance variables inherited from NotRest:

beams

Instance variables inherited from GeneralNote:

articulations expressions

isChord

lyrics

Instance variables inherited from Music21Object:

classSortOrder groups

isStream

sites

FirstFret

class music21.tablature.FirstFret(fretNum, location='right')

FirstFretInfo returns the information regarding the first fret utilized in a given chord position.

FretBoard

class music21.tablature.FretBoard(numStrings=6, fretNotes=None, displayFrets=4)

A FretBoard represents a displayed fretboard (i.e. used in chord symbols). To be displayed, a fretboard requires a tuning system, defined by the fretted instrument classes defined.

>>> fn1 = tablature.FretNote(string=3, fret=2, fingering=1)
>>> fn2 = tablature.FretNote(string=2, fret=3, fingering=3)
>>> fn3 = tablature.FretNote(string=1, fret=2, fingering=2)
>>> fb = tablature.FretBoard(6, fretNotes=[fn1, fn2, fn3], displayFrets=5)
>>> fb.numStrings
6
>>> fb
<music21.tablature.FretBoard 6 strings, 3 notes, 5 frets>
>>> len(fb.fretNotes)
3
>>> fb.fretNotes[0]
<music21.tablature.FretNote 3rd string, 2nd fret, 1st finger>

>>> fb.getFretNoteByString(2)
<music21.tablature.FretNote 2nd string, 3rd fret, 3rd finger>

FretBoard bases

• ProtoM21Object

FretBoard read-only properties

Read-only properties inherited from ProtoM21Object:

classSet

classes

FretBoard methods

FretBoard.fretNotesLowestFirst()

Returns a list of FretNotes in lowest to highest string order.

>>> firstNote = tablature.FretNote(string=2, fret=3, fingering=4)
>>> secondNote = tablature.FretNote(string=3, fret=3, fingering=3)
>>> thirdNote = tablature.FretNote(string=1, fret=3, fingering=3)
>>> myFretBoard = tablature.FretBoard(6, fretNotes=[firstNote, secondNote, thirdNote])
>>> for thisFretNote in myFretBoard.fretNotesLowestFirst():
...    print(thisFretNote)
<music21.tablature.FretNote 3rd string, 3rd fret, 3rd finger>
<music21.tablature.FretNote 2nd string, 3rd fret, 4th finger>
<music21.tablature.FretNote 1st string, 3rd fret, 3rd finger>

FretBoard.getFretNoteByString(requestedString)

Returns FretNote object on a given string or None if there are none.

>>> firstNote = tablature.FretNote(string=6, fret=3, fingering=4)
>>> secondNote = tablature.FretNote(string=2, fret=3, fingering=3)
>>> myFretBoard = tablature.FretBoard(6, fretNotes=[firstNote, secondNote])
>>> myFretBoard.getFretNoteByString(6)
<music21.tablature.FretNote 6th string, 3rd fret, 4th finger>

>>> myFretBoard.getFretNoteByString(2)
<music21.tablature.FretNote 2nd string, 3rd fret, 3rd finger>

>>> myFretBoard.getFretNoteByString(9) is None
True

FretBoard.getPitches() → list[None | music21.pitch.Pitch]

Returns a list of all the pitches (or None for each) given the FretNote information. This requires a tuning to be set.

>>> firstNote = tablature.FretNote(string=4, fret=3, fingering=3)
>>> secondNote = tablature.FretNote(string=2, fret=1, fingering=1)
>>> gfb = tablature.GuitarFretBoard(fretNotes=[firstNote, secondNote])
>>> gfb.getPitches()
[None, None, <music21.pitch.Pitch F3>, None, <music21.pitch.Pitch C4>, None]

What if the User provides an empty FretBoard? >>> gfb2 = tablature.GuitarFretBoard(fretNotes=[]) >>> gfb2.getPitches() [None, None, None, None, None, None]

Works for other stringed instruments, as long as the tuning is included (see below).

>>> tablature.UkeleleFretBoard().numStrings
4
>>> uke = tablature.UkeleleFretBoard(fretNotes=[firstNote, secondNote])
>>> uke.getPitches()
[<music21.pitch.Pitch B-4>, None, <music21.pitch.Pitch F4>, None]

Methods inherited from ProtoM21Object:

isClassOrSubclass()

FretNote

class music21.tablature.FretNote(string=None, fret=None, fingering=None)

A FretNote represents a note on a Fretboard, where each string should be fingered (or not).

>>> fn = tablature.FretNote(3, 4, 1)
>>> fn
<music21.tablature.FretNote 3rd string, 4th fret, 1st finger>

>>> fn.string
3
>>> fn.fret
4
>>> fn.fingering
1
>>> fn.displayFingerNumber
True

>>> fnStupid = tablature.FretNote()
>>> fnStupid.string is None
True

FretNote bases

• ProtoM21Object

FretNote read-only properties

Read-only properties inherited from ProtoM21Object:

classSet

classes

FretNote methods

Methods inherited from ProtoM21Object:

isClassOrSubclass()

GuitarFretBoard

class music21.tablature.GuitarFretBoard(fretNotes=None, displayFrets=4)

A six-string fretboard tuned to E A D G B E.

GuitarFretBoard bases

• FretBoard

• ProtoM21Object

GuitarFretBoard read-only properties

Read-only properties inherited from ProtoM21Object:

classSet

classes

GuitarFretBoard methods

Methods inherited from FretBoard:

fretNotesLowestFirst()

getFretNoteByString()

getPitches()

Methods inherited from ProtoM21Object:

isClassOrSubclass()

MandolinFretBoard

class music21.tablature.MandolinFretBoard(fretNotes=None, displayFrets=4)

A four-string fretboard tuned to G D A E

MandolinFretBoard bases

• FretBoard

• ProtoM21Object

MandolinFretBoard read-only properties

Read-only properties inherited from ProtoM21Object:

classSet

classes

MandolinFretBoard methods

Methods inherited from FretBoard:

fretNotesLowestFirst()

getFretNoteByString()

getPitches()

Methods inherited from ProtoM21Object:

isClassOrSubclass()

UkeleleFretBoard

class music21.tablature.UkeleleFretBoard(fretNotes=None, displayFrets=4)

A four-string fretboard tuned to G C E A

UkeleleFretBoard bases

• FretBoard

• ProtoM21Object

UkeleleFretBoard read-only properties

Read-only properties inherited from ProtoM21Object:

classSet

classes

UkeleleFretBoard methods

Methods inherited from FretBoard:

fretNotesLowestFirst()

getFretNoteByString()

getPitches()

Methods inherited from ProtoM21Object:

isClassOrSubclass()