rh]SrSSKJr SSKrSSKrSSKJr SSKJr \R"S5r Sr SSjr "S S \R5r "S S \R5r\ /r\S :XaSSKr\R""\5 gg)z Various tools and utilities for doing metrical or rhythmic analysis. See the chapter :ref:`User's Guide Chapter 14: Time Signatures ` for more information on defining metrical structures in music21. ) annotationsN) environment)streamzanalysis.metricalcVUR[R5GHnURSS9Sn[R "U5nUR RSS9 URHn[US5(a_URbR[RSXDRURR/5 URRS:XaMs[URUR 55HnUR#S 5 M M GM U$) ay Modify a Stream in place by annotating metrical analysis symbols. This assumes that the Stream is already partitioned into Measures. >>> s = stream.Stream() >>> ts = meter.TimeSignature('4/4') >>> s.insert(0, ts) >>> n = note.Note(type='eighth') >>> s.repeatAppend(n, 8) >>> s.makeMeasures(inPlace=True) >>> post = analysis.metrical.labelBeatDepth(s) >>> sOut = [] >>> for n in s.flatten().notes: ... stars = "".join([l.text for l in n.lyrics]) ... sOut.append("{0:8s} {1}".format(n.beatStr, stars)) >>> print("\n".join(sOut)) 1 **** 1 1/2 * 2 ** 2 1/2 * 3 *** 3 1/2 * 4 ** 4 1/2 * F)sortByCreationTimer)depthtiez note, tiestop*)getElementsByClassrMeasuregetTimeSignaturescopydeepcopy beatSequencesubdivideNestedHierarchy notesAndRestshasattrr environLocal printDebugtyperange getBeatDepthoffsetaddLyric)streamInmtstsTempnunused_is S/home/james-whalen/.local/lib/python3.13/site-packages/music21/analysis/metrical.pylabelBeatDepthr$s8 ( ( 8 E :1 =r"4414=Aq%  QUU%6''a (KL55::'!&"5"5ahh"?@ 3A !9" Oc`[U5S- nSn[U5GHup4US:XaSURlMX1:XaX$RlM6XS- RR nURR nXS-RR nXV:Xa Xg:XaSnSn OhXV:wa Xg:XaSnSn OYXV:Xa Xg:waSnSn OJXV:a Xg:aSnSn O;XV:a Xg:aSnSn O,XVs=:aU:aO OS nS n OXVs=:aU:aO OS nS n OSnSn X-URlU nGM g ) a Adds an attribute, 'melodicAccent' to each note's `.editorial` within a :class:`~music21.stream.Stream` object according to the method postulated in Joseph M. Thomassen, "Melodic accent: Experiments and a tentative model," ''Journal of the Acoustical Society of America'', Vol. 71, No. 6 (1982) pp. 1598-1605; with, Erratum, ''Journal of the Acoustical Society of America'', Vol. 73, No. 1 (1983) p.373, and in David Huron and Matthew Royal, "What is melodic accent? Converging evidence from musical practice." ''Music Perception'', Vol. 13, No. 4 (1996) pp. 489-516. Similar to the humdrum melac_ tool. .. _melac: https://www.humdrum.org/Humdrum/commands/melac.html Takes in a Stream of :class:`~music21.note.Note` objects (use `.flatten().notes` to get it, or better `.flatten().getElementsByClass(note.Note)` to filter out chords) and adds the attribute to each. Note that Huron and Royal's work suggests that melodic accent has a correlation with metrical accent only for solo works/passages; even treble passages do not have a strong correlation. (Gregorian chants were found to have a strong ''negative'' correlation between melodic accent and syllable onsets) Following Huron's lead, we assign a `melodicAccent` of 1.0 to the first note in a piece and take the accent marker of the first interval alone to the second note and of the last interval alone to be the accent of the last note. Example from Thomassen, figure 5: >>> s = converter.parse('tinynotation: 7/4 c4 c c d e d d') >>> analysis.metrical.thomassenMelodicAccent(s.flatten().notes) >>> for n in s.flatten().notes: ... (n.pitch.nameWithOctave, n.editorial.melodicAccent) ('C4', 1.0) ('C4', 0.0) ('C4', 0.0) ('D4', 0.33) ('E4', 0.5561) ('D4', 0.17) ('D4', 0.0) g?rgg(\?g(\?gQ?g(\?gQ?gq= ףp??N)len enumerate editorial melodicAccentpitchps) rmaxNotesp2Accentir!lastPsthisPsnextPs thisAccent nextAccents r#thomassenMelodicAccentr7Ms:Z8}q HH(# 6(+AKK %  ](0KK % a%&&))a%&&))   0JJ  &"2JJ  &"2JJ _JJ _JJ  %v %JJ  %v %JJJJ$.$9 !M$r%c\rSrSrSrSrSrg) TestExternalTcSSKJn SSKJn [R"5nUR S5nUR U5 UR5nSUlURUS5 UR5nSUlURUS5 UR5n[U5nUR(aUR5 g g ) z/ Need to test direct meter creation w/o stream r)note)meterz4/4r'r(N) music21r<r=rStream TimeSignatureappendNote quarterLength repeatAppend makeMeasuresr$show)selfr<r=srr!s r# testSingleTestExternal.testSingles !! MMO   '  IIK q! IIK q! NN  1  99 FFH r%N)__name__ __module__ __qualname____firstlineno__rHrK__static_attributes__rMr%r#r9r9s Dr%r9c\rSrSrSrg)TestrMN)rNrOrPrQrRrMr%r#rTrTsr%rT__main__)rz stream.Stream)__doc__ __future__rrunittestr@rr Environmentrr$r7TestCaser9rT _DOC_ORDERrNmainTestrMr%r#r^s# &&':; -^Uv8$$8 8      z Tr%