Predictive Analytics
XLKitLearn's predictive analytics addin allows you to fit a range of predictive models in Excel. There are three main components of predictive analytic workflows in XLKitLearn:
 Specify the data to be used to train the predictive model; XLKitLearn can read data from the current Excel workbook, or pull data directly from a file.
 Describe the dependent and independent variables using a formula; XLKitLearn's formula language allows you to carry out variable transformations, automatically create dummies for categorical variables, and more.
 Select the predictive model to be used, together with any parameters required.
The predictive analytic addin also includes full support for training and test sets, parameter tuning using KFold crossvalidation, and inference on new datasets.
Selecting data
The simplest way to load data into XLKitLearn is to drag any sheets containing the data into the addin workbook.
Adding Sheets Containing Data
You should never move the addin sheet to another workbook. If your data sits in another Excel workbook, bring the sheet containing your data into the addin Excel workbook.
Once the data is in your workbook, click on the "Click to Select" button under "Training" in the addin dialogue, and select the entire dataset you will be using, including column headers. Hover here for a demo.
Column Names
The first row of your data should contain column names. There are a number of rules these column names must satisfy. They must contain only letters, numbers, and underscores  no spaces  and cannot start with a number. Column names also cannot be python reserved keywords or the word "intercept".
Reading data from files
When working with a very large dataset, opening it in Excel may slow down your computer. In fact, it may be altogether impossible if the dataset contains more rows than Excel can handle.
For these situations, XLKitLearn allows you to read data directly from a source file, without having to open it in Excel. After clicking on "Click to select", simply type the name of the file directly into the dialogue box. Hover here for a demo. The first row of the file should contain the column names (the same column name rules apply).
XLKit learn can read .csv files as well as .xlsx files; make sure to include the file extension (.csv or .xslx) when you specify the file name.
Specifying a Formula
In XLKitLearn, a formula specifies the outcome variable to be predicted (the dependent or 'y' variable) and the features that will be used to predict this variable (the independent or 'x' variables). The formula should be input into the formula box.
XLKitLearn formulas are always provided in the following format
dependent_variable ~ independent_variable_1 + independent_variable_2 + ...
Variables are referred to using the columns names in the data.
For example, suppose you are fitting a model on the Boston housing dataset provided with XLKitLearn, and that you want to predict the median house price using the crime per capita and the average number of rooms per dwelling. The formula would then be
median_property_value ~ crime_per_capita + av_rooms_per_dwelling
The Formula Editor
You can always type the formula into the formula box manually. To make things easier for you, XLKitLearn also includes a formula editor, which offers a number of helpful features. To launch the formula editor, click on the three dots next to the formula box.
The formula editor contains a list at the left of all the variables in the selected data (whether in Excel or in an external file). It also contains a larger textbox in which to type your formula.
The formula editor also supports autocomplete for quicker formula entry. As variable names are typed in the formula entry box, the list on the left is filtered down to variables that begin with those letters, and the first such variable is automatically suggested. Pressing the Tab key will complete the name of that variable. Hover here for a demo.
Variables Names in External Files
In the following circumstances, XLKitLearn will not be able to load variable names from the file and display them in the formula editor. (1) If you are loading a .xlsx file, XLKitLearn will not be able to open the file and read column names. (2) If you are on a Mac and loading an external file, Mac security settings will stop XLKitLearn from opening the file and reading column names.
If the formula you entered contains an error, the formula input box will turn red, and an error message will be displayed in the bottom part of the formula editor.
Advanced XLKitLearn Formulas
The formula language used by XLKitLearn also allows you to seamlessly transform variables in your data in a number of useful ways:

