keycorel manpage

COMMAND

keycorel -- Correlation identification of keys in musical contexts.

keycorel [-s | --aarden] [-D] [-a] [-f] [input] [> output]

-a		Display the r-value correlation scores for all test keys.
-D		Do not scale the note distributions by note durations.
-s		Simple key correlation weightings
--aarden		Correlation weightings of Bret Aarden (2003)
-f		Display measured note frequency distributions in input.
-w weightfile		Use the weights for pitch profiles in the weightfile.

User-defined weights

Non-standard pitch profiles can be specified in a file which is given as input with the -w option. The weight file must have at least two spine: one **kern spine containing the pitch class -- upper case for major keys and lower case for minor keys; and a **number spine which contains the weighting for that pitch class and mode. There may be other spines in the file, but there should be only one **kern and **number spine in the file for predictable results. Here is an example pitchclass weight file using the same weights used with the -s option:

Carol Krumhansl's probe-tone profiles (default): **kern **number C 6.35 C# 2.23 D 3.48 D# 2.33 E 4.38 F 4.09 F# 2.52 G 5.19 G# 2.39 A 3.66 A# 2.29 B 2.88 c 6.33 c# 2.68 d 3.52 d# 5.38 e 2.60 f 3.53 f# 2.54 g 4.75 g# 3.98 a 2.69 a# 3.34 b 3.17 *- *-

Bret Aarden's continuity profiles (--aarden): **kern **number C 17.7661 C# 0.145624 D 14.9265 D# 0.160186 E 19.8049 F 11.3587 F# 0.291248 G 22.062 G# 0.145624 A 8.15494 A# 0.232998 B 4.95122 c 18.2648 c# 0.737619 d 14.0499 d# 16.8599 e 0.702494 f 14.4362 f# 0.702494 g 18.6161 g# 4.56621 a 1.93186 a# 7.37619 b 1.75623 *- *-

Simple pitch profiles (-s): **kern **number C 2 C# 0 D 1 D# 0 E 1 F 1 F# 0 G 2 G# 0 A 1 A# 0 B 1 c 2 c# 0 d 1 d# 1 e 0 f 1 f# 0 g 2 g# 1 a 0 a# 0.5 b 0.5 *- *-

Comparison between different weightings

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

The compiled keycorel program can be downloaded for the following platforms:
• Linux (i386 processors) compiled on April 24 2005.
• Windows compiled on 1 Jun 2006.

The source code for the program was last modified on 24 Apr 2005.