Xenharmonic Wiki

Template:MOS degrees/doc: Difference between revisions

← Older edit
VisualWikitext
Ganaram inukshuk (talk | contribs)
autopatrolled, emailconfirmed
4,810 edits
mNo edit summary
ArrowHead294 (talk | contribs)
14,512 edits
mNo edit summary
 
(12 intermediate revisions by 4 users not shown)
Line 1: Line 1:
== Parameters ==
{{dochead}}{{lua}}
 
=== Parameters ===
{| class="wikitable"
{| class="wikitable"
|-
|-
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>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>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>JI Ratios</pre> || No (optional) || Whether to include JI ratios for certain entries. For assistance with entering ratios, see below.
|-
|-
| <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>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>Degree Notation</pre> || No (optional) || 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>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).
|}
|}


== Usage ==
=== Usage ===
 
The typical use of this template is for showing a table of scale degrees for a specific step ratio.
The typical use of this template is for showing a table of scale degrees for a specific step ratio.


<pre>{{MOS degrees}}</pre>
<pre>{{MOS degrees}}</pre>


=== Using a different scale signature ===
==== Using a different scale signature ====
 
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|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>
 
=== 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>
 
Typing in "NONE" for the prefix will not show any prefixes.
<pre>{{MOS degrees
| Scale Signature=4L 3s
| MOS Prefix=NONE}}</pre>
 
==== Using notation and UDP ====
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>


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.
<pre>{{MOS degrees|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
== Advanced usage ==
| Notation=123456789; #; b
=== Changing the genchain lengths ===
| UDP=7,1}}</pre>
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.
 
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>


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.
=== Advanced usage ===
==== Adding JI ratios ====
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.


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.
To help with entering ratios, set the parameter "Show Abbreviations" to 1 to show scale degrees.
<pre>{{MOS degrees|Scale Signature=5L 2s|Genchain Extend=5}}</pre>
{{MOS degrees|Scale Signature=5L 2s|Genchain Extend=5}}
Changing this value to 0 means only the naturals are shown.
<pre>{{MOS degrees|Scale Signature=5L 2s|Genchain Extend=0}}</pre>
{{MOS degrees|Scale Signature=5L 2s|Genchain Extend=0}}
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.


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.
<pre>{{MOS degrees
<pre>{{MOS degrees|Scale Signature=5L 2s|Genchain Extend=0,4}}</pre>
| Scale Signature=4L 3s
{{MOS degrees|Scale Signature=5L 2s|Genchain Extend=0,4}}
| 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;
}}
</pre>


=== Changing the degree notation ===
==== Showing alterations ====
There are currently two ways of naming scale degrees supported by this template: using TAMNAMS numbering (which starts at 0 for the unison) and ordinal numbering (which starts at the 1st for the unison). The default is TAMNAMS degree notation, but this can be changed to ordinal notation as shown below.
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).
<pre>{{MOS degrees|Scale Signature=2L 5s|UDP=1,5|Notation=CDEFGAB;#;b|Degree Notation=ordinal}}</pre>
<pre>{{MOS degrees
{{MOS degrees|Scale Signature=2L 5s|UDP=1,5|Notation=CDEFGAB;#;b|Degree Notation=ordinal}}
| Scale Signature=4L 3s
=== Changing the mos prefix ===
| Number of Alterations=1
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.)
}}
<pre>{{MOS degrees|Scale Signature=2L 5s|UDP=1,5|Notation=CDEFGAB;#;b|Degree Notation=ordinal|MOS Prefix=pel}}</pre>
</pre>
{{MOS degrees|Scale Signature=2L 5s|UDP=1,5|Notation=CDEFGAB;#;b|Degree Notation=ordinal|MOS Prefix=pel}}
 
Typing in "NONE" for the prefix will not show any prefixes, for both ordinal names and TAMNAMS-named scale degrees.
=== Limitations ===
<pre>{{MOS degrees|Scale Signature=4L 3s|MOS Prefix=NONE}}</pre>
Setting the number of alterations to any value greater than 1 throws the following error:
{{MOS degrees|Scale Signature=4L 3s|MOS Prefix=NONE}}
<pre>Lua error: Internal error: The interpreter has terminated with signal "24".</pre>
Retrieved from "https://en.xen.wiki/w/Template:MOS_degrees/doc"