Previous topic

music21.abcFormat.translate

Next topic

music21.analysis.discrete

Table Of Contents

Table Of Contents

This Page

music21.analysis.correlate

Various tools and utilities to find correlations between disparate objects in a Stream.

See the chapter Overview: Importing File and Data Formats for more information and examples of converting formats into and out of music21.

ActivityMatch

class music21.analysis.correlate.ActivityMatch(streamObj)

Given a Stream, find if one object is active while another is also active.

Plotting routines to graph the output of dedicated methods in this class are available.

PlotScatterPitchSpaceDynamicSymbol and PlotScatterWeightedPitchSpaceDynamicSymbol employs the pitchToDynamic() method. Sample output is as follows:

../_images/PlotScatterWeightedPitchSpaceDynamicSymbol.png

ActivityMatch methods

ActivityMatch.pitchToDynamic(dataPoints=True)

Create an analysis of pitch to dynamic symbol.

If dataPoints is True, all data matches between source and destination are returned. If False, 3 point weighted coordinates are created for each unique match.

>>> s = corpus.parse('bach/bwv8.6.xml')
>>> am = analysis.correlate.ActivityMatch(s.parts[0].flat.sorted)
>>> am.pitchToDynamic()
Traceback (most recent call last):
CorrelateException: cannot create correlation an object that is not found in the 
Stream: <class 'music21.dynamics.Dynamic'>
>>> s = corpus.parse('schumann/opus41no1', 2)
>>> am = analysis.correlate.ActivityMatch(s.parts[0].flat.sorted)
>>> data = am.pitchToDynamic()
>>> len(data)
427
>>> data[0]
[64.0, 5]