3j|1dZddlmZddlZddlmZddlmZddlmZddlmZddlm Z Gd d ejZ Gd d e jZ Gd de jZGddZGddej eZGddeZGddeZGddeZGddeZGddej,Zedk(rddlZej2eyy)z} Music21 representation of FretNote and FretBoard objects. TODO: Chord from Figure Chord from FretBoard Object with tuning. ) annotationsN)common) exceptions21)harmony)pitch)prebasec eZdZy)TablatureExceptionN)__name__ __module__ __qualname__>/DATA/.local/lib/python3.12/site-packages/music21/tablature.pyr r srr c0eZdZdZ d ddZdZy)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 Nc<||_||_||_d|_y)NT)stringfret fingeringdisplayFingerNumber)selfrrrs r__init__zFretNote.__init__6s! !' " #,)- rcLd}|j||jd}nd}|j||jd}nd}|j||jd}nd}g}|||fD]}|dk7s |j|dj |}|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 c4|tj|SN)rordinalAbbreviation)xs rabbrz$FretNote._reprInternal..abbrTsS33A678 8rz stringz fretz fingerz, )rrrappendjoin)rr stringReprfretRepr fingeringRepr nonEmptyReprthisReprfullReprs r _reprInternalzFretNote._reprInternal@s( 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) NcD||_|xsg|_||_g|_yr) numStrings fretNotes displayFretstuning)rr/r0r1s rrzFretBoard.__init__s% *)2b()+ rcf|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)r/lenr0r1rs rr)zFretBoard._reprInternals4//"*S-@,A$J[J[I\\bccrcg}t|jddD]'}|j|}||j|)|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)ranger/getFretNoteByStringr!)r allFretNotes stringNumber thisFretNotes rfretNotesLowestFirstzFretBoard.fretNotesLowestFirstsO !$//1b9L33LAL#    - :rcL|jD]}||jk(s|cSy)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)r0r)rrequestedStringr<s rr9zFretBoard.getFretNoteByStrings+ !NNL,"5"55##+rct|j|jk7r/tdt|jd|jddg|jz}|js|S|jD]]}|j xsddz}|j|}|j }||jxsdz}tj|}|||<_|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 instrumentNrr7) r4r2r/r r0rpsrrPitch)r pitchListr<pitchListPosition tuningPitchtuningPitchAsPs actualPitch displayPitchs r getPitcheszFretBoard.getPitchess0 t{{ t .$6t{{#$M??##57  .2FT__,D ~~  NNL!-!4!4!9R ? ++&78K%0^^O!0L4E4E4J!KK ;;{3L+7I' (+r)N)r/intr0zlist[FretNote] | Noner1rL)returnzlist[None | pitch.Pitch]) r r r r+rr)r=r9rIrrrr-r-osF.!")- , ,& , , d4,.rr-ceZdZdZddZy) FirstFretzp FirstFretInfo returns the information regarding the first fret utilized in a given chord position. c ||_||_yr)fretNumlocation)rrQrRs rrzFirstFret.__init__s   rN)right)r r r r+rrrrrOrOs  !rrOceZdZdZddZdZy)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]) Nc ztjj|fd|i|tj||||y)Nfigure)r/r0r1)r ChordSymbolrr-)rrWr/r0r1keywordss rrzChordWithFretBoard.__init__s@$$TE&EHE 4&0%.(4  6rcy)z TODO: Given a chord with fret Figure, getFretNotesFromFigure returns each FretNote object within it. Nrr5s rgetFretNotesFromFigurez)ChordWithFretBoard.getFretNotesFromFiguresr)NrJNrK)r r r r+rr[rrrrUrUs  6rrUc$eZdZdZdfd ZxZS)GuitarFretBoardz6 A six-string fretboard tuned to E A D G B E. c*d}t||||tjdtjdtjdtjdtjdtjdg|_y)NrJE2A2D3G3B3E4superrrrBr2rr0r1r/ __class__s rrzGuitarFretBoard.__init__4sg  Y ={{4(%++d*;U[[=N{{4(%++d*;U[[=NP rNrKr r r r+r __classcell__rhs@rr]r]/sPPrr]c$eZdZdZdfd ZxZS)UkeleleFretBoardz2 A four-string fretboard tuned to G C E A cd}t||||tjdtjdtjdtjdg|_y)NrKG4C4rdA4rergs rrzUkeleleFretBoard.__init__AQ  Y ={{4(%++d*;U[[=NPUP[P[\`Pab rrirjrls@rrnrn<ccrrnc$eZdZdZdfd ZxZS)BassGuitarFretBoardz2 A four-string fretboard tuned to E A D G cd}t||||tjdtjdtjdtjdg|_y)NrKE1A1D2G2rergs rrzBassGuitarFretBoard.__init__Mrsrrirjrls@rrvrvHrtrrvc$eZdZdZdfd ZxZS)MandolinFretBoardz2 A four-string fretboard tuned to G D A E cd}t||||tjdtjdtjdtjdg|_y)NrKrbD4rrE5rergs rrzMandolinFretBoard.__init__Yrsrrirjrls@rr}r}Trtrr}c$eZdZdZdZdZdZy)Testcvtddd}|j|jg}|j|ddgy)NrK)rrr assertEqual)rfstringAndFretInfos rtestFretNoteStringzTest.testFretNoteStringcs8 Q1 XXqvv. *QF3rcL|jtjdyr)rrrr5s rtestStupidFretNotezTest.testStupidFretNotejs **D1rcnddlm}|jdd}d}|jt ||y)Nr) tablaturerJz3)music21rrrrepr)rr weirdFretNote expectedReprs rtestFretNoteWeirdReprzTest.testFretNoteWeirdReprms1%!**1c2 L  m,l;rctddd}tddd}td||g}g}|jD]}|j|j|j |ddgy)NrrrJ)r0)rr-r=r!rr)r fretNote1 fretNote2 myFretBoard stringListthisNotes rtestFretBoardLowestFirstzTest.testFretBoardLowestFirstusoQ1% Q1% i-CD  #88:H   hoo .; aV,rN)r r r rrrrrrrrras42< -rr__main__)r+ __future__runittestrrrrrrMusic21Exceptionr ProtoM21Objectrr-rOrXrUr]rnrvr}TestCaserr mainTestrrrrs#  66 Lw%%L^K&&K\!!,,iN Pi P cy c c) c c c-8  -D zGTr