Learn R Programming

OptimalDesign (version 1.0.3)

OptimalDesign-package: OptimalDesign

Description

OptimalDesign is a toolbox for constructing optimal (or efficient) experimental designs on finite sets of candidate design points. It provides algorithms for computing D-, A-, I-, and c-optimal approximate and exact designs of experiments for regression models with uncorrelated observations.

The package can be used for a wide range of applications, including optimal screening, response-surface, mixture, and weighing designs, as well as designs for standard nonlinear, generalized linear, and survival models via the approach of local optimality.

Although the design space (the set of candidate design points) is required to be finite, this is typically not a limitation in practice. In many applications the design space is intrinsically finite. Even when a continuous region is assumed theoretically, implementable factor levels are always constrained to a finite set, by instrument resolution and operating procedures.

In this package, a design on a finite candidate set is represented by a vector w of replications of the candidate design points. The components of w are non-negative numbers, one for each candidate point. For exact designs these replications are integers, i.e., they can be directly used. For approximate designs the replication numbers may be non-integer, that is, they must be properly rounded before the design is implemented. Optimal approximate designs also have an auxiliary utility for the construction of exact designs, for example by providing a bound on the efficiency of any exact design.

The model is represented by the matrix Fx of candidate regressors: each row of Fx corresponds to one candidate design point, and each column to one model parameter.

Several functions allow the user to impose linear constraints directly on the design vector w (for example, on the total cost if the trials at different design points have different costs, on upper bounds on replication numbers of individual design points or entire strata of the design set, and so on).

Note that constraints restricting the set of candidate points themselves can be handled simply by removing the impermissible rows from Fx before computing the design.

A typical workflow is as follows.

1) Specify the candidate design space and construct the matrix Fx, either manually or using helper functions such as Fx_cube, Fx_simplex, Fx_blocks, Fx_glm, Fx_dose, or Fx_survival.

2) Choose an optimality criterion ("D", "A", "I", "C" or "c") and, if the c- or C-criterion is used, specify a linear combination of parameters via the vector h. Note that the C-criterion is a regularized version of the standard c-criterion.

3) Use od_REX for standard approximate designs, od_KL for standard exact designs constrained only by the size (i.e., the total number of trials), or od_RC, od_AQUA, or od_MISOCP to compute an efficient design under more general linear constraints.

4) Possibly inspect and visualize the resulting design using optcrit, infmat, od_print, od_plot, dirder, effbound, or varfun.

Several functions offer additional options that are useful in applications. For example, setting bin = TRUE in od_KL, od_AQUA, od_MISOCP, or od_RC enforces a binary design, in which each candidate design point can be used at most once (non-replicable design points). The argument w0 allows the user to fix a lower bound on the replication numbers (also called protected runs), i.e., to compute an optimal augmentation of a given design.

Arguments

Author

Radoslav Harman, Lenka Filova