music21.tree

Tools for grouping notes and chords into a searchable tree organized by start and stop offsets.

This is a lower-level tool that for now at least normal music21 users won’t need to worry about.

This directory will change significantly and may even be removed in v10. Developers who depend on certain tree features (chirp…chirp…) should speak up on the music21list or GitHub – but in > 12 years of having it no one has said they use it – hence why it should be modified!

Functions

music21.tree.makeExampleScore()

Makes example score for use in stream-to-tree conversion docs.

>>> sc = tree.makeExampleScore()
>>> sc.show('text')
{0.0} <music21.stream.Part ...>
    {0.0} <music21.instrument.Instrument 'PartA: : '>
    {0.0} <music21.stream.Measure 1 offset=0.0>
        {0.0} <music21.clef.BassClef>
        {0.0} <music21.meter.TimeSignature 2/4>
        {0.0} <music21.note.Note C>
        {1.0} <music21.note.Note D>
    {2.0} <music21.stream.Measure 2 offset=2.0>
        {0.0} <music21.note.Note E>
        {1.0} <music21.note.Note F>
    {4.0} <music21.stream.Measure 3 offset=4.0>
        {0.0} <music21.note.Note G>
        {1.0} <music21.note.Note A>
    {6.0} <music21.stream.Measure 4 offset=6.0>
        {0.0} <music21.note.Note B>
        {1.0} <music21.note.Note C>
        {2.0} <music21.bar.Barline type=final>
{0.0} <music21.stream.Part ...>
    {0.0} <music21.instrument.Instrument 'PartB: : '>
    {0.0} <music21.stream.Measure 1 offset=0.0>
        {0.0} <music21.clef.BassClef>
        {0.0} <music21.meter.TimeSignature 2/4>
        {0.0} <music21.note.Note C#>
    {2.0} <music21.stream.Measure 2 offset=2.0>
        {0.0} <music21.note.Note G#>
    {4.0} <music21.stream.Measure 3 offset=4.0>
        {0.0} <music21.note.Note E#>
    {6.0} <music21.stream.Measure 4 offset=6.0>
        {0.0} <music21.note.Note D#>
        {2.0} <music21.bar.Barline type=final>