Class PolyKernel

  • All Implemented Interfaces:
    java.io.Serializable, CapabilitiesHandler, OptionHandler, RevisionHandler
    Direct Known Subclasses:
    MIPolyKernel, NormalizedPolyKernel

    public class PolyKernel
    extends CachedKernel
    The polynomial kernel : K(x, y) = <x, y>^p or K(x, y) = (<x, y>+1)^p

    Valid options are:

     -D
      Enables debugging output (if available) to be printed.
      (default: off)
     -no-checks
      Turns off all checks - use with caution!
      (default: checks on)
     -C <num>
      The size of the cache (a prime number), 0 for full cache and 
      -1 to turn it off.
      (default: 250007)
     -E <num>
      The Exponent to use.
      (default: 1.0)
     -L
      Use lower-order terms.
      (default: no)
    Version:
    $Revision: 9993 $
    Author:
    Eibe Frank (eibe@cs.waikato.ac.nz), Shane Legg (shane@intelligenesis.net) (sparse vector code), Stuart Inglis (stuart@reeltwo.com) (sparse vector code)
    See Also:
    Serialized Form
    • Constructor Detail

      • PolyKernel

        public PolyKernel()
        default constructor - does nothing.
      • PolyKernel

        public PolyKernel​(Instances data,
                          int cacheSize,
                          double exponent,
                          boolean lowerOrder)
                   throws java.lang.Exception
        Creates a new PolyKernel instance.
        Parameters:
        data - the training dataset used.
        cacheSize - the size of the cache (a prime number)
        exponent - the exponent to use
        lowerOrder - whether to use lower-order terms
        Throws:
        java.lang.Exception - if something goes wrong
    • Method Detail

      • clean

        public void clean()
        Frees the cache used by the kernel.
        Overrides:
        clean in class CachedKernel
      • globalInfo

        public java.lang.String globalInfo()
        Returns a string describing the kernel
        Specified by:
        globalInfo in class Kernel
        Returns:
        a description suitable for displaying in the explorer/experimenter gui
      • listOptions

        public java.util.Enumeration listOptions()
        Returns an enumeration describing the available options.
        Specified by:
        listOptions in interface OptionHandler
        Overrides:
        listOptions in class CachedKernel
        Returns:
        an enumeration of all the available options.
      • setOptions

        public void setOptions​(java.lang.String[] options)
                        throws java.lang.Exception
        Parses a given list of options.

        Valid options are:

         -D
          Enables debugging output (if available) to be printed.
          (default: off)
         -no-checks
          Turns off all checks - use with caution!
          (default: checks on)
         -C <num>
          The size of the cache (a prime number), 0 for full cache and 
          -1 to turn it off.
          (default: 250007)
         -E <num>
          The Exponent to use.
          (default: 1.0)
         -L
          Use lower-order terms.
          (default: no)
        Specified by:
        setOptions in interface OptionHandler
        Overrides:
        setOptions in class CachedKernel
        Parameters:
        options - the list of options as an array of strings
        Throws:
        java.lang.Exception - if an option is not supported
      • getOptions

        public java.lang.String[] getOptions()
        Gets the current settings of the Kernel.
        Specified by:
        getOptions in interface OptionHandler
        Overrides:
        getOptions in class CachedKernel
        Returns:
        an array of strings suitable for passing to setOptions
      • setExponent

        public void setExponent​(double value)
        Sets the exponent value.
        Parameters:
        value - the exponent value
      • getExponent

        public double getExponent()
        Gets the exponent value.
        Returns:
        the exponent value
      • exponentTipText

        public java.lang.String exponentTipText()
        Returns the tip text for this property
        Returns:
        tip text for this property suitable for displaying in the explorer/experimenter gui
      • setUseLowerOrder

        public void setUseLowerOrder​(boolean value)
        Sets whether to use lower-order terms.
        Parameters:
        value - true if lower-order terms will be used
      • getUseLowerOrder

        public boolean getUseLowerOrder()
        Gets whether lower-order terms are used.
        Returns:
        true if lower-order terms are used
      • useLowerOrderTipText

        public java.lang.String useLowerOrderTipText()
        Returns the tip text for this property
        Returns:
        tip text for this property suitable for displaying in the explorer/experimenter gui
      • toString

        public java.lang.String toString()
        returns a string representation for the Kernel
        Overrides:
        toString in class java.lang.Object
        Returns:
        a string representaiton of the kernel