Creating categorical variables: When a variable needs to be treated as categorical (wikipedia reference), XLKitLearn can automatically create dummy variables (wikipedia reference) on the fly. Simply surround the variable with
C()
. For example, suppose you are fitting a model on the Boston housing dataset provided with XLKitLearn, and that you want to predict the median property value using the crime per capita and the highway accessibility treated as a categorical. The formula would bemedian_property_value ~ crime_per_capita + C(highway_accessibility)
A few notes. (a) When a variable is treated as categorical, dummies will always be created for every possible value of that variable. The first dummy (in alphabetical order) will then be dropped from the model. (b) Any column containing nonnumerical values will automatically be created as a categorical, with or without the
C()
around it. 
Standardizing variables: Surrounding any variable with
standardize()
will subtract the mean of that variable form every value in the column, and divide by its standard deviation. This can be particularly useful when comparing the size of coefficients in a linear regression. Note that when using training and test sets, this transformation will be done correctly; the mean of the training set will be used to standardize variables in the evaluation set. 
Including all variables: To include every variable in the data as independent variables in your model, simply use
~.
. For example, suppose you are fitting a model on the Boston housing dataset provided with XLKitLearn, and that you want to predict the median property value using every other variable in the data. The formula would then bemedian_property_value ~ .
Categorical Variables and ~.
As mentioned above under "Creating categorical variables", any column containing nonnumerical values that is explicitly named in the formula will automatically be treated as a categorical variable. This, however, is not true of variables that are implicitly included using ~.
. Therefore, if any of your columns contain nonnumerical values, using a ~.
will result in an error.

Including interaction terms: It is sometimes necessary to include an interaction term (wikipedia reference) in a predictive model. This is done using the
*
character. For example, suppose you are fitting a model on the Boston housing dataset provided with XLKitLearn, and that you want to predict the median property value using the interaction of crime per capita and highway accessibility. The formula would bemedian_property_value ~ crime_per_capita * highway_accessibility
Note the the
a*b
construction is shorthand fora + b + a x b
. In the example above, the model output would include both crime per capita and highway accessibility as dependent variables on their own, as well as the interaction term. 
Removing the intercept: An intercept will be added to the formula by default. Adding
1
at the end of the formula will remove the intercept. 
Applying Python functions: Any Python function can be used as part of a formula;
numpy
functions can be accessed usingnp.
. For example, suppose you are fitting a model on the Boston housing dataset provided with XLKitLearn, and that you want to predict the median property value using the crime per capita and the crime per capita squared. The formula would bemedian_property_value ~ crime_per_capita + np.power(crime_per_capita, 2)

Creating yes/no outcomes: XLKitLearn will automatically interpret any formula in which the outcome column contains only 0s and 1s as a classification task.
XLKitLearn also supports oneversusall classification models, in which an outcome column is converted to a 1 if it is equal to a certain value, and 0 otherwise. This is best illustrated by example. Suppose you are fitting a model on the Boston housing dataset provided with XLKitLearn, and that you want to predict whether the highway accessibility is equal to 4 or not using every other column in the data. You would use the following formula:
(highway_accessibility = 4) ~ .
The model will then interpret all rows in which highway accessibility is 4 as a '1' outcome, and '0' otherwise.
Nonnumeric Columns as dependent variables
Including a nonnumeric column as the dependent variable will return an error unless a yes/no outcome is created in this way.
Note that XLKitLearn's formulas leverage the Patsy Python library, which itself approximates Rstyle formulas. Any formula features available in Patsy can also be used in XLKitLearn. Some of the features described above, however, are not directly available in Patsy.
Specifying a Predictive Model
The final component of any predictive analytic workflow is the model that will be trained and used to make predictions. The model can be selected in the model dropdown.
Some predictive models require parameters to be specified. In those cases, the parameters can be specified in the parameter section, which will update to list the parameters required for the specific model selected. In addition, any parameters that are required (and cannot be left blank) will be highlighted in red.
Regression vs Classification
For each of its models, XLKitLearn supports both regression models (with continuous outcomes) and classification models (with 0/1 outcomes). XLKitLearn will automatically determine the type of model required  if the outcome column (as specified in the formula) only contains 0s and 1s, a classification model will be fit. Otherwise, a regression model will be fit.
Note that XLKitLearn does not currently support classification models with more than two possible outcomes. As described above, however, these can be converted into oneversusall classification models.
Supported Models
XLKitLearn supports the following models:

Linear and Logistic Regression: Depending on whether a regression or classification model is required, XLKitLearn will fit a linear regression (wikipedia reference) model or a logistic regression (wikipedia reference) on the data. XLKitLearn makes the following parameter(s) available for this model
 The Lasso penalty (wikipedia reference), which can be specified in one of three ways
 If it is left blank, XLKitLearn will assume it is equal to 0, and fit an unpenalized linear model.
 It can be set to a numerical value to specify the weight of the Lasso penalty in the model.
 If set to the special value
