Despite their historical and conceptual importance, linear regression models often perform poorly relative to newer predictive modeling approaches from the machine learning literature like support vector machines, gradient boosting machines, or random forests. An objection frequently leveled at these newer model types is difficulty of interpretation relative to linear regression models, but *partial dependence plots* may be viewed as a graphical representation of linear regression model coefficients that extends to arbitrary model types, addressing a significant component of this objection. The DataRobot modeling engine is a massively parallel architecture for simultaneously fitting many models to a single dataset, providing a basis for comparing these models and selecting the most appropriate one for use, by any one of several different criteria. These models cover a wide range of types, including constrained and unconstrained linear regression models, machine learning models like the ones listed above, and ensemble models that combine the predictions of the most successful of these individual models in several different ways. This vignette illustrates the use of partial dependence plots to characterize the behavior of four very different models, all developed to predict the compressive strength of concrete from the measured properties of laboratory samples. These plots are based on predictions generated by the *R* package **datarobot**, which allows interactive *R* users to start new DataRobot modeling projects, collect the results, and generate predictions for any of these models from any dataset that is compatible with the original modeling dataset. A more detailed introduction to this *R* package is given in the companion vignette, "Introduction to the **DataRobot** *R* Package."

The DataRobot modeling engine is a commercial product that supports the rapid development and evaluation of a large number of different predictive models from a single data source. The open-source *R* package **datarobot** allows users of the DataRobot modeling engine to interact with it from *R*, creating new modeling projects, examining model characteristics, and generating predictions from any of these models for a specified dataset. This vignette describes an application of the **datarobot** package, demonstrating how *R* can be used to apply novel preprocessing of the DataRobot modeling data to obtain useful new insights. More specifically, Section 2 describes the creation of a DataRobot modeling project to predict concrete compressive strength from the characteristics of laboratory material samples. Modified modeling datasets are then used with the **datarobot** prediction functions to generate *partial dependence plots*, described in Section 3. These plots, proposed by @friedman01 as a useful adjunct to gradient boosting machines, can be constructed for any predictive model and they provide useful insight into the way model predictions depend on covariates, as shown in Section 4. Conceptually, these plots may be viewed as graphical extensions of simple linear regression model parameters to arbitrarily complex models without useful parametric descriptions.

As noted by @boukhatem12, concrete is a composite material widely used in the construction industry, typically consisting of cement, water, coarse aggregates, fine aggregates, and possibly other components like blast furnace slag, fly ash, silica fume, superplaticizers and air entraining agents. In fact, @chandwani14 characterize concrete as "one of the most widely used construction materials in the world today," further noting that:

The material modeling of concrete is a difficult task owing to its composite nature. Although various empirical relationships in the form of regression equations have been derived from experimental results and are widely in use, these do not provide accuracy and predictability wherein the interactions among the number of variables are either unknown, complex, or nonlinear in nature.''

To address these difficulties, Chandwani, Agrawal and Nagar explore the use of artificial neural networks as a more effective alternative to linear regression models. The following example considers a wider range of predictive model structures that includes a linear regression model and several machine learning models, both to demonstrate how much better some of these other models can perform, and to illustrate the use of the partial dependence plots advocated by @friedman01 in understanding the behavior of relatively complex models.

concreteFrame <- read.csv(system.file("extdata", "concreteData.csv", package = "datarobot"))

The results presented here are based on a concrete physical properties dataset provided by @yeh98 and available from a number of different sources. The version used here was constructed from the dataframe **ConcreteCompressiveStrength**, included in the *R* package **randomUniformForest** [@ciss15]. This dataframe characterizes `r nrow(concreteFrame)`

