Among most popular off-the-shelf machine learning packages available to R,
caret ought to stand out for its consistency. It reaches out to a wide range of dependencies that deploy and support model building using a uniform, simple syntax. I have been using
caret extensively for the past three years, with a precious partial least squares (PLS) tutorial in my track record.
A couple of years ago, the creator and maintainer of
caret Max Kuhn joined RStudio where he has contributing new packages to the ongoing tidy-paranoia – the supporting
rsample and many other packages that are part of the
tidyverse paradigm and I knew little about. As it happens,
caret is now best used with some of these. As an aspiring data scientist with fashionable hex-stickers on my laptop cover and a tendency to start any sentence with ‘big data’, I set to learn
tidyverse and going Super Mario using pipes (
%>%, Ctrl + Shift + M).
Overall, I found the ‘tidy’ approach quite enjoyable and efficient. Besides streamlining model design in a sequential manner,
recipes and the accompanying ‘tidy’ packages fix a common problem in the statistical learning realm that curtails predictive accuracy, data leakage. You can now generate a ‘recipe’ that lays out the plan for all the feature engineering (or data pre-processing, depending on how many hex-stickers you have) and execute it separately for validation and resampling splits (i.e. split first, process later), thus providing a more robust validation scheme. It also enables recycling any previous computations afterwards.
I drew a lot of inspiration from a webinar and a presentation from Max himself to come up with this tutorial. Max is now hands-on writing a new book, entitled Feature Engineering and Selection: A Practical Approach for Predictive Models that will include applications of
caret supported by
recipes. I very much look forward to read it considering he did a fantastic job with Applied Predictive Modeling.
The aim here is to test this new
caret framework on the DREAM Olfaction Prediction Challenge, a crowd-sourced initiative launched in January 2015. This challenge demonstrated predictive models can identify perceptual attributes (e.g. coffee-like, spicy and sweet notes) in a collection of fragrant compounds from physicochemical features (e.g. atom types). The findings were condensed into a research article  that reports an impressive predictive accuracy for a large number of models and teams, over various perceptive attributes. Perhaps more impressive yet, is the fact it anticipates the very scarce knowledge of human odour receptors and their molecular activation mechanisms. Our task, more concretely, will be to predict population-level pleasantness of hundreds of compounds from physicochemical features, using the training set of the competition.
Finally, a short announcement. Many people have been raising reproducibility issues with previous entries, due to either package archiving (e.g.
GenABEL, for genetic mapping) or cross-incompatibility (e.g.
caret, for PLS). There were easy fixes for the most part, but I have nevertheless decided to start packing scripts together with
sessionInfo() reports in unique GitHub repositories. The bundle for this tutorial is available under https://github.com/monogenea/olfactionPrediction. I hope this will help track down the exact package versions and system configurations I use, so that anyone can anytime fully reproduce these results. No hex-stickers required!
The DREAM Olfaction Prediction Challenge
The DREAM Olfaction Prediction Challenge training set consists of 338 compounds characterised by 4,884 physicochemical features (the design matrix), and profiled by 49 subjects with respect to 19 semantic descriptors, such as ‘flower’, ‘sweet’ and ‘garlic’, together with intensity and pleasantness (all perceptual attributes). Two different dilutions were used per compound. The perceptual attributes were given scores in the 0-100 range. The two major goals of the competition were to use the physicochemical features in modelling i) the perceptual attributes at the subject-level and ii) both the mean and standard deviation of the perceptual attributes at the population-level. How ingenious it was to model the standard deviation, the variability in how something tastes to different people! In the end, the organisers garnered important insights about the biochemical basis of flavour, from teams all over the world. The resulting models were additionally used to reverse-engineer nonexistent compounds from target sensory profiles – an economically exciting prospect.
According to the publication, the top-five best predicted perceptual attributes at the population-level (i.e. mean values across all 49 subjects) were ‘garlic’, ‘fish’, ‘intensity’, pleasantness and ‘sweet’ (cf. Fig. 3A in ), all exhibiting average prediction correlations of , far greater than the average subject-level predictions (cf. Fig. 2D in ). This should come as no surprise since averaging over subjects is more likely to flesh out universal mechanisms. This averaging also helps stabilising the subject-level variance – no subject will necessarily utilise the full 0-100 scoring range; some will tend to use narrow intervals (low variance) while some will use the whole range instead (high variance).
Since pleasantness is one of the most general olfactory properties, I propose modelling the population-level median pleasantness of all compounds, from all physicochemical features. The median, as opposed to the mean, is less sensitive to outliers and an interesting departure from the original approach we can later compare against.
Let’s get started with R
We can start off by loading all the necessary packages and pulling the data directly from the DREAM Olfaction Prediction GitHub repository. More specifically, we will create a directory called
data and import both the profiled perceptual attributes (
TrainSet.txt) and the physicochemical features that comprise our design matrix (
molecular_descriptors_data.txt). Because we are tidy people, we will use
readr to parse these as tab-separated values (TSV). I also suggest re-writing the column name
Compound Identifier in the sensory profiles into
CID, to match with that from the design matrix
Next, we filter compounds that are common to both datasets and reorder them accordingly. The profiled perceptual attributes span a total of 49 subjects, two different dilutions and some replications (cf. Fig. 1A in ). Determine the median pleasantness (i.e.
VALENCE/PLEASANTNESS) per compound, across all subjects and dilutions while ignoring missingness with
na.rm = T. The last line will ensure the order of the compounds is identical between this new dataset and the design matrix, so that we can subsequently introduce population-level pleasantness as a new column termed
Y in the new design matrix
X. We no longer need
CID so we can discard it.
Regarding missingness, I found maxima of 0.006% and 23% NA content over all columns and rows, respectively. A couple of compounds could be excluded but I would move on.
In examining the structure of the design matrix, you will see there are many skewed binary variables. In the most extreme case, if a binary predictor is either all zeros or all ones throughout it is said to be a zero-variance predictor that if anything, will harm the model training process. There is still the risk of having near-zero-variance predictors, which can be controlled based on various criteria (e.g. number of samples, size of splits). Of course, this can also impact quantitative, continuous variables. Here we will use
caret to identify faulty predictors that are either zero-variance or display values whose frequency exceeds a predefined threshold. Having a 5x repeated 5-fold cross-validation in mind, I suggest setting
freqCut = 4, which will rule out i) binary variables with , and ii) continuous variables with . See
?nearZeroVar for more information. From 4,870 features we are left with 2,554 – a massive reduction by almost a half.
Now we will use
rsample to define the train-test and cross-validation splits. Please use
set.seed as it is, to ensure you will generate the same partitions and arrive to the same results. Here I have allocated 10% of the data to the test set; by additionally requesting stratification based on the target
Y, we are sure to have a representative subset. We can next pass the new objects to
testing to effectively split the design matrix into train and test sets, respectively. The following steps consist of setting up a 5x repeated 5-fold cross-validation for the training set. Use
vfold_cv and convert the output to a
caret-like object via
rsample2caret. Next, initialise a
trainControl object and overwrite
indexOut using the corresponding elements in the newly converted
Prior to modelling, I will create two reference variables –
binVars, to identify binary variables, and
missingVars, to identify any variables containing missing values. These will help with i) excluding binary variables from mean-centering and unit-variance scaling, and ii) restricting mean-based imputation to variables that do contain missing values, respectively.
Recipes are very simple in design. The call to
recipe is first given the data it is supposed to be applied on, as well as a
lm-style formula. The
recipes package contains a family of functions with a
step_... prefix, involved in encodings, date conversions, filters, imputation, normalisation, dimension reduction and a lot more. These can be linked using pipes, forming a logic sequence of operations that starts with the
recipe call. Supporting functions such as
all_nominal delineate specific groups of variables at any stage in the sequence. One can also use the names of the variables, akin to my usage of
I propose writing a basic recipe
myRep that does the following:
- Yeo-Johnson  transformation of all quantitative predictors;
- Mean-center all quantitative predictors;
- Unit-variance scale all quantitative predictors;
- Impute missing values with the mean of the incident variables.
In brief, the Yeo-Johnson procedure transforms variables to be distributed as Gaussian-like as possible. Before delving into the models let us tweak the recipe and assign it to
pcaRep, conduct a principal component analysis and examine how different compounds distribute along the first two principal components. Colour them based on their population-level pleasantness – red for very pleasant, blue for very unpleasant and the gradient in between, via
The compounds do not seem to cluster into groups, nor do they clearly separate with respect to pleasantness.
pcaRep itself is just a recipe on wait. Except for recipes passed to
caret::train, to process and extract the data as instructed you need to either ‘bake’ or ‘juice’ the recipe. The difference between the two is that ‘juicing’ outputs the data associated to the recipe (e.g. the training set), whereas ‘baking’ can be applied to process any other dataset. ‘Baking’ is done with
bake, provided the recipe was trained using
prep. I hope this explains why I used
Next we have the model training. I propose training five regression models – k-nearest neighbours (KNN), elastic net (ENET), support vector machine with a radial basis function kernel (SVM), random forests (RF), extreme gradient boosting (XGB) and Quinlan’s Cubist (CUB) – aiming at minimising the root mean squared error (RMSE). Note I am using
tuneLength interchangeably. I rather supply predefined hyper-parameters to simple models I am more familiar with, and run the rest with a number of defaults via
Parallelise the computations if possible. Because I use macOS, I picked
registerDoMC from the
doMC package to harness multi-threading of the training procedure. Please use a library compatible with your OS. To the best of my knowledge,
doMC will also work in Linux but Windows users might need to use the
doParallel package instead.
Once the training is over, we can compare the optimal five cross-validated models based on their RMSE across all resamples, using some
bwplot magic sponsored by
lattice. In my case the runtime was unusually long (>3 hours) compared to the old
The cross-validated RSME does not vary considerably across the six optimal models. To conclude, I propose creating a model ensemble by simply taking the average predictions of all six optimal models on the test set, to compare observed and predicted population-level pleasantness in this hold-out subset of compounds.
The ensemble fit on the test set is not terrible – slightly underfit, predicting the poorest in the two extremes of the pleasantness range. All in all, it attained a prediction correlation of , which is slightly larger than the mean reported (cf. Fig. 3A in ). However, note that there are only 31 compounds in the test set. A model like this could be easily moved into production stage or repurposed to solve a molecular structure from a sensory profile of interest, as mentioned earlier.
caret framework is still under development, but it seems to offer
- A substantially expanded, unified syntax for models and utils. Keep an eye on
textrecipes, an upcoming complementary package for processing textual data;
- A sequential streamlining of extraction, processing and modelling, enabling recycling of previous computations;
- Executing-after-splitting, thereby precluding leaky validation strategies.
On the other hand, I hope to see improvements in
- Decoupling from proprietary frameworks in the likes of
tidyverse, although there are alternatives;
- The runtime. I suspect the recipes themselves are the culprit, not the models. Future updates will certainly fix this.
Regarding the DREAM Olfaction Prediction Challenge, we were able to predict population-level perceived pleasantness from physicochemical features with an accuracy as good as that achieved, in average, by the competing teams. Our model ensemble seems underfit, judging from the narrow range of predicted values. Maybe we could be less restrictive about the near-zero-variance predictors and use a repeated 3-fold cross-validation.
I hope you had as much fun as I did in dissecting a fascinating problem while unveiling a bit of the new
caret. You can use this code as a template for exploring different recipes and models. If you encounter any problems or have any questions do not hesitate to post a comment underneath – we all learn from each other!
 Keller, Andreas et al. (2017). Predicting human olfactory perception from chemical features of odor molecules. Science, 355(6327), 820-826.
 Yeo, In-Kwon and Johnson, Richard (2000). A new family of power transformations to improve normality or symmetry. Biometrika, 87(4), 954-959.