rh`%SrSSKJr SSKrSSKrSSKrSSKrSSKrSSK r SSK J r SSK J r SSK J r SSKJr \ R "S5rS S0rS \S 'S r"S S5r"SS5r"SS5rSrSr"SS\ R45r"SS\ R45r/rS\S'\S:XaSSK r \ R>"\5 gg)a This module defines classes for representing Scala scale data, including Scala pitch representations, storage, and files. The Scala format is defined at the following URL: https://www.huygens-fokker.org/scala/scl_format.html We thank Manuel Op de Coul for allowing us to include the repository (as of May 11, 2011) with music21 Scala files are encoded as latin-1 (ISO-8859) text Utility functions are also provided to search and find scales in the Scala scale archive. File names can be found with the :func:`~music21.scala.search` function. To create a :class:`~music21.scale.ScalaScale` instance, simply provide a root pitch and the name of the scale. Scale names are given as the scala .scl filename. >>> mbiraScales = scale.scala.search('mbira') >>> mbiraScales ['mbira_banda.scl', 'mbira_banda2.scl', 'mbira_gondo.scl', 'mbira_kunaka.scl', 'mbira_kunaka2.scl', 'mbira_mude.scl', 'mbira_mujuru.scl', 'mbira_zimb.scl'] For most people you'll want to do something like this: >>> sc = scale.ScalaScale('a4', 'mbira_banda.scl') >>> [str(p) for p in sc.pitches] ['A4', 'B4(-15c)', 'C#5(-11c)', 'E-5(-7c)', 'E~5(+6c)', 'F#5(+14c)', 'G~5(+1c)', 'B-5(+2c)'] ) annotationsN)common) environment)interval)sclz scale.scalaallPathsz&dict[str, dict[str, list[str]] | None] SCALA_PATHSc[Sb [S$[n[US5(dUnO[URSn[ [ R "U55Vs/sH"n[ RRX#5PM$ nn0nUHnURS5(dM/XE'[ RRU5up&URSS5nXERU5 [ RRU5up&UR5nURSS5nURSS5nURSS5nXERU5 M U[S'U$s snf)z Get all scala scale paths. This is called once or the module and cached as SCALA_PATHS, which should be used instead of calls to this function. >>> a = scale.scala.getPaths() >>> len(a) >= 3800 True r__path__r.scl_-)r rhasattrr sortedoslistdirpathjoinendswithsplitreplaceappendlower) moduleName dirListing directoryxpathsfpfns V/home/james-whalen/.local/lib/python3.13/site-packages/music21/scale/scala/__init__.pygetPathsr#CsG:*:&&J :z * *  ''* :@IAV:WX:WQbggll90:W X E ;;v  EIGGMM"-MIFB'B I  R GGMM"-MIBFB'BC$BC$B I  R $K  L'Ys)E;c2\rSrSrSrSSjrSrSSjrSrg) ScalaPitchpa Representation of a scala pitch notation >>> sp = scale.scala.ScalaPitch(' 1066.667 cents') >>> print(sp.parse()) 1066.667 >>> sp = scale.scala.ScalaPitch(' 2/1') >>> sp.parse() 1200.0 >>> sp.parse('100.0 C#') 100.0 >>> [sp.parse(x) for x in ['89/84', '55/49', '44/37', '63/50', '4/3', '99/70', '442/295', ... '27/17', '37/22', '98/55', '15/8', '2/1']] [100.0992..., 199.9798..., 299.9739..., 400.10848..., 498.04499..., 600.0883..., 699.9976..., 800.9095..., 900.0260..., 1000.0201..., 1088.2687..., 1200.0] NcHSUlUbURU5 SUlgN)src_setSrccents)self sourceStrings r"__init__ScalaPitch.__init__s$  # LL & c|UR5n[R"USS9upUR5Ulg)Nz 0123456789./)numbers)stripr getNumFromStrr))r,rawjunks r"r*ScalaPitch._setSrcs.iik((nE 99;r0cUbURU5 SUR;a&[UR5UlUR$SUR;a3URR S5up#[U5[U5p2O[UR5nSnS[ R "X#- S5-UlUR$)z- Parse the source string and set self.cents. ./g?g@)r*r)floatr+rmathlog)r,r-nds r"parseScalaPitch.parses  # LL & $((?txxDJzzdhhxx~~c*Qxq1$((O$((AEA"66DJzzr0)r+r)r() __name__ __module__ __qualname____firstlineno____doc__r.r*rA__static_attributes__r0r"r%r%ps* r0r%cL\rSrSrSrS SjrSrSrSrSr S r S r S r S r g) ScalaDatau Object representation of data stored in a Scala scale file. This object is used to access Scala information stored in a file. To create a music21 scale with a Scala file, use :class:`~music21.scale.ScalaScale`. This is not called ScalaScale, as this name clashes with the :class:`~music21.scale.ScalaScale` that uses this object. >>> import os >>> sf = scale.scala.ScalaFile() >>> fp = common.getSourceFilePath() / 'scale' / 'scala' / 'scl' / 'tanaka.scl' >>> sf.open(fp) >>> sd = sf.read() ScaleFile descriptions are converted to unicode. >>> print(sd.description) 26-note choice system of Shohé Tanaka, Studien i.G.d. reinen Stimmung (1890) >>> sd.pitchCount 26 Distances from the tonic: >>> cat = sd.getCentsAboveTonic() >>> len(cat) 26 >>> list(int(round(x)) for x in cat[0:4]) [71, 92, 112, 182] >>> sd.pitchValues[0] >>> sd.pitchValues[0].cents 70.6724... This will not add up with centsAboveTonic above, due to rounding >>> adj = sd.getAdjacentCents() >>> list(int(round(x)) for x in adj[0:4]) [71, 22, 20, 71] Interval Sequences >>> intSeq = sd.getIntervalSequence() >>> intSeq[0:4] [, , , ] Tweak the file and be ready to write it back out: >>> sd.pitchValues[0].cents = 73.25 >>> sd.fileName = 'tanaka2.scl' >>> sd.description = 'Tweaked version of tanaka.scl' >>> fs = sd.getFileString() >>> print(fs) ! tanaka2.scl ! Tweaked version of tanaka.scl 26 ! 73.25 92.17... 111.73... 182.40... Be sure to reencode `fs` as `latin-1` before writing to disk. >>> sf.close() NcFXlX lSUlSUl/Ulgr()r)fileName description pitchCount pitchValues)r,r-rNs r"r.ScalaData.__init__s'  r0c URRS5nSn[U5Hup4UR5nUR S5(a3US:Xa+UR cSU;aUSSR5UlM^US- nUS:XaUS:waX@lMwMyUS:XaUS:wa[U5UlMMUS:wdM[U5nUR5 URRU5 M g) z@ Parse a scala file delivered as a long string with line breaks  r!Nr r r;) r)r enumerater3 startswithrNrOintrPr%rArQr)r,linescountilinesps r"rAScalaData.parsest$ 'GA::&&(A KK))!d(3 4) r0c/UlSnUHGn[5nX#R-UlURnURRU5 MI [ UR5Ulg)z0 Set the scale from a list of Interval objects. rNrk)r,iListrer\r^s r"setIntervalSequenceScalaData.setIntervalSequenceIsaAB'')BHxxH    # #B '  d../r0cL/nURbURSUR35 URS5 URbURUR5 OURS5 URb%UR[ UR55 OURS5 URS5 UR H'nUR[ UR 55 M) URS5 SRU5$)z Return a unicode-string suitable for writing a Scala file The unicode string should be encoded in Latin-1 for maximum Scala compatibility. z! rUr rT)rNrrOrPstrrQr+r)r,msgr^s r" getFileStringScalaData.getFileStringWs == $ JJDMM?+ , 3    ' JJt'' ( JJrN ?? & JJs4??+ , JJrN 3""B JJs288} %# 2yy~r0)rOrNrPrQr))NN)rCrDrErFrGr.rArarhrnrrrvr{rHrIr0r"rKrKs1DJ 0:5  0 0r0rKcV\rSrSrSrSSjrSSjrSrSrSr S r S r S r S r S rg) ScalaFileiya Interface for reading and writing scala files. On reading, returns a :class:`~music21.scala.ScalaData` object. >>> import os >>> sf = scale.scala.ScalaFile() >>> fp = common.getSourceFilePath() / 'scale' / 'scala' / 'scl' / 'tanaka.scl' >>> sf.open(fp) >>> sd = sf.read() >>> sd >>> sd is sf.data True >>> sf.fileName.endswith('tanaka.scl') True >>> sd.pitchCount 26 >>> sf.close() Nc,SUlSUlXlgr()rNfiledata)r,rs r"r.ScalaFile.__init__s   r0c[R"XSS9Ul[RR U5Ulg)z Open a file for reading zlatin-1)encodingN)ioopenrrrbasenamerN)r,r modes r"rScalaFile.opens,GGBy9 ((, r0cXlg)zX Assign a file-like object, such as those provided by StringIO, as an open file object. N)r)r,fileLikes r" openFileLikeScalaFile.openFileLikes  r0c SnU$)Nz rI)r,rs r"__repr__ScalaFile.__repr__s r0c8URR5 gr()rcloser,s r"rScalaFile.closes r0cTURURR55$)z Read a file. Note that this calls readstr, which processes all tokens. If `number` is given, a work number will be extracted if possible. )readstrrreadrs r"rScalaFile.reads ||DIINN,--r0c\[XR5nUR5 X lU$)zF Read a string and process all Tokens. Returns a ABCHandler instance. )rKrNrAr)r,strSrcsss r"rScalaFile.readstrs%v}} -    r0cZUR5nURRU5 gr()writestrrwrite)r,wss r"rScalaFile.writes ]]_ r0cv[UR[5(aURR5$gr() isinstancerrKr{rs r"rScalaFile.writestrs+ dii + +99**, , ,r0)rrrNr()r)rCrDrErFrGr.rrrrrrrrrHrIr0r"r~r~ys4( - .-r0r~c2Sn[U[R5(a [U5n[R R U5(aURS5(aUnURSS5nUcX[5HJn[R RU5up4UR5UR5:XdMHUn O Uc>[5H0n[5UHnUR5U:XdMUn M. M2 Uc>[5H0n[5UHnUR5U;dMUn M. M2 Ub=[5nURU5 UR5nUR5 U$g)aZ Get a :class:`~music21.scala.ScalaData` object from the bundled SCL archive or a file path. >>> ss = scale.scala.parse('balafon6') >>> ss.description 'Observed balafon tuning from Burma, Helmholtz/Ellis p. 518, nr.84' >>> [str(i) for i in ss.getIntervalSequence()] ['', '', '', '', '', '', ''] >>> scale.scala.parse('incorrectFileName.scl') is None True >>> ss = scale.scala.parse('barbourChrom1') >>> print(ss.description) Barbour's #1 Chromatic >>> ss.fileName 'barbour_chrom1.scl' >>> ss = scale.scala.parse('blackj_gws.scl') >>> ss.description 'Detempered Blackjack in 1/4 kleismic marvel tuning' Nr  r )rpathlibPathryrrexistsrrr#rrr~rrr)targetmatchr unused_directoryr!altsfrs r"rArAsH: E&',,''V ww~~f&//&"9"9^^C $F }*B#%77==#4 ||~+  }*Bz"~<<>S(E&  }*Bz"~<<>S(E&  [  WWY   r0cB/nURSS5n[5H`n[RR U5up4UR 5UR 5:XdMHX!;dMOUR U5 Mb [5HEn[5UH1nUR 5U;dMX!;dM UR U5 M3 MG /nUH1nUR [RRU55 M3 UR5 U$)a Search the scala archive for matches based on a string >>> mbiraScales = scale.scala.search('mbira') >>> mbiraScales ['mbira_banda.scl', 'mbira_banda2.scl', 'mbira_gondo.scl', 'mbira_kunaka.scl', 'mbira_kunaka2.scl', 'mbira_mude.scl', 'mbira_mujuru.scl', 'mbira_zimb.scl'] rr ) rr#rrrrrrsort)rrr rr!rnamess r"searchrs E^^C $Fj!ww}}R0 <<>RXXZ ' R j:b>C||~$?LL$" E RWW%%b)* JJL Lr0c\rSrSrSrg) TestExternali3rIN)rCrDrErFrHrIr0r"rr3sr0rc&\rSrSrSrSrSrSrg)Testi8cSn[U5nUR5 URURS5 URURS5 UR[ UR 5S5 URUR Vs/sHo3RSPM sn/SQ5 URUR5Vs/sHo3SPM sn/SQ5 URUR5Vs/sHo3SPM sn/SQ5 URUR5Vs/sHn[U5PM sn/SQ5 gs snfs snfs snfs snf)Nzs! slendro5_2.scl ! A slendro type pentatonic which is based on intervals of 7, no. 2 5 ! 7/6 4/3 3/2 7/4 2/1 zslendro5_2.scl.9f) 266.870905604 498.044999135z 701.955000865z 968.8259064691200.000000000)r 231.174093531z 203.910001731rr)%%z$rr) rKrA assertEqualrPrNrlrQr+rarhrrry)r,rzrrs r"testScalaScaleATest.testScalaScaleA:sI s^   * &67 R^^,a0 BNNCNqWWSM*NC= > b.C.C.EF.EsG*.EF= > b.A.A.CD.CsG*.CD< = "*@*@*BC*BQ#a&*BCC DDGEDsE E E$:E)cSn[U5nUR5 URURS5 URURS5 URUR S5 URUR 5Vs/sHo3SPM sn/SQ5 URUR5Vs/sHo3SPM sn/SQ5 URUR5Vs/sHn[U5PM sn/SQ5 [5nURUR55 URUR 5Vs/sHo3SPM sn/SQ5 gs snfs snfs snfs snf) Nz! fj-12tet.scl ! Franck Jedrzejewski continued fractions approx. of 12-tet 12 ! 89/84 55/49 44/37 63/50 4/3 99/70 442/295 27/17 37/22 98/55 15/8 2/1 z fj-12tet.sclz9Franck Jedrzejewski continued fractions approx. of 12-tetr) 100.099209825z 199.979843291z 299.973903610z 400.108480470rz 600.088323762z 699.997698171z 800.909593096z 900.026096390z1000.020156709z1088.268714730r) rz 99.880633466 99.994060319z 100.134576860z 97.936518664z 102.043324627z 99.909374409z 100.911894925z 99.116503294rz 88.248558022z 111.731285270) $$rrz$z$rz$z$rz%z%) rKrArrPrNrOrarhrrryrn)r,rzrrss2s r"testScalaScaleBTest.testScalaScaleB_sp$s^   + n5 T V b.C.C.EF.EsG*.EF IZ [ b.A.A.CD.CsG*.CD GX Y "*@*@*BC*BQ#a&*BC C D k R0023 c.D.D.FG.FsG*.FG / 0[GED&Hs E4 E97E> FcDSn[5nURU5nURURS5 URUR 5SSUSS5 URUR 5Vs/sHn[ U5PM sn/SQ5 gs snf)Nz! arist_chromenh.scl ! Aristoxenos' Chromatic/Enharmonic, 3 + 9 + 18 parts 7 ! 50.00000 200.00000 500.00000 700.00000 750.00000 900.00000 2/1 rV)%%zrrr)r~rrrPr{rrry)r,rzrrrs r"testScalaFileATest.testScalaFileAs [ ZZ_ * ))+BQ/Ra9 "*@*@*BC*BQ#a&*BC< =Cs=BrIN)rCrDrErFrrrrHrIr0r"rr8s"DJT0l=r0rz list[type] _DOC_ORDER__main__) rG __future__rrr=rrtypingtunittestmusic21rrrmusic21.scale.scalar Environment environLocalr __annotations__r#r%rKr~rArTestCaserrrrCmainTestrIr0r"rs># $&&}5 6@4F 1F)Z77xIIZF-F-VGT J 8$$ [=8  [=@ J z Tr0