Template:MOS gamut/doc: Difference between revisions

From Xenharmonic Wiki
Jump to navigation Jump to search
← Older editNewer edit →
VisualWikitext
Ganaram inukshuk (talk | contribs)
autopatrolled, emailconfirmed
4,810 edits
Ganaram inukshuk (talk | contribs)
autopatrolled, emailconfirmed
4,810 edits
No edit summary
Line 11: Line 11:
| 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<nowiki>|</nowiki>dp for multi-period mosses. If left blank, then the brightest mode 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<nowiki>|</nowiki>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, 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.
|-
|-
| 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.
| 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.
Line 20: Line 20:
== Usage ==
== Usage ==


The typical use of this template is for describing a mos's gamut, the set of named notes, with accidentals.
The typical use of this template is for describing a mos's gamut, the set of named notes.


<pre>{{MOS gamut}}</pre>
<pre>{{MOS gamut}}</pre>


A scale signature different from the page's title can be specified as shown below.
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.


<pre>{{MOS gamut|Scale Signature = 4L 3s}}</pre>
<pre>{{MOS gamut|Scale Signature = 4L 3s}}</pre>
{{MOS gamut|Scale Signature = 4L 3s}}
{{MOS gamut|Scale Signature = 4L 3s}}


This produces a gamut with a step ratio of 2:1 for the brightest mode. Since it's common to use different step ratios and to apply notation to a different mode, an example of overriding the mode and step ratio is shown below.
=== Using a different step ratio and mode ===
 
An example of using a different step ratio and mode are shown below.


<pre>{{MOS gamut|Scale Signature = 4L 3s|Bright Gens Up = 3|Step Ratio = 3/1}}</pre>
<pre>{{MOS gamut|Scale Signature = 4L 3s|Bright Gens Up = 3|Step Ratio = 3/1}}</pre>
Line 49: Line 51:
== Limitations ==
== Limitations ==


Equivalent pitch classes, such as enharmonic equivalents, 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.
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 notation|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).
Accidentals smaller than a chroma, such as [[ups and downs notation|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).
Line 56: Line 58:
{{MOS gamut|Scale Signature = 5L 2s|Step Ratio = 5/3}}
{{MOS gamut|Scale Signature = 5L 2s|Step Ratio = 5/3}}


If a step ratio is entered without being simplified, the edo (or ed{{angbr|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, notation for the additional notes, which may be notated using ups and downs, are currently not added to keep the output simplified.
If a step ratio is entered without being simplified, the edo (or ed{{angbr|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.


<pre>{{MOS gamut|Scale Signature = 5L 2s|Step Ratio = 4/2}}</pre>
<pre>{{MOS gamut|Scale Signature = 5L 2s|Step Ratio = 4/2}}</pre>

Revision as of 17:55, 12 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.
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.

Retrieved from "https://en.xen.wiki/index.php?title=Template:MOS_gamut/doc&oldid=116477"