//
// Programmer: Craig Stuart Sapp <craig@ccrma.stanford.edu>
// Creation Date: Mon Nov 20 16:12:43 PST 2000
// Last Modified: Mon Nov 20 16:12:46 PST 2000
// Filename: ...sig/examples/all/maxent.cpp
// Web Address: http://sig.sapp.org/examples/museinfo/humdrum/maxent.cpp
// Syntax: C++; museinfo
//
// Description: determination of metrical accentuation through rules given
// by John Maxwell in:
//
// Reference: "An Expert System for Harmonizing Analysis of Tonal
// Music." pp 335-353 in: "Understanding Music with AI:
// Perspectives on Music Cognition." Ed. by Mira Balaban,
// Kemal Ebcioglu, and Otto Laske. MIT Press; 1992.
// [ISBN 0-262-52170-9]
//
#include "humdrum.h"
#include <string.h>
#include <ctype.h>
#include <stdio.h>
// function declarations
void checkOptions(Options& opts, int argc, char* argv[]);
void example(void);
void generateAnalysis(HumdrumFile& infile, Array<int>& maxent);
int measureAccentuation(HumdrumFile& infile, int line);
void printAnalysis(HumdrumFile& infile, Array<int>& accentuation);
void usage(const char* command);
// global variables
Options options; // database for command-line arguments
int debugQ = 0; // used with the --debug option
int appendQ = 0; // used with the -a option
int compoundQ = 1; // used with the -c option
// variables for keeping track of the change in meter during the score:
int metercount = 4;
int meterbase = 4;
///////////////////////////////////////////////////////////////////////////
int main(int argc, char* argv[]) {
HumdrumFile infile;
Array<int> accentuation;
// process the command-line options
checkOptions(options, argc, argv);
// figure out the number of input files to process
int numinputs = options.getArgCount();
for (int i=0; i<numinputs || i==0; i++) {
infile.clear();
// if no command-line arguments read data file from standard input
if (numinputs < 1) {
infile.read(cin);
} else {
infile.read(options.getArg(i+1));
}
generateAnalysis(infile, accentuation);
printAnalysis(infile, accentuation);
}
return 0;
}
///////////////////////////////////////////////////////////////////////////
//////////////////////////////
//
// checkOptions -- validate and process command-line options.
//
void checkOptions(Options& opts, int argc, char* argv[]) {
opts.define("a|append=b", "append analysis to data in output");
opts.define("C|compound=b", "don't try to use compound meters");
opts.define("debug=b", "trace input parsing");
opts.define("author=b", "author of the program");
opts.define("version=b", "compilation information");
opts.define("example=b", "example usage");
opts.define("h|help=b", "short description");
opts.process(argc, argv);
// handle basic options:
if (opts.getBoolean("author")) {
cout << "Written by Craig Stuart Sapp, "
<< "craig@ccrma.stanford.edu, Nov 2000" << endl;
exit(0);
} else if (opts.getBoolean("version")) {
cout << argv[0] << ", version: Nov 2000" << endl;
cout << "compiled: " << __DATE__ << endl;
cout << MUSEINFO_VERSION << endl;
exit(0);
} else if (opts.getBoolean("help")) {
usage(opts.getCommand());
exit(0);
} else if (opts.getBoolean("example")) {
example();
exit(0);
}
debugQ = opts.getBoolean("debug");
appendQ = opts.getBoolean("append");
if (opts.getBoolean("compound")) {
compoundQ = 0;
} else {
compoundQ = 1;
}
}
//////////////////////////////
//
// example -- example usage of the maxent program
//
void example(void) {
cout <<
" \n"
<< endl;
}
//////////////////////////////
//
// generateAnalysis --
//
void generateAnalysis(HumdrumFile& infile, Array& accentuation) {
accentuation.setSize(infile.getNumLines());
infile.analyzeRhythm();
int i, j;
for (i=0; i<infile.getNumLines(); i++) {
if (options.getBoolean("debug")) {
cout << "processing line " << (i+1) << " of input ..." << endl;
}
if (infile[i].getType() == E_humrec_interpretation) {
for (j=0; j<infile[i].getFieldCount(); j++) {
if (infile[i].getExInterpNum(j) != E_KERN_EXINT) {
continue;
}
if ((strncmp(infile[i][j], "*M", 2) == 0) &&
isdigit(infile[i][j][2]) &&
(strchr(infile[i][j], '/') != NULL)) {
sscanf(infile[i][j], "*M%d/%d", &metercount, &meterbase);
break;
}
}
}
if (infile[i].getType() != E_humrec_data) {
accentuation[i] = -1;
continue;
}
accentuation[i] = measureAccentuation(infile, i);
}
}
//////////////////////////////
//
// measureAccentuation -- apply the rule 6 on page 337:
//
// Rule 6. IF a musical event falls on the "primary beat unit" of
// the meter (as defined by a table relating meters to beat units)
// THEN it is accented.
//
#define ACCENT_YES 1
#define ACCENT_NO 0
#define ACCENT_UNKNOWN -1
int measureAccentuation(HumdrumFile& infile, int line) {
if (infile[line].getType() != E_humrec_data) {
return ACCENT_UNKNOWN;
}
double fraction;
fraction = infile[line].getBeat();
if (compoundQ && (metercount % 3 == 0)) {
fraction = fraction/3;
}
int beat = (int)fraction;
fraction = fraction - beat;
if (fraction < 0.001) {
fraction = 0;
} else if (fraction > 0.999) {
fraction = 0;
beat++;
}
if (fraction == 0) {
return ACCENT_YES;
} else {
return ACCENT_NO;
}
}
//////////////////////////////
//
// printAnalysis --
//
void printAnalysis(HumdrumFile& infile, Array& accentuation) {
int i;
if (appendQ) {
for (i=0; i<infile.getNumLines(); i++) {
switch (infile[i].getType()) {
case E_humrec_global_comment:
case E_humrec_bibliography:
case E_humrec_none:
case E_humrec_empty:
cout << infile[i].getLine() << "\n";
break;
case E_humrec_data:
cout << infile[i].getLine() << "\t";
if (accentuation[i] == ACCENT_YES) {
cout << "y";
} else {
cout << "n";
}
cout << "\n";
break;
case E_humrec_data_comment:
if (infile[i].equalFieldsQ("**kern")) {
cout << infile[i].getLine() << "\t"
<< infile[i][0] << "\n";
} else {
cout << infile[i].getLine() << "\t!\n";
}
break;
case E_humrec_data_measure:
if (infile[i].equalFieldsQ("**kern")) {
cout << infile[i].getLine() << "\t"
<< infile[i][0] << "\n";
} else {
cout << infile[i].getLine() << "\t=\n";
}
break;
case E_humrec_data_interpretation:
if (strncmp(infile[i][0], "**", 2) == 0) {
cout << infile[i].getLine() << "\t";
cout << "**accent" << "\n";
} else if (infile[i].equalFieldsQ("**kern")) {
cout << infile[i].getLine() << "\t"
<< infile[i][0] << "\n";
} else {
cout << infile[i].getLine() << "\t*\n";
}
break;
}
}
} else {
for (i=0; i<infile.getNumLines(); i++) {
switch (infile[i].getType()) {
case E_humrec_global_comment:
case E_humrec_bibliography:
case E_humrec_none:
case E_humrec_empty:
cout << infile[i].getLine() << "\n";
break;
case E_humrec_data:
if (accentuation[i] == ACCENT_YES) {
cout << "y";
} else {
cout << "n";
}
cout << "\n";
break;
case E_humrec_data_comment:
if (infile[i].equalFieldsQ("**kern")) {
cout << infile[i][0] << "\n";
} else {
// do nothing
}
break;
case E_humrec_data_measure:
if (infile[i].equalFieldsQ("**kern")) {
cout << infile[i][0] << "\n";
} else {
cout << "\t=\n";
}
break;
case E_humrec_data_interpretation:
if (strncmp(infile[i][0], "**", 2) == 0) {
cout << "**accent" << "\n";
} else if (infile[i].equalFieldsQ("**kern")) {
cout << infile[i][0] << "\n";
} else {
// do nothing
}
break;
}
}
}
}
//////////////////////////////
//
// usage -- gives the usage statement for the quality program
//
void usage(const char* command) {
cout <<
" \n"
<< endl;
}
// md5sum: 8f9f92335baec121042fce2aa15f26ac maxent.cpp [20050403]