music21.converter.subConverters

Subconverters parse or display a single format.

Each subconverter should inherit from the base SubConverter object and have at least a parseData method that sets self.stream.

ConverterABC

class music21.converter.subConverters.ConverterABC(**keywords)

Simple class wrapper for parsing ABC.

Input only

ConverterABC bases

ConverterABC read/write properties

Read/write properties inherited from SubConverter:

ConverterABC methods

ConverterABC.parseData(strData, number=None)

Get ABC data, as token list, from a string representation. If more than one work is defined in the ABC data, a Opus object will be returned; otherwise, a Score is returned.

ConverterABC.parseFile(fp, number=None)

Get ABC data from a file path. If more than one work is defined in the ABC data, a Opus object will be returned; otherwise, a Score is returned.

If number is provided, and this ABC file defines multiple works with a X: tag, just the specified work will be returned.

Methods inherited from SubConverter:

ConverterBraille

class music21.converter.subConverters.ConverterBraille(**keywords)

ConverterBraille bases

ConverterBraille read/write properties

Read/write properties inherited from SubConverter:

ConverterBraille methods

ConverterBraille.write(obj, fmt, fp=None, subformats=None, **keywords)

Methods inherited from SubConverter:

ConverterCapella

class music21.converter.subConverters.ConverterCapella(**keywords)

Simple class wrapper for parsing Capella .capx XML files. See capella/fromCapellaXML.

ConverterCapella bases

ConverterCapella read/write properties

Read/write properties inherited from SubConverter:

ConverterCapella methods

ConverterCapella.parseData(strData, number=None)

parse a data stream of uncompessed capella xml

N.B. for web parsing, it gets more complex.

ConverterCapella.parseFile(fp, number=None)

Read a file

Methods inherited from SubConverter:

ConverterClercqTemperley

class music21.converter.subConverters.ConverterClercqTemperley(**keywords)

Simple class wrapper for parsing roman text harmonic definitions.

ConverterClercqTemperley bases

ConverterClercqTemperley read/write properties

Read/write properties inherited from SubConverter:

ConverterClercqTemperley methods

ConverterClercqTemperley.parseData(strData, number=None)
ConverterClercqTemperley.parseFile(fp, number=None)

Methods inherited from SubConverter:

ConverterHumdrum

class music21.converter.subConverters.ConverterHumdrum(**keywords)

Simple class wrapper for parsing Humdrum data provided in a file or in a string.

ConverterHumdrum bases

ConverterHumdrum read/write properties

Read/write properties inherited from SubConverter:

ConverterHumdrum methods

ConverterHumdrum.parseData(humdrumString, number=None)

Open Humdrum data from a string – calls humdrum.parseData()

>>> humdata = ('**kern\n*M2/4\n=1\n24r\n24g#\n24f#\n24e\n24c#\n' + 
...     '24f\n24r\n24dn\n24e-\n24gn\n24e-\n24dn\n*-')
>>> c = converter.subConverters.ConverterHumdrum()
>>> s = c.parseData(humdata)
>>> c.stream.show('text')
{0.0} <music21.stream.Part spine_0>
    {0.0} <music21.humdrum.spineParser.MiscTandem **kern humdrum control>
    {0.0} <music21.stream.Measure 1 offset=0.0>
        {0.0} <music21.meter.TimeSignature 2/4>
        {0.0} <music21.note.Rest rest>
        {0.1667} <music21.note.Note G#>
        {0.3333} <music21.note.Note F#>
        {0.5} <music21.note.Note E>
        {0.6667} <music21.note.Note C#>
        {0.8333} <music21.note.Note F>
        {1.0} <music21.note.Rest rest>
        {1.1667} <music21.note.Note D>
        {1.3333} <music21.note.Note E->
        {1.5} <music21.note.Note G>
        {1.6667} <music21.note.Note E->
        {1.8333} <music21.note.Note D>        
ConverterHumdrum.parseFile(filepath, number=None)

Open Humdram data from a file path.

Calls humdrum.parseFile on filepath.

Number is ignored here.

Methods inherited from SubConverter:

ConverterIPython

class music21.converter.subConverters.ConverterIPython(**keywords)

Meta-subconverter for displaying image data etc. in iPython using either png (via MuseScore or LilyPond) or directly via Vexflow/music21j

ConverterIPython bases

ConverterIPython read/write properties

Read/write properties inherited from SubConverter:

ConverterIPython methods

ConverterIPython.show(obj, fmt, app=None, subformats=None, **keywords)

show using the appropriate subformat.

Methods inherited from SubConverter:

ConverterLilypond

class music21.converter.subConverters.ConverterLilypond(**keywords)

Convert to Lilypond and from there usually to png, pdf, or svg.

ConverterLilypond bases

ConverterLilypond read/write properties

Read/write properties inherited from SubConverter:

ConverterLilypond methods

ConverterLilypond.show(obj, fmt, app=None, subformats=None, **keywords)

Call .write (write out the lilypond (.ly) file; convert to .png/.pdf, etc.) then launch the appropriate viewer for .png/.pdf (graphicsPath) or .svg (vectorPath)

ConverterLilypond.write(obj, fmt, fp=None, subformats=None, **keywords)

Methods inherited from SubConverter:

ConverterMEI

class music21.converter.subConverters.ConverterMEI(**keywords)

Converter for MEI. You must use an ”.mei” file extension for MEI files because music21 will parse ”.xml” files as MusicXML.

ConverterMEI bases

ConverterMEI read/write properties

Read/write properties inherited from SubConverter:

ConverterMEI methods

ConverterMEI.checkShowAbility(**keywords)

MEI export is not yet implemented.

ConverterMEI.parseData(dataString, number=None)

Convert a string with an MEI document into its corresponding music21 elements.

Parameters:
  • dataString (str) – The string with XML to convert.
  • number (NoneType) – Unused in this class. Default is None.
Returns:

The music21 objects corresponding to the MEI file.

Return type:

Stream or subclass

ConverterMEI.parseFile(filePath, number=None)

Convert a file with an MEI document into its corresponding music21 elements.

Parameters:
  • filePath (str) – Full pathname to the file containing MEI data.
  • number (NoneType) – Unused in this calss. Default is None.
Returns:

The music21 objects corresponding to the MEI file.

Return type:

Stream or subclass

ConverterMEI.show(obj, fmt, app=None, subformats=None, **keywords)
ConverterMEI.write(obj, fmt, fp=None, subformats=None, **keywords)

Methods inherited from SubConverter:

ConverterMidi

class music21.converter.subConverters.ConverterMidi(**keywords)

Simple class wrapper for parsing MIDI and sending MIDI data out.

ConverterMidi bases

ConverterMidi read/write properties

Read/write properties inherited from SubConverter:

ConverterMidi methods

ConverterMidi.parseData(strData, number=None)

Get MIDI data from a binary string representation.

Calls midi.translate.midiStringToStream.

ConverterMidi.parseFile(fp, number=None, **keywords)

Get MIDI data from a file path.

Calls midi.translate.midiFilePathToStream.

ConverterMidi.write(obj, fmt, fp=None, subformats=None, **keywords)

Methods inherited from SubConverter:

ConverterMuseData

class music21.converter.subConverters.ConverterMuseData(**keywords)

Simple class wrapper for parsing MuseData.

ConverterMuseData bases

ConverterMuseData read/write properties

Read/write properties inherited from SubConverter:

ConverterMuseData methods

ConverterMuseData.parseData(strData, number=None)

Get musedata from a string representation.

ConverterMuseData.parseFile(fp, number=None)

parse fp and number

Methods inherited from SubConverter:

ConverterMusicXML

class music21.converter.subConverters.ConverterMusicXML(**keywords)

Converter for MusicXML using the 2015 ElementTree system

ConverterMusicXML bases

ConverterMusicXML read/write properties

Read/write properties inherited from SubConverter:

ConverterMusicXML methods

ConverterMusicXML.findPNGfpFromXMLfp(xmlFilePath)
Check whether total number of pngs is in 1-9, 10-99, or 100-999 range,
then return appropriate fp. Raises and exception if png fp does not exist.
ConverterMusicXML.parseData(xmlString, number=None)

Open MusicXML data from a string.

ConverterMusicXML.parseFile(fp, number=None)

Open from a file path; check to see if there is a pickled version available and up to date; if so, open that, otherwise open source.

ConverterMusicXML.runThroughMusescore(fp, subformats=None, **keywords)

Take the output of the conversion process and run it through musescore to convert it to a png.

ConverterMusicXML.show(obj, fmt, app=None, subformats=None, **keywords)

Override to do something with png...

ConverterMusicXML.write(obj, fmt, fp=None, subformats=None, **keywords)
ConverterMusicXML.writeDataStream(fp, dataBytes)

Methods inherited from SubConverter:

ConverterNoteworthy

class music21.converter.subConverters.ConverterNoteworthy(**keywords)

Simple class wrapper for parsing NoteworthyComposer data provided in a file or in a string.

Gets data with the file format .nwctxt

Users should not need this routine. The basic format is converter.parse(“file.nwctxt”)

>>> nwcTranslatePath = common.getSourceFilePath() + os.path.sep + 'noteworthy'
>>> paertPath = converter.parse(r'd:/desktop/arvo_part_o_weisheit.nwctxt')
>>> paertStream = converter.parse(paertPath)
>>> len(paertStream.parts)
4

For developers: see the documentation for parseData() and parseFile() to see the low-level usage.

ConverterNoteworthy bases

ConverterNoteworthy read/write properties

Read/write properties inherited from SubConverter:

ConverterNoteworthy methods

ConverterNoteworthy.parseData(nwcData)

Open Noteworthy data from a string or list

>>> nwcData = ("!NoteWorthyComposer(2.0)\n|AddStaff\n|Clef|" + 
...     "Type:Treble\n|Note|Dur:Whole|Pos:1^")
>>> c = converter.subConverters.ConverterNoteworthy()
>>> c.parseData(nwcData)
>>> c.stream.show('text')
{0.0} <music21.stream.Part ...>
    {0.0} <music21.stream.Measure 0 offset=0.0>
        {0.0} <music21.clef.TrebleClef>
        {0.0} <music21.note.Note C>
ConverterNoteworthy.parseFile(fp, number=None)

Open Noteworthy data (as nwctxt) from a file path.

>>> paertPath = converter.parse('d:/desktop/arvo_part_o_weisheit.nwctxt')
>>> c = converter.subConverters.ConverterNoteworthy()
>>> c.parseFile(filePath)
>>> c.stream.show()

Methods inherited from SubConverter:

ConverterNoteworthyBinary

class music21.converter.subConverters.ConverterNoteworthyBinary(**keywords)

Simple class wrapper for parsing NoteworthyComposer binary data provided in a file or in a string.

Gets data with the file format .nwc

Users should not need this routine. Call converter.parse directly

ConverterNoteworthyBinary bases

ConverterNoteworthyBinary read/write properties

Read/write properties inherited from SubConverter:

ConverterNoteworthyBinary methods

ConverterNoteworthyBinary.parseData(nwcData)
ConverterNoteworthyBinary.parseFile(fp, number=None)

Methods inherited from SubConverter:

ConverterRomanText

class music21.converter.subConverters.ConverterRomanText(**keywords)

Simple class wrapper for parsing roman text harmonic definitions.

ConverterRomanText bases

ConverterRomanText read/write properties

Read/write properties inherited from SubConverter:

ConverterRomanText methods

ConverterRomanText.parseData(strData, number=None)
ConverterRomanText.parseFile(fp, number=None)

Methods inherited from SubConverter:

ConverterScala

class music21.converter.subConverters.ConverterScala(**keywords)

ConverterScala bases

ConverterScala read/write properties

Read/write properties inherited from SubConverter:

ConverterScala methods

Methods inherited from SubConverter:

ConverterText

class music21.converter.subConverters.ConverterText(**keywords)

standard text presentation has line breaks, is printed.

Two keyword options are allowed: addEndTimes=Boolean and useMixedNumerals=Boolean

ConverterText bases

ConverterText read/write properties

Read/write properties inherited from SubConverter:

ConverterText methods

ConverterText.show(obj, *args, **keywords)
ConverterText.write(obj, fmt, fp=None, subformats=None, **keywords)

Methods inherited from SubConverter:

ConverterTextLine

class music21.converter.subConverters.ConverterTextLine(**keywords)

a text line compacts the complete recursive representation into a single line of text; most for debugging. returned, not printed

>>> s = corpus.parse('bwv66.6')
>>> s.measures(1,4).show('textline')
'{0.0} <music21.stream.Part Soprano> / {0.0} <music21.instrument.Instrument ... 1>...' 

ConverterTextLine bases

ConverterTextLine read/write properties

Read/write properties inherited from SubConverter:

ConverterTextLine methods

ConverterTextLine.show(obj, *args, **keywords)
ConverterTextLine.write(obj, fmt, fp=None, subformats=None, **keywords)