laboratory concrete samples, giving the compressive strength and age of each sample, along with seven compositional variables. Several of the variable names in this dataframe include embedded spaces, a potential source of subtle errors in some data manipulations, motivating the slightly modified dataframe considered here. As a specific example, the **StartProject** and **UploadPredictionDataset** functions in the **datarobot** package can both accept either dataframes or CSV files, but dataframes are first saved by these functions as CSV files, which are then uploaded to the modeling engine. If we write the dataframe **ConcreteCompressiveStrength** to a CSV file using *R's* **write.csv** function, the variable names are changed, with periods replacing the spaces. This mismatch in variable names between the dataframe and the CSV file can cause difficulties if we attempt to compare predictions from the DataRobot models with observed responses from the original dataframe. To avoid these problems, the analysis presented here is based on the dataframe **concreteFrame**, identical to **ConcreteCompressiveStrength** except with the following, somewhat simplified variable names:

```
str(concreteFrame)
```

This dataframe was used to create a DataRobot project as described in the vignette, "Introduction to the **DataRobot** *R* Package." The specific sequence used here was:

myDRProject <- StartProject(concreteFrame, "ConcreteProject", target = "strength", wait = TRUE)

library(datarobot) concreteModels <- readRDS("concreteModels.rds") fullFrame <- as.data.frame(concreteModels, simple = FALSE) modelsFrame <- as.data.frame(concreteModels)

Once the modeling process has completed, the **ListModels** function returns an S3 object of class "listOfModels" that characterizes all of the models in a specified DataRobot project.

concreteModels <- ListModels(myDRProject)

A **summary** method has been included in the **datarobot** package for "listOfModels" objects that gives a useful preview of the models included in a DataRobot modeling project:

```
summary(concreteModels)
```

The first element of this summary list, named **generalSummary**, tells us how many models are included in the **concreteModels** list, and the second element, named **detailedSummary**, contains the first 6 rows of the dataframe obtained from the **as.data.frame** method with its default parameters. For "listOfModels" objects, this method converts **concreteModels** into a dataframe with one row for each project model and the following columns:

**modelType**= a (relatively) short character string describing the model structure;**expandedModel**= the**modelType**character string, prepended with character strings describing the preprocessing steps applied, if any;**modelId**= unique alphanumeric model identifier;**blueprintId**= unique alphanumeric identifier for the DataRobot blueprint used in fitting the model: this identifier defines the structure of the model and its preprocessing;**featurelistName**= character string giving the name of the featurelist containing the features (e.g., columns of the modeling dataset) used in fitting all project models;**featurelistId**= unique alphanumeric identifier for the featurelist;**samplePct**= percentage of the training dataset used to fit the model;**validationMetric**= value of the metric used in fitting all project models, evaluated for the validation dataset.

Each element of the original S3 "listOfModels" object is itself an S3 object, of class "dataRobotModel", with its own **summary** method; these objects contain more model information than is included in the dataframe constructed above. Complete results can be obtained by calling the function **as.data.frame** with **simple = FALSE**. For the concrete modeling project considered here, the resulting dataframe has `r ncol(fullFrame)`

columns, versus the `r ncol(modelsFrame)`

described above.

poorCol <- c("black", "red", rep("black", 13)) plot(concreteModels, orderDecreasing = TRUE, selectRecords = seq(16, 30, 1), textColor = poorCol, xpos = 10, xlim = c(0, 18)) abline(v = min(modelsFrame$validationMetric), lty = 2, lwd = 2, col = "magenta")

Figures 1 and 2 are barplots summarizing the performance of the concrete predictive models, based on the RMSE values from **concreteModels**. This project includes `r length(concreteModels)`

models and, to make the details easier to see, each figure summarizes half of these models, with Figure 1 summarizing the 15 poorer-performing models and Figure 2 summarizing the 15 better-performing models. These plots were generated using the **plot** method included in the **datarobot** package for S3 objects of class "listOfModels". This method generates a horizontal barplot where the length of each bar is determined by the optional parameter **metric** and the text displayed on each bar in the plot is determined by the **modelType** value for each model. The default value for **metric** is **NULL**, which specifies that the **validationMetric** value from the summary dataframe is used, as in this example. The only required parameter is the S3 object; the four optional parameters used in this example have the following effects:

**orderDecreasing**, when**TRUE**, sorts the models in decreasing order of**metric**. Here, since**metric**has the default value**NULL**, models are sorted by decreasing**validationMetric**value, which is**RMSE.validation**for this example;**selectRecords**is a numeric vector specifying a subset of models to be included in the plot. In Figure 1, the poorer half of the models (ranked 16 through 30) are selected;**textColor**is a character vector of color names for the text labels in each barplot;**xpos**is a numerical value defining the horizontal center position of the text labels;**xlim**is passed to R's**barplot**function to specify the horizontal extent of the plot.

For a more detailed discussion of this plot method and its options, refer to the help file.

In both Figures 1 and 2, the vertical dashed line indicates the performance achieved by the ENET Blender discussed below, which exhibits the best overall performance. The poorest model shown in Figure 1 is the Mean Response Regressor, a trivial, intercept-only model included as a performance reference for all of the other models in the project. The project includes one unconstrained linear regression model (Linear Regression, indicated in red), and its performance is part of a four-way tie for second-worst place, together with three constrained linear regression models: two ridge regression models and one elastic net model. The difference between the two ridge regression models - and between these models and the other two, better-performing ridge regression models in the project - lies in their preprocessing. While this information is not shown in Figure 1, it is available from the **expandedModel** field of the project model list described above. For the four ridge regression models, we have the following results:

ridgeRows <- grep("Ridge", modelsFrame$modelType) modelsFrame[ridgeRows, c("expandedModel", "validationMetric")]

goodCol <- c(rep("black", 3), "red", rep("black", 6), "red", rep("black", 3), "red") plot(concreteModels, orderDecreasing = TRUE, selectRecords = seq(1, 15, 1), textColor = goodCol, xlim = c(0, 18), xpos = 10) abline(v = min(modelsFrame$validationMetric), lty = 2, lwd = 2, col = "magenta")

Figure 2 summarizes the performance of the other 15 models from the concrete compressive strength prediction project, in the same format as Figure 1. The four best models in the project appear at the top of this plot and are *blenders*, composite models that aggregate two or more of the best individual models from the project, differing in which of these models are included and how they are combined. It is clear from Figure 2 that these blenders exhibit essentially identical performance. The best performance is achieved by the ENET Blender, shown in red in Figure 2; two other models are also shown in red: Gradient Boosted Greedy Trees Regressor, the best non-blender model, and the better-performing of two Nystroem Kernel SVM Regressor models. As with the ridge regression models discussed above, the difference between these SVM models lies in the preprocessing applied in fitting each one. The partial dependence plots described in Section 3 are used in Section 4 to obtain insights into the performance differences between the four models highlighted in red in Figures 1 and 2.

In the case of linear regression, we can gain considerable insight into the structure and interpretation of the model by examining its coefficients. For more complex models like support vector machines, random forests, or the blenders considered here, no comparably simple parametric description is available, making the interpretation of these models more difficult. To address this difficulty for his gradient boosting machine, @friedman01 proposed the use of *partial dependence plots*. The rest of this section briefly describes these plots, and the following section demonstrates their use in interpreting the four models highlighted in red in Figures 1 and 2.

Friedman's partial dependence plots are based on the following idea: consider an arbitrary model obtained by fitting a particular structure (e.g., random forest, support vector machine, or linear regression model) to a given dataset $\cal D$. This dataset includes $N$ observations $y_k$ of a response variable $y$, for $k = 1,2,\dots,N$, along with $p$ covariates denoted $x_{i,k}$ for $i = 1,2,\dots,p$ and $k = 1,2,\dots,N$. The model generates predictions of the form:

$$
\hat{y}*k = F(x*{1,k}, x_{2,k}, \dots, x_{p,k}),
$$

for some mathematical function $F(\cdots)$. In the case of a single covariate $x_j$, Friedman's partial dependence plots are obtained by computing the following average and plotting it over a useful range of $x$ values:

$$ \phi_j(x) = \frac{1}{N} \; \sum_{k=1}^{N} \; F(x_{1,k},\dots, x_{j-1,k},x,x_{j+1,k}, \dots, x_{p,k}). $$

The idea is that the function $\phi_j(x)$ tells us how the value of the variable $x_j$ influences the model predictions ${ \hat{y}_k }$ after we have "averaged out" the influence of all *other* variables. For linear regression models, the resulting plots are simply straight lines whose slopes are equal to the model parameters. Specifically, for a linear model, the prediction defined above has the form:

$$
\hat{y}*k = \sum*{i=1}^{p} \; a_i x_{i,k},
$$

from which it follows that the partial dependence function is:

$$ \phi_j(x) = a_j x + \frac{1}{N} \; \sum_{k=1}^{N} \sum_{i \neq j} \; a_i x_{i,k} = a_j x + \sum_{i \neq j} a_i \bar{x_i}, $$

where $\bar{x_i}$ is the average value of the $i^{th}$ covariate. The main advantage of these plots is that they can be constructed for any predictive model, regardless of its form or complexity.

The multivariate extension of the partial dependence plots just described is straightforward in principle, but several practical issues arise. First and most obviously, these plots are harder to interpret: the bivariate partial dependence function $\phi_{i,j}(x,y)$ for two covariates $x_i$ and $x_j$ is defined analogously to $\phi(x)$ by averaging over all other covariates, and this function is still relatively easy to plot and visualize, but higher-dimensional extensions are problematic. Also, these multivariate partial dependence plots have been criticized as being inadequate in the face of certain strong interactions; an alternative approach that attempts to address these limitations has been incorporated into the *R* package **ICEbox** described by @goldstein14. It may be useful to extend the approach described here along the lines advocated by these authors, but this idea has not yet been explored.

To gain an understanding of the differences between some of the models characterized in Figures 1 and 2, the following paragraphs construct the univariate partial dependence plots described in Section 3 for selected variables and the four models highlighted in Section 2:

- ENET Blender, the model exhibiting the best performance seen for this example;
- GBGT: Gradient Boosted Greedy Trees Regressor, the best non-blender model;
- Nystroem Kernel SVM: the best of the support vector machine (SVM) models;
- Linear: the ordinary least squares linear regression model.

To compute $\phi_j(x)$, we first select a set of $G$ grid points uniformly spaced over the range of $x_j$ values. Next, we construct an augmented dataset by concatenating $G$ copies of the original, each constructed by replacing all $x_j$ observations with one of the $G$ grid points. A simple *R* function to generate this augmented dataset is **FullAverageDataset**:

FullAverageDataset <- function(covarFrame, refCovar, numGrid, plotRange = NULL) { covars <- colnames(covarFrame) refIndex <- which(covars == refCovar) refVar <- covarFrame[, refIndex] if (is.null(plotRange)) { start <- min(refVar) end <- max(refVar) } else { start <- plotRange[1] end <- plotRange[2] } grid <- seq(start, end, length = numGrid) outFrame <- covarFrame outFrame[, refIndex] <- grid[1] for (i in 2:numGrid) { upFrame <- covarFrame upFrame[, refIndex] <- grid[i] outFrame <- rbind.data.frame(outFrame, upFrame) } outFrame }

This function is called with a dataframe **covarFrame** containing covariates only, a character string **refCovar** giving the name of the reference covariate $x_j$ for which the partial dependence results are desired, and two optional parameters. The optional parameter **numGrid** specifies the number of grid points for which $\phi_j(x)$ is computed, and **plotRange** is an optional two-element vector that specifies the minimum and maximum $x$ values to be used; the default option, **plotRange = NULL**, uses the minimum and maximum $x_j$ values in the dataset.

In what follows, this function is used to create the modified dataset required to compute $\phi_j(x)$ for each covariate of interest, for the four models highlighted in red in Figures 1 and 2. This is accomplished via the function **PDPbuilder** shown here, which calls the function **FullAverageDataset** just described:

