jBLdZddlmZddlZddlZddlmZddlmZddlmZddlm Z ddlm Z dd l m Z ej d ZGd d ejZGd dZGddZGddejZegZedkrddlZejedSdS)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.windowedceZdZdS)WindowedAnalysisExceptionN)__name__ __module__ __qualname__/Users/tedpeters/Documents/Projects/Claude Projects/Misc Tools/notename-sheets/.venv/lib/python3.11/site-packages/music21/analysis/windowed.pyr r 'sDrr c<eZdZdZdZddZddZ dddZdS)WindowedAnalysisa 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. c||_t|tjst d|r|}||_||_ dS)Nznon-stream provided as argument) processor isinstancerStreamr hasPartLikeStreamsflatten _srcStreamgetMinimumWindowStream_windowedStream)self streamObjanalysisProcessors r__init__zWindowedAnalysis.__init__6ss*)V]33 O+,MNN N  ' ' ) ) ,!))++I##::<<r1/4c*tj}|dtj||j|}|d|std| d|S)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 rrz'WindowedAnalysis.getMinimumWindowStreamAsHmoo 1e1-@@AAA ?//K/HH ##I... F+,DEE E$'''roverlapcHt|j}|dkr ||z dz}nZ|dkr4||z dz}t|}||krtjddn |dkr|}nt jd|d g|z}d g|z}t|}|dkr|D]} tj } t| | |zD]"} | |j| # |j | \|| <|| <p#t$rd \|| <|| <YwxYwn|dkrd } | |z} t|D]} t| t|j} tj } t| | D]"} | |j| # |j | \|| <|| <n#t$rd \|| <|| <YnwxYw| } | |z} n"|dkrg}t||z dzD]y} tj } g}t| | |zD]7} | |j| | | 8| | |gzt|D]z} tj } |D]#\}}| |vr|D]}| |$ |j | \|| <|| <`#t$rd \|| <|| <YwwxYw||fS) 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) r- noOverlapzJmaxWindowCount is not divisible by windowSize, possibly undefined behavior) stackleveladjacentAveragezUnknown windowType: r))NNrz#ffffff)lenrintwarningswarnrMusic21Exceptionrangerrappendrprocessr min)r windowSize windowTypemaxWindowCount windowCountwindowCountFloatdatacolorwindowCountIndicesicurrentjstartend overlapped participants dataStreamms ranalyzezWindowedAnalysis.analyzets*PT122  " "(:59KK ; & &- :Q> .//K;.. ` , , ,(KK/0Sz0S0STT Ts[ k!";//  " "' C C -//q!j.11<(>w(G(G%DGU1XX0CCC(B%DGU1XXXC C; & &E*$C;'' ) )#s4#78899 -//uc**<(>w(G(G%DGU1XX0CCC(B%DGU1XXXCj( ) , , ,J>J6:;; ; ; -//! q!j.11++ANN4#7#:;;; ''****!!7L"9::::>** C C -//0:..,J L((!+..A#NN1----C(,(>(>w(G(G%DGU1XX0CCC(B%DGU1XXXCU{s6-#DD)(D)5#GG10G1!#LLLr/T minWindow int | None maxWindowwindowStepSize int | strc`|t|j}n|}|t|j}n|}|d}nJ|dvrd}n1|dvrd}n|dvrd}g}g} g} t|tr"t t ||dz|} n[tj|\} } g} |} | ||tt | z}||d zkrn?|r-t|j}|| vr| || D]_}| || \}}| || |d |i}| |`|| | fS) a  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}] Nr-r-) nooverlapnonoverlappingr0)adjacentaverager3r/Tg?)r>r=) r4rlowerrr5listr9r getNumFromStrr:roundrN)rrOrQrRr>includeTotalWindow maxLength minLengthsolutionMatrix colorMatrix metaMatrix windowSizesnumjunkx totalWindowrEsolution colorNamemetas rr;zWindowedAnalysis.processs`  D011II!I  D011II!I  "JJ     ; . ."JJ     #B B B$JJ     #6 6 6*J  nc * * uY A ~NNOOKK,^<ddlm}ddlm}|d}|j|jfD]l}|}t||}ttdddgzD]}| ||\}} } mdS)Nrcorpusdiscretez bach/bwv324r/) music21rzmusic21.analysisr|parseKrumhanslSchmucklerAmbitusrrrZr9r;) rrzr|spClasspwarEunused_xunused_yunused_zs r testBasiczTest.testBasichs""""""------ LL ' '3X5EF @ @FA"!))++q11B%1++&&$/ @ @/1zz!Q/?/?,(HH @ @ @rc t}ddlm}tj}||d||dtj}||d||d||d||d||d||d||d ||dt||}t||}|t|j d |t|j d | d d d d \}}} |t|dd ||ddd ||dd d | d d d d \}}} |t|dd ||ddd | d d d d \}}} |t|dd ||ddd ||dd d | d d d d \}}} |t|dd| ddd d \}}} |t|dd | d d d d \}}} |t|dd dS)zJ Test that windows are doing what they are supposed to do r)noteCDEFGABr1r/F)r]N) rmr~rrrr:Noter assertEqualr4rr;) rrrs1s2wa1wa2aunused_bunused_cs r testWindowingzTest.testWindowingys ! !      ]__ $))C..!!! $))C..!!! ]__ $))C..!!! $))C..!!! $))C..!!! $))C..!!! $))C..!!! $))C..!!! $))C..!!! $))C..!!!r1%%r1%% S0111555 S0111555!$ Aq! N N8X QqTA&&& 1a!$$$ 1a!$$$!$ Aq! N N8X QqTA&&& 1a!$$$!$ Aq! N N8X QqTA&&& 1a!$$$ 1a!$$$!$ Aq! N N8X QqTA&&&!$ Aq! N N8X QqTA&&&!$ Aq! N N8X QqTA&&&&&rcHddlm}ddlm}ddlm}|}|d}t||}|j |ddd}| dS) Nrr{ry)graphz bach/bwv66.6r}r-) doneAction windowStepr>) rr|r~rzrrrrrplot WindowedKeyrun)rr|rzrrr unused_wars rtestVariableWindowingzTest.testVariableWindowings------""""""!!!!!!  ( ( * * LL ( ($QYY[[!44 z%%aiikkd12y&JJ  rN)r r rrwrrrrrrrrrrcsT%%%@@@"8'8'8'v     rrr__main__)rk __future__runittestr6r~rrrrrmusic21.analysis.discreter Environment environLocalr8r rrmTestCaserr _DOC_ORDERr mainTestrrrrs  #""""" ??????&{&':;;      =   h7h7h7h7h7h7h7h7Z <<<<<<<<]]]]]8 ]]]F   zNNNGTr