jdZddlmZddlmZddlZddlZddlZ ddl Z ddl m Z ddl m Z ddl mZddl mZdd l mZdd l mZdd l mZdd l mZdd l mZddl mZddl mZddl mZddl mZGddejZGddZGddejZGddejZedkrddl Z e j edSdS)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)tieceZdZdS)CapellaImportExceptionN)__name__ __module__ __qualname__/Users/tedpeters/Documents/Projects/Claude Projects/Misc Tools/notename-sheets/.venv/lib/python3.11/site-packages/music21/capella/fromCapellaXML.pyrrNsDrrceZdZdZdZd'dZdZd(dZd(dZd)d Z d(d Z d(dZ d(dZ dZ dZdZdZdZdZdZdZejejejejejdZdZdZdZdZdZ ddd d!d"d#d$Z!d%Z"d&Z#dS)*CapellaImportera. 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. c0d|_d|_d|_dSN)xmlText zipFilenamemainDom)selfs r__init__zCapellaImporter.__init__[s  rFc|||||j}|dur|S||}|S)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 scoreFromFilezCapellaImporter.scoreFromFile`sh ))) ,,T\:: $  O55h??I rct||_tjt|d5}|d}dddn #1swxYwY||_|S)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)strrzipfileZipFilereadr)r!r( zipFileHandlers rr$z"CapellaImporter.readCapellaXMLFileqsx== _S]]C 0 0 6M#((55G 6 6 6 6 6 6 6 6 6 6 6 6 6 6 6 sAA ANc^||j}t|ts|d}tjjt|}|D]4\}}d|j vr&|j ddd|_ 5|j |_ |j S)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. Nzutf-8}) r isinstancer/decodexmletree ElementTree iterparsertagsplitrootr )r!ritunusedels rr%zCapellaImporter.parseXMLText~s ?lG'3'' .nnW--G Y " , ,Xg->-> ? ? 1 1JFBbf}}c1--a0w |rcJtjj|S)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 )r9r:r; fromstring)r!rs rdomElementFromTextz"CapellaImporter.domElementFromTexts0y$//888rr) stream.Scorereturnc t|tj}i}|D]}||}|tj}t |D]\}}|j|vr-t j} |j| _| |d||j<n||jd} |D]2} | tj | j |z| 3| t j } dtt|D} |D]} || }|d| |d<| D]}|t!d|t"j}|t&j}d}d}|D] }||kr|||}!|D] }||kr|||}!|d| d || | S) z Take a :class:`~music21.stream.Score` object which is organized by Systems and return a new `Score` object which is organized by Parts. )partnumberrIcg|]}dSrr).0is r z.s(P(P(P!(P(P(PrrJNz#part entries do not match partDict!T)inPlacer)getElementsByClassr System elementOffsetrPart enumerateid coreInsertropFracoffsetcoreElementsChangedScorerangelenprintrClefr KeySignatureremove makeMeasures)r!r) systemStream partDictById thisSystem systemOffset partStreamjthisPartnewPartrBnewScorepartspartIdpartDictpclefs keySignatureslastCleflastKeySignatureckss rr'z(CapellaImporter.partScoreFromSystemScoresx#55fmDD 8: & . .J'44Z@@L#66v{CCJ(44 . . 8;l22$kmmG!)GJ9@A0N0NL--*8;7?G"TTB&&v}RY5M'N'NPRSSSS++---- .<>>(P(PuS=N=N7O7O(P(P(P" 9 9F#F+H(0(8E(8$ % % & &Ay;<<<((33E001ABBMH#  ! !==HHQKKKK HH# * *)))HHRLLLL')$$ NN4N ( ( (   1 % % % %$$&&&rc|tj}|d}|stdt |dkrtd|d}|d}|stdt |D]9\}}||}|dz|_||:| |S) aX 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. Nsystemsz1Cannot find a tag in the objectr6zMFound more than one tag in the object, what does this mean?rsystemzHCannot find any tags in the tag in the object) rrZfindallrr\rTsystemFromSystem systemNumber coreAppendrY) r! scoreElementr* systemsListsystemsElement systemListrzrd systemObjs rr&z$CapellaImporter.systemScoreFromScores  |~~H"**955  E(CEE E {  a  (_aa a$Q#++H55  \(Z\\ \)2*(=(= + + $L*--j99I%1A%5I "    * * * *$$&&&rcd|tj}|d}|stdt |dkrtd|d}|d}|std|D] }d }d |jvr |jd }t j}||_|d } | std | d} | d } | stdt | dkrn| d} | d} | stdt | dkrtd| d}| ||| d|"|S)a 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 Nstavesz.No tag found in this elementr6z9More 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 rQrxrr\attribrrSrUstreamFromNoteObjectsinsert)r! systemElementr stavesList stavesElement staffListthisStaffElementrlpartObj voicesList voicesElement voiceListthisVoiceElementnoteObjectsListthisNoteObjects rryz CapellaImporter.systemFromSystem s   I"**844  [()YZZ Z z??Q  (KMM M"1 !))'22  Z(XZZ Z )" )" ) "F+222)0:kmmGGJ)11(;;J 3,2333'qMM%--g66I D,CDDD9~~""#,Q< "2":":="I"I&302333''!++06777"1!3**>7CCC   Q ( ( ( (rc|tj}n|}|j|j|j|j|j|jd}|D]{}d}|j}||vrtd|"|||}t|tr|D]}| |c|f| ||| |S)a 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 restFromRestchordOrNoteFromChordbarlineListFromBarliner=r]r7listr{rY) r!noteObjectsElement streamObjsmappingdrBdTagelSubs rrz%CapellaImporter.streamFromNoteObjectsGs`   AAA#4":#=, 5"9 $ % %AB5D7""14112222"WT]1%%b$''%!#,, U++++,ZLL$$$$ rctj}|d}||d|_|S)aj 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)rRestrxdurationFromDurationr )r! restElementr. durationLists rrzCapellaImporter.restFromRests@ IKK"**:66 ..|A?? rc2|d}|d}t|dkst|dkrtd||d}d}|stdt|dkr |d}nt j|}||d|_|d}|r"||d}||_ |S)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 headsr6zMalformed chord!rNlyric) rxr\rnotesFromHeadsrChordrr lyricListFromLyriclyrics)r! chordElementr headsList notesList noteOrChord lyricsLists rrz$CapellaImporter.chordOrNoteFromChords:$++J77  ((11 |   ! !S^^q%8%8();<< <'' ! 55   =();<< < y>>Q  #A,KK+i00K#88aII !))'22  ,00A??J!+K rcg}|d}|D]*}|||+|S)a returns a list of :class:`~music21.note.Note` elements for each in >>> ci = capella.fromCapellaXML.CapellaImporter() >>> headsElement = ci.domElementFromText( ... '') >>> ci.notesFromHeads(headsElement) [, ] head)rxappend noteFromHead)r! headsElementnotes headDomList headElements rrzCapellaImporter.notesFromHeadssS"**622 & 9 9K LL**;77 8 8 8 8 rc\d|jvrtd|jd}tj}||_|jdz |_|d}t|dkrtdt|dkr'||d}||j _ |d}t|dkrtdt|dkr"| |d}||_ |S) 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!r6alterz+Cannot deal with multiple elements!rrz)Cannot deal with multiple elements!) rrrNotenameWithOctaveoctaverxr\accidentalFromAlterr accidental tieFromTier)r!rnoteNameWithOctavenaltersacctiesthisTies rrzCapellaImporter.noteFromHeads$ +, , ,()YZZ Z(/8 IKK-8a<$$W-- v;;??()VWW W v;;!  **6!955C!$AG ""5)) t99q==()TUU U t99>>ood1g..GAErcd|jvrt|jd}ntdd}tj|}d|jvr|jddkrd|_|S)ao 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 rrz#CapellaImporter.accidentalFromAltersz$ \( ( (\0899JJ $ % % %Jz**  + + + 0CI0NR\0\0\%CO rcd}d}d|jvr|jddkrd}d|jvr|jddkrd}d}|dur|durd}n|durd}n |durd }ndStj|}|S) 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 rrzCapellaImporter.tieFromTie9s. j' ' 'J,=g,F&,P,PE J% % %**;E*Bf*L*LC D==SD[[ GG d]]GG D[[GG4!! rcg}|d}|D].}||}|||/|S)aH 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)rxlyricFromVerser)r! lyricElement lyricListversesr thisLyrics rrz"CapellaImporter.lyricListFromLyricds_ %%g.. , ,A++A..I$  +++rcd}d}d|jvrt|jddz}d|jvr|jddkrd}|j}||dkrdStj|||d }|S) a 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 r6singlerMhyphenrrNT)textrJsyllabicapplyRaw)rrrrLyric)r!r verseNumberrrrs rrzCapellaImporter.lyricFromVerseys  %,  el3/0014K u| # # X(>&(H(HHz <42::4JDxZ^___ELr)treblebassaltotenorzG2-cxd|jvr|jd}||jvr|j|S|ddkrtjSt |dkrS|dd}d}t |dkr|ddkrd}n|ddkrd}tj||}|Sd S) 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 rrrnr6+-N)r clefMappingrPercussionClefr\clefFromString)r!r clefValueclefSignAndLineclefOctaveChangeclefObjs rrz CapellaImporter.clefFromClefSigns2 X_ $ $ /ID,,,2t' 24441$$*,,,Y!##"+AaC.#$ y>>A%% |s**+,(("1,,+-(-o?OPPtrctd|jvr.t|jd}tj|SdS)a7 Returns a :class:`~music21.key.KeySignature` object from a keySign tag. >>> ci = capella.fromCapellaXML.CapellaImporter() >>> keySign = ci.domElementFromText('') >>> ci.keySignatureFromKeySign(keySign) fifthsN)rrr r_)r!r keyFifthss rrz'CapellaImporter.keySignatureFromKeySigns> w~ % %GN8455I#I.. . & %rcjd|jvr)|jd}|dkrtj|SdSdS)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 rrz)CapellaImporter.timeSignatureFromTimeSignsC X_ $ $!0JZ''*:666t4rctj}d|jvrh|jd}|d}|dkr@t |d|}t ||dzd}d|z|z }||_d|jvr!t |jd}||_|d } | D],} || } | | -|S) 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/rrr6Ng@dotstuplet) r Durationrfindr quarterLengthrrxtupletFromTuplet appendTuplet) r!durationElementdur baseValue slashIndex firstNumber secondNumberr dotNumbertupletsrrs rrz$CapellaImporter.durationFromDurations :!! _+ + +'.v6I",,JR!)AjL"9:: "9Z!^__#=>> !${!2l B $1! _+ + +O26:;;I CH!))(33 % %A**1--F   V $ $ $ $ rcd}d}d|jvr3t|jd}d}||dzkr|dz}||dzkd|jvr|jddkr|dz}d|jvrtdtj||}|S)aW 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 r6countrprolongr 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 rrz CapellaImporter.tupletFromTuplet#s  m* * *M09::IKkAo--q kAo--  , , ,1Eg1NRX1X1X 1 K =/ / / a c c coi55 rnormaldoublefinalrrz end-start)rr,rrepEndrepBegin repEndBeginc(g}d}d|jvr|jd}|dr||jvr|j|}|ddkr)|t jdd}|ddkr4t jd}|durd|_||n;||jvr2|t j|j||S) ai 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) [, ] FtypereprrTrr6) r startswith barlineMaprrrRepeatpriorityBarline)r!barlineElement barlineList hasRepeatEnd barlineType repeatTypestartReps rrz&CapellaImporter.barlineListFromBarlineGs(  ^* * *(/7K%%e,, R$/11!%!=J!u--22#**3:e+<+<==='+ !w//"44#&:g#6#6'4//01H-#**8444$/11&&s{4?;3O'P'PQQQrcdS)z! not implemented Nr)r!drawObjs rslurFromDrawObjSlurz#CapellaImporter.slurFromDrawObjSlurps  r)Fr)r)rFrGrF)$rrr__doc__r"r,r$r%rEr'r&ryrrrrrrrrrr TrebleClefBassClefAltoClef TenorClef Treble8vbClefrrrrrrr5rrArrrrrRs "    99994@@@@D    D9999vMMMM^$555n"***X:)))V*>"_== N, K***X / / /.111f8%$ !%!, J'''R     rrceZdZdZdS)Testc&ddlm}t}tjdz }|dz }||}|t|jd| t| j d| d| |jdd| d | |jdd dS) Nr)rcapellaNu_rue_mit_sorgen.capxzmass!r6scherzr)music21rrrgetSourceFilePathr, assertEqualr\rk assertGreaterrecurserassertInassembleLyrics)r!rcicapellaDirPath oswaldPathr+s r testCompletezTest.testCompletexs        133i?#&?? $$Z00  Y_--q111 3y00228992>>> gt229?13EqIIJJJ h 3 3IOA4F J JKKKKKrN)rrrrZrrrrIrIws( L L L L LrrIceZdZdZdZdZdS) TestExternalTct}tjdz }|dz }||}|jr|dSdSNrKrL)rrrQr,show)r!rWrXrYr+s rrZzTestExternal.testCompletesh   133i?#&?? $$Z00 9  NN       rcLt}tjdz }|dz }|||||jj}||}|j r| dSdSr^) rrrQr$r%r&r documentElementr'r_)r!rWrXrYr*r+s rxtestImportSorgenzTestExternal.xtestImportSorgens   133i?#&??  j)))  **2:+EFF//99 9  NN       rN)rrrr_rZrbrrrr\r\s7 Drr\__main__)!rB __future__riortypingtunittestxml.etree.ElementTreer9r0rPrrrrr r r r r rrrrMusic21ExceptionrrTestCaserIr\rmainTestrrrrmsA#""""" N     \:   b  b  b  b  b  b  b  b  J L L L L L8  L L L8$< zNNNGTr