M2K Development Team Module/Itineraries Development Status: 27 October 2005

MODULE NAME	PACKAGE	FUNCTION/DESCRIPTION
AudioTempoExtractionEvaluator	evaluation	Evaluates tempo transcription algorithms
ClassificationResultRead	evaluation	Reads in ground truth and classification result
DrumDetectionEvaluator	evaluation	Evaluates a detected set of drum transcriptions
KeyFindingAccuracy	evaluation	Calulates accuracy of key finding results
McNemarsTest	evaluation	Compares input Signal arrays with McNemar's test
MelodySimilarityEvaluator1	evaluation	Evaluates sybolic melody similarity algorithms
MelodyTranscriptionEvaluator	evaluation	Evaluates melody transcription algorithms
OnsetDetectionEvaluator	evaluation	Evaluates a detected set of musical event onset times
RankAlgorithms	evaluation	Ranks the output of multiple algorithms
ReadDrumDetectionTextFile	evaluation	Reads in a text file of drum detection and outputs a Signal object containing the detection
ReadKeyTextFile	evaluation	Reads a text file of the musical key of a music file and outputs a Signal object containing the key
ReadMelodyExtractionTextFile	evaluation	Reads a text file of a predominant melody F0 estimate
ReadOnsetTextFile	evaluation	Reads a text file of note onsets and outputs a Signal object containing the onsets
ReadSFSAnnotationFile	evaluation	Reads in drum detection text files and outputs the onsets and drum type in a Signal object
ReadTempoExtractionTextFile	evaluation	Reads a text file of tempo extractions and outputs a Signal object containing the onsets
SignTest	evaluation	Compares input Signal arrays with Sign test
SignalArrayAccuracy	evaluation	Calculates the accuracy of the classifications of the Signals in the input array
StudentTTest	evaluation	Compares input Signal arrays with Student T test
MelFilterBank	filters	Passes input through a MelFilterBank
OnePoleFilter	filters	Passes input through a One pole filter
OneZeroFilter	filters	Passes input through a One zero filter
SpectralContrastFilter	filters	Passes input spectrum through Octave-scale non-overlapping filters
AudioFilePlayerModule	io	An MP3 AudioPlayer, based on Javazoom JLayer.
AudioFileRead	io	Buffered audio file reading for a number of different audio file formats. The data is framed and streamed out.
AudioSegmentPlayerModule	io	An MP3 and WAV AudioPlayer, based on Javazoom JLayer. Allows one to play any segments in the file
AudioSegmentSequencePlayerModule	io	An audio segment sequencer and player.
CreateFileListForClass	io	Creates FileListForClass objects
CreateSignalList	io	Creates an array of Signal objects
CreateSignals	io	Creates a stream of empty Signal objects
InitSignalArrayFromListFile	io	Reads file names and labels from a file, initialises a Signal array and outputs it.
InputSignalArrays	io	Reads individual files, all files within a directory, all files in a directory tree, or any conbination thereof, and outputs them as signal objects
InputSignals	io	Reads individual files, all files within a directory, all files in a directory tree, or any conbination thereof, and outputs them as signal arrays
PreCacheASCIISignal	io	receives in a Signal Object, and saves it to disk as an ASCII file
Print1DDArray	io	Prints a 1 dimensional double array
Print2DDArray	io	Prints a 2 dimensional double array
PrintSignal	io	Prints the toString() of input Signal objects
ReadASCIISignal	io	Reads a signal cached in ASCII format
ReadCached Signal	io	Reads a cached signal
ReadMarsyas01FeatureFiles	io	Reads features files with labels from Marsyas
ReadSerializedObject	io	Reads in a Serialized object
ReadSerializedSignalArrays	io	Reads serialized Signal Array objects from the location specified in input file objects
ReadSerializedSignalOject	io	Reads serialized Signal objects from the location specified in input file objects
SerializeObject	io	Serializes an object and writes it to a file
SignalToFileObject	io	Takes a Signal object and outputs a File object at the place specified by the Signal's file_location metadata
SignalWaveRead	io	Read in a Signal object, output a double array
SimpleASCIISignalREader	io	receives in Signal Objects and reads in it from an ASCII file and outputs it.
StreamDirectoryFiles	io	Streams files specified in a given directory
StreamFilesFromFileListFile	io	Streams files specified in a list
WaveGenerator	io	Generate a sine wave
WavRead	io	Reads .wav files and outputs samples in double arrays
Write1DDoubleArrayToFile	io	Writes a double array to a file
Write1DDoubleArrayToTable	io	Writes a double array to a table
Write1DDoubleArraysToFiles	io	Writes multiple double arrays to files
Write2DDoubleArrayToFile	io	Writes a 2D double array to a file
Write2DDoubleArraysToFiles	io	Writes multiple 2D double arrays to files
WriteFileListForSignalArray	io	Takes a Signal array and writes the filenames and class metadata of the Signals to a file
WriteFileListsToTextFile	io	Write a stream of FileListWithClass to a text file
WriteSignalArrayToTable	io	Write data and all metadata in a signal to a table
WriteSignalToTable	io	Create FileListForClass objects
Abs	math	Absolute value of real 1Darrays/vectors (fullwave rectifier)
Angle	math	Phase angle of complex numbers
Centroid	math	Centroid of input vector
DifferenceBetweenFrames	math	Difference between frames (deltas and accelerations)
ElementAdd	math	Array/Vector Addition
ElementMultiply	math	Element by Element multiplication of vectors
Entropy	math	Computes the entropy of input arrays
Flux	math	Flux of successive 1Darrays/vectors
HalfWaveRectifier	math	Half wave rectifier
HistogramDoubleArray	math	Prepares a histogram from an input double array
InnerProduct	math	Dot product of two 1Darrays
LinearRegression	math	Computes a linear regression from succesive input arrays
Log	math	Logarithm base e
Log10	math	Logarithm base 10
Log2	math	Logarithm base 2
Magnitude	math	Computes the magnitude of complex numbers
Mean	math	Computes the mean of 1Darray/vector
MeanArray	math	Computes the means of input arrays and outputs an array of the mean values of input arrays
MeanSpread	math	Computes the spread of input arrays,
MedianDynamicThreshold	math	Peak picker for onset detection
Norm	math	Calculates 1,2,inf,-inf,p norms of input
NormaliseFunction	math	Normalizes the input
PhaseDeviation	math	Computes the deviation of a phase from its target value, which is calculated from the previous two values.
Pow	math	Raise to specified power
ScalarMultiply	math	Mutiply a 1Darrays with a scalar gain
SignalMeanandVariance	math	Computes Means and Variances of input Signal objects
SignalMeanandVariance2	math	Computes Means and Variances of input Signal objects, based on Onset detection metadata
SignalMedianDynamicSilenceGate	math	Computes a dynamic median threshold of the input function, which is used to peak-pick the input function
SignalMedianDynamicThreshold	math	Computes a dynamic median threshold of the input function, which is used to peak-pick the input function
SignalSquaredEuclideanDistance	math	Calculates Squared Euclidean distance of columns of two Signal Objects
SpectralRollOff	math	Compute the rolling off point of the input array
Spread	math	Compute the spread of input array
Sqrt	math	Squareroot
StreamMeanAndVariance	math	Computes Means and Variances of elements of array streams
SumArray	math	Calculates the sum of input arrays
Variance	math	Variance of 1Darray/vector
ZeroCrossings	math	Number of zerocrossings in a 1Darray/vector
ApplySignalClassifier	modelling	Applies a SignalClassifier model to novel inputs in the form of an array of Signal objects
ApplySignalClassifierForLikelihoods	modelling	Applies a SignalClassifier model to novel inputs in the form of an array of Signal objects to which the likelihoods of class membership are added
ApplySignalGaussian	modelling	Applies Signal Gaussian model to input Signal array
SignalGaussianTrainer	modelling	Trains a Gaussian model on input Signal array
TrainErgodicHMM	modelling.jahmm	Takes an array of Signal objects and trains an Ergodic HMM on them using Jahmm
ApplyFishersLinearDiscriminantModel	modelling.linearDiscriminantAnalysis	Applies a Fisher's Criterion Linear Discriminant classifier to an input array of Signal objects
ApplyOneAgainstAllLDAModel	modelling.linearDiscriminantAnalysis	Applys a multiClass Linear Discriminant Analysis model to novel inputs of an array of Signal objects
TrainFishersLinearDiscriminantModel	modelling.linearDiscriminantAnalysis	Takes an array of Signal objects and trains a Fisher's Criterion Linear Discriminant model on them
TrainOneAgainstAllLDAModel	modelling.linearDiscriminantAnalysis	Takes an array of Signal objects and trains a Fisher's Criterion Linear Discriminant model on them
ApplyFullTrainedModelCombiner	modelling.modelCombiners	Applies model combiners based on the FullTrainedModelCombiner interface (for classifier ensembles and bagging systems)
ApplyFullTrainedModelCombinerForLikelihoods	modelling.modelCombiners	Applies model combiners based on the FullTrainedModelCombiner interface to combine the likeliboods (for classifier ensembles and bagging systems)
ApplyFullTrainedModelCombinerToSignalFor Likelihoods	modelling.modelCombiners	Same as above, but input is a single Signal object, instead of a Signal array
TrainConstrainedRegressionCombiner	modelling.modelCombiners	Trains a Constrained Regression model to combine input likelihoods
TrainDecisionTemplateCombiner	modelling.modelCombiners	Trains a Decision Template to combine input likelihoods
TrainGaussianDecisionTemplateCombiner	modelling.modelCombiners	Trains a Gaussian Decision Template to combine input likelihoods
TrainModelCombinerModuleImpl	modelling.modelCombiners	An abstract base implementation of a module for training model combiners
ApplySingleGaussian	modelling.singleGaussian	Applies a Single Gaussian Model to inputs of an array of Signal objects
SingleGaussianTrainer	modelling.singleGaussian	Takes an array of Signal objects and trains a single Gaussian model on them
Template	my_modules	A module template to help users write their own modules
DetectBadDataInSignals	testing	Scans input Signal objects for bad data
GenerateImpulse	testing	Generates 1D double array of impulse values for testing purposes
GenerateRamp	testing	Generates 1D double array of ramp values for testing purposes
GenerateTriggerStream	testing	Generates a number of objects (triggers) for testing purposes
GenerateWhileNoise	testing	Generates 1D double array of while noise values for testing purposes
DCT	transforms	Discrete Cosine Transform
FFT	transforms	General FFT and iFFT
FFTReal	transforms	FFT of real inputs
PCA	transforms	Performs a Principal Componouts Analysis on an input Singal array
ApplyFishersLinearDiscriminantTransform	transforms	Applies a Fisher's Criterion Linear Discriminant transform on an novel input Signal array
TrainAndApplyFishersLinearDiscriminant Transform	transforms	Trains and applies a Fisher's Criterion Linear Discriminant transform on an input Signal array
ApplyFishersLinearDiscriminantTransform	transforms. linearDiscriminantTransform	Applies a Fisher's Criterion Linear Discriminant transform on an novel input Signal array
ApplyOneAgainstAllLDATransform	transforms. linearDiscriminantTransform	Applies an one-against-all LDA transform on an novel input Signal array
TrainAndApplyFishersLinearDiscriminant Transform	transforms. linearDiscriminantTransform	Trains and applies a Fisher's Criterion Linear Discriminant transform on an input Signal array
TrainAndApplyOneAgainstAllLDATransform	transforms. linearDiscriminantTransform	Trains and applies an one-against-all LDA transform on an input Signal array
ApplyPCA	transforms. principalComponentsAnalysis	Applies a Principal Components Analysis transform on an novel input Signal array
TrainAndApplyPCA	transforms. principalComponentsAnalysis	Trains and applies a PCA transform on an input Signal array
Accuracy	util	Measures label accuracy
AddIntMetadataToSignal	util	Add input integer to the metadata of input Signal
AppendArrayToSignal	util	Append input array to input Signal
AppendMatrixStreamToSignal	util	Append Matrix stream to input Signal
AppendTimeStampsToSignal	util	Append timestamp to each frame of input Signal
Collect1DDArrayStreamInto2DDArray	util	Collects an 1D double array input stream into a 2D double array
CollectSignals	util	Collect a Signal stream into Signals arrays according to their class labels
CollectSignalsInto1SignalPerClass	util	Collects an input of Signal objects into a Single Signal Object for each class
Concatenate1DDArrayStream	util	Concatenates a stream of double arrays into one double array
Concatenate1DDArrays	util	Concatenates 1DDArrays/Vectors
CopyMetadataFromSignal	util	Copies the specified metadata from one input Signal object to another
CopyMetadataFromSignalArray	util	Copies the specified metadata from one input Signal array to another
CreateTestAndTrainSets	util	Collect a FileListWithClass stream and divide them into a test and training set
CreateTestandTrainSignalArrays	util	Collect Signal arrays and divide them into a test and training set
DateSplitter	util	Divides data from each Signal object in a Signal array into two groups
DeleteDataFromSignal	util	Deletes the data matrices from input Signal objects
DeleteDataFromSignalArrays	util	Delectes the data matrices from input Signal arrays
DivideSignalArray	util	Divides a Signal array into two arrays
Downsample	util	Resample using every nth samples
Enframe	util	Frames input with certain frame size and overlap
ExternalIntegrationModule	util	Executes external commands
GateKeeper	util	Controls dataflow execution, by only allowing input through when trigger signals are received
IntArrayAccuracy	util	Accuracy and confusion matrix from labels
Length	util	Caculate the length of a 1D array
MatlabIntegrationModule	util	Interface for MATLAB
MatlabTwoInputIntegrationModule	util	Interface for MATLAB, 2 inputs
NFoldCrossvalidatedSignalArrays	util	Collect Signal arrays and split them into N fold test and traing sets
NFoldCrossvalidatedSignalArray	util	Splits an input Signal array into N fold test and training sets
OrderedFanIn	util	Takes in a number of inputs and outputs them, in the order of the input pipes
PopulateSignal	util	Populate an input Signal with input data frames
Stereo2Mono	util	Converts stereo signals to mono
StreamColumnsOfSignalOut	util	Produces a null-terminated stream of the columns of a Signal
StreamSignalsFromArray	util	Stream out a stream of Signal arrays as Signal objects
StripMetadataFromSignalArrays	util	Either copies the Signal array and strip the specified metadata from the copy or just strip the metadata from the original Signal array
StripMetadataFromSignals	util	Either copies the Signal object and strip the specified metadata from the copy or just strip the metadata from the original Signal object
TranscriptionMapper	util	Maps a transcription from one format to another
Truncate1DDArray	util	Truncates 1DArrays to specified length
TwoInputExternalIntegrationModule	util	Executes external commands, allows for 2 inputs
Upsample	util	Insert (n-1) zeros between samples
Window	util	Applies specified window type to 1Darray/vector
Zeropad	util	Zeropads input 1Darray/vector
Histogram	vis	Plots a histogram of input data

