If a directory is given as an argument to the program, all files ending in .krn will be processed, and any subdirectories in the directory will also be processed.
By default output files will be written to the same directory in which the program was run. If you need to store the files in a different directory, use the -t option to change the target directory.
The -m controls the minimum number of notes present in the incipit, while the -l option controls the maximum number of notes in the extracted incipit (limit). The tindex program will try to extract music by phrase markers in the data.
In the following example the input file has 49 notes, with phrases grouping every seven notes. When thememakerx is used with default settings, the output (shown on the right) will produce an incipit with 4 full phrases of 7 notes each, for a total of 28 notes.
Thememakerx tries to maximize the number of complete phrases which can fit within the limit (of 30 notes). In this case the first four phrases contain 28 notes, while the first 5 phrases contain too many notes (35). If a complete phrase boundary does not occur within the minimum and maximum limit for note counts, then the music will be selected up to the maxium number of notes allowed, chopping up any phrase up to that point. If no phrase information is given in the input file, then the maximum note count will be selected for the incipit.
program file.krnIt can also read the data over the web:
program http://www.some-computer.com/some-directory/file.krnPiped data works in a somewhat similar manner:
cat file.krn | programis 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.krnwill download the URL:
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