rh_ %SrSSKJr SSKrSSKrSSKJr SSKJr SSKJr SSKJ r SSKJ r \ R"S 5r S //S Q/S Q/S Q/SQ/SQ/SQ/SQS.r S&SS.SjjrS'SS.SjjrS(SjrS(Sjr"SS\R$5r"SS\R(5r0rS\S'"SS 5r"S!S"5r"S#S$\R45r\/r\S%:XaSSKr\R<"\5 gg))zK Utility routines for processing text in scores and other musical objects. ) annotationsN)base)common) exceptions21) environment)styletextzal-)theaan) derdiedasdesdemdeneineineeinereinemeinen)dehetz'teen)ellaloslasununaunosunas)or osasumumaunsumas) lerlesl'runerduzde lar)illorr,iglir*zun'runor deldellodelladeideglidelle)arenrnlesptfrit  wordSeparatorc8/n/nUR5RnUGHSnURUS- nURS:wdM)UR S;a,URbUR UR5 McMeUR S;aLURbUR UR5 UR SRU55 /nMUR S:XamURbUR UR5 URSR S;a%UR SRU55 /nGM;GM>[SUR 35e URU5$![a GMwf=f) a0 Concatenate text from a stream. The Stream is automatically flattened. The `lineNumber` parameter determines which line of text is assembled, as a ONE-indexed identifier in the .lyrics array. (To be changed in v8 to go with an identifier.). This means that `lineNumber=0` will retrieve the last line of text. >>> s = stream.Stream() >>> n1 = note.Note() >>> n1.lyric = 'Hi' >>> n2 = note.Note() >>> n2.lyric = 'there' >>> s.append(n1) >>> s.append(n2) >>> text.assembleLyrics(s) 'Hi there' Composite lyrics can also be assembled. >>> composite = note.Lyric() >>> composite0 = note.Lyric(text="He'", syllabic='begin') >>> composite1 = note.Lyric(text="ya", syllabic='end') >>> composite1.elisionBefore = '_' >>> composite.components = [composite0, composite1] >>> n1.lyrics[0] = composite >>> text.assembleLyrics(s) "He'_ya there" To get the lyrics from another line, set the lineNumber attribute. (see also :func:`~music21.text.assembleAllLyrics` to get all lyrics). >>> n1.addLyric('Bye') >>> n2.addLyric('Now') >>> text.assembleLyrics(s, lineNumber=2) 'Bye Now' _)beginmiddle)endsingleN compositez no known Text syllabic setting: ) flatten notesAndRestslyrics IndexErrorr syllabicappendjoin components ValueError)streamIn lineNumberrCwordwords noteStreamnlyricObjs F/home/james-whalen/.local/lib/python3.13/site-packages/music21/text.pyassembleLyricsr_9sfN D E!!#11J  xx Q/H ==C   $77==,KK .-""&====,KK . RWWT]+""k1==,KK .&&r*337NNLL/DO!#CHDUDUCV!WXX56   e $$1   sF  FFcpSn[SU5H#n[XUS9nUS:wdMUS:aXB- nXF- nM% U$)a Concatenate all Lyrics text from a stream separated by lyricSeparation. The Stream is automatically recursed. uses assembleLyrics to do the heavy work. maxLyrics just determines how many times we should parse through the score, since it is not easy to determine what the maximum number of lyrics exist in the score. Here is a demo with one note and five lyrics. >>> f = corpus.parse('demos/multiple-verses.xml') >>> text.assembleLyrics(f, 1) '1. First' >>> text.assembleLyrics(f, 2) '2. Second' >>> l = text.assembleAllLyrics(f) >>> l '1. First\n2. Second\n3. Third\n4. Fourth\n5. Fifth' * Changed in v8: no lyric separator appears at the beginning. rKrErB)ranger_)rW maxLyricslyricSeparationrCrPr1lyrs r^assembleAllLyricsresJ.F 1i X F "91u) MF ! McHSU;aU$Uc/n[HnU[U- nM O [UnURS5SR5nSnUHnUR5U:XdMUn O Ub)US-SR URS5SS5-$U$)a Given a text string, if an article is found in a trailing position with a comma, place the article in front and remove the comma. >>> text.prependArticle('Ale is Dear, The') 'The Ale is Dear' >>> text.prependArticle('Ale is Dear, The', 'en') 'The Ale is Dear' >>> text.prependArticle('Ale is Dear, The', 'it') 'Ale is Dear, The' >>> text.prependArticle('Combattimento di Tancredi e Clorinda, Il', 'it') 'Il Combattimento di Tancredi e Clorinda' ,NrMrAarticleReferencesplitstriplowerrT)srclanguagerefkeytrailingmatch candidates r^prependArticlerus #~ #C #C( (C$x(yy~b!'')H E >> y (E  s{SXXciinSb&9::: rfcHSU;aU$Uc/n[HnU[U- nM O [UnURS5SR5nSnUHnUR5U:XdMUn O Ub)SR URS5SS5SU3-$U$)a Given a text string, if an article is found in a leading position, place it at the end with a comma. >>> text.postpendArticle('The Ale is Dear') 'Ale is Dear, The' >>> text.postpendArticle('The Ale is Dear', 'en') 'Ale is Dear, The' >>> text.postpendArticle('The Ale is Dear', 'it') 'The Ale is Dear' >>> text.postpendArticle('Il Combattimento di Tancredi e Clorinda', 'it') 'Combattimento di Tancredi e Clorinda, Il' rANrrEz, ri)rnrorprqleadingrsrts r^postpendArticlerxs  #~ #C #C( (C$x(iinQ%%'G E ==?i 'E  xx #qr*+5'l:: rfc\rSrSrSrg) TextExceptionN)__name__ __module__ __qualname____firstlineno____static_attributes__r|rfr^rzrzsrfrzc^\rSrSrSr\R rSrS U4Sjjr Sr \ S5r \ RS5r \ S5r\RS 5rS rU=r$) TextBoxa< A TextBox is arbitrary text that might be positioned anywhere on a page, independent of notes or staffs. A page attribute specifies what page this text is found on; style.absoluteY and style.absoluteX position the text from the bottom left corner in units of tenths. This object is similar to the TextExpression object, but does not have as many position parameters, enclosure attributes, and the ability to convert to RepeatExpressions and TempoTexts. >>> y = 1000 # set a fixed vertical distance >>> s = stream.Stream() Specify character, x position, y position >>> tb = text.TextBox('m', 250, y) >>> tb.style.fontSize = 40 >>> tb.style.alignVertical = 'bottom' >>> s.append(tb) >>> tb = text.TextBox('u', 300, y) >>> tb.style.fontSize = 60 >>> tb.style.alignVertical = 'bottom' >>> s.append(tb) >>> tb = text.TextBox('s', 550, y) >>> tb.style.fontSize = 120 >>> tb.style.alignVertical = 'bottom' >>> s.append(tb) >>> tb = text.TextBox('ic', 700, y) >>> tb.style.alignVertical = 'bottom' >>> tb.style.fontSize = 20 >>> tb.style.fontStyle = 'italic' >>> s.append(tb) >>> tb = text.TextBox('21', 850, y) >>> tb.style.alignVertical = 'bottom' >>> tb.style.fontSize = 80 >>> tb.style.fontWeight = 'bold' >>> tb.style.fontStyle = 'italic' >>> s.append(tb) >>> #_DOCS_SHOW s.show() .. image:: images/textBoxes-01.* :width: 600 ic >[TU]"S0UD6 SUlXlSUlX R lX0R lSUR lSUR l g)NrEtopcenterr|) super__init___contentcontent_pager absoluteX absoluteY alignVerticalalignHorizontal)selfrxykeywords __class__s r^rTextBox.__init__-sT $8$     #(  %- "rfcURb4[UR5S:a[URSSS-5$URb[UR5$g)N z...rK)rlenreprrs r^ _reprInternalTextBox._reprInternal<sS == $T]]);b)@ cr*U23 3 ]] & & &rfcUR$)z Get or set the content. >>> te = text.TextBox('Con fuoco') >>> te.content 'Con fuoco' >>> te.style.justify = 'center' >>> te.style.justify 'center' )rrs r^rTextBox.contentEs}}rfc\[U[5(d[U5UlgXlgN) isinstancestrrrvalues r^rrSs%%%JDM!MrfcUR$)z Get or set the page number. The first page (page 1) is the default. >>> te = text.TextBox('Great Score') >>> te.content 'Great Score' >>> te.page 1 >>> te.page = 2 >>> te.page 2 )rrs r^page TextBox.pageZszzrfc,Ub[U5Ulggr)intrrs r^rrjs  UDJ rf)rrr)Nr)r}r~rr__doc__r TextStyle _styleClassclassSortOrderrrpropertyrsetterrr __classcell__)rs@r^rrs{0b//KN .   ^^""    [[$$rfrzdict[str, Trigram]_stored_trigramscb\rSrSrSr/SQrSSSSSS S S.r\S 5rSS jr SSjr SSjr Sr g )LanguageDetectoriua; Attempts to detect language on the basis of trigrams. >>> ld = text.LanguageDetector() >>> ld.mostLikelyLanguage('Guten Morgen Frau Wieck. Ich bin Robert.') 'de' Note that accuracy improves with longer texts, and that the trigrams are case sensitive. Putting "Morgen" in lowercase evaluates the text as Dutch. Supported languages are currently: >>> text.LanguageDetector.languageLong {'en': 'English', 'fr': 'French', 'it': 'Italian', 'de': 'German', 'cn': 'Chinese', 'la': 'Latin', 'nl': 'Dutch'} See also, documentation for :class:`~music21.text.Trigram`. )r;r?r@rcnrr<EnglishFrenchItalianGermanChineseLatinDutchcFURHln[R"5S- S- US-- nURSS9nUR 5R 5n[ U5[U'SSS5 Mn [R5$!,(df  M=f)zb Read the stored trigrams once and store them for later. Called on first LanguageDectector read. languageExcerpts trainingDataz.txtzutf-8)encodingN) languageCodesrgetSourceFilePathopenreadrkTrigramrcopy)cls languageCode thisExcerptf excerptWordss r^ readExcerptsLanguageDetector.readExcerptss --L!3358JJ,-0>> text.LanguageDetector.languageCodes ['en', 'fr', 'it', 'de', 'cn', 'la', 'nl'] or None if no language is detected. >>> ld = text.LanguageDetector() >>> ld.mostLikelyLanguage('Hello there, how are you doing today? ' ... + "I haven't seen you in a while.") 'en' >>> ld.mostLikelyLanguage('Ciao come stai? Sono molto lento oggi, ma non so perche.') 'it' >>> ld.mostLikelyLanguage('Credo in unum deum. Patrem omnipotentem. Factorum celi') 'la' >>> ld = text.LanguageDetector() >>> ld.mostLikelyLanguage('') is None True NrK?)rrr)rexcerpt excTrigrammaxLang maxDifferencelanglangDiffs r^mostLikelyLanguage#LanguageDetector.mostLikelyLanguagesX0W%  &&D}}T*Z7H' ( ' rfcUbUS:XagURU5n[[UR55HnURUU:XdMUS-s $ [ S5e)aF returns a number representing the most likely language for a passage or 0 if there is no text. Useful for feature extraction. The codes are the index of the language name in LanguageDetector.languageCodes + 1 >>> ld = text.LanguageDetector() >>> for index in range(len(ld.languageCodes)): ... print(str(index + 1) + ' ' + ld.languageCodes[index]) 1 en 2 fr 3 it 4 de 5 cn 6 la 7 nl >>> numLang = ld.mostLikelyLanguageNumeric('Hello there, how are you doing today? ' ... + "I haven't seen you in a while.") >>> numLang 1 >>> ld.languageCodes[numLang - 1] 'en' rKrrEz;got a language that was not in the codes; should not happen)rrarrrz)rrlangCoder1s r^mostLikelyLanguageNumeric*LanguageDetector.mostLikelyLanguageNumericsf4 ?gm..w7H3t1123%%a(H4q5L4 ]^ ^rf)r rr)rrreturnz str | None) r}r~rrrr languageLong classmethodrrrrrr|rfr^rrusP8?ML ' ' S#L!_rfrc^\rSrSrSrS Sjr\S5rSrSr SSjr SS jr S r S r S rg)ria See LanguageDetector above. From https://code.activestate.com/recipes/326576-language-detection-using-character-trigrams/ The frequency of three character sequences is calculated. When treated as a vector, this information can be compared to other trigrams, and the difference between them seen as an angle. The cosine of this angle varies between 1 for complete similarity, and 0 for utter difference. Since letter combinations are characteristic to a language, this can be used to determine the language of a body of text. For example: >>> #_DOCS_SHOW reference_en = Trigram('/path/to/reference/text/english') >>> #_DOCS_SHOW reference_de = Trigram('/path/to/reference/text/german') >>> #_DOCS_SHOW unknown = Trigram('url://pointing/to/unknown/text') >>> #_DOCS_SHOW unknown.similarity(reference_de) #_DOCS_SHOW 0.4 >>> #_DOCS_SHOW unknown.similarity(reference_en) #_DOCS_SHOW 0.95 would indicate the unknown text is almost certainly English. As syntax sugar, the minus sign is overloaded to return the difference between texts, so the above objects would give you: #_DOCS_SHOW >>> unknown - reference_de #_DOCS_SHOW 0.6 #_DOCS_SHOW >>> reference_en - unknown # order doesn't matter. #_DOCS_SHOW 0.05 As it stands, the Trigram ignores character set information, which means you can only accurately compare within a single encoding (iso-8859-1 in the examples). A more complete implementation might convert to unicode first. As an extra bonus, there is a method to make up nonsense words in the style of the Trigram's text. >>> #_DOCS_SHOW reference_en.makeWords(30) My withillonquiver and ald, by now wittlectionsurper, may sequia, tory, I ad my notter. Marriusbabilly She lady for rachalle spen hat knong al elf NcJ0UlSUlUbURU5 ggr)lut_length parseExcerpt)r excerptLists r^rTrigram.__init__)s)  "   k * #rfcTURcUR5$UR$r)rmeasurers r^lengthTrigram.length/s" << <<> !<< rfcSn[U[5(a_UHXnUR5S-H>nURR U05nUR US5S-XT'USU-nM@ MZ ODUH>nURR U05nUR US5S-XT'USU-nM@ UR 5 g)N rArrE)rlistrlr setdefaultgetr)rrpairlineletterds r^rTrigram.parseExcerpt6s gt $ $"jjlS0F++D"5A !fa 01 4AI7V+D1 "HH''b1EE&!,q0 Aw'" rfc SnURR5H2nU[UR5Vs/sHo3U-PM sn5- nM4 US-nX@lgs snf)zR calculates the scalar length of the trigram vector and stores it in self.length. r?N)rvaluessumr)rtotalrr thisLengths r^rTrigram.measureEsW "A S4Aa%45 5E#c\ ! 5sA c&[U[5(d [S5eURnURnSnUH.nXS;dM X%nX5nUHnX;dM XFUXx-- nM M0 [ X@R UR -- 5$)z returns a number between 0 and 1 indicating similarity between two trigrams. 1.0 means an identical ratio of trigrams; 0.0 means no trigrams in common. z&can't compare Trigram with non-Trigramr)rr TypeErrorrfloatr) rotherlut1lut2rkr brs r^ similarityTrigram.similarityPs%))DE ExxyyAyGGAv1, UkkELL89::rfc*SURU5- $)za indicates difference between trigram sets; 1.0 is entirely different, 0.0 is entirely the same. r)r)rrs r^__sub__Trigram.__sub__js T__U+++rfc/nSnU(a>URU5nURU5 USU-nUS;aUS-nU(aM>SRU5$)z< returns a string of made-up words based on the known text. rrEz rK)likelyrSrT)rcountr rr\s r^ makeWordsTrigram.makeWordsqs]  AA KKN!qAEz  e wwt}rfcXR;ag/nURUR5Hup4URX4-5 M SRU5n[R "U5$)zm Returns a character likely to follow the given string two character string, or a space if nothing is found. rArK)ritemsrSrTrandomchoice)rrlettersletKvs r^r Trigram.likelys^ HH xx{((*GD NN48 $+'''"}}W%%rf)rrr)rrrr)r}r~rrrrrrrrrr rr rr|rfr^rrs?(T+    ";4,  &rfrc&\rSrSrSrSrSrSrg)Testic,SSKJn SSKJn URUR S55n[ U5nUR US5 URUR S55n[ U5nURURS55 g)Nr) converter)corpuszhaydn/opus1no1/movement4.xmlrKz luca/gloriaz)Et in terra pax hominibus bone voluntatis) music21rrparsegetWorkr_ assertEqual assertTrue startswith)rrrr posts r^ testBasicTest.testBasicsq%" OOFNN+IJ Ka  r" OOFNN=9 :a  (STUrfcHSSKJn SSKJn UR5nSH*nUR 5nXElUR U5 M, [U5nURUS5 UR5nSH*nUR 5nXElUR U5 M, [U5nURUS5 UR5nSH*nUR 5nXElUR U5 M, [US S 9nURUS 5 g) Nr)stream)note)zhel-z-loa-z-gainz hello again)r*z-ris-z-to-z-catsaregreatzaristocats are great)u长u亭u外u古u道u边rKrBu长亭外古道边) rr(r)StreamNotelyricrSr_r!)rr(r)ssylr\r$s r^testAssembleLyricsATest.testAssembleLyricsAs" MMO1C AG HHQK2a  }- MMOCC AG HHQKDa  56 MMO=C AG HHQK>ar2 34rfc&[5nURSURS- nURSUs=:=(a S:Os 5 URSURSURS- s=:=(a S:Os 5 URSURSURS - s=:=(a S :Os 5 URS UR S 55 URSUR S 55 g)Nr?r@rg?gq= ףp?rgffffff?gGz?rrr;zhhello friends, this is a test of the ability of language detector to tell what language I am writing in.uxciao amici! cosé trovo in quale lingua ho scritto questo passaggio. Spero che troverà che é stata scritta in italiano)rrr"r!r)rlddiffFrIts r^testLanguageDetectorTest.testLanguageDetectors  ;;t$r{{4'88 x..$./ r{{402;;t3DDKKtKL r{{402;;t3DDJJsJK ..0WX Y r44 : ; rEs#  &&v.  '  ^ $ A < M =!,F%CF%RUXF#L$P L11 u$d  u$t(*$)D_D_PO&O&f:<8  :