Methods inherited from SubConverter:

ConverterTinyNotation

class music21.converter.subConverters.ConverterTinyNotation(**keywords)

Simple class wrapper for parsing TinyNotation data provided in a file or in a string.

Input only for now.

ConverterTinyNotation bases

ConverterTinyNotation read/write properties

Read/write properties inherited from SubConverter:

ConverterTinyNotation methods

ConverterTinyNotation.parseData(tnData, number=None)

Open TinyNotation data from a string

>>> tnData = "3/4 E4 r f# g=lastG trip{b-8 a g} c"
>>> c = converter.subConverters.ConverterTinyNotation()
>>> s = c.parseData(tnData)
>>> c.stream.show('text')
{0.0} <music21.stream.Measure 1 offset=0.0>
    {0.0} <music21.clef.TrebleClef>
    {0.0} <music21.meter.TimeSignature 3/4>
    {0.0} <music21.note.Note E>
    {1.0} <music21.note.Rest rest>
    {2.0} <music21.note.Note F#>
{3.0} <music21.stream.Measure 2 offset=3.0>
    {0.0} <music21.note.Note G>
    {1.0} <music21.note.Note B->
    {1.3333} <music21.note.Note A>
    {1.6667} <music21.note.Note G>
    {2.0} <music21.note.Note C>
    {2.5} <music21.bar.Barline style=final>

Methods inherited from SubConverter:

ConverterVexflow

class music21.converter.subConverters.ConverterVexflow(**keywords)

ConverterVexflow bases

ConverterVexflow read/write properties

Read/write properties inherited from SubConverter:

ConverterVexflow methods

ConverterVexflow.write(obj, fmt, fp=None, subformats=None, **keywords)

Methods inherited from SubConverter:

SubConverter

class music21.converter.subConverters.SubConverter(**keywords)

Class wrapper for parsing data or outputting data.

All other Converter types should inherit from this and have ways of dealing with various data formats.

Attributes that should be set:

readBinary = True or False (default False)
registerFormats = tuple of formats that can be handled; eg: ('musicxml',)
registerShowFormats = tuple of format calls that can be handled in .show() and .write()
registerInputExtensions = tuple of input extensions that should be handled in converter
registerOutputExtensions = tuple of output extensions that can be written. Order matters:
    the first will be used in calls to .write()
canBePickled = True or False (default True; does not do anything yet)
codecWrite = True or False (default False) if encodings need to be used to write
stringEncoding = string (default 'utf-8'). If codecWrite is True, this specifies what 
    encoding to use

SubConverter read/write properties

SubConverter.stream

Returns or sets the stream in the converter. Must be defined for subconverter to work.

SubConverter methods

SubConverter.checkShowAbility(**keywords)

return bool on whether the system is equipped to show in this format.

Default True. Might be False if, say a Lilypond converter is used and Lilypond is not installed.

SubConverter.getExtensionForSubformats(subformats=None)

Given a default format or subformats, give the file extension it should have:

>>> c = converter.subConverters.ConverterLilypond()

This is currently basically completely unused!!!!

SubConverter.getTemporaryFile(subformats=None)

This is never called with subformats and should probably be deleted!

>>> c = corpus.parse('bwv66.6')
>>> lpConverter = converter.subConverters.ConverterLilypond()
>>> tf = lpConverter.getTemporaryFile(subformats=['png'])
>>> tf.endswith('.png')
True
SubConverter.launch(filePath, fmt=None, options='', app=None, launchKey=None)

Opens the appropriate viewer for the file generated by .write()

app is the path to an application to launch. Specify it and/or a launchKey launchKey is the specific key in .music21rc (such as graphicsPath), etc. to search for the application. If it’s not specified then there might be a default one for the converter in self.launchKey. If it can’t find it there then environLocal.formatToApp(fmt) will be used.

SubConverter.parseData(dataString, number=None)

Called when a string (or binary) data is encountered.

This method MUST be implemented to do anything in parsing.

SubConverter.parseFile(filePath, number=None)

Called when a file is encountered. If all that needs to be done is loading the file and putting the data into parseData then there is no need to do anything except set self.readBinary (True|False).

SubConverter.show(obj, fmt, app=None, subformats=None, **keywords)
SubConverter.write(obj, fmt, fp=None, subformats=None, **keywords)
SubConverter.writeDataStream(fp, dataStr)