.. _moduleTreeSpans:

music21.tree.spans
==================

.. WARNING: DO NOT EDIT THIS FILE:
   AUTOMATICALLY GENERATED.
   PLEASE EDIT THE .py FILE DIRECTLY.

.. automodule:: music21.tree.spans

ElementTimespan
---------------

.. autoclass:: music21.tree.spans.ElementTimespan

.. rubric:: :class:`~music21.tree.spans.ElementTimespan` bases

- :class:`~music21.tree.spans.Timespan`

.. rubric:: :class:`~music21.tree.spans.ElementTimespan` read-only properties

.. autoattribute:: music21.tree.spans.ElementTimespan.measureNumber

.. autoattribute:: music21.tree.spans.ElementTimespan.part

.. autoattribute:: music21.tree.spans.ElementTimespan.quarterLength

Read-only properties inherited from :class:`~music21.tree.spans.Timespan`:

.. hlist::
   :columns: 3

   - :attr:`~music21.tree.spans.Timespan.endTime`
   - :attr:`~music21.tree.spans.Timespan.offset`

.. rubric:: :class:`~music21.tree.spans.ElementTimespan` methods

.. automethod:: music21.tree.spans.ElementTimespan.__eq__

.. automethod:: music21.tree.spans.ElementTimespan.getParentageByClass

.. automethod:: music21.tree.spans.ElementTimespan.makeElement

.. automethod:: music21.tree.spans.ElementTimespan.new

Methods inherited from :class:`~music21.tree.spans.Timespan`:

.. hlist::
   :columns: 3

   - :meth:`~music21.tree.spans.Timespan.canMerge`
   - :meth:`~music21.tree.spans.Timespan.mergeWith`
   - :meth:`~music21.tree.spans.Timespan.splitAt`

.. rubric:: :class:`~music21.tree.spans.ElementTimespan` instance variables

.. attribute:: ElementTimespan.parentage

	
	The Stream hierarchy above the element in a ElementTimespan.
	
	>>> score = corpus.parse('bwv66.6')
	>>> scoreTree = score.asTimespans()
	>>> verticality = scoreTree.getVerticalityAt(1.0)
	>>> pitchedTimespan = verticality.startTimespans[0]
	>>> pitchedTimespan
	<PitchedTimespan (1.0 to 2.0) <music21.note.Note A>>
	>>> for streamSite in pitchedTimespan.parentage:
	...     streamSite
	<music21.stream.Measure 1 offset=1.0>
	<music21.stream.Part Soprano>
	<music21.stream.Score ...>
	

PitchedTimespan
---------------

.. autoclass:: music21.tree.spans.PitchedTimespan

.. rubric:: :class:`~music21.tree.spans.PitchedTimespan` bases

- :class:`~music21.tree.spans.ElementTimespan`
- :class:`~music21.tree.spans.Timespan`

.. rubric:: :class:`~music21.tree.spans.PitchedTimespan` read-only properties

.. autoattribute:: music21.tree.spans.PitchedTimespan.pitches

Read-only properties inherited from :class:`~music21.tree.spans.ElementTimespan`:

.. hlist::
   :columns: 3

   - :attr:`~music21.tree.spans.ElementTimespan.measureNumber`
   - :attr:`~music21.tree.spans.ElementTimespan.part`
   - :attr:`~music21.tree.spans.ElementTimespan.quarterLength`

Read-only properties inherited from :class:`~music21.tree.spans.Timespan`:

.. hlist::
   :columns: 3

   - :attr:`~music21.tree.spans.Timespan.endTime`
   - :attr:`~music21.tree.spans.Timespan.offset`

.. rubric:: :class:`~music21.tree.spans.PitchedTimespan` methods

.. automethod:: music21.tree.spans.PitchedTimespan.canMerge

Methods inherited from :class:`~music21.tree.spans.ElementTimespan`:

.. hlist::
   :columns: 3

   - :meth:`~music21.tree.spans.ElementTimespan.__eq__`
   - :meth:`~music21.tree.spans.ElementTimespan.getParentageByClass`
   - :meth:`~music21.tree.spans.ElementTimespan.makeElement`
   - :meth:`~music21.tree.spans.ElementTimespan.new`

Methods inherited from :class:`~music21.tree.spans.Timespan`:

.. hlist::
   :columns: 3

   - :meth:`~music21.tree.spans.Timespan.mergeWith`
   - :meth:`~music21.tree.spans.Timespan.splitAt`

.. rubric:: :class:`~music21.tree.spans.PitchedTimespan` instance variables

Instance variables inherited from :class:`~music21.tree.spans.ElementTimespan`:

.. hlist::
   :columns: 3

   - :attr:`~music21.tree.spans.ElementTimespan.parentage`

Timespan
--------

.. autoclass:: music21.tree.spans.Timespan

.. rubric:: :class:`~music21.tree.spans.Timespan` read-only properties

.. autoattribute:: music21.tree.spans.Timespan.endTime

.. autoattribute:: music21.tree.spans.Timespan.offset

.. rubric:: :class:`~music21.tree.spans.Timespan` methods

.. automethod:: music21.tree.spans.Timespan.__eq__

.. automethod:: music21.tree.spans.Timespan.canMerge

.. automethod:: music21.tree.spans.Timespan.mergeWith

.. automethod:: music21.tree.spans.Timespan.new

.. automethod:: music21.tree.spans.Timespan.splitAt