Xenharmonic Wiki

Template:MOS degrees/doc: Difference between revisions

← Older editNewer edit →
VisualWikitext
Ganaram inukshuk (talk | contribs)
autopatrolled, emailconfirmed
4,810 edits
Mos-ordinals support dropped; Degree Notation param deprecated
Ganaram inukshuk (talk | contribs)
autopatrolled, emailconfirmed
4,810 edits
Updated documentation to reflect new features
Line 9: Line 9:
| <pre>Step Ratio</pre> || No (optional) || The step ratio of the mos, denoted as a fraction p/q and separated with a slash. If left blank, then the step ratio "2/1" is used by default.
| <pre>Step Ratio</pre> || No (optional) || The step ratio of the mos, denoted as a fraction p/q and separated with a slash. If left blank, then the step ratio "2/1" is used by default.
|-
|-
| <pre>UDP</pre> || No (optional) || The UDP representing the mode for which notation is applied. Due to technical limitations, using the pipe symbol is not advised and the "," character (comma) should be used instead.
| <pre>Show Abbreviations</pre> || No (optional) || Whether to show degree abbreviations. Abbreviations are shown without a mos prefix, and are intended to be an aid with entering JI ratios. Enter "1" to show abbreviations.
|-
|-
| <pre>Notation</pre> || No (optional) || The notation for note names, consisting of the naturals (written without separators), sharp symbol, and flat symbol, each separated by semicolons. For example, standard notation is entered as "CDEFGAB; #; b". If left blank, the default is diamond-MOS notation (JKLMNOP for naturals, & for the sharp symbol, and @ for the flat symbol), or if the scale signature is 5L 2s, the default is standard notation.
| <pre>Number of Alterations</pre> || No (optional) || Whether to show alterations to a mos's specific interval sizes. One alteration shows the large size with +1 chroma and the small size with -1 chroma, or for periods (including the unison and equave), the perfect size with +1 and -1 chroma.
|-
|-
| <pre>Genchain Extend</pre> || No (optional) || Additional intervals corresponding to the number of additional generators going up and/or down after those represented by the UDP. This value is per period, and the default value is the number of large steps per period.
| <pre>JI Ratios</pre> || No (optional) || Whether to include JI ratios for certain entries. For assistance with entering ratios, see below.
|-
|-
| <pre>Degree Notation</pre> || Deprecated || How should degrees be named? Options include TAMNAMS mosdegree naming and ordinal naming (EG, the unison is either called the 0-mosstep or 1st).
| <pre>UDP</pre> || No (optional) || The UDP representing the mode for which notation is applied; this is to be used in conjunction with notation. Due to technical limitations, using the pipe symbol is not advised and the "," character (comma) should be used instead.
|-
| <pre>Notation</pre> || No (optional) || The notation for note names, consisting of the naturals (written without separators), sharp symbol, and flat symbol, each separated by semicolons. For example, standard notation is entered as "CDEFGAB; #; b". Notation will not be displayed unless entered.
|-
|-
| <pre>MOS Prefix</pre> || No (optional) || If using TAMNAMS mosdegree naming, does the mos have a prefix?
| <pre>MOS Prefix</pre> || No (optional) || If using TAMNAMS mosdegree naming, does the mos have a prefix?
|-
| <pre>Genchain Extend</pre> || Deprecated || Additional intervals corresponding to the number of additional generators going up and/or down after those represented by the UDP. This value is per period, and the default value is the number of large steps per period.
|-
| <pre>Degree Notation</pre> || Deprecated || How should degrees be named? Options include TAMNAMS mosdegree naming and ordinal naming (EG, the unison is either called the 0-mosstep or 1st).
|}
|}


Line 30: Line 36:
A scale signature different from the page's title can be entered as shown.
A scale signature different from the page's title can be entered as shown.


<pre>{{MOS degrees|Scale Signature=5L 2s}}</pre>
<pre>{{MOS degrees
{{MOS degrees|Scale Signature=5L 2s}}
|Scale Signature=5L 2s}}</pre>
{{MOS degrees
|Scale Signature=5L 2s}}
=== Using a different step ratio ===
=== Using a different step ratio ===


