hum2xml manpage

COMMAND

hum2xml

SYNOPSIS

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

OPTIONS

-r Reverse the ordering of the staves in a printed system. Usually a Humdrum file contains the bottom staff in a system in the left-most column. If the ordering of the staves in a Humdrum file are reversed, then use the -r to store them in correct order in the MusicXML output.

DESCRIPTION

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

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.

EXAMPLES

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:

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

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

DOWNLOAD