samer@0: Digital edition of Hummel preludes, Op. 67
samer@0: ==========================================
samer@0: 
samer@0: This repository is a digital edition of the preludes composed by
samer@0: Johann Nepomuk Hummel, encoded in the Humdrum file format.
samer@0: Tools for processing the encodings in this format on the command-line
samer@0: can be found online at https://github.com/humdrum-tools
samer@0: 
samer@0: The encodings are located in the 'kern' directory.
samer@0: Scans of the source edition can be downloaded from 
samer@0: [kernScores](http://kern.humdrum.org) with this command:
samer@0: ```bash
samer@0:    make reference
samer@0: ```
samer@0: 
samer@0: These digital scores can also be found as a submodule in the 
samer@0: [humdrum-data](https://github.com/humdrum-tools/humdrum-data) repository.
samer@0: 
samer@0: 
samer@0: Data processing tools and other resources
samer@0: =========================================
samer@0: 
samer@0: These digital scores may also be found on the kernScores website:
samer@0: *    http://kernscores.stanford.edu/browse?l=hummel/preludes
samer@0: 
samer@0: with mirrors at:
samer@0: *    http://kern.humdrum.org/browse?l=hummel/preludes
samer@0: *    http://kern.ccarh.org/browse?l=hummel/preludes
samer@0: 
samer@0: which includes dynamic conversions to other data formats.  
samer@0: 
samer@0: The [Humdrum Extras](http://extras.humdrum.org) command-line programs 
samer@0: can download these files from kernScores.  A quick method of downloading:
samer@0: ```bash
samer@0:     mkdir -p hummel/preludes
samer@0:     cd hummel/preludes
samer@0:     humsplit h://hummel/preludes
samer@0: ```
samer@0: To get online access to a single movement, for example to transpose the first 
samer@0: prelude to G major:
samer@0: ```bash
samer@0:    transpose -k g h://hummel/preludes/prelude67-01.krn
samer@0: ```
samer@0: 
samer@0: 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):
samer@0: ```bash
samer@0:    humcat -s h://hummel/preludes | census -k
samer@0: ```
samer@0: 
samer@0: 
samer@0: Makefile
samer@0: ========
samer@0: 
samer@0: The makefile provided in the base directory includes example data
samer@0: processing commands.  Type ```make``` when in the same directory as the
samer@0: makefile to list commands that can be run with the makefile.
samer@0: 
samer@0: If the command ```which make``` reports that the make command cannot
samer@0: be found, then you must install it.  In linux, this command might
samer@0: install it:
samer@0: ```bash
samer@0:    sudo apt-get install build-essential
samer@0:    # or
samer@0:    sudo yum install build-essential
samer@0: ```
samer@0: 
samer@0: In OS X Mavericks or later, install the Xcode command-line tools:
samer@0: ```bash
samer@0:    xcode-select --install
samer@0: ```
samer@0: 
samer@0: In Cygwin on MS Windows, re-run the cygwin install program and make sure
samer@0: that the development tools are included in the installation packages.
samer@0: 
samer@0: 
samer@0: