The purpose is to properly derive data for the average observation in the
data by being 'aware' of formulas that contain interactions and/or function
calls. For example, in the old behavior, if the formula contained a square
term specified as I(x^2), we were returning the mean of x(^2) not the
square of mean(x).
Value
a data frame with a single row for the average observation, but with full factor levels. See details for more.
Details
Matrix-valued response columns (e.g. the cbind(successes, failures)
left-hand side of a binomial GLMM) are detected and dropped from the
working frame before averaging, since they cannot be collapsed to a
single scalar. The returned frame therefore has no response column for
matrix-LHS models; see averageObs for rationale.