rh%SrSSKJr SSKrSSKrSSKJr SSKJr SSKJ r SSKJ r SSKJ r SS KJ r SS KJ r SS KJr SS KJr SS KJr \R&(aSSKJr \R*r\R,r\R.r\ R0"S5r0rS\S'/SQrSrS7SjrSrS8Sjr S9Sjr!Sr"S:Sjr#Sr$Sr%SSS.S;Sjjr&Sr'S9SS%jjr+S9S&jr,S'r-S(r.S?S)jr/S@S*jr0S:S+jr1S,r2SAS-jr3SBS.jr4S/r5S8SCS0jjr6SDSES1jjr7"S2S3\ Rp5r9"S4S5\Rt5r;\>> soprano = corpus.parse('bwv66.6').parts[0] >>> #_DOCS_SHOW soprano.show('braille.ascii') >>> print(converter.toData(soprano, 'braille.ascii')) # _DOCS_HIDE %%%.C #J .DJ [W?>> data = converter.toData(soprano, 'braille') >>> print(data) ⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠩⠩⠩⠨⠉⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀ ⠼⠚⠀⠨⠙⠚⠀⠪⠺⠹⠣⠇⠫⠀⠹⠺⠪⠣⠇⠹⠀⠊⠚⠳⠻⠣⠇⠪⠀⠺⠺⠻⠫⠀⠪⠺⠹⠣⠇⠹ ⠀⠀⠐⠪⠺⠹⠪⠀⠳⠻⠗⠣⠇⠀⠟⠻⠻⠈⠉⠀⠻⠛⠩⠋⠻⠣⠇⠣⠅ Any :class:`~music21.base.Music21Object` which cannot be transcribed in :mod:`~music21.braille.basic` returns a braille literary question mark and outputs a warning to the console, rather than raising an exception. This is so that a transcription of a :class:`~music21.stream.Stream` in :class:`~music21.braille.translate` is completed as thoroughly as possible. ) annotationsN) articulations)clef)duration) environment) exceptions21) expressions)interval)note)lookup) stringTools)tempozbasic.pyzdict[str, bool] beamStatus)beginLongBracketSlurendLongBracketSlurbeginLongDoubleSlurendLongDoubleSlur shortSlur beamStart beamContinuec*[RURnSURSU3/URlU$![ aE [ RSUS35 SURS3/URl[Ss$f=f)u/ Takes in a :class:`~music21.bar.Barline` and returns its representation as a braille string in UTF-8 unicode. .. note:: Only dashed, double barlines, and final barlines can be transcribed. >>> from music21.braille.basic import barlineToBraille >>> doubleBarline = bar.Barline('double') >>> print(barlineToBraille(doubleBarline)) ⠣⠅⠄ >>> finalBarline = bar.Barline('final') >>> print(barlineToBraille(finalBarline)) ⠣⠅ Heavy gives an "unusual barline" symbol >>> heavyBarline = bar.Barline('heavy') >>> print(barlineToBraille(heavyBarline)) ⠇ zBarline  " cannot be transcribed to braille. Nonebasic_exception) r barlinestype editorialbrailleEnglishKeyError environRuleswarnsymbols)music21BarlinebrailleBarlines O/home/james-whalen/.local/lib/python3.13/site-packages/music21/braille/basic.pybarlineToBrailler'Ts**)<)<=~**+1^,< =3?  / *H^$44VWX5=n>Q>Q=RRW3X2Y  /())*sAAA BBTc /URl[UR5nSnU(aUR 5 OSn/nUSn[ R "UURS9n[UUS9nU[S:XaJ[RSUS35 URRRUS 35 [S$URU5 S RURRS /55n URRRUS U 35 [S [!U55GHn X:n [#U UURR5 [(R*"Xk5R,n U S:aU S - S-S -n U S :XaR[/U 5n URU 5 URRRSU R0SU 35 OX:S - n[(R*"UU 5R,nUS:aQ[/U 5n URU 5 URRRSU R0SU 35 OWU S :XaQ[/U 5n URU 5 URRRSU R0SU 35 U S :XaSn UR[2R4U 5 URRRSU S[2R4U 35 GM SRU5$![$a. [RSU R&S3SUS3-5 GNf=f)um Takes in a :class:`~music21.chord.Chord` and returns its representation as a braille string in UTF-8 unicode. In braille, only one pitch of a chord is brailled, with the rest represented as numeric intervals from that one pitch. If descending is True, the highest (sounding) pitch is brailled, and intervals are labeled in descending order; if descending is False, the lowest (sounding) pitch is brailled, and the intervals are labeled in ascending order. Convention dictates that chords found in the treble clef are brailled descending, and those found in the bass clef are brailled ascending. If showOctave is True, the octave of the brailled pitch is shown. Other octave marks are shown in context relative to the brailled pitch. >>> from music21.braille.basic import chordToBraille >>> gMajorTriadA = chord.Chord(['G4', 'B4', 'D5', 'G5'], quarterLength=4.0) >>> print(chordToBraille(gMajorTriadA, descending=True)) ⠨⠷⠼⠴⠤ >>> gMajorTriadB = chord.Chord(['G2', 'B2', 'D3', 'G3'], quarterLength=4.0) >>> print(chordToBraille(gMajorTriadB, descending=False)) ⠘⠷⠬⠔⠤ >>> gMajorTriadRightHand = chord.Chord(['D4', 'B4', 'G5'], quarterLength=4.0) >>> print(chordToBraille(gMajorTriadRightHand, descending=True)) ⠨⠷⠴⠼ >>> gMajorTriadLeftHand = chord.Chord(['G2', 'D3', 'B3'], quarterLength=4.0) >>> print(chordToBraille(gMajorTriadLeftHand, descending=False)) ⠘⠷⠔⠬ >>> cMajorTriadRightHand = chord.Chord(['C4', 'E5'], quarterLength=4.0) >>> print(chordToBraille(cMajorTriadRightHand, descending=True)) ⠨⠯⠐⠬ >>> cMajorTriadLeftHand = chord.Chord(['C2', 'E3'], quarterLength=4.0) >>> print(chordToBraille(cMajorTriadLeftHand, descending=False)) ⠘⠽⠸⠬ >>> cMajorSeventhRightHand = chord.Chord(['C6', 'E5', 'B4'], quarterLength=4.0) >>> print(chordToBraille(cMajorSeventhRightHand, descending=True)) ⠰⠽⠴⠌ >>> cMajorSeventhLeftHand = chord.Chord(['G2', 'E3', 'E4'], quarterLength=4.0) >>> print(chordToBraille(cMajorSeventhLeftHand, descending=False)) ⠘⠷⠴⠐⠴ >>> chordWithoutAccidentals = chord.Chord(['C4', 'E4', 'F4'], quarterLength=4.0) >>> print(chordToBraille(chordWithoutAccidentals, descending=True)) ⠐⠿⠌⠼ >>> chordWithAccidentals = chord.Chord(['C4', 'E-4', 'F#4'], quarterLength=4.0) >>> chordWithAccidentals.pitches[0].accidental = 'natural' >>> print(chordToBraille(chordWithAccidentals, descending=True)) ⠩⠐⠿⠣⠌⠡⠼ Descending Ascendingr quarterLength) music21Note showOctaverzChord rr rz Chord:  Accidental z of zchord Octave rz Interval )rrsortedpitchesreverser Noter, noteToBrailler#r!r"appendjoingetrangelenhandlePitchWithAccidentalr accidentalr notesToGeneric undirected pitchToOctaveoctaver intervals) music21Chord descendingr. allPitches direction chordTrans basePitchinitNote brailleNote englishJoinedcurrentPitchIndex currentPitchintervalDistance brailleOctave previousPitchrelativeIntervalDists r&chordToBraillerVtszj-/L) ,,-JI J1 Iyy"00H Kg/00F<.0RST--44 ~U5KL())k"IIh00445ErJKM))00 +Y}o.#1c*o6!4   %&&55 $229KVV a  01 49A=  A% -l ; !!-0&&55<<l112!M?CE!+q+@ A '/'>'>}?K(MMWZ%'1,$1,$?M%%m4 **99@@!,"5"5!6a G "),7M   m ,  " " 1 1 8 8,--.a ? A q  &**+;<=--44()6+;+; 8 by tripling, etc. the number of octave marks. >>> pitchToOctave = braille.basic.pitchToOctave >>> print(pitchToOctave(pitch.Pitch('C4'))) ⠐ >>> print(pitchToOctave(pitch.Pitch('B-4'))) ⠐ >>> print(pitchToOctave(4)) ⠐ >>> print(pitchToOctave(3)) ⠸ >>> print(pitchToOctave(2)) ⠘ >>> print(pitchToOctave(1)) ⠈ >>> print(pitchToOctave(0)) ⠈⠈ >>> print(pitchToOctave(-1)) ⠈⠈⠈ >>> print(pitchToOctave(5)) ⠨ >>> print(pitchToOctave(6)) ⠰ >>> print(pitchToOctave(7)) ⠠ >>> print(pitchToOctave(8)) ⠠⠠ >>> print(pitchToOctave(9)) ⠠⠠⠠ rEr0r3N)hasattrrEr octaves)music21PitchOrIntrEs r&rDrDsL (++"))" ~~f%% !~~a AJ// !~~a FQJ// c  SSSSSSSSS S S S . n[U[R5(aS U3/URlg[ R nUSnXCURUR- nX RRSU3-/URl[U[R[R45(a8XCSU- nU(a%URRRS5 U$XCSS- nU$![a SU3/URlNf=f![a: [R!SUS35 US3/URl["Ss$f=f)u Takes in a :class:`~music21.clef.Clef` and returns its representation as a braille string in UTF-8 unicode. Only :class:`~music21.clef.GClef`, :class:`~music21.clef.CClef`, :class:`~music21.clef.FClef`, :class:`~music21.clef.NoClef` and their subclasses (such as :class:`~music21.clef.TrebleClef`, :class:`~music21.clef.BassClef`) can be transcribed. If keyboardHandSwitched is True, the suffix of the brailled clef changes from dots 1-2-3 to dots 1-3. In scores of keyboard instruments, this change indicates that the playing hand differs from which implied by the clef. (E.g. A G clef in the left-hand part of a piano score needs the change of suffix.) Note that changeSuffix works only for G and F clefs. >>> from music21.braille.basic import clefToBraille >>> trebleClef = clef.TrebleClef() >>> print(clefToBraille(trebleClef)) ⠜⠌⠇ >>> print(clefToBraille(trebleClef, keyboardHandSwitched=True)) ⠜⠌⠅ >>> bassClef = clef.BassClef() >>> print(clefToBraille(bassClef)) ⠜⠼⠇ >>> print(clefToBraille(bassClef, keyboardHandSwitched=True)) ⠜⠼⠅ >>> altoClef = clef.AltoClef() >>> print(clefToBraille(altoClef)) ⠜⠬⠇ >>> tenorClef = clef.TenorClef() >>> print(clefToBraille(tenorClef)) ⠜⠬⠐⠇ >>> noClef = clef.NoClef() >>> clefToBraille(noClef) == '' True >>> sopranoClef = clef.SopranoClef() >>> print(f'{sopranoClef.sign}, {sopranoClef.line}, {clefToBraille(sopranoClef)}') C, 1, ⠜⠬⠈⠇ z French ViolinTreblez G-sopranoSopranoz Mezzo-sopranoAltoTenorz C-baritonez F-baritoneBasszSub-bass) FrenchViolinClef TrebleClef GSopranoClef SopranoClefMezzoSopranoClefAltoClef TenorClef CBaritoneClef FBaritoneClefBassClef SubBassClefzNo Clef r5prefixz Clef z Unnamed Clef suffixz Keyboard hand switchedFzClef rrr) isinstancerNoClefrrr clefssignline __class____name__r rermr;r!r"r#) music21ClefkeyboardHandSwitched clefNamesrs brailleClefs r& clefToBrailler|%sT,# +%%! I+t{{++2:;-0H/I , LLE/K*[--.{/?/?@@  S0099:vk]=SST  ! ! 0 kDOOT]]#C D D ?+?@ @K#%%44;;-u0E/F ,())*s>D?9.D'A&D? D?D<9D?;D<<D??AFFcx/n/URlU(aGUR[S5 URRRS[S35 [ UR SS9nURRRSUR S U35 URU5 S RU5$![ aan[RSUSU35 URRRSUR S35 [SsS nA$S nAff=f) u Takes in a :class:`~music21.dynamics.Dynamic` and returns its :attr:`~music21.dynamics.Dynamic.value` as a braille string in UTF-8 unicode. If precedeByWordSign is True, the value is preceded by a word sign (⠜). >>> from music21.braille.basic import dynamicToBraille >>> print(dynamicToBraille(dynamics.Dynamic('f'))) ⠜⠋ >>> print(dynamicToBraille(dynamics.Dynamic('pp'))) ⠜⠏⠏ wordzWord: TisTextExpressionzDynamic : rrNrr5) rrr;r# wordToBraillevalueBrailleBasicExceptionr!r"r<)music21DynamicprecedeByWordSign dynamicTransbrailleDynamic wordExceptions r&dynamicToBraillerus"L.0N+GFO,  //66?P7QR*&~';';dS ++22 >''(.)9:<' 77<   !*H^$4B}oFG  //66.BVBVAWW\7]^())*s#C D9AD4.D94D9c,/URlUR5R5nUVs/sHn[ U5PM nn[SRU5nURRRSUR5SU35 U$s snf![ aen[ RSUSU35 URRRSUR5S35 [SsSnA$SnAff=f)ud Takes in a :class:`~music21.instrument.Instrument` and returns its "best name" as a braille string in UTF-8 unicode. >>> from music21.braille.basic import instrumentToBraille >>> print(instrumentToBraille(instrument.Bassoon())) ⠠⠃⠁⠎⠎⠕⠕⠝ >>> print(instrumentToBraille(instrument.BassClarinet())) ⠠⠃⠁⠎⠎⠀⠉⠇⠁⠗⠊⠝⠑⠞ z Instrument rrrNspacer) rrbestNamesplitrrr!r"r;r#r<)music21InstrumentallWordsr~transr brailleInsts r&instrumentToBraillers 24. ))+113H*19:t$:'"''.K..55 '00231[MBD ; *K(9':"]OLM##2299+4467u = ?()) *s/B$B B$B$$ D.ADDDc[Rn/URlURn[R UnUS:a,URRRSUSU35 O4URRRS[U5SU35 UcU$URn[U5n[U5n/nUS:XdUS:Xd XV- X7- :waBURX&5 URRRSSUS X&35 O`Xg:a[URU[XS- 55 U[XS- 5n URRRSSUS U 35 URU5 S RU5$![ aN [RSUS35 URRRSUS35 [Ss$f=f![ aF [RS US35 URRRUS 35 Us$f=f) u Takes in a :class:`~music21.key.KeySignature` and returns its representation in braille as a string in UTF-8 unicode. >>> from music21.braille.basic import keySigToBraille >>> print(keySigToBraille(key.KeySignature(4))) ⠼⠙⠩ If given an old key signature, then its cancellation will be applied before and in relation to the new key signature. >>> print(keySigToBraille(key.KeySignature(0), outgoingKeySig = key.KeySignature(-3))) ⠡⠡⠡ zIncoming Key Signature rzKey Signature z sharps Nonerrz sharp(s) z flat(s) z naturals r5zOutgoing Key Signature z naturals=None)r naturalsrrsharps keySignaturesr r!r"r;r#absinsertr<) music21KeySignatureoutgoingKeySigrincomingSharps ks_brailleoutgoingSharps absOutgoing absIncomingr naturalsPrints r&keySigToBraillerstH35!!0(//N *)).9 %%44;;^,Jzl C  %%44;;S01:, G #**Nn%Kn%K E a !Q&"0n6RS LL. /  ) ) 8 8 ? ?  0 8;P:QR T ' LL#n&E"FG H$S)H%IJM  ) ) 8 8 ? ?  0 =/J   Z wwu~U *%&9%::\ ]  %%44;;01 > ())*X %n%55W X Z%%44;;~>Nn<]^ s&F,CH,AHHA IIcURcg/URl/n[R"SUR R S9n[USS9nURU5 SRURRS/55nURRRS U35 UR[S 5 URRRS [S 35 [UR5nURU5 URRRS URSU35 SRU5$![aVn[RS USU35 URRRUS35 [SsSnA$SnAff=f)ub Takes in a :class:`~music21.tempo.MetronomeMark` and returns it as a braille string in UTF-8 unicode. The format is (note C with duration of metronome's referent)(metronome symbol)(number/bpm). >>> from music21.braille.basic import metronomeMarkToBraille >>> mm1 = tempo.MetronomeMark(number=80, referent=note.Note(type='half')) >>> print(metronomeMarkToBraille(mm1)) ⠝⠶⠼⠓⠚ >>> mm2 = tempo.MetronomeMark(number=135, referent=note.Note(quarterLength=0.5)) >>> print(metronomeMarkToBraille(mm2)) ⠙⠶⠼⠁⠉⠑ >>> mm3 = tempo.MetronomeMark(numberSounding=80) >>> metronomeMarkToBraille(mm3) '' Nr5C4r+F)r.rrzMetronome Note metronomezMetronome symbol zMetronome number zMetronome Mark rrr)numberrrr r9referentr,r:r;r<r=r#numberToBraillerr!r")music21MetronomeMark metroTrans metroNoterNrO brailleNumbernumberExceptions r&metronomeMarkToBraillers$""*46""1* IId2F2O2O2]2]^ #I%@ +&!4!4!8!89I2!NO &&55<<m_ -  '+./&&55<< 45 6 ((<(C(CD -(&&55<< 4 ; ;UR[R ;a[R URnOM}SUR;a5URRRSURSU35 Uv M gg7f)u7 Generator that yields braille before note articulations from a given note. Might yield nothing. "When a staccato or staccatissimo is shown with any of the other [before note expressions], it is brailled first." "The up-bow and down-bow marks for bowed string instruments are brailled before any other signs from Column A and before an ornament." (BMTM, 114) Beyond that, we yield in alphabetical order, which happens to satisfy this: "When an accent is shown with a tenuto, the accent is brailled first." (BMTM, 113) For reference: >>> brailleArt = braille.lookup.beforeNoteExpr >>> print(brailleArt['tenuto']) ⠸⠦ >>> print(brailleArt['staccato']) ⠦ >>> print(brailleArt['accent']) ⠨⠦ >>> brailleBowings = braille.lookup.bowingSymbols >>> print(brailleBowings['down bow']) ⠣⠃ >>> print(brailleBowings['up bow']) ⠣⠄ >>> n = note.Note() >>> n.articulations.append(articulations.DownBow()) >>> n.articulations.append(articulations.Tenuto()) >>> n.articulations.append(articulations.Staccato()) >>> n.articulations.append(articulations.Accent()) >>> n.articulations.append(articulations.Scoop()) # example unsupported articulation This will yield in order: DownBow, Staccato, Accent, Tenuto. >>> for brailleArt in braille.basic.yieldBrailleArticulations(n): ... print(brailleArt) ⠣⠃ ⠦ ⠨⠦ ⠸⠦ c[U[R5n[U[R5nU(+U(+UR4$N)rqrBowingStaccatoname)inner_articulationisBowing isStaccatos r&_brailleArticulationsSortKey?yieldBrailleArticulations.._brailleArticulationsSortKeyZs@0-2F2FG 2M4J4JK  *n.@.E.EFFr]r)keyrz Articulation rN) rZr6rrr bowingSymbolsbeforeNoteExprrrr;)noteElrart brailleArts r&yieldBrailleArticulationsr*s`G v''&..4PQCxx6///#11#((; V222#22388< 6#3#33  //66sxxjPQR\Q]7^_ R(sC5C7)r.upperFirstInFingeringcL/URl[Hn[X5[U'M /n[S(aHUR [S5 URRR S[S35 OU[S(aGUR [S5 URRR S[S35 [S(aU[S(aGUR [S 5 URRR S [S 35 URRnU(Ga;[S (GaUS RS :Xa,US RS:waUR [S5 OUS RS:XaGUR [S5 URRR S[S35 [SnU[US RSSS9- nU[S- nUR U5 URRR US RSUS35 O[S(a S[S'[U5HnUR U5 M [UR UURR5 U(a[[+UR 5nUR U5 URRR SUR,SU35 [.R0UR R2n [5UR[R65(aOU S n UR U 5 URRR UR2SS S!U 35 GO*[S(a:U S n URRR UR2S"U 35 OcXRR8n URRR UR2SURR8SU 35 UR U 5 [;URR<5HJn UR [S5 URRR S#[S35 ML [?XU5 [AX5 [S%(aGUR [S&5 URRR S'[S&35 [S(a[S(d[S((aHUR [S)5 URRR S [S)35 OU[S(aGUR [S 5 URRR S [S 35 URBbaURBR8S*:waGUR [S+5 URRR S,[S+35 S-REU5$![ a S[U'GMf=f!["a7 [$R'SUR R(SUS3S-5 GN9f=f!["a} [$R'SUR R2<SUS3S-5 URRR SUR R2S35 [Ss$f=f!["ah [$R'S$URSUS3S-5 URRR S$URS35 [Ss$f=f).u Given a :class:`~music21.note.Note`, returns the appropriate braille characters as a string in UTF-8 unicode. The format for note display in braille is the accidental (if necessary) + octave (if necessary) + pitch name with length. If the note has an :class:`~music21.pitch.Accidental`, the accidental is always displayed unless its :attr:`~music21.pitch.Accidental.displayStatus` is set to False. The octave of the note is only displayed if showOctave is set to True. >>> from music21.braille.basic import noteToBraille >>> C4 = note.Note('C4') >>> print(noteToBraille(C4)) ⠐⠹ >>> C4.quarterLength = 2.0 >>> print(noteToBraille(C4)) ⠐⠝ >>> Ds4 = note.Note('D#4') >>> print(noteToBraille(Ds4)) ⠩⠐⠱ >>> print(noteToBraille(Ds4, showOctave=False)) ⠩⠱ >>> Ds4.pitch.accidental.displayStatus=False >>> print(noteToBraille(Ds4)) ⠐⠱ >>> A2 = note.Note('A2') >>> A2.quarterLength = 3.0 >>> print(noteToBraille(A2)) ⠘⠎⠄ >>> B = note.Note('B4') >>> f = expressions.Fermata() >>> B.expressions.append(f) >>> print(noteToBraille(B)) ⠐⠺⠣⠇ >>> for x in B.editorial.brailleEnglish: ... print(x) Octave 4 ⠐ B quarter ⠺ Note-fermata: Shape normal: ⠣⠇ >>> f.shape = 'square' >>> print(noteToBraille(B)) ⠐⠺⠰⠣⠇ >>> for x in B.editorial.brailleEnglish: ... print(x) Octave 4 ⠐ B quarter ⠺ Note-fermata: Shape square: ⠰⠣⠇ >>> C4 = note.Note('C4') >>> print(noteToBraille(C4)) ⠐⠹ >>> C4.duration.appendTuplet(duration.Tuplet(3, 2)) # triplet >>> print(noteToBraille(C4)) ⠐⠹ >>> C4.beamStart = True >>> print(noteToBraille(C4)) ⠆⠐⠹ >>> for x in C4.editorial.brailleEnglish: ... print(x) Triplet ⠆ Octave 4 ⠐ C quarter ⠹ >>> C4 = note.Note('C4') >>> C4.duration.appendTuplet(duration.Tuplet(7, 4)) # septuplet >>> C4.beamStart = True >>> print(noteToBraille(C4)) ⠸⠶⠄⠐⠹ >>> for x in C4.editorial.brailleEnglish: ... print(x) Septuplet ⠸⠶⠄ Octave 4 ⠐ C quarter ⠹ Fropening_bracket_slurzOpening bracket slur ropening_double_slurzOpening double slur rclosing_bracket_slurzClosing bracket slur rrTripletnonetripletztranscriber-added_signztranscriber-added tuplet_prefixTwithNumberSignlowerdotrrr1 of note !cannot be transcribed to braille.r4zName rreighthz Gracenote--not supported z beam Dot z Duration ropening_single_slurzOpening single slur rclosing_double_slurstoptiezTie r5)#rrTEMPORARY_ATTRIBUTESgetattrrAttributeErrorr;r#rtupletsfullNametupletActualShowrnumberNotesActualrr@pitchr r!r"rArDrEr pitchNameToNotessteprq GraceDurationrr>dotshandleArticulationshandleExpressionsrr<) r-r.rkeyword noteTrans allTuplets tupletTransbrailleArticulationrS notesInStepnameWithDurationunused_counter_dots r&r:r:msXx,.K(' (")+"?Jw ( I ()!789,,33#G,B$C#D E G ) *!678,,33"7+@#A"B C E&'J7M,N!789,,33#G,B$C#D E G %%--J k " "!}%%2z!}7U7UY_7_  !34a=11V;$$W-E%FG))88??,W5M-N,OPR%o6 z!}/N/N@E7; == wu~-   -  ! ! 0 0 7 7a=))*!IbM?;  ').J~ & 9E,- F  !      ! ! 0 0 %k&7&78 ',,33gk>P>P=QQRS`Ra4bc*--k.?.?.D.DE +&&(>(>??&x0)*,,33 (+EFVEW X  ..)#.x#8 %%44;;"''(/?.@AC$//C/C/H/H#I %%44;;"''(+*>*>*C*C)DAFVEWX   - .&+K,@,@,E,E&F"  0%%44;;d75>BR:J4KL 779 ] ("'Jw  (v  +++667y Q O1 2  " *K%%**-Y{m1 E1 2 3 ,,33eK .   K001;-qI56 7  ! ! 0 0 7 7)KDXDXCYY^8_ `,- -  .sJ[?+[# '\'-D)^1[ [ #=\$#\$'B^.-^.1A/`#"`#cURnUbURSLaURS:Xa.[SnUR U5 UR SU35 UR [ R UR5 UR SURS[ R UR35 URS:Xa/[SnUR U5 UR SU35 gggg)NF parentheseszbraille-music-parenthesisz Parenthesis r1r)rA displayStatus displayStyler#r;r accidentalsr) music21Pitch pitchTransraccpss r&r@r@_s  ! !C 3,,E9   } ,45B   b !  ! !L"5 6&,,SXX67 CHH:Qv7I7I#((7S6TUV   } ,45B   b !  ! !L"5 6 -:r]c URH:nSUR;dM[URUS9nUR U5 M< g![ a6 [ RSURRSUS3S-5 gf=f)N Fingering)rz Fingering rrr) rclassestranscribeNoteFingering fingerNumberr;rr!r"r fingering)r-rrrtranscribedFingerings r&rros 3,,Cckk)'>$$*?(A$  !56 - !3..889;-q Q1 2 33sA )A =B  B c URHn[U[R5(dM$[RSUR nUR U5 URRR SUR SU35 M g![a [RSUSUS35 Mf=f)z4 Transcribe the expressions for a note.GeneralNote. shapezNote-fermata: Shape rzFermata rz cannot be transcribed.N) r rqFermatar fermatasrr;rrr r!r")r-rexprfermataBrailles r&rrs '' dK// 0 0 b!'!9$**!E  0%%44;;*4::,b8HIK ( b!!HTF)K=H_"`a bsA&B&CCc"/URl/nURRnURRnUR SLaSnSn[ RUnURU5 URRRSUS U35 [U5HJnUR[S 5 URRRS [S 35 ML [X5 S RU5$![al [RSURS35 URRRSURRS35 [Ss$f=f) uY Given a :class:`~music21.note.Rest`, returns the appropriate braille characters as a string in UTF-8 unicode. Currently, only supports single rests with or without dots. Complex rests are not supported. >>> from music21.braille.basic import restToBraille >>> dottedQuarter = note.Rest(quarterLength=1.5) >>> print(restToBraille(dottedQuarter)) ⠧⠄ >>> whole = note.Rest(quarterLength=4.0) >>> print(restToBraille(whole)) ⠍ This would give a warning and gives the basic_exception symbol: quarterPlusSixteenth = note.Rest(quarterLength=1.25) print(restToBraille(quarterPlusSixteenth)) ⠜⠦ TwholerzRest of duration rzRest rrrrrr5)rrrrr fullMeasurer restsr r!r"r;r#r>rr<) music21Rest restTransrestTyperestDots simpleRestrs r& restToBrailler sl.,.K(I##((H##((H$&*\\(+ Z ((//%z:,0OP#Ho(,,33d75>:J4KL.k- 779  * 4 455W X Z,,33eK>> from music21.braille.basic import tempoTextToBraille >>> print(tempoTextToBraille(tempo.TempoText('Lento assai, cantante e tranquillo'))) ⠠⠇⠑⠝⠞⠕⠀⠁⠎⠎⠁⠊⠂ ⠉⠁⠝⠞⠁⠝⠞⠑⠀⠑⠀⠞⠗⠁⠝⠟⠥⠊⠇⠇⠕⠲ >>> print(tempoTextToBraille(tempo.TempoText('Andante molto grazioso'))) ⠠⠁⠝⠙⠁⠝⠞⠑⠀⠍⠕⠇⠞⠕⠀⠛⠗⠁⠵⠊⠕⠎⠕⠲ >>> print(tempoTextToBraille(tempo.TempoText('Andante molto grazioso ma cantabile'))) ⠠⠁⠝⠙⠁⠝⠞⠑⠀⠍⠕⠇⠞⠕⠀⠛⠗⠁⠵⠊⠕⠎⠕⠀⠍⠁⠀ ⠉⠁⠝⠞⠁⠃⠊⠇⠑⠲ >>> print(tempoTextToBraille(tempo.TempoText('Andante molto grazioso ma cantabile'), ... maxLineLength=20)) ⠠⠁⠝⠙⠁⠝⠞⠑⠀ ⠍⠕⠇⠞⠕⠀ ⠛⠗⠁⠵⠊⠕⠎⠕⠀⠍⠁⠀ ⠉⠁⠝⠞⠁⠃⠊⠇⠑⠲ ,z Tempo Text rrrNrr/r0rYrr5r.r) rrtextrrrr!r"r;r#r?r<alphabet)music21TempoTextrnewBrailleEnglish allPhrasesbraillePhrases samplePhraser phraseTrans sampleWord brailleWordr total_widthphrasejoinerbrailleUnicodeTexts r&tempoTextToBrailler!s<$&0A-!&&,,S1JN" %%'!# "J 2+J7 K%T>"#K3v;.K & S--1]Q5FG""4(   { +   ww/ 0+#, bggk!B&7893#6c]T !F^4x}D--44 &++,A.@-AB 7) 2!!K0@/AM?"ST **99@@!"2"7"7!8>0111  2s E G AG6GGc/URlURnU[R;a@[RUnURRR SUSU35 U$UR 5n/nUHnUR [USS95 M [S RU5nURRR SUSU35 U(a<[S U-nURRRS S [S 35 [U5S :a;U[S -nURRR S [S 35 U$![aWn[RSUSU35 URRR SUS35 [SsSnA$SnAff=f)uo Takes in a :class:`~music21.expressions.TextExpression` and returns its representation in UTF-8 unicode. From the lookup table: >>> from music21.braille.basic import textExpressionToBraille >>> print(textExpressionToBraille(expressions.TextExpression('cresc.'))) ⠜⠉⠗⠄ Single word expression has word symbol (⠜) only at beginning: >>> print(textExpressionToBraille(expressions.TextExpression('dolce'))) ⠜⠙⠕⠇⠉⠑ Multiple word expression has word symbol at beginning and end. >>> print(textExpressionToBraille(expressions.TextExpression('dim. e rall.'))) ⠜⠙⠊⠍⠄⠀⠑⠀⠗⠁⠇⠇⠄⠜ zText Expression rTrrrrNrr~rzWord r0)rrcontentr textExpressionsr;rrrr!r"r#r<rr?) music21TextExpressionrteWords simpleReturnallExprtextExpressionTransrrbrailleTextExprs r&textExpressionToBrailler+s*68##2#++G&(((--g6 ''66==wiq 7 9mmoG*D  & &}TD'Q Rg&++,?@O##2299 7)1_$568!&/O;''66==a5QWHYAZ[ 7|a)GFO;''66==gfoEV>WX # !*,-B,C2m_UV''66==@PQXPYY^>_`())*s"E99 GA GGGc/URlURS;aJ[URnURRR SURSU35 U$[ UR 5[ URSSS9/nSRU5nURRR SUR SURS3U-5 U$![[4aTn[RSUS 35 URRR US 35 [S sS nA$S nAff=f) u Takes in a :class:`~music21.meter.TimeSignature` and returns its representation in braille as a string in UTF-8 unicode. >>> from music21.braille.basic import timeSigToBraille >>> print(timeSigToBraille(meter.TimeSignature('4/4'))) ⠼⠙⠲ >>> print(timeSigToBraille(meter.TimeSignature('3/4'))) ⠼⠉⠲ >>> print(timeSigToBraille(meter.TimeSignature('12/8'))) ⠼⠁⠃⠦ >>> print(timeSigToBraille(meter.TimeSignature('c'))) ⠨⠉ )commoncutzTime Signature rFTrr5/rrrN) rrsymbolr#r;r numerator denominatorr<rr r!r")m21TimeSignature brailleSig timeSigTrans unused_errors r&timeSigToBrailler7@s_13-"33-445 ""1188.556a | D F*'(8(B(BC'(8(D(D7<.245 WW\* ""1188.889;K;W;W:XXY Z    !8 ,*.//Q R T""1188A E E EcUcg[R"X5nURRS:nURRS;nURUR:HnSnU(dU(a U(dSnU$)a Determines whether a currentNote carries an octave designation in relation to a previous Note. Rules: * If currentNote is found within a second or third of previousNote, currentNote does not carry an octave designation. * If currentNote is found a sixth or more away from previousNote, currentNote does carry an octave designation. * If currentNote is found within a fourth or fifth of previousNote, currentNote carries an octave designation if and only if currentNote and previousNote are not found in the same octave. Of course, these rules cease to apply in quite a few cases, which are not directly reflected in the results of this function: 1) If a braille measure goes to a new line, the first note in the measure carries an octave designation regardless of what the previous note was. 2) If a braille measure contains a new key or time signature, the first note carries an octave designation regardless of what the previous note was. 3) If a new key or time signature occurs in the middle of a measure, or if a double bar line is encountered, both of which would necessitate a music hyphen, the next note after those cases needs an octave marking. If any special case happens, previousNote can be set to None and the function will return True. >>> from music21.braille.basic import showOctaveWithNote >>> showOctaveWithNote(note.Note('C4'), note.Note('E4')) False >>> showOctaveWithNote(note.Note('C4'), note.Note('F4')) False >>> showOctaveWithNote(note.Note('C4'), note.Note('F3')) True >>> showOctaveWithNote(note.Note('C4'), note.Note('A4')) True If previousNote is None, it is always True >>> showOctaveWithNote(None, note.Note('A4')) True TrY)F)r IntervalgenericrCrE) previousNote currentNoteiisSixthOrGreaterisFourthOrFifthsameOctaveAsPrevious doShowOctaves r&showOctaveWithNoterDlsvn,4Ayy++q0ii**f4O'..+2D2DDLO4H r]cUcUcUcUc [S5eSnUb [X$S9nUcUcUcUR5n/nUHnURU5 M [ U5US- ::a*SR U5nUR U[S5$[[ U55H n XyR U[S5Xy'M" SR U5$/n Ub[U5n U RU 5 [X5n UbU R[S5 U RU 5 SR U 5n UcU R U[S5$UR5n/nUHnURU5 M URU 5 [ U5S:a*US (d USSn[ U5S:a US (dM [ U5S:a*US (d USS n[ U5S:a US (dM [ U5[ U 5-S-US- ::a1[SR U5nUR U[S5$[[ U55H n XyR U[S5Xy'M" SR U5$![a UcUc [S5eGNf=f) u Takes in a :class:`~music21.key.KeySignature`, :class:`~music21.meter.TimeSignature`, :class:`~music21.tempo.TempoText`, and :class:`~music21.tempo.MetronomeMark` and returns its representation in braille as a string in UTF-8 unicode. The contents are always centered on a line, whose width is 40 by default. In most cases, the format is (tempo text)(space)(metronome mark)(space)(key/time signature), centered, although all of these need not be included. If all the contents do not fit on one line with at least 3 blank characters on each side, then the tempo text goes on the first line (and additional lines if necessary), and the metronome mark + key and time signature goes on the last line. If the resulting heading is of length zero, a BrailleBasicException is raised. >>> from music21.braille.basic import transcribeHeading >>> print(transcribeHeading( ... key.KeySignature(5), ... meter.TimeSignature('3/8'), ... tempo.TempoText('Allegretto'), ... tempo.MetronomeMark(number=135, referent=note.Note(type='eighth')))) ⠀⠀⠀⠀⠀⠀⠀⠠⠁⠇⠇⠑⠛⠗⠑⠞⠞⠕⠲⠀⠙⠶⠼⠁⠉⠑⠀⠼⠑⠩⠼⠉⠦⠀⠀⠀⠀⠀⠀⠀ >>> print(transcribeHeading( ... key.KeySignature(-2), ... meter.TimeSignature('common'), ... tempo.TempoText('Lento assai, cantante e tranquillo'), ... None)) ⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠠⠇⠑⠝⠞⠕⠀⠁⠎⠎⠁⠊⠂⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀ ⠀⠀⠀⠀⠀⠀⠀⠀⠀⠉⠁⠝⠞⠁⠝⠞⠑⠀⠑⠀⠞⠗⠁⠝⠟⠥⠊⠇⠇⠕⠲⠀⠀⠀⠀⠀⠀⠀⠀⠀ ⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠣⠣⠨⠉⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀ >>> print(transcribeHeading( ... key.KeySignature(-2), ... meter.TimeSignature('common'), ... tempo.TempoText('Lento assai, cantante e tranquillo'), ... None, ... maxLineLength=10)) ⠀⠠⠇⠑⠝⠞⠕⠀⠀⠀ ⠀⠀⠁⠎⠎⠁⠊⠂⠀⠀ ⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀ ⠉⠁⠝⠞⠁⠝⠞⠑⠀⠀ ⠀⠀⠀⠀⠑⠀⠀⠀⠀⠀ ⠞⠗⠁⠝⠟⠥⠊⠇⠇⠕⠲ ⠀⠀⠀⠣⠣⠨⠉⠀⠀⠀ NzNo heading can be made.rrYr5rr/r0rr) rr! splitlinesr;r?r<centerr#r>rtranscribeSignatures)rmusic21TimeSignaturerrrtempoTextTranstempoTextLines headingTranstempoText_lineheading_line_index otherTransmetronomeMarkTrans keyAndTimeSig otherTransStrtempo_text_lineheadingTrans_strs r&transcribeHeadingrUsn #$, ($,#$=>>N#+,<Z#$,$,'224 ,N    /- ~ =1#4 577<0L&&}gg6FG G&+C ,=&>"3?3S3Z3Z!G$4 0'? 99\* *J'34HI,-C,-@W  +   gg. /-( GGJ'M##M773CDD'224 -O    0 .M*,!#LO'+L,!#LOO,!#L,<',L,!#L,<,< ~ ]!3 3a 7MA"3?3S3Z3Z!G$4 0'? 99\* *= !C  ',<,D'(AB BCs7J00KKc[Rn[U[5(a [ U5n[ U5S:XaX $/nURS5n[ U5S:XaSnO)[ U5S:XaURS5nSnO[ eU(dUR5 [[ U55HnXFRS5n[ U5S:XaFURX'S 5 UR[S 5 URX'S5 Ml[ U5S:XaUS nS n X(n URU 5 MM S RU5$![ a [SU35ef=f![ a0n U(dU eUS :Xa[S n Sn A Nk[S n Sn A NySn A ff=f![ a [SU35ef=f)uo Takes in a note fingering and returns its correct transcription to braille. >>> from music21.braille.basic import transcribeNoteFingering >>> print(transcribeNoteFingering('4')) ⠂ A change of fingering: >>> print(transcribeNoteFingering('2-1')) ⠃⠉⠁ A choice of fingering, both on either the top or bottom of the staff: >>> print(transcribeNoteFingering('5|4', upperFirstInFingering=True)) ⠅⠂ >>> print(transcribeNoteFingering('5|4', upperFirstInFingering=False)) ⠂⠅ A choice of fingering, one on top and one below the staff: >>> print(transcribeNoteFingering('2,1', upperFirstInFingering=True)) ⠃⠁ >>> print(transcribeNoteFingering('2,1', upperFirstInFingering=False)) ⠁⠃ A choice of fingering, first set missing fingermark: >>> print(transcribeNoteFingering('2,x')) ⠃⠄ A choice of fingering, second set missing fingermark: >>> print(transcribeNoteFingering('x,2')) ⠠⠃ Missing fingermarks change with upperFirstInFingering >>> print(transcribeNoteFingering('x,4', upperFirstInFingering=True)) ⠠⠂ >>> print(transcribeNoteFingering('x,4', upperFirstInFingering=False)) ⠂⠄ >>> print(transcribeNoteFingering('4,x', upperFirstInFingering=True)) ⠂⠄ >>> print(transcribeNoteFingering('4,x', upperFirstInFingering=False)) ⠠⠂ A change of fingering and a choice of fingering combined (thanks to Bo-cheng Jhan for the patch): >>> print(transcribeNoteFingering('1-2|3-4')) ⠁⠉⠃⠇⠉⠂ Incorrect fingerings raise a BrailleBasicException: >>> transcribeNoteFingering('6') Traceback (most recent call last): music21.braille.basic.BrailleBasicException: Cannot translate note fingering: 6 r0z!Cannot translate note fingering: rrXT|F-r finger_changer5first_set_missing_fingermarksecond_set_missing_fingermarkN)r fingerMarksrqintstrr?r rrr8r>r;r#r<) sampleNoteFingeringrr\rchoice allowAbsencer?change changeMarkfingerMarkToAppendes r&rr/sz$$K%s++!"56 1$ c3 3 E & &s +F 6{a V $**3/   3v; % c6{a [34 W_56 [34V!#AY %'" V)4)@& /0" 2 775>Q c'*KL_K`(ab b c6 V'Av-45S-T*-45T-U*V c'*KL_K`(ab b csUE-AG*GF G-F GF>+G0 F>9G>GGGcUcUbURS:XaUcg/nUbUR[XS95 UbUR[U55 SR U5$)u  Takes in a :class:`~music21.key.KeySignature` and :class:`~music21.meter.TimeSignature` and returns its representation in braille as a string in UTF-8 unicode. If given an old key signature, then its cancellation will be applied before and in relation to the new key signature. Raises a BrailleBasicException if the resulting key and time signature is empty, which happens if the time signature is None and (a) the key signature is None or (b) the key signature has zero sharps and there is no previous key signature. >>> from music21.braille.basic import transcribeSignatures >>> print(transcribeSignatures(key.KeySignature(5), meter.TimeSignature('3/8'), None)) ⠼⠑⠩⠼⠉⠦ >>> print(transcribeSignatures(key.KeySignature(0), None, key.KeySignature(-3))) ⠡⠡⠡ rr5)r)rr;rr7r<)rrIrrs r&rHrHsj& $$,(//149O E& _%8XY' %&:;< 775>r]cUR5n/nUHFn/nUHnUR[U5 M URSRU55 MH SRU5$)aM translates a braille UTF-8 unicode string into braille ASCII, which is the format compatible with most braille embossers. .. note:: The function works by corresponding braille symbols to ASCII symbols. The table which corresponds to said values can be found `here `_. Because of the way in which the braille symbols translate, the resulting ASCII string will look to a non-reader as gibberish. Also, the eighth-note notes in braille music are one-off their corresponding letters in both ASCII and written braille. The written D is really a C eighth-note, the written E is really a D eighth note, etc. >>> from music21.braille.basic import brailleUnicodeToBrailleAscii, noteToBraille >>> brailleUnicodeToBrailleAscii('\u2800') ' ' >>> Cs8 = note.Note('C#4', quarterLength=0.5) >>> Cs8_braille = noteToBraille(Cs8) >>> brailleUnicodeToBrailleAscii(Cs8_braille) '%"D' >>> Eb8 = note.Note('E-4', quarterLength=0.5) >>> Eb8_braille = noteToBraille(Eb8) >>> brailleUnicodeToBrailleAscii(Eb8_braille) '<"F' r5r/)rFr; ascii_charsr<)brailleUnicode brailleLines asciiLines sampleLineallCharschars r&brailleUnicodeToBrailleAsciirosi6",,.LJ" D OOK- ."''(+, # 99Z  r]c&0n[HnX![U'M UR5n/nUHOn/nUH$nURXR55 M& URSR U55 MQ SR U5$)u4 translates a braille ASCII string to braille UTF-8 unicode, which can then be displayed on-screen in braille on compatible systems. .. note:: The function works by corresponding ASCII symbols to braille symbols in a very direct fashion. It is not a translator from plain text to braille, because ASCII symbols may not correspond to their equivalents in braille. For example, a literal period is a 4 in braille ASCII. Also, all letters are translated into their lowercase equivalents, and any capital letters are indicated by preceding them with a comma. >>> t1 = braille.basic.brailleAsciiToBrailleUnicode(',ANDANTE ,MAESTOSO4') >>> t1 '⠠⠁⠝⠙⠁⠝⠞⠑⠀⠠⠍⠁⠑⠎⠞⠕⠎⠕⠲' >>> t2 = braille.basic.tempoTextToBraille(tempo.TempoText('Andante Maestoso')) >>> t1 == t2 True r5r/)rhrFr;upperr<) brailleAscii braille_charsrrkrjrlrmrns r&brailleAsciiToBrailleUnicoderts(M*-k#&'((*JL D OOM**,7 8BGGH-. ! 99\ ""r]c,UU3UU3UU3UU3S.nUR5n/nUHn/n/n/n UHRn [RU upn URX;5 URX<5 U RX=5 MT URSR U55 URSR U55 URSR U 55 URS5 M SR USS5$)u translates a braille unicode string into symbols (unicode) -- for debugging. >>> print(braille.basic.brailleUnicodeToSymbols('⠜')) ·o ·o o· )00011011z r5r/rr)rFr binary_dotsr;r<)ri filledSymbol emptySymbol symbolTransrj binaryLinesrl binaryLine1 binaryLine2 binaryLine3rndots14dots25dots36s r&brailleUnicodeToSymbolsr s((= 6'=7(>+7(>,8:K ",,.LK"    D'-'9'9$'? $VV   {2 3   {2 3   {2 3  499[12499[12499[122# 99[2& ''r]c#f# [RUHnUS;dM [Sv M g7f)u Generator that yields symbol['dot'] characters for each row of a braille character that where the left dot is filled. These are used in many places in Braille Music Code. >>> B = braille.lookup.brailleDotDict >>> gen = braille.basic.yieldDots(B[1]) >>> gen >>> for dot in gen: ... print(dot) ⠄ >>> gen = braille.basic.yieldDots(B[1235]) >>> for dot in gen: ... print(dot) ⠄ ⠄ ⠄ )rxryrN)r rzr#)brailleCharacterrs r& yieldDotsr/s/(""#34 < %. 5s11c $^/mSU4SjjnU(aUHqnUR5(aU"UR55 M0US:XaTR[S5 MPUS:XaU"S5 U"S5 MhU"U5 Ms S R T5$S nUGHnUR5(a"U(dTR[S 5 S nO6UR5(a!U(aTR[S5 S nUR5(a0TR[S5 U"UR55 MUR5(a-TR[R[U55 MUS:XaU"S5 U"S5 GMU"U5 GM S R T5$![a [ SUSUS3S -5ef=f![a [ SUSUS35ef=f)u| Transcribes a word to UTF-8 braille. >>> from music21.braille.basic import wordToBraille >>> print(wordToBraille('Andante')) ⠠⠁⠝⠙⠁⠝⠞⠑ Try the German for violin. >>> print(wordToBraille('Geige')) ⠠⠛⠑⠊⠛⠑ Tests number symbol at beginning, punctuation in number and switch back to letters. >>> print(wordToBraille('25.4cm')) ⠼⠃⠑⠲⠙⠰⠉⠍ c>U[;aTR[U5 g[R"U5nX:Xa[ SU-5eTR[S5 TR[U5 g)NzCannot translate ^)rr;r stripAccentsr ) inner_letterl2 wordTranss r& add_letter!wordToBraille..add_letterasi 8 #   Xl3 4)),7B!2\ABB   Xc] +   Xb\ *r]rrßsz Character 'z' in Text Expression 'z' rr5FrT letter_sign uppercasez ' in word '#' cannot be transcribed to braille.)rr^) isupperrr;r#r rr<isdigitisalphar numbersUpperr])rrrletterlastCharWasNumberrs @r&rrKs(I+ F~~6<<>*3  0433?v&!wwy!! ~~(9  !23$(!!!&7  !78$)!~~  !566<<>*!!  !4!4S[!AB4336"%2 779 C ?/%fX-CJ???8 'fX[ <_`  s,>G$B0G2AG2G21G2 G/2Hc V/nU(aUR[S5 U(a[RnO[Rn[ U5H!nURU[ U55 M# SRU5$![a [SUSUS35ef=f)u Transcribes a number to UTF-8 braille. By default, the result number occupies the upper two thirds of braille cells with a leading number sign. If withNumberSign is set to False, the leading number sign will be removed. If lower is set to True, the position will be changed from the upper (1245 dots) to the lower (2356 dots). >>> from music21.braille.basic import numberToBraille >>> print(numberToBraille(12)) ⠼⠁⠃ >>> print(numberToBraille(7)) ⠼⠛ >>> print(numberToBraille(37)) ⠼⠉⠛ rzDigit 'z ' in number 'rr5) r;r#r numbersLowerrr^r] ValueErrorrr<) sampleNumberrr numberTransnumbersdigits r&rrs K78,- %%%%\"    ws5z2 3# 77;   '% l^;^_  s B  B(c\rSrSrSrg)riNrw __module__ __qualname____firstlineno____static_attributes__rr]r&rrr]rc\rSrSrSrg)TestirNrrr]r&rrrr]r__main__)TT)F)Tr)r-z note.Note)r list[str])r-znote.GeneralNoterr)rztempo.TempoTextreturnr^)NNNNr )1T)rrr^rr^)o·)rr^rr^)TF)rr]rr^)>__doc__ __future__rtypingtunittestmusic21rrrrrr r r music21.brailler music21.commonr TYPE_CHECKINGrrrhr# Environmentr!r__annotations__rr'rVrDr|rrrrrr:r@rrr r!r+r7rDrUrrHrortrrrrMusic21ExceptionrTestCaserrwmainTestrr]r&rs:#! "&?? ??  ..&&z2  O (*@{|00fM*`!!H6DN,*^@L ood 7 3 b".hC%C CL6r&*XAJ |+~l^H$!N!#H(D!8M` F L99  8    z Tr]