Search {MOODE} | R Documentation |
Searching for a multi-objective optimal completely randomised design.
Description
Performing search for a (nearly) optimum factorial design, optimising with respect to a specified compound criterion.
Usage
Search(
mood.object,
algorithm = c("ptex", "coordex"),
parallel = FALSE,
verbose = TRUE
)
Arguments
mood.object |
The object generated by |
algorithm |
Parameter specifying the search algorithm. If |
parallel |
If |
verbose |
If |
Details
Search
takes the mood object as an input with all the parameters of the experiment. Runs a point-exchange or a coordinate-exchange algorithm, returns design and model matrices, computation time and criteria values.
See (Koutra et al. 2024) for examples of using parallel = TRUE
.
Value
List of the outputs generated by the search:
-
X.design
Design matrix. -
df
The number of pure error degrees of freedom. -
X1
Primary model matrix for the found (nearly-) optimum design. -
X2
Model matrix of potential terms for the found (nearly-) optimum design. -
compound.value
The compound criterion value of the (nearly-) optimum design. -
criteria.values
Component criteria values of the (nearly-) optimum design. -
path
The "path" of compound criterion values of the optimum designs obtained after for each random start. -
time
Computation time. -
algorithm
Point exchange or coordinate exchange used to find the design? -
parallel
Were different runs of the algorithm performed across different CPU cores (TRUE
/FALSE
)
References
Koutra V, Egorova O, Gilmour SG, Trinca LA (2024). “MOODE: An R Package for Multi-Objective Optimal Design of Experiments.” arXiv:2412.17158, https://arxiv.org/abs/2412.17158.
See Also
Examples
example1 <- mood(K = 2, Levels = 3, Nruns = 10, criterion.choice = "GDP",
kappa = list(kappa.Ds = 1./3, kappa.DP = 1./3, kappa.LoF = 1./3),
control = list(tau2 = 0.1),
model_terms = list(primary.model = "first_order",
potential.terms = c("x12", "x22", "x1x2")))
# Using point exchange
Search_point <- Search(example1, algorithm = 'ptex')
Search_point
# Using coordinate exchange (the default for K>4)
Search_coord <- Search(example1)
Search_coord