PDPbuilder <- function(covarFrame, refCovar, listOfModels, numGrid = 100, plotRange = NULL) { augmentedFrame <- FullAverageDataset(covarFrame, refCovar, numGrid, plotRange) nModels <- length(listOfModels) library(doBy) model <- listOfModels[[1]] yHat <- Predict(model, augmentedFrame) hatFrame <- augmentedFrame hatFrame$prediction <- yHat hatSum <- summaryBy(list(c("prediction"), c(refCovar)), data = hatFrame, FUN = mean) colnames(hatSum)[2] <- model$modelType for (i in 2:nModels) { model <- listOfModels[[i]] yHat <- Predict(model, augmentedFrame) hatFrame <- augmentedFrame hatFrame$prediction <- yHat upSum <- summaryBy(list(c("prediction"), c(refCovar)), data = hatFrame, FUN = mean) colnames(upSum)[2] <- model$modelType hatSum <- merge(hatSum, upSum) } hatSum }

The first two required paramters and the two optional parameters for this function are the same as those for the **FullAverageDataset** function, and the only other parameter in the **PDPbuilder** call is **listOfModels**, which specifies the DataRobot models for which partial dependence results are to be computed. This function returns a dataframe whose first column contains the $x_j$ values of the grid points for which the partial dependence is evaluated, and subsequent columns contain the $\phi_j(x)$ values for each model in **listOfModels** at each of these grid points.

In the examples considered here, these models are the four appearing in red in Figures 1 and 2, corresponding to the models ranked 1 (`r concreteModels[[1]]$modelType`

), 5 (`r concreteModels[[5]]$modelType`

), 12 (`r concreteModels[[12]]$modelType`

), and 29 (`r concreteModels[[29]]$modelType`

). The following code generates this list of models and the associated partial dependence results for the **age** variable from the concrete modeling dataframe:

modelList <- list(concreteModels[[1]], concreteModels[[5]], concreteModels[[12]], concreteModels[[29]]) agePDPframe <- PDPbuilder(concreteFrame[, 1:8], "age", modelList)

Given this dataframe, partial dependence plots like that shown in Figure 3 are generated by calling the plot function listed below:

PDPlot <- function(PDframe, Response, ltypes, lColors, ...) { Rng <- range(Response) nModels <- ncol(PDframe) - 1 modelNames <- colnames(PDframe)[2: (nModels + 1)] plot(PDframe[, 1], PDframe[, 2], ylim=Rng, type = "l", lty = ltypes[1], lwd = 2, col = lColors[1], xlab = colnames(PDframe)[1], ylab = "Partial Dependence", ...) abline(h = Rng, lty=3, lwd=2, col="black") for (i in 2:nModels) { lines(PDframe[, 1], PDframe[, i + 1], lwd = 2, lty = ltypes[i], col = lColors[i]) } legend("topleft", lty = ltypes, text.col = lColors, col = lColors, lwd = 2, legend = modelNames) }

Here, **PDframe** is the dataframe returned by the **PDPbuilder** function, **Response** is the target variable to be predicted by all models, **ltypes** is a vector of line types, one for each model in **modelList**, and **lColors** is a vector of line colors used to draw the partial dependence curves. The **Response** variable is included here because the range of the target variable provides a natural basis for evaluating the magnitude of the influence of each variable: if the total range of $\phi_j(x)$ is small compared to the range of the target variable, this suggests that the influence of this variable is small, regardless of the shape of the partial dependence curve.

par(mfrow=c(1, 1)) agePDPframe <- readRDS("agePDPframe.rds") Response <- concreteFrame$strength ltypes <- seq(4) lColors <- c("limegreen", "black", "blue", "magenta") PDPlot(agePDPframe, Response, ltypes, lColors)

