rh1SrSSKJr SSKrSSKJr SSKJr SSKJr SSKJr SSKJ r "S S \R5r "S S \ R5r "S S\ R5r"SS5r"SS\R \5r"SS\5r"SS\5r"SS\5r"SS\5r"SS\R,5r\S:XaSSKr\R2"\5 gg)z} Music21 representation of FretNote and FretBoard objects. TODO: Chord from Figure Chord from FretBoard Object with tuning. ) annotationsN)common) exceptions21)harmony)pitch)prebasec\rSrSrSrg)TablatureExceptionN)__name__ __module__ __qualname____firstlineno____static_attributes__r K/home/james-whalen/.local/lib/python3.13/site-packages/music21/tablature.pyr r srr c<\rSrSrSrSSSjjrSrSrg) FretNote!au A FretNote represents a note on a Fretboard, where each string should be fingered (or not). >>> fn = tablature.FretNote(3, 4, 1) >>> fn >>> fn.string 3 >>> fn.fret 4 >>> fn.fingering 1 >>> fn.displayFingerNumber True >>> fnUnknownFinger = tablature.FretNote(1, 1) >>> fnUnknownFinger.fingering is None True Nc6XlX lX0lSUlg)NT)stringfret fingeringdisplayFingerNumber)selfrrrs r__init__FretNote.__init__7s !' " #,)- rcXSnURbU"UR5S3nOSnURbU"UR5S3nOSnURbU"UR5S3nOSn/nX#U4HnUS:wdM URU5 M SR U5nU$)a Defines the representation of a FretNote object under music21 standards. >>> fn = tablature.FretNote(4, 2, 1) >>> fn >>> fn2 = tablature.FretNote(3, 2) >>> fn2 >>> fn3 = tablature.FretNote(fret=2, fingering=3) >>> fn3 >>> emptyNote = tablature.FretNote() >>> emptyNote c6U[R"U53$N)rordinalAbbreviation)xs rabbr$FretNote._reprInternal..abbrUsS33A678 8rz stringz fretz fingerz, )rrrappendjoin)rr$ stringReprfretRepr fingeringRepr nonEmptyReprthisReprfullReprs r _reprInternalFretNote._reprInternalAs( 9 ;; " -.g6JJ 99 tyy/*%0HH >> %#DNN34G>> 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 >>> len(fb.fretNotes) 3 >>> fb.fretNotes[0] >>> fb.getFretNoteByString(2) NcJXlU=(d /UlX0l/Ulgr!) numStrings fretNotes displayFretstuning)rr7r8r9s rrFretBoard.__init__s! *)2b()+ rcfURS[UR5SURS3$)aA >>> fn3 = tablature.FretNote(string=6, fret=1, fingering=1) >>> fn2 = tablature.FretNote(string=4, fret=2, fingering=2) >>> fn1 = tablature.FretNote(string=2, fret=4, fingering=4) >>> fb = tablature.FretBoard(6, fretNotes=[fn3, fn2, fn1], displayFrets=4) >>> fb z strings, z notes, z frets)r7lenr8r9rs rr/FretBoard._reprInternals4//"*S-@,A$J[J[I\\bccrc/n[URSS5H*nURU5nUcMURU5 M, U$)ap 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) r)ranger7getFretNoteByStringr')r allFretNotes stringNumber thisFretNotes rfretNotesLowestFirstFretBoard.fretNotesLowestFirstsO !$//1b9L33LAL#    - :rcPURHnXR:XdMUs $ g)a 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) >>> myFretBoard.getFretNoteByString(2) >>> myFretBoard.getFretNoteByString(9) is None True N)r8r)rrequestedStringrFs rrCFretBoard.getFretNoteByStrings) !NNL"5"55##+rc[UR5UR:wa8[SR [UR5UR55eS/UR-nUR (dU$UR HgnUR =(d SS-nURUnURnXRR=(d S-n[R"U5nXqU'Mi U$)ah 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, , None, , 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() [, None, , None] zITuning must be set first, tuned for {0} notes, on a {1} string instrumentNrrA) r=r:r7r formatr8rpsrrPitch)r pitchListrFpitchListPosition tuningPitchtuningPitchAsPs actualPitch displayPitchs r getPitchesFretBoard.getPitchess0 t{{ t .$[bb $OO  .2FT__,D ~~  NNL!-!4!4!9R ? ++&78K%0^^O!04E4E4J!KK ;;{3L+7' (+r)r9r8r7r:)N)r7intr8zlist[FretNote] | Noner9rZ)returnzlist[None | pitch.Pitch]) r rrrr2rr/rGrCrVrr rrr4r4psF.!")- , ,& , , d4,.rr4c"\rSrSrSrSSjrSrg) FirstFretzd FirstFretInfo returns the information regarding the first fret utilized in a given chord position. cXlX lgr!fretNumlocation)rrarbs rrFirstFret.__init__s   rr`N)right)r rrrr2rrr rrr]r]s  !rr]c(\rSrSrSrSSjrSrSrg)ChordWithFretBoardi a 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]) Nc v[RR"U4SU0UD6 [RUUUUS9 g)Nfigure)r7r8r9)r ChordSymbolrr4)rrhr7r8r9keywordss rrChordWithFretBoard.__init__s@$$TE&EHE 4&0%.(4  6rcg)zf TODO: Given a chord with fret Figure, getFretNotesFromFigure returns each FretNote object within it. Nr r>s rgetFretNotesFromFigure)ChordWithFretBoard.getFretNotesFromFigure"srr )NrXNrY)r rrrr2rrmrr rrrfrf s  6rrfc0^\rSrSrSrSU4SjjrSrU=r$)GuitarFretBoardi2z. A six-string fretboard tuned to E A D G B E. c4>Sn[TU]X1U5 [R"S5[R"S5[R"S5[R"S5[R"S5[R"S5/Ulg)NrXE2A2D3G3B3E4superrrrOr:rr8r9r7 __class__s rrGuitarFretBoard.__init__7se   ={{4(%++d*;U[[=N{{4(%++d*;U[[=NP rr:NrYr rrrr2rr __classcell__r{s@rrprp2sPPrrpc0^\rSrSrSrSU4SjjrSrU=r$)UkeleleFretBoardi?z* A four-string fretboard tuned to G C E A c>Sn[TU]X1U5 [R"S5[R"S5[R"S5[R"S5/Ulg)NrYG4C4rwA4rxrzs rrUkeleleFretBoard.__init__DO   ={{4(%++d*;U[[=NPUP[P[\`Pab rr}r~rrs@rrr?ccrrc0^\rSrSrSrSU4SjjrSrU=r$)BassGuitarFretBoardiKz* A four-string fretboard tuned to E A D G c>Sn[TU]X1U5 [R"S5[R"S5[R"S5[R"S5/Ulg)NrYE1A1D2G2rxrzs rrBassGuitarFretBoard.__init__Prrr}r~rrs@rrrKrrrc0^\rSrSrSrSU4SjjrSrU=r$)MandolinFretBoardiWz* A four-string fretboard tuned to G D A E c>Sn[TU]X1U5 [R"S5[R"S5[R"S5[R"S5/Ulg)NrYruD4rE5rxrzs rrMandolinFretBoard.__init__\rrr}r~rrs@rrrWrrrc,\rSrSrSrSrSrSrSrg)Testidcv[SSS5nURUR/nURUSS/5 g)NrY)rrr assertEqual)rfstringAndFretInfos rtestFretNoteStringTest.testFretNoteStringfs8 Q1 XXqvv. *QF3rcLUR[5RS5 gr!)rrrr>s rtestStupidFretNoteTest.testStupidFretNotems **D1rcnSSKJn URSS5nSnUR[ U5U5 g)Nr) tablaturerXz3)music21rrrrepr)rr weirdFretNote expectedReprs rtestFretNoteWeirdReprTest.testFretNoteWeirdReprps1%!**1c2 L  m,l;rc[SSS5n[SSS5n[SX/S9n/nUR5HnURUR5 M UR USS/5 g)NrrrX)r8)rr4rGr'rr)r fretNote1 fretNote2 myFretBoard stringListthisNotes rtestFretBoardLowestFirstTest.testFretBoardLowestFirstxsmQ1% Q1% i-CD  #88:H   hoo .; aV,rr N) r rrrrrrrrr rrrrds42< -rr__main__)r2 __future__runittestrrrrrrMusic21Exceptionr ProtoM21Objectrr4r]rirfrprrrTestCaserr mainTestr rrrs#  66 Lw%%L^K&&K\!!,,iN Pi P cy c c) c c c-8  -D z Tr