rhHtR%SrSSKJr SSKJrJr SSKrSSKrSSKr SSK r SSK J r SSK J r SSK Jr SSK Jr SS K Jr SS K Jr SS K Jr SS K Jr SS K Jr SSK Jr SSK Jr SSK Jr SSK Jr SSK Jr SSK Jr SSKJr SSKJr SSKJr SSKJ r! SSKJ"r" SSK#J$r$ SSK%J&r& \RNr'\RP"S5r)"SS\RT5r+"SS\RX5r-S r.S r/S r0S!r1S"r2Sr3S#r4S$r5S%r6S&r7S r8\Rr\-Rt\.4\Rv\-Rt\/4\Rx\-Rt\04\Rz\-Rt\14\R|\-Rt\24\ R~\-R\34\R\-R\44\R\-R\54\R\-R\64\R\-R\74\R\-R\84/ rJS'\KS('\-RS)\-RS*\-RS+\-RS,\-RS-\-RtS.\-RS/\-RS00rNS1\KS2'\R\R\R\R/rSS3\KS4'"S5S6\ R5rUSSS7.rVS6\KS8'S9rWS&rXS:rY\"S;/S\ R5r\"S?S@\5r]"SASB\"R5r_"SCSD\_\"R5raSSESSSFSSGSESSESSGSESGSESH.SWSIjjrbSESGSSJ.SWSKjjrcSSFSL.SXSMjjrdSYSNjreSOrfSZSPjrgSQrhS[SRjriS\SSjrj"STSU\ R5rl\mSV:XaSSK r \ R"\l5 gg)]a Inner classes and functions for transcribing musical segments into braille. This module was made in consultation with the manual "Introduction to Braille Music Transcription, Second Edition" by Mary Turner De Garmo, 2005. It is available from the Library of Congress `here `_, and will henceforth be referred to as BMTM. ) annotations)deque namedtupleN)bar)base)chord)clef)dynamics) environment) exceptions21) expressionskey)layout)meter)note)spanner)stream)tempo)ProtoM21Object)basic)lookup) noteGrouping)text)BrailleTranscriptionHelper)opFracz segment.pyc\rSrSrSrg)BrailleSegmentException;N)__name__ __module__ __qualname____firstlineno____static_attributes__r Q/home/james-whalen/.local/lib/python3.13/site-packages/music21/braille/segment.pyrr;sr&rc8\rSrSrSrSrSrSrSrSr Sr S r S r S r g ) Affinity? r N)r!r"r#r$_LOWEST SIGNATURETTEXTMMARK LONG_TEXTEXPRINACCORDSPLIT1_NOTEGROUP NOTEGROUPSPLIT2_NOTEGROUPr%r r&r'r)r)?s1GI E EMHIr&r)r3r2r0r,r-z4list[tuple[type[base.Music21Object], Affinity, int]] affinityCodeszSignature GroupingzTempo Text GroupingzMetronome Mark GroupingzLong Text Expression GroupingzInaccord Groupingz Note GroupingzSplit Note Grouping AzSplit Note Grouping Bzdict[Affinity, str] affinityNameszlist[type[base.Music21Object]]excludeFromBrailleElementsc*\rSrSr%S\S'S\S'Srg)GroupingGlobalszzkey.KeySignature | None keySignaturezmeter.TimeSignature | None timeSignaturer N)r!r"r#r$__annotations__r%r r&r'rCrCzs''++r&rC)rErFGROUPING_GLOBALSc[Sc[R"S5[S'[Sc[R"S5[S'gg)z sets defaults for grouping globals. Called first time anything in Braille is run, but saves creating two expensive objects if never run rENrrF4/4)rHr KeySignaturer TimeSignaturer r&r'setGroupingGlobalsrMsK '/+.+;+;A+>((0,1,?,?,F)1r&0_ThreeDigitNumber)hundredstensonescN\rSrSr%SrS\S'SrS\S'SrS\S'SrS \S 'S r g) SegmentKeyrintmeasureordinalNzAffinity | Noneaffinityz str | Nonehandr ) r!r"r#r$rWrGrXrYrZr%r r&r'rTrTs*GSGS"Hm"D(r&rTcj\rSrSr%SrSSSSSSS .rS \S 'S rS rSr Sr Sr Sr SSjr SrSrg)BrailleElementGroupinga A BrailleElementGrouping mimics a list of objects which should be displayed without a space in braille. >>> from music21.braille import segment >>> bg = segment.BrailleElementGrouping() >>> bg.append(note.Note('C4')) >>> bg.append(note.Note('D4')) >>> bg.append(note.Rest()) >>> bg.append(note.Note('F4')) >>> bg , , , ]> >>> print(bg) These are the defaults, and they are shared across all objects. >>> bg.keySignature >>> bg.timeSignature >>> bg.descendingChords True >>> bg.showClefSigns False >>> bg.upperFirstInNoteFingering True >>> bg.withHyphen False >>> bg.numRepeats 0 zCThe last :class:`~music21.key.KeySignature` preceding the grouping.zFThe last :class:`~music21.meter.TimeSignature` preceding the grouping.zTrue if a :class:`~music21.chord.Chord` should be spelled from highest to lowest pitch in braille, False if the opposite is the case.zIf True, clef signs are shown in braille. Representation of music in braille is not dependent upon clefs and staves, so the clef signs would be displayed for referential or historical purposes.z4If True, this grouping will end with a music hyphen.z.The number of times this grouping is repeated.)rErFdescendingChords showClefSigns withHyphen numRepeatsdict[str, str] _DOC_ATTRc[U6Ul[5 [SUl[SUlSUlSUlSUlSUl SUl g)NrErFTFr) list internalListrMrHrErFr^r_upperFirstInNoteFingeringr`ra)self listElementss r'__init__BrailleElementGrouping.__init__sU ,/,^<-o> $")-&r&c,[UR5$N)iterrfrhs r'__iter__BrailleElementGrouping.__iter__D%%&&r&c URU$rmrfrhitems r' __getitem__"BrailleElementGrouping.__getitem__s  &&r&c X RU'grmrt)rhposrvs r' __setitem__"BrailleElementGrouping.__setitem__s!%#r&c,[UR5$rm)lenrfros r'__len__BrailleElementGrouping.__len__s4$$%%r&cPUS:Xa [S5e[URU5$)NrfzinternalList not defined yet)AttributeErrorgetattrrf)rhattrs r' __getattr__"BrailleElementGrouping.__getattr__s) > ! !?@ @t(($//r&cZ/nSnUHn[U[R5(anU(a%URS[R S35 UH8nURSR URR55 M: SnMURSR URR55 SnM URS:a"URSURS-S 35 URSLa%URS [R S 35 SR U5nU$![[4a UR[U55 GM"f=f![[4a UR[U55 Nf=f) zW Return a unicode braille representation of each object in the BrailleElementGrouping. Fzfull inaccord full_inaccord Trz** Grouping x r=z **z music hyphen music_hyphen) isinstancerVoiceappendrsymbolsjoin editorialbrailleEnglishr TypeErrorstrrar`)rh allObjectsprevious_was_voiceobjobj2outs r'__str__BrailleElementGrouping.__str__sq  #(C#v||,,%%%v~~o7V6W&XYD5"))$))DNN4Q4Q*RS &*"0%%dii 0L0L&MN&+" ??Q    t/B.C3G H ??d "    fnn^.L-MN Oii # +I65"))#d)445 ' 20%%c#h/0s$4E 4E= *E:9E:=*F*)F*c,[UR5$rm)reprrfros r' _reprInternal$BrailleElementGrouping._reprInternalrrr&)r^rfrErar_rFrgr`N)returnr)r!r"r#r$__doc__rcrGrjrprwr{rrrrr%r r&r'r\r\sZ(T^a?8 MF !I~  ''&&0 <'r&r\c ^\rSrSr%SSSSSSSS S S . rS \S 'S*S+U4SjjjrSrSrSr Sr Sr Sr Sr \S5rSrSrSrSrSrSrS,SjrSrS-SjrS.S jrS/S!jrS,S"jrS#rS$rS%rS&rS'r S(r!S)r"U=r#$)0BrailleSegmentizIf True, the previous key signature should be cancelled immediately before a new key signature is encountered.zFor a given positive integer n, adds n "dummy rests" near the beginning of a segment. Designed for test purposes, as they are used to demonstrate measure division at the end of braille lines.zzThe maximum amount of braille characters that should be present in a line. The standard is 40 characters.zwIf True, then a measure number is shown following the heading (if applicable) and preceding the music.zsIf set to "right" or "left", shows the corresponding hand sign at the beginning of the first line.zIf True, then a braille heading is displayed. See :meth:`~music21.braille.basic.transcribeHeading` for more details on headings.zIf True, then all octave marks are suppressed. Designed for test purposes, as octave marks were not presented until Chapter 7 of BMTM.a%If True, then the last :class:`~music21.braille.segment.BrailleElementGrouping` of this segment will be followed by a music hyphen. The last grouping is incomplete, because a segment break occurred in the middle of a measure.zIf True, then the initial measure number of this segment should be followed by a dot. This segment is starting in the middle of a measure.) cancelOutgoingKeySigdummyRestLength lineLengthshowFirstMeasureNumbershowHand showHeadingsuppressOctaveMarks endHyphenbeginsMidMeasurerbrcc>[TU]US9 0Ul[5UlSUlSUlSUlSUlSUl SUl SUl SUl SUl SUlSUlSUlSUlSUlg)a A segment is "a group of measures occupying more than one braille line." Music is divided into segments in order to "present the music to the reader in a meaningful manner and to give him convenient reference points to use in memorization" (BMTM, 71). >>> brailleSeg = braille.segment.BrailleSegment() >>> brailleSeg.cancelOutgoingKeySig True >>> brailleSeg.dummyRestLength >>> brailleSeg.lineLength 40 >>> brailleSeg.showFirstMeasureNumber True Possible showHand values are None, 'right', 'left': >>> brailleSeg.showHand is None True >>> brailleSeg.showHeading True >>> brailleSeg.suppressOctaveMarks False >>> brailleSeg.endHyphen False >>> brailleSeg.beginsMidMeasure False A BrailleSegment is a type of defaultdict that returns a BrailleElementGrouping when a key is missing. >>> len(brailleSeg.keys()) 0 >>> beg = brailleSeg[braille.segment.SegmentKey(4, 1, 9)] >>> type(beg) is braille.segment.BrailleElementGrouping True Of course, creating random keys like this will have consequences: >>> print(str(brailleSeg)) ---begin segment--- Measure 4, Note Grouping 2: === ---end segment--- rNFT)superrj _groupingDictrgroupingKeysToProcesscurrentGroupingKeypreviousGroupingKeylastNoter_rgr^rrrrrrrr)rhr __class__s r'rjBrailleSegment.__init__3sp J/GI8="3748 (, #(/3&&*$(!#&*# #(  %r&c X RU'grmr)rhrvvalues r'r{BrailleSegment.__setitem__s#(4 r&clXR;a[5URU'URU$rm)rr\rus r'rwBrailleSegment.__getitem__s2 )) )'='?D  t $!!$''r&c\XR;aURU g[SU<S35$)NzNo item z in Segment)__dict__r ValueErrorrus r' __delitem__BrailleSegment.__delitem__s. }} $""4( <= =r&c.[URU5$rm)rrrus r'rBrailleSegment.__getattr__st))400r&cXR;$rmrrus r' __contains__BrailleSegment.__contains__s))))r&c,[UR5$rm)rnrros r'rpBrailleSegment.__iter__sD&&''r&c,[UR5$rm)r~rros r'rBrailleSegment.__len__s4%%&&r&c@[RRU5$)z0 Returns the string from the BrailleText object )r BrailleTextrros r' brailleTextBrailleSegment.brailleTexts ''--r&c nSn[UR55n/n/n[5nUHupgUR[R :XaUnM(URSRUR[URURS-55 [U5nURU5 UnM SR[[X455V V s/sHupSRXS/5PM sn n 5n SRSUU S/5n U $![ a Nf=fs sn n f) Nz(zMeasure {0}, {1} {2}: r=rz ===z---begin segment---z---end segment---)sorteditemsrTrYr)r:rrformatrWr@rXrrrezip) rhnameallItemsallKeys allGroupingsprevKeyitemKeygroupinggStrkgallElementGroupingsrs r'rBrailleSegment.__str__s?9$**,' ,#+ W ##x'@'@@%GA NN4;;GOO=J7K[K[=\=D__q=PR Sx=D    %G$,#ii8%?"       !  & &  % % '    +    #' (((&*&@&@&H&H&JD ##66?? 8#5#55((*!X%7%77--/!X%;%;;224!X%6%66,,.!X^^3--/'+'>'>D $((("r&c~UH7n[RH n[X#5(dM[X#5 M" M9 g)z Removes temporary attributes from Music21Objects set during transcription. Run this only AFTER any possible re-transcription in extractNoteGrouping(). N)rTEMPORARY_ATTRIBUTEShasattrdelattr)rhrelkws r'_cleanupAttributes!BrailleSegment._cleanupAttributess. B002??BO1r&cUR[RS-/nURSR U55 g)u  Adds as many dummy rests as self.dummyRestLength to the signatures of brailleText >>> seg = braille.segment.BrailleSegment() >>> seg.dummyRestLength = 4 >>> print(braille.lookup.rests['dummy']) ⠄ >>> seg.addDummyRests() >>> print(seg.brailleText) ⠄⠄⠄⠄ dummyrN)rrrests addSignaturesr)rh dummyRestss r'rBrailleSegment.addDummyRestss7**V\\'-BBC  277:./r&cUR=(d" [[UR555nUSnURn[ R "U5nUR(a U[S- nURU5 g)us Adds a measure number from the segmentKey needing processing >>> segKey = braille.segment.SegmentKey(measure=4, ordinal=1, affinity=9) >>> seg = braille.segment.BrailleSegment() Initialize a new Key >>> type(seg[segKey]) >>> seg.extractMeasureNumber() >>> print(seg.brailleText) ⠼⠙ Add a dot to the measure number if the segment begins mid-measure >>> seg = braille.segment.BrailleSegment() >>> seg[segKey] >>> seg.beginsMidMeasure = True >>> seg.extractMeasureNumber() >>> print(seg.brailleText) ⠼⠙⠄ rdotN) rrrrrWrnumberToBraillerraddMeasureNumber)rhgkpfirstSegmentKeyinitMeasureNumber brailleNumbers r'r#BrailleSegment.extractMeasureNumberso4((FE&2E,Fa&+33--.?@  WU^ +M m,r&cSnSnSnSnUR=(d" [[UR555nU(aUSR[ R :aOUR5nURnURRU5nU[ R:XaR[U5S:a USUSp!Ol[U5S:Xa)USn [U [R5(aU nO6U nO3U[ R:XaUSnOU[ R :XaUSnU(aM[!XX4/5(a4["R$"UUUUUR&S9n UR)U 5 gg)z Extract a :class:`~music21.key.KeySignature`, :class:`~music21.meter.TimeSignature, :class:`~music21.tempo.TempoText` and :class:`~music21.tempo.MetronomeMark` and add an appropriate braille heading to the brailleText object inputted. Nrr>r= maxLineLength)rrrrrYr)r7rrgetr5r~rrrKr6anyrtranscribeHeadingr addHeading) rhrErF tempoText metronomeMarkrcgkrcurrentBrailleGrouping keyOrTimeSigbrailleHeadings r'rBrailleSegment.extractHeading'sk     !% : : XeF499;DW>X#$Q'008>>A'//1C"|| %)%7%7%;%;C%@ "8#5#55-.!33I!3L3I!3L#0/0A5#9!#'>? $(  "+ ,dii88. 0&,,??!!%7$88_"`a12DEL##Ay1 ,5,F,FL ))2)@)@L &5>5X5XL 2:Dgo6"O u;;LI IO   _ -J!#,r&cURnURRU5nUSn[R"U5nUR U5 g)z^ Extract the Long Expression that is in the ElementGrouping in cgk and add it to brailleText. rN)rrrrtextExpressionToBrailleaddLongExpression)rhrcurrentElementGroupinglongTextExpressionlongExprInBrailles r'r,BrailleSegment.extractLongExpressionGroupingpsR %%!%!3!3!7!7!<3A6!99:LM 01r&cURnURnUbUbUR[R:wdoUR[R:wdQUR UR :Xa>UR UR S-:Xa!URUR:XaSUlUR(agUVs/sH&n[U[R5(dM$UPM( nnSnU(a=URb&USn[R"URU5nUSUlU$s snf)aV Given a noteGrouping, should we show the octave symbol? >>> n1 = note.Note('C1') >>> n2 = note.Note('D1') >>> n3 = note.Note('E1') >>> beg1 = braille.segment.BrailleElementGrouping([n1, n2, n3]) >>> bs1 = braille.segment.BrailleSegment() This is True because last note is None >>> bs1.lastNote is None True >>> bs1.showLeadingOctaveFromNoteGrouping(beg1) True But if we run it again, now we have a note within a fourth, so we do not need to show the octave: >>> bs1.lastNote >>> bs1.showLeadingOctaveFromNoteGrouping(beg1) False And that is true no matter how many times we call it on the same BrailleElementGrouping: >>> bs1.showLeadingOctaveFromNoteGrouping(beg1) False But if we give a new, much higher BrailleElementGrouping, we will see octave marks again. >>> nHigh1 = note.Note('C6') >>> nHigh2 = note.Note('D6') >>> beg2 = braille.segment.BrailleElementGrouping([nHigh1, nHigh2]) >>> bs1.showLeadingOctaveFromNoteGrouping(beg2) True But if we set `self.suppressOctaveMarks` to True, we won't see any when we switch back to beg1: >>> bs1.suppressOctaveMarks = True >>> bs1.showLeadingOctaveFromNoteGrouping(beg2) False We also show octaves if for some reason two noteGroups in the same measure have different BrailleElementGroupings keyed to consecutive ordinals. The code simulates that situation. >>> bs1.suppressOctaveMarks = False >>> bs1.previousGroupingKey = braille.segment.SegmentKey(measure=3, ordinal=1, ... affinity=braille.segment.Affinity.NOTEGROUP) >>> bs1.currentGroupingKey = braille.segment.SegmentKey(measure=3, ordinal=2, ... affinity=braille.segment.Affinity.NOTEGROUP) >>> bs1.showLeadingOctaveFromNoteGrouping(beg2) True >>> bs1.showLeadingOctaveFromNoteGrouping(beg1) True >>> bs1.showLeadingOctaveFromNoteGrouping(beg1) True Nr=FTrr+)rrrYr)r;rWrXrZrrrrNotershowOctaveWithNote)rhr currentKey previousKeynallNotesshowLeadingOctave firstNotes r'!showLeadingOctaveFromNoteGrouping0BrailleSegment.showLeadingOctaveFromNoteGrouping{sD,, ..  #*$$(:(::&&(*<*<<&&+*=*=="**k.A.AA.EE";+;+;; $  # # ,H|!z!TYY/GA|H  }}($QK $)$<$>> n1 = note.Note('C1') >>> n2 = note.Note('D1') >>> n3 = note.Note('E1') >>> beg1 = braille.segment.BrailleElementGrouping([n1, n2, n3]) >>> seg = braille.segment.BrailleSegment() >>> seg.needsSplitToFit(beg1) False >>> seg.lineLength = 10 >>> seg.needsSplitToFit(beg1) True r-TF)r currentLine textLocationr~)rhbrailleNoteGroupingquarterLineLength spaceLefts r'needsSplitToFitBrailleSegment.needsSplitToFitsH&!OOq0OOd&6&6&C&CC  )+,/@@r&c[R"5nSnSnSupxSn XV:aP[UUS9upxX$lSUlUR U5n UR RXS9(aOUS- nMUUR(+n XlUR U5n URn U R[RS 9n U R[RS 9nXpU 'XU'X4$) zh Take a noteGrouping and split it at a logical place, returning braille transcriptions of each section. rr3NNN)beatDivisionOffsetTaddSpacer=rY)rNoteGroupingTranscribersplitNoteGroupingr0r`transcribeGroupr5 canAppendrr_replacer)r:r<)rhrshowLeadingOctaveOnFirstaddSpaceToFirst transcriberr>REASONABLE_LIMITsplitNoteGroupAsplitNoteGroupBbrailleNoteGroupingAr0brailleNoteGroupingBr,aKeybKeys r'splitNoteGroupingAndTranscribe-BrailleSegment.splitNoteGroupingAndTranscribes 335 -9*# 31B#52 ._-E ))-O &#.#>#>#O ))*>)Y ! #   $ 8 88(9%*::?K,, ""H,E,E"F""H,E,E"F$T $T $;;r&cZ[R"5nURc [S5eURURnUR U5nX1lURU5nURU5nURRXES9(aURRXES9 OURU5nU(a@URUUU5upxURRXuS9 URU5 U(dWUSLa'UR SLaSUlURU5nURR#5 URU5 UR%UR&5 UR)U5 g![a SnNf=f)zN Fundamentally important method that adds a noteGrouping to the braille line. Nz?currentGroupingKey must not be None to call extractNoteGroupingr?FT)rrBrrrr2r0rD!optionalAddKeyboardSymbolsAndDotsr5rErr:rQ addToNewLinerrlastHyphenToSpaceaddRepeatSymbolsrar) rhrIrr0r7r@ should_splitbngAbngBs r'r"BrailleSegment.extractNoteGrouping$s335  " " *^_ _))$*A*AB  BB<P(9%)99,G99:MN    % %&9 % M    # #$7 # K!%!5!56I!JL )!%!D!D\ARAI"KJD$$++D+D%%d+ %-$2J2Je2S59K1*5*E*El*S'  224!!"56 l556  --/)$)L)s?F F*)F*cSUs=:aS:a.O O+[U5HnUR[S5 M gUS:a7UR[S[R"U5-5 SUlgg)u. Adds the appropriate number of repeat symbols, following DeGarmo chapter 17. >>> seg = braille.segment.BrailleSegment() >>> seg.addRepeatSymbols(0) >>> print(seg.brailleText) >>> seg.addRepeatSymbols(1) >>> print(seg.brailleText) ⠶ >>> seg = braille.segment.BrailleSegment() >>> seg.addRepeatSymbols(2) >>> print(seg.brailleText) ⠶⠀⠶ >>> seg = braille.segment.BrailleSegment() >>> seg.addRepeatSymbols(3) >>> print(seg.brailleText) ⠶⠼⠉ Does not yet handle situations beginning with Example 17-6 (repeats at different octaves), and further rr,repeatN)rangerrrrr)rh repeatTimesunused_repeatCounters r'rWBrailleSegment.addRepeatSymbolsYsk0 { Q (-k(:$""78#45); A    wx053H3H3UU V DMr&cSnSnURnURRU5n[U5S:a USUSp!O[[U5S:XaLURRUR5Sn[ U[ R 5(aUnOUnSnUR(aUb URn[R"XU5nUS:waURU5 gg![a Nrr=r) rrrr~rrrKroutgoingKeySigrrtranscribeSignaturesr)rhrErFrrrrc brailleSigs r'r'BrailleSegment.extractSignatureGroupingys   %%))--c2 |  !*6q/<?-  ! #--11$2I2IJ1ML,(8(899+ ,   $ $)A !-!>> SK = braille.segment.SegmentKey >>> BS1 = braille.segment.BrailleSegment() >>> BS1[SK(ordinal=0, affinity=2)] = ['hi', 'hello', 'there'] >>> BS1[SK(ordinal=1, affinity=9)] = ['these', 'get'] >>> BS1[SK(ordinal=2, affinity=9)] = ['put', 'together'] >>> BS1[SK(ordinal=3, affinity=4)] = ['in', 'new', 'group'] >>> BS1[SK(ordinal=4, affinity=9)] = ['with', 'the', 'previous'] >>> BS2 = BS1.consolidate() >>> for (groupingKey, groupingList) in sorted(BS2.items()): ... print(groupingKey, groupingList) SegmentKey(measure=0, ordinal=0, affinity=2, hand=None) ['hi', 'hello', 'there'] SegmentKey(measure=0, ordinal=1, affinity=9, hand=None) these get put together SegmentKey(measure=0, ordinal=3, affinity=4, hand=None) ['in', 'new', 'group'] SegmentKey(measure=0, ordinal=4, affinity=9, hand=None) with the previous N)rrrrrYr)r;r)rh newSegmentpngKey groupingKey groupingListrvs r' consolidateBrailleSegment.consolidates~4$DOO4 +1$**,+? '[##x'9'99*6;'>(F(D&--d3),@r&cb[R"S5n[R"S5n[ UR 55nSupEUGHupgUbUR S:aSUlUR S:XaUR[R:XaUR S:Xa{UR[R:Xa][US[R5(a[USSU5nO [XW5nU(aU=RS- slX MUR[R :XaWUHOn [U [R5(aU nM&[U [R5(dMGXlU nMQ GO2UR[R$[R4;Ga[US[R5(as[US[R&[R(45(aSUlO9[US[R,[R.45(aSUlUV s/sH&n [U [0R25(dM$U PM( n n [5U 5S:Xa,[U S[0R65(a SU SlXlX'lUR*UlUR>UlUR@Ul XgpTGM URB(aSUlggs sn f)a Modifies the attributes of all :class:`~music21.braille.segment.BrailleElementGrouping` instances in a list of :class:`~music21.braille.segment.BrailleSegment` instances. The necessary information is retrieved from the segment and from the found clef, if any. rrJr=Nr=TF)"rrKrrLrrrXr`rYr)r;rr rareGroupingsIdenticalrar5rcr9 TrebleClefAltoClefr^BassClef TenorClefr GeneralNoter~Rest fullMeasurerErFr_rgr) rh currentKeySigcurrentTimeSigrr- previousListrmrn isRepetitionbrailleElementr.allGeneralNotess r'addGroupingAttributes$BrailleSegment.addGroupingAttributess~ ((+ ,,U3djjl+ &2#+7 '[&&&!+.2L+''1,'00H4F4FF'//14'00H4F4FF!,q/499=='<\!"=M|'\ '<\'X #$//14/ - ##x'9'99&2N!.%2E2EFF)7#NC4D4DEE8E5(6 '3 %%(*;*;X=O=O)PPl1otyy99!,q/DOOT]]3STT04-#LOdmmT^^5TUU05-/;"^ljDL\L\>]1l"^'1,OA>&*L # #_s "#L, L,c 8^ SSKJm U 4SjnUR5nUR5Vs/sH'nUR[ R :XdM#X#PM) nnUHnUVs/sH&n[U[R5(dM$UPM( nn[[U55H]nXxn U RHFn [U T R5(a[U T R5(dM;U"U U UU5 MH M_ M gs snfs snf)a\ Goes through each :class:`~music21.braille.segment.BrailleSegment` and modifies the list of :attr:`~music21.note.GeneralNote.articulations` of a :class:`~music21.note.Note` if appropriate. In particular, two rules are applied: * Doubling rule => If four or more of the same :class:`~music21.articulations.Articulation` are found in a row, the first instance of the articulation is doubled and the rest are omitted. It is permissible (not mandatory) to observe this doubling with bowings. (BMTM, 114) For this reason, any :class:`~music21.articulations.TechnicalIndication` but for bowings (e.g. fingering, harmonic) is skipped, because it does not braille as an articulation. * Staccato, Tenuto rule => "If two repeated notes appear to be tied, but either is marked staccato or tenuto, they are treated as slurred instead of tied." (BMTM, 112) r) articulationsc>URn[UT RT R45(aZURbMURR S:XaSX#S- lSX#S- lOSX#S-lSUlSUlSn[US-[U55H7nX&nXGRVs/sHoRPM sn;aUS- nM7 O US:agURRU5 [US-X5-5HGnX&nURH0n U RU:XdMURRU 5 M2 MI gs snf)Nstopr=Trr,) rrStaccatoTenutotietype shortSlurr^r~rrremove) articmusic21NoteStartr/noteIndexStart articName numSequentialnoteIndexContinuemusic21NoteContinueaartOtherrs r'fixOneArticulation;BrailleSegment.fixArticulations..fixOneArticulationsg I5=#9#9=;O;O"PQQ(,,8#'',,67;Ha/04=AHa/0:7;Ha/0415$.'+ $M%*>A+=s8}%M!&.&A#1R1R S1RA1R SS!Q&M &N q   * * 1 1% 8%*>A+=+9+I&K!&.&A# 3 A AH}} 1+99@@J!B&K!Ts>E#N)music21rrorrYr)r;rrr*r^r~TechnicalIndicationBowing) rhrrkgpKey noteGroupingsrr.allNotes_outernoteIndexStart_outermusic21NoteStart_outer artic_outerrs @r'fixArticulationsBrailleSegment.fixArticulationss" * K<%%' *4//*;I*;#(>>X5G5G#G+**; I*L)5RAAtyy9QaNR(-c..A(B$)7)M #G#GK&{M4U4UVV)+}7K7KLL*'2*0 $H)C*ISs"DD)#DD)rrrrr^rrrrrr_rrrrrg(rrV)rNone)rr\)rbool)FF)$r!r"r#r$rcrGrjr{rwrrrrprpropertyrrrrrrrrrr2r:rQrrWrrrorrr% __classcell__)rs@r'rrs!UZF#SB2 -?  1*('.. <( T$0"!-F-,`2 2_!B:AF7<+$%N5+nAAr&rcT\rSrSrSrS S Sjjr\S5rSrSr Sr Sr S r S r g )BrailleGrandSegmentiDz A BrailleGrandSegment represents a pair of segments (rightSegment, leftSegment) representing the right and left hands of a piano staff (or other two-staff object). >>> bgs = braille.segment.BrailleGrandSegment(lineLength=36) >>> bgs.lineLength 36 c[RXS9 [RRXS9 [ 5UlSUlSUlg)Nr)rrjrBrailleKeyboardr allKeyPairspreviousGroupingPaircurrentGroupingPair)rhrs r'rjBrailleGrandSegment.__init__MsG< %%d%B:?' $(!#' r&c@[RRU5$rm)rrrros r'rBrailleGrandSegment.brailleTextUs##++D11r&cSn/nUR5GHup4UbrSRUR[URUR S-5n[ URRU55nSRXV/5nOSnUbrSRUR[URUR S-5n[ URRU55n SRX/5n OSn URSRXzS/55 GM SRSUSRU5S /5n U $) Nz1 ===zMeasure {0} Right, {1} {2}: r=rz Measure {0} Left, {1} {2}: rz==== z---begin grand segment---z---end grand segment---) yieldCombinedGroupingKeysrrWr@rYrXrrrrr) rhrallPairsrightKeyleftKey rightHeading rightContents rightFull leftHeading leftContentsleftFullrs r'rBrailleGrandSegment.__str__Ys>C#'#A#A#C X#>EE$$mH4E4E&FHXHX[\H\ ^ #D$6$6$:$:8$D E GG\$AB  ">EEOO]73C3C%DgooXYFY[ "4#5#5#9#9'#BC 77K#>? OODIIyH&EF G$D ii4dBGGH>> bgs = braille.segment.BrailleGrandSegment() >>> SegmentKey = braille.segment.SegmentKey # namedtuple >>> bgs[SegmentKey(1, 1, 1, 'right')] = '1r' >>> bgs[SegmentKey(1, 1, 1, 'left')] = '1l' >>> bgs[SegmentKey(1, 2, 3, 'right')] = '2r' >>> bgs[SegmentKey(1, 2, 4, 'left')] = '3l' >>> bgs[SegmentKey(2, 1, 9, 'left')] = '4l' >>> bgs[SegmentKey(2, 1, 9, 'right')] = '4r' >>> bgs[SegmentKey(3, 1, 9, 'right')] = '5r' >>> for l, r in bgs.yieldCombinedGroupingKeys(): ... (bgs[l], bgs[r]) ('1r', '1l') ('2r', ) (, '3l') ('4r', '4l') ('5r', ) Known Bug: Because this puts `None` elements into the defaultDict, it makes the assumption that all of .keys() will be SegmentKeys incorrect. In fact, if you run this method twice, the second time it will crash. ctURS:XaSnOSnURURURU4$)zD sort by measure, then ordinal, then affinity, then hand (r then l) rightr+r=)rZrWrXrY) segmentKeyskHs r'segmentKeySortKeyHBrailleGrandSegment.yieldCombinedGroupingKeys..segmentKeySortKeys<')&& (:(:J.matchOthersD%%)9)99%--1A1AA%..(2C2CCr&NrrrAleft)rrrZrYr)r;rFr9)rhrr storedRight storedLeftthisKeys r'r-BrailleGrandSegment.yieldCombinedGroupingKeyspsB> V   diik/@AG||w&)!'66&33!**h.@.@@()9)98CTCT)9)UWabb '33#Z00&- !%J")K'*!'77*44$--0A0AA*D11#Wo-*D11%, "&K!(J9B< % % $ $ s B7D,=A/D,c[UR55UlURSnUS(aUSROUSRn[ [ U55UlUR5 SUlUR(aURUl URR5UlURup4UbUR[R:d!Ub.UR[R:aUR5 UR(aMUR$)z9 Returns the BrailleText from the combined grouping keys r+rr=N)rrrrWr~rhighestMeasureNumberLengthrrrrrYr)r9rr)rhlastPairhighestMeasurerrs r'rBrailleGrandSegment.transcribes!!?!?!AB##B'08 !,,!ATAT*-c..A*B' #' (,(@(@D %'+'7'7'?'?'AD $"&":": X%(*;*;x?P?P*P+0@0@HDUDU0U((* r&cSnSnSnSnUR(aURSupVUnURRU5nUR [ R:aOURR5 UR [ R:Xa USUSp!OGUR [ R:XaUSnO#UR [ R:XaUSnUR(aM[R "UUUUUR"S9n UR%U 5 g![a=n U RSS:Xa#URRU5nUnSn A GN1U eSn A ff=f![a. [U[R5(aUSnNUSnNf=f![R&an U RSS:waU eSn A gSn A ff=f)z} Finds KeySignatures, TimeSignatures, TempoText, and Metronome Marks within the keyPairs, and removes some from allKeyPairs. Nrrr=rzNo heading can be made.)rrrKeyErrorargsrYr)r7rr5 IndexErrorrrrKr6rr rr BrailleBasicException) rhrErFr r rruseKey useElementkerbbes r'r"BrailleGrandSegment.extractHeadings     "&"2"21"5 XF !//33H= /    $ $ &("4"4462.>??'1!} (21 6&** xx{77 8 sMD:! F3F?: F0E<:E<<F.F<4F<;F<?G2G--G2c^TRupU(a URnOU(a URnO [S5e[R"USS9nU4SjnU"U5nU"U5nTR XFU5 g)Nz/Measure must be defined for leftKey or rightKeyF)withNumberSignc>UbUR[R:XaTRR U5n/nUHn[ U[ R5(dM$[U5nURUl URUl URUl UR[R"U55 TRU5 M [ SR#U5nU$UbDTRR U5n[R"U5nTRU5 U$SnU$)Nrr)rYr)r9rrrrrrr^r_rgrrrrrr)rightOrLeftKeyr voice_trans music21Voicer brailleStrrhs r'brailleFromKey?BrailleGrandSegment.extractNoteGrouping..brailleFromKeyNs )n.E.EIZIZ.Z ..22>B  $-L%lFLLAA #9,#GL4=4N4NL11:1H1HL.=F=`=`L:&&u'C'CL'QR++L9%.%_5::;G   +#1155nE "99,G '' 5   r&)rrWrrraddNoteGroupings)rhrrmNumcurrentMeasureNumberr rhBraille lhBrailles` r'r'BrailleGrandSegment.extractNoteGroupingCsv"66 ##D ??DNO O$44T%P 0#8, "7+  2yIr&)rrrrNrr)r!r"r#r$rrjrrrrrrrr%r r&r'rrDs=(22.T%H :0d&Jr&rTrF)setHandrr^rr segmentBreaksr_rrrshowLongSlursAndTiesTogethershowShortSlursAndTiesTogetherslurLongPhraseWithBracketsrrgc[UU U U S9 [XUS9nUHbnUUlUUlUUlUR 5 UUlUUlUUlU Ul U Ul UUl UR5 Md U$)uH Takes in a :class:`~music21.stream.Part`. Returns a list of :class:`~music21.segment.BrailleSegment` instances. Five functions or methods get called in the generation of segments: * :func:`~music21.braille.segment.prepareSlurredNotes` * :func:`~music21.braille.segment.getRawSegments` * :meth:`~music21.braille.segment.BrailleSegment.addGroupingAttributes` * :meth:`~music21.braille.segment.BrailleSegment.addSegmentAttributes` * :meth:`~music21.braille.segment.BrailleSegment.fixArticulations` >>> from music21.braille import test >>> example = test.example11_2() >>> allSegments = braille.segment.findSegments(example) >>> print(str(allSegments[0])) ---begin segment--- Measure 0, Signature Grouping 1: === Measure 0, Note Grouping 1: === Measure 1, Note Grouping 1: === Measure 2, Note Grouping 1: === Measure 3, Note Grouping 1: === Measure 4, Note Grouping 1: === Measure 5, Note Grouping 1: === Measure 6, Note Grouping 1: === Measure 7, Note Grouping 1: === Measure 8, Note Grouping 1: music hyphen ⠐ === ---end segment--- Second segment >>> print(str(allSegments[1])) ---begin segment--- Measure 8, Note Grouping 2: === Measure 9, Note Grouping 1: === Measure 10, Note Grouping 1: === Measure 11, Note Grouping 1: === Measure 12, Note Grouping 1: === Measure 13, Note Grouping 1: === Measure 14, Note Grouping 1: === Measure 15, Note Grouping 1: === Measure 16, Note Grouping 1: === Measure 17, Note Grouping 1: === ---end segment--- )rrrrr) prepareSlurredNotesgetRawSegmentsr_rgr^rrrrrrrr) music21Partrrr^rrrr_rrrrrrrrg allSegmentssegs r' findSegmentsr{sl 5Q6S3M!][K*(A%/ !!#$8 -%;" %"5 '* r&)rrrc@UR(dgUcUnUR5RR5nURR [ R 5GHnUR5nUR5nURU5nURU5n [X- 5S-n U(djU [::a`XHRb!XHRRS:XaUS- nXIRb!XIRRS:XaU S-n U(djU [:a`XHRb!XHRRS:XaUS- nXIRb!XIRRS:XaU S-n U [::a[!X5H n SXKlM GMaU(aSXHlSXIlGM}SXHS-lSXIS- lGM g![Ra GMf=f)a Takes in a :class:`~music21.stream.Part` and three keywords: * slurLongPhraseWithBrackets * showShortSlursAndTiesTogether * showLongSlursAndTiesTogether For any slurs present in the Part, the appropriate notes are labeled with attributes indicating where to put the symbols that represent slurring in braille. For purposes of slurring in braille, there is a distinction between short and long phrases. In a short phrase, a slur covers up to four notes. A short slur symbol should follow each note except the last. >>> import copy >>> from music21.braille import segment >>> short = converter.parse('tinynotation: 3/4 c4 d e') >>> s1 = spanner.Slur(short.recurse().notes.first(), short.recurse().notes.last()) >>> short.append(s1) >>> short.show('text') {0.0} {0.0} {0.0} {0.0} {1.0} {2.0} {3.0} {3.0} > >>> shortA = copy.deepcopy(short) >>> segment.prepareSlurredNotes(shortA) >>> shortA.recurse().notes[0].shortSlur True >>> shortA.recurse().notes[1].shortSlur True In a long phrase, a slur covers more than four notes. There are two options for slurring long phrases. The first is by using the bracket slur. By default, slurLongPhraseWithBrackets is True. The opening bracket sign is put before the first note, and the closing bracket sign is put before the last note. >>> long = converter.parse('tinynotation: 3/4 c8 d e f g a') >>> s2 = spanner.Slur(long[note.Note].first(), long[note.Note].last()) >>> long.append(s2) >>> long.show('text') {0.0} {0.0} {0.0} {0.0} {0.5} {1.0} {1.5} {2.0} {2.5} {3.0} {3.0} > >>> longA = copy.deepcopy(long) >>> segment.prepareSlurredNotes(longA) >>> longA[note.Note].first().beginLongBracketSlur True >>> longA[note.Note].last().endLongBracketSlur True The other way is by using the double slur, setting `slurLongPhraseWithBrackets` to False. The opening sign of the double slur is put after the first note (i.e. before the second note) and the closing sign is put before the last note (i.e. before the second to last note). If a value is not supplied for `showLongSlursAndTiesTogether`, it will take the value set for `slurLongPhraseWithBrackets`, which defaults True. >>> longB = copy.deepcopy(long) >>> segment.prepareSlurredNotes(longB, slurLongPhraseWithBrackets=False) >>> longB.recurse().notes[1].beginLongDoubleSlur True >>> longB.recurse().notes[-2].endLongDoubleSlur True In the event that slurs and ties are shown together in print, the slur is redundant. Examples are shown for slurring a short phrase; the process is identical for slurring a long phrase. Below, a tie has been added between the first two notes of the short phrase defined above. If showShortSlursAndTiesTogether is set to its default value of False, then the slur on either side of the phrase is reduced by the amount that ties are present, as shown below. >>> short.recurse().notes[0].tie = tie.Tie('start') >>> shortB = copy.deepcopy(short) >>> segment.prepareSlurredNotes(shortB) >>> shortB.recurse().notes[0].shortSlur Traceback (most recent call last): AttributeError: 'Note' object has no attribute 'shortSlur' >>> shortB.recurse().notes[0].tie >>> shortB.recurse().notes[1].shortSlur True If showShortSlursAndTiesTogether is set to True, then the slurs and ties are shown together (i.e. the note has both a shortSlur and a tie). >>> shortC = copy.deepcopy(short) >>> segment.prepareSlurredNotes(shortC, showShortSlursAndTiesTogether=True) >>> shortC.recurse().notes[0].shortSlur True >>> shortC.recurse().notes[0].tie TODO: This should not add attributes to Note objects but instead return a collection of sets of notes that have each element applied to it. Nr=startrT) spannerBundleflattennotesr getByClassrSlurgetFirstgetLastindexr StreamExceptionabsSEGMENT_MAXNOTESFORSHORTSLURrrr^rbeginLongBracketSlurendLongBracketSlurbeginLongDoubleSlurendLongDoubleSlur) rrrrr/slurr1r beginIndexendIndexdelta noteIndexs r'rr3s|  $ $#+'A$""$**113H))44W\\BMMO <<> ! 2J~~h/HH)*Q.,:V1V$((4 ,0055@a !%%1h6H6L6L6Q6QU[6[A +8T0T$((4 ,0055@a !%%1h6H6L6L6Q6QU[6[A  0 0":8 04#-9*<@$98<"5?Ca(<;?A&8QC++    s"HHHrc`/n[US9nSnSnUR[R5GHn[ U5 [ U5nSn [ Rn UGHn U(adU RS:waSUl URU5 [US9nU RS:waSUl SnU [ RLaU S- n SnSU R;a%SU R;a U[::aOUS:aSnM[U [R 5(aU[:aU R"S ;aSnU R$R&U :aU S- n U R$R&n U [ R(:Xa[ R*n O$U [ R,:Xa[ R.n [1UR2U U U5n X;a [55XM'XMnURU 5 US- nU R$R&n GM GM URU5 U$) a Takes in a :class:`~music21.stream.Part`, divides it up into segments (i.e. instances of :class:`~music21.braille.segment.BrailleSegment`). This function assumes that the Part is already divided up into measures (see :class:`~music21.stream.Measure`). An acceptable input is shown below. This will automatically find appropriate segment breaks at :class:`~music21.braille.objects.BrailleSegmentDivision` or :class:`~music21.braille.objects.BrailleOptionalSegmentDivision` or after 48 elements if a double bar or repeat sign is encountered. Two functions are called for each measure during the creation of segments: * :func:`~music21.braille.segment.prepareBeamedNotes` * :func:`~music21.braille.segment.extractBrailleElements` >>> tn = converter.parse("tinynotation: 3/4 c4 c c e e e g g g c'2.") >>> tn = tn.makeNotation(cautionaryNotImmediateRepeat=False) >>> tn.show('text') {0.0} {0.0} {0.0} {0.0} {1.0} {2.0} {3.0} {0.0} {1.0} {2.0} {6.0} {0.0} {1.0} {2.0} {9.0} {0.0} {3.0} By default, there is no break anywhere within the Part, and a segmentList of size 1 is returned. >>> import copy >>> from music21.braille import segment >>> tnA = copy.deepcopy(tn) >>> rawSegments = segment.getRawSegments(tnA) >>> len(rawSegments) 1 >>> rawSegments[0] >>> print(rawSegments[0]) ---begin segment--- Measure 1, Signature Grouping 1: === Measure 1, Note Grouping 1: === Measure 2, Note Grouping 1: === Measure 3, Note Grouping 1: === Measure 4, Note Grouping 1: === ---end segment--- Now, a segment break occurs at measure 2, offset 1.0 within that measure. The two segments are shown below. >>> tnB = copy.deepcopy(tn) >>> tnB.measure(2).insert(1.0, braille.objects.BrailleSegmentDivision()) >>> allSegments = segment.getRawSegments(tnB) >>> len(allSegments) 2 >>> allSegments[0] >>> print(allSegments[0]) ---begin segment--- Measure 1, Signature Grouping 1: === Measure 1, Note Grouping 1: === Measure 2, Note Grouping 1: === ---end segment--- >>> allSegments[1] >>> print(allSegments[1]) ---begin segment--- Measure 2, Note Grouping 2: === Measure 3, Note Grouping 1: === Measure 4, Note Grouping 1: === ---end segment--- If we insert an optional division, the division only appears if there are 48 elements in the current segment: >>> tnC = copy.deepcopy(tn) >>> tnC.measure(1).insert(1.0, braille.objects.BrailleOptionalSegmentDivision()) >>> allSegments = segment.getRawSegments(tnC) >>> len(allSegments) 1 If by happenstance a segment division object is encountered where a division has just been created (or the very beginning), no unnecessary empty segment will be created: >>> tnD = copy.deepcopy(tn) >>> tnD.measure(1).insert(0, braille.objects.BrailleSegmentDivision()) >>> allSegments = segment.getRawSegments(tnD) >>> len(allSegments) 1 rrFTr=BrailleSegmentDivisionBrailleOptionalSegmentDivision)doublefinal)rgetElementsByClassrMeasureprepareBeamedNotesrr)r4offsetrrrclassesMAX_ELEMENTS_IN_SEGMENTrrBarlinerr affinityCoder:r9r<r;rTnumberr\)rrrrcurrentSegmentelementsInCurrentSegmentstartANewSegmentmusic21MeasurebrailleElementsrXpreviousAffinityCoder~rrbrailleElementGroupings r'rrspK#}=N$%"%88H>*0@'//-N!((C/04N,"">2!/=!I!((C/6:N3+,('x/?/??qLG#( '>+A+AA48N8NN48OO-1'+$>3;;77,/FF"''+>>$( ''447KK1 )33@@Lx888'00 !:!::'11 #N$9$9$+$0$+&J /-C-E*%3%? " " ) ). 9 $ ) $$2#;#;#H#H w. ID~& r&c <[5nSnUGH n[U[R5(aUnM'[U[R 5(aUR S:XaMY[U5 Ub[U[R[R45(a^[U5 URRURl [U5/URlUR!U5 SnUR!U5 [U5/URlGM# UR-SS9 [/U5S:a^[US[0R25(a<[US[R 5(aSUSlUR-SS9 U$!["a^n[$Vs/sHn[X55PM Os snfnn['U5(d[(R+U5 SnAGMSnAGMSnAff=f) a Takes in a :class:`~music21.stream.Measure` or :class:`~music21.stream.Voice` and returns a :class:`~music21.braille.segment.BrailleElementGrouping` of correctly ordered :class:`~music21.base.Music21Object` instances which can be directly transcribed to braille. >>> from music21.braille import segment >>> tn = converter.parse('tinynotation: 2/4 c16 c c c d d d d', makeNotation=False) >>> tn = tn.makeNotation(cautionaryNotImmediateRepeat=False) >>> measure = tn[0] >>> measure.append(spanner.Slur(measure.notes[0],measure.notes[-1])) >>> measure.show('text') {0.0} {0.0} {0.0} {0.25} {0.5} {0.75} {1.0} {1.25} {1.5} {1.75} {2.0} > {2.0} Spanners are dealt with in :func:`~music21.braille.segment.prepareSlurredNotes`, so they are not returned by this function, as seen below. >>> print(segment.extractBrailleElements(measure)) Nregularc2URUR4$rmrclassSortOrderxs r'(extractBrailleElements..sAHHa.>.>#?r&rr>r+c2URUR4$rmr*r,s r'r.r/sAHHa6F6F+Gr&)r\rr rrrrsetAffinityCoderrwrrrrrrrrrAr rrsortr~r Dynamicr+)music21MeasureOrVoice allElementsr music21ObjectnotSupportedException music21ClassisExempts r'rrsZ)*K $I. mTYY / /%I  >-55 %%2 M *$!D$4$4fll#C*E*E *3@3J3J3W3W ##069)n5E ##2""9-   } -69-6H5IM # # 2-/<?@ ;1KOX=M=M!N!N k"os{{ 3 3-/KO *   !G  H ' >,FH,FL#=?,FHHHx==!!%:$;==! >s*/F3(CF33 H=HG.HHcURR5nUHnSUlSUlM URR5nSnSnSnUR 5R U5R U5nUR 5R U5R U5n[U5[U5:wa[RS5 g[U5GHupU RS:XaMXn URU 5n URU 5n X- S-nUS :aMMS n[U S-U S-5HFnUURU R:wd$[UU[R 5(dMDSn O X=S-n[U[R 5(a.[#UR$5[#U R$5:XaSnU(dGM X=S-RS:XaGM#S U lX>> from music21.braille import segment >>> tn = converter.parse('tinynotation: 2/4 c16 c c c d d d d') >>> tn = tn.makeNotation(cautionaryNotImmediateRepeat=False) >>> tn.show('text') {0.0} {0.0} {0.0} {0.0} {0.25} {0.5} {0.75} {1.0} {1.25} {1.5} {1.75} {2.0} >>> measure = tn[0] >>> segment.prepareBeamedNotes(measure) >>> measure.notes[0].beamStart True >>> measure.notes[1].beamContinue True >>> measure.notes[2].beamContinue True >>> measure.notes[3].beamContinue True Fc\URSL=(a [UR5S:$)Nr)beamsr~runuseds r'withBeamFilter*prepareBeamedNotes..withBeamFilterJs#$;#bhh-!*;;r&cRURRS5RS:H$)Nr=rr= getByNumberrr>s r'beamStartFilter+prepareBeamedNotes..beamStartFilterMs"xx##A&++w66r&cRURRS5RS:H$)Nr=rrCr>s r'beamStopFilter*prepareBeamedNotes..beamStopFilterPs"xx##A&++v55r&zDIncorrect beaming: number of start notes != to number of stop notes.Ng?r=r,T)rr beamStart beamContinue notesAndRestsrn addFilterr~rr enumerate quarterLengthrr^rrrxrVbeatr)r#r/ sampleNoteallNotesAndRestsr@rErH allStartIter allStopIter beamIndex startNotestopNote startIndex stopIndexrallNotesOfSameValuer afterStopNotebeforeStartNotes r'rrsJ##**,H $ "' &33::<<76==?,,^<FFWL--/++N;EEnUK <C ,,`a ), 7   " "c ) )%++I6 $**84 &* 19 #zA~y1}=I +99Y=T=TT!"29"=tyyII&+# >  ,];M=$))44]//0C 4FF&+##   A .<<CD #  .A~>O?DII66O001S5HH'559P9PP)- &zA~y1}=I7; Y ' 4>c!86         s8AJ25KA3K2 J?>J? KK KKc[H.upn[X5(dMX RlX0l g [U[ R 5(am[RURl[URR55S:a[RURlSUlg[U[5(ag[US35e)a Takes in a :class:`~music21.base.Music21Object`, and does two things: * Modifies the :attr:`~music21.base.Music21Object.classSortOrder` attribute of the object to fit the slightly modified ordering of objects in braille music. * Adds an affinity code to the Editorial for the object. This code indicates which surrounding objects the object should be grouped with. A BrailleSegmentException is raised if an affinity code cannot be assigned to the object. As seen in the following example, the affinity code of a :class:`~music21.note.Note` and a :class:`~music21.clef.TrebleClef` are the same, because they should be grouped together. However, the classSortOrder indicates that the TrebleClef should come first in the braille. >>> n1 = note.Note('D5') >>> braille.segment.setAffinityCode(n1) >>> n1.editorial.affinityCode >>> n1.classSortOrder 10 >>> c1 = clef.TrebleClef() >>> braille.segment.setAffinityCode(c1) >>> c1.editorial.affinityCode >>> c1.classSortOrder 7 Nr=r1z" cannot be transcribed to braille.)r?rrrr+r TextExpressionr)r;r~contentsplitr8rr)r7r9code sortOrders r'r2r2s@,9'Y m 2 237 # # 0+4 (  ,9 -!;!;<>> a = [note.Note('C4'), note.Note('D4')] >>> b = [note.Note('C4'), note.Note('D4')] >>> braille.segment.areGroupingsIdentical(a, b) True >>> d = b.pop() >>> braille.segment.areGroupingsIdentical(a, b) False >>> c = [note.Rest(), note.Note('D4')] >>> braille.segment.areGroupingsIdentical(a, c) False FT)r~r) noteGroupingA noteGroupingBelementAelementBs r'rrrrs:* =S//$' $E X#%F r&c[R"5nUHnURURU5 M! [ UUUR 5upE[ R "U5n/UlUHnURU5 M [ R "U5n/UlUHnURU5 M Xg4$)a Almost identical to :func:`~music21.braille.segment.splitMeasure`, but functions on a :class:`~music21.braille.segment.BrailleElementGrouping` instead. >>> from music21.braille import segment >>> bg = segment.BrailleElementGrouping() >>> bg.timeSignature = meter.TimeSignature('2/2') >>> s = converter.parse('tinyNotation: 2/2 c4 d r e') >>> for n in s.recurse().notesAndRests: ... bg.append(n) >>> left, right = segment.splitNoteGrouping(bg) >>> left , ]> >>> print(left) >>> right , ]> Now split one beat division earlier than it should be. For 2/2 that means one half of a beat, or one quarter note earlier: >>> left, right = segment.splitNoteGrouping(bg, beatDivisionOffset=1) >>> left ]> >>> right , , ]> ) rrrr splitMeasurerFcopyrfr)rr>r#r~ leftMeasure rightMeasureleftBrailleElementsrightBrailleElementss r'rCrCsJ^^%N&n33^D'".~/A/;/I/I#K[))L1')$%"">2& 99\2(*%&##N3'  44r&cUbUnOUR5nSnUS:wa[U5[UR5:a[ SUS3SUR3-5e[UR5[U5- nU[ URUR 5- n[ U5n[R"UR5nSnURUS S 9 UR5SupX-n [$R&"5n [$R&"5n UHn U R(U:a]U R(U :d/U R(U :Xa=[+U [,R.5(aU R1U R(U 5 MpU R1U R(U 5 M U R2HLn U R4b<U R7U 5 U R9U 5 XR:R - n ML O UR:R U - n[<R>"US9nU R1X5 [<R>"U S9nU R1SU5 S nU R@cSnX:l X;l U RCU5 U RCU5 U RESS9 U RESS9 [GU 5 [GU 5 U R9U5 U R9U5 U(aU R9U5 U R9U5 X4$![a) [RSURS3-5 GNf=f![ R"aE US - nURUS S 9 UR5SSnUR5S S n GNf=f)a  Takes a :class:`~music21.stream.Measure`, divides it in two parts, and returns a two-tuple of (leftMeasure, rightMeasure). The parameters are as follows: * beatDivisionOffset => Adjusts the end offset of the first partition by a certain amount of beats to the left. * useTimeSignature => In the event that the Measure comes from the middle of a Part and thus does not define an explicit :class:`~music21.meter.TimeSignature`. If not provided, a TimeSignature is retrieved by using :meth:`~music21.stream.Measure.bestTimeSignature`. >>> m = stream.Measure() >>> m.append(note.Note('C4')) >>> m.append(note.Note('D4')) >>> left, right = braille.segment.splitMeasure(m) >>> left.show('text') {0.0} >>> right.show('text') {1.0} rrzbeatDivisionOffset z is outside zof ts.beatDivisionDurations z2Problem in converting a time signature in measure z, offset may be wrongr>F) loadDefaultr=r0r+)rOT)inPlace)$bestTimeSignaturerr~beatDivisionDurationsrrrOrrrrrjdeepcopy beatSequencepartitionByCount getLevelSpanrMeterExceptionrrrrrrrrrrrdurationrrxrFmergeAttributes makeBeamsr)r#r>useTimeSignaturetsrduration_indexbsnumberOfPartitionsstartOffsetZero endOffsetZerorkrlr-r. rest0Lengthr0r1 ts0_deletes r'riri s,#   - - / FQ ! "S)A)A%B B)%&8%9F01I1I0JKL R556=O9PP Q fR55nESST TFF^F r 'B2 .EB+-??+>#L  HH 'XX -]2'3;;77   qxx +   ! ,   55    q !    " ZZ55 5M   !))77-GK  -B})  /BR J  ( $&!!#/  0$'4({#|$r2  &&s Q   R#1#8#8"99N OP Q Q   2a .EB//+A.q1)"-b1 2s%0L;%M1;/M.-M.1AO  O c\rSrSrSrSrg)Testi cSSKJn URS5nURSS9n[ U5n[ US5ng)Nr) converterz)tinynotation: 3/4 c4 c c e e e g g g c'2.F)cautionaryNotImmediateRepeat)rrparse makeNotationrr)rhrtn rawSegListr?s r'testGetRawSegmentsTest.testGetRawSegments s<% __H I __%_ @#B' Z]#r&r N)r!r"r#r$rr%r r&r'rr s$r&r__main__)rz bool | None)rrV)r5zstream.Measure | stream.Voicerr\)r7zbase.Music21Object)r)rN)or __future__r collectionsrrrjenumtypingtunittestrrrrr r r r r rrrrrrrmusic21.prebasermusic21.braillerrrrrmusic21.braille.objectsrmusic21.common.numberToolsrr EnvironmentrMusic21ExceptionrIntEnumr)CSO_NOTECSO_REST CSO_CHORD CSO_DYNAMICCSO_CLEF CSO_BARLINE CSO_KEYSIG CSO_TIMESIG CSO_TTEXT CSO_MMARK CSO_VOICEr*r;rxChordr4rrr<rKr5rL TempoTextr6 MetronomeMarkr7rr9r?rGr8r:r@r SystemLayout PageLayout StaffLayoutrA TypedDictrCrHrMrrrO NamedTuplerTr\rrrrrrrrrr2rrrCriTestCaserr!mainTestr r&r'rs#)  *!"1 >- ..&&|4  l;;  t||           YY""H- YY""H- [[($$i0 x));7 YY""H-[[(++[9x)):6 (,,k: __hnni0 (..)4 \\8$$i0 G C  , NN) NN- ; *  6 6 & "  LL    >:,akk, %/ G !24PQt'^t'nk T%%k \eJ.$*>*>eJr &*"&!%!#$(,!;?/4,0%*+/!u09ut486;BF l@7@ l@b (*c#&cLS6SSln