EXPERIMENT               package:FKBL               R Documentation

_M_a_k_e_s _a_n _E_X_P_E_R_I_M_E_N_T

_D_e_s_c_r_i_p_t_i_o_n:

     This eases the realization of an experiment. It takes a dataset,
     and divides it in several parts or "chunks". It uses by turns each
     chunk as the test set and the rest of the dataset as train set, to
     make an experiment with all single objective  learning and
     tweaking algorithms. This means that, if a dataset is divided in
     10 chunks, it makes the whole experiment 10 times, each of them
     with a different test set.

_U_s_a_g_e:

      EXPERIMENT(data,chunks=10, initchunk=1, numPart=5, 
             execute=NULL, 
             errorfunc=NULL,
             trainfunc=NULL,
             testfunc=NULL,
             inferencefunc=NULL,
             iteraA=1000, e=0.01,
             iteraR=1000, etaMore=0.001, etaLess=0.1, 
             P=NULL, genS=100, crossS=0.5, mutaS=0.01, kS=0.01, 
             pobS=20, mutaP=0.8, crossP=0.9, genP=50, 
             crossH=0.9, mutaH=0.8, genH=50, replaceH=2,
             crossM=0.9, mutaM=0.01, genM=1000)

_A_r_g_u_m_e_n_t_s:

     Takes the train data, the number of chunks, the initial chunk, the
     number of divisions  of a partition, the vector of activations of
     algorithms, the error function, the train function, the inference
     function, the numbers of  iterations, e, etaMore, etaLess, the
     list of partitions, cross and mutation  probability for
     PittsBurgh,the number of generations for PittsBurgh, the number 
     of generations of the ErrorSize algorithm, the cross and mutation
     probability for ErrorSize,  the weight for the Size in ErrorSize,
     the size of the initial population in ErrorSize, cross and
     mutation probability for Hybrid, cross and mutation probability
     for Michigan, the generations for Hybrid and the generations for
     Michigan.

    data: The train dataset, this is the only argument which must be
          supplied, the rest are optional.

  chunks: The number of chunks for getTrain and getTest.

initchunk: The initial chunk to be processed.

 numPart: The number of divisions for the getPart algorithm.

 execute: The vector of activations for the algorithms, here it is
          possible to determinate which algorithms are executed. If
          none is provided, a default one with all algorithms activated
          is created.

errorfunc: The error function to be used. If none is provided the
          default one is used. The function provided must respect the
          original function input format.

trainfunc: The function to obtain a train set from the actual problem.
          If none is provided the default one is used.  The function
          provided must respect the original function input format.

testfunc: The function to obtain a test set from the actual problem. If
          none is provided the default one is used.

inferencefunc: The inference function to be used. If none is provided
          the default one is used. The function provided must respect
          the original function input format.

  iteraA: The number of iterations for analytic.

  iteraR: The number of iterations for rewardPunishment.

       e: The e parameter for analytic.

 etaMore: The etaMore parameter for rewardPunishment.

 etaLess: The etaLess parameter for rewardPunishment.

       P: The vector of partitions, if none is given one is created
          with getPart.

   mutaP: The mutation probability in the PittsBurgh algorithm.

  crossP: The cross probability in the PittsBurgh algorithm.

    genP: The number of generations in the PittsBurgh algorithm.

    genS: The number of generations in the ErrorSize algorithm.

  crossS: The crossing probability in the ErrorSize algorithm.

   mutaS: The mutation probability in the ErrorSize algorithm.

      kS: The weight of the size in the ErrorSize algorithm.

    pobS: Size of the initial population for ErrorSize.

  crossH: The cross probability up to 1, at Hybrid.

   mutaH: The mutation probability up to 1, at Hybrid.

  crossM: The cross probability up to 1, at Michigan.

   mutaM: The mutation probability up to 1, at Michigan.

    genH: The number of Hybrid generations.

replaceH: The number of individuals to replace.

    genM: The number of Michigan generations.

_V_a_l_u_e:

     Returns a list, with the knowledge bases, the inferred classes,
     and the test errors. The structure of the list is this:

     list(e=error, k=kBs, c=classes)

     e is for error, KbS is for knowledge Bases and c is for classes.

_E_x_a_m_p_l_e_s:

      data(trainM)
      print(trainM)
      out<-EXPERIMENT(trainM)

      #Shows the actual results, and its mean
      print(out$e)
      print(mean(out$e))

      #Shows the graphical boxplot
      boxplot(out$e)

