rht%SSKJr SSKrSSKrSSKrSSKJr SSKJr SSKJr SSK J r SSK J r SSK Jr S rS rS rS rSS jrSSjrSr\\\R0\R0\R0\R04\4r0rS\S'0rS\S'0rS\S'0rS\S'Sr Sr!Sr"Sr#Sr$\\\\/r%"SS\RL5r'\(S:XaSSKr\RR"\'5 gg)) annotationsN)pitch)stream) voiceLeading)opFrac) possibility)Music21Exceptionch[U5nUR[R5R5n[ [ U55Vs/sH2nX#R 5RS5R5PM4 nnUSR[R5R5Rn[UR55HdupgUup[ [ U55HCn Xzn [R"U 5n X- U lSU lXJR#X-U 5 ME Mf UHLn U R%SSS9 US:wdMU SR'5 U HnU=R(S-slM MN [R*"U5nU$s snf) aP Takes in a :class:`~music21.stream.Stream` and returns a :class:`~music21.stream.Score` of the :class:`~music21.stream.Stream` broken up into its voice leading moments. >>> #_DOCS_SHOW score = corpus.parse('corelli/opus3no1/1grave').measures(1, 3) >>> #_DOCS_SHOW score.show() .. image:: images/figuredBass/corelli_grave.* :width: 700 >>> from music21.figuredBass import checker >>> score = corpus.parse('bwv66.6') #_DOCS_HIDE >>> vlMoments = checker.getVoiceLeadingMoments(score) >>> #_DOCS_SHOW vlMoments.show() .. image:: images/figuredBass/corelli_vlm.* :width: 700 GeneralNoterNTF)inPlacecautionaryNotImmediateRepeatg)extractHarmoniesgetElementsByClassrPartrangelenflattengetElementsNotOfClassMeasurefirst paddingLeftsorteditemscopydeepcopy quarterLengthtieinsert makeNotationpadAsAnacrusisnumberScore) music21Stream allHarmoniesallPartsinewPartsroffsetsnotes initOffsetendTime genNoteIndexmusic21GeneralNotenewGeneralNote givenPartmnewScores U/home/james-whalen/.local/lib/python3.13/site-packages/music21/figuredBass/checker.pygetVoiceLeadingMomentsr4sy($M2L// <CCEHs8}-/-A ##%;;MJQQS- /1+00@FFHTTK"<#5#5#78 '!#e*-L!&!4 !]]+=>N+2+?N (!%N   " ) )**BN S .9 t%P #  aL ' ' )A   ||H%H O%/s9F/cUR[R5n[U5S:a [ S5e[ US5nUSSHn[ X#5nM U$)a Takes in a :class:`~music21.stream.Stream` and returns a dictionary whose values are the voice leading moments of the :class:`~music21.stream.Stream` and whose keys are (offset, endTime) pairs delimiting their duration. The voice leading moments are spelled out from the first or highest :class:`~music21.stream.Part` to the lowest one. >>> score = corpus.parse('corelli/opus3no1/1grave').measures(1, 3) >>> #_DOCS_SHOW score.show() .. image:: images/figuredBass/corelli_grave.* :width: 700 >>> from music21.figuredBass import checker >>> allHarmonies = checker.extractHarmonies(score) >>> for (offsets, notes) in sorted(allHarmonies.items()): ... print('{0!s:15}[{1!s:23}{2!s:23}{3!s:22}]'.format(offsets, notes[0], notes[1], notes[2])) (0.0, 1.5) [ ] (1.5, 2.0) [ ] (2.0, 3.0) [ ] (3.0, 3.5) [ ] (3.5, 4.0) [ ] (4.0, 6.0) [ ] (6.0, 6.5) [ ] (6.5, 7.0) [ ] (7.0, 7.5) [ ] (7.5, 8.0) [ ] (8.0, 8.5) [ ] (8.5, 9.0) [ ] (9.0, 9.5) [ ] (9.5, 10.0) [ ] (10.0, 10.5) [ ] (10.5, 11.0) [ ] (11.0, 11.5) [ ] (11.5, 12.0) [ ] z5There must be at least two parts to extract harmoniesrrN)rrrrr createOffsetMappingcorrelateHarmonies)r$r&r% music21Parts r3rrFs_N// >> from music21.figuredBass import checker >>> score = corpus.parse('corelli/opus3no1/1grave').measures(1, 3) >>> v0 = score[0] >>> offsetMapping = checker.createOffsetMapping(v0) >>> for (offsets, notes) in sorted(offsetMapping.items()): ... print('{0!s:15}[{1!s:22}]'.format(offsets, notes[0])) (0.0, 1.5) [ ] (1.5, 2.0) [ ] (2.0, 3.0) [] (3.0, 4.0) [ ] (4.0, 6.0) [ ] (6.0, 6.5) [ ] (6.5, 7.0) [] (7.0, 8.0) [ ] (8.0, 8.5) [ ] (8.5, 9.0) [ ] (9.0, 11.0) [] (11.0, 12.0) [ ] ) collections defaultdictlistr notesAndRestsoffsetrappend)r9currentMappingr.r+r,s r3r7r7vsg.!,,T2N)113AA'.. ???G,-445GHB r:c 0n[UR55HnUupEUR5RR XESSSSS9nXnUHnUn Un UR U:d UR n UR UR -U:d"[UR UR -5n [R"U5n U RU5 XX4'M M U$)a Adds a new :class:`~music21.stream.Part` to an existing offset mapping. >>> from music21.figuredBass import checker >>> score = corpus.parse('corelli/opus3no1/1grave').measures(1, 3) >>> v0 = score[0] >>> offsetMapping = checker.createOffsetMapping(v0) >>> v1 = score[1] >>> newMapping = checker.correlateHarmonies(offsetMapping, v1) >>> for (offsets, notes) in sorted(newMapping.items()): ... print('{0!s:15}[{1!s:23}{2!s:21}]'.format(offsets, notes[0], notes[1])) (0.0, 1.5) [ ] (1.5, 2.0) [ ] (2.0, 3.0) [ ] (3.0, 4.0) [ ] (4.0, 6.0) [ ] (6.0, 6.5) [ ] (6.5, 7.0) [ ] (7.0, 7.5) [ ] (7.5, 8.0) [ ] (8.0, 8.5) [ ] (8.5, 9.0) [ ] (9.0, 9.5) [ ] (9.5, 10.0) [ ] (10.0, 10.5) [ ] (10.5, 11.0) [ ] (11.0, 12.0) [ ] F) offsetEndincludeEndBoundarymustFinishInSpanmustBeginInSpanincludeElementsThatEndAtStart) rkeysrr?getElementsByOffsetr@rrrrA) rBr9 newMappingr)r+r, notesInRange allNotesSoFarr. newInitOffset newEndTime allNotesCopys r3r8r8s<J.--/0 '"**,::NN $u!OH '/ ". &M J%,,z9 2 9 9 %,,/A/O/OORYY#$6$=$=@R@`@`$`a 99]3L    2 36B 2 3#/1$ r:c /nUSLa4URSUR-5 URS<SS35 [[[ U5R 555nUR [R5Vs/sHofR5PM nnUHupU V s/sHn [U 5PM n n U"U 5n USn U HZnUH2nUcMXS- RU U S S 9SnUURl M4 USLdMBURU<SU<35 M\ M USLa5[U5S :XaURS 5 UHn[U5 M ggs snfs sn f) aN Takes in a :class:`~music21.stream.Score` and a functionToApply which takes in a possibility instance, a tuple with pitches or rests comprising a vertical sonority. Changes the color of notes in the :class:`~music21.stream.Score` which comprise rule violations as determined by functionToApply. .. note:: Colored notes are NOT supported in Finale. >>> music21Stream = corpus.parse('corelli/opus3no1/1grave').measures(1, 6) >>> #_DOCS_SHOW music21Stream.show() .. image:: images/figuredBass/corelli_grave2.* :width: 700 >>> from music21.figuredBass import checker >>> functionToApply = checker.voiceCrossing >>> checker.checkSinglePossibilities(music21Stream, functionToApply, debug=True) Function To Apply: voiceCrossing (Offset, End Time): Part Numbers: (16.0, 16.5) (1, 2) (16.5, 17.0) (1, 2) Voice Crossing is present in the fifth measure between the first and second voices, and the notes in question are highlighted in the music21Stream. >>> #_DOCS_SHOW music21Stream.show() .. image:: images/figuredBass/corelli_voiceCrossing.* :width: 700 TFunction To Apply: z(Offset, End Time):25z Part Numbers:rNrFrGr6No violations to report.)rA__name__rr>rrrrrrgeneralNoteToPitchrJstylecolorrprint)r$functionToApplyrYdebug debugInfor%pr&r)r*nvlmvlm_violationsr+partNumberTuple partNumbernoteAlineInfos r3checkSinglePossibilitiesrfsFI }.1I1IIJ17B7}EF$/ >DDFGHL%2%E%Efkk%RS%R %RHS(.34e!!$e4(-QZ -O- $$!^4HH""(-I/012E).EKK% .}  G>b>/1D!EF . ) } y>Q    7 8!H (O"!T4s E1.E6c /nUSLa/URSUR-5 URS5 [[U5R 55nUR [ R5Vs/sHofR5PM nnUSupU V s/sHn [U 5PM n n USn USSHupUV s/sHn [U 5PM nn U SnU"X5nUHnUHsnUcMUUS- RXSS9R5nUUS- RUUSS9R5nUURl UURl Mu USLdMURU<S U <S U<35 M U nUn Un M USLa5[U5S :XaURS 5 UHn[U5 M ggs snfs sn fs sn f) a# Takes in a :class:`~music21.stream.Score` and a functionToApply which takes in two consecutive possibility instances, each a tuple with pitches or rests comprising a vertical sonority. Changes the color of notes in the :class:`~music21.stream.Score` which comprise rule violations as determined by functionToApply. .. note:: Colored notes are NOT supported in Finale. >>> music21Stream = corpus.parse('theoryExercises/checker_demo.xml') >>> #_DOCS_SHOW music21Stream.show() .. image:: images/figuredBass/checker_demo.* :width: 700 >>> from music21.figuredBass import checker >>> functionToApply = checker.parallelOctaves >>> checker.checkConsecutivePossibilities(music21Stream, functionToApply, debug=True) Function To Apply: parallelOctaves (Offset A, End Time A): (Offset B, End Time B): Part Numbers: (1.0, 2.0) (2.0, 3.0) (2, 4) (2.0, 3.0) (3.0, 5.0) (2, 4) (8.0, 9.0) (9.0, 11.0) (1, 3) Parallel octaves can be found in the first measure, between the first two measures, and between the third and the fourth measure. The notes in question are highlighted in the music21Stream, as shown below. >>> #_DOCS_SHOW music21Stream.show() .. image:: images/figuredBass/checker_parallelOctaves.* :width: 700 TrRz>(Offset A, End Time A): (Offset B, End Time B): Part Numbers:rrNFrTrSr6rU)rArVrrrrrrrrWrJrrXrYrrZ)r$r[rYr\r]r%r^r&previousOffsets previousNotesr_vlmA initOffsetAr)r*vlmB initOffsetBrarbrcrdnoteBres r3checkConsecutivePossibilitiesro sJI }.1I1IIJYZ*=9??ABL%2%E%Efkk%RS%R %RHS'3A$_+8 9=a q !=D 9!!$K(,/45u!"1%u5aj (4-O- $$Z!^4HH#%IIIN$Z!^4HH#[%IIIN(-EKK%(-EKK%.}  O#9b#9'BGZ![\ ."! %-( } y>Q    7 8!H (O"3T 96s:G G G"cF/n[[U55HdnXnUR [US-[U55H4nXnUR X5:dMUR US-US-45 M6 Mf U$![a Mwf=f![a M\f=f)a Returns a list of (partNumberA, partNumberB) pairs, each representing two voices which form a voice crossing. The parts from the lowest part to the highest part (right to left) must correspond to increasingly higher pitches in order for there to be no voice crossing. Comparisons between pitches are done using pitch comparison methods, which are based on pitch space values (see :class:`~music21.pitch.Pitch`). >>> from music21.figuredBass import checker >>> C4 = pitch.Pitch('C4') >>> E4 = pitch.Pitch('E4') >>> C5 = pitch.Pitch('C5') >>> G5 = pitch.Pitch('G5') >>> possibA1 = (C5, G5, E4) >>> checker.voiceCrossing(possibA1) # G5 > C5 [(1, 2)] >>> possibA2 = (C5, E4, C4) >>> checker.voiceCrossing(possibA2) [] r)rrpsAttributeErrorrA)possibApartViolations part1Index higherPitch part2Index lowerPitchs r3 voiceCrossingry^s*NCL)  !-K NN QG =J $0  '%%zA~zA~&FG>*    "  s#BB BB B B PITCH_QUARTET_TO_BOOL_TYPEparallelFifthsTableparallelOctavesTablehiddenFifthsTablehiddenOctavesTablec[R"X5n/n[[U55GHnX$upV[US-[U55HnX'up[ UR UR - 5S-S:XdM5[ UR U R - 5S-S:XdM`XXV4n U [;a)[U n U (aURUS-US-45 [R"U 6n U R5(a"URUS-US-45 S[U 'S[U 'M GM U$![ a GMf=f)a8 Returns a list of (partNumberA, partNumberB) pairs, each representing two voices which form parallel fifths. If pitchA1 and pitchA2 in possibA are separated by a simple interval of a perfect fifth, and they move to a pitchB1 and pitchB2 in possibB also separated by the simple interval of a perfect fifth, then this constitutes parallel fifths between these two parts. >>> from music21.figuredBass import checker >>> C3 = pitch.Pitch('C3') >>> D3 = pitch.Pitch('D3') >>> G3 = pitch.Pitch('G3') >>> A3 = pitch.Pitch('A3') >>> A4 = pitch.Pitch('A4') >>> B4 = pitch.Pitch('B4') Here, the bass moves from C3 to D3 and the tenor moves from G3 to A3. The interval between C3 and G3, as well as between D3 and A3, is a perfect fifth. These two parts, and therefore the two possibilities, have parallel fifths. >>> possibA1 = (B4, G3, C3) >>> possibB1 = (A4, A3, D3) >>> checker.parallelFifths(possibA1, possibB1) [(2, 3)] Now, the tenor moves instead to F3. The interval between D3 and F3 is a minor third. The bass and tenor parts don't form parallel fifths. The soprano part forms parallel fifths with neither the bass nor tenor parts. The two possibilities, therefore, have no parallel fifths. >>> F3 = pitch.Pitch('F3') >>> possibA2 = (B4, G3, C3) >>> possibB2 = (A4, F3, D3) >>> checker.parallelFifths(possibA2, possibB2) [] r TF) r partPairsrrabsrqrrr{rArVoiceLeadingQuartet parallelFifth) rspossibB pairsListrt pair1Index higherPitchA higherPitchB pair2Index lowerPitchA lowerPitchB pitchQuartethasParallelFifthsvlqs r3parallelFifthsrsV`%%g7INC N+ '0'<$ QI?J)2)> &[ :>*JK22LAC  ""%%zA~zA~&FG48#L105  -'@,. "  )E)E EEc/n[R"X5nUSupEUSupg[URUR- 5S-S:XaXgXE4nU[;a.[Un U (aUR S[ U545 U$[R"U6n U R5(a%UR S[ U545 S[U'S[U'U$U$![a U$f=f)ay Returns a list with a (highestPart, lowestPart) pair which represents a hidden fifth between shared outer parts of possibA and possibB. The outer parts here are the first and last elements of each possibility. If sopranoPitchA and bassPitchA in possibA move to a sopranoPitchB and bassPitchB in possibB in similar motion, and the simple interval between sopranoPitchB and bassPitchB is that of a perfect fifth, then this constitutes a hidden octave between the two possibilities. >>> from music21.figuredBass import checker >>> C3 = pitch.Pitch('C3') >>> D3 = pitch.Pitch('D3') >>> E3 = pitch.Pitch('E3') >>> F3 = pitch.Pitch('F3') >>> E5 = pitch.Pitch('E5') >>> A5 = pitch.Pitch('A5') Here, the bass part moves up from C3 to D3 and the soprano part moves up from E5 to A5. The simple interval between D3 and A5 is a perfect fifth. Therefore, there is a hidden fifth between the two possibilities. >>> possibA1 = (E5, E3, C3) >>> possibB1 = (A5, F3, D3) >>> checker.hiddenFifth(possibA1, possibB1) [(1, 3)] Here, the soprano and bass parts also move in similar motion, but the simple interval between D3 and Ab5 is a diminished fifth. Consequently, there is no hidden fifth. >>> Ab5 = pitch.Pitch('A-5') >>> possibA2 = (E5, E3, C3) >>> possibB2 = (Ab5, F3, D3) >>> checker.hiddenFifth(possibA2, possibB2) [] Now, we have the soprano and bass parts again moving to A5 and D3, whose simple interval is a perfect fifth. However, the bass moves up while the soprano moves down. Therefore, there is no hidden fifth. >>> E6 = pitch.Pitch('E6') >>> possibA3 = (E6, E3, C3) >>> possibB3 = (A5, F3, D3) >>> checker.hiddenFifth(possibA3, possibB3) [] rrrrTF) rrrrqr}rArrr hiddenFifthrr) rsrrtr highestPitchA highestPitchB lowestPitchA lowestPitchBrhasHiddenFifthrs r3rrs nN%%g7I%.q\"]#,R= \ },//1 2R 71 <( UL00!2>> from music21.figuredBass import checker >>> C3 = pitch.Pitch('C3') >>> D3 = pitch.Pitch('D3') >>> G3 = pitch.Pitch('G3') >>> A3 = pitch.Pitch('A3') >>> C4 = pitch.Pitch('C4') >>> D4 = pitch.Pitch('D4') Here, the soprano moves from C4 to D4 and the bass moves from C3 to D3. The interval between C3 and C4, as well as between D3 and D4, is a parallel octave. The two parts, and therefore the two possibilities, have parallel octaves. >>> possibA1 = (C4, G3, C3) >>> possibB1 = (D4, A3, D3) >>> checker.parallelOctaves(possibA1, possibB1) [(1, 3)] Now, the soprano moves down to B3. The interval between D3 and B3 is a major sixth. The soprano and bass parts no longer have parallel octaves. The tenor part forms a parallel octave with neither the bass nor soprano, so the two possibilities do not have parallel octaves. (Notice, however, the parallel fifth between the bass and tenor!) >>> B3 = pitch.Pitch('B3') >>> possibA2 = (C4, G3, C3) >>> possibB2 = (B3, A3, D3) >>> checker.parallelOctaves(possibA2, possibB2) [] rrrTF) rrrrrrqrrr|rArrparallelOctave) rsrrrtrrrrrrrhasParallelOctavesrs r3parallelOctavesr2sV`%%g7INC N+ '0'<$ QI?J)2)> &[ :>*JK22LAC!!##%%zA~zA~&FG59$\216  .'@,. "  rc/n[R"X5nUSupEUSupg[URUR- 5S-S:XaXgXE4nU[;a.[Un U (aUR S[ U545 U$[R"U6n U R5(a%UR S[ U545 S[U'S[U'U$U$![a U$f=f)aL Returns a list with a (highestPart, lowestPart) pair which represents a hidden octave between shared outer parts of possibA and possibB. The outer parts here are the first and last elements of each possibility. If sopranoPitchA and bassPitchA in possibA move to a sopranoPitchB and bassPitchB in possibB in similar motion, and the simple interval between sopranoPitchB and bassPitchB is that of a perfect octave, then this constitutes a hidden octave between the two possibilities. >>> from music21.figuredBass import checker >>> C3 = pitch.Pitch('C3') >>> D3 = pitch.Pitch('D3') >>> E3 = pitch.Pitch('E3') >>> F3 = pitch.Pitch('F3') >>> A5 = pitch.Pitch('A5') >>> D6 = pitch.Pitch('D6') Here, the bass part moves up from C3 to D3 and the soprano part moves up from A5 to D6. The simple interval between D3 and D6 is a perfect octave. Therefore, there is a hidden octave between the two possibilities. >>> possibA1 = (A5, E3, C3) >>> possibB1 = (D6, F3, D3) # Perfect octave between soprano and bass. >>> checker.hiddenOctave(possibA1, possibB1) [(1, 3)] Here, the bass part moves up from C3 to D3 but the soprano part moves down from A6 to D6. There is no hidden octave since the parts move in contrary motion. >>> A6 = pitch.Pitch('A6') >>> possibA2 = (A6, E3, C3) >>> possibB2 = (D6, F3, D3) >>> checker.hiddenOctave(possibA2, possibB2) [] rrrrTF) rrrrqr~rArrr hiddenOctaverr) rsrrtrrrrrrhasHiddenOctavers r3rrsVN%%g7I%.q\"]#,R= \ },//1 2R 71 <( UL11"4\"B""))1c'l*;<%%22LAC!!%%q#g,&7837"<0/4 | ,! ! ="     rc>UR(a UR$g)a` Takes a :class:`~music21.note.GeneralNote`. If it is a :class:`~music21.note.Note`, returns its pitch. Otherwise, returns the string "RT", a rest placeholder. >>> n1 = note.Note('G5') >>> c1 = chord.Chord(['C3', 'E3', 'G3']) >>> figuredBass.checker.generalNoteToPitch(n1) >>> figuredBass.checker.generalNoteToPitch(c1) 'RT' RT)isNoter)r.s r3rWrWs  !'''r:c\rSrSrSrg)TestiN)rV __module__ __qualname____firstlineno____static_attributes__rr:r3rrsr:r__main__)z#FF0000F)* __future__rr<runittestmusic21rrrmusic21.common.numberToolsrmusic21.figuredBassrmusic21.exceptions21r r4rr7r8rfrorydicttuplePitchboolrzr{__annotations__r|r}r~rrrrrW _DOC_ORDERTestCaserrVmainTestrr:r3rs #  -+1 (V-`>2p=@Hb&X" %++u{{EKK <= 35/4350502-213.3JZNbJZBP& 6+-EG  8    z Tr: