Public interface for importing file formats into music21.
Given a file path, encoded data in a Python string, or a URL, attempt to parse the item into a Stream. Note: URL downloading will not happen automatically unless the user has set their Environment “autoDownload” preference to “allow”.
>>> s = parse(["E4 r f# g=lastG trip{b-8 a g} c", "3/4"])
>>> s = parse("E8 f# g#' G f g# g G#", "2/4")
A class used for converting all supported data formats into music21 objects. Not a subclass, but a wrapper for different converter objects based on format.
Converter properties
- stream¶
- No documentation.
Converter methods
- parseData(dataStr)¶
- Given raw data, determine format and parse into a music21 Stream.
- parseFile(fp, forceSource=False)¶
- Given a file path, parse and store a music21 Stream.
- parseURL(url)¶
- Given a url, download and parse the file into a music21 Stream. Note that this check the user Environment autoDownlaad setting before downloading.
ConverterMusicXML properties
- stream¶
- No documentation.
ConverterMusicXML methods
- getPartNames()¶
- No documentation.
- load()¶
- Load all parts from a MusicXML object representation. This determines the order parts are found in the stream
- parseData(xmlString)¶
- Open MusicXML data from a string.
- parseFile(fp)¶
- Open from file path; check to see if there is a pickled version available and up to date; if so, open that, otherwise open source.
Simple class wrapper for parsing Humdrum data provided in a file or in a string.
ConverterHumdrum attributes
Attributes without Documentation: stream
ConverterHumdrum methods
- parseData(humdrumString)¶
Open Humdrum data from a string
>>> humdata = '**kern\n*M2/4\n=1\n24r\n24g#\n24f#\n24e\n24c#\n24f\n24r\n24dn\n24e-\n24gn\n24e-\n24dn\n*-' >>> c = ConverterHumdrum() >>> s = c.parseData(humdata)
- parseFile(filepath)¶
- Open Humdram data from a file path.
Simple class wrapper for parsing TinyNotation data provided in a file or in a string.
ConverterTinyNotation attributes
Attributes without Documentation: stream
ConverterTinyNotation methods
- parseData(tnData)¶
Open TinyNotation data from a string or list
>>> tnData = ["E4 r f# g=lastG trip{b-8 a g} c", "3/4"] >>> c = ConverterTinyNotation() >>> s = c.parseData(tnData)
- parseFile(fp)¶
- Open TinyNotation data from a file path.
Before opening a file path, this class can check if there is an up to date version pickled and stored in the scratch directory. If the user has not specified a scratch directory, a pickle path will not be created.
Provide a file path to check if there is pickled version. If forceSource is True, pickled files, if available, will not be returned.
PickleFilter methods
- status()¶
- Given a file path specified with __init__, look for an up to date pickled version of this file path. If it exists, return its fp, other wise return the original file path. Return arguments are file path to load, boolean whether to write a pickle, and the file path of the pickle.