Template:MOS gamut/doc

From Xenharmonic Wiki
Jump to navigation Jump to search

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.
Bright Gens Up No (optional) The number of bright generators going up needed to produce the mode for which notation is applied. In UDP notation, this corresponds to the value u in the UDP of u|d, or up (u times p) in the UDP of up|dp for multi-period mosses. If left blank, then the brightest mode is used by default.
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.

{{MOS gamut|Scale Signature = 4L 3s|Bright Gens Up = 3|Step Ratio = 3/1}}

J, K@, J&, K, L, M@, L&, M, N, O@, N&, O, P, J@, P&, J

{{MOS gamut|Scale Signature = 4L 3s|Bright Gens Up = 3|Step Ratio = 3/2}}

J, J&, K@, K, K&/L@, L, L&, M@, M, M&/N@, N, N&, O@, O, O&/P@, P, P&, J@, J

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|Bright Gens Up = 7|Note Symbols = 123456789|Sharp Symbol = #|Flat Symbol = b}}

J, J&/K@, K, K&/L@, L, M, M&/N@, N, N&/O@, O, O&/P@, P, Q, Q&/R@, R, R&/J@, J

{{MOS gamut|Scale Signature = 4L 5s (3/1-equivalent)|Bright Gens Up = 5|Note Symbols = CDEFGHJAB|Sharp Symbol = #|Flat Symbol = b}}

J, K, K&/L@, L, M, M&/N@, N, O, O&/P@, P, Q, Q&/R@, R, J

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

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

The design of the template itself is not finalized and is open to suggestions.