BS
, XLKitLearn will perform bestsubset selection, in which every possible combination of the variables provided will be tested against each other using Kfold cross validation. Note that this option is only available when the formula includes fewer than 10 variables.
 The Lasso penalty (wikipedia reference), which can be specified in one of three ways

KNearest Neighbors: A simple knearestneighbors (wikipedia reference) regressor or classifier will be fit on the data. XLKitLearn makes the following parameter(s) available for this model
 The number of neighbors, K
 The weighting to be used when averaging neighboring values. This parameter can take two possible values: 'uniform' (or 'u'), and 'distance' (or 'd'). In the case of uniform weighting, all neighbors will be weighted equally, and in the case of distance weighting, closer neighbors will be weighted more heavily and distant neighbors will be weighted less. If this field is left blank, uniform weighting will be used by default.

Decision Tree: A simple decision tree (wikipedia reference) will be fit using CART. The splitting criterion will be chosen based on whether a regression or classification model is required; the meansquarederror for the former, and the gini impurity for the latter. XLKitLearn makes the following parameter(s) available for this model
 The tree depth, which determines the maximum depth of the tree

Boosted Decision Tree: A boosted decision tree (wikipedia reference) fit using gradient boosting. XLKitLearn makes the following parameter(s) available for this model:
 The tree depth, which determines the maximum depth of each tree in the ensemble
 The maximum number of trees in the ensemble
 Boosted trees do not always continue improving as extra trees are added  after a certain point, performance drops. Thus, after fitting the number of trees specified by this parameter, XLKitLearn will automatically determine whether some smaller number of trees performs better on the leftout folds in Kfold cross validation. For this reason, boosted decision trees always need a value for K in the parameter tuning section of the addin, even when multiple parameters are not being compared against each other.
 The learning rate for the gradient boosting procedure

Random Forest: A random forest (wikipedia reference). XLKitLearn makes the following parameter(s) available for this model:
 The tree depth, which determines the maximum depth of each tree in the ensemble
 The number of trees in the ensemble
For specific details on how these models are implemented, see the generated Python code for each model  these generated pieces of code will illustrate how SciKitLearn packages are used to fit each of these models.
Parameter Tuning
XLKitLearn supports Kfold cross validation (wikipedia reference) for parameter tuning. The model that performs best on all the folds on average will be selected and fit on the entire data.
In particular, for any of the parameters described above, multiple values of the parameters can be compared against each other by specifying several values, separated by &
signs. For example, if you are fitting a decision tree and would like to compare trees of depth 2, 3, and 4, you should enter 2 & 3 & 4
in the "tree depth" parameter for the decision tree.
In addition to comparing multiple parameters against each other, you can also test multiple formulas against each other. For example, suppose you are fitting a model on the Boston housing dataset provided with XLKitLearn, and that you want to predict the median property value. To compare a model that makes this prediction using crime_per_capita
to one that makes this prediction using av_rooms_per_dwelling
, you would type the following formula into XLKitLearn:
median_property_value ~ crime_per_capita & median_property_value ~ av_rooms_per_dwelling
Comparing Two Formulas
Note that when comparing two formulas, the dependent variable (median_property_value
above) needs to be repeated for each formula. Additionally, all formulas being compared must have the same dependent variable.
XLKitLearn allows you to specify the number of folds to use; simply enter the number in the appropriate box.
Required Cross Validation
If your model requires crossvalidation (i.e., if you are testing multiple parameters or formulas against each other) but you do not specify the number of folds, the "folds" box will turn red to remind you this parameter is required. Remember that when fitting a boosted decision tree, crossvalidation is always required.
The folds will be split randomly, using the randomization seed provided in the addin.
Note that if multiple parameters are tuned (eg: tree depths of 1 and 2 and learning rates of 0.1 and 0.2 for a boosted tree), every combination of these parameters will be tested (tree depth of 1 and learning rate of 0.1, tree depth of 2 and learning rate of 0.1, tree depth of 1 and learning rate of 0.2, tree depth of 2 and learning rate of 0.2).
Training and Evaluation Sets
XLKitLearn is able to work with separate training and evaluation datasets. Evaluation datasets can be specified in the "Evaluation" section of the addin in a number of ways:
 No evaluation set: the entire training set will be used to train the model, and no evaluation set will be used.
 Automatically generate an evaluation set with __ % of the training data: the addin will shuffle the data, and randomly set aside a portion of the dataset to be used as an evaluation set on which to test the performance of the model. The randomization seed will determine the way the dataset is shuffled, so using this option multiple times with the same percentage and randomization seed will yield identical evaluation sets.
 Use a specific evaluation set: a specific dataset can be selected  using either method above  to be used as an evaluation dataset on which the model will be tested. Note that this evaluation dataset must satisfy one of two conditions  it must either (a) have the same number of columns as the original training dataset, and in the same order (b) must contains all the training columns used in the model, with the same column names.
