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.
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.

Accidentals smaller than a chroma, such as ups and downs or half-accidentals, are currently not supported. An example of such usage is 5L 2s in 31edo, where Dbb may be notated as ^C (up-C) or Ct (C half-sharp).

{{MOS gamut|Scale Signature = 5L 2s|Step Ratio = 5/3}}

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

If a step ratio is entered without being simplified, the edo (or ed⟨equave⟩) displayed will reflect that by being a larger division of the equave. An example of this is 5L 2s in 24edo, whose step ratio is 4/2. However, the notes in between are not shown to keep the output simplified.

{{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 step ratios, but collapsed step ratios are not formatted properly. This is an aesthetic issue.

{{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.