Figures 3 through 6 present plots of these partial dependence functions for the variables **age**, **cement**, **water**, and **blastFurnaceSlag**, for each of the four models considered here, overlaid to facilitate comparison. Horizontal dotted black lines are drawn at the minimum and maximum values of compressive strength to provide a useful frame of reference for the variation of the functions shown in these plots. The magenta dash-dot line in Figure 3 represents the partial dependence plot for the linear regression model, and it clearly exhibits the linear behavior described in Section 3. The other three curves in Figure 3 show the partial dependence plots for the Nystroem Kernel SVM Regressor (blue dotted line), the Gradient Boosted Greedy Trees Regressor (black dashed line), and the ENET Blender (solid green line). All three of these nonlinear models exhibit hard saturation behavior, which seems intuitively reasonable - i.e., that concrete "sets" in a finite time, after which it exhibits negligible changes in physical properties. The ability of these machine learning models to capture this saturation behavior partially explains their superior prediction performance.

par(mfrow=c(1, 1)) cementPDPframe <- readRDS("cementPDPframe.rds") PDPlot(cementPDPframe, Response, ltypes, lColors)

Figure 4 shows the **cement** partial dependence, in the same format as Figure 3. As with the **age** variable, the partial dependence plots for the three better models (Nystroem SVM, Gradient Boosted Greedy Trees Regressor, and ENET Blender) have similar shapes, exhibiting a much weaker nonlinearity than the **age** plots, but showing some evidence of saturation at both low and high cement concentrations. Also, note the substantially weaker dependence seen for these three models relative to the linear regression models.

par(mfrow=c(1, 1)) waterPDPframe <- readRDS("waterPDPframe.rds") PDPlot(waterPDPframe, Response, ltypes, lColors)

Figure 5 shows the partial dependence plots for **water**, in the same format as Figure 3. Here, the ENET Blender and Gradient Boosted Greedy Trees Regressor exhibit nonmonotonic dependencies that are very roughly sinusoidal. The negative slope seen for the Linear Regression model is qualitatively consistent with the mid-range behavior of the ENET Blender plot, but with a substantially smaller negative slope. The plot for the Gradient Boosted Greedy Trees Regressor is extremely similar to that for the ENET blender, while the Nystroem SVM shows a very different dependence. In particular, this model shows essentially no dependence on **water** over the range from 120 to 180, where the ENET and GBGT models show their strongest variation.

par(mfrow=c(1, 1)) blastPDPframe <- readRDS("blastPDPframe.rds") PDPlot(blastPDPframe, Response, ltypes, lColors)

Finally, Figure 6 shows the partial dependence plots for **blastFurnaceSlag**, again in the same format as Figure 3. Here, all four of these plots suggest an approximately linear dependence of compressive strength on **blastFurnaceSlag**, all with positive slopes. The primary differences are in the magnitudes of these slopes: the linear model show much larger slopes than the other three models, all of which exhibit very similar behavior.

The results presented in Figures 3 through 6 suggest several conclusions. First, the superior predictive capability of the ENET Blender and Gradient Boosted Greedy Trees Regressor probably arises from their flexibility in capturing the monotonic saturation nonlinearity of the **age** dependence and the non-monotonic **water** dependence. Indeed, these two models are the only ones examined here that show this relatively complex **water** dependence. In contrast, the simple linear model can only crudely approximate the nonlinear **age** and **water** dependencies.

This note has described the partial dependence plots proposed by @friedman01 to characterize the dependence of model predictions on individual covariates. As discussed in Section 3, these plots reduce to straight lines for linear regression model, where the slopes correspond to the model parameters; thus, for arbitrary predictive models, these plots may be viewed as graphical extensions of the coefficients in these linear models. The other three models characterized in Figure 3 exhibit "hard saturation," showing no influence of **age** beyond approximately 100 days. Finally, the most surprising feature seen in these partial dependence results is the non-monotonic **water** dependence shown in Figure 5 for the ENET and GBGT models: this behavior is not seen for the Nystroem Kernel SVM model, which performs clearly worse than these other models.

**Any scripts or data that you put into this service are public.**

Embedding an R snippet on your website

Add the following code to your website.

For more information on customizing the embed code, read Embedding Snippets.