Remove predict_single max_models

docs/BoostAODE.md

@@ -1,12 +1,12 @@
 # BoostAODE Algorithm Operation
 
-The algorithm is based on the AdaBoost algorithm with some new proposals that can be activated using the following hyperparameters.
+## Algorithm
 
 ## Hyperparameters
 
 The hyperparameters defined in the algorithm are:
 
-- ***repeatSparent*** (*boolean*): Allows dataset variables to be repeated as parents of an *SPODE*. Default value: *false*.
+- ***bisection*** (*boolean*): If set to true allows the algorithm to add *k* models at once (as specified in the algorithm) to the ensemble. Default value: *false*.
 
 - ***maxModels*** (*int*): Maximum number of models (*SPODEs*) to build. This hyperparameter is only taken into account if ***repeatSparent*** is set to *true*. Default value: *0*.
 
@@ -14,7 +14,7 @@ The hyperparameters defined in the algorithm are:
 
 - ***convergence*** (*boolean*): Sets whether the convergence of the result will be used as a termination condition. If this hyperparameter is set to true, the training dataset passed to the model is divided into two sets, one serving as training data and the other as a test set (so the original test partition will become a validation partition in this case). The partition is made by taking the first partition generated by a process of generating a 5 fold partition with stratification using a predetermined seed. The exit condition used in this *convergence* is that the difference between the accuracy obtained by the current model and that obtained by the previous model is greater than *1e-4*; otherwise, one will be added to the number of models that worsen the result (see next hyperparameter). Default value: *false*.
 
-- ***tolerance*** (*int*): Sets the maximum number of models that can worsen the result without constituting a termination condition. Default value: *0*.
+- ***tolerance*** (*int*): Sets the maximum number of models that can worsen the result without constituting a termination condition. Default value: *0*. if ***bisection*** is set to *true*, the value of this hyperparameter will be exponent of base 2 to compute the number of models to insert at once.
 
 - ***select_features*** (*{"IWSS", "FCBF", "CFS", ""}*): Selects the variable selection method to be used to build initial models for the ensemble that will be included without considering any of the other exit conditions. Once the models of the selected variables are built, the algorithm will update the weights using the ensemble and set the significance of all the models built with the same &alpha;<sub>t</sub>. Default value: *""*.
 
@@ -26,8 +26,6 @@ The hyperparameters defined in the algorithm are:
 
 - ***predict_voting*** (*boolean*): Sets whether the algorithm will use *model voting* to predict the result. If set to false, the weighted average of the probabilities of each model's prediction will be used. Default value: *false*.
 
-- ***predict_single*** (*boolean*): Sets whether the algorithm will use single-model prediction in the learning process. If set to *false*, all models trained up to that point will be used to calculate the prediction necessary to update the weights in the learning process. Default value: *true*.
-
 ## Operation
 
 The algorithm performs the following steps:

docs/algorithm.md

@@ -0,0 +1,105 @@
+1. // initialization
+
+2. $W_0 \leftarrow (w_1, \dots, w_m) \leftarrow 1/m$
+
+3. $W \leftarrow W_0$
+
+4. $Vars \leftarrow {\cal{X}}$
+
+5. $\delta \leftarrow 10^{-4}$
+
+6. $convergence \leftarrow True$
+
+7. $maxTolerancia \leftarrow 3$
+
+8. $bisection \leftarrow False$
+
+9. $error \leftarrow \inf$
+
+10. $finished \leftarrow False$
+
+11. $AODE \leftarrow \emptyset$ // the ensemble
+
+12. $tolerance \leftarrow 0$
+
+13. $numModelsInPack \leftarrow 0$
+
+14.
+
+15. // main loop
+
+16. While (!finished)
+
+    1. $\pi \leftarrow SortFeatures(Vars, criterio, D[W])$
+
+    2. if $(bisection) \; k \leftarrow 2^{tolerance} \;$ else
+        $k \leftarrow 1$
+
+    3. if ($k tolerance == 0$) $W_B \leftarrow W$;
+        $numItemsPack \leftarrow0$
+
+    4. $P \leftarrow Head(\pi,k)$ // first k features in order
+
+    5. $spodes \leftarrow \emptyset$
+
+    6. $i \leftarrow 0$
+
+    7. While ($i < size(P)$)
+
+        1. $X \leftarrow P[i]$
+
+        2. $i \leftarrow i + 1$
+
+        3. $numItemsPack \leftarrow numItemsPack + 1$
+
+        4. $Vars.remove(X)$
+
+        5. $spode \leftarrow BuildSpode(X, {\cal{X}}, D[W])$
+
+        6. $\hat{y}[] \leftarrow spode.Predict(D[W])$
+
+        7. $e \leftarrow error(\hat{y}[], y[])$
+
+        8. $\alpha \leftarrow \frac{1}{2} ln \left ( \frac{1-e}{e} \right )$
+
+        9. if ($\alpha > 0.5$)
+
+            1. $finished \leftarrow True$
+
+            2. break
+
+        10. $spodes.add( (spode,\alpha_t) )$
+
+        11. $W \leftarrow UpdateWeights(D[W],\alpha,y[],\hat{y}[])$
+
+    8. $AODE.add( spodes )$
+
+    9. if ($convergence \And ! finished$)
+
+        1. $\hat{y}[] \leftarrow Predict(D,spodes)$
+
+        2. $e \leftarrow error(\hat{y}[], y[])$
+
+        3. if $(e > (error+\delta))$ // result doesn't improve
+
+            1. if
+                $(tolerance == maxTolerance) \;\; finished\leftarrow True$
+
+            2. else $tolerance \leftarrow tolerance+1$
+
+        4. else
+
+            1. $tolerance \leftarrow 0$
+
+            2. $error \leftarrow min(error,e)$
+
+    10. If $(Vars == \emptyset) \; finished \leftarrow True$
+
+17. if ($tolerance == maxTolerance$) // algorithm finished because of
+    lack of convergence
+
+    1. $removeModels(AODE, numItemsPack)$
+
+    2. $W \leftarrow W_B$
+
+18. Return $AODE$

