Key Signature

Key Signature

A key_signature object specifies a music key signature.

Data Item Type Required/ Optional Description
tonic text optional The tonic of the scale. If omitted, the Composer selects the tonic automatically. See below for valid values
quality text optional The scale quality. If omitted, the Composer selects the quality automatically. See below for valid values

Note: A particular descriptor typically supports only a subset of quality types. If a quality is provided which the descriptor for the active region does not support, it will be changed.

Values for tonic are a text representation of a musical note consisting of a letter and accidental.

Valid values for letter are:

Valid values for accidental are:

Examples:

Musical Note tonic Value
C cis
D𝄫 deses
E e
B fes

Valid values for quality are:

For reference, the Composer generally classifies the available qualities into two groups:

Majorish Minorish
major natural_minor
ionian aeolian
mixolydian dorian
lydian phrygian

Note: major is equivalent to ionian, and natural_minor is equivalent to aeolian.

Example:

{
    "tonic": "bes",
    "quality": "major"
}