rhLSrSSKJr SSKrSSKJr SSKJr SSKJr SSK J r SSKJ r SS KJ r SS KJ r SS KJr \ R"S 5r"S S\R"5r"SS\5r"SS\5r"SS\5r"SS\5r"SS\5r"SS\5r"SS\5r"SS\5r"SS \\5r"S!S"\5r"S#S$\5r"S%S&\5r"S'S(\5r"S)S*\5r "S+S,\5r!"S-S.\5r""S/S0\5r#"S1S2\5r$"S3S4\\5r%"S5S6\5r&"S7S8\5r'"S9S:\'5r("S;S<\'5r)"S=S>\'5r*"S?S@\)5r+"SASB\)5r,"SCSD\)\(5r-"SESF\)5r."SGSH\)5r/"SISJ\)5r0"SKSL\/\*5r1"SMSN\)5r2"SOSP\25r3"SQSR\25r4"SSST\'5r5"SUSV\5\*5r6"SWSX\ Rn\'5r8"SYSZ\ Rn\'5r9"S[S\\55r:"S]S^\55r;"S_S`\'5r<"SaSb\<5r="ScSd\<5r>"SeSf\<5r?"SgSh\?5r@"SiSj\?5rA"SkSl\<5rB"SmSn\'5rC"SoSp\C5rD"SqSr\C5rE"SsSt\'5rF"SuSv\F5rG"SwSx\'5rH"SySz\R5rJ\/rK\LS{:XaSSKr\R"\J5 gg)|a Classes for representing and processing articulations. Specific articulations are modeled as :class:`~music21.articulations.Articulation` subclasses. A :class:`~music21.note.Note` object has an :attr:`~music21.note.Note.articulations` attribute. This list can be used to store one or more :class:`music21.articulations.Articulation` subclasses. As much as possible, MusicXML names are used for Articulation classes, with xxx-yyy changed to XxxYyy. For instance, "strong-accent" in MusicXML is "StrongAccent" here. Fingering and other playing marks are found here. Fermatas, trills, etc. are found in music21.expressions. >>> n1 = note.Note('D#4') >>> n1.articulations.append(articulations.Tenuto()) >>> #_DOCS_SHOW n1.show() >>> c1 = chord.Chord(['C3', 'G4', 'E-5']) >>> c1.articulations = [articulations.OrganHeel(), articulations.Accent()] >>> #_DOCS_SHOW c1.show() A longer test showing the utility of the module: >>> s = stream.Stream() >>> n1 = note.Note('c#5') >>> n1.articulations = [articulations.Accent()] >>> n1.quarterLength = 1.25 >>> s.append(n1) >>> n2 = note.Note('d5') >>> n2.articulations = [articulations.StrongAccent()] >>> n2.quarterLength = 0.75 >>> s.append(n2) >>> n3 = note.Note('b4') >>> n3.articulations = [articulations.Staccato()] >>> n3.quarterLength = 1.25 >>> n3.tie = tie.Tie('start') >>> s.append(n3) >>> n4 = note.Note('b4') >>> n4.articulations = [articulations.Staccatissimo()] >>> n4.quarterLength = 0.75 >>> s.append(n4) >>> n5 = note.Note('a4') >>> n5.articulations = [articulations.Tenuto()] >>> n5.quarterLength = 4/3 >>> s.append(n5) >>> n6 = note.Note('b-4') >>> n6.articulations = [articulations.Staccatissimo(), articulations.Tenuto()] >>> n6.quarterLength = 2/3 >>> s.append(n6) >>> s.metadata = metadata.Metadata() >>> s.metadata.title = 'Prova articolazioni' # ital: 'Articulation Test' >>> s.metadata.composer = 'Giuliano Lancioni' >>> #_DOCS_SHOW s.show() .. image:: images/prova_articolazioni.* :width: 628 ) annotationsN)base)common) tempAttribute)OffsetQL) environment)interval)spanner)style articulationsc^\rSrSr%Sr\R rS\S'S U4Sjjr Sr \ SSj5r Sr S r\ "\ \S S 9rS rU=r$) Articulation`a Base class for all Articulation sub-classes. >>> x = articulations.Articulation() >>> x.placement = 'below' >>> x.style.absoluteY = 20 >>> x.displayText = '>' **Equality** Equality of articulations is based only on the class, as other attributes are independent of context and deployment. >>> at1 = articulations.StrongAccent() >>> at2 = articulations.StrongAccent() >>> at1.placement = 'above' >>> at2.placement = 'below' >>> at1 == at2 True Comparison between classes and with the object itself behaves as expected: >>> at3 = articulations.Accent() >>> at4 = articulations.Staccatissimo() >>> at1 == at3 False >>> at4 == at4 True OMIT_FROM_DOCS >>> at5 = articulations.Staccato() >>> at6 = articulations.Spiccato() >>> [at1, at4, at3] == [at1, at4, at3] True >>> [at1, at2, at3] == [at2, at3, at1] False >>> {at1, at2, at3} == {at2, at3, at1} True >>> at6 == True False This is in OMIT ztype[style.Style] _styleClassc l>[TU]"S0UD6 SUlSUlSUlSUlSUlg)Ngg?first)super__init__ placement _volumeShift lengthShift tieAttach displayTextselfkeywords __class__s O/home/james-whalen/.local/lib/python3.13/site-packages/music21/articulations.pyrArticulation.__init__s9 $8$#&"%%%)cg)Nrrs r _reprInternalArticulation._reprInternalsr!cXURRn[R"USS9$)a returns the name of the articulation, which is generally the class name without the leading letter lowercase. Subclasses can override this as necessary. >>> st = articulations.Staccato() >>> st.name 'staccato' >>> sp = articulations.SnapPizzicato() >>> sp.name 'snap pizzicato'  ) replacement)r__name__rcamelCaseToHyphen)r classNames rnameArticulation.names& NN++ '' sCCr!cUR$Nrr$s r_getVolumeShiftArticulation._getVolumeShifts   r!c2US:aSnOUS:aSnXlg)Nr1)rvalues r_setVolumeShiftArticulation._setVolumeShifts 19E RZE!r!a Get or set the volumeShift of this Articulation. This value, between -1 and 1, that is used to shift the final Volume of the object it is attached to. >>> at1 = articulations.StrongAccent() >>> at1.volumeShift > 0.1 True )doc)rrrrr)returnNone)r;str)r* __module__ __qualname____firstlineno____doc__r TextStyler__annotations__rr%propertyr-r2r8 volumeShift__static_attributes__ __classcell__rs@rrr`sZ+X&+__K"4*DD$!"?OB  Kr!rc,^\rSrSrSrU4SjrSrU=r$)LengthArticulationzD Superclass for all articulations that change the length of a note. c 4>[TU]"S0UD6 SUlgNlastrrrrrs rrLengthArticulation.__init__ $8$r!rr*r>r?r@rArrFrGrHs@rrJrJs  r!rJc\rSrSrSrSrg)DynamicArticulationzE Superclass for all articulations that change the dynamic of a note. rNr*r>r?r@rArFrr!rrUrUr!rUc\rSrSrSrSrg)PitchArticulationzC Superclass for all articulations that change the pitch of a note. rNrWrr!rrZrZrXr!rZc\rSrSrSrSrg)TimbreArticulationzD Superclass for all articulations that change the timbre of a note. rNrWrr!rr]r]rXr!r]c,^\rSrSrSrU4SjrSrU=r$)Accentz! >>> a = articulations.Accent() c 4>[TU]"S0UD6 SUlg)Ng?rrrrrs rrAccent.__init__s $8$r!r1rSrHs@rr`r`s  r!r`c,^\rSrSrSrU4SjrSrU=r$) StrongAccentz Like an accent but even stronger. Has an extra attribute of pointDirection >>> a = articulations.StrongAccent() >>> a.pointDirection 'up' >>> a.pointDirection = 'down' >>> a.pointDirection 'down' c B>[TU]"S0UD6 SUlSUlg)Ng333333?upr)rrrpointDirectionrs rrStrongAccent.__init__s# $8$ "r!)rrjrSrHs@rrfrfs ##r!rfc,^\rSrSrSrU4SjrSrU=r$)Staccatoz# >>> a = articulations.Staccato() c B>[TU]"S0UD6 SUlSUlg)N皙?ffffff?rrrrrrs rrStaccato.__init__# $8$ r!rrrSrHs@rrmrmsr!rmc,^\rSrSrSrU4SjrSrU=r$) Staccatissimoizs A very short note (derived from staccato), usually represented as a wedge. >>> a = articulations.Staccatissimo() c B>[TU]"S0UD6 SUlSUlg)Nrpg?rrrrs rrStaccatissimo.__init__ rtr!rurSrHs@rrwrws r!rwc\rSrSrSrSrSrg)Spiccatoia A staccato note + accent in one >>> spiccato = articulations.Spiccato() >>> staccato = articulations.Staccato() >>> accent = articulations.Accent() >>> spiccato.lengthShift == staccato.lengthShift True >>> spiccato.volumeShift == accent.volumeShift True c [RU5 [US5 [RU5 SSS5 g!,(df  g=f)Nr)rmrrr`)rrs rrSpiccato.__init__s2$ 4 / OOD !0 / /s A ArN)r*r>r?r@rArrFrr!rr{r{s  "r!r{c,^\rSrSrSrU4SjrSrU=r$)Tenutoi z >>> a = articulations.Tenuto() c B>[TU]"S0UD6 SUlSUlg)N皙皙?rrrrs rrTenuto.__init__$s# $8$!r!rurSrHs@rrr sr!rc,^\rSrSrSrU4SjrSrU=r$)DetachedLegatoi)z( >>> a = articulations.DetachedLegato() c 4>[TU]"S0UD6 SUlg)Ng?r)rrrrs rrDetachedLegato.__init__-s $8$r!)rrSrHs@rrr)sr!rc0\rSrSrSr\R rSrg)IndeterminateSlidei3z Represents a whole class of slides that are of an indeterminate pitch amount (scoops, plops, etc.) All these have style information of .style.lineShape .style.lineType, .style.dashLength, and .style.spaceLength rN) r*r>r?r@rAr LineStylerrFrr!rrr3s//Kr!rc\rSrSrSrSrg)Scoopi>z_ An indeterminateSlide coming before the main note and going up >>> a = articulations.Scoop() rNrWrr!rrr>r!rc\rSrSrSrSrg)PlopiFza An indeterminateSlide coming before the main note and going down. >>> a = articulations.Plop() rNrWrr!rrrFrr!rc,^\rSrSrSrU4SjrSrU=r$)DoitiMz^ An indeterminateSlide coming after the main note and going up. >>> a = articulations.Doit() c 4>[TU]"S0UD6 SUlgrMrOrs rr Doit.__init__SrQr!rRrSrHs@rrrM   r!rc,^\rSrSrSrU4SjrSrU=r$)FalloffiWzc An indeterminateSlide coming after the main note and going down. >>> a = articulations.Falloff() c 4>[TU]"S0UD6 SUlgrMrOrs rrFalloff.__init__]rQr!rRrSrHs@rrrWrr!rc,^\rSrSrSrU4SjrSrU=r$) BreathMarkidzk Can have as a symbol 'comma' or 'tick' or None >>> a = articulations.BreathMark() >>> a.symbol = 'comma' c B>[TU]"S0UD6 SUlSUlg)Nrqr)rrrsymbolrs rrBreathMark.__init__ks" $8$ r!)rrrSrHs@rrrds r!rc\rSrSrSrSrg)Caesuraipz! >>> a = articulations.Caesura() rNrWrr!rrrprXr!rc,^\rSrSrSrU4SjrSrU=r$)Stressiuzh An articulation indicating stress. Played a little longer and louder. >>> a = articulations.Stress() c B>[TU]"S0UD6 SUlSUlg)Nrprrrrrs rrStress.__init__{rtr!rurSrHs@rrrus r!rc,^\rSrSrSrU4SjrSrU=r$)Unstressizh An articulation indicating lack of stress. Played a little quieter. >>> a = articulations.Unstress() c 4>[TU]"S0UD6 SUlg)Nrrrcrs rrUnstress.__init__ $8$!r!r1rSrHs@rrrs ""r!rc\rSrSrSrSrg)TechnicalIndicationiz TechnicalIndications (MusicXML: technical) give performance indications specific to different instrument types, such as harmonics or bowing. TechnicalIndications can include an optional content. rNrWrr!rrrsr!rc\rSrSrSrSrg)HarmonicizK A general harmonic indicator -- StringHarmonic is probably what you want. rNrWrr!rrrrXr!rc\rSrSrSrSrg)BowingizK Indication that bowing is being affected. >>> a = articulations.Bowing() rNrWrr!rrrrr!rc6^\rSrSrSrSU4SjjrSrSrU=r$) Fingeringia Fingering is a technical indication that covers the fingering of a note (in a guitar/fret context, this covers the fret finger, see FrettedPluck for that). Converts the MusicXML -- object >>> f = articulations.Fingering(5) >>> f >>> f.fingerNumber 5 `.substitution` indicates that this fingering indicates a substitute fingering: >>> f.substitution = True MusicXML distinguishes between a substitution and an alternate fingering: >>> f.alternate = True Fingerings are the only articulations that apply per note in a chord. Other articulations, e.g., accents, apply to the whole chord and will, therefore, only be associated with the first note of a chord when serializing. Since chords store all articulations in an ordered list, Fingerings are mapped implicitly to the notes of a chord in order. Superfluous Fingerings will be ignored and may be discarded when serializing. c N>[TU]"S0UD6 XlSUlSUlgNFr)rr fingerNumber substitution alternate)rrrrs rrFingering.__init__s( $8$(!r!c,[UR5$r0)r=rr$s rr%Fingering._reprInternals4$$%%r!)rrrr0 r*r>r?r@rArr%rFrGrHs@rrrs: &&r!rc\rSrSrSrSrg)UpBowiz >>> a = articulations.UpBow() rNrWrr!rrrrXr!rc\rSrSrSrSrg)DownBowiz! >>> a = articulations.DownBow() rNrWrr!rrrrXr!rc,^\rSrSrSrU4SjrSrU=r$)StringHarmoniciaA Indicates that a note is a harmonic, and can also specify whether it is the base pitch, the sounding pitch, or the touching pitch. >>> h = articulations.StringHarmonic() >>> h.harmonicType 'natural' >>> h.harmonicType = 'artificial' pitchType can be 'base', 'sounding', or 'touching' or None >>> h.pitchType = 'base' c B>[TU]"S0UD6 SUlSUlg)Nnaturalr)rr harmonicType pitchTypers rrStringHarmonic.__init__s" $8$%r!)rrrSrHs@rrrs r!rc\rSrSrSrg) OpenStringirNr*r>r?r@rFrr!rrrr!rc6^\rSrSrSrSU4SjjrSrSrU=r$)StringIndicationia StringIndication indicates which string a note is played on. A StringIndication can be constructed as >>> si = articulations.StringIndication(2) >>> si >>> si.number 2 If no argument to the constructor is specified, number defaults to 0. c 2>[TU]"S0UD6 XlgNrrrnumberrrrrs rrStringIndication.__init__ $8$ r!cUR$r0rr$s rr%StringIndication._reprInternal++r!rrrrHs@rrr   r!rc\rSrSrSrSrg)StringThumbPositioniz MusicXML -- thumb-position rNrWrr!rrr  r!rc\rSrSrSrSrg)StringFingeringizG Indicates a fingering on a specific string. Nothing special for now. rNrWrr!rrrrr!rc\rSrSrSrSrg) Pizzicatoi z in MusicXML, Pizzicato is an element of every note. Here we represent pizzicatos along with all bowing marks. For pluck, see FrettedPluck. rNrWrr!rrr s   r!rc\rSrSrSrg) SnapPizzicatoirNrrr!rrrrr!rc\rSrSrSrSrg) NailPizzicatoiz Does not exist in MusicXML rNrWrr!rrrrr!rc6^\rSrSrSrSU4SjjrSrSrU=r$)FretIndicationia FretIndication indicates which fret of a string a note is played on. A FretIndication can be constructed as >>> fi = articulations.FretIndication(3) >>> fi >>> fi.number 3 If no argument to the constructor is specified, number defaults to 0. c 2>[TU]"S0UD6 Xlgrrrs rrFretIndication.__init__,rr!cUR$r0rr$s rr%FretIndication._reprInternal0rr!rrrrHs@rrrrr!rc\rSrSrSrSrg) FrettedPlucki3zI specifies plucking fingering for fretted instruments pluck in musicxml rNrWrr!rrr3s   r!rc\rSrSrSrSrg)HammerOni;z9 A hammer-on represented as a spanner between two Notes. rNrWrr!rrr;rr!rc\rSrSrSrSrg)PullOffiAz8 A pull-off represented as a spanner between two Notes. rNrWrr!rrrArr!rc^\rSrSr%SrS\S'S\S'S\S'S \S 'SS S S S S .SU4SjjjjrS rU=r$)FretBendiGa& Bend indication for fretted instruments Bend in musicxml `number` is an identifier for the articulation. Defaults to 0. `bendAlter` is the interval defined by the bend, bend-alter in musicxml. Defaults to `None`. `preBend` indicates if the string is bent before the onset of the note. Defaults to `False`. `release` is the quarterLength value from the start of the note for releasing the bend, if any. Defaults to `None`. `withBar` indicates what whammy bar movement is used, if any. MusicXML supports 'scoop' or 'dip'. Defaults to `None`. >>> fb = articulations.FretBend(1, bendAlter=interval.ChromaticInterval(-2), release=0.5) >>> fb >>> fb.preBend False >>> fb.withBar is None True >>> fb.bendAlter >>> fb.release 0.5 5interval.Interval | interval.ChromaticInterval | None bendAlterboolpreBendOffsetQL | Nonerelease str | NonewithBarNF)rrrrc Z>[TU]"SSU0UD6 X lX0lX@lXPlg)Nrr)rrrrrr)rrrrrrrrs rrFretBend.__init__ls. 33(3"   r!r) rintrrrrrrrr) r*r>r?r@rArCrrFrGrHs@rrrGsw>ED M  LP#'"I    ! r!rc\rSrSrSrg)FretTapi|rNrrr!rrr|rr!rc\rSrSrSrg)WindIndicationirNrrr!rrrrr!rc\rSrSrSrg)WoodwindIndicationirNrrr!rrrrr!rc\rSrSrSrg)BrassIndicationirNrrr!rrrrr!rc\rSrSrSrg)TonguingIndicationirNrrr!rrrrr!rc\rSrSrSrg) DoubleTongueirNrrr!rrrrr!rc\rSrSrSrg) TripleTongueirNrrr!rr r rr!r c\rSrSrSrg)StoppedirNrrr!rr r rr!r c,^\rSrSrSrU4SjrSrU=r$)OrganIndicationiz Indicates whether a pitch should be played with heel or toe. Has one attribute, "substitution" default to False, which indicates whether the mark is a substitution mark c 4>[TU]"S0UD6 SUlgr)rrrrs rrOrganIndication.__init__rr!)rrSrHs@rr r s ""r!r c\rSrSrSrg) OrganHeelirNrrr!rrrrr!rc\rSrSrSrg)OrganToeirNrrr!rrrrr!rc\rSrSrSrg)HarpIndicationirNrrr!rrrrr!rc\rSrSrSrSrg)HarpFingerNailsiz musicXML -- fingernails rNrWrr!rrrrr!rc\rSrSrSrSrg)HandbellIndicationiz displayText is used to store any of the techniques in handbell music. Values are damp, echo, gyro, hand martellato, mallet lift, mallet table, martellato, martellato lift, muted martellato, pluck lift, and swing rNrWrr!rrrs  r!rc \rSrSrSrSrSrg)Testic2SSKJn U"U[55 g)Nr) testCopyAll)music21.test.commonTestrglobals)rrs rtestCopyAndDeepcopyTest.testCopyAndDeepcopys7D')$r!cP[5nURURS5 gr0)r assertEqualr)ras r testBasicTest.testBasics J d+r!rN)r*r>r?r@r r%rFrr!rrrs % ,r!r__main__)NrA __future__runittestmusic21rrmusic21.common.classToolsrmusic21.common.typesrrr r r Environment environLocal Music21ObjectrrJrUrZr]r`rfrmrwr{rrrrrrrrrrrrrrrrrrrrrrrrrrrSpannerrrrrrrrrrr r r rrrrrTestCaser _DOC_ORDERr*mainTestrr!rr4s;@B#3)&&7 a 4%%a H  ,     #6#"! H "x"$ '"*"        # l  "4 ""","  %&#%&RF f VX&   v , &  &     I  I  ( * >9  w 3  goo2 3~3j n  (    n    %  %  n  ") "     (  n  , ,8  ,@^  z Tr!