j|1dZddlmZddlZddlmZddlmZddlmZddlmZddlm Z Gd d ej Z Gd d e j Z Gd de j ZGddZGddejeZGddeZGddeZGddeZGddeZGddejZedkrddlZejedSdS)z} Music21 representation of FretNote and FretBoard objects. TODO: Chord from Figure Chord from FretBoard Object with tuning. ) annotationsN)common) exceptions21)harmony)pitch)prebaseceZdZdS)TablatureExceptionN)__name__ __module__ __qualname__/Users/tedpeters/Documents/Projects/Claude Projects/Misc Tools/notename-sheets/.venv/lib/python3.11/site-packages/music21/tablature.pyr r sDrr c(eZdZdZ d d dZdZdS) FretNotea 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 Nstring int | Nonefret fingeringc>||_||_||_d|_dS)NT)rrrdisplayFingerNumber)selfrrrs r__init__zFretNote.__init__6s' !' " #,)-   rc.d}|j||jd}nd}|j||jd}nd}|j||jd}nd}g}|||fD]}|dkr||d|}|S)aA 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 c2|tj|SN)rordinalAbbreviation)xs rabbrz$FretNote._reprInternal..abbrTs83A6688 8rNz stringz fretz fingerz, )rrrappendjoin)rr stringReprfretRepr fingeringRepr nonEmptyReprthisReprfullReprs r _reprInternalzFretNote._reprInternal@s( 9 9 9 ; " D--666JJJ 9 $ty//000HHH > %#tDN33<<>> 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) N numStringsint fretNoteslist[FretNote] | None displayFretscB||_|pg|_||_g|_dSr)r0r2r4tuning)rr0r2r4s rrzFretBoard.__init__s) *)2b()+ rcP|jdt|jd|jdS)ay >>> 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)r0lenr2r4rs rr*zFretBoard._reprInternals2/ccS-@-@cc$J[ccccrcg}t|jddD]/}||}|||0|S)a 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)ranger0getFretNoteByStringr")r allFretNotes stringNumber thisFretNotes rfretNotesLowestFirstzFretBoard.fretNotesLowestFirsts_ !$/1b99 . .L33LAAL#    - - - -rc8|jD]}||jkr|cSdS)ap 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)r2r)rrequestedStringr@s rr=zFretBoard.getFretNoteByStrings; !N $ $L,"555####6trreturnlist[None | pitch.Pitch]c`t|j|jkr-tdt|jd|jddg|jz}|js|S|jD]G}|jpddz}|j|}|j}||jpdz}tj |}|||<H|S)a 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] z$Tuning must be set first, tuned for z notes, on a z string instrumentNrr;) r8r6r0r r2rpsrrPitch)r pitchListr@pitchListPosition tuningPitchtuningPitchAsPs actualPitch displayPitchs r getPitcheszFretBoard.getPitchess0 t{  t . .$7t{##77?777  .2FT_,D ~   N 8 8L!-!4!9R ? +&78K%0^O!0L4E4J!KK ;{33L+7I' ( (r)r.Nr/)r0r1r2r3r4r1)rDrE) r r r r+rr*rAr=rOrrrr-r-os.!")- , , , , , d d d4,......rr-ceZdZdZddZdS) FirstFretzp FirstFretInfo returns the information regarding the first fret utilized in a given chord position. rightc"||_||_dSr)fretNumlocation)rrTrUs rrzFirstFret.__init__s   rN)rR)r r r r+rrrrrQrQs2 !!!!!!rrQc eZdZdZddZdZdS)ChordWithFretBoarda Music21Object subclass that combines a ChordSymbol with a FretBoard. Its 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]) Nr.r/c ttjj|fd|i|t||||dS)Nfigure)r0r2r4)r ChordSymbolrr-)rrYr0r2r4keywordss rrzChordWithFretBoard.__init__sW$TEE&EHEEE 4&0%.(4  6 6 6 6 6rcdS)z TODO: Given a chord with fret Figure, getFretNotesFromFigure returns each FretNote object within it. Nrr9s rgetFretNotesFromFigurez)ChordWithFretBoard.getFretNotesFromFigures tr)Nr.Nr/)r r r r+rr]rrrrWrWsA   6 6 6 6rrWc$eZdZdZdfd ZxZS)GuitarFretBoardz6 A six-string fretboard tuned to E A D G B E. Nr/cDd}t|||tjdtjdtjdtjdtjdtjdg|_dS)Nr.E2A2D3G3B3E4superrrrHr6rr2r4r0 __class__s rrzGuitarFretBoard.__init__4s|  Y ==={4((%+d*;*;U[=N=N{4((%+d*;*;U[=N=NP rNr/r r r r+r __classcell__rjs@rr_r_/sQPPPPPPPPPPrr_c$eZdZdZdfd ZxZS)UkeleleFretBoardz2 A four-string fretboard tuned to G C E A Nr/cd}t|||tjdtjdtjdtjdg|_dS)Nr/G4C4rfA4rgris rrzUkeleleFretBoard.__init__Ac  Y ==={4((%+d*;*;U[=N=NPUP[\`PaPab rrkrlrns@rrprp<Qccccccccccrrpc$eZdZdZdfd ZxZS)BassGuitarFretBoardz2 A four-string fretboard tuned to E A D G Nr/cd}t|||tjdtjdtjdtjdg|_dS)Nr/E1A1D2G2rgris rrzBassGuitarFretBoard.__init__Mrurrkrlrns@rrxrxHrvrrxc$eZdZdZdfd ZxZS)MandolinFretBoardz2 A four-string fretboard tuned to G D A E Nr/cd}t|||tjdtjdtjdtjdg|_dS)Nr/rdD4rtE5rgris rrzMandolinFretBoard.__init__Yrurrkrlrns@rrrTrvrrc&eZdZdZdZdZdZdS)Testcttddd}|j|jg}||ddgdS)Nr/)rrr assertEqual)rfstringAndFretInfos rtestFretNoteStringzTest.testFretNoteStringcsC Q1  Xqv. *QF33333rcT|tjddSr)rrrr9s rtestStupidFretNotezTest.testStupidFretNotejs% *D11111rcddlm}|dd}d}|t ||dS)Nr) tablaturer.z3)music21rrrrepr)rr weirdFretNote expectedReprs rtestFretNoteWeirdReprzTest.testFretNoteWeirdReprmsR%%%%%%!**1c22 L  m,,l;;;;;rctddd}tddd}td||g}g}|D]}||j||ddgdS)Nrrr.)r2)rr-rAr"rr)r fretNote1 fretNote2 myFretBoard stringListthisNotes rtestFretBoardLowestFirstzTest.testFretBoardLowestFirstusQ1%% Q1%% i-CDDD  #88:: / /H   ho . . . . aV,,,,,rN)r r r rrrrrrrrrasP444222<<< - - - - -rr__main__)r+ __future__runittestrrrrrrMusic21Exceptionr ProtoM21Objectrr-rQrZrWr_rprxrTestCaserr mainTestrrrrs#"""""      6   LLLLLw%LLL^KKKKK&KKK\!!!!!!!!,iN P P P P Pi P P P c c c c cy c c c c c c c c) c c c c c c c c c c c-----8 ---D zNNNGTr