rh(<SrSSKJr SSKrSSKJr SSKrSSKrSSK r SSK J r SSK J r SSK Jr \R(aSSK Jr \R""S 5rS r"S S \ 5r"S S\ R*5r\/r\S:XaSSK r \ R2"\5 gg)zn This module defines objects for tracking the derivation of one :class:`~music21.stream.Stream` from another. ) annotationsN) Generator)common)SlottedObjectMixin) environment)base derivationcF^[R"T5U4Sj5nU$)aV This decorator can be used for creating a function that returns a new derivation. But is currently unused, since it does not take into account `inPlace=True`. `Stream.cloneEmpty(derivationMethod='derivationMethod')` is preferred for Streams. >>> from copy import deepcopy >>> @derivation.derivationMethod ... def allGreen(n): ... n2 = deepcopy(n) ... n2.style.color = 'green' ... return n2 >>> n = note.Note('C#') >>> n2 = allGreen(n) >>> n2.style.color 'green' >>> n2.name = 'D-' >>> n2.derivation from via 'allGreen'> cv>T"U/UQ70UD6nXRlTRURlU$N)r origin__name__method)self argumentskeywordsresultfunctions L/home/james-whalen/.local/lib/python3.13/site-packages/music21/derivation.pywrapper!derivationMethod..wrapper<s<$77h7#' #+#4#4  ) functoolswraps)rrs` rderivationMethodr%s'.__X Nrc,\rSrSrSrSrSSSjjrSSjrSrSr S r \ SS j5r \ RSS j5r SS jr\ SS j5r\RSSj5r\ SSj5r\RSSj5r\ SSj5r\ SSj5rSrg) DerivationEa A Derivation object keeps track of which Streams (or perhaps other Music21Objects) a Stream or other music21 object has come from and how. Derivation is automatically updated by many methods: >>> import copy >>> sOrig = stream.Stream(id='orig') >>> sNew = copy.deepcopy(sOrig) >>> sNew.id = 'copy' >>> sNew.derivation from via '__deepcopy__'> >>> sNew.derivation.client >>> sNew.derivation.client is sNew True >>> sNew.derivation.origin >>> sNew.derivation.method '__deepcopy__' >>> s1 = stream.Stream() >>> s1.id = 'DerivedStream' >>> d1 = derivation.Derivation(s1) >>> s2 = stream.Stream() >>> s2.id = 'OriginalStream' >>> d1.method = 'manual' >>> d1.origin = s2 >>> d1 from via 'manual'> >>> d1.origin is s2 True >>> d1.client is s1 True >>> import copy >>> d2 = copy.deepcopy(d1) >>> d2.origin is s2 True >>> d1.method = 'measure' >>> d1.method 'measure' Deleting the origin stream does not change the Derivation, since origin is held by strong ref: >>> import gc # Garbage collection >>> del s2 >>> unused = gc.collect() # ensure Garbage collection is run >>> d1 from via 'measure'> But deleting the client stream changes the Derivation, since client is held by weak ref, and will also delete the origin (so long as client was ever set) >>> del s1 >>> unused = gc.collect() # ensure Garbage collection is run >>> d1 )_client _clientId_method_origin _originIdNcVSUlSUlSUlSUlSUlXlgr rr r!r"r#clientrr&s r__init__Derivation.__init__s,37 #'!% 04 #' rcj[U5"5nURUlURUlU$)z Manage deepcopying by creating a new reference to the same object. If the origin no longer exists, than origin is set to None )typer&r )rmemonews r __deepcopy__Derivation.__deepcopy__s* 4jl[[ [[  rcURRnUR(aSUR<3OSnSUSURSURUS3$)z" representation of the Derivation z via ) __class__rrr&r )rklassvias r__repr__Derivation.__repr__sR'')-dkk_%"5'dkk]& cU!DDrcx[R"UR5Ul[R"U5$r )r unwrapWeakrefrr __getstate__rs rr;Derivation.__getstate__s)++DLL9 !..t44rcz[R"X5 [R"UR5Ulgr )r __setstate__r wrapWeakrefr)rstates rr?Derivation.__setstate__s&''4))$,,7 rc[R"UR5nUc)URbSUlSUlSUlSUlU$r )rr:rr r"r#)rcs rr&Derivation.clientsE   . 93!DNDLDL!DNrc~UcSUlSUlg[U5Ul[R"U5Ulgr )r ridrr@r's rr&rEs4 >!DNDLZDN!--f5DLrc#j# URnUb Uv URRnUbMgg7f)a Iterator/Generator Yields the Streams which this Derivation's client Stream was derived from. This provides a way to obtain all Streams that the client passed through, such as those created by :meth:`~music21.stream.Stream.getElementsByClass` or :meth:`~music21.stream.Stream.flatten`. >>> s1 = stream.Stream() >>> s1.id = 's1' >>> s1.repeatAppend(note.Note(), 10) >>> s1.repeatAppend(note.Rest(), 10) >>> s2 = s1.notesAndRests.stream() >>> s2.id = 's2' >>> s3 = s2.getElementsByClass(note.Note).stream() >>> s3.id = 's3' >>> for y in s3.derivation.chain(): ... print(y) >>> list(s3.derivation.chain()) == [s2, s1] True N)r r )rorigs rchainDerivation.chains24+/++J??))Ds-33cUR$)a Returns or sets the string of the method that was used to generate this Stream. >>> s = stream.Stream() >>> s.derivation.method is None True >>> sNotes = s.notes.stream() >>> sNotes.derivation.method 'notes' Some examples are 'getElementsByClass' etc. >>> s = stream.Stream() >>> s.id = 'lonelyStream' >>> s.append(clef.TrebleClef()) >>> s.append(note.Note()) >>> sNotes = s.notes.stream() >>> sNotes.derivation from via 'notes'> >>> derived = sNotes.derivation >>> derived.method 'notes' >>> derived.method = 'blah' >>> derived.method 'blah' >>> derived is sNotes.derivation True >>> sNotes.derivation.method 'blah' r!r<s rrDerivation.methodsL||rcXlgr rM)rrs rrrNs rcUR$r )r"r<s rr Derivation.origin#s ||rcTUcSUlSUlg[U5UlXlgr )r#r"rG)rr s rr rQ's' >!DNDLZDN!LrcUR$)z Return the Python id (=memory location) of the origin. (Same as id(derivation.origin). Not the same as derivation.origin.ind) )r#r<s roriginIdDerivation.originId2s ~~rcN[UR55nU(aUS$g)a Return a reference to the oldest source of this Stream; that is, chain calls to :attr:`~music21.stream.Stream.derivesFrom` until we get to a Stream that cannot be further derived. >>> s1 = stream.Stream() >>> s1.repeatAppend(note.Note(), 10) >>> s1.repeatAppend(note.Rest(), 10) >>> s2 = s1.notesAndRests.stream() >>> s3 = s2.getElementsByClass(note.Note).stream() >>> s3.derivation.rootDerivation is s1 True N)listrJ)rderivationChains rrootDerivationDerivation.rootDerivation:s%tzz|, "2& &rr%r )r&base.Music21Object | None)returnr\)r]z)Generator[base.Music21Object, None, None])r] str | None)rr^)r r\)r]z int | None)r __module__ __qualname____firstlineno____doc__ __slots__r(r.r7r;r?propertyr&setterrJrr rTrZ__static_attributes__rrrrEsCNI E5 8 ]]66*>%%N ]] ]]""rrc\rSrSrSrg)TestiRrgN)rr_r`rarfrgrrririRsrri__main__)rb __future__rweakrefcollections.abcrrtypingtunittestmusic21rmusic21.common.objectsrr TYPE_CHECKINGr Environment environLocalrrTestCaseri _DOC_ORDERrmainTestrgrrrys#%5??&&|4 @H#HZ 8   \  z Tr