Package	Number of Modules
evaluation	18
filters	4
io	37
math	37
modelling	18
my_modules	1
testing	5
transforms	12
util	41
vis	1
Total	174

ITINERARIES	DESCRIPTION
DecisionTree-C45	Creates a Decision Tree Model
DEMO-1stOrderEnergyDifferenceOnsetDetection	Determines note onset times in an input audio file, and generates visualizations for various derived note onset data
DEMO-FeatureExtractionToC45DT	Demonstrates audio feature extraction from .wav files belonging to three different classes. Classification is then performed using a D2K core C4.5 decision tree.
DEMO-FeatureExtractionToFile	Demonstrates audio feature extraction from .wav files belonging to three different classes, and outputs the features to a file.
DEMO-FeatureExtractionToNaiveBayes	Demonstrates audio feature extraction from .wav files belonging to three different classes. Classification is then performed using a D2K core Naïve Baysian model.
DEMO-FeatureExtractionToNeuralNet	Demonstrates audio feature extraction from .wav files belonging to three different classes. Classification is then performed using a D2K core Neural Net classifier.
DEMO-SignalGaussianMFCCClassification	Performs a single Gaussian classification of three classes using MFCC's as features
FeatureExtraction	Performs audio feature extraction on input Signal arrays
MFCCFromSignal	Calculates Mel-Frequency Cepstral Coefficients (MFCCs) for each Signal object in an input stream of Signal object arrays
NaiveBayes	Creates a Naive Bayes Model
NeuralNetwork	Creates a Neural Network Model

