o o’×i}Fã @sdZddlZddlZddlmZddlmZddlm Z gd¢Z e gd¢gd ¢gd ¢gd ¢gd ¢gd ¢gd¢gd¢gd¢gd¢d Z dd„e gd¢dƒDƒZdd„Zdd„Ze edddddœdd „ƒƒZd!d"„Zd#d$„Ze edddd%œd&d'„ƒƒZd(d)„ZdS)*zMusic notation utilitieséNé)Úcache)ÚParameterError)Údeprecate_positional_args)Úkey_to_degreesÚ key_to_notesÚmela_to_degreesÚ mela_to_svaraÚthaat_to_degreesÚ list_melaÚ list_thaat©rréééé é )rrrrrré )rrérrrr©rrrrrér)rérrrrr)rrrérrr)rrrrrrr)rrrrrrr)rrrrrrr)rrrrrrr) ÚbilavalÚkhamajÚkafiÚasavariÚbhairaviÚkalyanÚmarvaÚpoorviÚtodiÚbhairavcCsi|]\}}||“qS©r#)Ú.0ÚiÚkr#r#úS/home/ubuntu/SoloSpeech/.venv/lib/python3.10/site-packages/librosa/core/notation.pyÚ #sÿÿr()HÚ kanakangiÚratnangiÚ ganamurthiÚ vanaspathiÚ manavathiÚtanarupiÚ senavathiÚ hanumathodiÚdhenukaÚ natakapriyaÚ kokilapriyaÚ rupavathiÚ gayakapriyaÚvakulabharanamÚmayamalavagaulaÚ chakravakomÚ suryakanthamÚ hatakambariÚjhankaradhwaniÚ natabhairaviÚ keeravaniÚkharaharapriyaÚ gaurimanohariÚ varunapriyaÚ mararanjiniÚ charukesiÚ sarasangiÚ harikambhojiÚdheerasankarabharanamÚ naganandiniÚ yagapriyaÚ ragavardhiniÚgangeyabhushaniÚ vagadheeswariÚsuliniÚ chalanattaÚsalagamÚ jalarnavamÚ jhalavaraliÚ navaneethamÚpavaniÚ raghupriyaÚ gavambodhiÚ bhavapriyaÚsubhapanthuvaraliÚshadvidhamarginiÚ suvarnangiÚ divyamaniÚ dhavalambariÚ namanarayaniÚ kamavardhiniÚ ramapriyaÚ gamanasramaÚ viswambhariÚ syamalangiÚshanmukhapriyaÚsimhendramadhyamamÚ hemavathiÚ dharmavathiÚ neethimathiÚ kanthamaniÚ rishabhapriyaÚlatangiÚ vachaspathiÚ mechakalyaniÚ chitrambariÚ sucharitraÚjyotisvarupiniÚ dhatuvardhiniÚnasikabhushaniÚkosalamÚ rasikapriyarcCst t| ¡¡S)a5Construct the svara indices (degrees) for a given thaat Parameters ---------- thaat : str The name of the thaat Returns ------- indices : np.ndarray A list of the seven svara indices (starting from 0=Sa) contained in the specified thaat See Also -------- key_to_degrees mela_to_degrees list_thaat Examples -------- >>> librosa.thaat_to_degrees('bilaval') array([ 0, 2, 4, 5, 7, 9, 11]) >>> librosa.thaat_to_degrees('todi') array([ 0, 1, 3, 6, 7, 8, 11]) )ÚnpÚasarrayÚ THAAT_MAPÚlower)Úthaatr#r#r'r usr cCsðt|tƒrt| ¡d}nd|krdkrnn|d}ntd |¡ƒ‚dg}|d}d|kr7dkrAnn| ddg¡nWd|krKdkrUnn| dd g¡nCd|kr_d krinn| dd g¡n/d |krsd kr}nn| dd g¡nd |kr‡d kr‘nn| dd g¡n| d d g¡|dkr¢| d¡n| d¡| d¡|d}|dkr¼| ddg¡n7|dkrÈ| ddg¡n+|dkrÔ| ddg¡n|d krà| ddg¡n|d krì| ddg¡n| ddg¡t  |¡S)a¡Construct the svara indices (degrees) for a given melakarta raga Parameters ---------- mela : str or int Either the name or integer index ([1, 2, ..., 72]) of the melakarta raga Returns ------- degrees : np.ndarray A list of the seven svara indices (starting from 0=Sa) contained in the specified raga See Also -------- thaat_to_degrees key_to_degrees list_mela Examples -------- Melakarta #1 (kanakangi): >>> librosa.mela_to_degrees(1) array([0, 1, 2, 5, 7, 8, 9]) Or using a name directly: >>> librosa.mela_to_degrees('kanakangi') array([0, 1, 2, 5, 7, 8, 9]) rréHú mela={} must be in range [1, 72]é$rré réréérrrrrr) Ú isinstanceÚstrÚ MELAKARTA_MAPrtrÚformatÚextendÚappendrqÚarray)ÚmelaÚindexÚdegreesrtÚupperr#r#r'r”sF !     rr)ÚlevelT)ÚabbrÚunicodecCsøgd¢}t|tƒrt| ¡d}nd|krdkr#nn|d}ntd |¡ƒ‚|d}|dkr7d|d <nd |d <|d krDd |d <nd|d <|d}|dkrUd|d<nd|d<|dkrbd|d<nd|d<|rodd„|Dƒ}|sxdd„|Dƒ}t|ƒS)uLSpell the Carnatic svara names for a given melakarta raga This function exists to resolve enharmonic equivalences between pitch classes: - Ri2 / Ga1 - Ri3 / Ga2 - Dha2 / Ni1 - Dha3 / Ni2 For svara outside the raga, names are chosen to preserve orderings so that all Ri precede all Ga, and all Dha precede all Ni. Parameters ---------- mela : str or int the name or numerical index of the melakarta raga abbr : bool If `True`, use single-letter svara names: S, R, G, ... If `False`, use full names: Sa, Ri, Ga, ... unicode : bool If `True`, use unicode symbols for numberings, e.g., Riâ‚ If `False`, use low-order ASCII, e.g., Ri1. Returns ------- svara : list of strings The svara names for each of the 12 pitch classes. See Also -------- key_to_notes mela_to_degrees list_mela Examples -------- Melakarta #1 (Kanakangi) uses R1, G1, D1, N1 >>> librosa.mela_to_svara(1) ['S', 'Râ‚', 'Gâ‚', 'Gâ‚‚', 'G₃', 'Mâ‚', 'Mâ‚‚', 'P', 'Dâ‚', 'Nâ‚', 'Nâ‚‚', 'N₃'] #19 (Jhankaradhwani) uses R2 and G2 so the third svara are Ri: >>> librosa.mela_to_svara(19) ['S', 'Râ‚', 'Râ‚‚', 'Gâ‚‚', 'G₃', 'Mâ‚', 'Mâ‚‚', 'P', 'Dâ‚', 'Nâ‚', 'Nâ‚‚', 'N₃'] #31 (Yagapriya) uses R3 and G3, so third and fourth svara are Ri: >>> librosa.mela_to_svara(31) ['S', 'Râ‚', 'Râ‚‚', 'R₃', 'G₃', 'Mâ‚', 'Mâ‚‚', 'P', 'Dâ‚', 'Nâ‚', 'Nâ‚‚', 'N₃'] #34 (Vagadheeswari) uses D2 and N2, so Ni1 becomes Dha2: >>> librosa.mela_to_svara(34) ['S', 'Râ‚', 'Râ‚‚', 'R₃', 'G₃', 'Mâ‚', 'Mâ‚‚', 'P', 'Dâ‚', 'Dâ‚‚', 'Nâ‚‚', 'N₃'] #36 (Chalanatta) uses D3 and N3, so Ni2 becomes Dha3: >>> librosa.mela_to_svara(36) ['S', 'Râ‚', 'Râ‚‚', 'R₃', 'G₃', 'Mâ‚', 'Mâ‚‚', 'P', 'Dâ‚', 'Dâ‚‚', 'D₃', 'N₃'] # You can also query by raga name instead of index: >>> librosa.mela_to_svara('chalanatta') ['S', 'Râ‚', 'Râ‚‚', 'R₃', 'G₃', 'Mâ‚', 'Mâ‚‚', 'P', 'Dâ‚', 'Dâ‚‚', 'D₃', 'N₃'] ) ÚSauRiâ‚NNuGa₃uMaâ‚uMaâ‚‚ÚPauDhaâ‚NNuNi₃rrrvrwrxruGaâ‚ruRiâ‚‚r|uGaâ‚‚ruRi₃uNiâ‚ruDhaâ‚‚ruDha₃ruNiâ‚‚c Ss$g|]}| t ddddœ¡¡‘qS)Ú)ÚaÚhr%©Ú translater~Ú maketrans©r$Úsr#r#r'Ú sÿz!mela_to_svara..c Ss$g|]}| t ddddœ¡¡‘qS)Ú1Ú2Ú3)uâ‚uâ‚‚u₃rr“r#r#r'r•„sÿÿ)r}r~rrtrr€Úlist)r„r‰rŠÚ svara_mapÚmela_idxrtr‡r#r#r'r ÷s:M      ÿþr cCst ¡S)aUList melakarta ragas by name and index. Melakarta raga names are transcribed from [#]_, with the exception of #45 (subhapanthuvarali). .. [#] Bhagyalekshmy, S. (1990). Ragas in Carnatic music. South Asia Books. Returns ------- mela_map : dict A dictionary mapping melakarta raga names to indices (1, 2, ..., 72) Examples -------- >>> librosa.list_mela() {'kanakangi': 1, 'ratnangi': 2, 'ganamurthi': 3, 'vanaspathi': 4, ...} See Also -------- mela_to_degrees mela_to_svara list_thaat )rÚcopyr#r#r#r'r Œsr cCs tt ¡ƒS)a}List supported thaats by name. Returns ------- thaats : list A list of supported thaats Examples -------- >>> librosa.list_thaat() ['bilaval', 'khamaj', 'kafi', 'asavari', 'bhairavi', 'kalyan', 'marva', 'poorvi', 'todi', 'bhairav'] See Also -------- list_mela thaat_to_degrees )r™rsÚkeysr#r#r#r'r ­s r )rŠcsÖt d|¡}|std |¡ƒ‚ddddddd d œ}d dd d d d d œ}| d¡ ¡}| d¡}||}| d¡dd… ¡}|dk} | rN|||dd} n |||ddd} |dkrad} n|dkrhd} nd| krrdkrwnnd} n| dkr}d} gd¢} gd¢} gd¢}gd¢}| }| dkr™|dkr™d}| r´td|dd ƒD] }||\}}|| |<q¤| }nd| d}td|dd ƒD] }||\}}|| |<qÃ| }|sét  dddd d!œ¡‰t ‡fd"d#„|Dƒƒ}|S)$u± Lists all 12 note names in the chromatic scale, as spelled according to a given key (major or minor). This function exists to resolve enharmonic equivalences between different spellings for the same pitch (e.g. C♯ vs Dâ™­), and is primarily useful when producing human-readable outputs (e.g. plotting) for pitch content. Note names are decided by the following rules: 1. If the tonic of the key has an accidental (sharp or flat), that accidental will be used consistently for all notes. 2. If the tonic does not have an accidental, accidentals will be inferred to minimize the total number used for diatonic scale degrees. 3. If there is a tie (e.g., in the case of C:maj vs A:min), sharps will be preferred. Parameters ---------- key : string Must be in the form TONIC:key. Tonic must be upper case (``CDEFGAB``), key must be lower-case (``maj`` or ``min``). Single accidentals (``b!â™­`` for flat, or ``#♯`` for sharp) are supported. Examples: ``C:maj, Db:min, Aâ™­:min``. unicode : bool If ``True`` (default), use Unicode symbols (♯ð„ªâ™­ð„«)for accidentals. If ``False``, Unicode symbols will be mapped to low-order ASCII representations:: ♯ -> #, ð„ª -> ##, â™­ -> b, ð„« -> bb Returns ------- notes : list ``notes[k]`` is the name for semitone ``k`` (starting from C) under the given key. All chromatic notes (0 through 11) are included. See Also -------- midi_to_note Examples -------- `C:maj` will use all sharps >>> librosa.key_to_notes('C:maj') ['C', 'C♯', 'D', 'D♯', 'E', 'F', 'F♯', 'G', 'G♯', 'A', 'A♯', 'B'] `A:min` has the same notes >>> librosa.key_to_notes('A:min') ['C', 'C♯', 'D', 'D♯', 'E', 'F', 'F♯', 'G', 'G♯', 'A', 'A♯', 'B'] `A♯:min` will use sharps, but spell note 0 (`C`) as `B♯` >>> librosa.key_to_notes('A#:min') ['B♯', 'C♯', 'D', 'D♯', 'E', 'E♯', 'F♯', 'G', 'G♯', 'A', 'A♯', 'B'] `G♯:maj` will use a double-sharp to spell note 7 (`G`) as `Fð„ª`: >>> librosa.key_to_notes('G#:maj') ['B♯', 'C♯', 'D', 'D♯', 'E', 'E♯', 'F♯', 'Fð„ª', 'G♯', 'A', 'A♯', 'B'] `Fâ™­:min` will use double-flats >>> librosa.key_to_notes('Fb:min') ['Dð„«', 'Dâ™­', 'Eð„«', 'Eâ™­', 'Fâ™­', 'F', 'Gâ™­', 'Að„«', 'Aâ™­', 'Bð„«', 'Bâ™­', 'Câ™­'] õK^(?P[A-Ga-g])(?P[#♯b!â™­]?):(?P(maj|min)(or)?)$úImproper key format: {:s}rrrrrrr©ÚCÚDÚEÚFÚGÚAÚBréÿÿÿÿ©ú#rÚbú!õ♯õâ™­ÚtonicÚ accidentalÚscaleNrÚmajryFTr) r¡uC♯r¢uD♯r£r¤uF♯r¥uG♯r¦uA♯r§) r¡uDâ™­r¢uEâ™­r£r¤uGâ™­r¥uAâ™­r¦uBâ™­r§))ruE♯)ruB♯)ruFð„ª)ruCð„ª)ruGð„ª)ruDð„ª)ruAð„ª))ruCâ™­)ruFâ™­)ruBð„«)ruEð„«)ruAð„«)ruDð„«r§rªz##r«Úbb)r­uð„ªr®uð„«c3s|]}| ˆ¡VqdS)N)r‘)r$Ún©Ú translationsr#r'Ú zs€zkey_to_notes..) ÚreÚmatchrr€Úgroupr‡rtÚranger~r’r™)ÚkeyrŠr¹Ú pitch_mapÚacc_mapr¯r°Úoffsetr±ÚmajorÚ tonic_numberÚ use_sharpsÚ notes_sharpÚ notes_flatÚsharp_correctionsÚflat_correctionsÚn_sharpsr´r…ÚnameÚnotesÚn_flatsr#rµr'rËsZMü         rc Cs²tt gd¢¡t gd¢¡d}t d|¡}|std |¡ƒ‚dddd d d d d œ}dddddddœ}| d¡ ¡}| d¡}||}| d¡dd…  ¡}|||||dS)u†Construct the diatonic scale degrees for a given key. Parameters ---------- key : str Must be in the form TONIC:key. Tonic must be upper case (``CDEFGAB``), key must be lower-case (``maj`` or ``min``). Single accidentals (``b!â™­`` for flat, or ``#♯`` for sharp) are supported. Examples: ``C:maj, Db:min, Aâ™­:min``. Returns ------- degrees : np.ndarray An array containing the semitone numbers (0=C, 1=C#, ... 11=B) for each of the seven scale degrees in the given key, starting from the tonic. See Also -------- key_to_notes Examples -------- >>> librosa.key_to_degrees('C:maj') array([ 0, 2, 4, 5, 7, 9, 11]) >>> librosa.key_to_degrees('C#:maj') array([ 1, 3, 5, 6, 8, 10, 0]) >>> librosa.key_to_degrees('A:min') array([ 9, 11, 0, 2, 4, 5, 7]) r r)r²ÚminržrŸrrrrrrrr rr¨r©r¯r°r±Nrry) Údictrqrƒr¸r¹rr€rºr‡rt) r¼rÉr¹r½r¾r¯r°r¿r±r#r#r'rs $ÿü r)Ú__doc__r¸ÚnumpyrqÚ_cacherÚutil.exceptionsrÚutil.decoratorsrÚ__all__rÌrsÚ enumeraterr rr r r rrr#r#r#r'ÚsL    öJµþRc! 3