This repository contains a digital edition in the Humdrum file format of music composed by Scott Joplin. Graphical versions of these scores can be viewed on Verovio Humdrum Viewer (VHV).

PDF files of scanned music used to encode the digital scores can be found in the reference-edition directory in this repository. When viewing the digital scores in VHV, press the alt-p (or option-p) keys to view the original scan that the digital encoding represents. Differences between the encodings and the scans should be reported in the issues section of this repository.

which includes dynamic conversions to other data formats.

The Humdrum Extras command-line programs can download these files from kernScores. A quick method of downloading:

    mkdir joplin
    cd joplin
    humsplit h://joplin

To get online access to a single chorale, for example to transpose the first chorale to C major:

   transpose -k c h://joplin/mapleleaf.krn

To interface to the Humdrum Toolkit commands, use the humcat command to download to standard input (the -s option is needed when downloading multiple files):

   humcat -s h://joplin | census -k

The makefile provided in the base directory includes example data processing commands. Type make when in the same directory as the makefile to list commands that can be run with the makefile.

If the command which make reports that the make command cannot be found, then you must install it. In linux, this comamnd might install it:

   sudo apt-get install build-essential
   # or
   sudo yum install build-essential

In OS X Mavericks or later, install the Xcode command-line tools:

   xcode-select --install

In Cygwin on MS Windows, re-run the cygwin install program and make sure that the development tools are included in the installation packages.