Making Predictions on New Data
The "make predictions on new data" section allows inference to be carried out on new data. If a dataset is specified in this section, the highest performing model will be used to make predictions for the rows in that dataset.
As in the case with selecting an evaluation dataset manually, this dataset must satisfy one of two conditions  it must either (a) have the same number of columns as the original training dataset, and in the same order (b) must contains all the training columns used in the model, with the same column names.
The Randomization Seed
The randomization seed determines the choices XLKitLearn makes whenever randomization is required. This includes
 The random splitting of training data into training and test datasets
 The random splitting of training data into K folds for cross validation
 The randomness involved in fitting models (eg: the random features selected in each tree of a random forest)
If the addin is run twice with the same randomization seed, the results will be identical. This can be useful in a classroom setting, to ensure the entire class gets the same answer.
Understanding the Predictive Addin Output
The model output is dynamic based on the selected model and dataset. Depending on model type and parameters, not all of the following sections will be returned.
Parameter tuning
If the addin was asked to compare multiple parameters to each other using Kfold cross validation, this section will summarize the result of these comparison. Each row corresponds to one combination of parameters that were tested, and the table will contain the following columns:
 Row: the row number
 Insample score: the insample score for the model with the parameters specified in that row. If Kfolds are used, K different models will be fit (each on a training dataset comprising all the data minus one fold), the insample score for each of these K models will be calculated, and these scores will be averaged and listed in this column.
 Outofsample score: the outofsample score for the model with the parameters specified in that row. For each of the K models, the performance of these models will be calculated on the leftout fold, and these scores will be averaged and listen in this column.
 Outofsample SE: the standard error of the average outofsample score. This will be calculated by finding the standard deviation of the K outofsample scores, and dividing the results by the square root of K.
 The remaining columns of the table will contain the formula, and the relevant parameters being tested in that row. If a regression model is fit, the scores output will be Rsquared scores. If a classification model is fit, the scores output will be AUC scores (wikipedia reference).
Note that in two specific instances, there will be two additional columns included in this table:
 For boosted decision trees: an additional column called "Best number of trees". As discussed above, when a boosted decision tree ensemble is fit with a given maximum number of trees, the addin monitors the performance of the model as new trees are added, and stops when the performance starts to decline. This column specifies the number of trees at which the addin stopped, which is then used for the final model.
 For Lassopenalized linear models: an additional column called "Nonzero coefficients" will list the number of nonzero coefficients in the model when using this particular penalty.
Below this table, the addin will create a bar graph summarizing the results of parameter tuning  each bar will correspond to one row in the table, and display the outofsample score with error bars.
In addition, certain models will output additional graphs
 Penalized linear models (or bestsubset regressions): another graph will be created charting the optimal number of nonzero coefficients against the outofsample performance.
 Treebased ensemble models: a graph will be produced charting the outofsample performance as additional trees are added to the ensemble. One line will be produced for every row in the validation table.
