Template:MOS gamut/doc: Difference between revisions

From Xenharmonic Wiki
Jump to navigation Jump to search
Ganaram inukshuk (talk | contribs)
No edit summary
Ganaram inukshuk (talk | contribs)
No edit summary
Line 9: Line 9:
| 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.
| 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.
| UDP || 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 should be used instead.
|-
|-
| 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.
| 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.
Line 31: Line 31:
=== Using a different step ratio and mode ===
=== 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 <pre>{{!}}</pre>.
An example of using a different step ratio and mode are shown below. To prevent any issues with the visual editor or source editing, use the character "," in place of the pipe symbol.


<pre>{{MOS gamut|Scale Signature = 4L 3s|UDP=3{{!}}3|Step Ratio = 3/1}}</pre>
<pre>{{MOS gamut|Scale Signature = 4L 3s|UDP = 3,3|Step Ratio = 3/1}}</pre>
{{MOS gamut|Scale Signature = 4L 3s|UDP=3{{!}}3|Step Ratio = 3/1}}
{{MOS gamut|Scale Signature = 4L 3s|UDP = 3,3|Step Ratio = 3/1}}


<pre>{{MOS gamut|Scale Signature = 4L 3s|UDP=3{{!}}3|Step Ratio = 3/2}}</pre>
<pre>{{MOS gamut|Scale Signature = 4L 3s|UDP = 3,3|Step Ratio = 3/2}}</pre>
{{MOS gamut|Scale Signature = 4L 3s|UDP=3{{!}}3|Step Ratio = 3/2}}
{{MOS gamut|Scale Signature = 4L 3s|UDP = 3,3|Step Ratio = 3/2}}


=== Using different notation ===
=== Using different notation ===
Line 43: Line 43:
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).
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).


<pre>{{MOS gamut|Scale Signature = 7L 2s|UDP=7{{!}}1|Note Symbols = 123456789|Sharp Symbol = #|Flat Symbol = b}}</pre>
<pre>{{MOS gamut|Scale Signature = 7L 2s|UDP= 7,1|Note Symbols = 123456789|Sharp Symbol = #|Flat Symbol = b}}</pre>
{{MOS gamut|Scale Signature = 7L 2s|UDP=7{{!}}1|Note Symbols = 123456789|Sharp Symbol = #|Flat Symbol = b}}
{{MOS gamut|Scale Signature = 7L 2s|UDP = 7,1|Note Symbols = 123456789|Sharp Symbol = #|Flat Symbol = b}}


<pre>{{MOS gamut|Scale Signature = 4L 5s (3/1-equivalent)|UDP=5{{!}}3|Note Symbols = CDEFGHJAB|Sharp Symbol = #|Flat Symbol = b}}</pre>
<pre>{{MOS gamut|Scale Signature = 4L 5s (3/1-equivalent)|UDP = 5,3|Note Symbols = CDEFGHJAB|Sharp Symbol = #|Flat Symbol = b}}</pre>
{{MOS gamut|Scale Signature = 4L 5s (3/1-equivalent)|UDP=5{{!}}3|Note Symbols = CDEFGHJAB|Sharp Symbol = #|Flat Symbol = b}}
{{MOS gamut|Scale Signature = 4L 5s (3/1-equivalent)|UDP = 5,3|Note Symbols = CDEFGHJAB|Sharp Symbol = #|Flat Symbol = b}}


== Limitations ==
== Limitations ==

Revision as of 04:54, 17 June 2023

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. Due to technical limitations, using the pipe symbol is not advised and the "-" character should be used instead.
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. To prevent any issues with the visual editor or source editing, use the character "," in place of the pipe symbol.

{{MOS gamut|Scale Signature = 4L 3s|UDP = 3,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|UDP = 3,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|UDP= 7,1|Note Symbols = 123456789|Sharp Symbol = #|Flat Symbol = b}}

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

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

J, J&/K@, K, 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

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