metdetection.utils

Class Evaluation

java.lang.Object

metdetection.utils.Evaluation

public class Evaluation
extends java.lang.Object

The Evaluation can be used to perform global evaluation on some output file.

Author:

Andrew McLeod - 9 September, 2016

Constructor Summary

Constructors

Constructor and Description
Evaluation()

Method Summary

Methods

Modifier and Type	Method and Description
private static void	argumentError(java.lang.String message) Some argument error occurred.
private static void	evaluateLpcfg() Evaluate the input lpcfg results.
private static void	evaluateTemperley(java.io.File file) Evaluate a Temperley file output (from std in) based on the gold standard meter parsed from the given MIDI or **kern file.
static java.lang.String	getAccuracyString(Measure correctMeasure, int correctSubBeatLength, int correctAnacrusisLength, Measure hypothesisMeasure, int hypothesisSubBeatLength, int hypothesisAnacrusisLength) Get the accuracy String for a metrical hypothesis.
private static java.util.List<TimeSignature>	getAllMeters(java.io.File file) Get a List of all of the meters of the given song, excluding the initial dummy one.
private static int	getMatch(int length, int offset, Measure correctMeasure, int correctSubBeatLength, int correctAnacrusisLength) Get the match type of a grouping of the given length and offset given the correct measure, anacrusis length, and sub beat length.
private static TimeSignature	getMeter(java.io.File file) Get the meter at the beginning of the given file.
private static java.lang.String	getNoteFileString(java.io.File file) Convert the given input file out into a note file.
private static int	getNumLevels(java.lang.String line) Return the number of levels on the given line of Temperley output.
static void	main(java.lang.String[] args)

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

Evaluation

public Evaluation()

Method Detail

main

public static void main(java.lang.String[] args)
                 throws java.io.IOException,
                        javax.sound.midi.InvalidMidiDataException

Throws:

java.io.IOException

javax.sound.midi.InvalidMidiDataException

getAllMeters

private static java.util.List<TimeSignature> getAllMeters(java.io.File file)
                                                   throws java.io.IOException,
                                                          javax.sound.midi.InvalidMidiDataException

Get a List of all of the meters of the given song, excluding the initial dummy one.

Parameters:

file - The file whose meters we want.

Returns:

A List of all of the meters of the given song, excluding the initial dummy one.

Throws:

java.lang.InterruptedException

javax.sound.midi.InvalidMidiDataException

java.io.IOException

getMeter

private static TimeSignature getMeter(java.io.File file)
                               throws java.io.IOException,
                                      javax.sound.midi.InvalidMidiDataException

Get the meter at the beginning of the given file.

Parameters:

file - The file whose meter we want.

Returns:

The meter at the beginning of the given file.

Throws:

java.lang.InterruptedException

javax.sound.midi.InvalidMidiDataException

java.io.IOException

evaluateTemperley

private static void evaluateTemperley(java.io.File file)
                               throws java.io.IOException,
                                      javax.sound.midi.InvalidMidiDataException

Evaluate a Temperley file output (from std in) based on the gold standard meter parsed from the given MIDI or **kern file.

Parameters:

file - The MIDI or **kern file which contains the gold standard meter.

Throws:

java.lang.InterruptedException

javax.sound.midi.InvalidMidiDataException

java.io.IOException

getNumLevels

private static int getNumLevels(java.lang.String line)

Return the number of levels on the given line of Temperley output. That is, the number of occurrences of "x " on that line.

Parameters:

line - The line we are searching.

Returns:

The number of levels on the given line.

getAccuracyString

public static java.lang.String getAccuracyString(Measure correctMeasure,
                                 int correctSubBeatLength,
                                 int correctAnacrusisLength,
                                 Measure hypothesisMeasure,
                                 int hypothesisSubBeatLength,
                                 int hypothesisAnacrusisLength)

Get the accuracy String for a metrical hypothesis.

Parameters:

correctMeasure - The correct measure.

correctSubBeatLength - The correct sub beat length, in ticks.

correctAnacrusisLength - The correct anacrusis length, in ticks.

hypothesisMeasure - The hypothesis measure.

hypothesisSubBeatLength - The hypothesis sub beat length, in ticks.

hypothesisAnacrusisLength - The hypothesis anacrusis length, in ticks.

Returns:

The accuracy string for the given hypothesis.

getMatch

private static int getMatch(int length,
           int offset,
           Measure correctMeasure,
           int correctSubBeatLength,
           int correctAnacrusisLength)

Get the match type of a grouping of the given length and offset given the correct measure, anacrusis length, and sub beat length.

Parameters:

length - The length of the grouping we want to check.

offset - The offset of the grouping we want to check.

correctMeasure - The correct measure of this song.

correctSubBeatLength - The correct sub beat length.

correctAnacrusisLength - The correct anacrusis length, measured in tacti.

Returns:

A value less than 0 if this grouping overlaps some correct tree boundary. A value greater than 0 if this grouping matches a correct tree boundary exactly. A value of 0 otherwise, for example if the grouping lies under the lowest grouping, but could be grouped up into a correct grouping.

getNoteFileString

private static java.lang.String getNoteFileString(java.io.File file)

Convert the given input file out into a note file.

Parameters:

file - The input file to be converted into a note file.

Returns:

The String of the note file for the given input file.

evaluateLpcfg

private static void evaluateLpcfg()

Evaluate the input lpcfg results. That is, compute and print the global FN, FP, TP, P, R, and F1 from std in.

argumentError

private static void argumentError(java.lang.String message)

Some argument error occurred. Print the message to std err and exit.

Parameters:

message - The message to print to std err.