User’s Guide, Chapter 15: Keys and KeySignatures

(to be written)

from music21 import *

A Key object is derived from a KeySignature object and also a Scale object.

k = key.Key('E-')
k.classes
 ('Key',
  'KeySignature',
  'DiatonicScale',
  'ConcreteScale',
  'Scale',
  'Music21Object',
  'object')

Key Context and Note Spelling

Key and KeySignature objects affect how notes are spelled in some situations. Let’s set up a simple situation of a F-natural whole note in D major and then B-flat minor.

s = stream.Stream()
s.append(key.Key('D'))
s.append(note.Note('F', type='whole'))
s.append(key.Key('b-', 'minor'))
s.append(note.Note('F', type='whole'))
s2 = s.makeMeasures()
s2.show()
../_images/usersGuide_15_key_6_0.png

When we transpose each note up a half step (n.transpose(1)), music21 understands that the first F-natural should become F-sharp, while the second one will fit better as a G-flat.

for n in s2.recurse().notes:
    n.transpose(1, inPlace=True)
s2.show()
../_images/usersGuide_15_key_8_0.png

Example: Prepare a vocal exercise in all major keys, ascending by step.

requires v3 or higher

Let’s create a simple exercise in playing or singing thirds. I think I remember this from the First Division Band Method “Blue Book”:

pitchStream = converter.parse("tinyNotation: 4/4 c8 e d f e g f a g e f d c e c4")
pitchStream.show()
../_images/usersGuide_15_key_10_0.png

This melody does not have a key associated with it. Let’s put a Key of C Major at the beginning of the piece:

k = key.Key('C')
pitchStream.measure(1).insert(0, k)

Note that putting the key of C into the Stream doesn’t change what it looks like when we show the Stream, since there are no sharps or flats. But what makes the difference between an instrumental and a vocal exercise is the act of transposition. When we transpose the Key object up 1 semitone, to D-flat major, it will show up:

k.transpose(1, inPlace=True)
pitchStream.show()
../_images/usersGuide_15_key_14_0.png

Now the key signature is D-flat, but the notes are still in C-major, so we should transpose them also:

for n in pitchStream.recurse().notes:
    n.transpose(1, inPlace=True)

pitchStream.show()
../_images/usersGuide_15_key_16_0.png

Notice that we choose a semitone transposition and not a diatonic transposition such as minor second ("m2"); minor second would work just as good in this case, but then to do another half-step up, we would need to remember to transpose by an augmented unison ("A1") so that D-flat became D-natural and not E-double-flat. The semitone transposition is smart enough to make sure that the Key object remains between six-flats and six-sharps. Not only that, but the notes will match the best spelling for the current key signature.

k.transpose(1, inPlace=True)
for n in pitchStream.recurse().notes:
    n.transpose(1, inPlace=True)
pitchStream.show()
../_images/usersGuide_15_key_18_0.png
k.transpose(1, inPlace=True)
for n in pitchStream.recurse().notes:
    n.transpose(1, inPlace=True)
pitchStream.show()
../_images/usersGuide_15_key_19_0.png

So, we can make a nice, ascending vocal exercise by varying the transposition amount from 0 to 7 (or however high you can sing) and putting each of the two-measure excerpts together into one Part.

out = stream.Part()
for i in range(0, 8):
    pitchStream = converter.parse("tinyNotation: 4/4 c8 e d f e g f a g e f d c e c4")
    k = key.Key('C')
    pitchStream.measure(1).insert(0, k)
    k.transpose(i, inPlace=True)
    for n in pitchStream.recurse().notes:
        n.transpose(i, inPlace=True)
    for m in pitchStream:
        out.append(m)
out.show()
../_images/usersGuide_15_key_21_0.png

And we can listen to it as well:

out.show('midi')