candexch

R2026b

D-optimal design from candidate set using row exchanges

collapse all in page

Syntax

rlist = candexch(C,nrows)
rlist = candexch(C,nrows,Name=Value)

Description

rlist = candexch(C,nrows) uses a row-exchange algorithm to select a D-optimal design from the candidate set C.

example

rlist = candexch(C,nrows,Name=Value) generates a D-optimal design with additional options specified by one or more name-value arguments.

Examples

collapse all

Open Live Script

Define a candidate set with a restriction.

F = (fullfact([5 5 5])-1)/4; % Factor settings in a unit cube
T = sum(F,2)<=1.51;          % Find rows matching a restriction
F = F(T,:);                  % Take only those rows
C = [ones(size(F,1),1) F F.^2];

Calculate model terms including a constant and all squared terms. Because the candidate set has a restriction, use the candexch function instead of the rowexch function.

R = candexch(C,12);         % Find a D-optimal 12-run subset
X = F(R,:);                 % Get factor settings

Input Arguments

collapse all

Candidate set, specified as a matrix of size N-by-P. The candidate set contains the values of P model terms at each of N runs.

Desired number of rows in the design, specified as a positive integer.

Name-Value Arguments

collapse all

Specify optional pairs of arguments as Name1=Value1,...,NameN=ValueN, where Name is the argument name and Value is the corresponding value. Name-value arguments must appear after other arguments, but the order of the pairs does not matter.

Before R2021a, use commas to separate each name and value, and enclose Name in quotes.

Example: rlist = candexch(C,nrows,MaxIterations=7) specifies the maximum number of iterations as 7.

Flag for candexch to avoid calculating duplicate rows, specified as a numeric or logical 1 (true) or 0 (false). If AvoidDuplicates is true and candexch is able to calculate non-duplicate runs, the rows of rlist are unique. When AvoidDuplicates is false, the function does not avoid calculating duplicate rows.

Example: AvoidDuplicates=true

Data Types: single | double | logical

Display the iteration number, specified as "on" or "off". By default, the candexch function displays the iteration number, except when the UseParallel field of the Options name-value argument is "on" or "auto".

Initial design, specified as a numeric matrix of size nrows-by-P, where P is the number of columns in C. By default, the candexch function uses a random subset of the rows of C as the initial design.

Maximum number of iterations, specified as a positive integer.

Options for computing in parallel and setting random streams, specified as a structure. Create the Options structure using statset. This table lists the option fields and their values.

Field NameValueDefault
UseParallel

Set this value to "auto" or "on" to run computations in parallel. If you specify "auto", MATLAB® uses a parallel pool if one is available, otherwise runs in serial. If you specify "on", MATLAB uses a parallel pool if one is available, otherwise throws an error.

"off"
UseSubstreams

Set this value to true to run computations in a reproducible manner.

To compute reproducibly, set Streams to a type that allows substreams: "mlfg6331_64" or "mrg32k3a".

false
StreamsSpecify this value as a RandStream object or cell array of such objects. Use a single object except when the UseParallel value is "on" or "auto" and the UseSubstreams value is false. In that case, use a cell array that has the same size as the parallel pool.If you do not specify Streams, then candexch uses the default stream or streams.

Note

You need Parallel Computing Toolbox™ to run computations in parallel.

Before R2026b: To run computations in parallel, set UseParallel to true.

Example: Options=statset(UseParallel="auto",UseSubstreams=true,Streams=RandStream("mlfg6331_64"))

Data Types: struct

Factor settings, specified as a numeric matrix of size nobs-by-P, where nobs is the number of fixed design runs, and P is the number of columns in C. candexch finds nrows additional rows to add to the FixedRows design.

Number of tries to generate a design from a new starting point, specified as a positive integer. The algorithm uses random points for each try, except possibly the first.

Output Arguments

collapse all

Selected rows, returned as a vector of length nrows.

Algorithms

candexch selects a starting design X at random, and uses a row-exchange algorithm to iteratively replace rows of X by rows of C in an attempt to improve the determinant of X'*X.

Alternatives

The rowexch function also generates D-optimal designs using a row-exchange algorithm, but it automatically generates a candidate set that is appropriate for a specified model.

The daugment function augments a set of fixed design runs using a coordinate-exchange algorithm; the FixedRows name-value argument provides the same functionality using the row exchange algorithm.

Extended Capabilities

expand all

Version History

Introduced before R2006a

expand all

See Also

| | | |

Topics