docs/algorithm.tex

@@ -0,0 +1,69 @@
+\begin{enumerate}
+\item[] // initialization
+\item $W_0 \leftarrow (w_1, \dots, w_m) \leftarrow 1/m$
+\item $W \leftarrow W_0$
+\item $Vars \leftarrow {\cal{X}}$
+\item $\delta \leftarrow 10^{-4}$
+\item $convergence \leftarrow True$
+\item $maxTolerancia \leftarrow 3$
+\item $bisection \leftarrow False$
+\item $error \leftarrow \inf$ 
+\item $finished \leftarrow False$
+\item $AODE \leftarrow \emptyset$ \hspace*{2cm} // the ensemble
+\item $tolerance \leftarrow 0$
+\item $numModelsInPack \leftarrow 0$
+\item[] 
+\newpage
+\item[] // main loop
+\item While (!finished)
+\begin{enumerate}
+    \item $\pi \leftarrow SortFeatures(Vars, criterio, D[W])$
+    \item if $(bisection) \; k \leftarrow 2^{tolerance} \;$ else $k \leftarrow 1$
+    \item if ($k tolerance == 0$) $W_B \leftarrow W$; $numItemsPack \leftarrow0$
+    \item $P \leftarrow Head(\pi,k)$ \hspace*{2cm} //  first k features in order
+    \item $spodes \leftarrow \emptyset$
+    \item $i \leftarrow 0$
+    \item While ($ i < size(P)$)
+    \begin{enumerate}
+        \item $X \leftarrow P[i]$
+        \item $i \leftarrow i + 1$
+        \item $numItemsPack \leftarrow numItemsPack + 1$
+        \item $Vars.remove(X)$
+        \item $spode \leftarrow BuildSpode(X, {\cal{X}}, D[W])$
+        \item $\hat{y}[] \leftarrow spode.Predict(D[W])$
+        \item $e \leftarrow error(\hat{y}[], y[])$
+        \item $\alpha \leftarrow \frac{1}{2} ln \left ( \frac{1-e}{e} \right )$
+        \item if ($\alpha > 0.5$)
+        \begin{enumerate}
+            \item $finished \leftarrow True$
+            \item break
+        \end{enumerate}
+        \item $spodes.add( (spode,\alpha_t) )$
+        \item $W \leftarrow UpdateWeights(D[W],\alpha,y[],\hat{y}[])$
+    \end{enumerate}       
+    \item $AODE.add( spodes )$
+    \item if ($convergence \And ! finished$) 
+    \begin{enumerate}       
+        \item $\hat{y}[] \leftarrow Predict(D,spodes)$
+        \item $e \leftarrow error(\hat{y}[], y[])$
+        \item if $(e > (error+\delta))$ \hspace*{2cm} // result doesn't improve
+        \begin{enumerate}
+            \item if $(tolerance == maxTolerance) \;\; finished\leftarrow True$
+            \item else $tolerance \leftarrow tolerance+1$
+        \end{enumerate}
+        \item else
+        \begin{enumerate}
+            \item $tolerance \leftarrow 0$
+            \item $error \leftarrow min(error,e)$
+         \end{enumerate}
+    \end{enumerate}
+    \item If $(Vars == \emptyset) \; finished \leftarrow True$
+
+\end{enumerate}
+\item if ($tolerance == maxTolerance$) // algorithm finished because of lack of convergence
+\begin{enumerate}
+    \item $removeModels(AODE, numItemsPack)$
+    \item $W \leftarrow W_B$
+\end{enumerate}
+\item Return $AODE$
+\end{enumerate}