.. _moduleAnalysis.metrical:

music21.analysis.metrical
=========================

.. WARNING: DO NOT EDIT THIS FILE: AUTOMATICALLY GENERATED.  Edit the .py file directly

.. module:: music21.analysis.metrical

Various tools and utilities for doing metrical or rhythmic analysis. See the chapter :ref:`overviewMeters` for more information on defining metrical structures in music21. 


.. function:: labelBeatDepth(streamIn)

    Modify a Stream in place by annotating metrical analysis symbols. This assumes that the Stream is already partitioned into Measures. 

    >>> from music21 import *
    >>> s = stream.Stream()
    >>> ts = meter.TimeSignature('4/4')
    >>> s.insert(0, ts)
    >>> n = note.Note()
    >>> s.repeatAppend(n, 4)
    >>> post = analysis.metrical.labelBeatDepth(s)
    >>> ts.beatSequence
    <MeterSequence {{1/8+1/8}+{1/8+1/8}+{1/8+1/8}+{1/8+1/8}}> 

