PitchClassSet | SuperCollider 3.13.0 Help

Description

This is a Pitch Class Set implementation. Quarter tones are supported for the name system used in LilyPond and the musician-friendly naming convention. The sixteenth tones are supported for its own style \ez.

Twelve-tone Support

Standard notation	Syntactic sugar	Result in the Post window
PitchClassSet.lily(1) PitchClassSet.lily(1.0) PitchClassSet.lily[1] PitchClassSet.lily[1.0]	No syntactic sugar	-> [ cs, df, bx ]
PitchClassSet.mus(1) PitchClassSet.mus(1.0) PitchClassSet.mus[1] PitchClassSet.mus[1.0]	No syntactic sugar	-> [ c♯, d♭, b𝄪 ]
PitchClassSet.ez(1) PitchClassSet.ez(1.0) PitchClassSet.ez[1] PitchClassSet.ez[1.0]	No syntactic sugar	-> [ cs, df, bS ]
PitchClassSet.getName(11.0) PitchClassSet.getName(11) PitchClassSet.getName(\e)	11.0.pitchClassName 11.pitchClassName \e.pitchClassName	-> [ b, ax, cf, b♮, a𝄪, c♭, bn, b, aS, cf ]
PitchClassSet.getValue(\e) PitchClassSet.getValue(\ff)	\e.pitchClassNum \ff.pitchClassNum	-> 4

Microtonal Support

Decimals are not rounded. LilyPond style names and musician-friendly names are only supported up to quarter notes. See the Example Section of this help document:

Quarter tones

Standard notation	Syntactic sugar	Result in the Post window
PitchClassSet.getValue(\btqs) PitchClassSet.getValue(\bQ)	\cqs.pitchClassNum \cq.pitchClassNum	-> 0.5
PitchClassSet.getName(10.5) PitchClassSet.getName('t.5') PitchClassSet.getName(\t5)	10.5.pitchClassName 't.5'.pitchClassName \t5.pitchClassName	-> [ bqf, atqs, ctqf, cffqs, b ¼↓ , a♯ ¼↑ , b♭ ¼↑ , c♭ ¼↓ , c𝄫 ¼↑ , bu, aQ, cU, cFq ]

Sixteenth tones

Standard notation	Syntactic sugar	Result in the Post window
PitchClassSet.getName(0.125)	0.125.pitchClassName	-> [ c1_16 ]
PitchClassSet.getName(0.25)	0.25.pitchClassName	-> [ c1_8 ]
PitchClassSet.getName(0.375)	0.375.pitchClassName	-> [ c3_16 ]
PitchClassSet.getName(0.625)	0.625.pitchClassName	-> [ c5_16 ]
PitchClassSet.getName(0.75)	0.75.pitchClassName	-> [ c3_8 ]
PitchClassSet.getName(0.875)	0.875.pitchClassName	-> [ c7_16 ]

Full list of pitch class names with all styles

