rhBLSrSSKJr SSKrSSKrSSKJr SSKJr SSKJr SSKJ r SSKJ r SS K J r \R"S 5r"S S \R5r"S S5r"SS5r"SS\R&5r\/r\S:XaSSKr\R."\5 gg)an This module describes classes for performing windowed and overlapping windowed analysis. The :class:`music21.analysis.windowed.WindowedAnalysis` provides a reusable framework for systematic overlapping window analysis at the starting at the level of the quarter note and moving to the size of an entire :class:`music21.stream.Stream`. Modular analysis procedures inherit from :class:`music21.analysis.discrete.DiscreteAnalysis`. The :class:`music21.analysis.discrete.KrumhanslSchmuckler` (for algorithmic key detection) and :class:`music21.analysis.discrete.Ambitus` (for pitch range analysis) classes provide examples. ) annotationsN) exceptions21)common) environment)meter)stream)DiscreteAnalysisExceptionzanalysis.windowedc\rSrSrSrg)WindowedAnalysisException(N)__name__ __module__ __qualname____firstlineno____static_attributes__r S/home/james-whalen/.local/lib/python3.13/site-packages/music21/analysis/windowed.pyr r (srr cT\rSrSrSrSrS SjrS SjrS S SjjrSr g) WindowedAnalysis.z Create a WindowedAnalysis object. The provided `analysisProcessor` must provide a `process()` method that, when given a windowed Stream (a Measure) returns two element tuple containing (a) a data value (implementation dependent) and (b) a color code. cX l[U[R5(d [ S5eUR 5(aUR 5nXlUR5Ul g)Nznon-stream provided as argument) processor isinstancerStreamr hasPartLikeStreamsflatten _srcStreamgetMinimumWindowStream_windowedStream)self streamObjanalysisProcessors r__init__WindowedAnalysis.__init__7sW*)V]]33+,MN N  ' ' ) )!))+I##::<rc[R"5nURS[R"U55 UR R US9nURS5 U(d [S5eURSS9 U$)a Take the loaded stream and restructure it into measures of 1 quarter note duration. >>> s = corpus.parse('bach/bwv324') >>> p = analysis.discrete.Ambitus() Placing one part into analysis: >>> wa = analysis.windowed.WindowedAnalysis(s.parts[0], p) >>> post = wa.getMinimumWindowStream() >>> len(post.getElementsByClass(stream.Measure)) 42 >>> post.getElementsByClass(stream.Measure).first() Time signature set to 1/4 time signature >>> post.getElementsByClass(stream.Measure).first().timeSignature leaves one note in this measure >>> len(post.getElementsByClass(stream.Measure)[1].notes) 1 Placing a score with parts into analysis will automatically flatten the stream. So these two calls are equivalent: >>> wa1 = analysis.windowed.WindowedAnalysis(s, p) >>> wa2 = analysis.windowed.WindowedAnalysis(s.flatten(), p) r) meterStreamMeasurezMaking measures failedT)inPlace) rrinsertr TimeSignaturer makeMeasuresremoveByNotOfClassr makeTies)r! timeSignaturer'measureds rr'WindowedAnalysis.getMinimumWindowStreamBsyHmmo 1e11-@A ??//K/H ##I.+,DE E$'rc"[UR5nUS:XaX1- S-nOVUS:Xa.X1- S-n[U5nXT:wa[R"S5 O"US:XaUnO[ R "SU35eS/U-nS/U-n[U5nUS:XawUHnn [R"5n [XU-5H!n U RURU 5 M# URRU 5uXi'Xy'Mp Xg4$US:XaSn X-n [U5Hn [U [UR55n [R"5n [X5H!n U RURU 5 M# URRU 5uXi'Xy'U n X-n M Xg4$US:Xa/n[X1- S-5Hpn [R"5n /n[XU-5H2n U RURU 5 URU 5 M4 URX/5 Mr [U5Hhn [R"5n UH'unnX;dM UHnU RU5 M M) URRU 5uXi'Xy'Mj Xg4$![a SuXi'Xy'GM@f=f![a SuXi'Xy'GNDf=f![a SuXi'Xy'Mf=f) a Calls, for a given window size, an analysis method across all windows in the source Stream. If windowType is "overlap", windows above size 1 are always overlapped, so if a window of size 2 is used, windows 1-2, then 2-3, then 3-4 are compared. If a window of size 3 is used, windows 1-3, then 2-4, then 3-5 are compared. Windows are assumed to be partitioned by :class:`music21.stream.Measure` objects. Returns two lists for results, each equal in size to the length of minimum windows minus the window size plus one. If we have 20 1/4 windows, then the results lists will be of length 20 for window size 1, 19 for window size 2, 18 for window size 3, etc. >>> s = corpus.parse('bach/bwv66.6') >>> p = analysis.discrete.Ambitus() >>> wa = analysis.windowed.WindowedAnalysis(s.flatten(), p) >>> len(wa._windowedStream) 36 >>> a, b = wa.analyze(1) >>> len(a), len(b) (36, 36) >>> a, b = wa.analyze(4) >>> len(a), len(b) (33, 33) >>> a, b = wa.analyze(1, windowType='noOverlap') >>> len(a), len(b) (37, 37) >>> a, b = wa.analyze(4, windowType='noOverlap') >>> len(a), len(b) (10, 10) >>> a, b = wa.analyze(1, windowType='adjacentAverage') >>> len(a), len(b) (36, 36) overlap noOverlapzJmaxWindowCount is not divisible by windowSize, possibly undefined behavioradjacentAveragezUnknown windowType: r))NNrz#ffffff)lenr intwarningswarnrMusic21Exceptionrangerrappendrprocessr min)r! windowSize windowTypemaxWindowCount windowCountwindowCountFloatdatacolorwindowCountIndicesicurrentjstartend overlapped participants dataStreamms ranalyzeWindowedAnalysis.analyzeus(RT112  "(59K ; &-:Q> ./K. `, ,(K//2Fzl0ST Ts[ k!";/  "' --/qj.1ANN4#7#7#:;2C(,(>(>w(G%DGUX(r{[; &E$C;'#s4#7#789 --/u*ANN4#7#7#:;+C(,(>(>w(G%DGUX ((T{5, ,J>6:; --/! qj.1ANN4#7#7#:; ''*2!!7"9:<>* --/0:,J (!+A#NN1-",1;C(,(>(>w(G%DGUX+{c1C(B%DGUXC 1C(B%DGUXC:1C(B%DGUXCs6%"K "K"K7KKK43K47L LcUc[UR5nOUnUc[UR5nOUnUcSnODUR5S;aSnO-UR5S;aSnOUR5S;aSn/n/n /n [U[5(a[ [ XvS-U55n OP[R"U5up/n UnU RU5 U[[ U 55-nXS-:aOM3U(a+[UR5nX;aU RU5 U HMnURUUS 9unnURU5 U RU5 S U0nU RU5 MO XU 4$) a9 Main method for windowed analysis across one or more window sizes. Calls :meth:`~music21.analysis.WindowedAnalysis.analyze` for the number of different window sizes to be analyzed. The `minWindow` and `maxWindow` set the range of window sizes in quarter lengths. The `windowStepSize` parameter determines the increment between these window sizes, in quarter lengths. If `minWindow` or `maxWindow` is None, the largest window size available will be set. If `includeTotalWindow` is True, the largest window size will always be added. >>> s = corpus.parse('bach/bwv324') >>> ksAnalyzer = analysis.discrete.KrumhanslSchmuckler() placing one part into analysis >>> sopr = s.parts[0] >>> wa = analysis.windowed.WindowedAnalysis(sopr, ksAnalyzer) >>> solutions, colors, meta = wa.process(1, 1, includeTotalWindow=False) >>> len(solutions) # we only have one series of windows 1 >>> solutions, colors, meta = wa.process(1, 2, includeTotalWindow=False) >>> len(solutions) # we have two series of windows 2 >>> solutions[1] [(, 'major', 0.6844...), (, 'minor', 0.8308...), (, 'major', 0.6844...), (, 'minor', 0.8308...),...] >>> colors[1] ['#ffb5ff', '#9b519b', '#ffd752', '#9b519b', ...] >>> meta [{'windowSize': 1}, {'windowSize': 2}] r3r3) nooverlapnonoverlappingr5)adjacentaverager6r4g?)rAr@) r7r lowerrr8listr<r getNumFromStrr=roundrQ)r! minWindow maxWindowwindowStepSizerAincludeTotalWindow maxLength minLengthsolutionMatrix colorMatrix metaMatrix windowSizesnumjunkx totalWindowrHsolution colorNamemetas rr>WindowedAnalysis.processsb  D001I!I  D001I!I  "J    ; ."J    #B B$J    #6 6*J  nc * *uYA ~NOK,,^rr rrrr.sS =1fyz'(&'*+$#' f7#f7#f7!(f7f7rrc\rSrSrSrSrg)TestMockProcessori\cL[UR5R5S4$)z( Simply count the number of notes found N)r7r notesAndRests)r! subStreams rr>TestMockProcessor.process^s#9$$&445t;;rr N)rrrrr>rr rrrqrq\s) r!rrspClasspwarHunused_xunused_yunused_zs r testBasicTest.testBasicjs~"- LL '33X5E5EFFA"!))+q1B%1+&$//1zz!/?,H0Grc [5nSSKJn [R"5nUR UR S55 UR UR S55 [R"5nUR UR S55 UR UR S55 UR UR S55 UR UR S55 UR UR S55 UR UR S55 UR UR S 55 UR UR S55 [X15n[XA5nUR[UR5S 5 UR[UR5S 5 URS S S S S9upxn UR[US5S 5 URUSSS 5 URUSS S 5 URS S S S S9upxn UR[US5S 5 URUSSS 5 URS S S S S9upxn UR[US5S 5 URUSSS 5 URUSS S 5 URS S S S S9upxn UR[US5S5 URSSS S S9upxn UR[US5S 5 URS S S S S9upxn UR[US5S 5 g)z: Test that windows are doing what they are supposed to do r)noteCDEFGABr4F)r_N) rqrrrrr=Noter assertEqualr7r r>) r!rrs1s2wa1wa2aunused_bunused_cs r testWindowingTest.testWindowing{s   ]]_ $))C.! $))C.! ]]_ $))C.! $))C.! $))C.! $))C.! $))C.! $))C.! $))C.! $))C.!r%r% S00115 S00115!$ Aq! NX QqTA& 1a!$ 1a!$!$ Aq! NX QqTA& 1a!$!$ Aq! NX QqTA& 1a!$ 1a!$!$ Aq! NX QqTA&!$ Aq! NX QqTA&!$ Aq! NX QqTA&rcSSKJn SSKJn SSKJn UR 5nUR S5n[UR5U5nURRUR5SSSS9nUR5 g) Nrrr)graphz bach/bwv66.6rr3) doneAction windowSteprA) rrrrrrrrrplot WindowedKeyrun)r!rrrrr unused_wars rtestVariableWindowingTest.testVariableWindowingsk-"!  ( ( * LL ($QYY[!4 zz%%aiikd12y&J  rr N) rrrrr|rrrrr rrrwrwes%@"8'v rrw__main__)ro __future__runittestr9rrrrrrmusic21.analysis.discreter Environment environLocalr;r rrqTestCaserw _DOC_ORDERrmainTestr rrrs # ?&&':;  = = i7i7\ <<]8  ]F   z Tr