|
|
Python: module abcsound
Convert (enhanced) abc notation to a Csound score.
Classes |
| | |
- AbcException
- CsoundScoreAnalyzer
- Element
-
- AbcDefaultDurationElement
- AbcElement
-
- AbcBowDirection
- AbcChord
- AbcDecoration
- AbcLineEnd
- AbcMeasureBar
- AbcNlet
- AbcNote
- AbcRepeat
- AbcRepeatEnd
- AbcRest
- AbcSlurEnd
- AbcSlurStart
- AbcTie
- AbcMetaElement
- AbcMeterElement
- AbcTempoElement
- CsoundElement
- InstrumentElement
- VoiceData
- VoicesElement
class AbcElement(Element) |
| |
A musical element of an abc score. May be a note, measure, repeat
marker, or almost anything else. Most elements have a start time
and a duration, although even this is not necessarily universal.
Subclasses of AbcElement implement processing specific to each
kind of score element. Note that elements parsed from the score
are NOT represented recursively, but rather as simple linear
lists. This is because, contrary to what a casual inspection might
suggest, abc is a line-oriented language with non-recursive
structure. A tie or repeat, for example, my begin or end in the
middle of a measure, which breaks the obvious representation of a
score containing lines containing measures containing notes. Also
the fact that multiple voices are written as successive parallel
lines causes practical problems with recursive structure.
|
| |
Static methods defined here:
- read(txt, pos)
- Read this element from txt at the given position.
Return the next position to look at.
Methods inherited from Element:
- __init__(self, **args)
- analyze(self, score)
- analyzeTime(self, time)
- csoundPrint(self, score)
|
class AbcNote(AbcElement) |
| |
Represents a note at a particular time, duration, frequency.
|
| |
- Method resolution order:
- AbcNote
- AbcElement
- Element
Methods defined here:
- __str__(self)
- analyze(self, score)
- csoundPrint(self, score)
- determinePitch(self, score)
- implementSlur(self)
- parseNote(self)
- Convert a textual note into a note element.
- prevNote(self)
- readNote(self, txt, pos)
- Read the note at txt.pos, returning the new position.
Static methods defined here:
- read(txt, pos)
Methods inherited from Element:
- __init__(self, **args)
- analyzeTime(self, time)
|
class CsoundScoreAnalyzer |
| |
Analyze score data and generate a Csound score.
|
| |
Methods defined here:
- __init__(self)
- analyzeItem(self, item)
- analyzeScore(self, lines)
- analyzeTimes(self)
- assignPartLine(self, line)
- buildRepeat(self, rpt, endings)
- buildTimeline(self, lines)
- clone(self, elLst)
- establishVoices(self, voiceEl)
- expandRepeats(self, voiceLine)
- getInstrument(self, name)
- isRepeat(self, item)
- linkNoteElements(self, line)
- nVoices(self)
- newInstrument(self, name, instrEl)
- setDefaultLen(self, dlen)
- setMeter(self, n, kind)
- setTempo(self, tempo)
- timeLineAsString(self)
- voiceDataPresent(self)
- writeCsdScore(self, csdLines)
- writeScore(self, csdLines)
|
class Element |
| |
An element of the composition. May represent musical notation,
metadata, Csound directives, or just about anything else. Subclasses
implement parsing and analysis logic.
|
| |
Methods defined here:
- __init__(self, **args)
- analyze(self, score)
- analyzeTime(self, time)
- csoundPrint(self, score)
Static methods defined here:
- read(txt, pos)
|
class InstrumentElement(Element) |
| |
Represents an "instr" directive. This maps an abcsound voice
to a Csound instrument defintion. An instr directive must
appear alone on a single line.
The instrument named "Oboe" corresponds to Csound instrument 104,
except that initial slurred notes are rendered with instrument 105,
and successive slurred notes are rendered with instrument 106.
Csound field p4 should be set to the amplitude and p5 to the pitch;
fields p6 and p7 should be set to 13.2 and 99, respectively:
instr Oboe csound=104 initslur=105 slur=106 p4=amp p5=pitch p6=13.2 p7=99
|
| |
Methods defined here:
- __str__(self)
- analyze(self, score)
- buildIstmt(self, noteEl)
- Build the score i-statement for a particular note.
Static methods defined here:
- read(txt, pos)
Methods inherited from Element:
- __init__(self, **args)
- analyzeTime(self, time)
- csoundPrint(self, score)
|
class VoicesElement(Element) |
| |
Represents a "voices" directive, telling us how many parallel
voices will be present in the score following, and which
instruments they use. There can be different parts directives
in effect at different parts of the score. A voices directive
must appear alone on a single line.
Three parallel voices are in effect, named "Oboe", "Flute", "Guitar":
voices Oboe Flute Guitar
|
| |
Methods defined here:
- __str__(self)
Static methods defined here:
- read(txt, pos)
Methods inherited from Element:
- __init__(self, **args)
- analyze(self, score)
- analyzeTime(self, time)
- csoundPrint(self, score)
| |
Functions |
| | |
- detail(chan, msg)
- Print a debug message if the given chan is in details.
- generateNoteMap()
- Buils a map of note names to frequency.
- getElement(txt, pos)
- Extract an element from txt at position pos. Return
a tuple (element,nextPos).
Strategy: ask each AbcElement subclass to read an instance of itself
at the given location. When one succeeds, return the created AbcElement.
- getElementsInString(txt)
- Parse a string into its constituent elements.
- getPitch(note)
- Return the pitch associated with a given note name.
- listToString(lst)
- mapcan(func, lst)
- parse(lines)
- Parse the score into allElements. analyzeScore() will then
build timing and instrument data.
- preprocessLine(line)
- Do an initial massage to get things the way we like.
|
Data |
| | |
BOW_DIRECTIONS = 'uv'
CHORD_MARK = '"'
CLOSE_TIE = ')'
DECORATOR_END = '}'
DECORATOR_START = '{'
DIGITS = '0123456789'
MEASURE_BAR = '|'
NLET_MARK = '('
NOTE_CONTENT = "ABCDEFGabcdefg_^.~0123456789',>/"
NOTE_INITIALS = 'ABCDEFGabcdefg_^.~'
NOTE_NAMES = 'ABCDEFGabcdefg'
NOTE_NAMES_HI = 'abcdefg'
NOTE_NAMES_LOW = 'ABCDEFG'
OCT_DOWN_MARK = ','
OCT_UP_MARK = "'"
OPEN_TIE_OR_NLET = '('
ORNAMENT_MARK = '~'
REPEAT_MARK = ':'
REST_CONTENT = '0123456789/>'
REST_MARK = 'z'
SINGLE_DECORATION = '~'
SLUR_END = ')'
SLUR_START = '('
TIE_MARK = '-'
allElementClasses = [<class abcsound.CsoundElement at 0x7fef55cc>, <class abcsound.VoicesElement at 0x7fef55fc>, <class abcsound.InstrumentElement at 0x7fef562c>, <class abcsound.AbcDefaultDurationElement at 0x7fef565c>, <class abcsound.AbcMeterElement at 0x7fef568c>, <class abcsound.AbcTempoElement at 0x7fef56bc>, <class abcsound.AbcMetaElement at 0x7fef56ec>, <class abcsound.AbcMeasureBar at 0x7fef571c>, <class abcsound.AbcLineEnd at 0x7fef574c>, <class abcsound.AbcRest at 0x7fef577c>, <class abcsound.AbcNote at 0x7fef57ac>, <class abcsound.AbcRepeatEnd at 0x7fef57dc>, <class abcsound.AbcRepeat at 0x7fef580c>, <class abcsound.AbcNlet at 0x7fef583c>, <class abcsound.AbcSlurStart at 0x7fef586c>, <class abcsound.AbcSlurEnd at 0x7fef589c>, <class abcsound.AbcTie at 0x7fef58cc>, <class abcsound.AbcDecoration at 0x7fef58fc>, <class abcsound.AbcChord at 0x7fef592c>, <class abcsound.AbcBowDirection at 0x7fef595c>]
allLines = []
details = ['analyze']
noteFreqs = {12: 256.0, 'a': 430.53896457590599, 'b': 483.2636480463882, 'bb': 456.14014364783441, 'c': 256.0, 'c#': 271.22255215360002, 'd': 287.35028436215737, 'd#': 304.43702143268371, 'e': 322.53978876176836, 'f': 341.71900265253851, ...}
semitoneMult = 1.0594630943500001
testLines = ['K:G', 'R:jig', 'instr Oboe csound=104 p4=amp p5=pitch p6=13.2 p7=99', 'voices Oboe', ':a~buc (dvef)::"Am"g (3 zdz {whoohoo!}b ^c\'/2._D2,(e\'\'/2|1z/2A-B-C-D)zC/2|2z/2A-B-D-D)z/2C:|', ':abc def:||:gab cde|[1defabc|[2abcdef:|', ':ABC DEF:||:GAB CDE|[1DEFABC|[2ABCDEF:|', ':a~buc (dvef)::"Am"g (3 zdz {whoohoo!}b ^c\'/2._D2,(e\'\'/2|1z/2A-B-C-D)zC/2|2z/2A-B-D-D)z/2C:|', ':abc def:||:gab cde|[1defabc|[2abcdef:|', ':ABC DEF:||:GAB CDE|[1DEFABC|[2ABCDEF:|'] |
|
Last changed:
09-07-09 01:21:46
|
