hum2xml manpage

COMMAND

hum2xml -- Convert Humdrum files into MusicXML files.

hum2xml [-r] [input] [> output]

Printing Humdrum data in Finale 2003 or higher

Humdrum files converted into MusicXML files can be imported into the Finale Music Typesetting program by following these instructions:

    hum2xml input.krn > output.xml
 

For the sample input data on the left, the output file will contain the following data:

input.krn **kern *M4/4 *MM120 =1- 4c 4c 4g 4g =2 4a 4a 2g =3 4f 4f 4e 4e =4 4d 4d 2c == *-

output.xml <?xml version="1.0" standalone="no"?> <!DOCTYPE score-partwise PUBLIC "-//Recordare//DTD MusicXML 0.6a Partwise//EN" "//C:/Program Files/Finale 2003/Component Files/partwise.dtd"> <score-partwise> <part-list> <score-part id="P1"> <part-name>XPart 0</part-name> </score-part> </part-list> <part id="P1"> <measure number="1"> <attributes> <divisions>1</divisions> </attributes> <attributes> <time> <beats>4</beats> <beat-type>4</beat-type> </time> </attributes> <note> <pitch> <step>C</step> <octave>4</octave> </pitch> <duration>1</duration> <voice>1</voice> <type>quarter</type> </note> <note> <pitch> <step>C</step> <octave>4</octave> </pitch> <duration>1</duration> <voice>1</voice> <type>quarter</type> </note> <note> <pitch> <step>G</step> <octave>4</octave> </pitch> <duration>1</duration> <voice>1</voice> <type>quarter</type> </note> <note> <pitch> <step>G</step> <octave>4</octave> </pitch> <duration>1</duration> <voice>1</voice> <type>quarter</type> </note> </measure> <measure number="2"> <note> <pitch> <step>A</step> <octave>4</octave> </pitch> <duration>1</duration> <voice>1</voice> <type>quarter</type> </note> <note> <pitch> <step>A</step> <octave>4</octave> </pitch> <duration>1</duration> <voice>1</voice> <type>quarter</type> </note> <note> <pitch> <step>G</step> <octave>4</octave> </pitch> <duration>2</duration> <voice>1</voice> <type>half</type> </note> </measure> <measure number="3"> <note> <pitch> <step>F</step> <octave>4</octave> </pitch> <duration>1</duration> <voice>1</voice> <type>quarter</type> </note> <note> <pitch> <step>F</step> <octave>4</octave> </pitch> <duration>1</duration> <voice>1</voice> <type>quarter</type> </note> <note> <pitch> <step>E</step> <octave>4</octave> </pitch> <duration>1</duration> <voice>1</voice> <type>quarter</type> </note> <note> <pitch> <step>E</step> <octave>4</octave> </pitch> <duration>1</duration> <voice>1</voice> <type>quarter</type> </note> </measure> <measure number="4"> <note> <pitch> <step>D</step> <octave>4</octave> </pitch> <duration>1</duration> <voice>1</voice> <type>quarter</type> </note> <note> <pitch> <step>D</step> <octave>4</octave> </pitch> <duration>1</duration> <voice>1</voice> <type>quarter</type> </note> <note> <pitch> <step>C</step> <octave>4</octave> </pitch> <duration>2</duration> <voice>1</voice> <type>half</type> </note> <barline> <bar-style>light-heavy</bar-style> </barline> </measure> </part> </score-partwise>

To load the MusicXML file into Finale, first create a blank default document. This must be done in order to activate the "MusicXML Import..." item in the "Plug-ins" menu. If you do not have a blank Finale document open, then the MusicXML data cannot be imported. To open a blank document go to the "File" menu and choose "New" then "Default Document" as illustrated below:



Next, go to the "Plug-ins" menu at the top of the Finale menu and select "MusicXML Import..." as illustrated in the next figure:



In the "MusicXML Import..." window, select your MusicXML file to load into Finale. You should end up with music in the Finale window like this:



You may also use the translation from Humdrum into MusicXML to import the musical data into other notation programs listed on the recordare.com website, such as LilyPond which is a popular linux music-typesetting program.

Non-kern spines

Non-kern spines to the right of a **kern spine will be converted into lyrics when the file is converted into a MusicXML file. For example, the following input:

**kern **text **text *clefG2 * * *k[] * * *M4/4 * * 4c Twin- Up 4c -kle, a- 4g twin- -bove 4g kle the = = = 4a lit- world 4a tle so 2g star. high. = = = 4f How Like 4f I a 4e won- dia- 4e -der mond = = = 4d what in 4d you the 2c are. sky. == == == *- *- *-

Will generate this result when the MusicXML file is loaded into Finale:



More example usages of the hum2xml program are available on the hum2xml examples page

Input arguments or piped data which are expected to be Humdrum files can also be web addresses. For example, if a program can process files like this:

       program file.krn

It can also read the data over the web:

       program http://www.some-computer.com/some-directory/file.krn

Piped data works in a somewhat similar manner:

       cat file.krn | program

is equivalent to a web file using ths form:

       echo http://www.some-computer.com/some-directory/file.krn | program

Besides the http:// protocol, there is another special resource indicator prefix called humdrum:// which downloads data from the kernscores website. For example, using the URI humdrum://brandenburg/bwv1046a.krn:

      program humdrum://brandenburg/bwv1046a.krn

will download the URL:

http://kern.humdrum.org/cgi-bin/ksdata?file=bwv1046a.krn&l=/brandenburg&format=kern
Which is found in the Musedata Bach Brandenburg Concerto collection.

This online-access of Humdrum data can also interface with the classical Humdrum Toolkit commands by using humcat to download the data from the kernscores website. For example, try the command pipeline:

      humcat humdrum://brandenburg/bwv1046a.krn | census -k

xml2hum, ms, hum2gmn.

The compiled hum2xml program can be downloaded for the following platforms:
• Linux (i386 processors) (dynamically linked) compiled on 28 Jun 2012.
• Windows compiled on 29 Jun 2012.
• Mac OS X/i386 compiled on 13 Nov 2013.
• Mac OS X/PowerPC (version 10.2 and higher) compiled on 13 May 2009.

The source code for the program was last modified on 26 Jun 2012. Click here to go to the full source-code download page.