annotate classical/hummel/preludes/README.md @ 2:1e94d64e1d9e tip

Many fixes to remove spurious notes, correct time signatures and clefs. Still some problems remain.
author samer
date Fri, 24 Apr 2015 18:19:47 +0100
parents 968db103ad92
children
rev   line source
samer@0 1 Digital edition of Hummel preludes, Op. 67
samer@0 2 ==========================================
samer@0 3
samer@0 4 This repository is a digital edition of the preludes composed by
samer@0 5 Johann Nepomuk Hummel, encoded in the Humdrum file format.
samer@0 6 Tools for processing the encodings in this format on the command-line
samer@0 7 can be found online at https://github.com/humdrum-tools
samer@0 8
samer@0 9 The encodings are located in the 'kern' directory.
samer@0 10 Scans of the source edition can be downloaded from
samer@0 11 [kernScores](http://kern.humdrum.org) with this command:
samer@0 12 ```bash
samer@0 13 make reference
samer@0 14 ```
samer@0 15
samer@0 16 These digital scores can also be found as a submodule in the
samer@0 17 [humdrum-data](https://github.com/humdrum-tools/humdrum-data) repository.
samer@0 18
samer@0 19
samer@0 20 Data processing tools and other resources
samer@0 21 =========================================
samer@0 22
samer@0 23 These digital scores may also be found on the kernScores website:
samer@0 24 * http://kernscores.stanford.edu/browse?l=hummel/preludes
samer@0 25
samer@0 26 with mirrors at:
samer@0 27 * http://kern.humdrum.org/browse?l=hummel/preludes
samer@0 28 * http://kern.ccarh.org/browse?l=hummel/preludes
samer@0 29
samer@0 30 which includes dynamic conversions to other data formats.
samer@0 31
samer@0 32 The [Humdrum Extras](http://extras.humdrum.org) command-line programs
samer@0 33 can download these files from kernScores. A quick method of downloading:
samer@0 34 ```bash
samer@0 35 mkdir -p hummel/preludes
samer@0 36 cd hummel/preludes
samer@0 37 humsplit h://hummel/preludes
samer@0 38 ```
samer@0 39 To get online access to a single movement, for example to transpose the first
samer@0 40 prelude to G major:
samer@0 41 ```bash
samer@0 42 transpose -k g h://hummel/preludes/prelude67-01.krn
samer@0 43 ```
samer@0 44
samer@0 45 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 46 ```bash
samer@0 47 humcat -s h://hummel/preludes | census -k
samer@0 48 ```
samer@0 49
samer@0 50
samer@0 51 Makefile
samer@0 52 ========
samer@0 53
samer@0 54 The makefile provided in the base directory includes example data
samer@0 55 processing commands. Type ```make``` when in the same directory as the
samer@0 56 makefile to list commands that can be run with the makefile.
samer@0 57
samer@0 58 If the command ```which make``` reports that the make command cannot
samer@0 59 be found, then you must install it. In linux, this command might
samer@0 60 install it:
samer@0 61 ```bash
samer@0 62 sudo apt-get install build-essential
samer@0 63 # or
samer@0 64 sudo yum install build-essential
samer@0 65 ```
samer@0 66
samer@0 67 In OS X Mavericks or later, install the Xcode command-line tools:
samer@0 68 ```bash
samer@0 69 xcode-select --install
samer@0 70 ```
samer@0 71
samer@0 72 In Cygwin on MS Windows, re-run the cygwin install program and make sure
samer@0 73 that the development tools are included in the installation packages.
samer@0 74
samer@0 75
samer@0 76