Main Content

candexch

行交換を使用した候補セットによるD最適計画法

構文

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

説明

rlist= candexch(C,nrows)は行交換アルゴリズムを使用して、候補セットCからD最適計画法を選択します。

rlist= candexch(C,nrows,Name,Value)は、1 つまたは複数のName,Valueの引数ペアで指定された追加オプションを使用して、D最適計画法を生成します。

入力引数

C

それぞれのN点でPモデル項の値を含むN行P列の行列。

nrows

計画で必要な行数。

名前と値の引数

オプションの引数のペアをName1=Value1,...,NameN=ValueNとして指定します。ここでNameは引数名、Valueは対応する値です。名前と値の引数は他の引数の後ろにする必要がありますが、ペアの順序は関係ありません。

R2021a より前では、名前と値をそれぞれコンマを使って区切り、Nameを引用符で囲みます。

display

'on'の場合、反復回数を表示します。表示を無効にするには'off'に設定します。

既定値:UseParallelオプションがtrueの場合以外は、'on'を指定します。

init

初期計画を提供するnrows行P列の行列。

既定値:Cの行の無作為のサブセット

maxiter

最大反復回数 (正の整数)。

既定値:10

options

並列実行するかどうかを指定し,乱数ストリームを指定する構造体。このオプションには平行Computing Toolbox™ が必要です。

statsetを使用してoptions構造体を作成します。以下のオプションのフィールドがあります。

  • UseParallel— 並列計算する場合はtrueに設定します。既定値はfalseです。

  • UseSubstreams— 再生成可能な方法で並列計算する場合はtrueに設定します。既定値はfalseです。再現性のある計算を行うには、Streamsをサブストリームを許可する型、'mlfg6331_64'または'mrg32k3a'に設定します。

  • Streams—RandStreamオブジェクトまたはそのようなオブジェクトの cell 配列。Streamsを指定しないと、candexchには既定のストリームが使用されます。Streamsを指定するように選択した場合、次の場合を除いて単一オブジェクトを使用してください。

    • UseParallelがtrue

    • UseSubstreamsがfalse

    この場合は、並列プールと同じサイズの cell 配列を使用します。

既定値:[]

start

計画に含めるために修正した計画ポイントnobsの集合を指定するnobs行 p 列の行列の要因設定行列。関数candexchは、startの設計に追加するnrowsの行を検出します。このパラメーターは、関数daugmentと同じ機能を提供しますが、座標交換アルゴリズムではなく行交換アルゴリズムを使用します。

既定値:[]

tries

新しい開始点から計画の生成を試行する回数。このアルゴリズムでは、最初の試行を除いて、各試行で無作為な点を使用します。

既定値:1

出力引数

rlist

選択した行をリストする長さnrowsのベクトル。

例

この例では、候補セットに制限があり、関数rowexchが適切でない場合に、D最適計画法を生成する方法を示します。

F = (fullfact([5 5 5])-1)/4; % factor settings in 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]; % compute model terms including % a constant and all squared terms R = candexch(C,12); % find a D-optimal 12-point subset X = F(R,:); % get factor settings

アルゴリズム

candexchは、開始設計Xを無作為に選択し、行交換アルゴリズムを使用してXの行をCの行に置き換えて、X'*Xの判別が向上するように試行します。

代替方法

関数rowexchはさらに、行交換アルゴリズムを使用してD最適計画法を生成しますが、指定されたモデルに適切な候補セットを自動的に生成します。daugment関数は、座標変換アルゴリズムを使用して固定設計点のセットを強化し、'start'パラメーターは行交換アルゴリズムを使用して、同じ機能を提供します。

拡張機能

バージョン履歴

R2006a より前に導入

参考

||||

トピック