rhP%SrSSKJr SSKrSSKrSSKrSSKrSSKrSSK J r SSK J r SSK J r SSK J r SSK Jr SS K Jr SS K Jr SS K Jr SS K Jr SS K Jr SSK Jr \R*"S5r\R."SSS9r\R."SSS9r\R4(aSSKJr \R:"/SS/SQ/4PSSSS//4PSSSS //4PS!S"S#S$//4PS%S&S'S(//4PS)S*S+S,//4PS-S./S/Q/4PS0S1S2S3//4PS4S5S6S7//4PS8S9/S:Q/4PS;S//4PS?S@SASB//4PSCSDSE//4PSFSGSH//4PSISJSKSL//4PSMSNSOSP//4PSQSRSSST//4PSUSVSWSX//4PSYSZS[S\//4PS]S^S_S`//4PSaSb/ScQ/4PSdSeSf//4PSgShSi//4PSjSkSlSm//4PSnSoSpSq//4PSrSsStSu//4PSvSwSxSy//4PSzS{S|S}//4PS~SSS//4PSSSS//4PSSSS//4PSSS//4PSSSS//4PSSSS//4PSSSS//4PSSSS//4PSSSS//4PSSSS//4PSSSS//4PSSS//4PSSS//4PSSSS//4PSSSS//4PSSS//4PSSSS//4PSSSS//4PSSSS//4PSSS//4PSSS//4PSSS//4P5rS%S-S;S.r"SS\R@5r!"SS\ RD5r#"SS\R@5r$"SS\RJ5r&Sr'Sr(SSSjjr)SSjr*Sr+Sr,Sr-Sr.0r/S\0S'"SS\#5r1"SS\15r2Sr3"SS\Rh5r5"SS\Rh5r6\#\)\1\&/r7\8S:XaSSK r \ Rr"\55 gg)z An object representation of harmony, a subclass of chord, as encountered as chord symbols or roman numerals, or other chord representations with a defined root. ) annotationsN)base)chord)common)duration) environment) exceptions21)interval)key)pitch)prebase)styleharmonyT ChordSymbol)boundNCTNoChord realizerScalemajorz1,3,5)Mmajminorz1,-3,5mmin augmentedz1,3,#5+aug diminishedz1,-3,-5dimodominant-seventhz1,3,5,-77dom7 major-seventhz1,3,5,7maj7M7zminor-major-seventhz1,-3,5,7)mM7zm#7minmaj7 minor-seventhz 1,-3,5,-7m7min7zaugmented-major-seventhz1,3,#5,7z+M7augmaj7augmented-seventhz 1,3,#5,-7)z7+z+7aug7zhalf-diminished-seventhz 1,-3,-5,-7uø7m7b5diminished-seventhz 1,-3,-5,--7o7dim7zseventh-flat-fivez 1,3,-5,-7dom7dim5z major-sixthz1,3,5,66z minor-sixthz1,-3,5,6m6min6 major-ninthz 1,3,5,7,9M9Maj9dominant-ninthz 1,3,5,-7,99dom9zminor-major-ninthz 1,-3,5,7,9mM9minmaj9 minor-ninthz 1,-3,5,-7,9m9min9zaugmented-major-ninthz 1,3,#5,7,9z+M9augmaj9zaugmented-dominant-ninthz 1,3,#5,-7,9)z9#5z+9aug9zhalf-diminished-ninthz 1,-3,-5,-7,9uø9zhalf-diminished-minor-ninthz 1,-3,-5,-7,-9øb9zdiminished-ninthz 1,-3,-5,--7,9o9dim9zdiminished-minor-ninthz1,-3,-5,--7,-9ob9dimb9 dominant-11thz 1,3,5,-7,9,1111dom11 major-11thz 1,3,5,7,9,11M11Maj11zminor-major-11thz 1,-3,5,7,9,11mM11minmaj11 minor-11thz1,-3,5,-7,9,11m11min11zaugmented-major-11thz 1,3,#5,7,9,11z+M11augmaj11zaugmented-11thz1,3,#5,-7,9,11z+11aug11zhalf-diminished-11thz1,-3,-5,-7,9,11uø11zdiminished-11thz1,-3,-5,--7,9,11o11dim11 major-13thz1,3,5,7,9,11,13M13Maj13 dominant-13thz1,3,5,-7,9,11,1313dom13zminor-major-13thz1,-3,5,7,9,11,13mM13minmaj13 minor-13thz1,-3,5,-7,9,11,13m13min13zaugmented-major-13thz1,3,#5,7,9,11,13z+M13augmaj13zaugmented-dominant-13thz1,3,#5,-7,9,11,13z+13aug13zhalf-diminished-13thz1,-3,-5,-7,9,11,13uø13zsuspended-secondz1,2,5sus2suspended-fourthz1,4,5sussus4zsuspended-fourth-seventhz1,4,5,-77sus7sus4 Neapolitanz 1,-2,3,-5N6Italianz1,#4,-6zIt+6ItFrenchz 1,2,#4,-6zFr+6FrGermanz 1,-3,#4,-6zGr+6Gerpedal1powerz1,5Tristanz 1,#4,#6,#9tristan)dominant major-minorhalf-diminishedc\rSrSrSrg)HarmonyExceptionN__name__ __module__ __qualname____firstlineno____static_attributes__rI/home/james-whalen/.local/lib/python3.13/site-packages/music21/harmony.pyrrrrc^\rSrSrSr\R RS- r\Rr SSU4Sjjjr Sr Sr SrSSS jjr\S 5r\R$S 5r\S 5r\R$S 5r\S5r\R$S5r\S5r\R$S5rSS.SjrSrSrSrU=r$)Harmonya Harmony objects in music21 are a special type of chord - they retain all the same functionality as a chord (and inherit from chord directly), although they have special representations symbolically. They contain a figure representation, a shorthand, for the actual pitches they contain. This shorthand is commonly used on musical scores rather than writing out the chord pitches. Thus, each harmony object has an attribute, self.writeAsChord that dictates whether the object will be written to a score as a chord (with pitches realized) or with just the figure (as in Chord Symbols). Most users should start with the ChordSymbol class or the RomanNumeral class. The Harmony object is primarily a base object for defining other sorts of objects: >>> c6 = harmony.ChordSymbol('C/E') >>> c6 By default, Harmony objects just float above the score and are a sort of analytical object. To make them also count as pitches in a score, use `writeAsChord=True` >>> c6.writeAsChord = True >>> c6 Or individual components can be specified: >>> c6_again = harmony.ChordSymbol(root='C', bass='E', kind='major') >>> c6_again It is also possible to instantiate an empty Harmony object and then set components later, but this is an advanced and delicate operation: >>> h = harmony.ChordSymbol() >>> h.root('B-3') >>> h.bass('D', allow_add=True) >>> h.inversion(1, transposeOnSet=False) >>> h.addChordStepModification(harmony.ChordStepModification('add', 4)) >>> h >>> h = harmony.ChordSymbol('C7/E') >>> h.root() >>> h.bass() >>> h.inversion() 1 >>> h.isSeventh() True >>> [str(p) for p in h.pitches] ['E3', 'G3', 'B-3', 'C4'] >>> sus = harmony.ChordSymbol('Dsus4') >>> sus.root() Accepts a keyword 'updatePitches'. By default, it is `True`, but can be set to `False` to initialize faster if pitches are not needed. Tc >[TU]"S0UD6 SUlSUl/Ul/UlSUlURX#S9 XlUR(aUR5 SUR;a-SUR;aURURSSS9 U(aAUR(d SUR;dSUR;aUR5 URX#US9 g) NFrootbassrrT allow_addrr inversionr) super__init__ _writeAsChord_romanchordStepModifications _degreesList_key_updateFromParameters_figure _parseFigure _overridesr_updatePitches)selffigurerrr updatePitcheskeywords __class__s rrHarmony.__init__s $8$" CE#')  """8 <<      (Vt-F IIdoof-I > LL00    ! ""9"MrcURnUR(a=US- nUSRURVs/sHo"RPM sn5- nU$s snf)Nz:  )r writeAsChordjoinpitchesname)rsummaryps r _reprInternalHarmony._reprInternalsO++    tOG sxx >A >? ?G!?sA cgzB subclass this in extensions (protected in TypeScript/Java speak) Nrrs rrHarmony._parseFigure  rcgrrrs rrHarmony._updatePitchesrrcU(aP[U[5(a;[R"U5nUR [ R "USS95 OUbUR U5 UbURUSS9 U(aO[U[5(a:[R"U5nUR[ R "USS9SS9 gUbURUSS9 gg)a  This method must be called twice, once before the pitches are rendered, and once after. This is because after the pitches are rendered, the root() and bass() become reset by the chord class, but we want the objects to retain their initial root, bass, and inversion. )octaveNTtransposeOnSetr) isinstancestrrcleanedFlatNotationrr Pitchrr)rrrrs rrHarmony._updateFromParameterss JtS))--d3D IIekk$q1 2   IIdO  NN9TN : JtS))--d3D IIekk$q1TI B   IIddI +rcTURcUR5$UR$)a Get or set the figure of the harmony object. The figure is the character (string) representation of the object. For example, 'I', 'CM', '3#'. When you instantiate a harmony object, if you pass in a figure it is stored internally and returned when you access the figure property. If you don't instantiate the object with a figure, this property calls :meth:`music21.harmony.Harmony.findFigure` method which deduces the figure provided other information about the object, especially the chord. If the pitches of the harmony object have been modified after being instantiated, call :meth:`music21.harmony.Harmony.findFigure` to deduce the new figure. >>> h = harmony.ChordSymbol('CM') >>> h.figure 'CM' >>> harmony.ChordSymbol(root='C', bass='A', kind='minor').figure 'Cm/A' >>> h.bass(note.Note('E')) >>> h.figure 'CM' OMIT_FROM_DOCS Fixed storing deduced figures by avoiding duplicate chordStepModifications: >>> h = harmony.ChordSymbol('CM7omit5') >>> h.addChordStepModification(harmony.ChordStepModification(modType='add', degree=4)) >>> h.findFigure() 'Cmaj7 subtract 5 add 4' >>> h.figure 'CM7omit5' >>> h.figure = h.findFigure() >>> h.figure 'Cmaj7 subtract 5 add 4' )r findFigurers rrHarmony.figure6s&Z << ??$ $<< rctXlUR(a!UR5 UR5 ggN)rrr)rvalues rrrhs+ <<        ! rcUR$)a Gets or sets the current Key (or Scale object) associated with this Harmony object. For a given RomanNumeral object. Each sub-classed harmony object may treat this property differently, for example Roman Numeral objects update the pitches when the key is changed, but chord symbol objects do not and the key provides more information about the musical context from where the harmony object was extracted. >>> r1 = roman.RomanNumeral('V') >>> r1.pitches (, , ) >>> r1.key = key.Key('A') >>> r1.pitches (, , ) Changing the key for a ChordSymbol object does nothing to its pitches, since it's not dependent on key: >>> h1 = harmony.ChordSymbol('D-m11') >>> [str(p) for p in h1.pitches] ['D-2', 'F-2', 'A-2', 'C-3', 'E-3', 'G-3'] >>> h1.key = 'CM' # = C-Major >>> [str(p) for p in h1.pitches] ['D-2', 'F-2', 'A-2', 'C-3', 'E-3', 'G-3'] But it should change the .romanNumeral object: >>> y = harmony.ChordSymbol('F') >>> y.key is None True >>> y.romanNumeral >>> y.key = key.Key('C') >>> y.romanNumeral )rrs rr Harmony.keyosVyyrc[U[5(a[R"U5UlgXlSUlgr)rrr Keyrr)r keyOrScales rr rs+ j# & & +DI"IDKrcURcSSKJn UR(dUR 5$UR nSUlURc:URU[R"UR555UlO URXR5UlX lUR$)a, Get or set the romanNumeral numeral function of the Harmony as a :class:`~music21.romanNumeral.RomanNumeral` object. String representations accepted by RomanNumeral are also accepted. >>> h = harmony.ChordSymbol('Dmaj7') >>> h.romanNumeral >>> h.romanNumeral = 'III7' >>> h.romanNumeral >>> h.romanNumeral.key = key.Key('B') >>> h.romanNumeral >>> h.romanNumeral = roman.RomanNumeral('IV7', 'A') >>> h.romanNumeral >>> h = harmony.ChordSymbol('B-/D') >>> h.romanNumeral OMIT_FROM_DOCS Empty ChordSymbol = empty RomanNumeral: >>> harmony.ChordSymbol().romanNumeral rromanT) rmusic21rr RomanNumeralrrr romanNumeralFromChordrr)rrstoredWriteAsChords r romanNumeralHarmony.romanNumeralsF ;;  %<<))++"&!3!3  $D xx#99$ @TU #99$I !3 {{rc[US5(aSUR;aXlgSSKJn UR U5Ulg![ Ra Of=f[SU35e)Nclassesrrrz!not a valid pitch specification: ) hasattrrrrrrr Music21Exceptionr)rrrs rrrsj 5) $ $5==)HK ! ,,U3DK ,,   !B5'JKKsAAAcUR$)aO Boolean attribute of all harmony objects that specifies how this object will be written to the rendered output (such as musicxml). If `True` (default for romanNumerals), the chord with pitches is written. If False (default for ChordSymbols) the harmony symbol is written. For `NoChord` objects, writeAsChord means to write as a rest. )rrs rrHarmony.writeAsChords!!!rcXlU(a7URRS:Xa[R"S5Ulggg)Nrr)rr quarterLengthDuration)rvals rrrs7  4==..!3$--a0DM43rrc[U[5(d[SU35eXR;aURR U5 U(aUR 5 gg)a Add a harmony degree specification to this Harmony as a :class:`~music21.harmony.ChordStepModification` object. >>> hd = harmony.ChordStepModification('add', 4) >>> h = harmony.ChordSymbol() >>> h.addChordStepModification(hd) >>> h.addChordStepModification('juicy') Traceback (most recent call last): music21.harmony.HarmonyException: cannot add this object as a degree: juicy Alteration will also impact the pitches, if the keyword argument updatePitches is given as True >>> h = harmony.ChordSymbol('C') >>> mod = harmony.ChordStepModification('alter', 5, -1) >>> h.addChordStepModification(mod, updatePitches=True) >>> h.pitches (, , ) * Changed in v7: updatePitches is True by default z$cannot add this object as a degree: N)rChordStepModificationrrappendr)rdegreers raddChordStepModification Harmony.addChordStepModificationsc.&"788#6vh?A A 44 4  ' ' . .v 6     ! rcg)NzNo Figure Representationrrs rrHarmony.findFigures)rcUR$)z' Return all harmony degrees as a list. )rrs rgetChordStepModifications!Harmony.getChordStepModificationss***r)rrrrrrrr)NNNNT) r str | Nonerstr | pitch.Pitch | Nonerrr int | Nonerboolr)rrrrrrreturnNone)rrrr__doc__r Music21ObjectclassSortOrderr TextStyle _styleClassrrrrrpropertyrsetterr rrrrrr __classcell__rs@rrrsBH''66:N//K %).2.2'+'+ +N!+N++N,+N% +N !% +N+N^ # ,",#, ,  ,>/ / b ]]"" **X ZZ//b L L""11AE "D*++rrc\rSrSrSrg)ChordStepModificationExceptioni)rNrrrrrr)rrrc\rSrSrSrSSSjjrSrSr\S5r \ RS5r \S 5r \ RS 5r \S 5r \ RS 5r S r g)ri/a ChordStepModification objects define the specification of harmony degree alterations, subtractions, or additions, used in :class:`~music21.harmony.Harmony` objects, which includes harmony.ChordSymbol objects (and will include harmony.RomanNumeral objects). - degree-value element: indicates degree in chord, positive integers only - degree-alter: indicates semitone alteration of degree, positive and negative integers only - degree-type: add, alter, or subtract - if `add`: degree-alter is relative to a dominant chord (major and perfect intervals except for a minor seventh) - if `alter` or `subtract`: degree-alter is relative to degree already in the chord based on its kind element >>> hd = harmony.ChordStepModification('add', 4) >>> hd > >>> hd = harmony.ChordStepModification('alter', 3, 1) >>> hd > NcSUlU SUlUbXlUbX lUbX0lg[R "S5Ulg)NP1)_modType_degreemodTyperr Interval)rrr intervalObjs rrChordStepModification.__init__esF"&  !%  "L   K  "'M$--d3DMrcTSURSURSUR3$)NzmodType=z degree=z interval=)rrr rs rr#ChordStepModification._reprInternalus'$,,x }Jt}}oVVrc[U[5=(aY URUR:H=(a9 URUR:H=(a URUR:H$r)rrrrr )rothers r__eq__ChordStepModification.__eq__xsS u3 4 0  - 0 u||+ 0 /  rcUR$)a2 Returns or sets an integer specifying the scale degree that this ChordStepModification alters. >>> hd = harmony.ChordStepModification() >>> hd.degree = 3 >>> hd.degree 3 >>> hd.degree = 'juicy' Traceback (most recent call last): music21.harmony.ChordStepModificationException: not a valid degree: juicy )rrs rrChordStepModification.degrees||rc|Ub,[R"U5(a[U5Ulg[ SU35e)Nznot a valid degree: )risNumintrrrexprs rrrs;   T 2 2t9DL ,"4& )+ +rcUR$)a{ Get or set the alteration of this degree as a :class:`~music21.interval.Interval` object, generally as a type of ascending or descending augmented unison. >>> hd = harmony.ChordStepModification() >>> hd.interval = 1 >>> hd.interval >>> hd.interval = -2 >>> hd.interval >>> hd.interval = 0 >>> hd.interval >>> hd.interval = interval.Interval('m3') >>> hd.interval More than 3 half step alteration gets an interval that isn't a prime. >>> hd.interval = -4 >>> hd.interval ) _intervalrs rr ChordStepModification.intervals>~~rc8US;aSUlg[U[R5(aXlg[ U5nUS::a:US:XaSnOSU-nUS- nUS:aUS- n[R"U5Ulg[R"U5Ulg)NrrrParw-)rrr rabs)rrnumAsaStrs rr rs G !DN x00 1 1"NJEzA:D;D 19CKD!)!2!24!8!)!2!25!9rcUR$)ag Get or set the ChordStepModification modification type, where permitted types are the strings add, subtract, or alter. >>> hd = harmony.ChordStepModification() >>> hd.modType = 'add' >>> hd.modType 'add' >>> hd.modType = 'juicy' Traceback (most recent call last): music21.harmony.ChordStepModificationException: not a valid degree modification type: juicy )rrs rrChordStepModification.modTypes}}rcUb?[U[5(a*UR5S;aUR5Ulg[ SU35e)N)addsubtractalterz¬ a valid degree modification type: )rrlowerrrrs rrr sJ   4 5 5zz|;; $  ,4TF ;= =r)rrrrr r)NNNrr)rrrrrrrr rrrr rrrrrrr/sj 4 W   ]]++@__::*  ^^==rrcX/[U'g)a{ Add a new chord symbol: >>> harmony.addNewChordSymbol('BethChord', '1,3,-6,#9', ['MH', 'beth']) >>> [str(p) for p in harmony.ChordSymbol('BMH').pitches] ['B2', 'C##3', 'D#3', 'G3'] >>> harmony.ChordSymbol('Cbeth').pitches (, , , ) >>> harmony.ChordSymbol('C-beth').pitches (, , , ) OMIT_FROM_DOCS >>> harmony.ChordSymbol(root='Cb', kind='BethChord').pitches (, , , ) >>> harmony.ChordSymbol(root='C-', kind='BethChord').pitches (, , , ) >>> harmony.removeChordSymbols('BethChord') N CHORD_TYPES) chordTypeNamefbNotationStringAbbreviationLists raddNewChordSymbolr-s:#3!EK rc<[USRSU5 g)aq Change the current Abbreviation used for a certain :class:`music21.harmony.ChordSymbol` chord type >>> harmony.getCurrentAbbreviationFor('minor') 'm' >>> harmony.changeAbbreviationFor('minor', 'min') >>> harmony.getCurrentAbbreviationFor('minor') 'min' OMIT_FROM_DOCS >>> harmony.changeAbbreviationFor('minor', 'm') # must change it back for the rest of doctests rrN)r)insert) chordTypechangeTos rchangeAbbreviationForr2s  1$$Q1rc : UR(dgUR5 [ UR5S:XaCU(aUR5R S-S4$UR5R S-$URS5nURS5nURS5nURS5nURS 5nURS 5nUn Un Un SS jn S=pUR5nUR5nS n[GHxn[U5n[U5nU"UU5n[R"U5(dU/n[R"U5(dM^[ U5S:Xa*U(a#U "X44U5(aU(a UnUS n MMM[ U5S:Xa"U(aU "X4U4U5(a UnUS n MM[ U5S :Xa1U(a*U(d#U(dU "X4XV4USS9(a UnUS n GMGM[ U5S:Xa+U(a$U(dU "X4XVU4USS9(a UnUS n GM?GMB[ U5S :XdGMTU(dGM^U "X4XVXx4USS9(dGMqUnUS n GM{ U(Gd,S n[GHn[U5n[U5nU"UU5n[R"U5(dU/n[R"U5(dM^URSS5RSS5nUR!S5nUVs/sHn[#U5PM nnUR%5 XXXXgUS. n/nUHnUS:wdM UR'UU5 M! U "UU5(dMU[ U5:dGM [ U5nUnUS n GM" U(GaUR)5(aU S:XaAURUR+55 Sn SnUR5R U -nOYUR5R U -S-UR+5R -nOUR5R U -n[-U5RVs1sHnUR iM nnURVs1sHnUR iM nnUR/U5(daUR1U5n UR1U5n!U (aUS- nU H n"UU"S-- nM U!(aUS- nU!H nUUS-- nM USSnOSnU(aUU4$U$![an[[ U55UeSnAff=fs snfs snfs snf)u/ Analyze the given chord, and attempt to describe its pitches using a standard chord symbol figure. The pitches of the chord are analyzed based on intervals, and compared to standard triads, sevenths, ninths, elevenths, and thirteenth chords. The type of chord therefore is determined if it matches (given certain guidelines documented below) and the figure is returned. There is no standard "chord symbol" notation, so a typical notation is used that can be easily modified if desired by changing a dictionary in the source code. Set includeChordType to true (default is False) to return a tuple, the first element being the figure and the second element the identified chord type. >>> harmony.chordSymbolFigureFromChord(chord.Chord(['C3', 'E3', 'G3'])) 'C' THIRDS >>> c = chord.Chord(['C3', 'E3', 'G3']) >>> harmony.chordSymbolFigureFromChord(c, True) ('C', 'major') >>> c = chord.Chord(['B-3', 'D-4', 'F4']) >>> harmony.chordSymbolFigureFromChord(c, True) ('B-m', 'minor') >>> c = chord.Chord(['F#3', 'A#3', 'C##4']) >>> harmony.chordSymbolFigureFromChord(c, True) ('F#+', 'augmented') >>> c = chord.Chord(['C3', 'E-3', 'G-3']) >>> harmony.chordSymbolFigureFromChord(c, True) ('Cdim', 'diminished') SEVENTHS >>> c = chord.Chord(['E-3', 'G3', 'B-3', 'D-4']) >>> harmony.chordSymbolFigureFromChord(c, True) ('E-7', 'dominant-seventh') >>> c = chord.Chord(['C3', 'E3', 'G3', 'B3']) >>> harmony.chordSymbolFigureFromChord(c, True) ('Cmaj7', 'major-seventh') >>> c = chord.Chord(['F#3', 'A3', 'C#4', 'E#4']) >>> harmony.chordSymbolFigureFromChord(c, True) ('F#mM7', 'minor-major-seventh') >>> c = chord.Chord(['F3', 'A-3', 'C4', 'E-4']) >>> harmony.chordSymbolFigureFromChord(c, True) ('Fm7', 'minor-seventh') >>> c = chord.Chord(['F3', 'A3', 'C#4', 'E4']) >>> harmony.chordSymbolFigureFromChord(c, True) ('F+M7', 'augmented-major-seventh') >>> c = chord.Chord(['C3', 'E3', 'G#3', 'B-3']) >>> harmony.chordSymbolFigureFromChord(c, True) ('C7+', 'augmented-seventh') >>> c = chord.Chord(['G3', 'B-3', 'D-4', 'F4']) >>> harmony.chordSymbolFigureFromChord(c, True) ('Gø7', 'half-diminished-seventh') >>> c = chord.Chord(['C3', 'E-3', 'G-3', 'B--3']) >>> harmony.chordSymbolFigureFromChord(c, True) ('Co7', 'diminished-seventh') >>> c = chord.Chord(['B-3', 'D4', 'F-4', 'A-4']) >>> harmony.chordSymbolFigureFromChord(c, True) ('B-dom7dim5', 'seventh-flat-five') NINTHS >>> c = chord.Chord(['C3', 'E3', 'G3', 'B3', 'D3']) >>> harmony.chordSymbolFigureFromChord(c, True) ('CM9', 'major-ninth') >>> c = chord.Chord(['B-3', 'D4', 'F4', 'A-4', 'C4']) >>> harmony.chordSymbolFigureFromChord(c, True) ('B-9', 'dominant-ninth') >>> c = chord.Chord(['E-3', 'G-3', 'B-3', 'D4', 'F3']) >>> harmony.chordSymbolFigureFromChord(c, True) ('E-mM9', 'minor-major-ninth') >>> c = chord.Chord(['C3', 'E-3', 'G3', 'B-3', 'D3']) >>> harmony.chordSymbolFigureFromChord(c, True) ('Cm9', 'minor-ninth') >>> c = chord.Chord(['F#3', 'A#3', 'C##4', 'E#4', 'G#3']) >>> harmony.chordSymbolFigureFromChord(c, True) ('F#+M9', 'augmented-major-ninth') >>> c = chord.Chord(['G3', 'B3', 'D#4', 'F4', 'A3']) >>> harmony.chordSymbolFigureFromChord(c, True) ('G9#5', 'augmented-dominant-ninth') >>> c = chord.Chord(['C3', 'E-3', 'G-3', 'B-3', 'D3']) >>> harmony.chordSymbolFigureFromChord(c, True) ('Cø9', 'half-diminished-ninth') >>> c = chord.Chord(['B-3', 'D-4', 'F-4', 'A-4', 'C-4']) >>> harmony.chordSymbolFigureFromChord(c, True) ('B-øb9', 'half-diminished-minor-ninth') >>> c = chord.Chord(['C3', 'E-3', 'G-3', 'B--3', 'D3']) >>> harmony.chordSymbolFigureFromChord(c, True) ('Co9', 'diminished-ninth') >>> c = chord.Chord(['F3', 'A-3', 'C-4', 'E--4', 'G-3']) >>> harmony.chordSymbolFigureFromChord(c, True) ('Fob9', 'diminished-minor-ninth') This harmony can either be CmaddD or Csus2addE-. music21 prefers the former. Change the ordering of harmony.CHORD_TYPES to switch the preference. From Bach BWV380 >>> c = chord.Chord(['C3', 'D4', 'G4', 'E-5']) >>> harmony.chordSymbolFigureFromChord(c, True) ('CmaddD', 'minor') ELEVENTHS >>> c = chord.Chord(['E-3', 'G3', 'B-3', 'D-4', 'F3', 'A-3'] ) >>> harmony.chordSymbolFigureFromChord(c, True) ('E-11', 'dominant-11th') >>> c = chord.Chord(['G3', 'B3', 'D4', 'F#4', 'A3', 'C4']) >>> harmony.chordSymbolFigureFromChord(c, True) ('GM11', 'major-11th') >>> c = chord.Chord(['C3', 'E-3', 'G3', 'B3', 'D3', 'F3']) >>> harmony.chordSymbolFigureFromChord(c, True) ('CmM11', 'minor-major-11th') >>> c = chord.Chord(['F#3', 'A3', 'C#4', 'E4', 'G#3', 'B3']) >>> harmony.chordSymbolFigureFromChord(c, True) ('F#m11', 'minor-11th') >>> c = chord.Chord(['B-3', 'D4', 'F#4', 'A4', 'C4', 'E-4']) >>> harmony.chordSymbolFigureFromChord(c, True) ('B-+M11', 'augmented-major-11th') >>> c = chord.Chord(['F3', 'A3', 'C#4', 'E-4', 'G3', 'B-3']) >>> harmony.chordSymbolFigureFromChord(c, True) ('F+11', 'augmented-11th') >>> c = chord.Chord(['G3', 'B-3', 'D-4', 'F4', 'A3', 'C4']) >>> harmony.chordSymbolFigureFromChord(c, True) ('Gø11', 'half-diminished-11th') >>> c = chord.Chord(['E-3', 'G-3', 'B--3', 'D--4', 'F3', 'A-3']) >>> harmony.chordSymbolFigureFromChord(c, True) ('E-o11', 'diminished-11th') THIRTEENTHS These are so tricky: music21 needs to be told what the root is in these cases all tests here are 'C' chords, but any root will work: >>> c = chord.Chord(['C3', 'E3', 'G3', 'B3', 'D4', 'F4', 'A4']) >>> c.root('C3') >>> harmony.chordSymbolFigureFromChord(c, True) ('CM13', 'major-13th') >>> c = chord.Chord(['C3', 'E3', 'G3', 'B-3', 'D4', 'F4', 'A4']) >>> c.root('C3') >>> harmony.chordSymbolFigureFromChord(c, True) ('C13', 'dominant-13th') >>> c = chord.Chord(['C3', 'E-3', 'G3', 'B3', 'D4', 'F4', 'A4']) >>> c.root('C3') >>> harmony.chordSymbolFigureFromChord(c, True) ('CmM13', 'minor-major-13th') >>> c = chord.Chord(['C3', 'E-3', 'G3', 'B-3', 'D4', 'F4', 'A4']) >>> c.root('C3') >>> harmony.chordSymbolFigureFromChord(c, True) ('Cm13', 'minor-13th') >>> c = chord.Chord(['C3', 'E3', 'G#3', 'B3', 'D4', 'F4', 'A4']) >>> c.root('C3') >>> harmony.chordSymbolFigureFromChord(c, True) ('C+M13', 'augmented-major-13th') >>> c = chord.Chord(['C3', 'E3', 'G#3', 'B-3', 'D4', 'F4', 'A4']) >>> c.root('C3') >>> harmony.chordSymbolFigureFromChord(c, True) ('C+13', 'augmented-dominant-13th') >>> c = chord.Chord(['C3', 'E-3', 'G-3', 'B-3', 'D4', 'F4', 'A4']) >>> c.root('C3') >>> harmony.chordSymbolFigureFromChord(c, True) ('Cø13', 'half-diminished-13th') Pop chords are typically not always "strictly" spelled and often certain degrees are omitted. Therefore, the following common chord omissions are permitted and the chord will still be identified correctly: * triads: none * seventh chords: none * ninth chords: fifth * eleventh chords: third and/or fifth * thirteenth chords: fifth, eleventh, ninth This chord could be minor 7th with a C4, but because this 5th is not present, it is not identified. >>> c = chord.Chord(['F3', 'A-3', 'E-4']) >>> harmony.chordSymbolFigureFromChord(c) 'Chord Symbol Cannot Be Identified' Removing the fifth G3 (fifth of chord) >>> c = chord.Chord(['C3', 'E3', 'B3', 'D3']) >>> harmony.chordSymbolFigureFromChord(c, True) ('CM9', 'major-ninth') Chord with G3 and B-3 removed (3rd & 5th of chord) >>> c = chord.Chord(['E-3', 'D-4', 'F3', 'A-3'] ) Without a 3rd and 5th, root() algorithm can't locate the root, so we must tell it the root (or write an algorithm that assumes the root is the lowest note if the root can't be found) >>> c.root('E-3') >>> harmony.chordSymbolFigureFromChord(c, True) ('E-11', 'dominant-11th') Inversions are supported, and indicated with a '/' between the root, type-string, and bass >>> c = chord.Chord([ 'G#3', 'B-3', 'C4', 'E4',]) >>> harmony.chordSymbolFigureFromChord(c, True) ('C7+/G#', 'augmented-seventh') >>> c = chord.Chord(['G#2', 'B2', 'F#3', 'A3', 'C#4', 'E4']) >>> harmony.chordSymbolFigureFromChord(c, True) ('F#m11/G#', 'minor-11th') if the algorithm matches the chord, but omissions or subtractions are present, the chord symbol attempts to indicate this (although there is no standard way of doing this so the notation might be different from what you're familiar with). An example of using this algorithm for identifying chords "in the wild": >>> score = corpus.parse('bach/bwv380') >>> excerpt = score.measures(2, 3) >>> chfy = excerpt.chordify() >>> for c in chfy.flatten().getElementsByClass(chord.Chord): ... print(harmony.chordSymbolFigureFromChord(c)) B-7 E-maj7/B- B-7 Chord Symbol Cannot Be Identified B-7 E- B- Chord Symbol Cannot Be Identified B-/D B-7 CmaddD Cm/D E-+M7/D Cm/E- F7 Notice, however, that this excerpt contains many embellishment and non-harmonic tones, so an algorithm to truly identify the chord symbols must be as complex as any harmonic analysis algorithm, which this is not, so innately this method is flawed. And for the sake of completeness, unique chords supported by musicxml that this method can still successfully identify. Notice that the root must often be specified for this method to work. >>> c = chord.Chord(['C3', 'D3', 'G3']) >>> harmony.chordSymbolFigureFromChord(c, True) ('Csus2', 'suspended-second') >>> c.root() >>> c.bass() >>> c = chord.Chord(['C3', 'F3', 'G3']) >>> harmony.chordSymbolFigureFromChord(c, True) ('Csus', 'suspended-fourth') >>> c.root() >>> c.inversion() 0 >>> c = chord.Chord(['C3', 'D-3', 'E3', 'G-3']) >>> harmony.chordSymbolFigureFromChord(c, True) ('CN6', 'Neapolitan') >>> c = chord.Chord(['C3', 'F#3', 'A-3']) >>> c.root('C3') >>> harmony.chordSymbolFigureFromChord(c, True) ('CIt+6', 'Italian') >>> c = chord.Chord(['C3', 'D3', 'F#3', 'A-3']) >>> c.root('C3') >>> harmony.chordSymbolFigureFromChord(c, True) ('CFr+6', 'French') >>> c = chord.Chord(['C3', 'E-3', 'F#3', 'A-3']) >>> c.root('C3') >>> harmony.chordSymbolFigureFromChord(c, True) ('CGr+6', 'German') >>> eflat = chord.Chord(['E-3']) >>> harmony.chordSymbolFigureFromChord(eflat, True) ('E-pedal', 'pedal') >>> c = chord.Chord(['C3', 'G3']) >>> harmony.chordSymbolFigureFromChord(c, True) ('Cpower', 'power') >>> c = chord.Chord(['F3', 'G#3', 'B3', 'D#4'] ) >>> c.root('F3') >>> harmony.chordSymbolFigureFromChord(c, True) ('Ftristan', 'Tristan') This algorithm works as follows: 1. chord is analyzed for root (using chord's root() ) if the root cannot be determined, error is raised be aware that the root() method determines the root based on which note has the most thirds above it this is not a consistent way to determine the root of 13th chords, for example 2. a chord vector is extracted from the chord using :meth:`music21.chord.Chord.semitonesFromChordStep` this vector extracts the following degrees: (2, 3, 4, 5, 6, 7, 9, 11, and 13) 3. this vector is converted to fbNotationString (in the form of chord step, and a '-' or '#' to indicate semitone distance) 4. the fbNotationString is matched against the CHORD_TYPES dictionary in this harmony module, although certain subtractions are permitted for example a 9th chord will still be identified correctly even if it is missing the 5th 5. the type with the most identical matches is used, and if no type matches, "Chord Type Cannot Be Identified" is returned 6. the output format for the chord symbol figure is the chord's root, the chord type's Abbreviation (saved in CHORD_TYPES dictionary), a '/' if the chord is in an inversion, and the chord's bass The chord symbol nomenclature is not entirely standardized. There are several ways to write each abbreviation. For example, an augmented triad might be symbolized with '+' or 'aug'. Thus, by default the returned symbol is the first (element 0) in the CHORD_TYPES list. For example (Eb minor eleventh chord, second inversion): root + chord-type-str + '/' + bass = 'E-min11/B-' Users who wish to change these defaults can simply change that entry in the CHORD_TYPES dictionary. >>> harmony.chordSymbolFigureFromChord(chord.Chord(['C2', 'E2', 'G2'])) 'C' >>> harmony.changeAbbreviationFor('major', 'maj') >>> harmony.chordSymbolFigureFromChord(chord.Chord(['C2', 'E2', 'G2'])) 'Cmaj' OMIT_FROM_DOCS >>> harmony.changeAbbreviationFor('major', '') rNrrvrc[U5nU[U5:agUS:a"USUS:waSU;aUSS:XaUSbgUS:a"USUS:waSU;aUSS:XaUSbgUS:a"USUS:waSU;aUSS :XaUSbgUS:a"USUS:waS U;aUSS:XaUSbgUS:a"USUS:waS U;aUSS:XaUSbgUS :a"USUS:waS U;aUSS :XaUSbgg )a, inChord is the chord the user submits to analyze, givenChordNum is the chord type that the method is currently looking at to determine if it could be a match for inChord the corresponding semitones are compared, and if they do not match it is determined whether this is a permitted omission, etc. Frrrr7r6r4r5 r8 T)len) inChordNumsgivenChordNumspermittedOmissionsrs rcompare+chordSymbolFigureFromChord..comparesw   s;  6k!nq(99,,1Ba1G"1~1 6k!nq(99,,1Ba1G"1~1 6k!nq(99,,1Bb1H"1~1 6k!nq(99,,1Ba1G"1~1 6k!nq(99--.2Cq2H"1~1 6k!nq(99--.2Cq2H"1~1rc vSSSSSSSSSS. n/nU[;a [UnU[;aURS5HxnUS :XaM S U;aURS 5S -nOURS 5n[ UR S S 5R S S 55nUR X&U-5 Mz U$)Nr7r5r:r6r4r;) rr4r5r;r:r<r6r7r8,rwr#r) CHORD_ALIASESr)splitcountrreplacer) innerKind fbNotationtypesinner_chordDegreescharaltrs r convertFBNotationStringToDegreesDchordSymbolFigureFromChord..convertFBNotationStringToDegreess     %%i0I  #"((-3;$;**S/B.C**S/CT\\#r2::3CD"))%-#*=>."!rr)r4)r@)rr4)r4r:r;rrFrD) r6rr7r4r8r5r;r:r<rhrjri/r"omitrE!Chord Symbol Cannot Be Identified)r)rr Exceptionrrr=rsemitonesFromChordStepisTriad isSeventhr)!getAbbreviationListGivenChordTypegetNotationStringGivenChordTyper isListLikerJrHrsortrrrr issuperset difference)#inChordincludeChordTypeed3d5d7d9d11d13d2d4d6rAkindStrkindrXrYrQ chordKind chordKindStrr+ chordDegreesnumberOfMatchedDegreessdegreesxdata toComparecsrperfect inPitches additions subtractionsrs# rchordSymbolFigureFromChordr|#s-l ??.  7??q LLN'''17; ;<<>&&0 0  ' ' *B  ' ' *B  ' ' *B  ' ' *B  ( ( +C  ( ( +C B B B&PGooG!!#I":![ 8C :9E7 CST   ..(>L   \ * *< A%'B8\22w$D*1oG8?2\"a'IBB<66$D*1oG7\"a'Bs3BB+\dS$D*1oGT\"a'CBBC0,SYZ$D*1oG[\"a'CCBBC5|Xbcc$D*1oG7!: !"$IyI ;IGWXL$$\22 ,~   ..$,,S"5==c2F''#,+237a3q673 rRVYZ  AAv!((a1!9l33-L0AA14\1B.(".q/1%4     &  W\\^,)\\^((72\\^((72S87<<>;N;NN$$w.B#.r?#:#:;#:a166#:;%,__5_QVV_ 5!!),,!,,W5I"--i8Le "A1s7OB#f %A1s7OB&CRB 0Dz m .s1v&A-.L48<5s)U'?V"VV' V 1VV cP[[U55nURUlU$)a; Get the :class:`~music21.harmony.chordSymbol` object from the chord, using :meth:`music21.harmony.Harmony.chordSymbolFigureFromChord` >>> c = chord.Chord(['D3', 'F3', 'A4', 'B-5']) >>> symbol = harmony.chordSymbolFromChord(c) >>> symbol >>> c.pitches == symbol.pitches True )rr|r)r`rws rchordSymbolFromChordr~Ws$ /8 9BBJ Irc[US$)z Get the Abbreviation list (all allowed Abbreviations that map to this :class:`music21.harmony.ChordSymbol` object): >>> harmony.getAbbreviationListGivenChordType('minor-major-13th') ['mM13', 'minmaj13'] rr(r0s rrZrZh y !! $$rc[U5S$)z Return the current Abbreviation for a given :class:`music21.harmony.ChordSymbol` chordType: >>> harmony.getCurrentAbbreviationFor('dominant-seventh') '7' r)rZrs rgetCurrentAbbreviationForrts -Y 7 ::rc[US$)z Get the notation string (fb-notation style) associated with this :class:`music21.harmony.ChordSymbol` chordType >>> harmony.getNotationStringGivenChordType('German') '1,-3,#4,-6' rr(rs rr[r[rrc[U g)z~ Remove the given chord type from the CHORD_TYPES dictionary, so it can no longer be identified or parsed by harmony methods. Nr(rs rremoveChordSymbolsrs Irz5dict[tuple[str, str], realizerScale.FiguredBassScale]realizerScaleCachec^\rSrSrSrSSU4SjjjrSrSSjrSSjrSr Sr S r S r SS jr S rS rSrSS.SU4SjjjrSrU=r$)ria Class representing the Chord Symbols commonly found on lead sheets. Chord Symbol objects can be instantiated one of two main ways: 1. when music xml is parsed by the music21 converter, xml Chord Symbol tags are interpreted as Chord Symbol objects with a root and kind attribute. If bass is not specified, the bass is assumed to be the root 2. by creating a chord symbol object with music21 by passing in the expression commonly found on leadsheets. Due to the relative diversity of lead sheet chord syntax, not all expressions are supported. Consult the examples for the supported syntax, or email us for help. All :class:`~music21.harmony.ChordSymbol` inherit from :class:`~music21.chord.Chord` so you can consider these objects as chords, although they have a unique representation in a score. ChordSymbols, unlike chords, by default appear as chord symbols in a score and have duration of 0. To obtain the chord representation of the `ChordSymbol` in the score, change :attr:`~music21.harmony.Harmony.writeAsChord` to True. Unless otherwise specified, the duration of this chord object will become 1.0. If you have a leadsheet, run :func:`music21.harmony.realizeChordSymbolDurations` on the stream to assign the correct (according to offsets) duration to each harmony object.) The music xml-based approach to instantiating Chord Symbol objects: >>> cs = harmony.ChordSymbol(kind='minor', kindStr='m', root='C', bass='E-') >>> cs >>> cs.chordKind 'minor' >>> cs.root() >>> cs.bass() The second approach to creating a Chord Symbol object, by passing a regular expression (this list is not exhaustive): >>> symbols = ['', 'm', '+', 'dim', '7', ... 'M7', 'm7', 'dim7', '7+', 'm7b5', # half-diminished ... 'mM7', '6', 'm6', '9', 'Maj9', 'm9', ... '11', 'Maj11', 'm11', '13', ... 'Maj13', 'm13', 'sus2', 'sus4', ... 'N6', 'It+6', 'Fr+6', 'Gr+6', 'pedal', ... 'power', 'tristan', '/E', 'm7/E-', 'add2', ... '7omit3',] >>> for s in symbols: ... chordSymbolName = 'C' + s ... h = harmony.ChordSymbol(chordSymbolName) ... pitchNames = [str(p) for p in h.pitches] ... print('%-10s%s' % (chordSymbolName, '[' + (', '.join(pitchNames)) + ']')) C [C3, E3, G3] Cm [C3, E-3, G3] C+ [C3, E3, G#3] Cdim [C3, E-3, G-3] C7 [C3, E3, G3, B-3] CM7 [C3, E3, G3, B3] Cm7 [C3, E-3, G3, B-3] Cdim7 [C3, E-3, G-3, B--3] C7+ [C3, E3, G#3, B-3] Cm7b5 [C3, E-3, G-3, B-3] CmM7 [C3, E-3, G3, B3] C6 [C3, E3, G3, A3] Cm6 [C3, E-3, G3, A3] C9 [C3, E3, G3, B-3, D4] CMaj9 [C3, E3, G3, B3, D4] Cm9 [C3, E-3, G3, B-3, D4] C11 [C2, E2, G2, B-2, D3, F3] CMaj11 [C2, E2, G2, B2, D3, F3] Cm11 [C2, E-2, G2, B-2, D3, F3] C13 [C2, E2, G2, B-2, D3, F3, A3] CMaj13 [C2, E2, G2, B2, D3, F3, A3] Cm13 [C2, E-2, G2, B-2, D3, F3, A3] Csus2 [C3, D3, G3] Csus4 [C3, F3, G3] CN6 [C3, D-3, E3, G-3] CIt+6 [C3, F#3, A-3] CFr+6 [C3, D3, F#3, A-3] CGr+6 [C3, E-3, F#3, A-3] Cpedal [C3] Cpower [C3, G3] Ctristan [C3, D#3, F#3, A#3] C/E [E3, G3, C4] Cm7/E- [E-3, G3, B-3, C4] Cadd2 [C3, D3, E3, G3] C7omit3 [C3, G3, B-3] You can also create a Chord Symbol by writing out each degree, and any alterations to that degree: You must explicitly indicate EACH degree (a triad is NOT necessarily implied) >>> [str(p) for p in harmony.ChordSymbol('C35b7b9#11b13').pitches] ['C2', 'E2', 'G2', 'D-3', 'F#3', 'A-3', 'B-3'] >>> [str(p) for p in harmony.ChordSymbol('C35911').pitches] ['C2', 'E2', 'G2', 'D3', 'F3'] to prevent ambiguity in notation and in accordance with the rest of music21, if a root or bass is flat, the '-' must be used, and NOT 'b'. However, alterations and chord abbreviations are specified normally with the 'b' and '#' signs. >>> dFlat = harmony.ChordSymbol('D-35') >>> [str(p) for p in dFlat.pitches] ['D-3', 'F3', 'A-3'] >>> [str(p) for p in harmony.ChordSymbol('Db35').pitches] ['D3', 'F3', 'A3'] (Note that this would be much better expressed just as 'Dm'.) >>> [str(p) for p in harmony.ChordSymbol('D,35b7b9#11b13').pitches] ['D2', 'F#2', 'A2', 'E-3', 'G#3', 'B-3', 'C4'] >>> harmony.ChordSymbol('Am').pitches (, , ) >>> harmony.ChordSymbol('A-m').pitches (, , ) >>> harmony.ChordSymbol('A-m').pitches (, , ) >>> harmony.ChordSymbol('F-dim7').pitches (, , , ) Thanks to David Bolton for catching the bugs tested below: >>> [str(p) for p in harmony.ChordSymbol('C3579').pitches] ['C2', 'E2', 'G2', 'D3', 'B3'] >>> [str(p) for p in harmony.ChordSymbol('C35b79').pitches] ['C2', 'E2', 'G2', 'D3', 'B-3'] >>> [str(p) for p in harmony.ChordSymbol('C357b9').pitches] ['C2', 'E2', 'G2', 'D-3', 'B3'] When bass is not in chord: >>> cs = harmony.ChordSymbol(root='E', bass='C', kind='diminished-seventh') >>> [str(p) for p in cs.pitches] ['C2', 'E3', 'G3', 'B-3', 'D-4'] >>> cs.figure 'Eo7/C' And now, and example of parsing in the wild: >>> s = corpus.parse('leadsheet/fosterBrownHair') >>> initialSymbols = s.flatten().getElementsByClass(harmony.ChordSymbol)[0:5] >>> [[str(c.name) for c in c.pitches] for c in initialSymbols] [['F', 'A', 'C'], ['B-', 'D', 'F'], ['F', 'A', 'C'], ['C', 'E', 'G'], ['F', 'A', 'C']] Test creating an empty chordSymbol: >>> cs = harmony.ChordSymbol() >>> cs >>> cs.root('E-') >>> cs.bass('B-', allow_add=True) important: we are not asking for transposition, merely specifying the inversion that the chord should be read in (transposeOnSet = False) >>> cs.inversion(2, transposeOnSet=False) >>> cs.romanNumeral = 'I64' >>> cs.chordKind = 'major' >>> cs.chordKindStr = 'M' >>> cs c >XPlX`l[TU] "U4X#US.UD6 SU;a!SU;a[R "S5UlUR(dUR(aUR 5 gg)Nrrrr)rnrorrrrr) rrrrrrmrlrrs rrChordSymbol.__init__Tsj# WdWhW X %/*I$--a0DM >>T..    !/rcT[U[5(d [U5n/SQn/SQn/SQnURU;aD[R"USR [ USRS-5-5US'GOnURU;a[R"USR [ USRS-5-5US'[R"USR [ USRS-5-5US'OURU;a[R"USR [ USRS-5-5US'[R"USR [ USRS-5-5US'[R"USR [ USRS-5-5US'OU$[R"U5nUR5n[UR5$)Nr=r:rBrLrOrTr^r[rcrrr4) rlistrnr rrrrrChordsortDiatonicAscendingr)rrninths elevenths thirteenthscs r_adjustOctavesChordSymbol._adjustOctaveshs'4((7mG BA C >>V #WQZ__s71:;L;Lq;P7Q%QRGAJ ^^y (WQZ__s71:;L;Lq;P7Q%QRGAJWQZ__s71:;L;Lq;P7Q%QRGAJ ^^{ *WQZ__s71:;L;Lq;P7Q%QRGAJWQZ__s71:;L;Lq;P7Q%QRGAJWQZ__s71:;L;Lq;P7Q%QRGAJN KK  # # %AIIrc^^^^ SSKJn [T5mTRnUcT$TR 5mUR T5m UUU U4SjnUU4SjnUU4SjnUHRnUR S:Xa U"U5 MUR S:Xa U"U5 M7UR S:XdMIU"U5 MT T$![a SUlU"U5 Mtf=f) a degree-value element: indicates degree in chord, positive integers only degree-alter: indicates semitone alteration of degree, positive and negative integers only degree-type: `add`, `alter`, or `subtract`: if `add`: degree-alter is relative to a dominant chord (major and perfect intervals except for a minor seventh) if `alter` or `subtract`: degree-alter is relative to degree already in the chord based on its kind element FROM XML DOCUMENTATION The degree element is used to add, alter, or subtract individual notes in the chord. The degree-value element is a number indicating the degree of the chord (1 for the root, 3 for third, etc). The degree-alter element is like the alter element in notes: 1 for sharp, -1 for flat, etc. The degree-type element can be `add`, `alter`, or `subtract`. If the degree-type is `alter` or `subtract`, the degree-alter is relative to the degree already in the chord based on its kind element. If the degree-type is `add`, the degree-alter is relative to a dominant chord (major and perfect intervals except for a minor seventh). The print-object attribute can be used to keep the degree from printing separately when it has already taken into account in the text attribute of the kind element. The plus-minus attribute is used to indicate if plus and minus symbols should be used instead of sharp and flat symbols to display the degree alteration; it is `no` by default. The degree-value and degree-type text attributes specify how the value and type of the degree should be displayed. A harmony of kind "other" can be spelled explicitly by using a series of degree elements together with a root. r)scalec>TRURT5nUR(aURRS:wasURS:XaHURRS:a.TRb!TRS:waUR S5nUR UR5nURS:aUR S-UlTRn[UR5U;aMTHFnTRU5UR:XdM$TRU5 TRU5 MH gTRU5 g)zM change the pitches list based on this chordStepModification, adding a pitch rr5NrrEr) pitchFromDegreerr semitonesrn transposerrrgetScaleDegreeFromPitchremover)hD pitchToAppendrsrr rootPitchscrs rtypeAddDChordSymbol._adjustPitchesForChordStepModifications..typeAdds  ..ryy)DM{{r{{449 IIN --12",$1$;$;B$?M - 7 7 D yyA~'4';';a'? $''G299~( A11!4 Aq)}5! }-rc>TRnU(dgSn[TU5Hup4URSS5nURSS5nURSS5nUR[ U5:XdMVTR U5 SnTRH:n[ UR5U;dMTRR U5 M M U(d[SUR35eg) zO change the pitches list based on this chordStepModification, removing a pitch NFrrrFATDegree not in specified chord: )rziprJrrrrr)rrs pitchFoundrr degreeStringrrs r typeSubtractIChordSymbol._adjustPitchesForChordStepModifications..typeSubtracts''GJ '2 R0R0R099F +NN1%!%J(,(9(9 ryy>\9 --44\B!):345bii[ACCrcd>SnTRn[TU5Hrup4URSS5nURSS5nURSS5nUR[ U5:XdMVUR UR SS9nSnMt U(d[SUR35eg ) z alter FrrrFrTinPlacerN)rrrJrrrr r)rrrsrrrrs r typeAlterFChordSymbol._adjustPitchesForChordStepModifications..typeAlter sJ''G '2 R0R0R099F + BKK >A!%J3"45bii[ACCrr"r#r$)rrrrr MajorScalerr) rrrrrrrchordStepModificationrrs `` @@r'_adjustPitchesForChordStepModifications3ChordSymbol._adjustPitchesForChordStepModificationssT "w-!%!>> cs = harmony.ChordSymbol() >>> cs._parseAddAlterSubtract('add#9omit5', 'add') 'omit5' >>> cs.chordStepModifications [>] rrNrbrErFr6rTr#Fr)indexr= isnumericrrr)r remainingrrr$ startIndexs r_parseAddAlterSubtract"ChordSymbol._parseAddAlterSubtract9s#//'2S\A k* Ra=C E!!" I r]c !E!!" I Ra= " " $ $r]F!!" I q\ # # % %q\F!!" I & $  ) )%gs6{EBRW * YrcUnSU;aUSURS5nSU;aUSURS5nSU;aUSURS5nSU;aUSURS5nSU;a=XRS5S-R5(aUSURS5nSU;ajURS5[U5S- :aIXRS5S-R5(a S U;aS U;aUSURS5n[H2n[ U5H nX:XdM X0lU[U5Ss s $ M4 U$) Nr"rr$rTr#rFrrrJrG)risdigitr=r)rZrn)rsH originalsHrn charStrings r_getKindFromShortHand!ChordSymbol._getKindFromShortHandasM B;Abhhuo&B b=Abhhw'(B R<Abhhv&'B  Abhhz*+B "9HHSMA-.6688Abhhsm$B 2I"((3-#b'A+5xx}q()1133Ob(8Abhhsm$B$I? J #%.N%c"gh//K% rc:UHnURS:dM g g)NTFdiatonicNoteNumrrrs r_hasPitchAboveC4ChordSymbol._hasPitchAboveC4x"A  2%rc:UHnURS:dM g g)Nr<TFrrs r_hasPitchBelowA1ChordSymbol._hasPitchBelowA1~rrcSnURnU[;a [UnU[;a [U5nOSnUR SS5nUR 5UlU$)z returns NotationString of ChordSymbolObject which dictates which scale degrees and how those scale degrees are altered in this chord. >>> h = harmony.ChordSymbol('F-dim7') >>> h._notationString() '1,-3,-5,--7' rrDr)rnrGr)r[rJrHr)rnotationStringrmrss r_notationStringChordSymbol._notationStringsa~~ =  &D ; >  IIekk$' (YY(, 7 88:D<<R(D IIddI + 288:r2I  ' ' 2:  $I !)//)">%I+040K0K11>- "IA2(A4M0N,NZZR %I,),-% "9r zz/2H"..,K$K%J!))#r2H''R0H x="}  &D#3;#NN:a=:a!e;L+LM'+H!Z/)3d):J)3d):J#NN:6)+J#(AA'z*A&BD NN4  %JR*$$&)9)9#)>$>M$.$4$4S$9MYYy*52NNC O]#CD& 'OFG  ) )%eVW=U * T '_  N  1"v>>?AB  s*"P; Q ; Q  Q  Q3Q..Q3c4SUR;dSUR;d URcgSSKJn URSRS4nU[ ;a [ UnO)UR "URSS5nU[ U'SURSlSURSlUR5(a?URURSUR55nURS5 OQ/nURURS5 URSU;aURURS5 URU5nURSRURSR:wa[UR5nURU5(d4SnSURSlURURS5 OURSS S 9 SnURU5nUS ;aUSUH3nURS -UlUS:dMURS -UlM5 UH@nUR URSR :dM,URS -UlMB UR#U5(a6UHnU=RS -slM UR#U5(aM6UR%U5(a6UHnU=RS - slM UR%U5(aM6['U5UlUR+S S9 UR-UR-5S S9 UR/UR/55 g)a TODO: EXTREMELY SLOW! Calculate the pitches in the chord symbol and update all associated variables, including bass, root, inversion and chord: >>> CS = harmony.ChordSymbol >>> [str(pi) for pi in CS(root='C', bass='E', kind='major').pitches] ['E3', 'G3', 'C4'] >>> [str(pi) for pi in CS(root='C', bass='G', kind='major').pitches] ['G2', 'C3', 'E3'] >>> [str(pi) for pi in CS(root='C', kind='minor').pitches] ['C3', 'E-3', 'G3'] >>> [str(pi) for pi in CS(root='C', bass='B', kind='major-ninth').pitches] ['B2', 'C3', 'D3', 'E3', 'G3'] >>> [str(pi) for pi in CS(root='D', bass='F', kind='minor-seventh').pitches] ['F3', 'A3', 'C4', 'D4'] Note that this ChordSymbol creates what looks like a B- minor-seventh chord in first inversion, but is considered to be a D- chord in root position: >>> dFlatMaj6 = CS('D-6') >>> [str(pi) for pi in dFlatMaj6.pitches] ['D-3', 'F3', 'A-3', 'B-3'] >>> dFlatMaj6.root() >>> dFlatMaj6.inversion() 0 OMIT_FROM_DOCS >>> CS('E7omit3').root().nameWithOctave 'E3' >>> CS('E7omit5/G#').bass().nameWithOctave 'G#2' >>> CS('E9omit5/G#').root().nameWithOctave 'E3' >>> CS('E11omit3').root().nameWithOctave 'E2' rrNrrrrr6Fr)rNrTrr)rrnmusic21.figuredBassrrrFiguredBassScalerrgetSamplePitchespoprrrinversionIsValidrrrrtuplerrrr)rrscaleInitTuplefbScaler inversionNumr thisPitchs rrChordSymbol._updatePitchess b  (F$//,IT^^Mc 5//&166@ / /(8G#44T__V5LgVG18 ~ .*+&)*&    ! !..tv/FH\H\H^_G KKNG NN4??62 3v&g5tv67%%g. ??6 " ' '4??6+B+G+G G>>+L((66 $ 23'.tv67 NN4N 6L>>wG y (Q|,88a<!# xx!|AH -$$tv'>'N'NN xx!|AH##G,,$   A% %##G,, ##G,,$   A% %##G,,W~  ""4"0 $))+ . $))+rcfUR(dUR(GaUR5c [SU5eUR5RnURnU[ ;a [ UnU[ ;aU[U5S- nUR5bVUR5RUR5R:wa USUR5R-- nURHnURb_URRnUS:aSnOSnU[U5-nUSUR-S-U-[UR5-- nMoUSUR-S-[UR5-- nM U$[U5$)a Return the chord symbol figure associated with this chord. This method tries to deduce what information it can from the provided pitches. >>> h = harmony.ChordSymbol(root='F', bass='D-', kind='Neapolitan') >>> h.figure 'FN6/D-' Thanks to Norman Schmidt for code sample and helping fix a bug >>> foster = corpus.parse('leadsheet/fosterBrownHair.xml') >>> foster = foster.parts[0].getElementsByClass(stream.Measure) >>> for m in foster[12:17]: ... c = m.getElementsByClass(harmony.ChordSymbol) ... if c: ... ch = c[0].figure ... print(ch.replace('-', 'b')) ... else: ... print('n.c.') F G7 C C C Thanks to David Bolton for catching the bugs tested below: >>> h1 = harmony.ChordSymbol('C7 b9') >>> for x in h1.pitches: ... x ... >>> h2 = harmony.ChordSymbol('C/B- add 2') >>> for x in h2.pitches: ... x ... OMIT_FROM_DOCS >>> from xml.etree.ElementTree import fromstring as EL >>> MP = musicxml.xmlToM21.MeasureParser() >>> elStr = (r'Cdominant' + ... '9-1' + ... ' add') >>> mxHarmony = EL(elStr) >>> cs = MP.xmlToChordSymbol(mxHarmony) >>> print(cs.figure) C7 add b9 >>> cs.pitches (, , , , ) >>> elStr = (r'Cmajor' + ... 'B-1' + ... '20' + ... ' add') >>> mxHarmony = EL(elStr) >>> cs = MP.xmlToChordSymbol(mxHarmony) >>> print(cs.figure) C/B- add 2 >>> cs.pitches (, , , , ) z.Cannot find figure. No root to the chord foundrrSrFrr)rrnrrrrGr)rZrr rrrrrr|)rrrmcsModnumAlterrrprefixs rrChordSymbol.findFigurespp  & &$...yy{"&'WY]^^YY[%%F>>D}$$T*{";DA!DDyy{&99;##tyy{'7'77cDIIK$4$444F44>>-$~~77H!|X.FcEMM1C7&@3u||CTTTFcEMM1C7#ell:KKKF5M.d3 3rcSnSnSnSnUS:Xa!URU;dURU;agUS:Xa1URU;d URU;dURU;agUS:XaAURU;d0URU;d URU;dURU;agUS ;aURS :wagUcg g ) z Returns true if the provided inversion exists for the given pitches of the chord. If not, it returns false and the getPitches method then appends the bass pitch to the chord. ) rrrtrprnryr0r3r$r}r|r'r,rrrr4Tr7r)r6rrvF)rn)rrseventhsrrrs rrChordSymbol.inversionIsValid s      > NNk )~~* !^ NNi '~~,~~' !^ NNh &~~'~~*~~,6!NNg-  rFrcN>[TU]XS9nU(d SUlU$SUlg)aD Overrides :meth:`~music21.chord.Chord.transpose` so that this ChordSymbol's `figure` is appropriately cleared afterward. >>> cs = harmony.ChordSymbol('Am') >>> cs.figure 'Am' >>> cs.transpose(1) >>> cs.transpose(5, inPlace=True) >>> cs >>> cs.figure 'Dm' rN)rrr)rrrpostrs rrChordSymbol.transpose] s0 w  8DKKDKr)rrnrorrr)NNNNrr)rrrpitch.Pitch | str | Nonerrrr)rzt.Iterable[pitch.Pitch]rzlist[pitch.Pitch])rrrrrrr&)rrrzT | None)rrrrrrrrrrrrrrrrrrrrrs@rrrstr%).2.2'+ "!"+","% ""(:r.r rh&P.  2@TD@H{4z;z.3rc^\rSrSrSrSSU4SjjjrSSS.SjjrSSSS.S jjrS rSS .SS jjr S r U=r $)riv a Class representing a special 'no chord' ChordSymbol used to explicitly encode absence of chords. This is especially useful to stop a chord without playing another. >>> from music21.harmony import ChordSymbol, NoChord >>> s = stream.Score() >>> s.repeatAppend(note.Note('C'), 4) >>> s.append(ChordSymbol('C')) >>> s.repeatAppend(note.Note('C'), 4) >>> s.append(NoChord()) >>> s.repeatAppend(note.Note('C'), 4) >>> s = s.makeMeasures() See how the chordSymbol of C stops at offset 8 rather than continuing, thanks to the NoChord object. >>> s = harmony.realizeChordSymbolDurations(s) >>> s.show('text', addEndTimes=True) {0.0 - 0.0} {0.0 - 0.0} {0.0 - 1.0} {1.0 - 2.0} {2.0 - 3.0} {3.0 - 4.0} {4.0 - 8.0} {4.0 - 5.0} {5.0 - 6.0} {6.0 - 7.0} {7.0 - 8.0} {8.0 - 12.0} {8.0 - 9.0} {9.0 - 10.0} {10.0 - 11.0} {11.0 - 12.0} {12.0 - 12.0} >>> c_major = s.getElementsByClass(ChordSymbol).first() >>> c_major.duration >>> c_major.offset 4.0 Other text than the default of 'N.C.' can be given: >>> nc2 = NoChord('NC') >>> nc2 >>> nc2.pitches () Note that even if the text is a valid chord abbreviation, no pitches are generated. This feature may be useful for adding the appearance of ChordSymbols in a piece without having them be realized. >>> nc2 = NoChord('C7') >>> nc2 >>> nc2.pitches () Nc >[TU]"U4X#=(d U=(d SS.UD6 URcURUlgg)NN.C.)rmrl)rrrro)rrrmrlrrs rrNoChord.__init__ sC \d4Ov4O\S[\ << ,,DL rfindcgrr)rnewrootrs rr NoChord.root rF)rrcgrr)rnewbassrrs rr NoChord.bass rrcgrrrs rrNoChord._parseFigure srrc>U(d[R"U5$g)z Overrides :meth:`~music21.chord.Chord.transpose` to do nothing. >>> nc = harmony.NoChord() >>> nc.figure 'N.C.' >>> nc.transpose(8, inPlace=True) >>> nc.figure 'N.C.' N)copydeepcopy)r_valuers rrNoChord.transpose s==& &r)r)NnoneN)rrrmrrlrr)rrrz NCT | None) rrrrrrrrrrrrrs@rrrv sh=@  - - - - -16rcPUR5nUR[5R5nSnSn[ U5S:aUHnU(aSnUnMUR U5UR U5- nXdR lURU5[ U5S- :Xa-URUR U5- UR lUnM U$[ U5S:Xa5URUR US5- USR lU$U$)a Returns music21 stream with duration attribute of chord symbols correctly set. Duration of chord symbols is based on the surrounding chord symbols; The chord symbol continues duration until another chord symbol is located or the piece ends. >>> s = stream.Score() >>> s.append(harmony.ChordSymbol('C')) >>> s.repeatAppend(note.Note('C'), 4) >>> s.append(harmony.ChordSymbol('C')) >>> s.repeatAppend(note.Note('C'), 4) >>> s = s.makeMeasures() >>> harmony.realizeChordSymbolDurations(s).show('text') {0.0} {0.0} {0.0} {0.0} {1.0} {2.0} {3.0} {4.0} {4.0} {5.0} {6.0} {7.0} {8.0} If only one chord symbol object is present: >>> s = stream.Score() >>> s.append(harmony.ChordSymbol('C')) >>> s.repeatAppend(note.Note('C'), 4) >>> s = s.makeMeasures() >>> harmony.realizeChordSymbolDurations(s).show('text') {0.0} {0.0} {0.0} {0.0} {1.0} {2.0} {3.0} {4.0} If a ChordSymbol object exists followed by many notes, duration represents all those notes (how else can the computer know to end the chord? if there's no chord following it other than end the chord at the end of the piece?). >>> s = stream.Score() >>> s.repeatAppend(note.Note('C'), 4) >>> s.append(harmony.ChordSymbol('C')) >>> s.repeatAppend(note.Note('C'), 8) >>> s = s.makeMeasures() >>> harmony.realizeChordSymbolDurations(s).show('text') {0.0} {0.0} {0.0} {1.0} {2.0} {3.0} {4.0} {4.0} {5.0} {6.0} {7.0} {8.0} {9.0} {10.0} {11.0} {12.0} TNrFr) flattengetElementsByClassrstreamr= elementOffsetrrr highestTime)piecepf onlyChordsfirst lastChordrwqlDiffs rrealizeChordSymbolDurationsr0 sR B&&{3::zO(, , )C3) rrr assertEqualrrr assertTrue isConsonantrrrws rtestChordAttributesTest.testChordAttributesH sv#   & R"DE   O ] _ RWWY. ()rcSSKJn UR5nURSS5nUR U5 UR [ UR5S5 g)Nrr4r"r7r)rrrrrr7r=r)rrhhds r testBasicTest.testBasicR sL# OO   * *5! 4 ""2& Q556:rcSSKJn UR5nURS5 UR SSS9 UR SSS 9 S UlS UlS UlUR[U5S 5 g)Nrr4zE-zB-Trr6FrI64rrz#) rrrrrrrrnror7reprr:s rtestChordKindSettingTest.testChordKindSettingY sh#  "   % Qu -  b#HIrcj[R"S5n[U5nURUS5 g)N)zc##5ze#5zg#5zC##dim)rrr|r7)rcisisdimfigs rtestDoubleSharpsEtcTest.testDoubleSharpsEtcd s+;;56(2 h'rc[S5nUR5nURURS5 UR 5nURURS5 g)NzCm/E-C4E-3)rrr7nameWithOctaver)rdrrs rtestChordSymbolSetsBassOctave"Test.testChordSymbolSetsBassOctavej sN  vvx ,,d3 FFH ))51rc[SSSSS9nURUR5S5 URURSS9RS5 URUR SS9RS5 UR URSS9RUR SS9R5 g) zI Test that bass is preserved even when both bass and inversion are given FzA-rr)rrrrmFrN)rr7rrrr assertLessr)r explicitFm6s r$testHarmonyPreservesInversionAndBass)Test.testHarmonyPreservesInversionAndBassq s"sQ  ..0!4 ))u)5::DA ))u)5::C@  ((e(4;;#((e(4;; =rcSSKJn SSKJn [S5nUR S5nUR S5nUR SU5 UR SU5 URURS5U5 [S5nUR S5nSURl UR S5nURU5 URU5 URURS5U5 g)zs This tests a former bug in getContextByClass because ChordSymbol used to have the same `.classSortOrder` as Note. rnoter'CrrN) rr[r'rNoteMeasurer/assertIsgetContextByClassrrr)rr[r'rwnrs rtestClassSortOrderHarmonyTest.testClassSortOrderHarmony| s !"   IIcN NN1  A B a))-8"=  IIcN#$  NN1      a))-8"=rcSSKJn UR5nURSUR5 URSUR 5 URSUR 5 URS5nURSUR5 URSUR 5 URSUR 5 URS5nURSUR5 URSUR 5 URSUR 5 URSS9nURSUR5 URSUR 5 URSUR 5 URSS 9nURSUR5 URSUR 5 URSUR 5 URSSS 9nURSUR5 URSUR 5 URSUR 5 URS S SS 9nURSUR 5 URSUR 5 UR[U5S 5 URS[UR55 URUR55 URUR55 UR5 URS[UR55 g)Nrr4r#rNCr)rmzNo Chord)rlr]E)rrrmz)rrrr7rnrorrr=r assertIsNonerrr)rrncs r testNoChordTest.testNoChord s|# __  . 1 + __T " . r/ ryy) __V $ . 1 + __&_ ) . 1 + __Z_ 0 . R__5 RYY/ __T:_ 6 . R__5 ryy) __#Cf_ = 1 + R"BC C O, "'')$ "'')$  C O,rcSSKJn UR[5nUR S5 SSS5 UR [ WR5S5 UR[5nUR S5 SSS5 UR [ UR5S5 g!,(df  N=f!,(df  NE=f)Nrr4zH-7z0Chord H-7 does not begin with a valid root note.Garg7zvInvalid chord abbreviation 'arg7'; see music21.harmony.CHORD_TYPES for valid abbreviations or specify all alterations.)rr assertRaisesrrr7r exception)rrcontexts rtestInvalidRootsTest.testInvalidRoots s#   z *g    &+  !! " >   z *g    (+  !! " : + *+ *sB00C0 B> CcSSKJn [R"S5nUR U5nUR UR S5 g)Nrr4)zA#r]rgrU)rrrrr~r7r)rrrrws rtestInvalidSymbolTest.testInvalidSymbol s9# KK( )  ) )! , $GHrc[S5nURURVs/sHo"RPM sn/SQ5 [S5nURURVs/sHo"RPM sn/SQ5 [S5nURURVs/sHo"RPM sn/SQ5 gs snfs snfs snf)NzFFr+6)rTGBzD-dadd6)DzF#rrxatristan)rzB#zD#zF##)rr7rr)rrwrs rtestRegexEdgeCasesTest.testRegexEdgeCases s  ! "**5*Q&&*57LM  ! "**5*Q&&*57LM  $ "**5*Q&&*57OP 655sC (C+CcSSKJn SSKJn [ SU55nUR R 5nU"U5nURU5n[UR5n [U5n URX8R5 URX9R5 URX:R5 URn U Rn U Rn U [;a [U n U [;a [U n U [;a [U n URX5 URX5 URUR5U R55 URUR5U R55 URUR5U R55 URUR5U R55 g)z Run a series of tests on the given chord. xmlString: an XML harmony object figure: the equivalent figure representation pitches: the list of pitches of the chord r fromstringmusicxmlc3N# UHn[R"U5v M g7frr r.0rs r &Test.runTestOnChord.. 81 A#%N)xml.etree.ElementTreerrrrxmlToM21 MeasureParserxmlToChordSymbolrrr7rrnrGrr)r xmlStringrrELrMP mxHarmonycs1cs2cs3kind1kind2kind3s rrunTestOnChordTest.runTestOnChord sr ;$888    , , .yM !!),#**%&! ++. ++. ++.    M !!%(E M !!%(E M !!%(E & & SXXZ0 SXXZ0 SXXZ0 SXXZ0rc4SnSnSnURXU5 g)Na  A dominant 3 G zA7/G)G2A2C#3E3rrrrrs rtestChordWithBassTest.testChordWithBass s%  + Iw7rcSnSn[U5nURUR[SU555 SnSn[U5nURUR[SU555 Sn[SU55nURU[S 5R5 URU[S 5R5 S n[S U55nURU[S 5R5 Sn[SU55nURU[S5R5 g)N)rrB2D#3F3zG+9c3N# UHn[R"U5v M g7frrrs rr2Test.testChordFlatSharpInFigure..* *K7a5;;q>>7r)rrrrA3zG9#5c3N# UHn[R"U5v M g7frrrs rrr/ rr)rr6rG#3c3N# UHn[R"U5v M g7frrrs rrr2 rrAmM7Aminmaj7)A1C2E2rc3N# UHn[R"U5v M g7frrrs rrr6 rrzAm#7)rF2rB-3c3N# UHn[R"U5v M g7frrrs rrr: rr Csusaddb7)rr7rr)rrrrws rtestChordFlatSharpInFigureTest.testChordFlatSharpInFigure% s1   U*K7*K%KL1   U*K7*K%KL+888 +f"5"="=> +j"9"A"AB+888 +f"5"="=>+888 +k":"B"BCrc4SnSnSnURXU5 g)z This tests a bug where the root and bass were wrongly parsed, since the matched root and bass were globally removed from figure, and not only where matched. a# E dominant E -1 zE7/E-)zE-2rrB3D4Nrrs rtestRootBassParsingTest.testRootBassParsing= s%  2 Iw7rc4SnSnSnURXU5 g)z This tests a bug where the chord modification (add 2) was placed at a wrong octave, resulting in a D bass instead of the proper E. a C major E 2 0 add z C/E add 2rG3rMrNrrs rtestChordStepBassTest.testChordStepBassU s%  * Iw7rcSSKJn SSKJn Sn[ SU55nSnUR R 5nU"U5nURU5n[UR5n[S5n URX7R5 URX8R5 URX9R5 g) z This tests a bug where the bass addition was considered as the fifth inversion in suspended chords. Now, this is considered as a non-valid inversion, and the bass is simply added before the root. rrr)rD3rrc3N# UHn[R"U5v M g7frrrs rr#Test.testSusBass..z rra D suspended-fourth G zDsus/GN) rrrrrrrrrrr7r rrrrrrrrrrs r testSusBassTest.testSusBassp s ;$*888     , , .yM !!),#**%(# ++. ++. ++.rcSSKJn SSKJn Sn[ SU55nSnUR R 5nU"U5nURU5n[UR5n[S5n URX7R5 URX8R5 URX9R5 URSUR5R5 g) Nrrr)rNrrrMc3N# UHn[R"U5v M g7frrrs rr*Test.testBassNotInChord.. rrz C major E- zC/E-rN)rrrrrrrrrrr7rrrOrs rtestBassNotInChordTest.testBassNotInChord s:$+888     , , .yM !!),#**%&! ++. ++. ++.  9 9:rcSSKJn SSKJn Sn[ SU55nSnUR R 5nU"U5nURU5n[UR5n[S5n URSUR5R5 URX7R5 URX8R5 URX9R5 g) Nrrrrc3N# UHn[R"U5v M g7frrrs rr$Test.testSus2Bass.. rra C suspended-second E zCsus2/Er)rrrrrrrrrrr7rrOrrs r testSus2BassTest.testSus2Bass s:$*888     , , .yM !!),#**%)$ sxxz889 ++. ++. ++.rc4SnSnSnURXU5 g)z% This tests a bug in _adjustOctaves. z D minor-ninth )D2rrr6rDm9Nr)rrrrs r testNinthTest.testNinth s%  1 Iw7rcSSKJn SSKJn SnSn[ SU55nUR R 5nU"U5nURU5n[S5nURSUR55 URSUR55 S n[ S U55nURURU5 URURU5 URUR5UR55 URUR5UR55 g) Nrrrz C major 1 )rrr6c3N# UHn[R"U5v M g7frrrs rr%Test.testInversion.. rrzC/Er)rrrMc3N# UHn[R"U5v M g7frrrs rrr rr)rrrrrrrrrr7rrrr) rrrrrrrrrs r testInversionTest.testInversion s:$ %888    , , .yM !!),%  CMMO, CMMO,$888 g. g. SXXZ0 SXXZ0rc[SSS9nURSUR55 URS[UR 555 URS[UR 555 g)Nr]rgrrrMr)rr7rrrr)rrws rtestChordWithoutKindTest.testChordWithoutKind sX c , BLLN+ s2779~. s2779~.rclSnSnSnURXU5 SnURXU5 SnURXU5 SnSnSnURXU5 S nURXU5 [S 5nURS [UR55 S nS nSnURXU5 g)Na1 G dominant 5 0 subtract 9 -1 add 9 1 add 11 1 add 13 -1 add z+G7 subtract 5 add b9 add #9 add #11 add b13)rrrzA-3zA#3zC#4zE-4z&G7 subtract5 addb9 add#9 add#11 addb13z!G7subtract5addb9add#9add#11addb13ab C dominant 9 -1 add zC7 b9)r6rrrzD-4z C7 add b9z A7 alter #5zj(, , , )a A dominant 5 1 alter 9 1 add 11 1 add zA7 alter #5 add #9 add #11)rrzE#3rzB#3zD#4)rrr7rr)rrrrrws rtestChordStepFromFigureTest.testChordStepFromFigure s  B?@ Iw79 Iw74 Iw7  2 Iw7 Iw7 ' 569"**o G  ..: Iw7rc|[S5n[S5nURURUR5 g)NzF7 add 4 subtract 3F7sus4rr7rrch1ch2s rtestExpressSusUsingAlterations#Test.testExpressSusUsingAlterationsx s//0(# ckk2rc|[S5n[S5nURURUR5 g)NzCo omit5z Cdim omit5rrs rtestDoubledCharactersTest.testDoubledCharacters~ s.*%,' ckk2rcXSn[SU55nSnSnURX#U5 g)z) power chords should not have inversions )rrrc3N# UHn[R"U5v M g7frrrs rr#Test.x_testPower.. rrz A power E zApower/EN)rr)rrrrs r x_testPowerTest.x_testPower s7%888   Iw7rcSSKJn SSKJn UR5n[ S5nUR SUR SS95 UR SU5 [U5 URURS5 g ) z Test an edge case where a Stream contains only one ChordSymbol at the highest offset: should still have a nonzero duration if there is a subsequent highest time. rrZr\A7whole)typeg?g@N) rr[r'r_rr/r^r0r7r)rr[r'rrws rtestSingleChordSymbolTest.testSingleChordSymbol se !" NN    DII7I+, b#A& ))3/rc~[R"S5n[USS9nURURU45 g)Nr6F)rr)r rrr7r)r bass_noter>s rtestUpdatePitchesFalseTest.testUpdatePitchesFalse s2KK% % 8 YL1rrN)!rrrrr;r@rErJrQrWrcrjrqrtr|rrrrrrrrrrrrrrrrrrrrrr2r2F s*; J( 2 =>4*-X *I Q*1X8&D08086!/F ;D/@8$ 1D/e8N3 3 8,0 2rr2c&\rSrSrSrSrSrSrg) TestExternali c SSKJn SSKJn SSKJn UR S5nUR U5nUR 5RUR5nUR5nUHnSUl URU5 M g)Nrr4corpusr\zleadSheet/fosterBrownHair.xmlF) rrrr'parser0r%r&rStreamrr)rrrr'testFile chordSymbolsrrcSs r testReadInXMLTestExternal.testReadInXML sr#""<< ?@66x@'')<n[R5H#upVUSHnX4-U-n[U5 M M% M@ MI g)N)rrxr]rzrgrTrw)rrrFr)r)itemsr) rnotesmodrbr unused_keyr harmony_typesymbols rtestALLChordKindsTestExternal.testALLChordKinds sW3A'2'8'8':OJ(+A !"!5#F+)/(;rrN)rrrrr rrrrrrrr s(F@ ,rr__main__)F)r` chord.Chord)r`r rr):r __future__r collectionsrrunittesttypingtrrrrrrr r r r r r Environment environLocalTypeVarrr TYPE_CHECKINGrr OrderedDictr)rGrrrrrProtoM21Objectrr-r2r|r~rZrr[rr__annotations__rrr0TestCaser2r _DOC_ORDERrmainTestrrrr0s#  &&y1 IIc'iiY'??1%%>' w()*>' x#u&'>'8c5\*+>'Is|,- >' *sFo67 >'y64.12>'Z)BCD>'{T6N34>'eY-? @A>';(<=>>'v ?@>'MD&>:;>'; 56>'"Y&'#>'$Z$01%>'*[4.12+>', sFm45->'.<%);<=/>'0]T6N341>'2|eY-?@A3>'4 -1F!GH5>'6~w787>'8#_vh$?@9>':/D&>:;;>'< 05'2BCD=>'Bw89C>'DNUG$456E>'F/FJ+?@AG>'H$ug&678I>'Jo /CDEK>'L(5'*:;'N/&:;O>'P+eW-=>?Q>'V%w'789W>'X)D'?;'Z,vz.BCD[>'\'%)9:;]>'^06:2FGH_>'`!4ug6F GHa>'b2VH=>c>'h'F8,-i>'j'E6?34k>'l *vw.?!@Am>'nK$()o>'pVTN+,q>'r fd^,-s>'t vuo./u>'v sWIw>'x uwi !y>'z {+,{>'> D0 5$=  |44 Y+ekkY+~  \%B%B {=G22{=BF@2&qh" % ; %MOIN Y'YxekeT`Lh 28  h 2V?,8$$?,z1;@U V  z Tr