By default, cent and step values will be calculated for a step ratio of 2:1. A different step ratio can be entered as shown below. Up to 5 step ratios can be entered, written as p/q and with each ratio separated by semicolons.
By default, cent and step values will be calculated for a step ratio of 2:1. A different step ratio can be entered as shown below. Up to 5 step ratios can be entered, written as p/q and with each ratio separated by semicolons.


<pre>{{MOS degrees|Scale Signature=5L 2s|Step Ratio=2/1; 3/1; 3/2}}</pre>
<pre>{{MOS degrees
{{MOS degrees|Scale Signature=5L 2s|Step Ratio=2/1; 3/1; 3/2}}
|Scale Signature=5L 2s
=== Using different notation and UDP ===
|Step Ratio=2/1; 3/1; 3/2}}</pre>
{{MOS degrees
|Scale Signature=5L 2s
|Step Ratio=2/1; 3/1; 3/2}}
=== Changing the mos prefix ===
A mos-prefix, if defined under TAMNAMS, is automatically added. For mosses outside of TAMNAMS that have a prefix, enter it as shown below.
<pre>{{MOS degrees
|Scale Signature=2L 5s
|MOS Prefix=pel}}</pre>
{{MOS degrees
|Scale Signature=2L 5s
|MOS Prefix=pel}}
Typing in "NONE" for the prefix will not show any prefixes.
<pre>{{MOS degrees
|Scale Signature=4L 3s
|MOS Prefix=NONE}}</pre>
{{MOS degrees
|Scale Signature=4L 3s
|MOS Prefix=NONE}}
 
=== Using notation and UDP ===


