Template:MOS gamut/doc
Parameters
Parameters | Required? | Description |
---|---|---|
Scale Signature | Yes (optional on mos pages) | The mos's scale signature in the form "xL ys", or for non-octave mosses, "xL ys<p/q>", "xL ys⟨p/q⟩", or "xL ys (p/q-equivalent)". If left blank and used on a mos page, then the page's title will be used. |
Step Ratio | 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. |
UDP | No (optional) | The UDP representing the mode for which notation is applied. |
Note Symbols | No (optional) | A sequence of note symbols entered as a string, such as "CDEFGAB" and "JKLMNOP", the default for standard notation and diamond-MOS respectively, if left blank. |
Sharp Symbol | No (optional) | The symbol used to denote raising by a chroma, usually a sharp (#) or "am/amp" symbol (&), the default for standard notation and diamond-MOS respectively, if left blank. |
Flat Symbol | No (optional) | The symbol used to denote lowering by a chroma, usually a flat (b) or "at" symbol (@), the default for standard notation and diamond-MOS respectively, if left blank. |
Usage
The typical use of this template is for describing a mos's gamut, the set of named notes.
{{MOS gamut}}
A scale signature different from the page's title can be specified as shown below. This produces a gamut using the step ratio 2/1 and the brightest mode.
{{MOS gamut|Scale Signature = 4L 3s}}
J, J&/K@, K, L, L&/M@, M, N, N&/O@, O, P, P&/J@, J
Using a different step ratio and mode
An example of using a different step ratio and mode are shown below. Note: if editing source, enter the pipe character as
{{!}}
.
{{MOS gamut|Scale Signature = 4L 3s|UDP=3{{!}}3|Step Ratio = 3/1}}
Lua error in Module:MOS_gamut at line 193: attempt to index local 'udp' (a nil value).
{{MOS gamut|Scale Signature = 4L 3s|UDP=3{{!}}3|Step Ratio = 3/2}}
Lua error in Module:MOS_gamut at line 193: attempt to index local 'udp' (a nil value).
Using different notation
An example of this template's usage with different notation can be shown using Armodue notation (used for 7L 2s) and notation used for Lambda (3/1-equivalent 4L 5s).
{{MOS gamut|Scale Signature = 7L 2s|UDP=7{{!}}1|Note Symbols = 123456789|Sharp Symbol = #|Flat Symbol = b}}
Lua error in Module:MOS_gamut at line 193: attempt to index local 'udp' (a nil value).
{{MOS gamut|Scale Signature = 4L 5s (3/1-equivalent)|UDP=5{{!}}3|Note Symbols = CDEFGHJAB|Sharp Symbol = #|Flat Symbol = b}}
Lua error in Module:MOS_gamut at line 193: attempt to index local 'udp' (a nil value).
Limitations
Equivalent pitch classes are currently limited to pitches that fall at the exact midpoint of two other pitches, such as C# and Db being equivalent in standard notation, or C and B# being equivalent. This is to ensure note names have as few accidentals as possible.
Since the intended use of this template is to show a gamut based on a generator chain, notes altered by accidentals smaller than a chroma, such as half-accidentals and ups and downs, are not included. As such, if a step ratio is entered without being simplified, such as with 5L 2s in 24edo (step ratio of 4/2), the gamut produced will be for a simplified step ratio instead.
{{MOS gamut|Scale Signature = 5L 2s|Step Ratio = 4/2}}
J, J&/K@, K, L, L&/M@, M, M&/N@, N, N&/O@, O, P, P&/J@, J
Specific symbols for double-accidentals, such as "x" for double-sharps, are not supported.
This template can accept equalized and collapsed step ratios. Collapsed step ratios may not be displayed properly, but this is an aesthetic issue.
{{MOS gamut|Scale Signature = 5L 2s|Step Ratio = 1/1}}
J, K, L, M, N, O, P, J
{{MOS gamut|Scale Signature = 5L 2s|Step Ratio = 1/0}}
J, K/L, M, N, O/P, J