music-melodicdevice 0.2.3

Apply chromatic and diatonic transformations to music notes

Music Melodic-Device

Apply chromatic and diatonic transformations to music notes

DESCRIPTION

This class provides methods to do chromatic and diatonic transformations to music notes.

The three major categories are transpositions, inversions, and five types of ornamentation.

Accidental notes are returned as "sharps" by default. To get "flats" back, set the flat attribute to True. Also, please note that the music21 library uses the hyphen (-) to indicate the flat accidental, not 'b'. Sharp is a '#', though.

SYNOPSIS

from music_melodicdevice import Device

device = Device( # defaults:
    scale_note='C'
    scale_name='chromatic'
    notes=[] # notes set and used by devices
    flat=False # return notes with accidentals as flats instead of sharps
    pattern=[0,1,2], # the arpeggiation pattern (up)
    repeats=1, # how many times to repeat the arpeggiation pattern
    verbose=False
)

# default scale: chromatic
device = Device(notes=['C4', 'E4', 'D4', 'G4', 'C5'])
notes = device.transpose(2) # ['D4', 'F#4', 'E4', 'A4', 'D5']
notes = device.invert('C4') # ['C4', 'G#3', 'A#3', 'F3', 'C3']

# diatonic transformation:
device = Device(scale_name='major', verbose=True)
device.notes = ['C4', 'E4', 'D4', 'G4', 'C5']
notes = device.transpose(2) # ['E4', 'G4', 'F4', 'B4', 'E5']
notes = device.invert('C4') # ['C4', 'A3', 'B3', 'F3', 'C3']

# unknown note:
device = Device()
device.build_scale('major')
notes = device.transpose(2, ['C4', 'E4', 'D#4', 'G4', 'C5'])
# ['E4', 'G4', None, 'B4', 'E5']
notes = device.invert('C4', ['C4', 'E4', 'D#4', 'G4', 'C5'])
# ['C4', 'A3', None, 'F3', 'C3']

# accidental notes:
device = Device(scale_note='G', scale_name='major')
device.notes = ['C4', 'E4', 'D4', 'F#4', 'C5']
notes = device.transpose(2) # ['E4', 'G4', 'F#4', 'A4', 'E5'])
device = Device(scale_note='G', scale_name='major', flat=True)
device.notes = ['C4', 'E4', 'D4', 'F#4', 'C5']
notes = device.transpose(2) # ['E4', 'G4', 'G-4', 'A4', 'E5'])

# Ornamentation:

# chromatic
device = Device()

notes = device.grace_note(1, 'D5') # [[1/16, 'D5'], [1 - 1/16, 'D5']])
notes = device.grace_note(1, 'D5', offset=1) # [[1/16, 'D#5'], [1 - 1/16, 'D5']])
notes = device.grace_note(1, 'D5', offset=-1) # [[1/16, 'C#5'], [1 - 1/16, 'D5']])

notes = device.turn(1, 'D5') # [[1/4,'D#5'], [1/4,'D5'], [1/4,'C#5'], [1/4,'D5']])
notes = device.turn(1, 'D5', offset=-1) # [[1/4,'C#5'], [1/4,'D5'], [1/4,'D#5'], [1/4,'D5']])

notes = device.trill(1, 'D5', number=2, offset=1)
# [[1/4,'D5'], [1/4,'D#5'], [1/4,'D5'], [1/4,'D#5']])
notes = device.trill(1, 'D5', number=2, offset=-1)
# [[1/4,'D5'], [1/4,'C#5'], [1/4,'D5'], [1/4,'C#5']])

notes = device.mordent(1, 'D5', offset=1) # [[1/4,'D5'], [1/4,'D#5'], [1/2,'D5']])
notes = device.mordent(1, 'D5', offset=-1) # [[1/4,'D5'], [1/4,'C#5'], [1/2,'D5']])

notes = device.slide(1, 'D5', 'F5') # [[1/4,'D5'], [1/4,'D#5'], [1/4,'E5'], [1/4,'F5']])
notes = device.slide(1, 'D5', 'B4') # [[1/4,'D5'], [1/4,'C#5'], [1/4,'C5'], [1/4,'B4']])

# diatonic
device = Device(scale_name='major')

notes = device.grace_note(1, 'D5') # [[1/16, 'D5'], [1 - 1/16, 'D5']])
notes = device.grace_note(1, 'D5', offset=1) # [[1/16, 'E5'], [1 - 1/16, 'D5']])
notes = device.grace_note(1, 'D5', offset=-1) # [[1/16, 'C5'], [1 - 1/16, 'D5']])