By default, diamond-mos notation is used, or if the scale signature is 5L 2s, standard notation is used. Different notation can be entered as shown below, with semicolons separating the note names, sharp symbol, and flat symbol.
By default, no notation is displayed unless entered as shown in the example below.
<pre>{{MOS degrees|Scale Signature=7L 2s|Notation=123456789; #; b}}</pre>
<pre>{{MOS degrees
{{MOS degrees|Scale Signature=7L 2s|Notation=123456789; #; b}}
|Scale Signature=7L 2s
|Notation=123456789; #; b
}}</pre>
{{MOS degrees
|Scale Signature=7L 2s
|Notation=123456789; #; b
}}
By default, the mode for which nominals are applied is the symmetric mode, corresponding to a UDP of n<nowiki>|</nowiki>n. In the case of a mos with an even number of modes and therefore two "middle" modes (n+1<nowiki>|</nowiki>n and n<nowiki>|</nowiki>n+1), the brighter of the two is used as the default instead. Since some notation schemes may use a different mode as its "default", the UDP can be changed, as shown below. (Use a comma instead of the pipe <nowiki>|</nowiki> symbol.)
By default, the mode for which nominals are applied is the symmetric mode, corresponding to a UDP of n<nowiki>|</nowiki>n. In the case of a mos with an even number of modes and therefore two "middle" modes (n+1<nowiki>|</nowiki>n and n<nowiki>|</nowiki>n+1), the brighter of the two is used as the default instead. Since some notation schemes may use a different mode as its "default", the UDP can be changed, as shown below. (Use a comma instead of the pipe <nowiki>|</nowiki> symbol.)
<pre>{{MOS degrees|Scale Signature=7L 2s|Notation=123456789; #; b|UDP=7,1}}</pre>
<pre>{{MOS degrees
{{MOS degrees|Scale Signature=7L 2s|Notation=123456789; #; b|UDP=7,1}}
|Scale Signature=7L 2s
Typing in "NONE" for notation omits the column for note names. This allows the table to be used to list out interval sizes.
|Notation=123456789; #; b
<pre>{{MOS degrees|Scale Signature=7L 5s|Notation=NONE|}}</pre>
|UDP=7,1}}</pre>
{{MOS degrees|Scale Signature=7L 5s|Notation=NONE|}}
{{MOS degrees
|Scale Signature=7L 2s
|Notation=123456789; #; b|UDP=7,1}}
 
The template will attempt to use default notation with a default UDP if the keyword "Default" is entered. The default is standard notation on C (for 5L 2s) and diamond-mos for any nondiatonic mosses.
<pre>{{MOS degrees
|Scale Signature=4L 3s
|Notation=Default
}}
</pre>
{{MOS degrees
|Scale Signature=4L 3s
|Notation=Default
}}


== Advanced usage ==
== Advanced usage ==
=== Changing the genchain lengths ===
=== Adding JI ratios ===
The values in the table are calculated using a generator chain, or specifically by stacking its bright generator up from the root and down from the note one period up (usually down from the octave). The UDP described previously represents the lengths of the ascending and descending chains to reach all of the nominals, and extending further reaches pitches modified by accidentals.
JI ratios can be added by writing a semicolon-delimited list of entries, where each entry is an abbreviation for a scale degree, followed by a colon, followed by the JI ratio.


The default extend value is the number of large steps ''per period''. This means for multi-period mosses, there is an ascending and descending chain for each period.
To help with entering ratios, set the parameter "Show Abbreviations" to 1 to show scale degrees.


As an example using 5L 2s, a value of 5 effectively shows the two possible note names for all of the black keys on a standard piano.
<pre>{{MOS degrees
<pre>{{MOS degrees|Scale Signature=5L 2s|Genchain Extend=5}}</pre>
|Scale Signature=4L 3s
{{MOS degrees|Scale Signature=5L 2s|Genchain Extend=5}}
|Show Abbreviations=1
Changing this value to 0 means only the naturals are shown.
|JI Ratios=
<pre>{{MOS degrees|Scale Signature=5L 2s|Genchain Extend=0}}</pre>
M1md: 8/7;
{{MOS degrees|Scale Signature=5L 2s|Genchain Extend=0}}
P2md: 77/64, 6/5;
To show only the minor intervals, consider that the UDP here is 5<nowiki>|</nowiki>1, meaning that the ascending chain starts with 5 generators and the descending chain starts with 1 generator. Going up one more generator produces the augmented 4th, so it's not necessary to extend the ascending chain. Going down 4 more generators produces all of the minor intervals and one more after that produces the diminished 5th, so the descending chain should be extended further by 4.
m3md: 14/11;
M3md:11/8;
m4md: 16/11;
M4md: 11/7;
P5md: 5/3;
m6md: 7/4;
}}
</pre>
{{MOS degrees
|Scale Signature=4L 3s
|Show Abbreviations=1
|JI Ratios=
M1md: 8/7;
P2md: 77/64, 6/5;
m3md: 14/11;
M3md:11/8;
m4md: 16/11;
M4md: 11/7;
P5md: 5/3;
m6md: 7/4;
}}


This template supports entering separate values for the ascending and descending extend values; the first value is for the ascending chain, and the second for the descending chain, as shown below.
=== Showing alterations ===
<pre>{{MOS degrees|Scale Signature=5L 2s|Genchain Extend=0,4}}</pre>
Alterations refer to raising scale degrees by a chroma beyond the large and small sizes of a mos. For the number of alterations added, an additional altered degree is shown from raising the large size of a scale degree and lowering the small size of a scale degree (or the perfect size for period, unison, and equaves).
{{MOS degrees|Scale Signature=5L 2s|Genchain Extend=0,4}}
<pre>{{MOS degrees
=== Changing the mos prefix ===
|Scale Signature=4L 3s
It may be beneficial to change the prefix in cases where more than one nondiatonic mos is being discussed. The default is "mos", but this can be changed as shown below, using the previous section's example. (Do not add a hyphen to the end of the prefix, as the template will do that automatically.)
|Number of Alterations=2
<pre>{{MOS degrees|Scale Signature=2L 5s|UDP=1,5|Notation=CDEFGAB;#;b|MOS Prefix=pel}}</pre>
}}
{{MOS degrees|Scale Signature=2L 5s|UDP=1,5|Notation=CDEFGAB;#;b|MOS Prefix=pel}}
</pre>
Typing in "NONE" for the prefix will not show any prefixes, for both ordinal names and TAMNAMS-named scale degrees.
{{MOS degrees
<pre>{{MOS degrees|Scale Signature=4L 3s|MOS Prefix=NONE}}</pre>
|Scale Signature=4L 3s
{{MOS degrees|Scale Signature=4L 3s|MOS Prefix=NONE}}
|Number of Alterations=2
}}
Retrieved from "https://en.xen.wiki/w/Template:MOS_degrees/doc"