Class KernelEvaluation

  • All Implemented Interfaces:
    RevisionHandler

    public class KernelEvaluation
    extends java.lang.Object
    implements RevisionHandler
    Class for evaluating Kernels.
    Version:
    $Revision: 1.3 $
    Author:
    fracpete (fracpete at waikato dot ac dot nz)
    • Constructor Summary

      Constructors 
      Constructor Description
      KernelEvaluation()
      default constructor
    • Method Summary

      All Methods Static Methods Instance Methods Concrete Methods 
      Modifier and Type Method Description
      boolean equals​(java.lang.Object obj)
      Tests whether the current evaluation object is equal to another evaluation object
      static java.lang.String evaluate​(java.lang.String kernelString, java.lang.String[] options)
      Evaluates a kernel with the options given in an array of strings.
      static java.lang.String evaluate​(Kernel Kernel, java.lang.String[] options)
      Evaluates the Kernel with the given commandline options and returns the evaluation string.
      java.lang.String evaluate​(Kernel kernel, Instances data)
      Evaluates the Kernel with the given commandline options and returns the evaluation string.
      java.lang.String getRevision()
      Returns the revision string.
      java.lang.String[] getUserOptions()
      returns the options the user supplied for the kernel
      static void main​(java.lang.String[] args)
      A test method for this class.
      void setUserOptions​(java.lang.String[] options)
      sets the option the user supplied for the kernel
      java.lang.String toString()
      returns the current result
      java.lang.String toSummaryString()
      returns a summary string of the evaluation with a no title
      java.lang.String toSummaryString​(java.lang.String title)
      returns a summary string of the evaluation with a default title
      • Methods inherited from class java.lang.Object

        getClass, hashCode, notify, notifyAll, wait, wait, wait
    • Constructor Detail

      • KernelEvaluation

        public KernelEvaluation()
        default constructor
    • Method Detail

      • setUserOptions

        public void setUserOptions​(java.lang.String[] options)
        sets the option the user supplied for the kernel
        Parameters:
        options - options that were supplied for the kernel
      • getUserOptions

        public java.lang.String[] getUserOptions()
        returns the options the user supplied for the kernel
        Returns:
        the user supplied options for the kernel
      • evaluate

        public static java.lang.String evaluate​(Kernel Kernel,
                                                java.lang.String[] options)
                                         throws java.lang.Exception
        Evaluates the Kernel with the given commandline options and returns the evaluation string.
        Parameters:
        Kernel - the Kernel to evaluate
        options - the commandline options
        Returns:
        the generated output string
        Throws:
        java.lang.Exception - if evaluation fails
      • evaluate

        public static java.lang.String evaluate​(java.lang.String kernelString,
                                                java.lang.String[] options)
                                         throws java.lang.Exception
        Evaluates a kernel with the options given in an array of strings.
        Parameters:
        kernelString - class of kernel as a string
        options - the array of string containing the options
        Returns:
        a string describing the results
        Throws:
        java.lang.Exception - if model could not be evaluated successfully
      • evaluate

        public java.lang.String evaluate​(Kernel kernel,
                                         Instances data)
                                  throws java.lang.Exception
        Evaluates the Kernel with the given commandline options and returns the evaluation string.
        Parameters:
        kernel - the Kernel to evaluate
        data - the data to run the Kernel with
        Returns:
        the generated output string
        Throws:
        java.lang.Exception - if evaluation fails
      • equals

        public boolean equals​(java.lang.Object obj)
        Tests whether the current evaluation object is equal to another evaluation object
        Overrides:
        equals in class java.lang.Object
        Parameters:
        obj - the object to compare against
        Returns:
        true if the two objects are equal
      • toSummaryString

        public java.lang.String toSummaryString()
        returns a summary string of the evaluation with a no title
        Returns:
        the summary string
      • toSummaryString

        public java.lang.String toSummaryString​(java.lang.String title)
        returns a summary string of the evaluation with a default title
        Parameters:
        title - the title to print before the result
        Returns:
        the summary string
      • toString

        public java.lang.String toString()
        returns the current result
        Overrides:
        toString in class java.lang.Object
        Returns:
        the currently stored result
        See Also:
        toSummaryString()
      • getRevision

        public java.lang.String getRevision()
        Returns the revision string.
        Specified by:
        getRevision in interface RevisionHandler
        Returns:
        the revision
      • main

        public static void main​(java.lang.String[] args)
        A test method for this class. Just extracts the first command line argument as a kernel class name and calls evaluate.
        Parameters:
        args - an array of command line arguments, the first of which must be the class name of a kernel.