subsequence.roles

The API reference for roles.

roles

module subsequence.roles

Role parameter bundles — starting points you splat, not a role API.

The design deliberately ships no role nouns (no p.bass() verb): a "role" is just a small bundle of placement parameters a part usually wants, kept as plain data so you splat and override it. Each bundle holds keyword arguments shared by the placement surface — comp.phrase_part(...) and p.motif(...) / p.phrase(...) (root register anchor, velocity, and the chord-snapping fit dial):

import subsequence

comp.phrase_part(channel=2, part="bass", **subsequence.roles.BASS)
comp.phrase_part(channel=4, part="lead", **subsequence.roles.LEAD, root=78)   # override root

@comp.pattern(channel=3, bars=2)
def pad (p):
        p.motif(chords, **subsequence.roles.PAD)

These are taste defaults, not rules — a bass usually sits low and locks to chord tones (high fit), a pad sits mid and floats (lower fit). Change any value freely; the bundle is a dict.

Members: ARP, BASS, LEAD, PAD, ROLES

roles.BASS

roles.BASS: typing.Dict[str, typing.Any]

roles.PAD

roles.PAD: typing.Dict[str, typing.Any]

roles.LEAD

roles.LEAD: typing.Dict[str, typing.Any]

roles.ARP

roles.ARP: typing.Dict[str, typing.Any]

roles.ROLES

roles.ROLES: typing.Dict[str, typing.Dict[str, typing.Any]]