Previous topic

music21.counterpoint.species

Next topic

music21.documentation.library.cleaners

Table Of Contents

Table Of Contents

This Page

music21.derivation

This module defines objects for tracking the derivation of one Stream from another.

Derivation

class music21.derivation.Derivation(container=None)
>>> import copy
>>> s1 = stream.Stream()
>>> s2 = stream.Stream()
>>> d1 = derivation.Derivation(s1)
>>> d1.setAncestor(s2)
>>> d1.getAncestor() is s2
True    
>>> d1.getContainer() is s1
True    
>>> d2 = copy.deepcopy(d1)
>>> d2.getAncestor() is s2
True
>>> d1.setMethod('measure')
>>> d1.getMethod()
'measure'

Derivation methods

Derivation.getAncestor()
Derivation.getContainer()
Derivation.getMethod()
Derivation.setAncestor(ancestor)
Derivation.setContainer(container)
Derivation.setMethod(method)

sets a string identifying how the object was derived

Derivation.unwrapWeakref()

Unwrap any and all weakrefs stored.

>>> s1 = stream.Stream()
>>> s2 = stream.Stream()
>>> d1 = derivation.Derivation(s1) # sets container
>>> d1.setAncestor(s2)
>>> common.isWeakref(d1._container)
True
>>> d1.unwrapWeakref()
>>> common.isWeakref(d1._container)
False
Derivation.wrapWeakref()

Wrap all stored objects with weakrefs.