MIREX frameworks
ITINERARIES	FOLDERS	DESCRIPTION
MIREX05-ArtistIdentification1	Audio artist identification	Evaluates an artists identification algorithm which combines feature extaction, model training and classification in one module
MIREX05-ArtistIdentification1_MATLAB	Audio artist identification	Evaluates an artists identification algorithm written in MATLAB which combines feature extaction, model training and classification into one module
MIREX05-ArtistIdentification2	Audio artist identification	Evaluates an artists identification algorithm which has separate modules for feature extaction, model training and classification
MIREX05-ArtistIdentification2_MATLAB	Audio artist identification	Evaluates an artists identification algorithm written in MATLAB which has separate modules for feature extaction, model training and classification
MIREX05-ArtistIdentification3	Audio artist identification	Evaluates an artists identification algorithm which has one module for feature extaction and another for model training and classification
MIREX05-ArtistIdentification3_MATLAB	Audio artist identification	Evaluates an artists identification algorithm written in MATLAB which has one module for feature extaction and another for model training and clasombines feature extaction, model training and classification in one module
Audio genre classification marsyas example itinerary	Audio genre classification	Example itinerary evaluating an audio genre classification algorithm written in external programs, taking Marsyas as an example
Genre identification evaluator test itinerary	Audio genre classification	Evaluates an audio genre classification algorithm, given ground truth and classification results in text files
MIREX05-GenreIdentification1	Audio genre classification	Evaluates an audio genre classification algorithm which combines feature extaction, model training and classification in one module
MIREX05-GenreIdentification1_MATLAB	Audio genre classification	Evaluates an audio genre classification algorithm written in MATLAB which combines feature extaction, model training and classification in one module
MIREX05-GenreIdentification2	Audio genre classification	Evaluates an audio genre classification algorithm which has separate modules for feature extaction, model training and classification
MIREX05-GenreIdentification2_MATLAB	Audio genre classification	Evaluates an audio genre classification algorithm written in MATLAB which has separate modules for feature extaction, model training and classification
MIREX05-GenreIdentification3	Audio genre classification	Evaluates an audio genre classification algorithm which has one module for feature extaction and another for model training and classification
MIREX05-GenreIdentification3_MATLAB	Audio genre classification	Evaluates an audio genre classification algorithm written in MATLAB which has one module for feature extaction and another for model training and classification
Key finding evaluation test itinerary	Audio key finding	Evaluates key finding algorithms, given ground truth and key detection results in text files
MIREX05-KeyDetectionEvaluation	Audio key finding	Evaluates a key finding algorithm
MIREX05-KeyDetectionEvaluation_MATLAB	Audio key finding	Evaluates a key finding algorithm written in MATLAB
Audio tempo extraction evaluation test itinerary	Audio tempo extraction	Evaluates audio tempo extraction results, given ground truth and extraction results in text files
MIREX05-AudioTempoExtraction	Audio tempo extraction	Evaluates an audio tempo extraction algorithm
MIREX05-AudioTempoExtraction_MATLAB	Audio tempo extraction	Evaluates an audio tempo extraction algorithm written in MATLAB
Drum transcription evaluator test itinerary1	Drum transcription	Evaluates drum transcription results, given ground truth and drum transcription results in text files
Drum transcription evaluator test itinerary2	Drum transcription	same as above, but with different drum transcription results as input
Drum transcription evaluator test itinerary3	Drum transcription	same as above, but with different drum transcription results as input
Drum transcription evaluator test itinerary4	Drum transcription	same as above, but with different drum transcription results as input
MIREX05-DrumDetectionEvaluation	Drum transcription	Evaluates a drum detection algorithm
MIREX05-DrumDetectionEvaluation_MATLAB	Drum transcription	Evaluates a drum detection algorithm written in MATLAB
Marsyas audio genre classificaiton example	Example submissions	An example of Evaluating an audio genre classification algorithm written in external programs
Matlab audio genre classification example	Example submissions	An example of Evaluating an audio genre classification algorithm written in external programs
Melodic similarity evaluation test itinerary	Melodic similarity	Evaluates symbolic melody similarity results, given ground truth and symbolic similarity results in text files
MIREX05-MelodicSimilarityEvaluation	Melodic similarity	Evaluates a symbolic melody similarityl algorithm
MIREX05-MelodicSimilarityEvaluation_MATLAB	Melodic similarity	Evaluates a symbolic melody similarityl algorithm written in MATLAB
Melody extraction evaluator test itinerary	Melody extraction	Evaluates melody extraction results, given ground truth and drum transcription results in text files
MIREX05-MelodyExtractionEvaluation	Melody extraction	Evaluates a melody extraction algorithm
MIREX05-MelodyExtractionEvaluation_MATLAB	Melody extraction	Evaluates a melody extraction algorithm written in MABLAB
Onset detection evaluator test itinerary	onset detection	Evaluates onset detection results, given ground truth and onset detection results in text files
MIREX05-OnsetDetectionEvaluation	onset detection	Evaluates a onset detection algorithm
MIREX05-OnsetDetectionEvaluation_MATLAB	onset detection	Evaluates a onset detection algorithm written in MATLAB
Audio genre classification marsyas example	Symbolic genre classification	Evaluates a genre classification algorithm written in external programs, taking Marsyas as an example
Genre identification evaluator test itinerary	Symbolic genre classification	Evaluates a genre classification algorithm, given ground truth and classification results in text files
MIREX05-GenreIdentification1	Symbolic genre classification	Evaluates a symbolic genre classification algorithm written in MATLAB which combines feature extaction, model training and classification in one module
MIREX05-GenreIdentification1_MATLAB	Symbolic genre classification	Evaluates a symbolic genre classification algorithm written in MATLAB which combines feature extaction, model training and classification in one module
MIREX05-GenreIdentification2	Symbolic genre classification	Evaluates a symbolic genre classification algorithm which has separate modules for feature extaction, model training and classification
MIREX05-GenreIdentification2_MATLAB	Symbolic genre classification	Evaluates a symbolic genre classification algorithm written in MATLAB which has separate modules for feature extaction, model training and classification
MIREX05-GenreIdentification3	Symbolic genre classification	Evaluates a symbolic genre classification algorithm which has one module for feature extaction and another for model training and classification
MIREX05-GenreIdentification3_MATLAB	Symbolic genre classification	Evaluates a symbolic genre classification algorithm written in MATLAB which has one module for feature extaction and another for model training and classification
Key finding evaluator test itinerary	Symbolic key finding	Evaluates key finding results, given ground truth and key detection results in text files
MIREX05-KeyDetectionEvaluation	Symbolic key finding	Evaluates a key finding algorithm
MIREX05-KeyDetectionEvaluation_MATLAB	Symbolic key finding	Evaluates a key finding algorithm written in MATLAB

Folders	Number of Itineraries
stand alone	11
MIREX frameworks/Audio artist identification	6
MIREX frameworks/Audio genre classification	8
MIREX frameworks/Audio key finding	3
MIREX frameworks/Audio tempo extraction	3
MIREX frameworks/Drum transcription	6
MIREX frameworks/Example submissions	2
MIREX frameworks/Melodic similarity	3
MIREX frameworks/Melody extraction	3
MIREX frameworks/onset detection	3
MIREX frameworks/Symbolic genre classification	8
MIREX frameworks/Symbolic key finding	3
Total	48

Maintained by: J. Stephen Downie
Comments to: jdownie at uiuc dot edu
Last modified: 27 October 2005