steepest {rsm}R Documentation

Steepest-ascent methods for response surfaces

Description

These functions provide the path of steepest ascent (or descent) for a fitted response surface produced by rsm.

Usage

steepest (object, dist = seq(0, 5, by = .5), descent = FALSE)
canonical.path(object, which = ifelse(descent, length(object$b), 1),
               dist = seq(-5, 5, by = 0.5), descent = FALSE)

Arguments

object rsm object to be analyzed.
dist Vector of desired distances along the path of steepest ascent or descent. In steepest, these must all be non-negative; in canonical.path, you may want both positive and negative values, which specify opposite directions from the stationary point.
descent Set this to TRUE to obtain the path of steepest descent, or FALSE to obtain the path of steepest ascent. This value is ignored in canonical.path if which is specified.
which Which canonical direction (eigenvector) to use.

Details

steepest returns the linear path of steepest ascent for first-order models, or a path obtained by ridge analysis (see Draper 1963) for second-order models. In either case, the path begins at the origin.

canonical.path applies only to second-order models (at least a TWI term present). It determines a linear path along one of the canonical variables, originating at the stationary point (not the origin). We need to specify which canonical variable to use. The eigenvalues obtained in the canaonical analysis are always in decreasing order, so the first canonical direction will be the path of steepest ascent (or slowest descent, if all eigenvalues are negative) from the stationary point, and the last one will be the path of steepest descent (or slowest ascent, if all eigenvalues are positive). These are the defaults for which when descent=FALSE and descent=TRUE respectively.

With either function, the path in uncoded units depends on how the data are coded. Accordingly, it is important to code the predictor variables appropriately before fitting the response-surface model. See \ref{coded.data} and its relatives for more information.

Value

A data.frame of points along the path of steepest ascent (or descent). For steepest, this path originates from the center of the experiment; for canonical.path, it starts at the stationary point. If coding information is available, the data frame also includes the uncoded values of the variables.
For first-order response surfaces, only steepest may be used; the path is linear in that case. For second-order surfaces, steepest uses ridge analysis, and the path may be curved.

Note

Take careful note of the fitted values along the outputted path (labeled yhat). For example, if the stationary point is a maximum (all eigenvalues negative), the fitted values from steepest will increase as far as the stationary point, then they will decrease as we proceed along what is now the path of slowest descent.

Author(s)

Russell V. Lenth

References

Draper, NR (1963), ``Ridge analysis of response surfaces'', Technometrics, 5, 469–479.

See Also

rsm, coded.data

Examples

library(rsm)
heli.rsm = rsm (ave ~ block + SO(x1, x2, x3, x4), data = heli) 

steepest(heli.rsm)

canonical.path(heli.rsm)

[Package rsm version 1.11 Index]