3j{LdZddlmZddlZddlmZddlmZddlmZddl m Z ddlm Z dd lm Z dd lm Z dd lmZe jd ZGd dej"ZGddeZGddeZGddeZGddeZGddeZGddeZGddeZGddeZGdd eeZGd!d"eZGd#d$eZGd%d&eZGd'd(eZGd)d*eZ Gd+d,eZ!Gd-d.eZ"Gd/d0eZ#Gd1d2eZ$Gd3d4eeZ%Gd5d6eZ&Gd7d8eZ'Gd9d:e'Z(Gd;de'Z*Gd?d@e)Z+GdAdBe)Z,GdCdDe)e(Z-GdEdFe)Z.GdGdHe)Z/GdIdJe)Z0GdKdLe/e*Z1GdMdNe)Z2GdOdPe2Z3GdQdRe2Z4GdSdTe'Z5GdUdVe5e*Z6GdWdXe jne'Z8GdYdZe jne'Z9Gd[d\e5Z:Gd]d^e5Z;Gd_d`e'Z<Gdadbe<Z=Gdcdde<Z>Gdedfe<Z?Gdgdhe?Z@Gdidje?ZAGdkdle<ZBGdmdne'ZCGdodpeCZDGdqdreCZEGdsdte'ZFGdudveFZGGdwdxe'ZHGdydzejZJegZKeLd{k(rddlZejeJyy)|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 articulationsceZdZUdZej Zded<d fd ZdZ e d dZ dZ dZ e e e d ZxZS) Articulationa  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 jt|di|d|_d|_d|_d|_d|_y)Ngg?first)super__init__ placement _volumeShift lengthShift tieAttach displayTextselfkeywords __class__s B/DATA/.local/lib/python3.12/site-packages/music21/articulations.pyrzArticulation.__init__s9 $8$#&"%%%)cy)Nrrs r _reprInternalzArticulation._reprInternalsrc\|jj}tj|dS)aj 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 rnamezArticulation.names& NN++ '' sCCrc|jSNrr"s r_getVolumeShiftzArticulation._getVolumeShifts   rc>|dkDr d}||_y|dkrd}||_y)Nr-)rvalues r_setVolumeShiftzArticulation._setVolumeShifts. 19E"RZE!ra 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)returnNone)r5str)r' __module__ __qualname____doc__r TextStyler__annotations__rr#propertyr*r.r3 volumeShift __classcell__rs@rrr_sZ+X&+__K"4*DD$!"?OB  Krrc"eZdZdZfdZxZS)LengthArticulationzL Superclass for all articulations that change the length of a note. c 2t|di|d|_yNlastrrrrrs rrzLengthArticulation.__init__ $8$rr'r8r9r:rr?r@s@rrBrBs  rrBceZdZdZy)DynamicArticulationzM Superclass for all articulations that change the dynamic of a note. Nr'r8r9r:rrrrJrJrrJceZdZdZy)PitchArticulationzK Superclass for all articulations that change the pitch of a note. NrKrrrrNrNrLrrNceZdZdZy)TimbreArticulationzL Superclass for all articulations that change the timbre of a note. NrKrrrrPrPrLrrPc"eZdZdZfdZxZS)Accentz) >>> a = articulations.Accent() c 2t|di|d|_y)Ng?rrrrrs rrzAccent.__init__s $8$rrHr@s@rrRrRs  rrRc"eZdZdZfdZxZS) 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 @t|di|d|_d|_y)Ng333333?upr)rrrpointDirectionrs rrzStrongAccent.__init__s# $8$ "rrHr@s@rrVrVs ##rrVc"eZdZdZfdZxZS)Staccatoz+ >>> a = articulations.Staccato() c @t|di|d|_d|_y)N皙?ffffff?rrrrrrs rrzStaccato.__init__# $8$ rrHr@s@rr[r[srr[c"eZdZdZfdZxZS) Staccatissimoz A very short note (derived from staccato), usually represented as a wedge. >>> a = articulations.Staccatissimo() c @t|di|d|_d|_y)Nr]g?rr_rs rrzStaccatissimo.__init__r`rrHr@s@rrbrbs rrbceZdZdZdZy)Spiccatoa$ 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 tj|t|d5tj|dddy#1swYyxYw)Nr)r[rrrR)rrs rrzSpiccato.__init__s2$ 4 / OOD !0 / /s AA N)r'r8r9r:rrrrrere s  "rrec"eZdZdZfdZxZS)Tenutoz( >>> a = articulations.Tenuto() c @t|di|d|_d|_y)N皙皙?rr_rs rrzTenuto.__init__#s# $8$!rrHr@s@rrhrhsrrhc"eZdZdZfdZxZS)DetachedLegatoz0 >>> a = articulations.DetachedLegato() c 2t|di|d|_y)Ng?r)rrrrs rrzDetachedLegato.__init__,s $8$rrHr@s@rrmrm(srrmc(eZdZdZej Zy)IndeterminateSlidez 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 N)r'r8r9r:r LineStylerrrrrprp2s//KrrpceZdZdZy)Scoopzk An indeterminateSlide coming before the main note and going up >>> a = articulations.Scoop() NrKrrrrsrs=rrsceZdZdZy)Plopzm An indeterminateSlide coming before the main note and going down. >>> a = articulations.Plop() NrKrrrrvrvErtrrvc"eZdZdZfdZxZS)Doitzj An indeterminateSlide coming after the main note and going up. >>> a = articulations.Doit() c 2t|di|d|_yrDrFrs rrz Doit.__init__RrGrrHr@s@rrxrxL   rrxc"eZdZdZfdZxZS)Falloffzo An indeterminateSlide coming after the main note and going down. >>> a = articulations.Falloff() c 2t|di|d|_yrDrFrs rrzFalloff.__init__\rGrrHr@s@rr|r|Vrzrr|c"eZdZdZfdZxZS) BreathMarkz{ Can have as a symbol 'comma' or 'tick' or None >>> a = articulations.BreathMark() >>> a.symbol = 'comma' c @t|di|d|_d|_y)Nr^r)rrrsymbolrs rrzBreathMark.__init__js" $8$ rrHr@s@rrrcs rrceZdZdZy)Caesuraz) >>> a = articulations.Caesura() NrKrrrrrorLrrc"eZdZdZfdZxZS)Stresszt An articulation indicating stress. Played a little longer and louder. >>> a = articulations.Stress() c @t|di|d|_d|_y)Nr]rkrr_rs rrzStress.__init__zr`rrHr@s@rrrts rrc"eZdZdZfdZxZS)Unstresszt An articulation indicating lack of stress. Played a little quieter. >>> a = articulations.Unstress() c 2t|di|d|_y)NrjrrTrs rrzUnstress.__init__ $8$!rrHr@s@rrrs ""rrceZdZdZy)TechnicalIndicationz TechnicalIndications (MusicXML: technical) give performance indications specific to different instrument types, such as harmonics or bowing. TechnicalIndications can include an optional content. NrKrrrrrsrrceZdZdZy)HarmoniczS A general harmonic indicator -- StringHarmonic is probably what you want. NrKrrrrrrLrrceZdZdZy)BowingzW Indication that bowing is being affected. >>> a = articulations.Bowing() NrKrrrrrrtrrc*eZdZdZdfd ZdZxZS) Fingeringa 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 Nt|di|||_d|_d|_yNFr)rr fingerNumber substitution alternate)rrrrs rrzFingering.__init__s* $8$(!rc,t|jSr,)r7rr"s rr#zFingering._reprInternals4$$%%rr,r'r8r9r:rr#r?r@s@rrrs: &rrceZdZdZy)UpBowz' >>> a = articulations.UpBow() NrKrrrrrrLrrceZdZdZy)DownBowz) >>> a = articulations.DownBow() NrKrrrrrrLrrc"eZdZdZfdZxZS)StringHarmonicae 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 @t|di|d|_d|_y)Nnaturalr)rr harmonicType pitchTypers rrzStringHarmonic.__init__s" $8$%rrHr@s@rrrs rrc eZdZy) OpenStringNr'r8r9rrrrrrrc*eZdZdZdfd ZdZxZS)StringIndicationaA 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 2t|di|||_yNrrrnumberrrrrs rrzStringIndication.__init__ $8$ rc|jSr,rr"s rr#zStringIndication._reprInternal++rrrr@s@rrr  rrceZdZdZy)StringThumbPositionz$ MusicXML -- thumb-position NrKrrrrr  rrceZdZdZy)StringFingeringzO Indicates a fingering on a specific string. Nothing special for now. NrKrrrrrrrrceZdZdZy) Pizzicatoz in MusicXML, Pizzicato is an element of every note. Here we represent pizzicatos along with all bowing marks. For pluck, see FrettedPluck. NrKrrrrr s   rrc eZdZy) SnapPizzicatoNrrrrrrrrrceZdZdZy) NailPizzicatoz$ Does not exist in MusicXML NrKrrrrrrrrc*eZdZdZdfd ZdZxZS)FretIndicationaC 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 2t|di|||_yrrrs rrzFretIndication.__init__+rrc|jSr,rr"s rr#zFretIndication._reprInternal/rrrrr@s@rrrrrrceZdZdZy) FrettedPluckzU specifies plucking fingering for fretted instruments pluck in musicxml NrKrrrrr2s   rrceZdZdZy)HammerOnzA A hammer-on represented as a spanner between two Notes. NrKrrrrr:rrrceZdZdZy)PullOffz@ A pull-off represented as a spanner between two Notes. NrKrrrrr@rrrcpeZdZUdZded<ded<ded<ded < dd d d d d  dfd ZxZS)FretBenda 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 `t|dd|i|||_||_||_||_y)Nrr)rrrrrr)rrrrrrrrs rrzFretBend.__init__ks6 33(3"   rr) rintrrrrrrrr)r'r8r9r:r<rr?r@s@rrrFsw>ED M  LP#'"I    ! rrc eZdZy)FretTapNrrrrrr{rrrc eZdZy)WindIndicationNrrrrrr~rrrc eZdZy)WoodwindIndicationNrrrrrrrrrc eZdZy)BrassIndicationNrrrrrrrrrc eZdZy)TonguingIndicationNrrrrrrrrrc eZdZy) DoubleTongueNrrrrrrrrrc eZdZy) TripleTongueNrrrrrrrrrc eZdZy)StoppedNrrrrrrrrrc"eZdZdZfdZxZS)OrganIndicationz 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 2t|di|d|_yr)rrrrs rrzOrganIndication.__init__rrrHr@s@rrrs ""rrc eZdZy) OrganHeelNrrrrrrrrrc eZdZy)OrganToeNrrrrrrrrrc eZdZy)HarpIndicationNrrrrrrrrrceZdZdZy)HarpFingerNailsz! musicXML -- fingernails NrKrrrrrrrrceZdZdZy)HandbellIndicationz 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 NrKrrrrrs  rrceZdZdZdZy)Testc2ddlm}||ty)Nr) testCopyAll)music21.test.commonTestrglobals)rrs rtestCopyAndDeepcopyzTest.testCopyAndDeepcopys7D')$rcPt}|j|jdyr,)r assertEqualr)ras r testBasiczTest.testBasics J d+rN)r'r8r9rrrrrrrs % ,rr__main__)Nr: __future__runittestmusic21rrmusic21.common.classToolsrmusic21.common.typesrrr r r Environment environLocal Music21ObjectrrBrJrNrPrRrVr[rbrerhrmrprsrvrxr|rrrrrrrrrrrrrrrrrrrrSpannerrrrrrrrrrrrrrrrrrTestCaser _DOC_ORDERr'mainTestrrrr s?@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  ,@^  zGTr