Model
This section describes the final model that was fit on the entire training dataset. If multiple models were compared using Kfold cross validation, the model with the highest outofsample score will be refit on the entire training dataset and displayed here.
The specific details output about each model will depend on the model in question:
 Linear models: a table will list the coefficients of the model. If a simple linear model is fit with no crossvalidation or penalty, pvalues and confidence intervals will also be provided.
 Decision tree: for decision trees with fewer than four layers, a graphical representation of the tree will be output. For all trees, a textual representation of the tree will be output.
 Knearest neighbors and ensemble models: for these models, the permutation variable importance (scikitlearn reference) will be listed for each variable, in decreasing order of importance. In particular, each column will be randomly permuted a number of times, and the resulting drop in model performance will be calculated in each case. The greater the drop, the more important the variable. These values will also be graphed  each red dot represents the drop in performance for a given permutation, and the black star is the average of the red dots.
Note that for models with thousands of variables, this section might be rather large. If your application does not require these details, you can uncheck the "output model" box in the addin settings to omit it.
Model evaluation
If an evaluation set is selected using any of the methods described above, the best model selected above will be evaluated using this data. This section will contain the following:
 The outofsample score of the model, as evaluated on this dataset. If a regression model is fit, this will be an Rsquared score. If a classification model is fit, this will be an AUC score (wikipedia reference).
 An ROC curve will be output, if a classification model is fit.
 A table listing every row in the evaluation set, together with the row number in the original dataset, the true value of the dependent variable from that original dataset, and the predicted value using our model. If the evaluation set is large, this table will be output to a file in the same directory as the addin, and the name of the file will be listed here. If you application does not require this table, you can uncheck the "output evaluation dataset" box in the addin settings to omit it.
Model prediction
If the addin was asked to perform inference on a new dataset, this section will contain a table listing those predictions. All the caveats listed regarding the table in the previous section apply here too.
Equivalent Python Code
This section is XLKitLearn's crown jewel. It contains automatically generated Python code that will carry out analyses equivalent to those run by XLKitLearn.
The code in this section is not simply the code that the addin uses. It is dynamically generated to ensure maximal pedagogical impact. The simplest scikit learn function will always be used in this code, and plentiful comments will be included.
Note that:
 If the data was selected from a specific sheet in the Excel workbook, the generated Python code will attempt to pull the data from the same sheet. The Excel workbook has to be open for this to work.
 If the data was loaded from a file, the generated Python code will attempt to pull the data from the same file. The code must therefore be in the same directory as the file.
Technical details
The input settings that were used to run the analysis. These can be copied and pasted directly into the "Settings" cell in the addin tab to run the exact same analysis again, and can be useful to students who might want to replicate the analysis in a solutions spreadsheet.
Copying a Settings String
The settings string contains the name of the files and/or sheets containing the data used for the run. Thus, if copying the settings string to another device, the addin will only run successfully if those files and/or sheets exist on the new device.
Advanced Settings
A number of advanced settings are provided by XLKitLearn at the bottom of the addin sheet. These settings differ on PC and Mac computers.
PC Advanced Settings
Two settings are provided on a PC
 Keep an active Python connection: when this box in unchecked, XLKitLearn will launch Python every time the "run" button is pressed, and then terminate that Python instance when the run has completed. This means that every time the addin is run, relevant Python packages need to be loaded, which can be timeconsuming. When this box is checked, Python will be launched once, and not terminated at the end of the run. This will make future runs much faster.
 Run Python visibly to allow early termination: when this box is unchecked, XLKitLearn will run Python in the background, invisibly. If this box is checked, the the background process running Python will become visible, as a black window. The benefit of this window is that if the addin is taking too long to run or freeing your computer, you can simply close the black window to interrupt the process. If you do this, an error will pop up which you can just click out of to return to the addin.
Note that if the first option is selected to keep an active Python connection, Python will always be run visibly.
Active Python Connections with Lenghty Runs
One key downside of keeping an active Python connection is that if the run takes more than approximately a minute, the run will fail with an incomprehensible error. This arises because of a limitation in the way Excel connects to Python. If this happens, simply click out of the error, uncheck the "keep an active Python connection" box and attempt the run again.
Mac advanced settings
Mac users will see a button that will allow them to "Attempt to terminate python". Clicking this button will send a kill code to the Python running in the background and terminate it if the addin is taking too long to run. Note that after the button is pressed, it can take a few moments to interrupt the process.