rh؉SrSSKJr SSKJr SSKrSSKrSSKr SSK r SSK J r SSK J r SSK Jr SSK Jr SS K Jr SS K Jr SS K Jr SS K Jr SS K Jr SSK Jr SSK Jr SSK Jr SSK Jr "SS\R25r"SS5r"SS\R85r"SS\R85r\S:XaSSK r \ R@"\5 gg)a A beta version of a complete .capx to music21 converter. Currently only handles one per and does not deal with Slurs, Dynamics, Ornamentation, etc. Does not handle pickup notes, which are defined simply with an early barline (same as incomplete bars at the end). ) annotations)StringION)bar)chord)clef)common)duration) exceptions21)layout)key)meter)note)pitch)stream)tiec\rSrSrSrg)CapellaImportExceptionON)__name__ __module__ __qualname____firstlineno____static_attributes__rX/home/james-whalen/.local/lib/python3.13/site-packages/music21/capella/fromCapellaXML.pyrrOsrrcJ\rSrSrSrSrS%SjrSrS&SjrS&Sjr S'S jr S&S jr S&S jr S&S jr S rSrSrSrSrSrSrSr\R.\R0\R2\R4\R6S.rSrSrSrSr Sr!SSSSSS S!.r"S"r#S#r$S$r%g)(CapellaImporterSa Object for importing .capx, CapellaXML files into music21 (from which they can be converted to musicxml, MIDI, lilypond, etc.) Note that Capella stores files closer to their printed versions -- that is to say, Systems enclose all the parts for that system and have new clefs etc. c.SUlSUlSUlgN)xmlText zipFilenamemainDom)selfs r__init__CapellaImporter.__init__\s  rcURU5 UR5 URUR5nUSLaU$UR U5nU$)z main program: opens a file given by filename and returns a complete music21 Score from it. If systemScore is True then it skips the step of making Parts from Systems and Measures within Parts. T)readCapellaXMLFile parseXMLTextsystemScoreFromScorer$partScoreFromSystemScore)r%filename systemScorescoreObj partScores r scoreFromFileCapellaImporter.scoreFromFileasU ) ,,T\\: $ O55h?I rc[U5Ul[R"[U5S5nUR S5nSSS5 WUlU$!,(df  N=f)z Reads in a .capx file at `filename`, stores it as self.zipFilename, unzips it, extracts the score.xml embedded file, sets self.xmlText to the contents. Returns self.xmlText rz score.xmlN)strr#zipfileZipFilereadr")r%r- zipFileHandler"s rr)"CapellaImporter.readCapellaXMLFilersNx= __S]C 0M#((5G1 1 0s A A"NcUc URn[U[5(dURS5n[R R R[U55nUH;up4SUR;dMURRSS5SUl M= URUl UR$)z Takes the string (or unicode string) in xmlText and parses it with `xml.etree`. Sets `self.mainDom` to the dom object and returns the dom object. zutf-8}) r" isinstancer5decodexmletree ElementTree iterparsertagsplitrootr$)r%r"itunusedels rr*CapellaImporter.parseXMLTexts ?llG'3''nnW-G YY " " , ,Xg-> ?JFbff}c1-a0ww ||rcT[RRRU5$)a Utility method, especially for the documentation examples/tests, which uses `xml.etree.ElementTree` to parse the string and returns its root object. Not used by the main parser >>> ci = capella.fromCapellaXML.CapellaImporter() >>> funnyTag = ci.domElementFromText( ... 'hiha' + ... '') >>> funnyTag iter searches recursively >>> len(list(funnyTag.iter('greg'))) 3 findall does not: >>> len(funnyTag.findall('greg')) 2 )r@rArB fromstring)r%r"s rdomElementFromText"CapellaImporter.domElementFromTexts0yy$$//88rc |UR[R5n0nUHnURU5nUR[R 5n[ U5HupxURU;a7[R "5n URU lXS.X8R'OX8RSn UH6n U R[R"U RU-5U 5 M8 U R5 M M [R"5n [[U55V s/sHn SPM n n UHnX>nUSXS'M U HnUc [!S5 MUR["R$5nUR[&R(5nSnSnUHnUU:XaUR+U5 MUnM UHnUU:XaUR+U5 MUnM UR-SS9 U RSU5 M U R5 U $s sn f) z Take a :class:`~music21.stream.Score` object which is organized by Systems and return a new `Score` object which is organized by Parts. )partnumberrPNrQz#part entries do not match partDict!T)inPlacer)getElementsByClassr System elementOffsetrPart enumerateid coreInsertropFracoffsetcoreElementsChangedScorerangelenprintrClefr KeySignatureremove makeMeasures)r%r. systemStream partDictById thisSystem systemOffset partStreamjthisPartnewPartrInewScoreipartspartIdpartDictpclefs keySignatureslastCleflastKeySignatureckss rr,(CapellaImporter.partScoreFromSystemScores#55fmmD 8: &J'44Z@L#66v{{CJ(4 ;;l2$kkmG!)GJ9@0NL-*;;7?G"B&&v}}RYY5M'NPRS#++- 5 '<<>7 H9cUc[R"5nURS5nU(d [S5e[ U5S:a [S5eUSnURS5nU(d [S5e[ U5H1upgUR U5nUS-UlURU5 M3 UR5 U$)a( returns an :class:`~music21.stream.Score` object from a tag. The Score object is not a standard music21 Score object which contains parts, then measures, then voices, but instead contains systems which optionally contain voices, which contain parts. No measures have yet been created. systemsz1Cannot find a tag in the objectr=zMFound more than one tag in the object, what does this mean?rsystemzHCannot find any tags in the tag in the object) rr]findallrr_rWsystemFromSystem systemNumber coreAppendr\) r% scoreElementr/ systemsListsystemsElement systemListrrg systemObjs rr+$CapellaImporter.systemScoreFromScores  ||~H"**95 (CE E { a (_a a$Q#++H5 (Z\ \)2*(= $L--j9I%1A%5I "    *)> $$&rcUc[R"5nURS5nU(d [S5e[ U5S:a [S5eUSnURS5nU(d [S5eUGHnSnS UR ;aUR S n[ R"5nXxlURS 5n U (d [S 5eU Sn U RS 5n U (d [S 5e[ U 5S:XaXU Sn U RS5n U (d [S5e[ U 5S:a [S5eU SnURX5 URSU5 GM U$)z returns a :class:`~music21.stream.System` object from a tag. The System object will contain :class:`~music21.stream.Part` objects which will have the notes, etc. contained in it. TODO: Handle multiple stavesz.No tag found in this elementr=z9More than one tag found in this elementrstaffzFNo tag found in the element for this element UnknownPartr voicesz[No tag found in the tag for the element for this elementvoicezoNo tag found in the tag for the tag for the element for this element noteObjectszNo tag found in the tag found in the tag for the tag for the element for this elementzMore than one tag found in the tag found in the tag for the tag for the element for this element) r rTr}rr_attribrrVrXstreamFromNoteObjectsinsert)r% systemElementr stavesList stavesElement staffListthisStaffElementrppartObj voicesList voicesElement voiceListthisVoiceElementnoteObjectsListthisNoteObjects rr~ CapellaImporter.systemFromSystem s   I"**84 ()YZ Z z?Q (KM M"1 !))'2 (XZ Z ) "F+222)00:kkmGJ)11(;J,233'qMM%--g6I,CDD9~"#,Q< "2":":="I&0233'!+0677"1!3**>C   Q (E!*FrcUc[R"5nOUnURURURUR UR URS.nUHwnSnURnXt;a[SU35 M&XG"U5n[U[5(aUHnURU5 M MaUcMfURU5 My UR5 U$)aJ Converts a tag into a :class:`~music21.stream.Stream` object which is returned. A Stream can be given as an optional argument, in which case the objects of this Stream are appended to this object. >>> ci = capella.fromCapellaXML.CapellaImporter() >>> noteObjectsString = r""" ... ... ... ... ... ... ... das, ... scherz, ... ... ... ... ... ... ... ... ... so ... der ... ... ... ... ... ... ... ... """ >>> noteObjectsElement = ci.domElementFromText(noteObjectsString) >>> streamObj = ci.streamFromNoteObjects(noteObjectsElement) >>> streamObj.show('text') {0.0} {0.0} {0.0} {2.0} {4.0} >>> streamObj.highestTime 4.0 N)clefSignkeySigntimeSignrestrbarlinezUnknown tag type: )rStreamclefFromClefSignkeySignatureFromKeySigntimeSignatureFromTimeSign restFromRestchordOrNoteFromChordbarlineListFromBarlinerDr`r>listrr\) r%noteObjectsElement streamObjsmappingdrIdTagelSubs rr%CapellaImporter.streamFromNoteObjectsHs`   AA#44"::#==,, 55"99 $AB55D"*4&12]1%b$''!# U+"$ZLL$$ rc[R"5nURS5nURUS5UlU$)a" Returns a :class:`~music21.rest.Rest` object from a tag. >>> ci = capella.fromCapellaXML.CapellaImporter() >>> restElement = ci.domElementFromText('') >>> r = ci.restFromRest(restElement) >>> r >>> r.duration.type 'half' r r)rRestr}durationFromDurationr )r% restElementr4 durationLists rrCapellaImporter.restFromRests: IIK"**:6 ..|A? rcURS5nURS5n[U5S:wd[U5S:wa [S5eURUS5nSnU(d [S5e[U5S:XaUSnO[R "U5nUR US5UlURS5nU(aURUS5nXel U$)a? returns a :class:`~music21.note.Note` or :class:`~music21.chord.Chord` from a chordElement -- a `Note` is returned if the has one element, a `Chord` is returned if there are multiple elements. >>> ci = capella.fromCapellaXML.CapellaImporter() >>> chordElement = ci.domElementFromText( ... '') >>> n = ci.chordOrNoteFromChord(chordElement) >>> n >>> n.duration This one is an actual chord >>> chordElement = ci.domElementFromText( ... '' + ... '') >>> c = ci.chordOrNoteFromChord(chordElement) >>> c >>> c.duration r headsr=zMalformed chord!rNlyric) r}r_rnotesFromHeadsrChordrr lyricListFromLyriclyrics)r% chordElementr headsList notesList noteOrChord lyricsLists rr$CapellaImporter.chordOrNoteFromChords<$++J7  ((1 |  !S^q%8();< <'' ! 5  ();< < y>Q #A,K++i0K#88aI !))'2 00A?J!+ rc~/nURS5nUH#nURURU55 M% U$)aZ returns a list of :class:`~music21.note.Note` elements for each in >>> ci = capella.fromCapellaXML.CapellaImporter() >>> headsElement = ci.domElementFromText( ... '') >>> ci.notesFromHeads(headsElement) [, ] head)r}append noteFromHead)r% headsElementnotes headDomList headElements rrCapellaImporter.notesFromHeadss?"**62 &K LL**;7 8' rcSUR;a [S5eURSn[R"5nX#lUR S- UlUR S5n[U5S:a [S5e[U5S:Xa$URUS5nXSRl UR S5n[U5S:a [S5e[U5S:XaURUS5nXsl U$) a) return a :class:`~music21.note.Note` object from a element. This will become part of Chord._notes if there are multiple, but in any case, it needs to be a Note not a Pitch for now, because it could have Tie information >>> ci = capella.fromCapellaXML.CapellaImporter() >>> headElement = ci.domElementFromText( ... '') >>> n = ci.noteFromHead(headElement) >>> n >>> n.octave # capella octaves are one higher than written 6 >>> n.tie rz.Cannot deal with element without pitch!r=alterz+Cannot deal with multiple elements!rrz)Cannot deal with multiple elements!) rrrNotenameWithOctaveoctaver}r_accidentalFromAlterr accidental tieFromTier)r%rnoteNameWithOctavenaltersacctiesthisTies rrCapellaImporter.noteFromHeads$ +,, ,()YZ Z(//8 IIK-88a<$$W- v;?()VW W v;! **6!95C!$GG ""5) t9q=()TU U t9>ood1g.GErcSUR;a[URS5nO [S5 Sn[R"U5nSUR;aURSS:XaSUlU$)a return a :class:`~music21.pitch.Accidental` object from an tag. >>> ci = capella.fromCapellaXML.CapellaImporter() >>> alter = ci.domElementFromText('') >>> ci.accidentalFromAlter(alter) The only known display type is "suppress" >>> alter = ci.domElementFromText('') >>> accidentalObject = ci.accidentalFromAlter(alter) >>> accidentalObject >>> accidentalObject.displayType 'never' stepzNo alteration...rdisplaysuppressnever)rintr`r Accidental displayType)r% alterElement alterationrs rr#CapellaImporter.accidentalFromAltersr$ \(( (\0089J $ %Jz*  ++ + 0C0CI0NR\0\%CO rcSnSnSUR;aURSS:XaSnSUR;aURSS:XaSnSnUSLaUSLaSnOUSLaSnO USLaS nOg[R"U5nU$) a` returns a :class:`~music21.tie.Tie` element from a tag if begin == 'true' then Tie.type = start >>> ci = capella.fromCapellaXML.CapellaImporter() >>> tieEl = ci.domElementFromText('') >>> ci.tieFromTie(tieEl) if end == 'true' then Tie.type = stop >>> tieEl = ci.domElementFromText('') >>> ci.tieFromTie(tieEl) if begin == 'true' and end == 'true' then Tie.type = continue (is this right???) >>> tieEl = ci.domElementFromText('') >>> ci.tieFromTie(tieEl) FbegintrueTendNcontinuestartstop)rrTie)r% tieElementrrtieTypetieObjs rrCapellaImporter.tieFromTie;s0 j'' 'J,=,=g,F&,PE J%% %**;*;E*Bf*LC D=SD[ G d]G D[G! rc/nURS5nUH*nURU5nUcMURU5 M, U$)a returns a list of :class:`~music21.note.Lyric` objects from a tag >>> ci = capella.fromCapellaXML.CapellaImporter() >>> lyricEl = ci.domElementFromText( ... 'di' + ... 'man,frau,') >>> ci.lyricListFromLyric(lyricEl) [, , ] verse)r}lyricFromVerser)r% lyricElement lyricListversesr thisLyrics rr"CapellaImporter.lyricListFromLyricgsO %%g.A++A.I$  +rcSnSnSUR;a[URS5S-nSUR;aURSS:XaSnURnUbUS:Xag[R"XBUS S 9nU$) ag returns a :class:`~music21.note.Lyric` object from a tag >>> ci = capella.fromCapellaXML.CapellaImporter() >>> verse = ci.domElementFromText('di"') >>> ci.lyricFromVerse(verse) Does not yet support 'align' attribute if the text is empty, returns None r=singlernhyphenrrNT)textrQsyllabicapplyRaw)rrrrLyric)r%r verseNumberrrrs rrCapellaImporter.lyricFromVerse}s  %,, ell3/014K u|| # X(>&(HHzz <42:JJDxZ^_ELr)treblebassaltotenorzG2-clSUR;aURSnX R;aURU"5$USS:Xa[R"5$[ U5S:aEUSSnSn[ U5S:aUSS:XaSnO USS:XaSn[R "X45nU$g ) a` returns a :class:`~music21.clef.Clef` object or subclass from a tag. >>> ci = capella.fromCapellaXML.CapellaImporter() >>> clefSign = ci.domElementFromText('') >>> ci.clefFromClefSign(clefSign) >>> clefSign = ci.domElementFromText('') >>> ci.clefFromClefSign(clefSign) >>> clefSign = ci.domElementFromText('') >>> clefObject = ci.clefFromClefSign(clefSign) >>> clefObject >>> clefObject.sign 'F' >>> clefObject.line 1 >>> clefObject.octaveChange 1 rrrrr=+-N)r clefMappingrPercussionClefr_clefFromString)r%r clefValueclefSignAndLineclefOctaveChangeclefObjs rr CapellaImporter.clefFromClefSigns2 X__ $ /I,,,'' 2441$**,,Y!#"+Aa.#$ y>A% |s*+,("1,+-(--oPrcSUR;a.[URS5n[R"U5$g)a Returns a :class:`~music21.key.KeySignature` object from a keySign tag. >>> ci = capella.fromCapellaXML.CapellaImporter() >>> keySign = ci.domElementFromText('') >>> ci.keySignatureFromKeySign(keySign) fifthsN)rrr rb)r%r keyFifthss rr'CapellaImporter.keySignatureFromKeySigns9 w~~ %GNN845I##I. . &rc|SUR;a,URSnUS:wa[R"U5$gg)a Returns a :class:`~music21.meter.TimeSignature` object from a timeSign tag. >>> ci = capella.fromCapellaXML.CapellaImporter() >>> timeSign = ci.domElementFromText('') >>> ci.timeSignatureFromTimeSign(timeSign) >>> timeSign = ci.domElementFromText('') >>> ci.timeSignatureFromTimeSign(timeSign) is None True timeinfiniteN)rr TimeSignature)r%r timeStrings rr)CapellaImporter.timeSignatureFromTimeSigns= X__ $!0JZ'**:66rc[R"5nSUR;aRURSnURS5nUS:wa,[ USU5n[ X4S-S5nSU-U- nXrlSUR;a[ URS5nXlURS 5n U H%n URU 5n URU 5 M' U$) a Return a music21.duration.Duration element from an XML Element representing a duration. >>> ci = capella.fromCapellaXML.CapellaImporter() >>> durationTag = ci.domElementFromText('') >>> durationObj = ci.durationFromDuration(durationTag) >>> durationObj >>> durationObj.type '32nd' >>> durationObj.dots 1 Here with Tuplets >>> durationTag2 = ci.domElementFromText( ... '') >>> d2 = ci.durationFromDuration(durationTag2) >>> d2 >>> d2.type 'quarter' >>> d2.tuplets (,) Does not handle noDuration='true', display, churchStyle on rest durations base/rrr=Ng@dotstuplet) r Durationrfindr quarterLengthr&r}tupletFromTuplet appendTuplet) r%durationElementdur baseValue slashIndex firstNumber secondNumberr* dotNumbertupletsrr's rr$CapellaImporter.durationFromDurations<! _++ +'..v6I",JR!)Aj"9: "9!^_#=> !${!2l B $1! _++ +O226:;I H!))(3A**1-F   V $ rcBSnSnSUR;a1[URS5nSnX#S-:aUS-nX#S-:aMSUR;aURSS:XaUS-nSUR;a [S5 [R"X#5nU$)a  Returns a :class:`~music21.duration.Tuplet` object from a tag. >>> ci = capella.fromCapellaXML.CapellaImporter() >>> tupletTag = ci.domElementFromText('') >>> ci.tupletFromTuplet(tupletTag) does not handle 'tripartite' = True r=countr prolongr tripartitezOWE DON'T HANDLE TRIPARTITE YET! Email the file and a pdf so I can figure it out)rrr`r Tuplet)r% tupletElement numerator denominatortups rr+ CapellaImporter.tupletFromTuplet(s  m** *M009:IKAo-q Ao-  ,, ,1E1Eg1NRX1X 1 K =// / a cooi5 rnormaldoublefinalrrz end-start)rrArrepEndrepBegin repEndBegincD/nSnSUR;Ga URSnURS5(aX@R;aURUnURS5S:a'UR [ R "S55 SnURS5S:a3[ R "S5nUSLaSUlUR U5 U$X@R;a2UR [ R"URU55 U$) a Indication that the barline at this point should be something other than normal. Capella does not indicate measure breaks or barline breaks normally, so the only barlines that are indicated are unusual ones. Returns a LIST of :class:`~music21.bar.Barline` or :class:`~music21.bar.Repeat` objects because the `repEndBegin` type requires two `bar.Repeat` objects to encode in `music21`. >>> ci = capella.fromCapellaXML.CapellaImporter() >>> barlineTag = ci.domElementFromText('') >>> ci.barlineListFromBarline(barlineTag) [] >>> repeatTag = ci.domElementFromText('') >>> ci.barlineListFromBarline(repeatTag) [, ] FtypereprrTrr=) r startswith barlineMapr)rrRepeatpriorityBarline)r%barlineElement barlineList hasRepeatEnd barlineType repeatTypestartReps rr&CapellaImporter.barlineListFromBarlineMs*  ^** *(//7K%%e,,//1!%!=J!u-2#**3::e+<='+ !w/"4#&::g#6'4/01H-#**84 //1&&s{{4??;3O'PQrcg)z not implemented Nr)r%drawObjs rslurFromDrawObjSlur#CapellaImporter.slurFromDrawObjSlurws r)r$r"r#)Fr!)r. stream.ScorereturnrY)&rrrr__doc__r&r1r)r*rMr,r+r~rrrrrrrrrr TrebleClefBassClefAltoClef TenorClef Treble8vbClefrrrrrr+rJrrWrrrrrrSs "  94@D D9vM^$6p"*X:*X,>"__==== NN,, K*X /.2h:%$ !%!, J(T rrc\rSrSrSrSrg)Testi~cSSKJn [5n[R"5S- nUS- nUR U5nUR [UR5S5 UR[UR5R5S5 URSURURSS55 URS URURSS 55 g) Nr)rcapellaNu_rue_mit_sorgen.capxzmass!r=scherzr )music21rrrgetSourceFilePathr1 assertEqualr_ro assertGreaterrecurserassertInassembleLyrics)r%rcicapellaDirPath oswaldPathr0s r testCompleteTest.testCompletes  113i?#&?? $$Z0  Y__-q1 3y0028892> gt229??13EqIJ h 3 3IOOA4F JKrrN)rrrrrsrrrrrbrb~s Lrrbc$\rSrSrSrSrSrSrg) TestExternaliTc[5n[R"5S- nUS- nURU5nUR(aUR 5 ggNrdre)rrrjr1show)r%rprqrrr0s rrsTestExternal.testCompletesN  113i?#&?? $$Z0 99 NN  rcD[5n[R"5S- nUS- nURU5 UR 5 UR UR R5nURU5nUR(aUR5 ggrx) rrrjr)r*r+r$documentElementr,ry)r%rprqrrr/r0s rxtestImportSorgenTestExternal.xtestImportSorgens  113i?#&??  j)  **2::+E+EF//9 99 NN  rrN)rrrrryrsr}rrrrrvrvs Drrv__main__)!r[ __future__riortypingtunittestxml.etree.ElementTreer@r6rirrrrr r r r r rrrrMusic21ExceptionrrTestCaserbrvrmainTestrrrrs# N \:: h  h  V L8   L8$$< z Tr