Computes an efficient exact experimental design under general linear constraints using the approach of mixed integer second-order cone programming.

1 2 |

`F` |
The |

`b, A` |
The real vector of length |

`w0` |
The non-negative vector of length |

`crit` |
The optimality criterion. Possible values are |

`R` |
The region of summation for the IV-optimality criterion. The argument |

`kappa` |
A small non-negative perturbation parameter. |

`tab` |
A vector determining the regressor components to be printed with the resulting design.
This argument should be a subvector of |

`graph` |
A vector determining the regressor components to be plotted with the resulting design.
This argument should be a subvector of |

`t.max` |
The time limit for the computation. |

The procedure computes an efficient exact design by converting the optimal design problem to a specific problem of mixed integer second-order cone programming; see the reference for details. The advantage of this approach is the possibility to construct exact designs under a general system of linear constraints.

The model should be non-singular in the sense that there exists an exact design `w`

satisfying the constraints `0<=w0<=w`

and
`A%*%w<=b`

, with a non-singular information matrix, preferably with the reciprocal condition number of at least `1e-5`

. If this requirement
is not satisfied, the computation may fail, or it may produce a deficient design.

If the criterion of IV-optimality is selected, the region `R`

should be chosen such that the associated matrix `L`

(see the help page of the function od.crit) is non-singular, preferably with a reciprocal condition number of at least `1e-5`

.
If this requirement is not satisfied, the computation may fail, or it may produce a deficient design.

The perturbation parameter `kappa`

can be used to add `n*m`

iid random numbers from the uniform distribution
in `[-kappa,kappa]`

to the elements of `F`

before the optimization is executed. This can be helpful for
increasing the numerical stability of the computation or for generating a random design from the potentially large set of optimal or
nearly-optimal designs.

The performance strongly depends on the problem and on the hardware used, but in most cases the function can compute an optimal or nearly-optimal exact design for a problem with a hundred design points within minutes of computing time. We advise the user to verify the quality of the resulting design by comparing it to the result of an alternative method (such as od.IQP and od.RC) and/or by computing its efficiency relative to the corresponding optimal approximate design (computed using od.SOCP). In the special case of the single constraint on the size, it is generally more efficient to use the function od.KL, or the function od.RCs.

A list with the following components:

`method` |
The method used for computing the design |

`w.best` |
the best permissible design found, or |

`Phi.best` |
The value of the criterion of optimality of the design |

`status` |
The status variable of the gurobi optimization procedure; see the gurobi solver documentation for details. |

`t.act` |
The actual time taken by the computation. |

Radoslav Harman, Lenka Filova

Sagnol G, Harman R (2015): Computing exact D-optimal designs by mixed integer second-order cone programming. The Annals of Statistics, Volume 43, Number 5, pp. 2198-2224.

`od.IQP, od.RC, od.SOCP, od.KL, od.RCs`

1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 | ```
if(require("gurobi")){
# Consider a dose-response study where both efficacy and toxicity are
# observed as 0/1 outcomes for each patient, where the probability of
# the outcome 1 under the dose x is modeled by the logistic function:
# exp(ae+be*x)/(1+exp(ae+be*x)) for the efficacy, and
# exp(at+bt*x)/(1+exp(at+bt*x)) for the toxicity. We can choose the
# doses x in the range 1 mg to 150 mgs.
# The aim is to estimate the parameters ae,be using the D-optimal
# design, or using the A-optimal design.
# Because this is a non-linear model, the optimal designs will depend
# on the unknown values of the parameters. We will use the approach of
# local optimality with the following nominal values of the parameters:
tle <- c(-10, 0.2)
tlt <- c(-20, 0.2)
# It is simple to show that the localized information matrix for
# (ae,be) is the information matrix of the standard model with
# the following regressors:
F.logistic <- matrix(0, nrow=150, ncol=2)
for (i in 1:150)
F.logistic[i, ] <-
c(sqrt(exp(tle[1]+tle[2]*i))/(1+exp(tle[1]+tle[2]*i)),
i*sqrt(exp(tle[1]+tle[2]*i))/(1+exp(tle[1]+tle[2]*i)))
# The constraints on the experiment are twofold: We can have at most
# N=100 subjects and we also require that the expected number of
# "failed" trials is at most 10. A trial is considered to be a failure
# if it leads to either a toxic response, or if it is not efficacious.
# These constraints can be expressed as A*w<=b:
efficacy.prob <- function(x)
exp(tle[1]+tle[2]*x)/(1+exp(tle[1]+tle[2]*x))
toxicity.prob <- function(x)
exp(tlt[1]+tlt[2]*x)/(1+exp(tlt[1]+tlt[2]*x))
failure.prob <- function(x)
1 - (1 - toxicity.prob(x)) * efficacy.prob(x)
b <- c(100, 10); A <- rbind(rep(1,150), failure.prob(1:150))
# Now we can compute the designs:
res.D <- od.MISOCP(F.logistic, b, A, crit="D")
res.A <- od.MISOCP(F.logistic, b, A, crit="A")
# Let us verify the quality of the designs by computing their efficiency
# relative to the approximate optimal designs:
res.D$Phi.best / od.SOCP(F.logistic, b, A, crit="D")$Phi.best
res.A$Phi.best / od.SOCP(F.logistic, b, A, crit="A")$Phi.best
# We can plot the failure probability curve (red), the toxicity
# probability curve (black), the efficacy probability curve (green),
# the D-optimal design (orange) and the A-optimal design (blue):
plot(failure.prob(1:150), type="l",
ylab="probability / proportion of subjects",
lwd=3, col="red")
lines(toxicity.prob(1:150), col="black")
lines(efficacy.prob(1:150), col="green")
lines(res.D$w.best/100, type="h", col="orange")
lines(res.D$w.best/100, type="h", col="orange", lwd=2)
lines(res.A$w.best/100, type="h", col="blue", lwd=2)
# Note that both designs perform the observations generally at two
# different levels, one of which is a dose which leads to a 50-percent
# failure of efficacy. Based on these designs, none of the patients
# are put on dangerously high levels of doses.
}
``` |

Questions? Problems? Suggestions? Tweet to @rdrrHQ or email at ian@mutexlabs.com.

All documentation is copyright its authors; we didn't write any of that.