Pitch class integer notation with numerical alternative (floats: microtonal)	Pitch class name per style
0 0.0	`\lily` - `[ c, bs, dff ]` `\mus` - `[ c♮, b♯, d𝄫 ]` `\ez` - `[ cn, c, bs, dF ]`
0.125	`\ez` - `[ c1_16 ]`
0.25	`\ez` - `[ c1_8 ]`
0.375	`\ez` - `[ c3_16 ]`
0.5	`\lily` - `[ cqs, btqs, dtqf, dffqs, bxqf ]` `\mus` - `[ c ¼↑ , c♯ ¼↓ , b♯ ¼↑ , d♭ ¼↓ , d𝄫 ¼↑ , b𝄪 ¼↓ ]` `\ez` - `[ cq, bQ, dU, dFq, bSu ]`
0.625	`\ez` - `[ c5_16 ]`
0.75	`\ez` - `[ c3_8 ]`
0.875	`\ez` - `[ c7_16 ]`
1 1.0	`\lily` - `[ cs, df, bx ]` `\mus` - `[ c♯, d♭, b𝄪 ]` `\ez` - `[ cs, df, bS ]`
1.125	`\ez` - `[ c9_16 ]`
1.25	`\ez` - `[ c5_8 ]`
1.375	`\ez` - `[ dm5_16 ]`
1.5	`\lily` - `[ dqf, ctqs, bxqs, cxqf, effqf ]` `\mus` - `[ d ¼↓ , d♭ ¼↑ , c♯ ¼↑ , b𝄪 ¼↑ , c𝄪 ¼↓ , e𝄫 ¼↓ ]` `\ez` - `[ du, cQ, bSq, cSu, eFu ]`
1.625	`\ez` - `[ dm3_16 ]`
1.75	`\ez` - `[ dm1_8 ]`
1.875	`\ez` - `[ dm1_16 ]`
2 2.0	`\lily` - `[ d, cx, eff ]` `\mus` - `[ d♮, c𝄪, e𝄫 ]` `\ez` - `[ dn, d, cS, eF ]`
2.125	`\ez` - `[ d1_16 ]`
2.25	`\ez` - `[ d1_8 ]`
2.375	`\ez` - `[ d3_16 ]`
2.5	`\lily` - `[ dqs, etqf, fffqf, cxqs, effqs ]` `\mus` - `[ d ¼↑ , d♯ ¼↓ , e♭ ¼↓ , f𝄫 ¼↓ , c𝄪 ¼↑ , e𝄫 ¼↑ ]` `\ez` - `[ dq, eU, fFu, cSq, eFq ]`
2.625	`\ez` - `[ d5_16 ]`
2.75	`\ez` - `[ d3_8 ]`
2.875	`\ez` - `[ d7_16 ]`
3 3.0	`\lily` - `[ ds, ef, fff ]` `\mus` - `[ d♯, e♭, f𝄫 ]` `\ez` - `[ ds, ef, fF ]`
3.125	`\ez` - `[ d9_16 ]`
3.25	`\ez` - `[ d5_8 ]`
3.375	`\ez` - `[ em5_16 ]`
3.5	`\lily` - `[ eqf, dtqs, ftqf, fffqs ]` `\mus` - `[ e♮ ¼↓ , e♭ ¼↑ , d♯ ¼↑ , f♭ ¼↓ , f𝄫 ¼↑ ]` `\ez` - `[ eu, dQ, fU, fFq ]`
3.625	`\ez` - `[ em3_16 ]`
3.75	`\ez` - `[ em1_8 ]`
3.875	`\ez` - `[ em1_16 ]`
4 4.0	`\lily` - `[ e, ff, dx ]` `\mus` - `[ e♮, f♭, d𝄪 ]` `\ez` - `[ en, e, ff, dS ]`
4.125	`\ez` - `[ e1_16 ]`
4.25	`\ez` - `[ e1_8 ]`
4.375	`\ez` - `[ e3_16 ]`
4.5	`\lily` - `[ eqs, fqf, dxqs, gffqf ]` `\mus` - `[ e ¼↑ , f ¼↓ , f♭ ¼↑ , e♯ ¼↓ , d𝄪 ¼↑ , g𝄫 ¼↓ ]` `\ez` - `[ eq, fu, dSq, gFu ]`
4.625	`\ez` - `[ fm3_16 ]`
4.75	`\ez` - `[ fm1_8 ]`
4.875	`\ez` - `[ fm1_16 ]`
5 5.0	`\lily` - `[ f, es, gff ]` `\mus` - `[ f♮, e♯, g𝄫 ]` `\ez` - `[ fn, f, es, gF ]`
5.125	`\ez` - `[ f1_16 ]`
5.25	`\ez` - `[ f1_8 ]`
5.375	`\ez` - `[ f3_16 ]`
5.5	`\lily` - `[ fqs, etqs, gtqf, gffqs, exqf ]` `\mus` - `[ f ¼↑ , e♯ ¼↑ , f♯ ¼↓ , g♭ ¼↓ , g𝄫 ¼↑ , e𝄪 ¼↓ ]` `\ez` - `[ fq, eQ, gU, gFq, eSu ]`
5.625	`\ez` - `[ f5_16 ]`
5.75	`\ez` - `[ f3_8 ]`
5.875	`\ez` - `[ f7_16 ]`
6 6.0	`\lily` - `[ fs, gf, ex ]` `\mus` - `[ f♯, g♭, e𝄪 ]` `\ez` - `[ fs, gf, eS ]`
6.125	`\ez` - `[ f9_16 ]`
6.25	`\ez` - `[ f5_8 ]`
6.375	`\ez` - `[ gu, fQ, eSq, fSu, aFu ]`
6.5	`\lily` - `[ gqf, ftqs, exqs, fxqf, affqf ]` `\mus` - `[ g ¼↓ , f♯ ¼↑ , g♭ ¼↑ , e𝄪 ¼↑ , f𝄪 ¼↓ , a𝄫 ¼↓ ]` `\ez` - `[ gu, fQ, eSq, fSu, aFu ]`
6.625	`\ez` - `[ gm3_16 ]`
6.75	`\ez` - `[ gm1_8 ]`
6.875	`\ez` - `[ gm1_16 ]`
7 7.0	`\lily` - `[ g, fx, aff ]` `\mus` - `[ g♮, f𝄪, a𝄫 ]` `\ez` - `[ gn, g, fS, aF ]`
7.125	`\ez` - `[ g1_16 ]`
7.25	`\ez` - `[ g1_8 ]`
7.375	`\ez` - `[ g3_16 ]`
7.5	`\lily` - `[ gqs, atqf, fxqs, affqs ]` `\mus` - `[ g ¼↑ , a♭ ¼↓ , g♯ ¼↓ , f𝄪 ¼↑ , a𝄫 ¼↑ ]` `\ez` - `[ gq, aU, fSq, aFq ]`
7.625	`\ez` - `[ g5_16 ]`
7.75	`\ez` - `[ g3_8 ]`
7.875	`\ez` - `[ g7_16 ]`
8 8.0	`\lily` - `[ gs, af ]` `\mus` - `[ g♯, a♭ ]` `\ez` - `[ gs, af ]`
8.125	`\ez` - `[ g9_16 ]`
8.25	`\ez` - `[ g5_8 ]`
8.375	`\ez` - `[ am5_16 ]`
8.5	`\lily` - `[ aqf, gtqs, gxqf, bffqf ]` `\mus` - `[ a ¼↓ , g♯ ¼↑ , a♭ ¼↑ , g𝄪 ¼↓ , b𝄫 ¼↓ ]` `\ez` - `[ au, gQ, gSu, bFu ]`
8.625	`\ez` - `[ am3_16 ]`
8.75	`\ez` - `[ am1_8 ]`
8.875	`\ez` - `[ am1_16 ]`
9 9.0	`\lily` - `[ a, gx, bff ]` `\mus` - `[ a♮, g𝄪, b𝄫 ]` `\ez` - `[ an, a, gS, bF ]`
9.125	`\ez` - `[ a1_16 ]`
9.25	`\ez` - `[ a1_8 ]`
9.375	`\ez` - `[ a3_16 ]`
9.5	`\lily` - `[ aqs, btqf, gxqs, bffqs, cffqf ]` `\mus` - `[ a ¼↑ , b♭ ¼↓ , a♯ ¼↓ , g𝄪 ¼↑ , b𝄫 ¼↑ , c𝄫 ¼↓ ]` `\ez` - `[ aq, bU, gSq, bFq, cFu ]`
9.625	`\ez` - `[ a5_16 ]`
9.75	`\ez` - `[ a3_8 ]`
9.875	`\ez` - `[ a7_16 ]`
10 10.0 \t	`\lily` - `[ as, bf, cff ]` `\mus` - `[ a♯, b♭, c𝄫 ]` `\ez` - `[ as, bf, cF ]`
10.125	`\ez` - `[ a9_16 ]`
10.25	`\ez` - `[ a5_8 ]`
10.375	`\ez` - `[ bm5_16 ]`
10.5 \t5 't.5'	`\lily` - `[ bqf, atqs, ctqf, cffqs ]` `\mus` - `[ b ¼↓ , a♯ ¼↑ , b♭ ¼↑ , c♭ ¼↓ , c𝄫 ¼↑ ]` `\ez` - `[ bu, aQ, cU, cFq ]`
10.625	`\ez` - `[ bm3_16 ]`
10.75	`\ez` - `[ bm1_8 ]`
10.875	`\ez` - `[ bm1_16 ]`
11 11.0 \e	`\lily` - `[ b, ax, cf ]` `\mus` - `[ b♮, a𝄪, c♭ ]` `\ez` - `[ bn, b, aS, cf ]`
11.125	`\ez` - `[ b1_16 ]`
11.25	`\ez` - `[ b1_8 ]`
11.375	`\ez` - `[ b3_16 ]`
11.5 \e5 'e.5'	`\lily` - `[ bqs, cqf, axqs, dffqf ]` `\mus` - `[ b ¼↑ , c ¼↓ , c♭ ¼↑ , b♯ ¼↓ , a𝄪 ¼↑ , d𝄫 ¼↓ ]` `\ez` - `[ bq, cu, aSq, dFu ]`
11.625	`\ez` - `[ cm3_16 ]`
11.75	`\ez` - `[ cm1_8 ]`
11.875	`\ez` - `[ cm1_16 ]`

Class Methods

PitchClassSet.ez(pitchClassNum)

returns

pitch class set in a simpler naming convention than LilyPond style as events if pitchClassNum is omitted.
pitch class name of the given pitch class number if pichClssNum is specified.

PitchClassSet.lily(pitchClassNum)

returns

LilyPond pitch naming style pitch class set as events if pitchClassNum is omitted.
pitch class name of the given pitch class number if pichClssNum is specified.

PitchClassSet.getName(which: 0)

returns the pitch class name and its enharmonically-respelled ones as an array from the given pitch class number.

Arguments:

which

Pitch class number from 0 to 11.5. \t can be used for 10; \e for 11; \t5 and 't.5' for 10.5; \e5 and 'e.5' for 11.5.

PitchClassSet.getValue(which: 'c')

returns the pitch class number from the given pitch class number.

Arguments:

which

Pitch class name in any style listed in the Full list of pitch class names with all styles

PitchClassSet.mus(pitchClassNum)

returns

musician-friendly naming style pitch class set as events if pitchClassNum is omitted.
pitch class name of the given pitch class number if pichClssNum is specified.