jAudioFeatureExtractor.Aggregators
Class StandardDeviation

java.lang.Object
  extended by jAudioFeatureExtractor.Aggregators.Aggregator
      extended by jAudioFeatureExtractor.Aggregators.StandardDeviation

public class StandardDeviation
extends Aggregator

Standard Deviation

This generic aggregator calculates standard deviation of each feature dimension independently. It is one of the original aggregators used in MIR research, present in the original Marsyas (2000) by Tzanetakis and Cook.

Author:
Daniel McEnnis

Field Summary
 
Fields inherited from class jAudioFeatureExtractor.Aggregators.Aggregator
LINE_SEP
 
Constructor Summary
StandardDeviation()
          Constructs a new standard deviation aggregator.
 
Method Summary
 void aggregate(double[][][] values)
          Aggregates the values of the features specified by the init function accross all windows of the data recieved.
 java.lang.Object clone()
          Create a new aggregator of the same class
 FeatureDefinition getFeatureDefinition()
          Description of a particular instantiation of an aggregate.
 java.lang.String[] getFeaturesToApply()
          Provide a list of features that are to be aggregated by this feature.
 void init(int[] featureIndecis)
          Specifies which Features are to be extracted and the index of these features in the values array that will passed into the aggregate function
 void setSource(FeatureExtractor feature)
           
 
Methods inherited from class jAudioFeatureExtractor.Aggregators.Aggregator
calculateOffset, collapseFeatures, getAggregatorDefinition, getParamaters, getResults, outputACEFeatureKeyEntries, outputACEValueEntries, outputARFFHeaderEntries, outputARFFValueEntries, setParameters
 
Methods inherited from class java.lang.Object
equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 

Constructor Detail

StandardDeviation

public StandardDeviation()
Constructs a new standard deviation aggregator.

Method Detail

aggregate

public void aggregate(double[][][] values)
Description copied from class: Aggregator
Aggregates the values of the features specified by the init function accross all windows of the data recieved.

Overrides:
aggregate in class Aggregator
Parameters:
values - complete array of the extracted features. Indecis are window, feature, and then feature value.

clone

public java.lang.Object clone()
Description copied from class: Aggregator
Create a new aggregator of the same class

Overrides:
clone in class Aggregator

getFeatureDefinition

public FeatureDefinition getFeatureDefinition()
Description copied from class: Aggregator
Description of a particular instantiation of an aggregate. This should not be called until after the specific features have been specified by the init function.

Overrides:
getFeatureDefinition in class Aggregator
Returns:
Feature Definition describing this instantiation of this aggregate object

getFeaturesToApply

public java.lang.String[] getFeaturesToApply()
Description copied from class: Aggregator
Provide a list of features that are to be aggregated by this feature. Returning null indicates that this aggregator accepts only one feature and every feature avaiable should be used.

Overrides:
getFeaturesToApply in class Aggregator
Returns:
list of features to be used by this aggregator or null

init

public void init(int[] featureIndecis)
          throws java.lang.Exception
Description copied from class: Aggregator
Specifies which Features are to be extracted and the index of these features in the values array that will passed into the aggregate function

Overrides:
init in class Aggregator
Parameters:
featureIndecis - Indecis of these features in the array passed in aggregate
Throws:
java.lang.Exception - if either parameter is null, of dicffering lengths, or contain invalid index values.

setSource

public void setSource(FeatureExtractor feature)
Overrides:
setSource in class Aggregator