notes = device.turn(1, 'D5', offset=1) # [[1/4,'E5'], [1/4,'D5'], [1/4,'C5'], [1/4,'D5']])
notes = device.turn(1, 'D5', offset=-1) # [[1/4,'C5'], [1/4,'D5'], [1/4,'E5'], [1/4,'D5']])

notes = device.trill(1, 'D5', number=2, offset=1) # [[1/4,'D5'], [1/4,'E5'], [1/4,'D5'], [1/4,'E5']])
notes = device.trill(1, 'D5', number=2, offset=-1) # [[1/4,'D5'], [1/4,'C5'], [1/4,'D5'], [1/4,'C5']])

notes = device.mordent(1, 'D5', offset=1) # [[1/4,'D5'], [1/4,'E5'], [1/2,'D5']])
notes = device.mordent(1, 'D5', offset=-1) # [[1/4,'D5'], [1/4,'C5'], [1/2,'D5']])

# arpeggiation
device = Device()
notes = device.arp(['C4','E4','G4']) # [ [1/3, 'C4'], [1/3, 'E4'], [1/3, 'G4'] ]
device.pattern = [2,1,0]
notes = device.arp(['C4','E4','G4']) # [ [1/3, 'G4'], [1/3, 'E4'], [1/3, 'C4'] ]

METHODS

transpose

notes = device.transpose(amount)

Transpose a note by an integer amount.

invert

notes = device.invert(axis_note, note_list)

Invert the note_list of named notes, around the named axis_note.

grace_note

notes = device.grace_note(duration, pitch, offset=offset)

Return a list with a 64th-note grace-note and the original named pitch with octave. The grace-note is offset semi-tone steps from the given pitch. The duration is the total, original length of the pitch.

turn

notes = device.turn(duration, pitch, offset=offset)

Return a list of four notes, having an up-down pattern, in place of the given pitch and duration.

trill

notes = device.trill(duration, pitch, number=number, offset=offset)

Return a list of pairs of notes, given the number, in place of the given pitch and duration.

The first of the pair is part of the original note, and the second is the note plus the given offset.

mordent

notes = device.mordent(duration, pitch, offset=offset)

Return a list of three notes in place of the given pitch and duration.

slide

notes = device.slide(duration, from_pitch, to_pitch)

Return a list of chromatic notes inclusively between the from_pitch and to_pitch, in place of the given duration.

arp

notes = device.arp() # use defaults
notes = device.arp(notes)
notes = device.arp(notes, duration=duration)
notes = device.arp(notes, arp_type=arp_type)
notes = device.arp(notes, repeats=repeats)

Return a list of the number of notes, selected by the arpeggiated pattern, and distributed across the duration.

arp_type

device.arp_type() # get all known types
device.arp_type(arp_type='up') # get the coderef of the 'up' type
# add a new type:
device.arp_type(arp_type='foo', coderef=lambda notes: [0,2,1,2])
# or use a notes list to be given in `arp`, as with 'random':
lambda notes: [ int(random.random() * len(notes)) for _ in notes ]

Return or set known arpeggiation types.

Note that the lambda for setting a new type requires a single argument, whether it is used or not.

MUSICAL EXAMPLES

from music21 import duration, note, stream
from music_melodicdevice import Device

device = Device(notes=['C4', 'E4', 'D4', 'G4'])
notes = device.invert('C5')

s = stream.Stream()
p = stream.Part()

for i in device.notes + notes:
    n = note.Note(i)
    n.duration = duration.Duration(1)
    p.append(n)

s.append(p)
s.show()

notes = ['C4', 'E4', 'D4', 'G4']

device = Device(scale_name='major')
device.notes = notes
device.notes = device.invert('C5')
device.notes = device.transpose(-5)

s = stream.Stream()
p = stream.Part()

for i,j in enumerate(notes + device.notes):
    if (i + 1) % 4 == 0:
        turn = device.turn(1, j)
        for t in turn:
            m = note.Note(t[1])
            m.duration = duration.Duration(t[0])
            p.append(m)
    else:
        n = note.Note(j)
        n.duration = duration.Duration(1)
        p.append(n)

s.append(p)
s.show()

SEE ALSO

https://en.wikipedia.org/wiki/Inversion_(music)#Melodies

https://en.wikipedia.org/wiki/Ornament_(music)