3j,ddlmZddlZddlmZddlmZddlmZddlmZddlm Z ejrddl m Z ejd Zejej ej"fd f d d Zed k(rddlZej(yy)) annotationsN)clef) environment)key)meter)stream) Music21Objectz stream.toolsTc tjtjtj f}i}|s|j d}t|tjr7t|jdkDr|jD]}t||d|D] t fd|Dstd|d|jj! }t|dkrT|d}|d d D]G}||k(r>|j"|vr||j"j%|5|g||j"<F|}I|j'D]\} } | j)| d |S) a The repetition of some classes like notes is common. By contrast, the explicit repetition of certain other objects like clefs usually indicates an error e.g., resulting from a copy'n'paste. This function serves to remove those that are likely in error and make no change. Use the `classesToRemove` argument to specify which music21 classes to check and remove. The classes currently supported are: time signatures, key signatures, and clefs. The `classesToRemove` argument defaults all three. Sometimes there are legitimate reasons to duplicate even these classes. In that case, override the default by specifying the list of which of the three of classes. More classes may be added, but for now they will simply raise a ValueError. So let's create an example part with an initial set of time signature, key signature, and clef. >>> p = stream.Part() >>> p.append(meter.TimeSignature('3/4')) # first TS >>> p.append(key.KeySignature(6)) # first KS >>> p.append(clef.TrebleClef()) # first Clef Then a few notes, followed by a duplicates of the key signature, and clef. >>> p.append(note.Note('C')) >>> p.append(note.Note('C')) >>> p.append(note.Note('D')) >>> p.append(meter.TimeSignature('3/4')) # duplicate >>> p.append(key.KeySignature(6)) # duplicate >>> p.append(clef.TrebleClef()) # duplicate Finally, a few more notes, followed by a change of time signature, key signature, and clef. >>> p.append(note.Note('E')) >>> p.append(note.Note('F')) >>> p.append(note.Note('G')) >>> p.append(meter.TimeSignature('2/4')) >>> p.append(key.KeySignature(-5)) >>> p.append(clef.BassClef()) >>> p.append(note.Note('A')) >>> p.append(note.Note('B')) >>> p.append(note.Note('C5')) Now we'll make it into a proper part with measures and see how it looks in its original, unaltered form: >>> p.makeMeasures(inPlace=True) >>> p.show('t') {0.0} {0.0} {0.0} {0.0} {0.0} {1.0} {2.0} {3.0} {0.0} {0.0} {0.0} {0.0} {1.0} {2.0} {6.0} {0.0} {0.0} {0.0} {0.0} {1.0} {8.0} {0.0} {1.0} Calling removeDuplicates should remove the duplicates even with those changes now stored within measures, not directly on the part. Specifically, in our example, the duplicates entries are removed from measure 2 and the actual changes in measure 3 remain. >>> testInPlace = stream.tools.removeDuplicates(p) >>> testInPlace.show('t') {0.0} {0.0} {0.0} {0.0} {0.0} {1.0} {2.0} {3.0} {0.0} {1.0} {2.0} {6.0} {0.0} {0.0} {0.0} {0.0} {1.0} {8.0} {0.0} {1.0} As the example shows, this function defaults to working on a stream inPlace. >>> testInPlace == p True To avoid this, set inPlace to False. >>> testNotInPlace = stream.tools.removeDuplicates(p, inPlace=False) >>> testNotInPlace == p False This function is primarily designed and intended for use on a stream.Part object. If called on a steam.Score, it will simply be applied to each of that score's parts in turn. >>> s = stream.Score() >>> s.append(p) >>> t = stream.tools.removeDuplicates(s, inPlace=False) >>> s.parts[0] == testInPlace True removeDuplicatesrT)classesToRemoveinPlacec36K|]}t|yw)N) issubclass).0supportedClass thisClasss A/DATA/.local/lib/python3.12/site-packages/music21/stream/tools.py z#removeDuplicates..s`O_^:i8O_szInvalid class. Only z are supported.N)recurse)r TimeSignaturer KeySignaturerClefcoreCopyAsDerivation isinstancerScorelenpartsr any ValueErrorrgetElementsByClass activeSiteappenditemsremove) thisStreamr r supportedClasses removalDictp allStates currentState thisState activeSiteKeyvaluesToRemovers @rr r sgH++S-=-=tyyI<>K 445GH *fll+ z 1 $%% OTR&% `O_``34D3E_UV V&&(;;IF y>A   | "12IL('';6 4 45<rAs#??*&{&&~6 05/B/BCDTDTVZV_V_.`%)g&+g"g(gX zGr0