Class YGradientEPO

  • All Implemented Interfaces:
    Serializable, weka.core.CapabilitiesHandler, weka.core.CapabilitiesIgnorer, weka.core.CommandlineRunnable, weka.core.OptionHandler, weka.core.RevisionHandler, weka.filters.SupervisedFilter

    public class YGradientEPO
    extends weka.filters.SimpleBatchFilter
    implements weka.filters.SupervisedFilter
    Applies the External Parameter Orthogonalization (EPO) algorithm to the data.

    For more information see:
    http://wiki.eigenvector.com/index.php?title=Advanced_Preprocessing:_Multivariate_Filtering#External_Parameter_Orthogonalization_.28EPO.29

    Valid options are:

     -alpha <value>
      The alpha parameter. Defines how strongly GLSW downweights interferences. Larger values (> 0.001) decreases the filtering effect. Smaller values (< 0.001) increase the filtering effect.
      (default: 0.001)
     -N <value>
      The number of eigenvectors to keep.
      (default: 5)
     -output-debug-info
      If set, filter is run in debug mode and
      may output additional info to the console
     -do-not-check-capabilities
      If set, filter capabilities are not checked before filter is built
      (use with caution).
    Author:
    FracPete (fracpete at waikato dot ac dot nz)
    See Also:
    Serialized Form
    • Field Summary

      Fields 
      Modifier and Type Field Description
      protected com.github.waikatodatamining.matrix.algorithm.glsw.YGradientEPO m_Algorithm
      the EPO algorithm.
      protected double m_Alpha
      Alpha parameter.
      protected int m_N
      Number of eigenvectors to keep.
      • Fields inherited from class weka.filters.Filter

        m_Debug, m_DoNotCheckCapabilities, m_FirstBatchDone, m_InputRelAtts, m_InputStringAtts, m_NewBatch, m_OutputRelAtts, m_OutputStringAtts
    • Constructor Summary

      Constructors 
      Constructor Description
      YGradientEPO()  
    • Method Summary

      All Methods Static Methods Instance Methods Concrete Methods 
      Modifier and Type Method Description
      String alphaTipText()
      Returns the tip text for this property
      protected weka.core.Instances determineOutputFormat​(weka.core.Instances inputFormat)
      Determines the output format based on the input format and returns this.
      double getAlpha()
      Returns the alpha parameter.
      weka.core.Capabilities getCapabilities()
      Returns the Capabilities of this filter.
      protected double getDefaultAlpha()
      Returns the default algorithm.
      protected int getDefaultN()
      Returns the default algorithm.
      int getN()
      Returns the number of eigenvectors to keep.
      String[] getOptions()
      returns the options of the current setup
      String getRevision()
      Returns the revision string.
      String globalInfo()
      Returns a string describing this classifier.
      Enumeration<weka.core.Option> listOptions()
      Gets an enumeration describing the available options.
      static void main​(String[] args)
      runs the filter with the given arguments.
      String NTipText()
      Returns the tip text for this property
      protected weka.core.Instances process​(weka.core.Instances instances)
      Processes the given data (may change the provided dataset) and returns the modified version.
      void setAlpha​(double value)
      Set the alpha parameter.
      void setN​(int value)
      Sets the number of eigenvectors to keep.
      void setOptions​(String[] options)
      Parses the options for this object.
      • Methods inherited from class weka.filters.SimpleBatchFilter

        allowAccessToFullInputFormat, batchFinished, hasImmediateOutputFormat, input
      • Methods inherited from class weka.filters.SimpleFilter

        reset, setInputFormat
      • Methods inherited from class weka.filters.Filter

        batchFilterFile, bufferInput, copyValues, copyValues, debugTipText, doNotCheckCapabilitiesTipText, filterFile, flushInput, getCapabilities, getDebug, getDoNotCheckCapabilities, getInputFormat, getOutputFormat, initInputLocators, initOutputLocators, inputFormatPeek, isFirstBatchDone, isNewBatch, isOutputFormatDefined, makeCopies, makeCopy, mayRemoveInstanceAfterFirstBatchDone, numPendingOutput, output, outputFormatPeek, outputPeek, postExecution, preExecution, push, push, resetQueue, run, runFilter, setDebug, setDoNotCheckCapabilities, setOutputFormat, testInputFormat, toString, useFilter, wekaStaticWrapper
    • Field Detail

      • m_Alpha

        protected double m_Alpha
        Alpha parameter. Defines how strongly GLSW downweights interferences
      • m_N

        protected int m_N
        Number of eigenvectors to keep.
      • m_Algorithm

        protected com.github.waikatodatamining.matrix.algorithm.glsw.YGradientEPO m_Algorithm
        the EPO algorithm.
    • Constructor Detail

      • YGradientEPO

        public YGradientEPO()
    • Method Detail

      • globalInfo

        public String globalInfo()
        Returns a string describing this classifier.
        Specified by:
        globalInfo in class weka.filters.SimpleFilter
        Returns:
        a description of the classifier suitable for displaying in the explorer/experimenter gui
      • listOptions

        public Enumeration<weka.core.Option> listOptions()
        Gets an enumeration describing the available options.
        Specified by:
        listOptions in interface weka.core.OptionHandler
        Overrides:
        listOptions in class weka.filters.Filter
        Returns:
        an enumeration of all the available options.
      • getOptions

        public String[] getOptions()
        returns the options of the current setup
        Specified by:
        getOptions in interface weka.core.OptionHandler
        Overrides:
        getOptions in class weka.filters.Filter
        Returns:
        the current options
      • setOptions

        public void setOptions​(String[] options)
                        throws Exception
        Parses the options for this object.
        Specified by:
        setOptions in interface weka.core.OptionHandler
        Overrides:
        setOptions in class weka.filters.Filter
        Parameters:
        options - the options to use
        Throws:
        Exception - if the option setting fails
      • getDefaultAlpha

        protected double getDefaultAlpha()
        Returns the default algorithm.
        Returns:
        the default
      • setAlpha

        public void setAlpha​(double value)
        Set the alpha parameter. Defines how strongly GLSW downweights interferences. Larger values (> 0.001) decreases the filtering effect. Smaller values (< 0.001) increase the filtering effect.
        Parameters:
        value - Alpha parameter
      • getAlpha

        public double getAlpha()
        Returns the alpha parameter.
        Returns:
        alpha
      • alphaTipText

        public String alphaTipText()
        Returns the tip text for this property
        Returns:
        tip text for this property suitable for displaying in the explorer/experimenter gui
      • getDefaultN

        protected int getDefaultN()
        Returns the default algorithm.
        Returns:
        the default
      • setN

        public void setN​(int value)
        Sets the number of eigenvectors to keep.
        Parameters:
        value - the number
      • getN

        public int getN()
        Returns the number of eigenvectors to keep.
        Returns:
        the number
      • NTipText

        public String NTipText()
        Returns the tip text for this property
        Returns:
        tip text for this property suitable for displaying in the explorer/experimenter gui
      • determineOutputFormat

        protected weka.core.Instances determineOutputFormat​(weka.core.Instances inputFormat)
                                                     throws Exception
        Determines the output format based on the input format and returns this. In case the output format cannot be returned immediately, i.e., immediateOutputFormat() returns false, then this method will be called from batchFinished().
        Specified by:
        determineOutputFormat in class weka.filters.SimpleFilter
        Parameters:
        inputFormat - the input format to base the output format on
        Returns:
        the output format
        Throws:
        Exception - in case the determination goes wrong
        See Also:
        SimpleBatchFilter.hasImmediateOutputFormat(), SimpleBatchFilter.batchFinished()
      • getCapabilities

        public weka.core.Capabilities getCapabilities()
        Returns the Capabilities of this filter.
        Specified by:
        getCapabilities in interface weka.core.CapabilitiesHandler
        Overrides:
        getCapabilities in class weka.filters.Filter
        Returns:
        the capabilities of this object
        See Also:
        Capabilities
      • process

        protected weka.core.Instances process​(weka.core.Instances instances)
                                       throws Exception
        Processes the given data (may change the provided dataset) and returns the modified version. This method is called in batchFinished().
        Specified by:
        process in class weka.filters.SimpleFilter
        Parameters:
        instances - the data to process
        Returns:
        the modified data
        Throws:
        Exception - in case the processing goes wrong
        See Also:
        SimpleBatchFilter.batchFinished()
      • getRevision

        public String getRevision()
        Returns the revision string.
        Specified by:
        getRevision in interface weka.core.RevisionHandler
        Overrides:
        getRevision in class weka.filters.Filter
        Returns:
        the revision
      • main

        public static void main​(String[] args)
        runs the filter with the given arguments.
        Parameters:
        args - the commandline arguments